Remote access to the WAGO Ethernet controller/coupler using an ...

WLAN Access to theWAGO Ethernet ControllerUsing an iPod TouchApplication NoteLast Update: 30.03.11

2 • GeneralCopyright 2011 by WAGO Kontakttechnik GmbHAll rights reserved.WAGO Kontakttechnik GmbHHansastraße 27D-32423 MindenPhone: +49 (0) 571/8 87 – 0Fax: +49 (0) 571/8 87 – 1 69E-mail: info@wago.comWeb: http://www.wago.comTechnical SupportPhone: +49 (0) 571/8 87 – 7 77Fax: +49 (0) 571/8 87 – 87 77E-mail: tcba@wago.comEvery conceivable measure has been taken to ensure the accuracy and completenessof this documentation. However, as errors can never be fully excluded,we always appreciate any information or suggestions for improvingthe documentation.We wish to point out that the software and hardware names, as well as thetrademarks of companies used and/or mentioned in the present manual, aregenerally protected by trademark or patent law.Application Note

Contents • 3TABLE OF CONTENTS1 Important Notes ......................................................................................... 41.1 Legal Principles .....................................................................................41.1.1 Copyright ...............................................................................................41.1.2 Personnel Qualification..........................................................................41.1.3 Intended Use ..........................................................................................41.2 Scope of Validity ................................................................................... 51.3 Symbols .................................................................................................52 Description.................................................................................................. 63 Material....................................................................................................... 64 Set-Up..........................................................................................................75 Program Description ................................................................................. 85.1 CoDeSys Program..................................................................................85.2 Determining the MODBUS Addresses.................................................. 85.3 Visualization Interface.........................................................................106 iPod Configuration .................................................................................. 116.1 WLAN Settings....................................................................................116.2 ScadaMobile App ................................................................................ 126.3 Communication Settings...................................................................... 136.4 Processing the Configuration File .......................................................136.5 Operating Interface .............................................................................. 156.6 Access to Multiple Controllers ............................................................ 167 Appendix...................................................................................................177.1 Required Files for WAGO-I/O-PRO CAA..........................................17Application Note

4 • Important Notes1 Important Notes1.1 Legal Principles1.1.1 CopyrightTo ensure quick installation and start-up of the units, please carefully read andadhere to the following information and explanations.This document, including all figures and illustrations contained therein, is subjectto copyright protection. Any use of this document that infringes upon thecopyright provisions stipulated herein is prohibited. Reproduction, translation,electronic and phototechnical filing/archiving (e.g., photocopying) as well asany amendments require the written consent of WAGO KontakttechnikGmbH, Minden, Germany. Non-observance will involve the right to assertdamage claims.WAGO Kontakttechnik GmbH reserves the right to enact changes that servetechnical progress.WAGO Kontakttechnik GmbH owns all rights arising from the granting ofpatents or from the legal protection of utility patents. Third-party products arealways mentioned without any reference to patent rights. Thus, the existenceof such rights cannot be excluded.1.1.2 Personnel Qualification1.1.3 Intended UseThe use of the product detailed in this document is geared exclusively to specialistshaving qualifications in PLC programming, electrical specialists orpersons instructed by electrical specialists who are also familiar with the validstandards. WAGO Kontakttechnik GmbH assumes no liability resulting fromimproper action and damage to WAGO products and third-party products duethe disregard of the information contained in this document.For each individual application, the components are supplied from the factorywith a dedicated hardware and software configuration. Modifications are onlyadmitted within the framework of the possibilities documented in this document.WAGO Kontakttechnik GmbH will be exempted from any liability incase of changes in hardware or software as well as to non-compliant usage ofcomponents.Please send your requests for modified and new hardware or software configurationsdirectly to WAGO Kontakttechnik GmbH.Application Note

Important Notes • 51.2 Scope of ValidityThis application note is based on the stated hardware and software from thespecific manufacturer, as well as the associated documentation. This applicationnote is therefore only valid for the described installation.New hardware and software versions may need to be handled differently.Please note the detailed description in the specific manuals.1.3 SymbolsDANGERAlways observe this information to protect persons from injury.NOTICEAlways observe this information to prevent damage to the device.NOTEBoundary conditions that must always be observed to ensure smooth operation.NoteRoutines or advice for efficient use of a device and software optimization.Additional InformationReferences to additional literature, manuals, data sheets and INTERNETpages.Application Note

