WAGO MODBUS Master Configurator

Pos : 2 /D okumentati on allgemein/Ei nband/Ei nband H andbuch - Dec kbl att ohne Variantenfel d (Standar d) @ 9\mod_1285229289866_0.doc x @ 64941 @ @ 1
Manual
WAGO Software
MODBUS Master Configurator
for Configuration of MODBUS Networks with
WAGO-I/O-PRO (CODESYS)
Version 1.0.0
Pos : 3 /Alle Serien (Allgemeine M odul e)/Hinweise z ur Dokumentation/Impres sum für Standardhandbüc her - allg. Angaben, Ansc hriften, Tel efonnummer n und E-Mail-Adres sen @ 3\mod_1219151118203_21.doc x @ 21060 @ @ 1
2
WAGO Software
MODBUS Master Configurator
© 2014 by WAGO Kontakttechnik GmbH & Co. KG
All rights reserved.
WAGO Kontakttechnik GmbH & Co. KG
Hansastraße 27
D-32423 Minden
Phone:
Fax:
+49 (0) 571/8 87 – 0
+49 (0) 571/8 87 – 1 69
E-Mail:
info@wago.com
Web:
http://www.wago.com
Technical Support
Phone:
Fax:
+49 (0) 571/8 87 – 5 55
+49 (0) 571/8 87 – 85 55
E-Mail:
support@wago.com
Every conceivable measure has been taken to ensure the accuracy and
completeness of this documentation. However, as errors can never be fully
excluded, we always appreciate any information or suggestions for improving the
documentation.
E-Mail:
documentation@wago.com
We wish to point out that the software and hardware terms as well as the
trademarks of companies used and/or mentioned in the present manual are
generally protected by trademark or patent.
=== Ende der Liste für T extmar ke Ei nband_vorne ===
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Table of Contents
3
Pos : 5 /D okumentati on allgemein/Verzeic hnisse/Inhalts verz eichnis - Ü berschrift oG und Verzei chnis @ 3\mod_1219151230875_21.doc x @ 21063 @ @ 1
Table of Contents
1
1.1
1.2
1.3
1.4
1.5
Notes about this Documentation ................................................................. 5
Scope of Validity....................................................................................... 5
Copyright................................................................................................... 5
Symbols ..................................................................................................... 6
Number Notation ....................................................................................... 8
Font Conventions ...................................................................................... 8
2
Important Notes ........................................................................................... 9
2.1
Legal Bases ............................................................................................... 9
2.1.1
Subject to Changes ............................................................................... 9
2.1.2
Personnel Qualification ........................................................................ 9
2.2
System Requirements ................................................................................ 9
2.2.1
PC Hardware ........................................................................................ 9
2.2.2
PC Software ........................................................................................ 10
2.3
Hardware Constraints .............................................................................. 11
2.3.1
Supported MODBUS Master Devices................................................ 11
2.3.2
Hardware Interfaces............................................................................ 11
2.3.3
Acceptable MODBUS Slaves............................................................. 12
2.4
Safety Advice (Precautions) .................................................................... 12
3
3.1
3.2
3.3
General ........................................................................................................ 13
Installation ............................................................................................... 13
Preparation .............................................................................................. 13
Open MODBUS Master Configurator in WAGO-I/O-PRO ................... 14
4
The MODBUS Master Configurator ....................................................... 15
4.1
Function................................................................................................... 15
4.2
Configuration Procedure ......................................................................... 17
4.2.1
Step 1: "Create project" ...................................................................... 17
4.2.2
Step 2: "Configure MODBUS network" ............................................ 17
4.2.3
Step 3: "Configure network devices" ................................................. 18
4.2.4
Step 4: "Generate code"...................................................................... 19
4.2.5
Step 5: "Integrate into application" .................................................... 19
5
User Interface ............................................................................................. 20
5.1
Main View ............................................................................................... 20
5.2
"MODBUS network" Dialog .................................................................. 20
5.2.1
Context Menu for the "MODBUS master" Entry............................... 22
5.2.1.1
"Parameter code generator" Dialog ............................................... 23
5.2.2
Context Menu for the "Interface (COMx)" Entry .............................. 24
5.2.2.1
"Settings: Serial interface" Dialog ................................................. 25
5.2.2.2
"MODBUS slave selection" Dialog ............................................... 26
5.2.2.3
"Search device" Dialog .................................................................. 26
5.2.3
Context Menu for the "Interface (ETHERNET)" Entry ..................... 27
5.2.3.1
"MODBUS slave selection" Dialog ............................................... 28
5.2.3.2
"Search device" Dialog" ................................................................ 29
5.2.4
Context Menü for the "ModbusSlave" Entry ..................................... 30
5.2.4.1
"Communication settings" – Interface (COMx) Dialog) ............... 31
5.2.4.2
"Communication settings" – Interface (ETHERNET Dialog) ....... 32
Manual
Version 1.0.0
4
Table of Contents
5.2.4.3
5.2.5
5.2.5.1
5.2.6
5.2.7
5.2.7.1
WAGO Software
MODBUS Master Configurator
"MODBUS slave selection" Dialog ............................................... 34
Context Menu for the "Generic variables" Entry ............................... 35
"WAGO MODBUS register" Dialog ............................................. 36
Context Menu for the "PFC variables" Entry ..................................... 37
Context menu for the "K-Bus" Entry ................................................. 38
"Module selection" Dialog............................................................. 39
6
Operation .................................................................................................... 40
6.1
Make Network Presets ............................................................................ 40
6.2
Add Interface ........................................................................................... 41
6.2.1
Add Serial or ETHERNET Interface .................................................. 41
6.2.2
Configure Serial Interface .................................................................. 41
6.3
Insert and Configure MODBUS Slave .................................................... 41
6.3.1
Insert MODBUS Slave Online ........................................................... 41
6.3.2
Insert MODBUS Slave Offline .......................................................... 42
6.3.3
Configure MODBUS Slave ................................................................ 42
6.3.3.1
Configure MODBUS Slave via Serial Interface ............................ 42
6.3.3.2
Configure MODBUS Slave via ETHERNET Interface ................ 43
6.3.4
Configure WAGO MODBUS Slave Hardware Online ...................... 43
6.3.5
Configure WAGO MODBUS Slave Hardware Offline ..................... 43
6.4
Insert and Configure Variables ............................................................... 44
6.4.1
Add Generic Variables ....................................................................... 44
6.4.2
Configure Generic Variables .............................................................. 44
6.4.3
Add PFC Variables ............................................................................. 45
6.4.4
Configure PFC Variables ................................................................... 45
6.4.5
Configure K-Bus Variables ................................................................ 46
6.5
Generate IEC Code ................................................................................. 46
7
Glossary ...................................................................................................... 48
8
Appendix ..................................................................................................... 51
8.1
WAGO-I/O-PRO-Libraries ..................................................................... 51
8.1.1
WAGO-I/O-PRO Function Blocks..................................................... 52
8.1.2
Directory Structure ............................................................................. 52
8.1.3
Program Execution of the Generated Code ........................................ 53
8.1.4
Cycle Time of the "MBCFG_MASTER_TASK" .............................. 54
8.1.5
Data Storage, Persistent ...................................................................... 54
8.1.6
MODBUS Function Codes ................................................................. 55
8.1.7
Access to WAGO Slaves .................................................................... 55
8.1.8
Access to the Hardware Area ............................................................. 55
8.1.9
Access to the PFC Variable Area and Flags ....................................... 55
8.1.10
Access to the Special Feature Registers ............................................. 56
8.1.11
Optimizing Communication with WAGO MODBUS Slaves ............ 56
8.1.12
Access to Generic MODBUS Slaves, Manufacturer-Independent..... 56
8.1.13
Access to MODBUS Data Points from the IEC 61131 Program ....... 56
List of Figures ...................................................................................................... 58
List of Tables ........................................................................................................ 59
=== Ende der Liste für T extmar ke Verzeic hnis_vor ne ===
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Notes about this Documentation
5
Pos : 7 /Alle Serien (Allgemeine M odul e)/Übersc hriften für all e Serien/Hi nweis z ur Dokumentation/Hinweis e z ur D okumentation - Ü bersc hrift 1 @ 4\mod_1237987661750_21.doc x @ 29029 @ 1 @ 1
1
Notes about this Documentation
Pos : 8 /Alle Serien (Allgemeine M odul e)/Hinweise z ur Dokumentation/Hi nweis e/Hi nweis : D okumentation aufbewahr en @ 4\mod_1237987339812_21.doc x @ 29026 @ @ 1
Keep this documentation!
The operating instructions are part of the product and shall be kept for the entire
lifetime of the product. They shall be transferred to each subsequent user of the
product. Care must also be taken to ensure that any supplement to these
instructions are included, if applicable.
Pos : 9 /Seri e 759 ( WAGO- Software)/Hi nweis e z ur D okumentati on/Gültigkeits bereic h M ODBU S-Mas ter-Konfigurator @ 18\mod_1391500177852_21.doc x @ 144272 @ 2 @ 1
1.1
Scope of Validity
This documentation applies to the software of the MODBUS Master Configurator.
Pos : 10.1 /All e Seri en ( Allgemei ne Module)/Hi nweis e zur D okumentati on/Urhebersc hutz ausführlich @ 4\mod_1235565145234_21.doc x @ 27691 @ 2 @ 1
1.2
Copyright
This Manual, including all figures and illustrations, is copyright-protected. Any
further use of this Manual by third parties that violate pertinent copyright
provisions is prohibited. Reproduction, translation, electronic and phototechnical
filing/archiving (e.g., photocopying) as well as any amendments require the
written consent of WAGO Kontakttechnik GmbH & Co. KG, Minden, Germany.
Non-observance will involve the right to assert damage claims.
Pos : 10.2 /Dokumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
6
Notes about this Documentation
WAGO Software
MODBUS Master Configurator
Pos : 10.3 /All e Seri en ( Allgemei ne Module)/Ü bers chriften für alle Serien/Hinweis z ur D okumentati on/Symbole - Ü berschrift 2 @ 13\mod_1351068042408_21.doc x @ 105270 @ 2 @ 1
1.3
Symbols
Pos : 10.4.1 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Gefahr/Gefahr: _War nung vor Personenschäden allgemei n_ - Erl äuter ung @ 13\mod_1343309450020_21.doc x @ 101029 @ @ 1
Personal Injury!
Indicates a high-risk, imminently hazardous situation which, if not avoided, will
result in death or serious injury.
Pos : 10.4.2 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Gefahr/Gefahr: _War nung vor Personenschäden durc h elektrisc hen Strom_ - Erläuterung @ 13\mod_1343309694914_21.doc x @ 101030 @ @ 1
Personal Injury Caused by Electric Current!
Indicates a high-risk, imminently hazardous situation which, if not avoided, will
result in death or serious injury.
Pos : 10.4.3 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Warnung/Warnung: _Warnung vor Personensc häden allgemei n_ - Erläuterung @ 13\mod_1343309877041_21.doc x @ 101035 @ @ 1
Personal Injury!
Indicates a moderate-risk, potentially hazardous situation which, if not avoided,
could result in death or serious injury.
Pos : 10.4.4 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Vorsic ht/Vorsicht: _War nung vor Pers onensc häden allgemein_ - Erläuterung @ 13\mod_1343310028762_21.doc x @ 101038 @ @ 1
Personal Injury!
Indicates a low-risk, potentially hazardous situation which, if not avoided, may
result in minor or moderate injury.
Pos : 10.4.5 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Achtung/Achtung: _War nung vor Sac hsc häden allgemein_ - Erläuterung @ 13\mod_1343310134623_21.doc x @ 101041 @ @ 1
Damage to Property!
Indicates a potentially hazardous situation which, if not avoided, may result in
damage to property.
Pos : 10.4.6 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Achtung/Achtung: _War nung vor Sac hsc häden durc h elektr ostatis che Aufladung_ - Erläuterung @ 13\mod_1343310227702_21.doc x @ 101044 @ @ 1
Damage to Property Caused by Electrostatic Discharge (ESD)!
Indicates a potentially hazardous situation which, if not avoided, may result in
damage to property.
Pos : 10.4.7 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Hi nweis /Hinweis: _Wic htiger Hi nweis allgemein_ - Erläuterung @ 13\mod_1343310326906_21.doc x @ 101047 @ @ 1
Important Note!
Indicates a potential malfunction which, if not avoided, however, will not result in
damage to property.
Pos : 10.4.8 /All e Serien ( Allgemei ne Module)/Wic htige Erläuterungen/Sicherheits- und sons tige Hinweis e/Infor mation/Infor mation: _Weiter e Infor mation allgemei n_ - Erl äuter ung @ 13\mod_1343310439814_21.doc x @ 101051 @ @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Notes about this Documentation
Additional Information:
Refers to additional information which is not an integral part of this
documentation (e.g., the Internet).
Pos : 10.5 /Dokumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
7
8
Notes about this Documentation
WAGO Software
MODBUS Master Configurator
Pos : 10.6 /All e Seri en ( Allgemei ne Module)/Hi nweis e zur D okumentati on/Zahlens ysteme @ 3\mod_1221059454015_21.doc x @ 21711 @ 2 @ 1
1.4
Number Notation
Table 1: Number notation
Number code
Decimal
Hexadecimal
Binary
Example
100
0x64
'100'
'0110.0100'
Note
Normal notation
C notation
In quotation marks, nibble separated with
dots (.)
Pos : 10.7 /All e Seri en ( Allgemei ne Module)/Hi nweis e zur D okumentati on/Sc hriftkonventi onen @ 3\mod_1221059521437_21.doc x @ 21714 @ 2 @ 1
1.5
Font Conventions
Table 2: Font conventions
Font type
italic
Menu
>
Input
“Value”
[Button]
[Key]
Indicates
Names of paths and data files are marked in italic-type.
e.g.: C:\Programme\WAGO-I/O-CHECK
Menu items are marked in bold letters.
e.g.: Save
A greater-than sign between two names means the selection of a
menu item from a menu.
e.g.: File > New
Designation of input or optional fields are marked in bold letters,
e.g.: Start of measurement range
Input or selective values are marked in inverted commas.
e.g.: Enter the value “4 mA” under Start of measurement range.
Pushbuttons in dialog boxes are marked with bold letters in square
brackets.
e.g.: [Input]
Keys are marked with bold letters in square brackets.
e.g.: [F5]
Pos : 11 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Important Notes
9
Pos : 12.1 /All e Seri en ( Allgemei ne Module)/Ü bers chriften für alle Serien/Wichtige Erläuter ungen/Wichtige Erläuter ung en - Übersc hrift 1 @ 4\mod_1241428899156_21.doc x @ 32170 @ 1 @ 1
2
Important Notes
Pos : 12.2 /Serie 759 (WAGO-Softwar e)/Hinweis e z ur Dokumentation/Wic htige Erläuterungen/Wic htige Erläuterungen - Einl eitung Software @ 12\mod_1333628906785_21.doc x @ 93367 @ @ 1
This section describes the legal principles and system requirements for using the
software in compliance with intended purpose, underlying provisions and stated
specifications.
Pos : 12.3 /All e Seri en ( Allgemei ne Module)/Ü bers chriften für alle Serien/Wichtige Erläuter ungen/Rechtliche Gr undl agen - Ü bersc hrift 2 @ 3\mod_1221060626343_21.doc x @ 21726 @ 2 @ 1
2.1
Legal Bases
Pos : 12.4 /All e Seri en ( Allgemei ne Module)/Wic htige Erläuterungen/Änderungs vor behalt - Ü bers chrift 3 und Inhalt @ 3\mod_1221060036484_21.doc x @ 21720 @ 3 @ 1
2.1.1
Subject to Changes
WAGO Kontakttechnik GmbH & Co. KG reserves the right to provide for any
alterations or modifications that serve to increase the efficiency of technical
progress. WAGO Kontakttechnik GmbH & Co. KG owns all rights arising from
the granting of patents or from the legal protection of utility patents. Third-party
products are always mentioned without any reference to patent rights. Thus, the
existence of such rights cannot be excluded.
Pos : 12.5 /Serie 759 (WAGO-Softwar e)/Hinweis e z ur Dokumentation/Wic htige Erläuterungen/Pers onalqualifi kation Software @ 12\mod_1331792915159_21.doc x @ 91000 @ 3 @ 1
2.1.2
Personnel Qualification
Any steps related to the use of WAGO software may only be performed by
qualified employees with sufficient knowledge of handling the respective PC
system used.
Steps in which files are created or changed on the PC system may only be
performed by qualified employees with sufficient knowledge in the administration
of the PC system used in addition to the aforementioned.
Steps in which the behavior of the PC system in a network is changed may only
be performed by qualified employees with sufficient knowledge in the
administration of the network used in addition to the aforementioned.
Pos : 12.6 /All e Seri en ( Allgemei ne Module)/Ü bers chriften für alle Serien/Wichtige Erläuter ungen/Systemvor aussetzungen - Ü berschrift 2 @ 12\mod_1333625105884_21.doc x @ 93361 @ 2 @ 1
2.2
System Requirements
Pos : 12.7 /Serie 759 (WAGO-Softwar e)/Hinweis e z ur Dokumentation/Wic htige Erläuterungen/Systemvorauss etz ung en MOD BUS-M aster-Konfig urator @ 18\mod_1391500508952_21.doc x @ 144276 @ 332333 @ 1
2.2.1
PC Hardware
Table 3: Required PC hardware
Components
Operating System
Memory
Free hard disk storage
Processor
Other
Manual
Version 1.0.0
Requirements
Windows XP (SP3 or higher); Windows 7/8
Min. 1 GB RAM (recommended: 2 GB RAM or more)
Min. 1.5 MB for the WAGO MODBUS Configurator
Min. 1 GHz or higher
Installed network card,
standard web browser with Java support
10
Important Notes
2.2.2
WAGO Software
MODBUS Master Configurator
PC Software
Table 4: Required software
Components
WAGO-I/O-PRO
Version 2.3.9.40 or higher
(includes MODBUS Master
Configurator)
Customers with older versions
should contact Support:
support@wago.com
Table 5: Optional software
Components
WAGO-I/O-CHECK
WAGO Ethernet Settings
Source (Item No.)
WAGO (759-333)
(Manual for WAGO-I/O-PRO can be downloaded free at:
www.wago.com).
Source (Item No.)
WAGO (759-302)
WAGO (free download at:
www.wago.com)
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
2.3
Important Notes
11
Hardware Constraints
The hardware constraints are based on the WAGO products from the WAGO-I/OSYSTEM 750, 758 and 762 Series.
The WAGO devices and interfaces that can be used as MODBUS masters and
slaves are listed in the sections below.
2.3.1
Supported MODBUS Master Devices
The MODBUS Master Configurator supports the following WAGO devices that
are programmable with CODESYS 2.3:
Table 6: Supported MODBUS master devices
Series /
Device Class
Subgroup
WAGO-I/O-SYSTEM 750 / 16-bit derivatives
(P-)FC 750-8xx
32-bit derivatives
WAGO-I/O-SYSTEM 758 /
IPC 758-87x
Compact Industrial PCs
WAGO PERSPECTO® 762 / PERSPECTO®
CP 762-3xxx/000-001
Control-Panel with
Target Visualization
Item Mumber
750-804, 750-806, 750-819, 750-833,
750-837, 750-842, 750-843
750-830, 750-831, 750-841, 750-849,
750-871, 750-872, 750-873, 750-880,
750 881, 750-882, 750-884, 750-885,
750-8203, 750-8204, 750-8206
758-874/000-xxx,
758-875/000-xxx
758-876/000-xxx
762-3035/000-001,
762-3057/000-001,
762-3104/000-001,
762-3121/000-001,
762-3150/000-001
The difference in device classes for the 16-bit and 32-bit derivatives is in access to
the ETHERNET interface, in which different CODESYS2 ETHERNET libraries
are accessed for ETHERNET access.
The class of devices from WAGO's PERSPECTO® 762 Series differs when
accessing serial communication because there is no internal data bus (K-Bus).
2.3.2
Hardware Interfaces
For communication, the MODBUS master uses the ETHERNET or RS-232
hardware interfaces available on the housing of the MODBUS master device or
the serial I/O modules plugged in the fieldbus node (see table below).
Table 7: Hardware interfaces
Interfaces
ETHERNET interface
RS-232 interface
RS-232 C serial interface
RS-485 serial interface
RS-232 / RS-485 serial interface
Manual
Version 1.0.0
WAGO Device, Item Number
MODBUS master device, see table above
MODBUS master device, see table above
750-650
750-653
750-652
12
Important Notes
2.3.3
WAGO Software
MODBUS Master Configurator
Acceptable MODBUS Slaves
Any device that supports MODBUS ASCII, MODBUS RTU, MODBUS TCP or
MODBUS UDP and at least one of the MODBUS function codes (except FC22
and FC23) can be used as a MODBUS slave.
When using MODBUS slaves from third-party manufacturers, include them in the
network configuration by creating generic MODBUS slaves.
For WAGO MODBUS slaves, the hardware configuration of the fieldbus node
can be manually created in the MODBUS Master Configurator or by simply
scanning for devices.
The WAGO devices listed below are acceptable as MODBUS slaves.
Table 8: Possible WAGO MODBUS slaves
MODBUS Slaves
WAGO Devices
MODBUS slaves via ETHERNET ETHERNET fieldbus coupler from the 750 Series: 750–3xx
(UDP and TCP)
ETHERNET fieldbus controller from the 750 Series: 750-8xx
IPCs der Serie 758: 758-087x
PFC200-Derivate: 750-860x
MODBUS slaves with serial
PFC200 derivatives: 750-860x
interface
RS232/RS485 coupler (750-312, 750-314, …)
(MODBUS RTU)
RS232/RS485 controller (750-812, 750-814,750-830, …)
Pos : 12.8 /All e Seri en ( Allgemei ne Module)/Ü bers chriften für alle Serien/Wichtige Erläuter ungen/Sic herheits hinweise - Übersc hrift 2 @ 6\mod_1260180299987_21.doc x @ 46724 @ 2 @ 1
2.4
Safety Advice (Precautions)
Pos : 12.9 /Serie 759 (WAGO-Softwar e)/Hinweis e z ur Dokumentation/Hi nweis e/Hi nweis : Aktuell e Sicherheitss oftwar e ver wenden! + Nicht benötigte Software deakti vi eren oder de.! @ 12\mod_1333429179862_21.doc x @ 92870 @ @ 1
Use up-to-date security software!
Secure operation of the PC system can be at risk as a result of malware such a
viruses and Trojans, as well as related threats such as denial-of-service attacks.
Therefore, make sure that the latest security software and definitions are always
installed on the PC system.
Disable or uninstall software that is no longer required!
The vulnerability of a PC system against malware and related threats increases
with the number of installed or active software components (applications and
services). Therefore, uninstall or disable software components that are not needed
for the purpose at hand.
Pos : 13 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
General
13
Pos : 14 /Serie 759 ( WAGO-Softwar e)/MOD BUS-M aster-Konfigurator/M ODBU S-Mas ter-Konfigurator - Allgemeines - Vorbereitung, Installati on, Öffnen (Ü berschrift 1 + T ext) @ 19\mod_1396961709564_21.doc x @ 151010 @ 1222 @ 1
3
General
3.1
Installation
The MODBUS Master Configurator is part of the WAGO-I/O-PRO software
(ItemNo.: 759-333) 2.3.9.40 or higher.
WAGO-I/O-PRO is easy to install using a „Setup.exe“ file with a user guided
wizard.
3.2
Preparation
When using the MODBUS Master Configurator, it is important that the hardware
of your MODBUS master and MODBUS slaves used, as well as the MODBUS
network, are set up and working correctly.
A communication link from your PC to your MODBUS master-enabled device
must be established for online configuration. This can be achieved via
ETHERNET connection or serial interface on the programmable fieldbus
controller being used.
In addition, the WAGO-I/O-PRO software (version with integrated MODBUS
Master Configurator) must be installed on your PC.
Please note the version of WAGO-I/O-PRO with integrated MODBUS
Master Configurator!
Please note that the MODBUS Master Configurator is integrated in WAGO-I/OPRO version V 2.3.9.40 or higher.
Customers with older versions should contact Support:
support@wago.com
Important Note! -> Durch Hinweisüberschrift ersetzen!
Please note the following when launching WAGO-I/O-PRO:
- Do not use an existing project file, e.g., double-click, to launch WAGO-I/OPRO. Doing so prevents code generation.
- You can open only one instance of WAGO-I/O-PRO at once.
- You have to use the " remote" command line argument to start WAGO-I/OPRO in order to add modules in WAGO-I/O-PRO:
(Example: "<Install_Path>\WAGO-Software\CODESYS
V2.3\CODESYS.exe" –remote).
After creating a new project in WAGO-I/O-PRO and selecting the target system
according to your MODBUS master, you can open the controller’s MODBUS
Master Configurator and begin configuration.
Manual
Version 1.0.0
14
3.3
General
WAGO Software
MODBUS Master Configurator
Open MODBUS Master Configurator in
WAGO-I/O-PRO
1.
Open the MODBUS Master Configurator in the WAGO I/O-PRO
programming environment directly.
First, select the target system in a new project, the required programming
language and then the "Resources" tab.
2.
Double-click "Controller Configuration" in the tree structure to open the
controller configuration dialog.
3.
In this dialog, expand the "Hardware configuration" entry in the tree
structure.
4.
Then click to highlight the „Modbus-Master[FIX]“.
In the right area of the dialog, the configuration dialog for the MODBUS
master configuration appears.
The dialog contains the "MODBUS Master Configurator" tab.
Figure 1: View of the controller configuration with MODBUS Master Configurator
Pos : 15 /Serie 759 ( WAGO-Softwar e)/MOD BUS-M aster-Konfigurator/M ODBU S-Mas ter-Konfigurator - Anfang/Ü bersicht - F unktions bes chr eibung @ 18\mod_1391080567660_21.doc x @ 143921 @ 12233333 @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
The MODBUS Master Configurator
4
The MODBUS Master Configurator
4.1
Function
15
The MODBUS Master Configurator is an extension application of the WAGOI/O-PRO (CODESYS 2.3) programming environment and is used directly in the
programming environment.
The MODBUS Master Configurator simplifies MODBUS network configuration
in a WAGO-I/O-PRO project that is connected to a WAGO device with
MODBUS master support.
The figure below shows an example configuration of a MODBUS network using
the MODBUS Master Configurator in CODESYS with a device from WAGO’s
PERSPECTO® 762 Series as a MODBUS master.
Figure 2: Example configuration for using the MODBUS Master Configurator
The dialog streamlines network creation in the MODBUS Master Configurator.
However, scanning for MODBUS-enabled WAGO devices makes creating a
network even easier. For any WAGO devices found, a node scan can also read the
connected I/O module configuration and determine all data points.
To scan, the PC must have online access to the WAGO devices via ETHERNET
or a serial interface.
From the following configuration settings specified for respective communication
processes, the MODBUS Master Configurator can automatically create a
corresponding IEC 61131 program code with the click of a mouse. This code is
then directly available in the WAGO-I/O-PRO (CODESYS 2.3) programming
environment.
For data access to the WAGO MODBUS slaves, no manual input of the
MODBUS communication parameters is required. The MODBUS function codes
(FC) used can be specified via the MODBUS Master Configurator depending on
which data ranges (bit/register area) should be accessed.
Manual
Version 1.0.0
16
The MODBUS Master Configurator
WAGO Software
MODBUS Master Configurator
The MODBUS Master Configurator maximizes support for correctly selecting the
MODBUS addresses and function codes.
Additionally, "optimized" or "explicit" communication for individual data channel
access can be selected by clicking on the appropriate checkbox. The definitions
are included when generating the code and read communication jobs.
To illustrate the types of access, an example is shown below.
If a slave provides three data points, for example, which are defined as
"optimized", they are read or written with this MODBUS FC at one time.
If the data points are marked as "explicit", however, the MODBUS master
performs three requests to read or write the data points from the slave.
It should be noted that some MODBUS slaves do not allow "optimized" reading
because there may be data with more than one word/coil behind a MODBUS
address that can only be read as "explicit".
Figure 3: Example of "optimized" and "explicit" data access
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
4.2
The MODBUS Master Configurator
17
Configuration Procedure
The MODBUS network is configured in five simple steps; steps 1 and 5 in the
WAGO-I/O-PRO programming environment and steps 2–4 with the MODBUS
Master Configurator.
The user project is created in WAGO-I/O-PRO, the hardware and software of the
network devices configured in the MODBUS Master Configurator and subsequent
connection of network devices is then implemented in the WAGO-I/O-PRO
project.
Table 9: Configuration procedure overview
Tool
WAGO-I/O-PRO
Step 1:
Create project
Step 2:
Configure MODBUS network
MODBUS Master Configurator Step 3:
WAGO-I/O-PRO
Step
Configure network devices
Step 4:
Generate code
Step 5:
Integrate into application
The basic process is briefly outlined in the steps shown in the following sections.
Step-by-step instructions for this process can be found in the "Operation" section.
Details and information about the software are available in the "MODBUS Master
Configurator" and "WAGO-I/O-PRO Function Blocks" main sections.
4.2.1
Step 1: "Create project"
Create your project in WAGO-I/O-PRO.
Start WAGO-I/O-PRO with the "-remote" command line argument and create a
new project in WAGO-I/O-PRO. Select the target system based on the MODBUS
master used.
4.2.2
Step 2: "Configure MODBUS network"
Configure the MODBUS network in the MODBUS Master Configurator.
First, configure the MODBUS network hardware in the controller configuration of
WAGO-I/O-PRO using the MODBUS Master Configurator.
Once you click the "MODBUS Master[FIX]" entry in the tree structure of the
controller configuration, the interface of the MODBUS Master Configurator
appears.
Click the [Network View] button to open the "MODBUS Network" dialog for
network configuration.
Within this dialog box, utilize a tree structure to map the structure of your
hardware by adding corresponding entries for existing interfaces and connected
MODBUS slaves.
Manual
Version 1.0.0
18
The MODBUS Master Configurator
WAGO Software
MODBUS Master Configurator
The respective settings for the interfaces and MODBUS slaves are made from
their corresponding context menus (right-click) for these entries.
Details of the process are briefly described in the table below.
Table 10: General settings from the context menus of tree structure entries
Entry Context Menu Description
"MODBUS Master" At the beginning, an entry already exists for your
MODBUS master in the representation of the tree
structure.
First, you can perform settings for the code generator from
the context menu of the MODBUS master and then add
appropriate interfaces to the master for your existing
MODBUS slaves.
"Interface"
You can then automatically or manually add the connected
MODBUS slave to each interface from the context menu
for the respective interface:
Automatically – online from the "Find devices" context
menu.
Offline – via "Add MODBUS slave", which provides a list
of all possible slaves (WAGO or generic) for manually
selecting MODBUS slaves.
"MODBUS Slave"
The communication preferences (transport protocol and IP
address) for the respective MODBUS slave are made from
the context menu of the corresponding MODBUS slave,
via the "Edit" menu item / MODBUS ETHERNET
Settings tab.
"K-Bus"
To select the individual I/O modules on a fieldbus node,
you can open the dialog on the tree structure entry "K-Bus
" via the context menu/"Add" menu item and select your
physical hardware components offline.
Optionally, you can also perform an automatic device scan
online from the context menu/menu item "Scan node" on
the tree structure entry "K-Bus".
4.2.3
Step 3: "Configure network devices"
You can also configure individual network devices in the MODBUS Master
Configurator.
Once you have configured the structure of the network based on your physical
structure, you can rename the displayed variable name and associated comment in
the MODBUS network list for each individual data channel and specify the
required access (none, read, write) from a selection list. You can also choose
whether communication should be "optimized" (default) or "explicit".
In addition, you can add generic variables and — depending on availability —
PFC variables, as well as declare their types as required.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
4.2.4
The MODBUS Master Configurator
19
Step 4: "Generate code"
Once you have defined all required functionality, clicking the "
" button
([Generate code]) automatically generates the defined variables and access
function codes as IEC function blocks.
4.2.5
Step 5: "Integrate into application"
You can then directly integrate and use the generated IEC function blocks in
WAGO-I/O-PRO in your project.
To establish a connection between network devices, connect the inputs and
outputs of your application, as required, with the configured network variables of
the MODBUS network devices.
Pos : 16 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
20
User Interface
WAGO Software
MODBUS Master Configurator
Pos : 17 /Serie 759 ( WAGO-Softwar e)/MOD BUS-M aster-Konfigurator/M ODBU S-Mas ter-Konfigurator - Bedi enoberfl äc he (Übersc hrift 1 + T ext) @ 18\mod_1391511469772_21.doc x @ 144328 @ 122343444344344434334 @ 1
5
User Interface
5.1
Main View
There are four buttons on the user interface of the MODBUS Master
Configurator. MODBUS slaves are listed on the right side next to the buttons in a
display window if they have already been configured.
There are no entries in this list prior to MODBUS network configuration.
Figure 4: User interface of the MODBUS Master Configurator
Table 11: Legend to figure "User interface of the MODBUS Master Configurator"
Buttons
Description
Click this button to open the "MODBUS Network" dialog.
[Network view]
Based on the target system selected in the WAGO-IO-PRO project,
the MODBUS master is already displayed in the dialog list when first
opened.
Click this button to generate the respective IEC code from the
[Generate code]
configuration settings.
Any MODBUS master program previously created is deleted and
replaced by a new version.
Click this button to remove the generated IEC code.
[Remove code]
Click this button to save the configuration settings and close the
[Save configuration]
"MODBUS Network" dialog.
5.2
"MODBUS network" Dialog
Click the [Network view] button to open the MODBUS Network dialog; here,
the network is configured first and then the network devices and individual data
points are configured.
When you first open the dialog, only the MODBUS master entry exists.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
User Interface
Figure 5: MODBUS netzwork dialog (without configuration)
After the network is configured, specific settings can be made for the individual
data points of each network device entered.
Figure 6: MODBUS netzwork dialog (with example configuration)
Manual
Version 1.0.0
21
22
User Interface
WAGO Software
MODBUS Master Configurator
Table 12: Legend to figure "MODBUS netzwork dialog"
Table Entry
Description
Network Tree structure entry for MODBUS master, interface, MODBUS slave or
variable.
The "ModbusSlavex" entries and the individual variables can be edited by
double-clicking.
Other settings can be made by right-clicking to call up the context menu for
the respective entry.
Type Specifying the MODBUS slave or variable.
Select the variable entries in the selection list by double-clicking.
Other settings can be made by right-clicking to call up the context menu for
the respective entry.
IEC address IEC address for data access.
Access Type of data access (none [default], read, write) can be selected in the
selection list by double-clicking.
Other settings can be made by right-clicking to call up the context menu for
the respective entry.
Communication Selecting communication type (optimized [default] or explicit) is possible by
right-clicking to call up the context menu for the respective entry.
Comment Can be edited by double-clicking.
Buttons
Description
Click this button to remove the generated code.
Click this button to generate code from the configuration settings.
[OK]
5.2.1
Click this button to apply all settings and close the dialog.
Context Menu for the "MODBUS master" Entry
Select the "MODBUS master" entry and right-click to display the context menu.
Figure 7: Context menu for the""MODBUS master" entry
Table 13: Legende to Figure "Context menu for the "MODBUS master entry"
Menu Item
Description
Edit Opens the "Parameter code generator" dialog.
Add serial interface In the tree structure, the "Interface (COMx)" subentry is added
to the "MODBUS Master" entry.
Add ETHERNET interface In the tree structure, the "Interface ETHERNET" subentry is
added to the "MODBUS Master" entry.
Copy No action
Paste No action
Buttons
Click this button to apply all settings and close the dialog.
[OK]
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
5.2.1.1
User Interface
"Parameter code generator" Dialog
The Parameter code generator dialog is opened from the context menu for the
MODBUS master, "Edit" menu item.
Figure 8: Parameter code generator dialog
Manual
Version 1.0.0
23
24
User Interface
WAGO Software
MODBUS Master Configurator
Table 14: Legende to Figure "Parameter code generator dialog"
Entry
Default
Description
Enabled: Explicit tasks are created for the
generated CODESYS function blocks.
 This implies that it is necessary to create a
separate task for the PLC_PRG program to call
up the function block tasks.
Generate CODESYS tasks

Disabled: No tasks are created for the generated
CODESYS function blocks.

CODESYS generates a separate task for the
PLC_PRG program by default.
MODBUS RTU task
5 [ms]
Minimum task cycle setting.
Minimum task cycle
Can also be changed later in the task configuration.
0.100000 Multiplier of the task cycle time per inserted
Interface multiplier
interface.
MODBUS ETHERNET task
5 [ms]
Minimum task cycle time setting.
Minimum task cycle
Can also be changed later in the task configuration.
0.100000 Multiplier of the task cycle time per added slave.
Slave
Buttons
Click this button to apply all settings and close the dialog.
[OK]
Click this button to discard all settings and close the dialog.
[Cancel]
5.2.2
Context Menu for the "Interface (COMx)" Entry
Select the "Interface (COMx)" entry and right-click to display the context menu.
Figure 9: Context menu for the "Interface (COMx)" entry
Table 15: Legend to Figure "Context menu for the Interface (COMx) entry
Menu Item
Description
Open the "Settings: Serial interface" dialog.
Edit
Opens the "MODBUS slave selection" dialog.
Add MODBUS slave
The interface entry is deleted in the tree structure.
Delete
Copies the selected serial interface with all settings. The number
Copy
of COM ports is automatically increased by one when inserted.
Inserts the copied serial interface with all settings. The number
Paste
of COM ports is automatically increased by one when inserted.
Opens the "Search device" dialog.
Find devices
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
5.2.2.1
User Interface
25
"Settings: Serial interface" Dialog
The Settings: Serial interface dialog is opened from the context menu for the
serial interface, "Edit" menu item.
Figure 10: Settings: Serial interface dialog
Table 16: Legend to Figure "Settings: Serial interface dialog"
Entry
Default
Description
2
Free number entry of the COM port, automatically
COM port
increased when inserting multiple serial ports.
9600
Selection list for the baud rate (110–115200).
Baud rate
8
Selection list for the number of data bits (7, 8).
Data bits
1
Selection list for the number of stop bits (1, 2)
Stop bits
none
Selection list for the parity (even, none, odd)
Parity
RS485
Selection list for the type of hardware interface
Hardware type
(RS-485, RS-232).
OFF
Selection list for the flow control (OFF, RTS/CTS)
Flow control
OFF
Selection list for enabling ASCII mode
ASCII mode
(active, OFF)
Buttons
Click this button to apply all settings and close the dialog.
[OK]
Click this button to discard all settings and close the dialog.
[Cancel]
Manual
Version 1.0.0
26
User Interface
5.2.2.2
WAGO Software
MODBUS Master Configurator
"MODBUS slave selection" Dialog
The MODBUS slave selection dialog is opened from the context menu for the
"Interface (COMx)" or "Interface (ETHERNET)" entry, "Add MODBUS slave"
menu item.
This dialog is also opened from the context menu for the "ModbusSlave" entry,
"Replace" menu item.
The description of this dialog is available in the section "Context menu for the
ModbusSlave entry" >> "MODBUS slave selection dialog".
5.2.2.3
"Search device" Dialog
The Search device dialog is opened from the context menu for the "Interface
(COMx)" entry, "Find device" menu item.
Figure 11: Search device dialog
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
User Interface
27
Table 17: Legend to Figure " Search device dialog"
Entry
Default
Description
Connected devices that are in the specified range of
Address range,
IP addresses should be searched for and displayed in
from … to …
the device list.
Display names assigned by DHCP server or
 WAGO ETHERNET settings
(a scan takes longer).
Resolve network names

Names assigned by DHCP server or WAGO
 ETHERNET settings are not displayed.
All connected devices should be searched and
 displayed in the device list.
Display all devices in the

Only connected devices that are in the specified
network
 range of IP addresses should be searched for and
displayed in the device list.
Click this button to search for all connected devices, or connected
[Browse]
devices within a specified range of IP addresses, and display in the
device list.
List of all devices found.
Device list
IP address IP address of the device found.
Network name Network name of the device found, if specified.
Item number Item number of the device found.
MAC ID MAC ID of the device found.
Buttons
Click this button to apply to all selected devices and close the
[Apply]
dialog.
Click this button to discard all settings and close the dialog.
[Cancel]
5.2.3
Context Menu for the "Interface (ETHERNET)" Entry
Select the "Interface (ETHERNET)" entry and right-click to display the context
menu.
Figure 12: Context menu for the "Interface (ETHERNET)" entry
Manual
Version 1.0.0
28
User Interface
WAGO Software
MODBUS Master Configurator
Table 18: Legend to Figure "Context menu for the Interface (ETHERNET) entry"
Menu Item
Description
ETHERNET interface has no settings.
Edit
Opens the "MODBUS slave selection" dialog.
Add MODBUS slave
The interface entry is deleted in the tree structure.
Delete
No action
Copy
No action
Paste
Opens the "Search device" dialog.
Find devices
5.2.3.1
"MODBUS slave selection" Dialog
The MODBUS slave selection dialog is opened from the context menu for the
"Interface (COMx)" or "Interface (ETHERNET)" entry, "Add MODBUS slave"
menu item.
This dialog is also opened from the context menu for the "ModbusSlave" entry,
"Replace" menu item.
The description of this dialog is available in the section "Context menu for the
ModbusSlave entry" >> "MODBUS slave selection dialog".
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
5.2.3.2
User Interface
"Search device" Dialog"
The Search Device dialog is opened from the context menu for the "Interface
(ETHERNET)" entry, "Find device" menu item.
Figure 13: Search device dialog
Manual
Version 1.0.0
29
30
User Interface
WAGO Software
MODBUS Master Configurator
Table 19: Legend to Figure "Search device dialog"
Entry
Default
Description
Connected devices that are in the specified range of
Address range,
IP addresses should be searched for and displayed in
from … to …
the device list.
Display names assigned by DHCP server or
 WAGO ETHERNET settings
(a scan takes longer).
Resolve network names

Names assigned by DHCP server or WAGO
 ETHERNET settings are not displayed.
All connected devices should be searched and
 displayed in the device list.
Display all devices in the

Only connected devices that are in the specified
network
 range of IP addresses should be searched for and
displayed in the device list.
Click this button to search for all connected devices, or connected
[Browse]
devices within a specified range of IP addresses, and display in the
device list.
List of all devices found.
Device list
IP address IP address of the device found.
Network name Network name of the device found, if specified.
Item number Item number of the device found.
MAC ID MAC ID of the device found.
Buttons
Click this button to apply to all selected devices and close the
[Apply]
dialog.
Click this button to discard all settings and close the dialog.
[Cancel]
5.2.4
Context Menü for the "ModbusSlave" Entry
Select the "ModbusSlave" entry and right-click to display the context menu.
Figure 14: Context menu for the "ModbusSlave" entry
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
User Interface
31
Table 20: Legend to Figure "Context menu for the ModbusSlave entry"
Menu Item
Description
Opens the "Communication settings" dialog.
Edit
If the MODBUS slave can be accessed online, the components
Scan node
and process data variables of the connected fieldbus node are
scanned and listed in the tree structure under the
"ModbusSlave" entry  "K-Bus" subentry.
The MODBUS slave entry is deleted from the tree structure.
Delete
Opens the "MODBUS slave selection" dialog.
Replace
Copies the selected MODBUS slave and all its settings. The
Copy
number of MODBUS slaves is automatically increased by one
when inserted.
Inserts the copied MODBUS slave and all its settings. The
Paste
number of MODBUS slaves is automatically increased by one
when inserted.
5.2.4.1
"Communication settings" – Interface (COMx) Dialog)
The Communication settings dialog is opened from the context menu for the
"ModbusSlave" entry "Edit" menu item.
The "MODBUS RTU settings" tab provides the settings for access from the
connected MODBUS master to the MODBUS slave via the serial interface.
The "Service settings" tab provides the settings for access during maintenance
from a connected service PC to the MODBUS slave.
Figure 15: Communication settings dialog [for Interface (COMx)]
Manual
Version 1.0.0
32
User Interface
WAGO Software
MODBUS Master Configurator
Table 21: Legende to Figure "Communication settings dialog [for Interface (COMx)])"
"MODBUS RTU settings" Tab
Entry
Default
Description
20
Time span in which the response is expected.
Time out [ms]
0
Delay in [ms] between two MODBUS requests.
Delay [ms]
Prevents overloading of the slaves. When '0', the
next request is made immediately after receiving the
response.
0
The MODBUS unit ID of the slave must be unique
MODBUS unit ID
for all devices in the line.
"Service settings" Tab
Entry
Default
Description
ETHERNET
 Access enabled from the service PC to the
MODBUS slave via the ETHERNET interface.

 Access enabled from the service PC to the
MODBUS slave via the serial interface.
Service Interface
 Access enabled from the service PC to the
MODBUS slave via the serial interface;
select interface via selection list.

 Access disabled from the service PC to the
MODBUS slave via the serial interface.
Buttons
Click this button to apply to all selected devices and close the
[OK]
dialog.
Click this button to discard all settings and close the dialog.
[Cancel]
5.2.4.2
"Communication settings" – Interface (ETHERNET Dialog)
The Communication settings dialog is opened from the context menu for the
"ModbusSlave" entry,"Edit" menu item.
The "MODBUS ETHERNET settings" tab provides the settings for access from
the connected MODBUS master to the MODBUS slave via the ETHERNET
interface.
The "Service settings" tab provides the settings for access during maintenance
from a connected service PC to the MODBUS slave.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
User Interface
33
Figure 16: Communication settings dialog [for Interface (ETHERNET)]
Table 22: Legend to Figure " Communication settings dialog [for Interface (ETHERNET)]"
"MODBUS RTU settings" Tab
Entry
Default
Description
The UDP protocol is used for transport via the
ETHERNET interface.
UDP
Transport
The TCPP protocol is used for transport via the
ETHERNET interface.
0.0.0.0
IP address of the slave
IP address
502
Interface port
Port
20
Time span to wait for the response.
Time out [ms]
0
The MODBUS unit ID of the slave must be unique
MODBUS unit ID
for all devices in the line.
"Service settings" Tab
Entry
Default
Description
ETHERNET
 Access enabled from the service PC to the
