Woodward easYgen-1000 User manual

37393C
Interface Description
Software Version 2.1xxx
Manual 37393C
easYgen-1000
Interfaces

Manual 37393C easYgen-1000 Series - Interfaces
Page 2/96 © Woodward
WARNING
Read this entire manual and all other publications pertaining to the work to be performed before in-
stalling, operating, or servicing this equipment. Practice all plant and safety instructions and precau-
tions. Failure to follow instructions can cause personal injury and/or property damage.
The engine, turbine, or other type of prime mover should be equipped with an overspeed (overtempera-
ture, or overpressure, where applicable) shutdown device(s), that operates totally independently of the
prime mover control device(s) to protect against runaway or damage to the engine, turbine, or other
type of prime mover with possible personal injury or loss of life should the mechanical-hydraulic gov-
ernor(s) or electric control(s), the actuator(s), fuel control(s), the driving mechanism(s), the linkage(s),
or the controlled device(s) fail.
Any unauthorized modifications to or use of this equipment outside its specified mechanical, electrical,
or other operating limits may cause personal injury and/or property damage, including damage to the
equipment. Any such unauthorized modifications: (i) constitute "misuse" and/or "negligence" within
the meaning of the product warranty thereby excluding warranty coverage for any resulting damage,
and (ii) invalidate product certifications or listings.
CAUTION
To prevent damage to a control system that uses an alternator or battery-charging device, make sure
the charging device is turned off before disconnecting the battery from the system.
Electronic controls contain static-sensitive parts. Observe the following precautions to prevent dam-
age to these parts.
Discharge body static before handling the control (with power to the control turned off, contact a
grounded surface and maintain contact while handling the control).
Avoid all plastic, vinyl, and Styrofoam (except antistatic versions) around printed circuit boards.
Do not touch the components or conductors on a printed circuit board with your hands or with
conductive devices.
OUT-OF-DATE PUBLICATION
This publication may have been revised or updated since this copy was produced. To verify that you
have the latest revision, be sure to check the Woodward website:
http://www.woodward.com/pubs/current.pdf
The revision level is shown at the bottom of the front cover after the publication number. The latest
version of most publications is available at:
http://www.woodward.com/publications
If your publication is not there, please contact your customer service representative to get the latest
copy.
Important definitions
WARNING
Indicates a potentially hazardous situation that, if not avoided, could result in death or serious injury.
CAUTION
Indicates a potentially hazardous situation that, if not avoided, could result in damage to equipment.
NOTE
Provides other helpful information that does not fall under the warning or caution categories.
Woodward reserves the right to update any portion of this publication at any time. Information provided by Woodward is believed to be
correct and reliable. However, Woodwardassumes no responsibility unless otherwise expressly undertaken.
© Woodward
All Rights Reserved.

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 3/96
Revision History
Rev.
Date
Editor
Changes
C
2016-07-04
GG
With software version 2.1014 or higher, the number of CAN bus error frames transmitted dur-
ing easYgen startup is minimized.
Added a note about how to solve a problem of PLC or other devices reading Modbus data
transmitted by easYgen (see page 15).
B
08-07-02
TP
Parameter descriptions moved to Configuration Manual
A
08-05-21
TP
Minor corrections
NEW
07-02-06
TP
Release based on 37262D
Contents
CHAPTER 1. GENERAL INFORMATION ....................................................................................... 5
Related Documents..................................................................................................................................5
Interface Overview...................................................................................................................................6
Modbus Half/Full Duplex Application.............................................................................................7
CAN Bus...................................................................................................................................................9
CHAPTER 2. DATA TELEGRAMS ............................................................................................. 10
Interface Monitoring ...............................................................................................................................10
Transmit Telegram.................................................................................................................................10
Modbus ........................................................................................................................................10
CAN (CAL)...................................................................................................................................10
CANopen .....................................................................................................................................10
Receive Telegram..................................................................................................................................11
Modbus ........................................................................................................................................11
CAN (CAL)...................................................................................................................................12
CANopen .....................................................................................................................................12
CHAPTER 3. SERIAL INTERFACE............................................................................................. 13
Overview ................................................................................................................................................13
Modbus RTU Slave................................................................................................................................14
General Information.....................................................................................................................14
Modbus Addressing and Data Model.....................................................................................................15
Visualization...........................................................................................................................................16
Configuration..........................................................................................................................................17
Exception Responses ............................................................................................................................20
CHAPTER 4. CAN (CAL) ....................................................................................................... 21
CHAPTER 5. CANOPEN ......................................................................................................... 22
Introduction.............................................................................................................................................22
Server Data Objects (SDO) - Communication.............................................................................23
Process Data Objects (PDO).......................................................................................................25
Setting the Transmit PDO (Examples).........................................................................................26
SYNC Message ...........................................................................................................................27
Using a CANopen Configuration Program...................................................................................27
Settings for Connection with External Devices......................................................................................29
Expansion with One IKD 1 (8 Additional External DI/DO)...........................................................30
Expansion with Two IKD 1 (16 Additional External DI/DO).........................................................31
Expansion with the Phoenix terminal IL CAN BK / ILB CO 24 16DI 16DO (16 DI/DO)...............33
Expansion with an easYlite..........................................................................................................34
FAQ CAN Bus........................................................................................................................................35
Recommendations of Woodward.................................................................................................35

