Codesys 3

CoDeSys Automation Alliance
CoDeSys V3
Ethernet Driver
1 System Configuration....................................................................................................... 3
2 External Device Selection ................................................................................................ 6
3 Communication Settings .................................................................................................. 7
4 Setup Items .................................................................................................................... 19
5 Supported Devices......................................................................................................... 24
6 Device Code and Address Code.................................................................................... 36
7 Error Messages.............................................................................................................. 37
1
CoDeSys V3 Ethernet Driver
Introduction
This manual describes how to connect the Display and the External Device (target PLC).
In this manual, the connection procedure will be described in the sections identified below:
1 System Configuration
 "1 System Configuration" (page 3)
This section lists the types of External
Devices and SIO that you can connect.
2 External Device Selection

 "2 External Device Selection" (page 6)
Select a model (series) of the External
Device and its connection method.
3 Communication Settings
"3 Communication Settings" (page 7)
This section shows setting examples for
communicating between the Display and
the External Device.
4 Setup Items
"4 Setup Items" (page 19)
This section describes communication
setup items on the Display. Set the
Display’s communication settings in GP
Pro-EX or in off-line mode.
Operation
GP-Pro EX Device/PLC Connection Manual 2

1 System Configuration
The system configuration for the Display connected to the CoDeSys Automation Alliance External Device is
shown below.
Communication
Series CPU Link I/F Setting Example
Method
3S-Smart Software Solutions
"Setting Example 1"
GmbH PC/AT Ethernet Interface Ethernet (TCP)
(page 7)
CODESYS Control Win V3
1006
Hitachi Industrial Equipment
1025 "Setting Example 1"
Systems Co., Ltd. Ethernet Interface Ethernet (TCP)
1051 (page 7)
EHV+
1102
HX-CP1S08
Hitachi Industrial Equipment HX-CP1H16
"Setting Example 2"
Systems Co., Ltd. HX-CP1S08M Ethernet Interface Ethernet (TCP)
(page 10)
HX HX-CP1H16M
HXC-CP1H16
Lenze Vertrieb GmbH "Setting Example 1"
3200C Ethernet Interface Ethernet (TCP)
Controller 3200C (page 7)
M241 "Setting Example 3"
Ethernet Interface Ethernet (TCP)
Schneider Electric SA M251 (page 13)
Modicon "Setting Example 4"
M262 Ethernet Interface Ethernet (TCP)
(page 16)
• Please refer to the latest list of the External Device to be supported by this driver on the Pro-
face’s website.
http://www.pro-face.com/product/soft/gpproex/driver/driver.html
• This driver does not support GP3000 Series, LT3000 Series, GP-4100 Series (Monochrome
Model), GP-4*01TM and GP-Rear Module.
 Connection Configuration
• 1:1 Connection

• 1:n Connection
• 1:n Connection (Gateway connection)
• n:1 Connection
* The number of Displays you can connect depends on the External Device. Check the specifications of the
External Device.

• n:m Connection
* The number of Displays you can connect depends on the External Device. Check the specifications of the
External Device.

2 External Device Selection
Select the External Device to be connected to the Display.
Setup Items Setup Description

Use an integer from 1 to 2 to enter the number of Devices/PLCs to connect to the
display.
Number of Devices/PLCs
• When you set up the CoDeSys Automation Alliance CoDeSys V3 Ethernet driver,
you can connect simultaneously up to two drivers (models that support four
drivers) or one driver (models that support two drivers).
Select the manufacturer of the External Device to be connected. Select "CoDeSys
Manufacturer
Automation Alliance".
Select a model (series) of the External Device to be connected and connection
method. Select "CoDeSys V3 Ethernet".
Series Check the External Device which can be connected in "CoDeSys V3 Ethernet" in
system configuration.
 "1 System Configuration" (page 3)