MODBUS slave via the ETHERNET interface.

 Access enabled from the service PC to the
MODBUS slave via the serial interface.
Service Interface
 Access enabled from the service PC to the
MODBUS slave via the serial interface;
select interface via selection list.

 Access disabled from the service PC to the
MODBUS slave via the serial interface.
Buttons
Click this button to apply to all selected devices and close the
[Apply]
dialog.
Click this button to discard all settings and close the dialog.
[Cancel]
Manual
Version 1.0.0
34
User Interface
5.2.4.3
WAGO Software
MODBUS Master Configurator
"MODBUS slave selection" Dialog
The MODBUS slave selection dialog is opened from the context menu for the
"Interface (COMx)" or "Interface (ETHERNET)" entry, "Add MODBUS slave"
menu item.
This dialog is also opened from the context menu for the "ModbusSlave" entry,
"Replace" menu item.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
User Interface
35
Figure 17: MODBUS slave selection Dialog
Table 23: Legend to Figure " MODBUS slave selection Dialog"
Entry
Description
Item number of the MODBUS slave available
Item No.
generic
Generic MODBUS slave to integrate the MODBUS slave from a
third-party manufacturer.
Item number of the WAGO MODBUS slave
075x-xxx/xxx
Description
Buttons
[OK]
[Cancel]
5.2.5
Item description of the MODBUS slave
Click this button to apply to all selected devices and close the
dialog.
Click this button to discard all settings and close the dialog.
Context Menu for the "Generic variables" Entry
Select the "Generic Variables" entry and right-click to display the context
menu.
Figure 18: Context menu for the "Generic variables" entry
Table 24: Legend to Figure " Context menu for the Generic variables entry "
Menu Item
Description
Adds a generic variable as a subentry with the following table
Add
entries that can be changed by double-clicking:
- Network: "xNewVar" (editable)
- Type: "Bool" (default) (selection list)
- Access: "none" (default), (selection list: "read/write")
- Communication: "Read:FC0, 0, Offset:0; Write:FC0, 0,
Offset:0".
Copies the selected generic variables with all settings.
Copy
Inserts the copied generic variables with all settings.
Paste
Opens the "WAGO MODBUS register" dialog.
WAGO MODBUS register
Manual
Version 1.0.0
36
User Interface
5.2.5.1
WAGO Software
MODBUS Master Configurator
"WAGO MODBUS register" Dialog
The WAGO MODBUS register dialog is opened from the context menu for the
"Generic variables" entry, "WAGO MODBUS register" menu item.
Figure 19: WAGO MODBUS register dialog
Table 25: Legend to Figure "WAGO MODBUS register" dialog
Entry
Description
Register address for read and write range of the WAGO MODBUS
Address
register entries.
Description of the register entry
Description
Default name of the variables for the corresponding register
Default name
Buttons
Click this button to apply all selected MODBUS registers as generic
[Apply]
variables and close the dialog.
Click this button to discard all settings and close the dialog.
[Cancel]
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
5.2.6
User Interface
37
Context Menu for the "PFC variables" Entry
Figure 20: Context menu for the "PFC variables" entry
Table 26: Legend to Figure " Context menu for the "PFC variables" entry"
Menu Item
Description
Adds a PFC variable as a subentry with the following table
Add
entries that can be changed by double-clicking:
- Network: "xNewVar" (editable)
- Type: "Bool" (default) (selection list)
- IEC address: "%MX0.0" (default), (type-dependent)
- Access: "none" (default) (selection list: "read/write")
- Communication: "Read:FC1, 12288, Offset:0;
Write:FC15,12288, Offset:0". (default),
(FC depends on the variable type)
Copies the selected PFC variables with all of the settings.
Copy
Inserts the copied PFC variables with all of the settings.
Paste
Copies the selected entries as IEC 61131 code to the clipboard,
Copy as IEC61131 code
enabling slave variable definitions to be transferred to the slave
CODESYS program.
You can also copy IEC code from CODESYS!
To do so, select the variable definitions in CODESYS
program, copy them to the clipboard and insert them in
the PFC variable list via the "Insert" menu item. The
Master Configurator can then generate corresponding
entries in the tree structure.
You can also paste the variable definitions from the
clipboard into another instance of the MODBUS
Master Configurator.
Manual
Version 1.0.0
38
User Interface
5.2.7
WAGO Software
MODBUS Master Configurator
Context menu for the "K-Bus" Entry
Figure 21: Context menu for the "K-Bus" entry
Table 27: Legend to Figure "Context menu for the K-Bus entry"
Menu Item
Description
If the MODBUS slave can be accessed online, the components
Scan node
and process data variables of the connected fieldbus node are
scanned and their configurations listed as subentries.
The "Module selection" dialog appears.
Add
Copies all configured I/O modules to the marked internal data
Copy
bus with all settings.
Inserts the copied I/O module configuration with all settings in
Paste
the selected internal data bus.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
5.2.7.1
User Interface
39
"Module selection" Dialog
The Module selection dialog is opened from the "K-Bus " context menu, "Add"
menu item.
Figure 22: Module selection dialog
Table 28: Legend to Figure " Module selection dialog"
Module catalogue
Entry
Description
Input field to filter the selection of I/O modules by specific item
Filter 075x-____
numbers.
Digital Input
Counter
Analog Input
Folders that contain the item number of the respective I/O modules
Special Interface
as subentries for selection.
Digital Outpup
Analog Output
Serial Interface
Selected modules
Entry
Description
After applying the selected I/O modules from the "Module
____
catalogue" on the left side, the I/O modules are displayed in the
"Selected modules" on the right side. By clicking [OK] to confirm,
the I/O modules are then inserted in the tree structure of the network
configuration under the "K-Bus" entry.
Buttons
Click this button to move the modules selected in the "Module
[>>]
catalogue" area on the left side to the "Selected modules" area on the
right side.
Click this button to remove all the modules marked in the "Selected
[<<]
modules" on the right side.
Click this button to apply all settings and close the dialog.
[OK]
Click this button to discard all settings and close the dialog.
[Cancel]
Manual
Version 1.0.0
40
Operation
WAGO Software
MODBUS Master Configurator
Pos : 18 /Serie 759 ( WAGO-Softwar e)/MOD BUS-M aster-Konfigurator/M ODBU S-Mas ter-Konfigurator - Bedi enen @ 19\mod_1397201206500_21.doc x @ 151328 @ 12233233344332333332 @ 1
6
6.1
Operation
1.
Make the network presets.
2.
Insert the required interfaces.
3.
Configure your interfaces.
4.
Insert your MODBUS slaves.
5.
Configure the communication settings for your MODBUS slaves.
6.
Configure the hardware for your MODBUS slaves.
7.
Insert the required generic variables and PFC variables.
8.
Configure the required generic variables, PFC variables and internal data
bus variables.
9.
Generate the IEC code from your configuration settings.
Make Network Presets
1.
In the main view of the MODBUS Master Configurator, click the
[Network View] button.
The MODBUS network dialog opens.
2.
Select the "MODBUS master" entry right-click.
The context menu opens.
3.
Click "Edit" in the context menu.
The Parameter code generator dialog opens.
4.
In the dialog, enable the "Generate CODESYS tasks" function to generate
IEC code from the configuration settings.
5.
In the dialog, change the minimum task cycle time for the MODBUS RTU
task and interface multiplier if desired.
You can also change the minimum task cycle time for the MODBUS
ETHERNET task and the multiplier per configured slave if desired.
6.
Click [OK] to confirm your settings.
The Parameter code generator dialog closes.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
6.2
Add Interface
6.2.1
Add Serial or ETHERNET Interface
6.2.2
Operation
41
1.
Select the "MODBUS master" entry and right-click.
The context menu opens.
2.
In the context menu, click the "Add serial interface" menu item if you want
to communicate to your MODBUS master via the serial interface.
The entry for the serial interface is displayed in the tree structure.
3.
In the context menu, click the "Add ETHERNET interface" menu item if
you want to communicate to your MODBUS master via ETHERNET.
The entry for the ETHERNET interface is displayed in the tree structure.
Configure Serial Interface
1.
Select the "Interface (COMx)" entry and right-click.
The context menu opens.
2.
In the context menu, click the "Edit" menu item.
The Settings: Serial interface dialog opens.
3.
In the dialog for the serial interface, if desired, change the number for the
COM port, select the baud rate, number of data bits and stop bits, parity,
hardware type and whether flow control and ASCII mode should be
enabled.
4.
Click [OK] to confirm your settings.
The Settings: Serial interface dialog closes.
6.3
Insert and Configure MODBUS Slave
6.3.1
Insert MODBUS Slave Online
1.
Select the "Interface (COMx)" or "Interface (ETHERNET)" entry and
right-click.
The context menu opens..
2.
If you can access your MODBUS slaves online, click the "Find devices"
menu item in the context menu.
The Search device dialog opens..
3.
In the dialog, change the IP addresses for the address range according to the
IP addresses of the devices that are online.
If necessary, enable the "Resolve network names" and "Display all devices
in the network" functions.
4.
Confirm your settings and click [Browse] to enable the search.
The devices found that are accessible online are displayed in the device list.
Manual
Version 1.0.0
42
Operation
5.
6.3.2
6.3.3
6.3.3.1
WAGO Software
MODBUS Master Configurator
Select the devices found in the device list and click [Apply].
The Search device dialog closes and the MODBUS slaves are applied in the
network tree structure as subentries.
Insert MODBUS Slave Offline
1.
If configuring a MODBUS slave offline, click the "Add MODBUS slave"
menu item in the context menu.
The MODBUS slave selection dialog opens.
2.
Mark the required devices in the selection list and double-click in the
"Choosen devices" list below to apply.
3.
Mark the selected devices in the list below and click [OK].
The MODBUS slave selection closes and the MODBUS slaves are applied
in the network tree structure as subentries.
Configure MODBUS Slave
1.
Select the "ModbusSlave" entry and right-click.
The context menu opens.
2.
In the context menu, click the "Edit" menu item.
The Communication settings dialog opens.
The setting options for MODBUS slave communication depend on the type
of interface your MODBUS slave is attached to.
Configure MODBUS Slave via Serial Interface
1.
If your MODBUS slave is connected to a serial interface, select the
"MODBUS RTU settings" tab in the dialog.
2.
If desired, change the time values for "Time-out", "Delay [ms]" and
"MODBUS unit ID".
3.
To set direct access to the MODBUS slave from a service PC, select the
"Service settings" tab in the dialog.
4.
If desired, change the option for access via the ETHERNET address or the
required serial interface.
5.
Click [OK] to confirm your settings.
The Communication settings dialog closes.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
6.3.3.2
6.3.4
6.3.5
Operation
43
Configure MODBUS Slave via ETHERNET Interface
1.
If your MODBUS slave is connected to an ETHERNET interface, select the
"MODBUS ETHERNET settings" tab in the dialog.
2.
If desired, change the type for "Transport", "IP address", "Port", time value
for "Timeout [ms]" and the "MODBUS unit ID".
3.
To set direct access to the MODBUS slave from a service PC, select the
"Service settings" tab in the dialog.
4.
If desired, change the option for access via the ETHERNET address or the
required serial interface.
5.
Click [OK] to confirm your settings.
The Communication settings dialog closes.
Configure WAGO MODBUS Slave Hardware Online
1.
Select the "ModbusSlave" entry and right-click.
The context menu opens.
2.
If you can access your MODBUS slave online, click the "Scan node" menu
item in the context menu.
All data points for the connected I/O modules in the fieldbus node are
displayed in the tree structure under the "K-Bus " entry as internal data bus
variables.
Configure WAGO MODBUS Slave Hardware Offline
1.
For offline configuration, select the "K-Bus" subentry under the
"ModbusSlave" entry and right click.
The context menu opens.
2.
In the context menu, click the "Add" menu item.
The Module selection dialog appears.
3.
In the "Module catalogue" area on the left side, double-click the modules
that are in your fieldbus node as I/O modules.
After double-clicking, the modules are displayed in the "Selected modules"
area on the right.
4.
Click [OK] to confirm your settings.
The Module selection dialog closes and all data points for the selected I/O
modules are displayed in the tree structure under the "K-Bus" entry as
internal data bus variables.
Manual
Version 1.0.0
44
Operation
WAGO Software
MODBUS Master Configurator
6.4
Insert and Configure Variables
6.4.1
Add Generic Variables
6.4.2
1.
Select the "Generic variables" subentry under the "ModbusSlave" entry
and right-click.
The context menu opens.
2.
In the context menu, click the "Add" menu item.
A variable of the "BOOL" type, without access, is displayed under the
"Generic variables" entry.
Configure Generic Variables
1.
In the tree structure, select the entry for the generic variable that you want to
configure. Double-click the entry to edit the name of the variables, if
necessary.
2.
In the "Type" column for the generic variable, select the data type and
double-click.
A selection list with data types is displayed.
3.
Select the required data type for the generic variable.
The function code for MODBUS access appropriate for the selected data
types is automatically displayed in the "IEC Address" or "Communication"
column.
4.
In the "Access" column for the generic variable, select the default entry
"none" and double-click.
A selection list with the options "read", "write" and "none" is displayed.
5.
Select the access required for the generic variable.
6.
Select the field in the "Comment" column.
Double-click to edit the field and to enter a comment, if necessary.
7.
In the tree structure, select the subentry of one desired variable and rightclick to open the context menu.
8.
In the context menu, select the "Number of items" menu item.
The Enter the number of items dialog opens.
9.
Enter the required element count in the dialog and click [OK] to confirm
your settings.
The Enter the number of items dialog closes.
10.
In the context menu, click the "Edit address" menu item.
The MODBUS address dialog opens.
11.
In the dialog, select the required function code to read and write variables
from the selection list and click [OK] to confirm your settings.
The MODBUS address dialog closes.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
6.4.3
6.4.4
Operation
45
12.
In the context menu, select the "Communication" menu item and if required,
select the "Explicit" or "Optimized" menu item.
Optimized communication is set by default.
Variables with explicit communication are displayed in red font.
13.
If required, configure other variables in the same way.
Add PFC Variables
1.
Select the "PFC variables" subentry under the "ModbusSlave" entry and
right-click.
The context menu opens.
2.
In the context menu, click the "Add" menu item.
A "BOOL" type variable, without access, is displayed under the "PFC
variables" entry.
Configure PFC Variables
1.
In the tree structure, select the entry for the PFC variable that you want to
configure. Double-click the entry to edit the name of the variables, if
necessary.
2.
In the "Type" column for the PFC variable, select the data type and doubleclick.
A selection list with data types is displayed.
3.
Select the required data type for the PFC variable.
The address string for IEC addressing of the selected data type, as well as
the appropriate function code for MODBUS access, are automatically
displayed in the "IEC address" or "Communication" column.
4.
In the "IEC address" column for the PFC variable, select the IEC address
and double-click.
You can set the address as required.
5.
In the "Access" column for the PFC variable, select the default entry "none"
and double-click.
A selection list with the options "read", "write" and "none" is displayed.
6.
Select the access required for the PFC variable.
7.
Select the field in the "Comment" column.
Double-click to edit the field and enter a comment, if necessary.
8.
In the tree structure, select the subentry of one desired variable and rightclick to open the context menu.
9.
In the context menu, select the "Communication" menu item and if required,
select the "Explicit" or "Optimized" menu item.
Optimized communication is set by default.
Variables with explicit communication are displayed in red font.
Manual
Version 1.0.0
46
Operation
6.4.5
6.5
WAGO Software
MODBUS Master Configurator
10.
In the context menu, select the "Copy as IEC 61131 code" menu item.
The PFC variable settings are copied to the clipboard as IEC code, so that
you can directly paste them into the variable declaration of your IEC
project.
11.
If required, configure other variables in the same way.
Configure K-Bus Variables
1.
In the tree structure, select under the K-Bus entry the desired subentry for
the internal data bus variable that you want to configure. Double-click the
entry to edit the name of the variables, if necessary.
2.
In the "Access" column for the internal data bus variable, select the default
entry "none" and double-click.
A selection list with the options "read", "write" and "none" is displayed.
3.
Select the access required for the internal data bus variable.
4.
Select the field in the "Comment" column.
Double-click to edit the field and enter a comment, if necessary.
5.
In the tree structure, select the subentry of one desired variable and rightclick to open the context menu.
6.
In the context menu, select the "Communication" menu item and if required,
select the "Explicit" or "Optimized" menu item.
Optimized communication is set by default.
Variables with explicit communication are displayed in red font.
7.
If required, configure other variables in the same way.
8.
Click [OK] to confirm all settings.
The MODBUS network dialog closes.
Generate IEC Code
1.
In the main view of the MODBUS Master Configurator, click the
[Generate code] button to automatically generate the IEC code from your
configuration settings.
2.
You can then use the generated function blocks in your application program
in WAGO-I/O-PRO.
Once in WAGO-I/O-PRO, go to the "POUs" tab.
The program modules are created there.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Operation
More information about WAGO-I/O-PRO function blocks!
Detailed information about libraries and descriptions of the function blocks
available in WAGO I/O-PRO by code generation are in the appendix.
Pos : 19 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
47
48
Glossary
WAGO Software
MODBUS Master Configurator
Pos : 20 /D okumentation allgemei n/Verz eic hniss e/Glossar - Übersc hrift 1 @ 7\mod_1265811387961_21.doc x @ 50272 @ 1 @ 1
7
Glossary
Pos : 21 /All e Seri en (Allgemei ne Module)/F eldbus kommuni kation/M ODBU S/Gloss ar - M ODBU S @ 18\mod_1392372231086_21.doc x @ 145512 @ @ 1
More information about MODBUS technical terms!
Detailed information about MODBUS-specific terms and technologies is
available on the MODBUS website at:
www.modbus.org
C
CODESYS 2.3
A programming environment based on the IEC 61131-3 standard.
CODESYS Task
Subprocesses that execute specific POUs (Program Organization Units)
cyclically and after events.
D
DTU
Date type objects in CODESYS (STRUCT, ENUM).
E
EXP Format
This format uses the CODESYS 2.3 environment to export project elements
in a human-readable format.
F
Function
Module that always returns the same results (as a function value). It has no
local variables that store values beyond an invoke.
Function block
Module that returns one or more values when executed. It can be saved as a
local variable ("memory").
G
Generic Variable
Network variable used to address and employ devices from third-party
manufacturers in a network as MODBUS slaves.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Glossary
49
I
IEC 61131-3
International standard for modern systems with PLC functionality created in
1993. Based on a structured software model, it defines a series of powerful
programming languages to be utilized for different automation tasks.
K
K Bus
Internal data bus in the fieldbus node of the WAGO-I/O-SYSTEM 750.
L
Library
Collection of modules available to the programmer in the WAGO-I/O-PRO
programming tool (CODESYS) for creating control programs that adhere to
IEC 61131-3.
M
MODBUS
Communication protocol standardized in IEC 61158 - CPF15.
MODBUS ASCII
MODBUS protocol that transfers data in ASCII code. This type of
communication is not prevalent.
MODBUS Master
Node in the MODBUS network that can make active communication
requests to other nodes.
MODBUS Protocol
For communication between MODBUS master and slave, various
MODBUS protocols with different data transmission formats can be
selected, such as MODBUS ASCII, MODBUS RTU, MODBUS TCP and
MODBUS UDP.
MODBUS RTU
MODBUS protocol that transfers data in a binary format. Next to MODBUS
TCP, this protocol is used most often.
MODBUS Slave
Node in the MODBUS network that reacts and responds to incoming
communication requests.
Manual
Version 1.0.0
50
Glossary
WAGO Software
MODBUS Master Configurator
MODBUS TCP
MODBUS protocol that functions as the RTU implementation. The main
difference between MODBUS RTU and TCP is the transmission of data to
the TCP / IP stack. This permits communication via the Internet, if
necessary, and is not limited by the cable length. Port 502 is reserved for
MODBUS. The MODBUS TCP implementation is currently being specified
as a standard (IEC PAS 62030 [pre-standard]).
MODBUS UDP
MODBUS protocol that transfers data in a binary format. Next to MODBUS
TCP, this protocol is used most often.
Module
Modules consist of functions, function blocks and programs.
Every module is made up of a declaration part and a body. The body is
written in one of the IEC programming languages STL (statement list), ST
(structured text), AS (process structure), FUP (function plan) or KOP
(coupling plan).
N
Network Variable
A network variable is a type-related variable in IEC 61131 programming for
implementing logical communication channels and links between the
network nodes.
This can be associated with one or more network variables of one or more
network nodes.
P
POU
Abbreviation for Program Organization Unit, which are program objects in
CODESYS (PRG, FB).
S
Special Feature Register
MODBUS registers from address 0x1000 to 0x2052. With WAGO devices,
these registers contain additional information about the present WAGO
fieldbus node. In most WAGO applications, this range cannot be considered
contiguous flat memory.
Pos : 22 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Appendix
51
Pos : 23 /Serie 759 ( WAGO-Softwar e)/MOD BUS-M aster-Konfigurator/Anhang - M ODBU S-Mas ter-Konfigur ator (Funkti ons bausteine) @ 18\mod_1392372153273_21.doc x @ 145508 @ 122333323333333 @ 1
8
Appendix
This appendix contains information about the libraries and function blocks
available in WAGO-I/O-PRO after code generation, as well as descriptions of
data access via the function codes.
More information about WAGO libraries!
Please also note the descriptions in the manuals for libraries for WAGO-I/O-PRO
at:
www.wago.com.
Pos : 19 /Serie 759 ( WAGO-Softwar e)/LON-Configur ator/Erz eugte WAGO-I/O-PR O-Baus tei ne und LON .lib @ 12\mod_1339688502370_6.doc @ 97505 @ 233333333333333333332122222222 @ 4
8.1
WAGO-I/O-PRO-Libraries
The following Table s provide an overview of the WAGO-I/O-PRO libraries
(CODESYS 2.x) and the device class of MODBUS master devices used for a
specific communication channel.
Table 29: CODESYS 2.x libraries used depending on the device class of the MODBUS master
devices.
Device Class MODBUS RTU
ETHERNET TCP ETHERNET UDP
16-bit
Modb_l05.lib
MODBUSEthernet_ MODBUSEthernet_04.lib
derivatives
(with SerCom.Lib)
04.lib
32-bit
Modb_l05.lib
WagoLibMODBUS_ WagoLibMODBUS_IP_01.lib
derivatives
Module:
IP_01.lib
Module:
MODBUS_EXTEND Module:
ETHERNET_MODBUSMASTER
ETHERNET_MOD _UDP
ED_MASTER
BUSMASTER_TCP
PERSPECTO® Modb_l05.lib
WagoLibMODBUS_ WagoLibMODBUS_IP_01.lib
Control Panel/ Module:
IP_01.lib
Module:
Control Panel MODBUS_EXTEND Module:
ETHERNET_MODBUSMASTER
with Target
ETHERNET_MOD _UDP
ED_MASTER
Visualization (with
BUSMASTER_TCP
SerComPerspecto.Lib
and CRC_Extern.lib)
The following Table provides an overview of the libraries integrated in your
WAGO-I/O-PRO project (CODESYS 2.x) during code generation. The libraries
are only statically linked when required.
Manual
Version 1.0.0
52
Appendix
WAGO Software
MODBUS Master Configurator
Table 30: CODESYS 2.x used depending on the code generation
Library
Description
Modb_l05.lib
Makes the MODBUS RTU function available, and is
available for each device class.
WagoLibMODBUS_IP_01.lib
Makes the MODBUS function available for TCP/IP, used
for 32-bit and PERSPECTO® device classes.
MODBUSEthernet_04.lib
Makes the MODBUS function available for TCP/IP, used
for 16-bit device class.
Ethernet.lib
TCP/IP and UDP/IP functionality for 16-bit device class.
Serial_Interface_01.lib
Encapsulates the functions of the SerComm.Lib for easier
access.
SerComm.lib
Makes basic functionality for serial communication
transparent via internal data bus or device connection.
SercomPerspecto.lib
Adaptation of SerComm.Lib for PERSPECTO® device class
mod_com.lib
Makes help functions available, required for MODBUS
communication.
CRC_Extern.lib
MbMasterCommon.lib
Contains specific function blocks that define MODBUS
communication to one specific slave or via one specific
serial interface.
Also included are user-defined data types generated in
response to user input.
8.1.1
WAGO-I/O-PRO Function Blocks
After making the communication settings and generating function blocks, the
generated function blocks are available with MODBUS communication and
variable definitions in your WAGO-I/O-PRO project for a PLC application.
8.1.2
Directory Structure
Figure 23: Directory structure of the function blocks (overview)
In the tree structure view, the main program entry "PLC_PRG [PRG]" always
appears automatically when creating a project in WAGO-IO-PRO.
The PLC_PRG [PRG] is a module of the "Program" type and is automatically
generated by WAGO-I/O-PRO when creating a new project.
This main program module must be contained in each PLC program for project
execution if there is no task configuration for the execution sequence. This
module may not be deleted or renamed.
PLC_PRG [PRG] is called up once per control cycle.
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Appendix
53
The settings and function blocks generated in the MODBUS Master Configurator
are in the "Configuration" and "Generated Code" directories.
In the "Generated Code" directory, a program module ([PRG] module) is
generated for each configured MODBUS slave.
The generated "PRG" modules are stand-alone programs that allow data exchange
between the PLC main program and the corresponding MODBUS slave. These
are cyclically executed by a task.
Within the task "MBCFG_MASTER_TASK", the entire list of MODBUS slave
PRG modules is processed sequentially.
The "MBCFG_MASTER_TASK" is used for all MODBUS communication.
Managed by the MODBUS Master Configurator, this task is automatically
included as needed.
Manually remove the "MBCFG_MASTER_TASK"!
Please note that automatic removal of the MODBUS Master
"MBCFG_MASTER_TASK" is not possible for MODBUS communication. If
you no longer want MODBUS Master functionality in your WAGO-I/O-PRO
project, the task must be manually removed!
There is a list of communication jobs and corresponding variable addresses in the
MODBUS process image of the slave within the MODBUS slave program
modules.
The variables of the MODBUS slaves defined by you are executed as INPUT or
OUTPUT objects of the modules.
8.1.3
Program Execution of the Generated Code
When the generated code is executed, each slave program generates a list of
variables to be communicated, corresponding communication jobs and one
communication object (TCP/UDP/RTU) at startup.
There can be fewer communication jobs than variables and several variables can
be processed with one communication job.
Each variable contains a reference to a communication job.
The two lists are passed to the communication object.
During the task run-time, the communication object runs through the job list,
performs the tasks specified (MODBUS read, MODBUS write) and then updates
the values of the variables in the list passed.
Before a "Write" job is executed, the variables assigned to the job are first
processed and compiled from the data collected in the data range.
For a "Read" job, the process is similar, i.e., the values are first read from the
MODBUS slave and then distributed to the assigned variables.
Manual
Version 1.0.0
54
Appendix
8.1.4
WAGO Software
MODBUS Master Configurator
Cycle Time of the "MBCFG_MASTER_TASK"
The task cycle time does not depend on the number of communication jobs, but
on the number of variables across all slave PRG objects.
During each cycle, one new job per slave is started or stopped — most of the time
is needed to process the variable list (distribute data read, collect data to be
written).
For this reason, the cycle time of the task per 100 variables is increased by 1 ms.
Initially, the cycle is set to 10 ms.
8.1.5
Data Storage, Persistent
The communication settings and data points you defined must be cached to be
available the next time the configuration dialog is called up.
To save these settings along with the WAGO-I/O-PRO project, a
"MODBUS_CONFIGURATION [PRG]" module is generated that is not
assigned to any task.
It is located in the "Configuration" directory.
In a comment field for this module, the entire configuration is stored as text with
information about the node structure on the internal data bus of the WAGO slaves,
the communication settings to the slaves, as well as the designations and data
point types.
To load it, WAGO-I/O-PRO is first instructed to export the module to a temporary
file. The file generated is compiled by the MODBUS Master Configurator (source
code to target code) and then displayed as XML in WAGO-I/O-PRO.
Once defined, this makes it possible to apply the structure in other WAGO-I/OPRO projects by EXP export of the PRG module.
If there are no configuration settings, an empty configuration is created.
Figure 24: Configuration settings, persistent
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
Appendix
55
Do not manually change the saved format!
Please note that you should not manually change the saved format; the structure is
already saved, and any manual change will be detected.
8.1.6
MODBUS Function Codes
For access to WAGO MODBUS slaves, no manual input of the MODBUS
communication parameters is required. Which MODBUS services are used can be
specified via the MODBUS Master Configurator depending on what data ranges
(bit/register area) should be accessed. The definitions are included when
generating the code.
Table 31: MODBUS function codes used
Data Range
MODBUS function code (FC)
Bit range
FC01 (Read Coils)
FC02 (Read Discrete Inputs)
FC05 (Write Single Coil)
FC15 (Write Multiple Coils)
Register range
FC03 (Read Holding Registers)
FC04 (Read Input Registers)
FC06 (Write Single Registers)
FC16 (Write Multiple Registers)
FC22 (Mask Write Registers)
FC23 (Read/Write Multiple Registers)
8.1.7
Access to WAGO Slaves
When accessing MODBUS slaves from WAGO, the following rules apply:
•
•
•
•
8.1.8
All register- and bit-based services access the same logical range.
The data points can be read and written under the same MODBUS
address/bit offset.
Bit-based services do not have access to complex or analog I/O modules.
The Special Feature Register is not implemented as flat-addressable
memory, i.e., neighboring addresses must have no logical connection.
Access to the Hardware Area
For access to the input and output data of the WAGO MODBUS slaves (I/O
modules), use either the register services or the bit services for digital data.
8.1.9
Access to the PFC Variable Area and Flags
The register services access the PFC area of the WAGO MODBUS slaves with
CODESYS 2.x runtime system.
Manual
Version 1.0.0
56
Appendix
8.1.10
WAGO Software
MODBUS Master Configurator
Access to the Special Feature Registers
Access to the Special Feature Registers is realized by means of the register
services.
8.1.11
Optimizing Communication with WAGO MODBUS Slaves
The number of communication processes when reading and writing can be
reduced when several data points can be combined into one read/write operation.
This optimization cannot be applied for Special Feature Registers as there is no
flat address on the MODBUS level, i.e., neighboring addresses must have no
logical connection.
8.1.12
Access to Generic MODBUS Slaves, ManufacturerIndependent
If MODBUS slaves from other manufacturers are used, then the data points must
be manually defined with corresponding read/write commands and MODBUS
addresses/bit offsets.
When accessing generic MODBUS slaves from other manufacturers, the
following rules apply:
•
Data points cannot be read and written under the same MODBUS
address/bit offset.
•
The length of the data points when reading and writing may not differ.
•
When accessing data points with lengths not from M={x*16 bit | x ϵ N ),
it is accepted that remaining areas of the accessed address are overwritten
with 0.
• Optimizing communication is optional since it cannot be assumed that
corresponding FC codes (FC16, FC15) are implemented in the target system, and
that there is a flat-addressable area. As many MODBUS slave types should be
supported as possible.
8.1.13
Access to MODBUS Data Points from the IEC 61131
Program
Because a separate program module is created for each MODBUS slave when
generated, access to the individual data points of the MODBUS slaves is provided
by the input or output variables of the respective slave program.
Pos : 24 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
=== Ende der Liste für T extmar ke Inhalt_mitte ===
Manual
Version 1.0.0
Appendix
57
58
List of Figures
WAGO Software
MODBUS Master Configurator
Pos : 26 /D okumentation allgemei n/Verz eic hniss e/Abbil dungs verz eic hnis - Übersc hrift oG und Verz eichnis @ 3\mod_1219222916765_21.doc x @ 21080 @ @ 1
List of Figures
Figure 1: View of the controller configuration with MODBUS Master
Configurator ................................................................................................. 14
Figure 2: Example configuration for using the MODBUS Master Configurator.. 15
Figure 3: Example of "optimized" and "explicit" data access ............................... 16
Figure 4: User interface of the MODBUS Master Configurator ........................... 20
Figure 5: MODBUS netzwork dialog (without configuration) ........................... 21
Figure 6: MODBUS netzwork dialog (with example configuration) .................. 21
Figure 7: Context menu for the""MODBUS master" entry ................................ 22
Figure 8: Parameter code generator dialog ........................................................ 23
Figure 9: Context menu for the "Interface (COMx)" entry ................................ 24
Figure 10: Settings: Serial interface dialog ........................................................ 25
Figure 11: Search device dialog ........................................................................... 26
Figure 12: Context menu for the "Interface (ETHERNET)" entry .................... 27
Figure 13: Search device dialog ........................................................................... 29
Figure 14: Context menu for the "ModbusSlave" entry ....................................... 30
Figure 15: Communication settings dialog [for Interface (COMx)] ................... 31
Figure 16: Communication settings dialog [for Interface (ETHERNET)] ......... 33
Figure 17: MODBUS slave selection Dialog ....................................................... 35
Figure 18: Context menu for the "Generic variables" entry ................................ 35
Figure 19: WAGO MODBUS register dialog ..................................................... 36
Figure 20: Context menu for the "PFC variables" entry...................................... 37
Figure 21: Context menu for the "K-Bus" entry ................................................... 38
Figure 22: Module selection dialog ...................................................................... 39
Figure 23: Directory structure of the function blocks (overview)......................... 52
Figure 24: Configuration settings, persistent ........................................................ 54
Pos : 27 /D okumentation allgemei n/Glieder ungs elemente/---Seitenwechs el--- @ 3\mod_1221108045078_0.doc x @ 21810 @ @ 1
Manual
Version 1.0.0
WAGO Software
MODBUS Master Configurator
List of Tables
59
Pos : 28 /D okumentation allgemei n/Verz eic hniss e/Tabell enverz eichnis - Übersc hrift oG und Verz eichnis @ 3\mod_1219222958703_21.doc x @ 21084 @ @ 1
List of Tables
Table 1: Number notation........................................................................................ 8
Table 2: Font conventions ....................................................................................... 8
Table 3: Required PC hardware .............................................................................. 9
Table 4: Required software ................................................................................... 10
Table 5: Optional software .................................................................................... 10
Table 6: Supported MODBUS master devices...................................................... 11
Table 7: Hardware interfaces ................................................................................ 11
Table 8: Possible WAGO MODBUS slaves ......................................................... 12
Table 9: Configuration procedure overview ......................................................... 17
Table 10: General settings from the context menus of tree structure entries ........ 18
Table 11: Legend to figure "User interface of the MODBUS Master Configurator"
...................................................................................................................... 20
Table 12: Legend to figure "MODBUS netzwork dialog" .................................. 22
Table 13: Legende to Figure "Context menu for the "MODBUS master entry" . 22
Table 14: Legende to Figure "Parameter code generator dialog"...................... 24
Table 15: Legend to Figure "Context menu for the Interface (COMx) entry ..... 24
Table 16: Legend to Figure "Settings: Serial interface dialog" .......................... 25
Table 17: Legend to Figure " Search device dialog"............................................ 27
Table 18: Legend to Figure "Context menu for the Interface (ETHERNET)
entry" ............................................................................................................ 28
Table 19: Legend to Figure "Search device dialog"............................................. 30
Table 20: Legend to Figure "Context menu for the ModbusSlave entry"............ 31
Table 21: Legende to Figure "Communication settings dialog [for Interface
(COMx)])" ................................................................................................... 32
Table 22: Legend to Figure " Communication settings dialog [for Interface
(ETHERNET)]" ........................................................................................... 33
Table 23: Legend to Figure " MODBUS slave selection Dialog" ....................... 35
Table 24: Legend to Figure " Context menu for the Generic variables entry ".. 35
Table 25: Legend to Figure "WAGO MODBUS register" dialog ...................... 36
Table 26: Legend to Figure " Context menu for the "PFC variables" entry" ...... 37
Table 27: Legend to Figure "Context menu for the K-Bus entry" ........................ 38
Table 28: Legend to Figure " Module selection dialog"...................................... 39
Table 29: CODESYS 2.x libraries used depending on the device class of the
MODBUS master devices. ........................................................................... 51
Table 30: CODESYS 2.x used depending on the code generation ....................... 52
Table 31: MODBUS function codes used ............................................................. 55
=== Ende der Liste für T extmar ke Verzeic hnis_hi nten ===
Manual
Version 1.0.0
Pos : 30 /D okumentation allgemei n/Einband/Einband H andbuc h - R üc kseite @ 9\mod_1285229376516_21.doc x @ 64944 @ @ 1
WAGO Kontakttechnik GmbH & Co. KG
Postfach 2880 • D-32385 Minden
Hansastraße 27 • D-32423 Minden
Phone:
+49/5 71/8 87 – 0
Fax:
+49/5 71/8 87 – 1 69
E-Mail:
info@wago.com
Internet:
=== Ende der Liste für T extmar ke Ei nband_hinten ===
http://www.wago.com
Download PDF