Manual 37393C easYgen-1000 Series - Interfaces
Page 4/96 © Woodward
Device Combinations and Bus Load........................................................................................... 35
CHAPTER 6. CAN SAE J1939...............................................................................................38
Introduction............................................................................................................................................ 38
Displayed Messages.............................................................................................................................. 38
DM1/DM2 .................................................................................................................................... 38
Standard Messages..................................................................................................................... 39
Special EMR Messages .............................................................................................................. 39
Special S6 Messages.................................................................................................................. 40
Monitoring the Interface......................................................................................................................... 40
Watchdogs............................................................................................................................................. 40
APPENDIX A. TELEGRAMS......................................................................................................41
Transmission Telegram......................................................................................................................... 41
Remote Control Telegram ..................................................................................................................... 53
APPENDIX B. CANOPEN ........................................................................................................54
Description of the Common Data Types................................................................................................ 54
Structure of the PDO-COB-ID Entry (UNSIGNED32)................................................................. 54
Description of the Object Parameter ..................................................................................................... 55
Data Format of Different Functions ....................................................................................................... 62
Receiving Messages ................................................................................................................... 62
Definition of Protocol Descriptions......................................................................................................... 63
Unsigned Integer......................................................................................................................... 63
Signed Integer............................................................................................................................. 64
Transmission Telegram............................................................................................................... 65
CANopen: Mapping-Parameter................................................................................................... 70
J1939 Measuring values........................................................................................................................ 81
J1939 Standard Measuring Values............................................................................................. 81
J1939 Messages of DM1 Advise................................................................................................. 82
J1939 Messages of DM2 Advise................................................................................................. 83
J1939 Appendix for S6................................................................................................................ 84
J1939 Appendix for EMR ............................................................................................................ 84
J1939 Appendix for MTU ADEC.................................................................................................. 85
APPENDIX C. SUPPORTED REMOTE CONTROL MESSAGES FOR ECUS......................................86
APPENDIX D. APPLICATION EXAMPLES...................................................................................87
Remote Control...................................................................................................................................... 87
Configuration of the LogicsManager Functions........................................................................... 87
Remote Control Telegram ..................................................................................................................... 89
Remote Control via CAN ....................................................................................................................... 90
Remote Start/Stop/Acknowledgement ........................................................................................ 90
Remote Control via Modbus.................................................................................................................. 93
Sending a Data Protocol via TPDO....................................................................................................... 95
Cyclically Sending of Data........................................................................................................... 95
Sending of Data on Request ....................................................................................................... 95

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 5/96
Chapter 1.
General Information
Related Documents
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
Type
English
German
easYgen-1000 Series
easYgen-1000 - Installation
37390
GR37390
easYgen-1000 - Configuration
37391
GR37391
easYgen-1000 - Operation
37392
GR37392
easYgen-1000 - Interfaces
this manual 
37393
GR37393
easYgen-1000 - Application
37394
GR37394
Additional Manuals
IKD 1 - Manual
37135
GR37135
Discrete expansion board with 8 discrete inputs and 8 relay outputs that can be coupled via the CAN bus to the control unit. Evalua-
tion of the discrete inputs as well as control of the relay outputs is done via the control unit.
LeoPC1 - User Manual
37146
GR37146
PC program for visualization, configuration, remote control, data logging, language upload, alarm and user management, and man-
agement of the event recorder. This manual describes the set-up of the program and interfacing with the control unit.
LeoPC1 - Engineering Manual
37164
GR37164
PC program for visualization, configuration, remote control, data logging, language upload, alarm and user management, and man-
agement of the event recorder. This manual describes the configuration and customization of the program.
GW 4 - Manual
37133
GR37133
Gateway for transferring the CAN bus to any other interface or bus.
ST 3 - Manual
37112
GR37112
Control to govern the air fuel ratio of a gas engine. The ratio will be directly measured though a Lambda probe and controlled to a
configured value.
Table 1-1: Manual - overview
Intended Use The unit must only be operated in the manner described by this manual. The prerequisite for a
proper and safe operation of the product is correct transportation, storage, and installation as well as careful oper-
ation and maintenance.
NOTE
This manual has been developed for a unit fitted with all available options. Inputs/outputs, functions,
configuration screens, and other details described, which do not exist on your unit, may be ignored.
The present manual has been prepared to enable the installation and commissioning of the unit. Due to
the large variety of parameter settings, it is not possible to cover every combination. The manual is
therefore only a guide. In case of incorrect entries or a total loss of functions, the default settings may
be taken from the list of parameters enclosed in the configuration manual 37391.