Select the Display port to be connected to the External Device. Select [Ethernet
Port
(TCP)].
Check this option to synchronize the system data area of the Display and the device
(memory) of the External Device. When synchronized, you can use the External
Device’s ladder program to switch the display or display the window on the Display.
Cf. GP-Pro EX Reference Manual "LS Area (Direct Access Method
Area)"
Use System Area
This feature can also be set in GP-Pro EX or in the Display's offline mode.
Cf. GP-Pro EX Reference Manual "System Settings [Display Unit] -
[System Area] Settings Guide"
Cf. Maintenance/Troubleshooting Guide "Main Unit - System Area
Settings"

3 Communication Settings
Examples of communication settings of the Display and the External Device, recommended by Pro-face, are
shown.
3.1 Setting Example 1

 Settings of GP-Pro EX
 Communication Settings
To display the setup screen, from the [Project] menu, point to [System Settings] and select [Device/PLC].

 Device Setting
To display the [Individual Device Settings] dialog box, from [Device-Specific Settings] in the [Device/PLC]
window, select the External Device and click [Settings] . To connect multiple External Devices, from
[Device-Specific Settings] in the [Device/PLC] window, click [Add Device] to add another External Device.
• When using a gateway, select the [Connect via Gateway] check box and set the gateway's IP
address and port number.
• While using a display unit other than IPC, PC/AT compatible machine, or SP5000 Series Open
Box and the gateway restarts, communication may not be restored. If that happens, restart the
display unit.
• Use the programming software for the External Device to check the gateway's node name,
node address and IP address.
• Check with a network administrator about IP address. Do not set the duplicate IP address in
the same network.
• Set up the External Device's IP address and Port Number in the [Individual Device Settings]
dialog box.
• Set up the Display's IP address in offline mode.

 Settings of External Device

Use the programming software for the External Device to define its communication settings. Please refer to the
manual of the External Device for more details.
1 In the programming software, create a project.

2 Select [Device] from the [Devices] tree view.
3 Click [Scan network] and search for the External Device to use.
• When searching for External Devices, the External Device and host must exist on the same
network. Please refer to the manual of the External Device for more details.
4 Select the added External Device, and confirm the [Node Name] or [Node Address].
• When using a gateway, check the gateway's IP address and port number.



 Device Setting
display unit.
the same network.
dialog box.


1 Create a project in the programming software.

2 From the [Devices] tree view double-click [Device].
3 Click [Scan network] to find the External Device.
• To search for External Devices, the External Device must be on the same network as the host.
For information, refer to the manual of the External Device.
4 Select the External Device, and click [OK].

5 Click [PLC Parameters] and set up the communication port as follows.

IP Address 192.168.0.1
Subnet Mask 255.255.255.0
Change IP information Yes
• ETH1, ETH2, and ETH3 cannot be set to the same network.

• When changing the IP address, set [Change IP information] to [Yes].
6 From the [Online] menu select [Login], and log in to the External Device.
7 Download the project and restart the External Device.



 Device Setting
display unit.
the same network.
• In the [Node Name (or) Address] field, set the device name of the External Device. You
cannot use the IP address for communication.



2 From the [View] menu, select [Navigators]-[Devices tree].
3 From the [Devices tree], double-click the [MyController].
4 Click [Controller selection].
5 Right-click the External Device, and select [Change device name].
6 Input the [Device name].
• The setting of Device name have to be identical to that of GP-Pro EX.
7 Click [OK].
• When communicating with GP-Pro EX, set the Device name for the External Device. IP
addresses cannot be used for communication.



 Device Setting
display unit.
the same network.
dialog box.



2 From the [View] menu, select [Navigators]-[Devices tree].
3 From the [Devices tree], double-click the [MyController].
4 Click [Controller selection].
5 Right-click the External Device, and select [Change device name].
6 Input the [Device name].
• The setting of Device name have to be identical to that of GP-Pro EX.
7 Click [OK].

4 Setup Items
Set communication settings of the Display with GP-Pro EX or in offline mode of the Display.
The setting of each parameter must be identical to that of External Device.
"3 Communication Settings" (page 7)
• Set the Display’s IP address in off-line mode.
Cf. Maintenance/Troubleshooting Guide "Ethernet Settings"
4.1 Setup Items in GP-Pro EX

 Communication Settings

