Manual WAGO-Software WAGO ETS Plug-in for the Configuration of WAGO KNX Devices 2.0.
WAGO-Software WAGO ETS Plug-in © 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.
WAGO-Software WAGO ETS Plug-in Table of Contents 3 Table of Contents 1 1.1 1.2 1.3 1.4 1.5 Notes about this Documentation ................................................................. 5 Scope ......................................................................................................... 5 Copyright................................................................................................... 5 Symbols .....................................................................................
Table of Contents 4.2 4.2.1 4.2.2 4.2.3 WAGO-Software WAGO ETS Plug-in Associating Network Variables and Group Addresses ........................... 39 Creating Associations ......................................................................... 39 Error Messages ................................................................................... 40 Deleting Associations ......................................................................... 41 5 KNXnet/IP Router Parameterization .................
WAGO-Software WAGO ETS Plug-in 1 Notes about this Documentation 5 Notes about this Documentation Keep this documentation! The operating instructions are part of the product and shall be kept for the entire lifetime of the device. They shall be transferred to each subsequent owner or user of the device. Care must also be taken to ensure that any supplement to these instructions are included, if applicable. 1.
1.3 Notes about this Documentation WAGO-Software WAGO ETS Plug-in Symbols Personal Injury! Indicates a high-risk, imminently hazardous situation which, if not avoided, will result in death or serious injury. Personal Injury Caused by Electric Current! Indicates a high-risk, imminently hazardous situation which, if not avoided, will result in death or serious injury.
WAGO-Software WAGO ETS Plug-in Notes about this Documentation Additional Information: Refers to additional information which is not an integral part of this documentation (e.g., the Internet). Manual 2.0.
1.4 Notes about this Documentation Number Notation Table 1: Number notation Number code Decimal Hexadecimal Binary 1.5 WAGO-Software WAGO ETS Plug-in Example 100 0x64 '100' '0110.0100' Note Normal notation C notation In quotation marks, nibble separated with dots (.) 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.
WAGO-Software WAGO ETS Plug-in 2 Important Notes 9 Important Notes This section describes the legal principles and system requirements for using the software in compliance with intended purpose, underlying provisions and stated specifications. 2.1 Legal Bases 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.
2.2 Important Notes WAGO-Software WAGO ETS Plug-in System Requirements Minimal system requirement: Table 3: Minimal system requirement PC Operating System Main memory Fixed disk storage Monitor Resolution Mouse Drive Interface Others 2.3 min. 1 GHz processor capacity Windows 98, Windows 2000, Windows XP, Windows 7 (recommended) 256 MB 3 GB Super VGA or higher 1024x768 recommended USB, serial, KNXnet/IP controller 750-889 as router, KNXnet/IP the ETS Plug-in requires the ETS in version 3.
WAGO-Software WAGO ETS Plug-in 3 ETS 11 ETS The ETS (Engineering Tool Software) was specially developed for planning, project design and startup of KNX/EIB networks. During its development, ETS functionality was optimized and the latest version includes options for setting up, maintaining, servicing and expanding KNX networks.
3.2 ETS WAGO-Software WAGO ETS Plug-in Access to KNX Devices via ETS4 ETS provides the following options in order to access KNX devices within a bus system: • • • Serial, using the COM interface USB ETHERNET (“KNXnet/IP” or “KNXnet/IP Routing”) The ETS4-equipped PC used for project design must be connected to a KNX interface. An interface can be configured in ETS4 via [Settings] > Communication > [New]. This procedure applies to all selected connection types.
WAGO-Software WAGO ETS Plug-in 3.3 ETS 13 Interworking Datapoint Types (DPTs) DPTs describe defined formats and data widths of communication objects. The KNX Module supports the following EIB data widths: • 1 … 7 bits • 1 … 4 bytes • 6 bytes • 8 bytes • 10 bytes • 14 bytes Additional information about “Interworking Datapoint Types”! Additional information about “Interworking Datapoint Types” can be found at http://www.konnex.org. 3.
ETS WAGO-Software WAGO ETS Plug-in Table 5: Syntax for array variable Wildcard 3.4.3 Length Digits 3 digits Digits Explanation KNX Module number Identifies variable array Identifies variable in array Syntax for Nested Variables The syntax for names of nested variables is: .M__[] Table 6: Syntax for nested variables Wildcard 3.4.
WAGO-Software WAGO ETS Plug-in 3.5 ETS 15 Importing the ETS Plug-in ETS4 To import the ETS plug-in, select the corresponding vd4 file: 1. Click the [Catalogs] button on the ribbon. 2. Click the [Import…] button. Figure 2: Importing products This opens the “Import Products” dialog containing the import wizard that guides you through importing a product catalog into your database: Figure 3: Import products – Starting the import wizard Manual 2.0.0 3.
ETS WAGO-Software WAGO ETS Plug-in 6. Languages: Here you can choose to import all languages or make an additional selection. Then click the [Next] button. 7. The Summary relists all the selections made. Then click the [Import] button. The progress of the installation is indicated: Figure 4: Progress display The product database of the ETS is then automatically updated and contains the KNX Module, KNX IP Controller or the Router. Figure 5: Product catalog (extract) Manual 2.0.
WAGO-Software WAGO ETS Plug-in ETS 17 Multiple selections are possible if you import without using the import wizard! To import multiple products at the same time, hold down the [SHIFT] key while clicking the [Import…] button. This enables the simultaneous import of several products. Manual 2.0.
3.6 ETS WAGO-Software WAGO ETS Plug-in Opening the ETS Plug-in Move to the topology view of the ETS in order to accept the license agreement and open the plug-in. 1. Click Edit Parameters in the context menu of a device in the ETS to open the ETS Plug-in and configure the device. Figure 6: Opening the ETS Plug-in 2. The dialog for the license agreement of the WAGO software opens: Figure 7: License agreement Manual 2.0.
WAGO-Software WAGO ETS Plug-in 3. ETS Please read the license agreement carefully. • By clicking “I accept the license agreement.” you can confirm the dialog with [Next >]. The Setup then installs the ETS Plug-in. • If you do not agree with the license agreement, the setup is canceled by clicking [Cancel].
3.7 ETS WAGO-Software WAGO ETS Plug-in Importing a Symbol File in the ETS Plug-in Specific configurations are required to operate the KNX Module and the KNX IP Controller. The WAGO-I/O-PRO software generates these configurations and exports them to an “SYM_XML” icon file. In the Plug-in window: 1. Click [File] in the main menu of the plug-in user interface. 2. Select the Import SYM-XML file… menu item. Figure 9: “Import SYM-XML file…” menu item 3.
WAGO-Software WAGO ETS Plug-in ETS 21 If a node contains several KNX Modules, the DPTs of all bus modules are contained in the SYM_XML file. In this case, proceed as follows: 4. In the Module index selection field (“Settings” area), select the KNX Module number for the DPTs to be imported. 5. Click [Update] to start the synchronization. Observe the index counting method and designation! If a second KNX Module of this type is used on a KNX IP Controller (750-889), it will operate in device mode.
4 KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization The KNX/EIB/TP1 Module (753-646), referred to as the KNX Module, and the KNX IP Controller (750-889) use the same ETS Plug-in; however, the controller offers additional functions. This description applies to both the KNX Module and the Controller. Other functions are described.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 23 is also possible to use the mouse to resize the individual window panes to the desired height and width. 4.1.1 Main Menu The main menu contains the following items, each contains its own submenu items: • File • View • Tools* • Options • Help * only when configuring controllers 4.1.1.1 “File” Menu Item Figure 12: “File” menu item Table 9: “File” menu item Menu Item Import SYMXML file… Save Manual 2.0.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in Table 9: “File” menu item Menu Item Export Description The following submenu items enable you to export the current configuration. XML (Backup) Export as XML file (not a SYM_XML file). All settings of WAGO devices (assignment of network variables, their properties, the settings of network variables and the assignment of communication objects to group addresses, etc.) are saved as an XML file.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 25 Table 9: “File” menu item Menu Item Import Description Use the following submenu items to import a configuration. XML (Restore) Import as an XML file. This is not a SYM_XML file. CSV Export as a CSV file. The imported .csv file must have been previously exported and, if necessary, edited with Excel or a text editor. This enables you to change group address associations and other properties of network variables.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in 4.1.1.1.2 Exporting a Configuration as a CSV File CSV file does not contain a fully specified configuration! Unlike an XML file, the CSV file does not contain a fully specified configuration. It is therefore not suitable as a backup file. 1. In the main menu choose File > Export > CSV. 2. Enter a storage location in the opened dialog. 3. Left-click [Save] to save the configuration and close the dialog.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 27 4.1.1.1.4 Importing a CSV File CSV files do not contain a fully specified configuration! Unlike an exported XML file, the CSV file does not contain a fully specified configuration. It is therefore not suitable for: • transferring the configuration to a different device • reimporting after a manual change of the ETS visibility of variables • reimporting after an XML or SYM_XML import. 4.1.1.2 1.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization • WAGO-Software WAGO ETS Plug-in the infix (between basic name and suffix) for identification when nesting. Table 11: Structure of the network variable name – long/short form Langform . .KNX_ .M_ .M_[] .M_. .M_.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 29 Table 13: “Options” menu item Menu Item IP parameters… *) Options… *) Description This opens the “IP Controller” dialog to set the IP parameters for the controller. *) This opens the “Options” dialog to enter settings for functions such as telegram delay and automatic save. only when configuring controllers The Options… menu item opens the “Options” dialog.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in Figure 17: “Options” dialog – “CODESYS” tab 4.1.1.4.3 Setting the Autosave Function Use the “Autosave” tab to define automatic save for the current configuration. For this, the Enable automatic save of the configuration checkbox must be checked. Enter a number that defines the save interval in minutes.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 31 Figure 19: “IP Controller” dialog – KNXnet/IP parameters of the KNX IP Controller The KNX IP Controller needs an IP address for network integration. Various options for assigning the IP address include “manual,” “BootP,” “DHCP.” Use the [Scan IP] button to search the network for the IP address of the controller specified by the MAC address.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization 4.1.2 WAGO-Software WAGO ETS Plug-in Toolbar The toolbar provides fast and convenient access to frequently used functions of the main menu. Figure 21: Toolbar Table 15: Toolbar Button Action Imports an SYM_XML file, similar to selection of the SYM_XML file. Saves the settings to the ETS. The SYM_XML file is not changed. Prints the current configuration. Shows or hides the “Properties” tab. Opens the “Options” dialog.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 33 Table 16: “List of network variables” table Table Column No. CO # Name Type Send on reset Read on reset Timeout Cyclic send Group addresses Value / Description Checkbox for enabling or disabling visibility in the ETS. (Table row number) Consecutive number of the table rows. (Communication Communication object number in the ETS' object number) topology.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in Multiple selection is supported! In order to change the properties of several network variables at the same time, you can mark several lines in the “List of network variables” simultaneously. The changes that you make in the “Properties” tab then apply to all network variables marked in the list. 4.1.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization Figure 23: Selection of EIS type EIS 5, corresponds to DPT_Value_Temp Figure 24: Selection of EIB datawidth 2 byte, also contains DPT_Value_Temp Only one attribute (data type/datawidth) can be used as a filter! Only one attribute can be entered as a filter. Multiple selection in the EIB datatype window is not possible. Manual 2.0.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization 4.1.5 WAGO-Software WAGO ETS Plug-in “Properties” Tab Figure 25: “Properties” tab The “Properties” tab displays the properties of selected network variables. You can read or write properties here. The settings made are immediately updated in the “List of network variables” table. Manual 2.0.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 37 Table 17: Properties of network variables Designation Name Send on reset checkbox Read on reset checkbox Timebase Cyclic send checkbox Timeout checkbox Explanation Description of the selected network variable. If several network variables are selected: empty Startup behavior If the checkbox is checked, values are updated after a device reset.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in Figure 26: Multiple selection for editing network variables 4.1.6 Status Bar The “Assigned group addresses” percentage bar is shown on the right of the status bar.
WAGO-Software WAGO ETS Plug-in 4.2 KNX/EIB/TP1 Module / KNX IP Controller Parameterization 39 Associating Network Variables and Group Addresses The basic task of the ETS software is visualizing the associations of network variables of the KNX Module or KNX IP Controller with group addresses in the ETS and enabling them to be edited. 4.2.1 Creating Associations Associations between communication objects and group addresses are created using “drag & drop” in the ETS.
KNX/EIB/TP1 Module / KNX IP Controller Parameterization WAGO-Software WAGO ETS Plug-in Alternatively, you can also create the association via the context menu of the relevant communication object (Link with…). This opens the “Link Device Objects” dialog.
WAGO-Software WAGO ETS Plug-in KNX/EIB/TP1 Module / KNX IP Controller Parameterization 41 Figure 30: Example of an error message 4.2.3 Deleting Associations There are two options to remove an association of network variable and group address. If you right-click a group address from the Group Addresses area, you can choose Unlink from the context menu. This menu item is used removes links between the selected group address and all communication objects connected to it. Manual 2.0.
5 KNXnet/IP Router Parameterization WAGO-Software WAGO ETS Plug-in KNXnet/IP Router Parameterization The first KNX Module behind a KNX IP Controller (and possibly behind other non-KNX Modules) extends the function of the KNX IP Controller to a KNXnet/IP Router. Any subsequent KNX modules operate in device mode. The KNXnet/IP Router routes telegrams from IP to a twisted-pair cable and vice versa. The following section describes the steps for using the KNXnet/IP Router within the ETS. 5.
WAGO-Software WAGO ETS Plug-in 5.2 KNXnet/IP Router Parameterization 43 Operation The software has the basic task of setting up the KNXnet/IP Router and adapting its IP parameters to the network. 5.2.1 Device Settings You can view or set general data such as device name, project number or installation number in the “Device settings” area of the user interface.
KNXnet/IP Router Parameterization WAGO-Software WAGO ETS Plug-in Table 18: Settings for the KNXnet/IP Router Option [Bus IP] [IP Bus] Description Opens the “Bus IP” dialog for configuring the filtering and confirmation of telegrams from the bus to the IP medium (see Section “Bus IP settings”) Opens the “IP Bus” dialog for configuring the filtering and confirmation of telegrams from the IP medium to the bus (see Section “IP Bus Settings”) KNXnet/IP parameter Enable IP parameter checked:
WAGO-Software WAGO ETS Plug-in KNXnet/IP Router Parameterization 45 Incorrect entries will not be saved! Incorrect entries are not saved in the system! Watch for different project numbers! The project number in the “Extended Device Parameters” dialog is not identical to the project number assigned in the ETS. Bus power failure and return are reported via KNX! If a power failure is detected on the bus line, the error is output as a KNXnet/IP telegram. Power restoration is also indicated via KNXnet/IP.
KNXnet/IP Router Parameterization 5.2.2 WAGO-Software WAGO ETS Plug-in Bus IP Settings This dialog sets the parameters for the filtering and confirmation of telegrams sent from the bus to the IP medium. Figure 33: “Bus IP” dialog 5.2.2.1 Group Telegrams for the Main Groups 0 to 13 In this selection box, you set the filtering of telegrams for the main groups 0 to 13: • • • 5.2.2.2 route: lock: filter (normal): All telegrams are routed. No telegram is routed.
WAGO-Software WAGO ETS Plug-in • • 5.2.2.4 lock: filter (normal): KNXnet/IP Router Parameterization 47 No telegram is routed. Filtering is performed according to the filter table. Confirmation of Group-Oriented Telegrams This selection box sets how telegrams for group-oriented telegrams are confirmed: • • 5.2.3 all: All telegrams are confirmed. only when routed: All routed telegrams are confirmed.
KNXnet/IP Router Parameterization 5.2.3.2 WAGO-Software WAGO ETS Plug-in Group Telegrams for the Main Groups 14 and 15 In this selection box, you set the filtering of telegrams for the main groups 14 to 15: • • 5.2.3.3 lock: route: No telegram is routed. All telegrams are routed. Physically Addressed and Broadcast Telegrams In this selection box, you set the filtering of physically addressed and broadcast telegrams: • • • 5.2.4 route: lock: filter (normal): All telegrams are routed.
WAGO-Software WAGO ETS Plug-in 5.2.4.1 KNXnet/IP Router Parameterization 49 Manually Setting the KNXnet/IP Router The “Enable IP parameter settings” checkbox defines the behavior of the plug-in. If the checkbox is unchecked, manually setting the parameters is not possible and these settings are not transferred to the device during a download. If the checkbox is checked, the IP parameters can be set manually.
KNXnet/IP Router Parameterization WAGO-Software WAGO ETS Plug-in Additional information Additional information on the “Internet Assigned Numbers Authority” can be found at http://www.iana.org. An overview of multicast addresses can be found at http://www.iana.org/assignments/multicast-addresses. The following figure shows the successful configuration of a KNX Module that will operate as a KNXnet/IP Router: Figure 36: Fully configured KNXnet/IP Router 5.2.4.
WAGO-Software WAGO ETS Plug-in KNXnet/IP Router Parameterization 51 DHCP DHCP is a further development of BootP. Whereas BootP assigns IP addresses from an address table to the clients and cannot accept further clients when all addresses from the table have been assigned, DHCP offers the benefit of a three assignment techniques, including possible dynamic assignment. 5.2.4.3 DHCP Assignment Techniques • Static assignment This assignment corresponds to the assignment by BootP.
6 Uninstalling the ETS Plug-in WAGO-Software WAGO ETS Plug-in Uninstalling the ETS Plug-in Proceed as follows to remove the software from your system. For router and controller: 1. On your PC, open the Control Panel and click “Programs,” [Uninstall a program]. The entry “Wago-IEC61131Controller-IpRouter” is shown in the software list. 2. Right-click the required entry and choose [Uninstall] in the context menu. For modules: 1.
WAGO-Software WAGO ETS Plug-in List of Figures 53 List of Figures Figure 1: “New Connection” dialog ...................................................................... 12 Figure 2: Importing products ................................................................................. 15 Figure 3: Import products – Starting the import wizard ........................................ 15 Figure 4: Progress display .....................................................................................
List of Tables WAGO-Software WAGO ETS Plug-in List of Tables Table 1: Number notation........................................................................................ 8 Table 2: Font conventions ....................................................................................... 8 Table 3: Minimal system requirement................................................................... 10 Table 4: Syntax for simple variable ......................................................................
WAGO-Software WAGO ETS Plug-in Manual 2.0.
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: http://www.wago.