Manual 37393C easYgen-1000 Series - Interfaces
Page 6/96 © Woodward
Interface Overview
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
The easYgen-1000 provides the following communication interfaces:
Serial interface (DPC)
LeoPC1 or Modbus Protocol
CAN interface
CANopen, CAN CAL, or CAN J1939 Protocol
NOTE
ECU data in J1939 format may be sent simultaneously with data in CANopen format on the same bus.
However, the baud rate must be the same.
Figure 1-1: Interface overview
WARNING
When connecting the direct configuration interface, the Woodward DPC with RJ45 connector must be
used. Failure to do so may destroy the unit.

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 7/96
Figure 1-2: Interface overview - serial interface
Modbus Half/Full Duplex Application
NOTE
Not every RS-232/RS-485 converter is suitable for this application when using more than one easYgen
because the converter has to control the data of the connected easYgen units.
The following model of the company Amplicon meets this requirements: Magic 485F9
This converter has also been verified for single unit applications.
Please refer to the manufacturer's homepage for further information about the suitable Amplicon RS-
485/RS-232 converter under http://www.amplicon.co.uk.

Manual 37393C easYgen-1000 Series - Interfaces
Page 8/96 © Woodward
Figure 1-3: Interface overview - serial interface Modbus full-duplex
Figure 1-4: Interface overview - serial interface Modbus half-duplex

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 9/96
CAN Bus
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
Figure 1-5: CAN bus topology - CAN CAL
Characteristics of the CAN interface used by Woodward:
Standard: Compatible with ISO 11898
Electrically isolated: Isolation voltage 1,500 VDC
NOTE
Please note that the CAN bus must be terminated with an impedance which corresponds to the wave
impedance of the cable (e.g. 120 Ohm, ¼ W). The CAN bus is terminated between CAN-H and CAN-L.
Figure 1-6: Interface - The CAN bus loop
Bus line Bus line Bus line Bus line
Terminantion
resistor Terminantion resistor
120 Ohm 120 Ohm
CAN_H
CAN_L
CAN bus
Node 1 Node 30

Manual 37393C easYgen-1000 Series - Interfaces
Page 10/96 © Woodward
Chapter 2.
Data Telegrams
Interface Monitoring
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
It is possible to monitor the interface for received data. Refer to the configuration manual for more information
about this monitoring function.
Transmit Telegram
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
The transmit telegram provides all measuring and status data of the easYgen. The data have different addresses
and will be transmitted in the respective format depending on the selected interface.
Modbus
Data transmission in Modbus format is performed in the order of the transmit telegram (refer to Appendix A:
Transmission Telegram on page 41). The data addresses may be taken from the respective column of the transmit
telegram.
CAN (CAL)
The easYgen sends its data via cyclic CAN messages. If a GW 4 is used, the baud rate must be configured to
125 kBaud.
NOTE
Instead of using a GW 4, a CAN to USB (or RS-232) converter may be used.
CANopen
Using the mapped objects, which are described in detail starting on page 25, enables you to send data by setting
the object ID 2C76h on the basis of the CANopen protocol.
This document contains tables of further mapped objects, which may be configured in refer to Appendix A:
Transmission Telegram on page 41.
NOTE
When using the mapped objects listed in the appendix instead of the complete transmit telegram, the
refresh rate of the single messages may be reduced.

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 11/96
Receive Telegram
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
Starting with V2.xxx the genset may be started, stopped, and acknowledged via the interface.
In order to execute the desired command, a rise of the pulse of the respective signal from Low to High is re-
quired.
It must be observed that the combination of remote start and remote stop create the logical command varia-
ble 04.13. This command variable may be used as input of the LogicsManager in the easYgen.
Figure 2-1: Data telegrams - remote control signals
An acknowledgement command must be sent twice to acknowledge a fault, which is not present anymore. The
first rise of the pulse resets the horn. The second rise of the pulse acknowledges the unit, if the fault is not present
anymore.
NOTE
Please note that the respective remote control parameters must be configured in the LogicsManager of
the unit. Refer to the application manual 37394 for more detailed information about this.
Modbus
It is possible to remote control the easYgen using the bits 0 to 4 of control word 1 on address 503. The Remote
Control Telegram in Appendix A on page 53 is valid for both, CANopen as well as Modbus, and indicates the ar-
rangement of the remote control bits.
Start/Stop:
Start bit
Stop bit
4.13 Remote
start request
Start/Stop:
Start bit
Stop bit
4.13 Remote
start request

Manual 37393C easYgen-1000 Series - Interfaces
Page 12/96 © Woodward
CAN (CAL)
The Woodward LeoPC1 software may be used to remote control the easYgen via a connected PC. After selecting
the desired remote control command, the remote control command must be confirmed by selecting the "Set" but-
ton.
Figure 2-2: Data telegrams - remote control via CAN
CANopen
It is possible to remote control the easYgen using the bits 0 to 4 of control word 1 on address 503. The Remote
Control Telegram in Appendix A on page 53 is valid for both, CANopen as well as Modbus, and indicates the ar-
rangement of the remote control bits.

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 13/96
Chapter 3.
Serial Interface
Overview
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
Figure3-1: Serial interface - overview
Baudrate: XXX
(Parity,Stop Bits)
Baudrate
Baudrate:
:XXX
(Parity,Stop Bits) Serial Interface :
Modbus Protocol :
LeoPC1
PLC RS-485 Port
RS-232/RS-485
Converter
PLC COM Port ModbusSlaveID
ModbusSlaveID :
: 0 to 255
ModbusReplyDelay
ModbusReplyDelay :
:0 to 1000ms
Modem
Baudrate
Baudrate:
:XXX
(Parity,Stop Bits)

Manual 37393C easYgen-1000 Series - Interfaces
Page 14/96 © Woodward
Modbus RTU Slave
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
General Information
Modbus is a serial communications protocol published by Modicon in 1979 for use with its programmable logic
controllers (PLCs). It has become a de facto standard communications protocol in industry, and is now the most
commonly available means of connecting industrial electronic devices. The easYgen supports a Modbus RTU
Slave module. This means that a Master node needs to poll the easYgen slave node. Modbus RTU can also be
multi-dropped, or in other words, multiple Slave devices can exist on one Modbus RTU network, assuming that
the serial interface is a RS-485. Detailed Information about the Modbus protocol are available on the following
website:
http://www.modbus.org/specs.php
There are also various tools available on the internet. We recommend to use ModScan32 which is a Windows ap-
plication designed to operate as a Modbus Master device for accessing data points in a connected Modbus Slave
device. It is designed primarily as a testing device for verification of correct protocol operation in new or existing
systems. It is possible to download a trial version from the following website:
http://www.win-tech.com/html/modscan32.htm

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 15/96
Modbus Addressing and Data Model
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
The easYgen Modbus slave module distinguishes between visualization data and configuration & remote control
data. The different data is accessible over a split address range and may be read via the "Read Holding Register"
function. Furthermore, easYgen parameters and remote control data can be written with the "Preset Single Regis-
ters" function or "Preset Multiple Registers" (refer to figure below).
Modicon
address
easYgen
visualization data
Modbus commands:
Read Holding Register (0x03)
450001
450000
easYgen
remote control
&
configuration data
Read Holding (0x03)
Preset Multiple Registers (0x10)
Preset Single Register (0x06)
40001
NOTE
All addresses in this document comply with the Modicon address convention. Some PLCs or PC pro-
grams use different address conventions depending on their implementation. Then the address must
be increased and the leading 4 may be omitted.
Please refer to your PLC or program manual for more information. This determines the address sent
over the bus in the Modbus telegram. The Modbus starting address 450001 of the visualization data
may become bus address 50000 for example.
In case the PLC discovers problems with the reading of the Modbus data (CRC alarm), the amount of
reading words has to be reduced to <=24.

Manual 37393C easYgen-1000 Series - Interfaces
Page 16/96 © Woodward
Visualization
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
The visualization over Modbus is provided in a very fast data protocol where important system data like alarm
states, AC measurement data, switch states and various other information may be polled. According to the easY-
gen Modbus addressing range, the visualization protocol can be reached on addresses starting at 450001. On this
address range it is possible to do block reads from 1 up to 128 Modbus registers at a time.
Modbus Read
Addresses
Description
Multiplier
Units
450001
Protocol-ID
--
450002
Generator: Voltage VL12
0.1
V
............
.........
.....
.....
............
.........
.....
.....
............
.........
.....
.....
............
.........
.....
.....
450184
Failure codes from MTU ADEC ECU
-
-
Table 3-1: Modbus - address range block read
NOTE
Table 3-1 is only an excerpt of the data protocol. It conforms to the data protocol, that is also used by
CAN bus. Refer to Appendix A: Transmission Telegram on page 41 for the complete protocol.
The following exemplary ModScan32 screenshot shows the configurations made to read the visualization proto-
col with a block read of 128 registers.
Figure 3-2: Modbus - visualization configurations

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 17/96
Configuration
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
The Modbus interface can be used to read/write parameters of the easYgen. According to the easYgen Modbus
addressing range for the configuration addresses, the range starts at 40001 and ends at 450000. You can always
access only one parameter of the system in this address range. The Modbus address can be calculated depending
on the parameter ID as illustrated below:
Parameter ID < 10000
Parameter ID >= 10000
Modbus address =
40000 + (Par. ID+1)
400000 + (Par. ID+1)
Table 3-2: Modbus - address calculation
Block reads in this address range depend on the data type of the parameter. This makes it important to set the cor-
rect length in Modbus registers which depends on the data type (UNSIGNED 8, INTEGER 16, etc.). Refer to Ta-
ble 3-3 for more information.
easYgen
types
Modbus
registers
UNSIGNED 8
1
UNSIGNED 16
1
INTEGER 16
1
UNSIGNED 32
2
INTEGER 32
2
LOGMAN
7
TEXT/X
X/2
Table 3-3: Modbus - data types
NOTE
The parameters of the following examples are an excerpt of the parameter list in the appendix of the
Configuration Manual 37391. Please refer to this manual for the complete parameter list.
NOTE
Be sure to enter the password for code level 2 or higher for the corresponding interface to get access
for changing parameter settings.
NOTE
The new entered value must comply with the parameter setting range when changing the parameter
setting.

Manual 37393C easYgen-1000 Series - Interfaces
Page 18/96 © Woodward
Example 1: Addressing the password for serial interface1:
Par.
ID.
Parameter
Setting range
Data type
10401
Password for serial interface1
0000 to 9999
UNSIGNED 16
Modbus address = 400000 + (Par. ID +1) = 410402
Modbus length = 1 (UNSIGNED 16)
The following Modscan32 screenshot shows the configurations made to address parameter 10401.
Figure 3-3: Modbus - configuration example 1
Example 2: Addressing the generator rated voltage:
Par.
ID.
Parameter
Setting range
Data type
1766
Generator rated voltage
50 to 650000 V
UNSIGNED 32
Modbus address = 40000 + (Par. ID +1) = 41767
Modbus length = 2 (UNSIGNED 32)
The following Modscan32 screenshot shows the configurations made to address parameter 1766.
Figure 3-4: Modbus - configuration example 2

Manual 37393C easYgen-1000 Series - Interfaces
© Woodward Page 19/96
Example 3: Addressing the generator voltage measuring:
Par.
ID.
Parameter
Setting range
Data type
1851
Generator voltage measuring
3Ph 4W {0}
3Ph 3W {1}
1Ph 2W {2}
1Ph 3W {3}
UNSIGNED 16
Modbus address = 40000 + (Par. ID +1) = 41852
Modbus length = 1 (UNSIGNED 16)
NOTE
If the setting range contains a list of parameter settings like in this example, the parameter settings are
numbered and start with 0 for the first parameter setting. The number corresponding with the respec-
tive parameter setting must be configured.
The following Modscan32 screenshot shows the configurations made to address parameter 1851, which is con-
figured to "3Ph 4W".
Figure 3-5: Modbus - configuration example 3

Manual 37393C easYgen-1000 Series - Interfaces
Page 20/96 © Woodward
Exception Responses
≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
The easYgen Modbus interface has multiple exception responses to show that a request could not be executed.
Exception responses can be recognized if the response telegram contains the request function code with an offset
of 128 (0x80 hex).
Table 3-4 explains possible reasons for an exception response that occurred.
easYgen Modbus
Exception Responses
Code
Name
Reason
01
ILLEGAL FUNCTION
The sent request function code is not supported by the easYgen
Modbus interface.
02
ILLEGAL ADDRESS
Permission to read/write the parameter is denied.
The amount of requested registers is wrong to read/write this reg-
isters.
03
ILLEGAL DATA VALUE
The data value exceeds the min. and max. limitations of the pa-
rameter upon a write request.
There is no parameter on the requested address.
Table 3-4: Modbus - exception responses