6 • Description2 DescriptionThis application note describes the basic procedures for access to the WAGOEthernet Controller 750-8xx or the WAGO Ethernet Coupler 750-3xx using aniPod Touch. An iPhone can also be used as an alternative.The connection is established using a WLAN access point. The protocol usedis MODBUS TCP.3 MaterialSupplier Qty. Designation Item No.WAGO 1 Programmable fieldbus controller 750-8xxWAGO 1 Digital input module 750-402WAGO 1 Digital output module 750-504WAGO 1 End terminal block 750-600- 1 iPod Touch- 1 WLAN access point- 1 Switch + Patch cableThe following software is also required for programming and commissioning:WAGO WAGO-I/O-PRO CAA 759-333SweetWilliam ScadaMobile or ScadaMobile LiteAdditional Information:The libraries and documentation used are available at www.wago.com/Service/Downloads/LibrariesAdditional Information:Information about the different versions, manuals, and the required CSV filetemplates is available at http://www.sweetwilliamautomation.com/Application Note

Set-Up • 74 Set-UpIllus. 4.1: Network set-upThe controllers are connected to a WLAN access point. The network settingsmust be adapted from the access point to the controller's IP addresses (seeillus. 4.1).Note:The set-up described is only one example. The set-up can be expanded asrequired by the respective application.Application Note

8 • Program Description5 Program Description5.1 CoDeSys ProgramIllustration 5.1 shows the set-up of an example program in the CoDeSys software.Illus. 5.1: CoDeSys programThe declared variables are distinguished according to bit and register accessand are referenced at the corresponding flag addresses. These flags can thenbe read and described using corresponding MODBUS addresses.5.2 Determining the MODBUS AddressesThe MODBUS addresses for bit and register access, which are a function ofcommunication direction, are listed in the following tables.NoteThe included tables show only an excerpt of the MODBUS communicationaddresses. The complete tables are available in the manuals for the controllerand coupler in the chapter “MODBUS Access Mapping”.Application Note

Pos: 116.22/All series (general modules)/Fieldbus communication/MODBUS/MODBUS register mapping - bit read access (using FC1, FC2) (Controller, x41) @ 3\mod_1235394387921_6.doc @ 27586 @Pos: 116.21/All series (general modules) Fieldbus communication/MODBUS/MODBUS register mapping - section Coil services, bit access @ 3\mod_125393917265_6.doc @ 27582 @@Pos: 116.22/All series (general modules)/Fieldbus communication/MODBUS/MODBUS register mapping - bit read access (using FC1, FC2) (Controller, x41) @ 3\mod_1235394387921_6.doc @ 27586 @Program Description • 9Bit Read AccessMODBUS address Memory areaDescription[dez] [hex]0...511 0x0000...0x01FF Physical input area (1) First 512 digital inputs512...1023 0x0200...0x03FF Physical output area (1) First 512 digital outputs4096...8191 0x1000...0x1FFF %QX256.0...%QX511.15 PFC-OUT-AreaVolatile PLC output variables12288...32767 0x3000...0x7FFF %MX0...%MX1279.15 Flag areaPos: 116.23/All series (general modules)/Fieldbus communication/MODBUS/MODBUS register mapping - bit write access (using FC5, FC15) (Controller, x41) @ 3\mod_1235398841703_6.doc @ 27594 @Bit Write AccessMODBUS address Memory areaDescription[dez] [hex]512...1023 0x0200...0x03FF Physical output area (1) First 512 digital outputs8192...12287 0x2000...0x2FFF %IX256.0...%IX511.15 PFC-IN-AreaVolatile PLC input variables12288...32767 0x3000...0x7FFF %MX0...%MX1279.15 Flag areaRegister Read AccessMODBUS address IEC-61131-Memory area[dez] [hex] address0...255 0x0000...0x00FF %IW0...%IW255 Physical input area (1)256...511 0x0100...0x01FF %QW256...%QW511 PFC-OUT-AreaVolatile PLC output variables512...767 0x0200...0x02FF %QW0...%QW255 Physical output area (1)12288...24575 0x3000...0x5FFF %MW0...%MW12287 Flag areaPos: 116.20 / All series (general modules)/Fieldbus communication /MODBUS register mapping - register access (using FC6, FC16, FC22, FC23) (Controller, x41) @ 3\mod_1235392386281_6.doc @ 27579 @Register Write AccessPos: 116.21/All series (general modules) Fieldbus communication/MODBUS/MODBUS register mapping - section Coil services, bit access @ 3\mod_125393917265_6.doc @ 27582 @@MODBUS address IEC-61131-Memory area[dez] [hex] address512...767 0x0200...0x02FF %QW0...%QW255 Physical output area (1)768...1023 0x0300...0x03FF %IW256...%IW511 PFC-IN-AreaVolatile PLC input variables12288...24575 0x3000...0x5FFF %MW0...%MW12287 Flag areaApplication Note

10 • Program Description5.3 Visualization InterfaceThe declared variables are changed or displayed using elements in the visualizationinterface (see illus. 5.2).Illus. 5.2: Visualization with examplesNote:WAGO-I/O-PRO CAA visualization requires that the PC is connected to theWAGO fieldbus controller. Depending on the fieldbus controller used, twooptions are available.The first option is available for all types of fieldbus controllers. Here, connectionto the fieldbus controller's service interface is established via 750-923Communication Cable. With ETHERNET fieldbus controllers, connection isalso possible using the ETHERNET interface.Application Note