Displays the port number of the Display, from 1024 to 65535.
Port No.
The port number is set automatically.
Time (in seconds) that the Display waits for a response from the External Device, from 1 to
Timeout
127.
Number of times, from 0 to 255, the Display will re-transmit a command when it does not
Retry
receive a response from the External Device.
Amount of time, from 0 to 255 milliseconds, the Display waits after receiving a
Wait To Send
communication packet before transmitting the next command.
• Refer to the GP-Pro EX Reference Manual for information on Indirect Devices.
Cf. GP-Pro EX Reference Manual "Changing the Device/PLC at Runtime (Indirect

Device)"

 Device Setting
window, select the external device and click [Settings] .
To connect multiple External Devices, from [Device-Specific Settings] in the [Device/PLC] window, click [Add
Device] to add another External Device.

Node Name (or) Enter the node name or node address of the connected External Device. When you enter the
Address node name or node number, settings such as the IP address become unnecessary.
Use Tcp/Ip Select this check box to specify the External Device's IP address and port number.
Set the External Device's IP address.
IP Address
• Check with a network administrator about IP address. Do not set the duplicate IP address.
Port No. Enter the External Device's port number.
Use User
Select this check box when the connected External Device performs user management.
Management
User Enter the user name.
Password Enter the password.


Connect via Gateway When using a gateway, select this check box.
Set the gateway's IP address.
IP Address
• Check with a network administrator about IP address. Do not set the duplicate IP address.
Port No. Enter the gateway's port number.
Select this check box.
Use Tag Data Click [New], and import the tag data to use.
 "  Importing Tag File" (page 27)

4.2 Setup Items in Offline Mode
• Please refer to Maintenance/Troubleshooting Guide for more information on how to enter

offline mode or about operation.
Cf. Maintenance/Troubleshooting Guide "Offline Mode"
• The number of the setup items to be displayed for 1 page in the offline mode depends on the
Display in use. Please refer to the Reference manual for details.
 Communication Settings
To display the setting screen, touch [Device/PLC Settings] from [Peripheral Settings] in offline mode. Touch the
External Device you want to set from the displayed list.

Displays the port number of the Display, from 1024 to 65535.
Port No.
The port number is set automatically.
Time (in seconds) that the Display waits for a response from the External Device, from 1 to
Timeout
127.
Number of times, from 0 to 255, the Display will re-transmit a command when it does not
Retry
receive a response from the External Device.
Amount of time, from 0 to 255 milliseconds, the Display waits after receiving a
Wait To Send
communication packet before transmitting the next command.

 Device Setting
To display the setting screen, touch [Device/PLC Settings] from [Peripheral Settings]. Touch the External Device
you want to set from the displayed list, and touch [Device].

Select the External Device to set up. The device name is the name of the External Device
Device/PLC Name
defined in GP-Pro EX. The initial value is [PLC1].
Node Address Displays the node name or node address of the connected External Device.
Select [Enable] to specify the External Device's IP address and port number.
TCP Connection
When you select [Disable], the [IP Address (Tcp)] and [Tcp Port] properties are disabled.
Set the External Device's IP Address.
IP Address(Tcp)
• Check with a network administrator about IP address. Do not set the duplicate IP
address.
Tcp Port Enter the External Device's port number.
Select [Enable] when the connected External Device performs user management. Use the
UserManagement user name and password set in GP-Pro EX.
 "  Device Setting" (page 20)
When using a gateway, select [Enable].
Gateway
When you select [Disable], the [Gateway IP] and [Gateway Port] properties are disabled.
Set the gateway's IP address.
Gateway IP
• Check with a network administrator about IP address. Do not set the duplicate IP
address.
Gateway Port Enter the gateway's port number.

5 Supported Devices
Range of supported device addresses is shown in the table below. Please note that the actual supported range of
devices varies on the External Device in use. Please check the actual range in the manual for your connected
equipment.
You can import tag data from the project created by your programming software.
This address can be specified as system data area.
Device Bit Address Word Address 32 bit Notes

Single <TAGNAME> -
<TAGNAME>[xl] -
1D Array
<TAGNAME>[xh]
*1
BOOL <TAGMNAME>[xl,yl] - -
2D Array
<TAGNAME>[xh,yh]
<TAGNAME>[xl,yl,zl] -
3D Array
<TAGNAME>[xh,yh,zh]
<TAGNAME>.00 -
Single <TAGNAME>
<TAGNAME>.07
<TAGNAME>[xl].00 - <TAGNAME>[xl] -
BYTE 1D Array
<TAGNAME>[xh].07 <TAGNAME>[xh]
*1
SINT
USINT <TAGNAME>[xl,yl].00 - <TAGNAME>[xl,yl] -
2D Array
<TAGNAME>[xh,yh].07 <TAGNAME>[xh,yh]
<TAGNAME>[xl,yl,zl].00 - <TAGNAME>[xl,yl,zl] -
3D Array
<TAGNAME>[xh,yh,zh].07 <TAGNAME>[xh,yh,zh]
<TAGNAME>.00 -
Single <TAGNAME>
<TAGNAME>.15
INT 1D Array
*1*2
UINT
WORD <TAGNAME>[xl,yl].00 - <TAGNAME>[xl,yl] -
2D Array
3D Array
<TAGNAME>.00 -
Single <TAGNAME>
<TAGNAME>.31
DINT 1D Array
*1
UDINT
DWORD <TAGNAME>[xl,yl].00 - <TAGNAME>[xl,yl] -
2D Array
3D Array


Single <TAGNAME>
DATE
REAL <TAGNAME>[xl] -
1D Array
TIME <TAGNAME>[xh]
*1
TOD - <TAGNAME>[xl,yl] -
2D Array
<TAGNAME>[xh,yh]
TIME_OF_
DAY <TAGNAME>[xl,yl,zl] -
3D Array
<TAGNAME>[xh,yh,zh]
Single <TAGNAME>
<TAGNAME>[xl] -
1D Array
DATE_AND <TAGNAME>[xh]
*1*3
_TIME - <TAGNAME>[xl,yl] - -
DT 2D Array
<TAGNAME>[xh,yh]
3D Array
<TAGNAME>[xh,yh,zh]
Single <TAGNAME>
<TAGNAME>[xl] -
1D Array
<TAGNAME>[xh]
*1
STRING - <TAGNAME>[xl,yl] - -
2D Array
<TAGNAME>[xh,yh]
3D Array
<TAGNAME>[xh,yh,zh]
<TAGNAME>.00 -
Single <TAGNAME>
<TAGNAME>.63
LINT 1D Array
*4
LWORD -
ULINT <TAGNAME>[xl,yl].00 - <TAGNAME>[xl,yl] -
2D Array
3D Array
Single <TAGNAME>
<TAGNAME>[xl] -
1D Array
<TAGNAME>[xh]
*4
LREAL - <TAGNAME>[xl,yl] - -
2D Array
<TAGNAME>[xh,yh]
3D Array
<TAGNAME>[xh,yh,zh]
Single <TAGNAME>
<TAGNAME>[xl] -
1D Array
<TAGNAME>[xh]
*4
LTIME - <TAGNAME>[xl,yl] - -
2D Array
<TAGNAME>[xh,yh]
3D Array
<TAGNAME>[xh,yh,zh]


Single <TAGNAME>
<TAGNAME>[xl] -
1D Array
<TAGNAME>[xh]
*5
WSTRING - <TAGNAME>[xl,yl] - -
2D Array
<TAGNAME>[xh,yh]
3D Array
<TAGNAME>[xh,yh,zh]
*1 <TAGNAME>: When referring to structures, the TagName includes the structure name. The maximum
number of characters for the Tag Name is 255, which includes delimiters and elements.
Example)
BOOL type single symbol "BOOLSYMBOL"
BOOL type 1D Array "BOOL1D[10]
WORD type 2D Array "WORD2D[10,10]
UDINT type 3D Array "UDINT3D[0,1,2]
STRING in User Defined Structure [STRUCT001] "STRUCT001.STRINGSYM"
*2 Initially, 16 words of items are selected for the system data area. When selecting less than 16 words, set
up a tag array with more than 16 words, allocate it to the system data area, and select the items.
*3 64-bit data type on the Display, 32-bit data type on the External Device.
*4 64-bit data type on the External Device, 32-bit data type on the Display. (The Display uses just the
bottom 4 bytes and the top 4 bytes are ignored.)
When a bit is specified, normal writing cannot be performed for 31-bit to 63-bit.
*5 Tag data can be imported. Do not use it, however, since it is the data type which is not supported by the
Display.
• When connecting with EHV+ Series, arrays cannot be used for the Display.
• Sub-Scope is shown on the Display as 'Scope'$'Sub-Scope'. ('$' is delimiter)

• When importing ENUM data types, the member name is converted to ENUM0. The value “0”
is assigned to ENUM0.
• Naming rules for the Tag Name, Data type name and Scope name are as follows:
• Special characters are not allowed.
• Consecutive underscore '_' are not allowed.
• You cannot start names with any of the following text:
LS, USR, SCR, PRT 
• Maximum 255 characters.
• Imported BIT type variables are converted to BOOL devices. To import BIT type variables,
you need to output a symbol file from the configuration software for CoDeSys Runtime
version 3.5 SP6 or later.
• Please refer to the GP-Pro EX Reference Manual on the system data area.
Cf. GP-Pro EX Reference Manual "LS Area (Direct Access Method Area)"
• Please refer to the precautions on manual notation for icons in the table.
 "Manual Symbols and Terminology"

 Importing Tag File

 3S-Smart Software Solutions, Lenze Vertrieb, Hitachi Industrial Equipment Systems EHV+ Series
1 Use the programming software to create symbols.
2 In the [Devices] tree view, right-click [Application].
3 From the menu select [Add Object]-[Symbol configuration].
4 Move symbols you want to use on the Display to the [Selected variables] area.
5 Build the project and download to the External Device. Symbol data (xml file) is created when downloading.
6 In GP-Pro EX, display the [Individual Device Settings] dialog box and select the [Use Tag Data] check box.

7 Click [New] to display the [Tag List] window.
8 Click [Import].

9 From [Select File] click [Browse..], and select the symbol data (xml file).
10 Select the symbols you want to import, and click [OK].
• Please refer to "Using Device/PLC Tags" of the GP-Pro EX Reference Manual for the importing
tag.

 Hitachi Industrial Equipment Systems HX Series

1 In the programming software, create symbols in PLC__PRG.
2 From the [Devices] tree view, right-click [Application].
3 From the menu select [Add Object]-[Symbol configuration].
4 Select the check box of symbols that will be used on the display unit.
5 Build the project and download to the External Device. A symbol data file (xml file) is created at download.
6 In GP-Pro EX, from the [Individual Device Settings] dialog box, select the [Use tag data] check box.

8 Click [Import].

tag.

 Schneider Electric SA
1 In the configuration tool, create a symbol.
2 Build the project. On build, symbol data (xml file) is generated.
3 In GP-Pro EX, display the [Individual Device Settings] dialog box and select the [Use Tag Data] check box.

5 Click [Import].

tag.

6 Device Code and Address Code
Device code and address code cannot be used.

7 Error Messages
Error messages are displayed on the screen of Display as follows: "No. : Device Name: Error Message (Error
Occurrence Area)". Each description is shown below.
Item Description
No. Error No.
Name of External Device where error occurs. Device name is a title of External Device set
Device Name
with GP-Pro EX. (Initial value [PLC1])
Error Message Displays messages related to the error which occurs.
Displays IP address or device address of External Device where error occurs, or error codes
received from External Device.
Error Occurrence Area

• IP address is displayed such as "IP address (Decimal): MAC address (Hex)".
• Device address is displayed such as "Address: Device address".
• Received error codes are displayed such as "Decimal [Hex]".
Display Examples of Error Messages

"RHAA035: PLC1: Error has been responded for device write command (Error Code: 2 [02H])"
• Refer to your External Device manual for details on received error codes.
• Refer to "Display-related errors" in "Maintenance/Troubleshooting Guide" for details on the
error messages common to the driver.
 Error Messages Unique to External Device
Message ID Error Message Description

This message appears when the Display cannot
communicate with the External Device, or when
communication is interrupted.
(Node Name): Connection open error
RHxx128 Check the External Device settings.
(Node: %s)
(This message appears when using the node
address or the node name for communication
with the External Device.)
(Node Name): %s:Symbol mismatch with This message appears when accessing a symbol
RHxx129 Device/PLC. Please update TagData in that does not exist.
the project. Make sure the tag data matches the symbol file.
This message appears when writing an out of
(Node Name): %s:Out of range value in
RHxx130 range value.
write request (Address:%s)
Check the write values.

Codesys 3

Uploaded by

Copyright:

Available Formats

Codesys 3

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Codesys 3

Uploaded by

Copyright:

Available Formats

CoDeSys Automation Alliance

2 External Device Selection

GP-Pro EX Device/PLC Connection Manual 2

GP-Pro EX Device/PLC Connection Manual 3

• 1:n Connection (Gateway connection)

GP-Pro EX Device/PLC Connection Manual 4

GP-Pro EX Device/PLC Connection Manual 5

2 External Device Selection

Select the External Device to be connected to the Display.

Setup Items Setup Description

GP-Pro EX Device/PLC Connection Manual 6

3.1 Setting Example 1

GP-Pro EX Device/PLC Connection Manual 7

GP-Pro EX Device/PLC Connection Manual 8

 Settings of External Device

1 In the programming software, create a project.

GP-Pro EX Device/PLC Connection Manual 9

3.2 Setting Example 2

GP-Pro EX Device/PLC Connection Manual 10

GP-Pro EX Device/PLC Connection Manual 11

 Settings of External Device

1 Create a project in the programming software.

4 Select the External Device, and click [OK].

Setup Items Setup Description

• ETH1, ETH2, and ETH3 cannot be set to the same network.

GP-Pro EX Device/PLC Connection Manual 12

3.3 Setting Example 3

GP-Pro EX Device/PLC Connection Manual 13

GP-Pro EX Device/PLC Connection Manual 14

 Settings of External Device

1 In the programming software, create a project.

• The setting of Device name have to be identical to that of GP-Pro EX.

GP-Pro EX Device/PLC Connection Manual 15

3.4 Setting Example 4

GP-Pro EX Device/PLC Connection Manual 16

GP-Pro EX Device/PLC Connection Manual 17

 Settings of External Device

1 In the programming software, create a project.

• The setting of Device name have to be identical to that of GP-Pro EX.

GP-Pro EX Device/PLC Connection Manual 18

Cf. Maintenance/Troubleshooting Guide "Ethernet Settings"

4.1 Setup Items in GP-Pro EX

Setup Items Setup Description

• Refer to the GP-Pro EX Reference Manual for information on Indirect Devices.

Cf. GP-Pro EX Reference Manual "Changing the Device/PLC at Runtime (Indirect

GP-Pro EX Device/PLC Connection Manual 19

Setup Items Setup Description

GP-Pro EX Device/PLC Connection Manual 20

Setup Items Setup Description

GP-Pro EX Device/PLC Connection Manual 21

4.2 Setup Items in Offline Mode

• Please refer to Maintenance/Troubleshooting Guide for more information on how to enter

Setup Items Setup Description

GP-Pro EX Device/PLC Connection Manual 22

Setup Items Setup Description

GP-Pro EX Device/PLC Connection Manual 23

This address can be specified as system data area.

Device Bit Address Word Address 32 bit Notes

GP-Pro EX Device/PLC Connection Manual 24