iPod Configuration • 116 iPod Configuration6.1 WLAN SettingsThe first step is to establish WLAN (WiFi) communication. In order to accomplishthis, the WLAN access point must be established and activated in theiPod settings (see illus. 6.1).Illus. 6.1: WiFi network settingsApplication Note

12 • iPod ConfigurationThe iPod's Safari browser can be used for a first communication test. Enter thecontroller's IP address in Safari's address bar (see illus. 6.2). For example:“192.168.1.81”.Illus. 6.2: Safari web browserIf the WLAN communication functions between the iPod and the WAGO controller,the WAGO WebBasedManagement for the corresponding ETHERNETcontroller will be displayed on the iPod.NoteThe browser does not support JAVA, therefore, web pages created withCoDeSys cannot be displayed!6.2 ScadaMobile AppIn the next step, the application (app) “ScadaMobile” must be loaded on theiPod.As an alternative, “ScadaMobile Lite” can also be used. This is a ‘lite’ versionwhich can communicate up to 4 data points.In the example, “ScadaMobile” version 1.5.1 was used. The manual is availableat the following homepage:http://www.sweetwilliamautomation.comApplication Note

iPod Configuration • 136.3 Communication SettingsIn the “ScadaMobile” app, a few basic communication settings have to be setin the “Settings” tab. All of the following steps can be also be found in the“ScadaMobile User Manual”.Illus. 6.3: Communication settings in ScadaMobileIllustration 6.3 shows the typical settings for MODBUS communication. TheWAGO controller's IP address can be entered under “Default Connection”,which should be considered a standard setting. In addition, the following settingsare required: Local Port: 502 Remote Port: 502 Address: e.g.: 192.168.1.816.4 Processing the Configuration FileThe file server is launched using the “File Server” tab, and enables the exchangeof data between the PC and the iPod. After starting, the server addressis displayed (see illus. 6.4). This address is entered in Internet Explorer anddisplays the CSV configuration files saved on the iPod. If no files are displayed,the templates can be loaded using “Load Examples”. Then select thefile“DataTypesModbusES.csv” and save it to the PC.Application Note

14 • iPod ConfigurationIllus. 6.4: Turning on the file server on the iPodThe saved template can now be opened and processed using Excel. The entriesshould be adapted to the example program shown in chapter 6. The columnshave the following meaning:Column A: Variable name, as it should be displayed in the iPodColumn B: Data type of the CoDeSys variablesColumn C: MODBUS range and MODBUS addressColumn D: Additional parameters (appearance, headers, and commentary)When entering the MODBUS address in column C, you must pay attention tothe fact that in general, an offset of 1 must be added to the addresses documentedin the WAGO manual. If 32bit variables are entered (e.g. DINT orREAL), the attribute “word_swap:=true;” must be entered one time in columnD (see illus. 6.5). After all changes have been made, the file should be savedusing a different name.Illus. 6.5: Example of a configuration file (WAGO_iPod_Example_1.csv)NoteMore complete documentation and further details about the entry possibilitiesare available in the “ScadaMobile Manual”.Application Note

iPod Configuration • 15In the file server, select and upload the processed file using “File Upload”.This file will then have to be actively switched on in ScadaMobile (see illus.6.6).Illus. 6.6: Selected file6.5 Operating InterfaceThe display is turned on using the “Connections” tab. The green LED light indicatesan error-free MODBUS connection. The variables specified in theCSV file are displayed in the “Home” tab. The variables can be modified withwrite access (see illus. 6.7).Illus. 6.7: Operating interfaceApplication Note

16 • iPod Configuration6.6 Access to Multiple ControllersMultiple WAGO controllers can be accessed using ScadaMobile. A separateCSV file must be generated for each controller. In each file, the attribute “local_ip:=x.x.x.x”must be present once in column D (see illus. 6.8). Files thatdo not contain this attribute will be assigned to the controller using the IP addressfrom the standard settings.“Illus. 6.8: Configuration file with IP address (Wago_iPod_Example_2.csv)The second CSV file is also uploaded to the file server and activated in the“Files” tab with a check. The “Tags” from all active files are displayed under“Home” (see illus. 6.9). The order of the tags within the sections can bechanged using the “ord” attribute in the CSV file.Illus. 6.9: Operating interface for two CSV filesApplication Note

Appendix • 177 Appendix7.1 Required Files for WAGO-I/O-PRO CAANo special libraries are required for these applications.LibraryDescription- -Application Note

WAGO Kontakttechnik GmbHPO Box 2880 • D-32385 MindenHansastraße 27 • D-32423 MindenPhone: +49 (0) 571/8 87 – 0Fax: +49 (0) 571/8 87 – 1 69E-mail: info@wago.comOnline: