eWON Family 500, 2001, 4001, 2101, 4101, 4002, 4102, 2104, 4104, 2005, 2005CD, 4005, 4005CD General Reference Guide ver 1.5 COOL INTERNET TELECONTROL SOLUTION RG-001-0-EN-(General Reference Guide) ver 1.
Table of content 1 Introduction .........................................................................................................................5 2 The eWON login page ........................................................................................................6 2.1 Access from a Computer Browser ..................................................................................6 2.2 Access from a PDA Browser ...............................................................................
Table of content 5.4.3 Tag name convention ................................................................................................94 5.5 UNITE IO Server ..........................................................................................................96 5.5.1 Introduction ...............................................................................................................96 5.5.2 Setup................................................................................................
Table of content 5.16.1 Introduction ...........................................................................................................144 5.16.2 Setup .....................................................................................................................144 5.16.3 Tag name convention ............................................................................................145 6 eWON Monitoring Web Interface ..........................................................................
Table of content 8.3.8 $dtSE [Script Expression] .......................................................................................180 8.3.9 $dtUF [User File] ....................................................................................................181 8.3.10 $dtIV [Instant Values]...........................................................................................183 8.3.11 $dtSV...........................................................................................................
General Reference Guide 1 Introduction Introduction The aim of this guide is to provide you exhaustive information about the multiple eWON firmware features. Considering the gains in terms of optimization and performances that firmware version 5 brings, we recommend you to migrate from version 4 to version 5 if not already done.
General Reference Guide 2 2.1 Introduction The eWON login page Access from a Computer Browser When you connect to the eWON with Internet Explorer, you will be invited to log you on. Figure 1: eWON login page The factory predefined parameters to login on the eWON are: IP address 10.0.0.53 Login adm Password adm Table 1: eWON default login parameters IMPORTANT! Password IS case sensitive but user name is not.
General Reference Guide 3 eWON Configuration eWON Configuration Interface Just after you have logged in successfully, the eWON Web Interface will be displayed (as explained in the next chapter). Figure 3: eWON interface page But before analyzing the Monitoring Web Interfaces page, you need to configure your eWON. Click on the Configuration menu item. The following Configuration web page then appears: Figure 4: eWON configuration links 3.
General Reference Guide 3.2 eWON Configuration Users Setup The Users Setup page allows building the list of authorized eWON users. Figure 5: eWON Users Setup page The user’s page lists all the eWON users and attributes. The first time that you connect to the eWON, the default user is Adm. It is recommended to modify the default password of the Administrator user. 3.2.1 To edit a user Click on the user's name link in the User Login column. 3.2.
General Reference Guide 3.2.3 eWON Configuration Logon parameters First Name and Last Name are detailed (and optional) information about the user, while User Login and Password are mandatory (they are used during the logon procedure).
General Reference Guide 3.2.5 eWON Configuration User’s directory restriction When the user web site is built, HTML (or SHTM) pages can be placed in subdirectories. The root directory of the user defined web site is /usr (from the FTP directory structure). Every user has access to that directory. /usr is considered as DEFAULT directory for the web site.
General Reference Guide 3.2.6 eWON Configuration Tag pages restriction There are 10 user defined pages (please refer to chapter “Pages configuration” on page 79) and one default page.
General Reference Guide 3.3 eWON Configuration System Setup The system setup page (accessed by clicking on the System Setup item from the configuration menu) allows to set all the eWON system parameters and looks as follows: Figure 9: eWON system configuration page This section has a high impact on the eWON behavior (mainly from a communication point of view). You should fill it in carefully.
General Reference Guide 3.3.1.1 eWON Configuration eWON identification Figure 10: eWON system general setup – eWON identification Control Description eWON Identification The name of the eWON. This information is added in each eWON e-mail alarm notification. Check that this identification and the next one allow you to identify your eWON without any doubt. General Information As for the eWON identification, you can put a free text.
General Reference Guide 3.3.1.2 eWON Configuration Alarms (globals parameters) Figure 11: eWON system general setup – Alarms Control Description Action retrig interval If an alarm is still present after this interval, then a new action on alarm will be triggered once (only if the alarm condition is still true AND if the alarm has not been acknowledged yet). The default value for this parameter is one day (86400 seconds).
General Reference Guide 3.3.1.4 eWON Configuration Reboot Rebooting eWON is sometimes necessary (i.e. to validate some configuration changes). Figure 13: eWON system Reboot eWON version 5 offers three ways to perform a reboot: • From the Reboot menu from General configuration page • By using the "REBOOT" Basic command (see eWON programming Manual).
General Reference Guide 3.3.2 eWON Configuration Net services setup Regarding its Internet connectivity features, the eWON has basically two modes of operation: • A server mode (Web server and FTP server) • A client mode (Email client, FTP client and NTP client) In the server mode, the eWON is waiting for a client to connect with its Web browser or with its FTP client. In the client mode, the eWON needs to connect to a server.
General Reference Guide eWON Configuration Another feature of the TELNET RFC2217 mode is its ability to change the modem line status. This means that the RTS/CTS, DTR, DCD (etc.) levels of the eWON’s physical port are reflected to the PC virtual port and vice-versa. This protocol is called TELNET RFC 2217 because it has been standardized and described in an RFC specification. It means that any client supporting the RFC2217 protocol can use the eWON as a virtual port server. 3.3.2.1.
General Reference Guide 3.3.2.3.2 eWON Configuration Web configuration You get access to the COM1 (or COM2) VIRTUAL PORT CONFIGURATION page by following this path from the Main Menu navigation bar: Configuration/System Setup/General/Net services/Virtual Com : Figure 15: eWON Virtual COM port configuration page You may first choose the COM port you want to configure in the COM Port: scrolling menu.
General Reference Guide eWON Configuration When using modem port for VCOM, the following must be considered: • Modem serial port is normally owned by PPP: • If an SMS transfer is in progress and a VCOM client tries to connect, the VCOM connection will fail. • If a VCOM client is connected, and an SMS must be sent, the SMS sending will fail. • When an SMS transfer or a VCOM connection ends, the PPP is again the owner of the modem serial port. 3.3.2.
General Reference Guide Control Enable NTP clock update NTP server address NTP Server Port GMT Offset Update Time Interval eWON Configuration Description To update the eWON date & time the eWON is able to make a connection automatically on a NTP (Network Time Protocol) timeserver. If you want to use that functionality, check the box and fill the next edit boxes in. The IP address of the NTP (Network Time Server Protocol) server. You can easily find a list of NTP servers by using any Web search engine.
General Reference Guide 3.3.2.7 eWON Configuration SNMP Setup Figure 19: eWON SNMP setup main menu page 3.3.2.8 Communities The communities are defined here. These are acting like a "login-password" feature. Please refer to the SNMP standard for detailed explanations. Up to five different communities can be set up in the eWON. Each community has different read and write attributes. In the eWON, each of them can be specified for read and/or write rights.
General Reference Guide eWON Configuration The parameters for Alarm traps are as follows: Param 0 Tag name (Text [0..63]) Param 1 Alarm message (Text [0..255]) Param 2 Value of the Tag in alarm (Integer 32bits) Param 3 Alarm status (Integer) Param 4 Alarm Type (Integer) Table 13: Alarm traps parameters RG-001-0-EN ver 1.
General Reference Guide 3.3.3 Diagnosis 3.3.3.1 Overview eWON Configuration This part of eWON configuration allows you to fine-tune the way you monitor the eWON, concerning the events, that gives the user the ability to diagnose quickly and efficiently any trouble that could happen. The second choice in the Diagnostic menu is PPP Dump, which allows you to log the history of any PPP communication to and from eWON. Since Firmware 5.
General Reference Guide Control Initialisation Configuration eWON Configuration Description Allows you to define the level of monitoring about the events concerning the eWON boot. Allows you to define the level of monitoring about the events concerning the eWON configuration. IO Server Allows you to define the level of monitoring about the events concerning the IO Servers that eWON manages.
General Reference Guide Control eWON Configuration Description Log Incoming call Logs communications when the eWON is acting as a PPP server Log Outgoing call Logs communication when the eWON is acting as PPP Client (connects to a server) Number of bytes allocated for logging PPP communications.
General Reference Guide 3.3.4 eWON Configuration COM Setup section Warning: depending on eWON's version (c.f. Table 187 on page 203) The second link of the System setup is the communication setup. All Ethernet, modem and PPP TCP/IP connectivity parameters are defined here. The tree menu is divided into 4 sub-menus, which classifies the COM setup into functional systems: Interfaces, Network connections, Networking Config and Manage Config.
General Reference Guide 3.3.4.1.1 eWON Configuration Modem setup page Warning: depending on the eWON's version (c.f. Table 187 on page 203) 3.3.4.1.1.1 Modem configuration (PSTN modem) This tab contains the Modem setup of the eWON and stands in a distinct page from Dialup Setup since version 4.
General Reference Guide 3.3.4.1.1.2 eWON Configuration Modem configuration (GSM/GPRS modem) If eWON embeds a GSM/GPRS modems, then the modem page will have a very different look: Figure 24: Modem settings for eWON with GSM/GPRS modem Control Description Modem Status Textual description of the eWON internal modem detected, if available. Modem Detected The text that displays is always "Internal", followed by the modem type or speed (i.e. "Internal MUTLIBAND GSM" in the screenshot above).
General Reference Guide eWON Configuration note: Unused parameters are hidden. You must check the Enabled checkbox to expand the parameters Figure 25: Modem settings for eWON with GSM/GPRS modem (all parameters) GPRS Settings In order to generate a GPRS outgoing communication, the user must choose "GPRS" in the Connection type field from the Outgoing Calls config part from the Dial Up Configuration page, see chapter “Primary & secondary servers” on page 40.
General Reference Guide eWON Configuration Quality Of Service Profile (Requested) Check with your network operator before changing any of the QoS (Quality of Service) settings. The settings Precedence, Delay, Peak rate, Reliability and Mean Rate are all set by default to "Subscribed", which means that your operators default QoS (Quality of Service) values will be applied.
General Reference Guide 3.3.4.1.1.4 eWON Configuration PSTN: Leased line configuration PSTN modem types MT5634SMI-xx have the ability to work in Leased Line mode. In this mode, you are able to connect by phone two eWONs with simple wires. The two eWONs must have a MT5634SMI-xx modem. One side acts as the client and you must insert the LLCLT command in the init string. The other side acts as the server and you must enter the LLSRV command in the init string.
General Reference Guide 3.3.4.1.1.5 eWON Configuration ADSL interface The eWON ADSL modem supports the ADSL2+ standard. The configuration is very simple and provides compatibility with PPPOE and PPPOA with VCMux and LLCMux implementations. When the ADSL modem is connected, the eWON will have a WAN interface connected to the Internet, it will be able to act as a gateway on the Internet and will be accessible from Internet on any port.
General Reference Guide 3.3.4.1.2 eWON Configuration Ethernet LAN & WAN From the hardware point of view, there is nothing to configure on the Ethernet interfaces. You find here the MAC address of the Ethernet Interface. Figure 28: Ethernet Interface info page 3.3.4.2 Network connections The “Network connections group” handle all the software parameters of yours connections.
General Reference Guide 3.3.4.2.1 eWON Configuration Ethernet LAN (& WAN) 3.3.4.2.1.1 General This tab contains the Ethernet setup of the eWON. Figure 29: Network connections: Ethernet setup An ethernet interface needs the following parameters: Control Description Address Setup Ethernet IP address eWON Ethernet IP mask Ethernet IP gateway IP address of the eWON on the LAN (or WAN) side. Use this IP address to connect to the eWON using a LAN (or WAN) connection.
General Reference Guide eWON Configuration Each mechanisms provides you all or some of the IP parameters. IP parameters Static BootP DHCP IP Address X X X IP Mask X X X Default Gateway X (*) X DNS (primary and secondary) X (*) X (optional) Network Name not applicable not applicable X Table 25: IP parameters provided by IP configuration mechanisms (*) (optional) this parameter must be configured statically.
General Reference Guide eWON Configuration On eWONs with two ethernet interfaces (eWON2005 or 4005), the WAN configuration page will be one of the followings: Static BootP DHCP Table 28: Two ethernets : WAN configuration pages IMPORTANT: Since firmware 5.4, on eWON with 2 ethernet interfaces, the WAN ethernet interface is disconnected by default. See "WAN/LAN/PPP interface management" on page 47 3.3.4.2.1.2 BootP : TCP/IP Bootstrap Protocol You can force eWON to ask its IP address to a BootP Server.
General Reference Guide 3.3.4.2.2 eWON Configuration Modem Incoming & Outgoing Warning: Depending on the eWON's version (c.f. Table 187 on page 203) This group contains the PPP(Point to Point) setup of the eWON that sets up the PPP settings for the server and client functions of the eWON engine. 3.3.4.2.2.1 Incoming Figure 30: Modem Incoming setup page Control Description eWON PPP server IP address PPP server Internet protocol (IP) address of the eWON.
General Reference Guide 3.3.4.2.2.2 eWON Configuration Outgoing Global parameters Figure 31: Modem Outgoing Global setup page Control Description Dial and connection timeout Time allowed for the whole establishment of the PPP link to be up. This means modem call, modem negotiation, PPP negotiation and logon. This time includes all trials on each server. This is thus a global time. Enable compression Enable the compression negotiation request when an outgoing call occurs.
General Reference Guide Reset modem after eWON Configuration Consider this parameter like a Watchdog parameter. To avoid eWON to stay stucked due to any modem reason, you can use this parameter to force a reset of the modem after xxx outgoing calls failure. Only available on eWON with GPRS modem. Minimum GPRS connection duration Time in seconds: if the GPRS dial-out connection is shorter than this time, the connection is considered as ERROR. If set to “-1”, this time is not tested (default value = 4).
General Reference Guide eWON Configuration Primary & secondary servers The following parameters are the same for both servers. Two different servers can be set up. This ensures that the eWON can find a way out for PPP link if a server is down. At the startup of a connection, the primary server is always dialed first. If the connection cannot be established, the eWON tries the second server. If it fails, then it toggles back to the primary server. This is done until the dial-out timeout is reached.
General Reference Guide 3.3.4.2.3 eWON Configuration ADSL Figure 33: ADSL global connection parameters Control Description Connection timeout The maximum time the eWON will wait for the ADSL WAN to be established. After this time, the connection will fail. If Maintain Connecion is selected, then the eWON will retry continuously. Table 32: ADSL global connection configuration control RG-001-0-EN ver 1.
General Reference Guide 3.3.4.2.4 eWON Configuration VPN Figure 34: VPN Global setup page Control Diagnosis level Description Choose the level of diagnosis reported in the “Real Time Log” on page 161. Level could: None, Low, Medium or High The TCP Port number where eWON will listen all incoming VPN traffic. port <> 0 Port In Only this port could be use for incoming VPN traffic.
General Reference Guide eWON Configuration The eWON can be set to “listen” to incoming connections, you may connect directly your computer (or another eWON) to an eWON and establish a secured VPN channel. Figure 35: VPN Incoming setup page Control Passphrase VPN IP addresses config Local VPN IP address Remote VPN IP address 3.3.4.2.4.1 Description Enter the passphrase that will be used as certification for the incoming connection.
General Reference Guide eWON Configuration VPN between two eWONs Figure 36: VPN Outgoing setup page (connect to other eWON) Control Description Connect to...OTHER eWONs Primary Server Secondary Server Passphrase VPN IP addresses config Local VPN IP address Remote VPN IP address RG-001-0-EN ver 1.5 The address or Name of the primary VPN Server The address or Name of the secondary VPN Server (called if primary failed) Enter the passphrase that will be used as certification for the outgoing connection.
General Reference Guide eWON Configuration VPN with a Server Figure 37: VPN Outgoing setup page (connect to VPN Server) Control Description Connect to...VPN Server Primary Server Secondary Server Private key eWON Certificate CA (Certificate Authority) CERTIFICATE RG-001-0-EN ver 1.
General Reference Guide eWON Configuration VPN with an ENDIAN Server You can find information about the ENDIAN Server on www.endian.com Figure 38: VPN Outgoing setup page (connect to ENDIAN VPN Server) Control Description Connect to...
General Reference Guide 3.3.4.2.5 eWON Configuration WAN/LAN/PPP interface management Thanks to its 2 ethernet interfaces (2005/4005), since firmware 5, the eWON makes a strong distinction between the WAN interface and the LAN interface. 3.3.4.2.5.1 LAN (Local Area Network) In the eWON, the LAN is the ethernet interface connected to a local network. It is simply an ethernet interface with no specific properties. 3.3.4.2.5.
General Reference Guide Ethernet WAN Connection - Disconnection sequence eWON Configuration (since firmware 5.
General Reference Guide 3.3.4.2.6 eWON Configuration Ethernet Gateway behavior On the eWON, it is possible to define a default gateway on the ethernet interface. First we must consider 2 cases. • The eWON has 2 ethernet interfaces (2005/4005/2005CD/4005CD/2104/4104) In this case, the gateway is active only while the WAN interface is connected. The eWON-ADSL must be considered as an eWON with 2 Ethernet interfaces. The ADSL interface is a WAN interface. • The eWON has only 1 ethernet interface. 3.3.4.2.6.
General Reference Guide 3.3.4.3 eWON Configuration Networking Config The Networking Config section sets all the network behaviors of your eWON. These behaviors are: • How to connect to the Internet • What is the VPN behavior • Do I publish the IP address, do I use No-IP • Callback • Routing rules • Proxy features • Security features • IP ports configuration 3.3.4.3.
General Reference Guide eWON Configuration “On demand” Internet connection Dial On Demand It is possible to establish remote connections towards the ISP by using the Dial On Demand feature. If selected, the eWON will try to connect to the ISP each time a connection will be required (i.e. packets to send). Those fields allow you EITHER to exclude OR to select IP addresses ranges that are allowed or refused for Dial On Demand. Four different IP addresses ranges can be defined.
General Reference Guide 3.3.4.3.3 eWON Configuration Publish IP address When the eWON goes to the Internet (automatically or by CallBack) , it can receive a different IP address at each connection. It needs to inform you of its new WAN address thanks to this publish IP function. Figure 41: Publish IP address configuration page Control Description Publish by EMail EMail destination address This field allows you to define the destination address by default that will receive the notification.
General Reference Guide 3.3.4.3.4 eWON Configuration Callback Warning: depending on your eWON's version (c.f. Table 187 on page 203) This menu contains the configuration controls that the eWON will use to perform callback operations. Figure 42: Callback configuration Control Description General Callback Config Callback enabled If this box is checked, then the eWON callback feature is enabled.
General Reference Guide eWON Configuration Figure 43: Callback on user’s request at logon Note: When connecting to an eWON with Callback on user's request, you will get the above webpage. You will start the callback by using the Callback button or abort (hang up the phone line) by using the "Close PPP Connection" button.
General Reference Guide 3.3.4.3.5 eWON Configuration Routing Warning: Depending on your eWON's version (c.f. Table 187 on page 203) This page contains the router configuration of the eWON, the PPP settings for the server and client functions of the eWON engine, in order to define the way that you will use your eWON to access remote devices, and access them through the eWON as if they were on your local site.
General Reference Guide eWON Configuration Figure 46: Routing setup page (on eWON without VPN : 2001, 4001, 4002) The IP Forwarding configuration check box enables the forwarding between both interfaces (LAN and PPP). On VPN eWONs, this check box does not appear because IP Forwarding is always active. Term Definition This means that a link can be performed between PPP and Ethernet IP packets. Please note that this is dangerous because it can connect your LAN directly to the Internet.
General Reference Guide eWON Configuration Figure 47: eWON PPP Router logon screen 3.3.4.3.5.1 Static routes Before the firmware 5.2, it was only possible to configure a default gateway to reach a given destination node when not located on the eWON's physical network. This feature adds the ability to configure 3 additional entries in eWON's routing tables (static routes).
General Reference Guide 3.3.4.3.6 3.3.4.3.6.1 eWON Configuration Proxy Why a proxy feature? Since firmware 5.2, the eWON has a built-in ProxyServer. The Proxy feature is similar to the transparent forwarding, with some advantages and some drawbacks. To be precise, it is not exactly equivalent to the transparent forwarding that forwards all the ports (except the 81), but more like a “port forwarding” feature that would forward some ports.
General Reference Guide eWON Configuration All these parameters are in the comcfg.txt file. Control Description (param name in comcfg.txt file) Proxy Configuration Enabled (ProxyEnabled) Idle connection timeout (ProxyIdleTO) Maximum connections per proxy enrty (ProxyMaxSock) Proxy External Interface (EXT) (ProxyExtItf) Enables or disables the proxy feature. The proxy operation can be switched on or off at any time during the eWON operation without reboot.
General Reference Guide 3.3.4.3.7 eWON Configuration Security You can define the Networking security level you need. You can set 3 levels of security.
General Reference Guide Control eWON Configuration Description HTTP Web Server Primary HTTP port Allows you to redefine the eWON's Primary TCP Port (whose default value is set to 80). Secondary HTTP port Allows you to redefine eWON's Secondary TCP Port (whose default value is set to 81). This port is never forwarded when Transparent Forwarding is enabled. This port is used to reach the eWON default Website ( http://10.0.0.
General Reference Guide 3.3.4.4.2 eWON Configuration Default Config Using this menu, the user can return to the default communication configuration of the eWON. This will NOT modify anything in the other configurations of the eWON. The IP address will not be modified. This option requires a forced reboot of the eWON (software or hardware). Also remember that the communication setup is NOT affected by a format of the eWON. Figure 53: Reset to default COM config 3.3.4.
General Reference Guide 3.3.4.5.1 eWON Configuration Memory config There are three (or five depending on the Flash size) different ways to configure the storage from the different files from eWON, depending on the way you are going to use it (refer to the configuration table below the following screenshot). Figure 54: Storage Memory config page (16MB) /usr (MB) Rec. (MB) 6 1 You want to store a lot of user files on your eWON, but you won't create a lot of Tags.
General Reference Guide Flash Memory zone eWON Configuration Size Description Historical data 1 to 3 MB Used for storing historical data. This file system is located in its own partition. This partition contains 3 files that contain circular data: • Incremental recordings • Events logging • Alarm history logging Each of those files receives a predefined maximum amount of space. When this amount of space is reached, then the older data are erased, in order to free space for the new data.
General Reference Guide 3.3.4.5.2 eWON Configuration Erase & Format Figure 57: Erase & Format panel This control panel function is to allow you to erase some parts of the eWON storage area. Control Description Format All partitions Format All partitions Validating this checkbox will result in formatting /usr and /sys partitions. Format /sys partition Validating this checkbox will result in formatting /sys partition.
General Reference Guide eWON Configuration Clear scheduled action Validating this checkbox will result in erasing from the sstat.htm file the eWON actions that are not currently in progress, that means all the actions that are completed (whatever successful or not). Clear pending actions Note: as sstat.htm is a "virtual" file, which means that its information are stored in the volatile memory from eWON, clearing this file does not impact the memory file system from eWON.
General Reference Guide 3.4 3.4.1 eWON Configuration Tag Setup Tag definition: Introduction The eWON Monitoring Web Interface features are based on: • The configurable monitoring of Tags • The execution of scripts All the variables monitored by the eWON are defined as "Tags". A Tag is a Boolean or Float value changing with time and coming from a datasource. Typical data-sources are: • eWON internal Inputs/Outputs • Remote Inputs/Outputs (modbus, UnitelWay, ...
General Reference Guide 3.4.1.2 eWON Configuration Tags validation For optimisation purpose and since firmware version 5.2, the eWON can detect if tags are valid or not, and disables the polling of invalid tags. By default, this feature is not activated, See "Global Config" on page 86 to enable it. At the creation of the Tags or at the initialisation of an IOServer, all tags are considered as valid and are polled.
General Reference Guide eWON Configuration Important: If a Tag is created in a different page than the page being displayed, it will not appear in the list, although it is present. Figure 61: eWON Tag Setup page • To EDIT a Tag Click on the link in the Tag name column. • To EDIT a Tag ALARM ACTION Click on the icon next to name of the Tag link. • To DELETE a Tag Click on the check box near the Tag name and then click on the Delete Selected Tag link. • To ADD a Tag Click on the Create New Tag link.
General Reference Guide 3.4.2.1 eWON Configuration Tag main edit window You will have access to the Tag main setup page by clicking on the Create New Tag link, or by editing an existing Tag when clicking on its name (the content of this page differs accordingly to your eWON’s version: Historical Data Logging and Real Time Logging is not available on all the eWONs): see Table 187 on page 203 Figure 62: eWON Tag main configuration page - eWONs that does not allow logging feature RG-001-0-EN ver 1.
General Reference Guide eWON Configuration Figure 63: eWON Tag Main Configuration page - eWONs that allow logging feature RG-001-0-EN ver 1.
General Reference Guide Control eWON Configuration Description Tag general properties Tag name Tag Description Name of the Tag The name of the Tag will be used for any reference to the Tag when using the export function or the script function. -This Information will be included in the alarm email Note: the Tag’s name cannot contain: spaces $ character " characters Maximum length for a Tag’s name is 64 characters A free text to describe the meaning of the Tag. Useful to clarify the meaning of an alarm.
General Reference Guide eWON Configuration Tag Visibility Published value Modbus TCP visibility Each Tag in the eWON can be accessed by a modbus TCP master. If the Tag must be visible: Enable this checkbox. Address of the register, starting with 1.
General Reference Guide eWON Configuration • Historical and real-time logging: Those fields display only for some eWON's versions (c.f. “Tags monitoring and handling” on page 68) Historical and real-time logging Historical logging enabled Logging dead band Logging Interval Real time enabled Time span Logging Interval If checked, the Tag values will be logged in a circular file. Warning: This is a non-volatile logging; data are stored in the flash file system.
General Reference Guide 3.4.2.2 eWON Configuration Tag "Alarm Action" edit window Alarm action can be one of the following: • Send an Email • Send an SMS • Send a file to an FTP server • Send an SNMP Trap The Alarm action window is accessed with the icon next to the Tag’s link.
General Reference Guide 3.4.2.2.1 eWON Configuration Email on alarm configuration The required configuration if an email must be sent in case of alarm. If an email must be sent through PPP, the system configuration (Main and COM) must also be set up. Alarm action Properties Email upon Short Message Description Checks the alarm states triggering an email (ALM, ACK, RTN, END). In some cases it is useful to have the whole message sent in the subject. For example if you need to route email to SMS.
General Reference Guide 3.4.2.2.2.1 eWON Configuration SMS_RECIPIENT: syntax The SMS_DESTINATION defines the phone number of the SMS recipient. In order to reach an SMS recipient, an SMS server must be called and the correct protocol must be used with that server. The server phone number depends on the GSM operator and the protocol used will be one of the 2 standard UCP or TAP protocol. A table with the SMS protocols and server phone numbers is available on http://www.ewon.biz/DocSMS.htm.
General Reference Guide eWON Configuration Examples: SMS on alarm "SMS Destination" syntax Explanations 0407886633,ucp,0475161622,proximus ucp protocol requires the use of a password. In this case, the password is "proximus" See in the above table for the word datasize and parity specification tap protocol does not require to enter a password.
General Reference Guide 3.4.2.2.3.1 eWON Configuration File content: If a standard text is put in the File Content field, the file built will receive that static text as content. If the File content has the following form, one or more file(s) will be written with a dynamic content: [EXPORT_BLOC_DESCRIPTOR_1] [EBD_2]… The number of EXPORT_BLOC_DESCRIPTOR is not limited. The EXPORT_BLOC_DESCRIPTOR syntax is described in chapter “Export Block Descriptor” on page 167.
General Reference Guide 3.7 eWON Configuration Script Setup The Script setup page that you can reach by clicking on the Script Setup link from the configuration navigation bar is used to create, modify or erase the scripts in the eWON and to test them. Basic is the language that is used to write these scripts. Further information about the structure and the syntax of this language is given in “eWON Programming Manual”.
General Reference Guide eWON Configuration • To edit a script section Select the script that you want to display the code of from the Script Sections list, and then click on the Edit button, in order to display it in the edition window: Figure 67: eWON Edit script section page Click on the Update button to validate your modifications or on the Cancel button to quit without saving. • To erase a script section: Select the script section to delete and click on the Delete button.
General Reference Guide 3.7.2 eWON Configuration The Script control link This page is used to monitor the result of the script execution and to execute some commands manually. You can use this page to easily debug your program. Figure 69: eWON script control page To display the result of the script execution, 2 actions must be performed: • Start the script execution by clicking on the RUN link. • Click on the Update Output button to update the display of the result screen.
General Reference Guide 3.8 eWON Configuration Wizards To help you quickly and easily configure some features, eWON provides you some wizards. Use the logo to display the availables wizards on your eWON. Figure 70: Wizards list Wizard Description Use this wizard to configure your eWON for Internet connection. You can choose between Modem or WAN, encode your PIN code, APN (for GPRS), choose if the connection will be permanent or OnDemand, ... Only available for eWON with modem.
General Reference Guide 4 eWON Configuration Configuring the eWON by a file upload It is possible to configure the eWON by uploading some files with an FTP client program. If you need to configure the eWON, you will put the config.bin file or the two config.txt and comcfg.txt files on the root directory of the eWON. You could also put the program.bas directly on the eWON. You can edit/modify the script Basic application in your favorite text editor, save as text file with the name program.
General Reference Guide 5 IO Servers Configuration The eWON IO Servers 5.1 Introduction This introduction repeats some information already introduced in chapter “Tag definition: Introduction” on page 67. An IO Server is the interface between a changing value and the eWON monitoring engine. It is a kind of driver. Any variable from any data source must have a common representation for all IO Servers in order to define common interface in the eWON.
General Reference Guide 5.2.1 IO Servers Configuration IO Server Clear To avoid the useless consumption of CPU and memory, the unused IO Servers need to be “unloaded” from CPU tasks and the used memory need to be cleared. For that purpose, the Clear function must be used. Only set to disable the BaudRate of an IO Server make it idle, but this IO Server is still in memory and use some CPU time (for nothing). Click on the Clear link to reset the config of the displayed IO Server and unload it from memory.
General Reference Guide 5.2.4 IO Servers Configuration Standard IO server configuration page When no dedicated configuration page is defined for configuring an IO server, the standard configuration page is used. Figure 73: Standard IO server configuration page As you can see in the above example, the standard configuration screen is a simple text edition area. Each parameter is entered on a separate line, the parameter value is separated from the parameter name by a colon ':' .
General Reference Guide 5.3 5.3.1 IO Servers Configuration Modbus IO server Introduction The MODBUS IO Server setup is the standard remote IO communication setup of the eWON. It is used to configure: • The eWON as a Modbus RTU master. • The eWON as a Modbus TCP slave and master. The first feature (Modbus TCP slave) is specific to the MODBUS IO server; it is actually designed to provide access to eWON Tag values and, unlike all the other IO servers, for interfacing field values with the eWON.
General Reference Guide IO Servers Configuration Example: if Modbus and UniTE IO servers are available, at least one of them must have its baud rate set to Disabled. If not the case, one of the IO servers will not be able to use the serial line and it will be disabled, with an error written in the event log. 5.3.2.3 Topic configuration Figure 76: Modbus topics configuration Three topics can be used for the IO Server.
General Reference Guide IO Servers Configuration Parameter name Description PreDelayFrom Used in conjunction with the next parameter (PreDelayVal), starting at that slave address, the eWON will insert a delay when switching from one slave address to another. If the PreDelayVal feature is not used, then the value for PreDelayFrom must be set to 256 (default value).
General Reference Guide 5.3.3 IO Servers Configuration Tag name convention IO Server configuration IO Server Name MODBUS Topic Name A or B or C Item Name 5.3.3.1 ValueName,SlaveAddress The PLC Address is defined Tag by Tag on serial link (RTU Master) ValueName,SlaveAddress,IPAddress The PLC Address is defined Tag by Tag on TCP link ValueName The Topic PLC address is used ValueName The Modbus IO Server Tags can be classified following ranges of values. Two types of ranges are used.
General Reference Guide IO Servers Configuration After the numerical value, the characters F, L, I, D or W can be used to specify how to read the value. The following table describes the different character meaning.
General Reference Guide 5.3.3.2 IO Servers Configuration Slave Address This is the address of the slave device that you want to access. It is a number from 0 to 255. Example: 30001,11 5.3.3.3 Polls a RTU device at address 11. IP Address This is the IP address of the device on an Ethernet network. It is composed of 4 numbers separated by a dot. Example: 30001,11,10.0.0.50 5.3.3.4 Polls a device configured with IP address 10.0.0.50 and with Modbus slave address 11.
General Reference Guide 5.4 5.4.1 IO Servers Configuration NETMPI IO Server Introduction NETMPI IO server is used to communicate with SIEMENS PLC. The eWON will connect to the PLC’s MPI interface by means of the eLINK adapter. The eLINK adapter is an interface with an MPI interface on one side and an Ethernet TCP/IP interface on the other side. The eLINK interface will be configured with an IP that the eWON will use to poll data.
General Reference Guide 5.4.3.1 IO Servers Configuration ValueName DBxBy Data block x Byte offset y (0-255) DBxWy Data block x Word offset y (0 - 65535) DBxFy Data block x Float offset y (+-3.
General Reference Guide 5.5 IO Servers Configuration UNITE IO Server 5.5.1 Introduction The eWON RS485 link can be configured as an UNITELWAY SLAVE INTERFACE. When the BaudRate in the UNITE IO Server is set to a value different than "Disabled", the Unitelway slave module in the eWON will be enabled. This Unitelway slave provides 2 features: • Poll items in a Unitelway capable device. The device can be the Unitelway master itself or a device addressable through the Unitelway master on the XWay network.
General Reference Guide IO Servers Configuration Important: When there are multiple IO servers potentially using the serial line, the unused IO servers must be "DISABLED" for the unused IO server baudrate. Example: if Modbus and UniTE IO servers are available, at least one of them must have the baudrate configured to "Disabled". If not, one of the IO servers will not be able to use the serial line and it will be disabled, with an error written in the event log. 5.5.2.
General Reference Guide 5.5.3.
General Reference Guide 5.5.3.2 IO Servers Configuration The device address syntax The Device Address is used in the topic definition or in the Tag definition. If used in the Tag definition, it will be separated from the value name by a coma (‘,’) • Network,Station,Gate or • Network,Station,Gate,Module,Channel The second case applies to addresses with 5 levels: • Network: 0..127 • Station: 0..63 • Gate: • Module: • Channel: Module and channel can be omitted if not required.
General Reference Guide 5.6 5.6.1 IO Servers Configuration DF1 IO Server Introduction The eWON serial link can be configured as a DF1 INTERFACE. When the Baud Rate in the DF1 IO Server is set to a value different than "Disabled", the DF1 module in the eWON will be enabled. This DF1 module provides 3 features: • Poll items in SLC50x and PLC5 controllers using PCCC requests. • Forward PCCC requests from EIP (TCP/IP) to DF1 bus and thus, acts as an adapter between EIP and DF1.
General Reference Guide eWON DF1 address Destination DF1 address Bridge EIP connection IO Servers Configuration The eWON’s device address on the DF1 link When th eWON acts as a DF1 slave, it will respond to 2 consecutive link addresses; doing this improves the throughput of data across the eWON when acting as a gateway.
General Reference Guide IO Servers Configuration Thanks to the ABLogix IOServer, the eWON is now able to poll data on SLC500/PLC5 devices by its Ethernet link. Even SLC500 connected behind your ControlLogix Network becomes available for polling. With this use of DF1 IOServer, the Serial config can be left unconfigured (baudrate=disabled), only one Topic enabled is required. You need to use a similar syntax than in ABLogix IOServer.
General Reference Guide IO Servers Configuration A Topic Name B C ValueName, DeviceType-DeviceAddress Device Type and Address are defined Tag by Tag Only device Type SLC500 is supported Device Address is a number between 0..254 ValueName Topic PLC Address is used Item Name Table 75: DF1 IO server configuration The Item Name can contain the PLC address where the value is polled, or not. If the address is also specified at the topic level, the address specified at Tag level will be ignored. 5.6.3.
General Reference Guide 5.6.3.1.4 IO Servers Configuration Status File Items Status File Item Format: S[n]:e[/b] • "n" represents the file number and is optional. If not specified, it is assumed to be 2 • "e" indicates the element number in the file (0..255) • "b" specifies the bit (0..15) decimal 5.6.3.1.5 Binary File Items Binary File Item Format: B[n]:e/b • "n" represents the file number and is optional.
General Reference Guide IO Servers Configuration Status, Global Device Address • You can define a status Tag for each PLC used. • If you use the status address, the Tag must be configured as analog. 0 Communication not initialized. Status UNKNOWN. If no Tag is polled on that device address, the communication status is unknown. 1 Communication OK. 2 Communication NOT OK. Table 77: Tag Status meaning 5.6.3.
General Reference Guide 5.7 5.7.1 IO Servers Configuration FINS IO Server Introduction The FINS IO Server includes the configuration of: • The eWON as a FINS Hostlink client (master) to give access on values in CSCJ series OMRON equipments reachable using eWON serial port(s). • The eWON as a FINS TCP/UDP client (master) to give access on values in CSCJ OMRON equipments reachable using eWON Ethernet interface.
General Reference Guide IO Servers Configuration Serial FINS network Source Network Address (SNA) filled in a FINS request message originating from the eWON and sent out on the serial interface. Serial FINS node Source Node Address (SA1) filled in a FINS request message originating from the eWON and sent out on the serial interface. It uniquely identifies the eWON on the serial network. Table 78: FINS IO server COM setup configuration fields 5.7.2.
General Reference Guide 5.7.2.3 IO Servers Configuration Gateway Configuration The following parameters can be modified: Figure 85: FINS IO server gateway configuration FINS TCP Server Node The eWON FINS server node address used during FINS TCP session establishment (exchange of the FINS node address messages, and allocation of a FINS TCP Client node if necessary). Routing Entry 1..4 For each defined destination network, gives the matching relay destination node.
General Reference Guide IO Servers Configuration Supported memory areas: X Memory area A Auxiliary area C Counter area CIO Core I/O area D Data Memory area E Extended Data Memory area H Holding area T Timer Area W Work Area Table 82: FINS IO server supported memory areas table Modifier: Symbol Modifier value range W Word 0 .. 65535 S signed Word -32768 .. 32767 D DWord 0 .. 4294967296 (*) L signed DWord -2147483648 .. 2147483647 (*) F Float +/- 3.
General Reference Guide 5.8 5.8.1 IO Servers Configuration S5-AS511 IO Server Introduction This IO server is intended for use with Siemens S5 PLCs communicating via the front programming port using AS511 protocol. The AS511 protocol is specific for each Siemens device. This IO Server has been designed to operate with a set range for Siemens equipment. Use of the IO Server on devices other than those listed is not recommended and not supported. The Siemens S5 PLC family has a unique memory structure.
General Reference Guide 5.8.4 IO Servers Configuration Tag name convention IO server Name S5-AS511 Topic name A or B or C Item Name ValueName, ComPortNum COM port is defined Tag by Tag ValueName Topic COM port is used (or default) Table 87: S5-AS511 IO server Tag name convention table ComPortNum: The port number used to access the PLC; if not specified, the default COM port is used. • If a port address is specified in the topic, it is used and overloads per Tag address.
General Reference Guide IO Servers Configuration • Status register: The STATUS Tag is a special Tag that returns information about the current state of communication for a given device. As for other Tags, the status Tag ValueName is composed of: Status,ComPortNum • You can define a status Tag for each COM port used. • If you use the status address, the Tag must be configured as analog. 0 Communication not initialized. Status UNKNOWN.
General Reference Guide 5.9 5.9.1 IO Servers Configuration ABLOGIX IO Server Introduction ABLogix IO server is used to communicate with Allen Bradley Logix Series PLCs on the Ethernet link or on the Serial link (in DF1 protocol). • It allows the eWON to poll ABLOGIX PLCs in order to read data. • It allows the eWON to act as EIP-DF1 gateway for remote maintenance of the ABLOGIX PLCs. • It allows the eWON to poll DH+ device using ControlLogix gateway.
General Reference Guide 5.9.2.1 IO Servers Configuration Communication Setup In the current implementation, the serial link configuration may be done using the DF1 IO Server configuration page or the AB LOGIX IO server page. The same settings apply for both IO servers (DF1 and ABLogix). note: In the config.txt file the serial link parameters are defined in the DF1 IO server entry.
General Reference Guide 5.9.2.2.2 IO Servers Configuration ABLogix : EIP Ethernet link The Global Device Address has the following syntax : IP Address,Port,Link • IP Address = address on your Ethernet network (i.e.: 10.0.30.
General Reference Guide 5.9.3.1 IO Servers Configuration ValueName ValueName follows the below syntax: [PROGRAM:ProgName.]SymbolicTagName • ProgName is the name of the program where the Tag is. If no ProgName, the Tag is in the global scope (tag is controller type) • SymbolicTagName: • Symbol of the tag.
General Reference Guide IO Servers Configuration 5.10 EWON IO Server 5.10.1 Introduction The eWON IO server is used to interface the eWON INPUTS and OUTPUTS. Depending on your eWON model, you have: • Digital inputs 1 on eWON500/2001/4001 9 on eWON4002 • Digital outputs 1 on eWON500/2001/4001 3 on eWON4002 • Analog inputs None on eWON500/2001/4001 6 on eWON4002 Additionally, there are a number of Tags that can be addressed with this IO server and which are computed by the eWON IO Server.
General Reference Guide IO Server configuration IO Servers Configuration Comment IO Server Name EWON Topic Name SYS Item Name SN_LO Serial number, low part (see example of use below) Analog SN_HI Serial number, high part (see example of use below) Analog SYS_UP Number of seconds since Power Up Analog GSM Status: 1: Home network 2: Searching registration 3: Registration denied 4: unknown registration 5: Roaming 100: Not applicable 101: Registration in progress GSM_REG Analog usually: 1 o
General Reference Guide IO Servers Configuration DI1... DI8 Status of input 1 to 8 on connector DI1-DI8 (top side) CI1... CI8 Counter on input 1 to 8 on connector DI1-DI8 (top side) LI1... LI8 Latched counter on input 1 to 8 on connector DI1-DI8 (top side) DI9 Status of input 9 on connector Input/output (bottom side) CI9 Counter on input 9 on connector Input/output (bottom side) LI9 Latched counter on input 9 on connector Input/output (bottom) DO1...
General Reference Guide IO Servers Configuration Figure 91: eWON IO server default parameters 5.10.2.2.1 ENERGY TAGS The following tags are available for energy management: LI1..LI8 Latched input When the Integration Period expires, the number of pulses counted during the integration period are logged in the corresponding LIx. ST1..ST4 Status variables: ST1 Latch time - 0x30000000 This is the absolute time when counter were latched.
General Reference Guide 5.10.2.3 IO Servers Configuration Analog Input Value Range (eWON4002) The Analog Inputs (AI1 to AI6) come from a 12 bits ADC. Then, the values read on a AI# tag go from 0 to 4095. 5.10.2.3.1 Configurable analog input AI1 to AI4 • In 0-10V mode AI# Volt 0 0 4095 10 If you need to read the Tag value converted in Volt, you can set a factor of 0.0024420 = 10/4095 with an offset of 0.
General Reference Guide 5.10.2.3.2 IO Servers Configuration PT100 input AI5 and AI6 These two entries measure a Resistance value in Ohm. AI# Ohm 0 162.13 4095 79.625 As you can see, the slope is negative, and if you need to read the Tag value converted in Ohm, you can set a factor of -0.02014774 = -82.505/ 4095 with an offset of 162.13. Figure 94: Tag’s configuration: reading the tag value in Ohms If you need to convert into °C: temperature = AI * (-0.0523311) + 161.376.
General Reference Guide 5.10.3 IO Servers Configuration Setup The Energy IO Server is based on the eWON IO Server. The configuration consists in advanced parameters from the latter IO Server. The following screen shot shows the standard empty eWON IO Server configuration page. Figure 95: eWON IO server configuration page 5.10.3.1 Configuration of the counter pulse length The pulse length for counter can be configured on all the eWON types.
General Reference Guide IO Servers Configuration 5.11 MEM IO Server 5.11.1 Introduction The MEMORY IO Server is not a real IO server because values do not come from a peripheral. Memory Tags (Tags defined with the MEM IO server) are rather sorts of variables that can be modified by a user input or by a BASIC application. These Tags are very useful for combining different Tags and consider the result as an actual Tag i.e.
General Reference Guide IO Servers Configuration 5.12 S7-300&400 (MPI/Profibus - ISOTCP) 5.12.1 Introduction S73&400 IO Server is dedicated to communicate directly with SIEMENS PLC (S7-300 & S7-400). The eWON will connect directly to the PLC’s MPI interface or Profibus DP interface. WARNING: The MPI/Profibus interface requires a special serial port hardware! ONLY the eWONs MPI/Profibus are able to communicate in MPI/Profibus eWON product codes like EWxxx6x (i.e.
General Reference Guide IO Servers Configuration Speed of the MPI port. Available speeds are: Baud Rate Reply Timeout MPI Address MPI Highest Station Address • • • • • • • • • • 9.6 19.2 45.45 93.75 187.5 1.
General Reference Guide 5.12.3 IO Servers Configuration Tag name convention IO Server Name S73&400 A Topic Name B C ValueName, Global Device Address PLC address is defined Tag by Tag ValueName Topic PLC Address is used. Item Name Table 99: S73&400 IO server - Tag name convention table The Item Name can contain the PLC address where the value is polled, or not. If the address is also specified at the topic level, the address specified at Tag level will be ignored. 5.12.3.
General Reference Guide IO Servers Configuration Examples address point to MW4 the Word at address 4 (in bytes) in the Internal Memory CS1 the Counter number 1, read it as Signed Word DB2L5 the DWord at address 5 (in bytes) in the Data Block 2 IB3 the Byte at address 3 (in bytes) in the Discrete Inputs zone I5#2 the bit 2 from the Byte (read ‘Bit access modifer’ note below) at address 5 in the Discrete Inputs zone Table 102: S7 300-400 register address examples • Bit access modifier: In any Me
General Reference Guide IO Servers Configuration The device address is composed like following: MPI node address: MPI node address of the PLC MPI, MPI node address Reach by MPI the PLC with the node address 2 node address: PROFIBUS node address of the PLC PROFIBUS, Profibus node addr Reach by Profibus the PLC with the node address 9 ISOTCP IP address : IP address of the PLC (ex: 10.0.120.204) Called TSAP : Transport Service Access Point (ex: 03.
General Reference Guide IO Servers Configuration 5.13 S7-200 (PPI - ISOTCP) 5.13.1 Introduction The S7200 IO Server is dedicated to communicate directly with SIEMENS PLC of family S7-200. The eWON will connect directly to the PLC’s PPI interface. Since firmware 5.5, eWONs with an MPI port are able to communicate on a PPI MultiMaster bus. Then, to communicate with a S7-200 device you could use either an eWON with a serial port or an eWON with an MPI port.
General Reference Guide IO Servers Configuration Figure 100: PPI link configuration Parameter COM Port Choose your COM port (only on eWON4002) Baud Rate Speed of the PPI port. Available speeds are 9600, 19200 Bauds or disable Parity Databits The parity to apply (None / Even /Odd) Number of bits in data (7 or 8) Stop bit(s) Number of Stop bits (1 or 2) HW mode Choose the Hardware mode of communication: Half-Duplex by default or Full Duplex with/without hardware handshaking.
General Reference Guide 5.13.2.4 IO Servers Configuration Topic configuration Figure 103: Topic configuration Three (3) topics can be used for the IO Server. These topics are used to give a common property to a group of PPI/ISOTCP Tags like: • Enable/Disable • Global Device Address • Polling Rate Topic configuration item Topic enabled Enables or disables polling of all the Tags in the topic. See below for the Device Address Syntax.
General Reference Guide 5.13.3.
General Reference Guide IO Servers Configuration • Status register: The STATUS Tag is a special Tag that returns information about the current state of communication for a given device. As for the other Tags, the status Tag ValueName is composed of: Status, Global Device Address • You can define a status Tag for each PLC used. • If you use the status address, the Tag must be configured as analog. 0 Communication not initialized. Status UNKNOWN.
General Reference Guide IO Servers Configuration 5.14 HITACHI IO Server 5.14.1 Introduction The Hitachi IOServer allows the eWON to poll tags belonging to a HITACHI EH series PLC using its serial link or Ethernet interface. eWON uses standard H protocol (for serial RS232), station number H protocol (for serial RS485), and Ethernet H-protocol (for Ethernet). No remote maintenance functionality is provided by this IO server. 5.14.1.1 5.14.1.1.
General Reference Guide 5.14.1.1.2 IO Servers Configuration Topic configuration Figure 105: HITACHI IOServer: Topic configuration Three (3) topics can be used for the IO Server. These topics are used to give a common property to a group of Hitachi Tags like: • Enable/Disable • Global Device Address • Polling Rate Topic configuration item Topic enabled Description Enables or disables polling of all the Tags in the topic. Global Device Address See below for the Device Address Syntax.
General Reference Guide 5.14.2.
General Reference Guide IO Servers Configuration L CPU Link Bit Hxxxxxx H stands for hexadecimal x: 1 to 6 digits hexadecimal indicating bit offset WL CPU Link Word W, S Hxxxxxx H stands for hexadecimal x: 1 to 6 digits hexadecimal indicating word offset DL CPU Link Double D, L, F Hxxxxxx H stands for hexadecimal x: 1 to 6 digits hexadecimal indicating word offset Table 115: HITACHI Memory types and address scheme Note: The Modifier can by omitted, the modifier in bold will be used.
General Reference Guide 5.14.2.2 IO Servers Configuration Global Device Address The device address is either appended to the ValueName in the Item Name definition, or entered in the Topic global address fields. The device address syntax is the following: EH[,[[ipaddress,TCP|UDP,port]|[station]][,LUMP]] EH Serial EH,station EH EH,station,LUMP station : address of the PLC on the network EH,4 the eWON will access PLC number 4. By configuration, an HITACHI PLC could have an undefined station number.
General Reference Guide IO Servers Configuration 5.15 MITSUBISHI FX IO Server 5.15.1 Introduction This MITSUFX IOServer allows the eWON to poll tags belonging to a MITSUBISHI FX series PLC using its RS-422 base unit programming connector. No remote maintenance functionality is provided by this IO server. The VCOM feature of the eWON has to be used to cover a remote maintenance. MITSUFX IOServer is available in eWON with Firmware 5.5 and above. 5.15.2 Setup 5.15.2.
General Reference Guide 5.15.2.2 IO Servers Configuration Topic configuration Figure 107: MITSUFX IOServer: Topic configuration Three (3) topics can be used for the IO Server. These topics are used to give a common property to a group of Mitsubishi Tags like: • Enable/Disable • Global Device Address • Polling Rate Topic configuration item Topic enabled Description Enables or disables polling of all the Tags in the topic. Global Device Address Select the type of Mitsubishi PLC to link.
General Reference Guide 5.15.3.
General Reference Guide IO Servers Configuration Status, Global Device Address • You can define a status Tag for each PLC used. • If you use the status address, the Tag must be configured as analog. 0 Communication not initialized. Status UNKNOWN. If no Tag is polled on that device address, the communication status is unknown. 1 Communication OK. 2 Communication NOT OK. Table 126: Tag Status meaning RG-001-0-EN ver 1.
General Reference Guide IO Servers Configuration 5.16 SNMP IO Server 5.16.1 Introduction The SNMP IO server (Simple Network Management Protocol) is used to communicate with any SNMPv1 device on the network. It allows both read and write operations on 32-bit objects. It supports access to several different devices at the same time. Only the following Object types are supported: INTEGER, 32bits COUNTER, GAUGE, UNSIGNED, TIMETICK. There is no handling of MIB files.
General Reference Guide 5.16.3 IO Servers Configuration Tag name convention IO Server Name SNMP A Topic Name B C ValueName, Global Device Address PLC address is defined Tag by Tag ValueName Topic PLC Address is used. Item Name Table 128: SNMP IOserver - Tag name convention table The Item Name can contain the Device address where the value is polled, or not. If the address is also specified at topic level, the address specified at Tag level will be ignored. 5.16.3.
General Reference Guide IO Servers Configuration • Status register: The STATUS Tag is a special Tag that returns information about the current state of communication for a given device. As for the other Tags, the status Tag ValueName is composed of: Status, Global Device Address • You can define a status Tag for each Device used. • If you use the status address, the Tag must be configured as analog. 0 Communication not initialized. Status UNKNOWN.
General Reference Guide 6 Monitoring Web Interface eWON Monitoring Web Interface If you have configured the eWON with some Tag names, you can now come back to the eWON’s Web Interface menu (Main Menu). The Web Interface menu of the eWON looks like this: Figure 109: eWON Web Interface menu The little home icon under the eWON logo can be accessed from any page of the eWON Scada and will always lead your browser directly to this main menu of the Web Interface.
General Reference Guide 6.1 Monitoring Web Interface Real-time screen Click on the View IO item from the eWON Web Interface menu to obtain the list of all eWON Tag names and associated real-time values. To refresh the value, click again on View IO item. Figure 111: eWON real time screen 6.1.1 Change a Tag value As shown in the above example, in the first row from the Tag list, if the Tag name is an output and if the user has the right to ‘force output’, an edit box and an Update link are available.
General Reference Guide 6.1.4 Monitoring Web Interface Historical window A check box may also appear in the first column of the View I/O screen meaning that you can choose this Tag to view its historical trend. It appears only if the historical logging has been enabled in the Tag description (see chapter “Tag Setup” on page 67). 6.2 Historical Trending screen Warning: depending on the eWON's version - c.f. table at the end of this manual.
General Reference Guide Monitoring Web Interface Figure 114: eWON historical trend graph RG-001-0-EN ver 1.
General Reference Guide 6.3 Monitoring Web Interface Historical table The historical table is a representation of the IRCALL.BIN (incremental recording). This representation provides recordings representation as a table where columns are Tag names and rows are recording times. The features can be used at 2 levels: • A page in the VIEW area. • An export bloc descriptor exists (see “$dtHT [Historical Table]” on page 173). The Historical table is available through the View I/O page.
General Reference Guide 6.4 Monitoring Web Interface Real time Alarm screen Figure 118: eWON real time alarm screen The real time alarm page lists all the Tag names currently in alarm state. • The ‘Date’ tab displays the eWON date and hour when the Tag was in alarm. • The ‘Name’ tab displays the Tag in alarm. • The ‘Action/Date’ tab displays the last status of the Tag and the date and hour of this state. • The ‘User Ack’ tab displays the user who acknowledged the alarm.
General Reference Guide 6.5 Monitoring Web Interface Historical Alarm screen The historical alarm screen is used to find the alarms generated in the past and know who acknowledged a specified alarm. All the alarms are stacked from the top to the bottom. The given information is: • The date and the hour of the event. • The Tag name. • The type of the event: ALM, RTN, ACK or END (RTN and ACK). • The user who acknowledged the alarm. • The description of the Tag.
General Reference Guide 6.6 Monitoring Web Interface Files transfer This link gives you access to a page where the eWON files are listed: Figure 121: files transfer page RG-001-0-EN ver 1.
General Reference Guide 6.7 Monitoring Web Interface Diagnostic If you encounter problems with your eWON, you will find a lot of information in the diagnostic area of the eWON. Figure 122: Diagnostic page (without ADSL) The diagnostic area is divided in four or five zones : • Event Log • Status • Scheduled Actions • Real Time Log • ADSL Log (on eWON with ADSL modem) Figure 123: Diagnostic page (with ADSL) 6.7.1 Event Log The Event Log page shows you the information recorded in the Events.txt file.
General Reference Guide Monitoring Web Interface You can customize the information displayed on this page by using the Event Class, Reporting Level and Per Page entry fields. Figure 125: Customize the Event Log page Event Class Reporting Level Per Page Allows you to filter the events displayed by categories ( or ALL ) Allows you to filter the events displayed by severity. You view the level choosed and the levels greater. If you select Warning, you will see the warning and Error events.
General Reference Guide 6.7.2 Monitoring Web Interface Status With the Status page, you can access all the internal variables, counters representing the current live status of your eWON. These counters are organized in three main categories: System Counters, I/O Servers counters and System Info. Figure 126: Status select page In the first column, you can see an or icon representing the Error or Warning level of this category. Click on the category link to view different counters/info.
General Reference Guide 6.7.2.1 Monitoring Web Interface Memory Information Figure 127: Memory Information page 6.7.2.2 NAT & IP Forwarding Figure 128: NAT & IP Forwarding page RG-001-0-EN ver 1.
General Reference Guide 6.7.2.3 Monitoring Web Interface VCom Figure 129: VCom page 6.7.2.4 Status Figure 130: Status page RG-001-0-EN ver 1.
General Reference Guide 6.7.2.5 Monitoring Web Interface Info Figure 131: Info page 6.7.3 Scheduled Actions The Scheduled Actions diagnostic page shows you the states of the outgoing actions like SendMail, putFTP, getFTP, NTPSynchro, SNMPTrap. Figure 132: Scheduled Actions page The Status code can take the following values: Status code values 0 Ended with Success -1 In Progress >0 Ended with Error. The value is the Error code. See Status As Text column for explanation.
General Reference Guide 6.7.4 Monitoring Web Interface Real Time Log The Real Time Log diagnostic page shows you the Debug information from VCom, Energy, Serial and VPN. This logging is a time consuming eWON task and is not activated by default. It will slow down the overall behavior of the eWON. Use it only during your debugging process ! Figure 133: Real Time Log page You can select the source of the data to display and the number of events per page with the configuration fields.
General Reference Guide 6.7.4.2 Monitoring Web Interface Activate Energy debug mode Figure 136: Activate Energy debug 6.7.4.3 Activate Serial debug mode You can activate the debug mode on every serial port of the eWON (COM port(s) and Modem). Syntax is SerDebX:Y X is the Serial port number and Y is the debug mode.
General Reference Guide Monitoring Web Interface As the Serial Debug uses eWON ressources (CPU and memory), don’t forget to disable the debugging once you don’t need it anymore. Set the SerDebX to 0 (null) to disable it.
General Reference Guide 7 Retrieving data from eWON Retrieving Data from eWON 7.1 List of eWON files The eWON flash file system contains the following files (R: read, W: write). Detailed information about files format are contained in the Technical Notes that you can download from the eWON web site (Support/Documentation/Technical notes on http://support.ewon.biz): • TN02: eWON files format • TN03: ircAll.bin format • TN12: var_lst.txt format File Name Type Description Events.
General Reference Guide Retrieving data from eWON • The following files only appear if the user owns the "Config rights": • Program.bas • ewonfwr.edf • config.bin • config.txt • During an FTP session, all the files are read-only, except for users who own the "Config rights". 7.2 Files Format Files format are text semicolon (;) separated files that may be inserted inside a program such as Excel™. The first row gives the columns names, and the next ones the values of the different columns.
General Reference Guide 7.3 Retrieving data from eWON FTP transfer FTP stands for the classical File Transfer Protocol used on the Internet. 7.3.1 FTP Software tools A lot of FTP software tools are available on the market. A very professional freeware FTP software called SMART FTP is available on the eWON web site for download http://www.ewon.biz/ (/Support/Resource Links). This tool allows you to easily manage file retrieving by drag and drop.
General Reference Guide 8 Export Block Descriptors Export Block Descriptor Exports are used to export eWON data. Export block can be used in the following situations: • Attach the eWON data to an email • Include eWON data into an eMail content • Make an FTP PUT of eWON data from the eWON to a FTP server • Make an FTP GET from a FTP client out of the eWON FTP server • Include data in an eWON HTML custom page. • Access data in Basic with OPEN “exp:.....
General Reference Guide 8.2 Export Block Descriptors Export fields syntax definition The syntax for the different fields is defined in the following chapters. 8.2.1 $dt [Data Type] The $dt field defines what data to export from the eWON.
General Reference Guide 8.2.3 Export Block Descriptors $st [Start Time] and $et [End Time] These 2 fields are used to limit the time range of an export operation. $st and $et provide the start and end time of the export. The parameter format is the same for both fields. There are 3 different formats for the $st, $et parameter: • Relative time • Absolute time • From last $ut (see also “$ut [Update Time]” on page 170). 8.2.3.
General Reference Guide 8.2.4 Export Block Descriptors $ut [Update Time] This field has no parameter, it means that at the end of this export, the time of the last point exported must be saved in the eWON so that it can be used as a reference time for a later call. Example: $stL$et_0$ut This sequence will specify a time range from last time to current time AND will ask to update the last time at the end of the export. The last time is stored on a per Tag basis if one Tag is specified for the export.
General Reference Guide 8.3 Export Block Descriptors Data Types description and syntax A Data type defines what is exported from the eWON. The data type is defined by the $dt field followed by 2 uppercase letters. The $dt field is mandatory for each "Export Block Descriptor" and usually the $ft (Format) field will also be present to define the output format of your data (although a default format is defined for each data type).
General Reference Guide Export Block Descriptors $ft Acceptable values Binary Text HTML Graph Table 144: [$dtHL] $ft acceptable values The Graph format is only allowed if a Tag has been specified. The Text format will output a comma-separated file. The separator is ‘;’ to avoid any confusion with decimal point. If all the Tags are output they will be output in a chronological order in the file. $ut If only one Tag is specified, the time of the last point for that Tag will be memorized.
General Reference Guide 8.3.2 $dtHT [Historical Table] 8.3.2.1 Export content Export Block Descriptors The historical table is a representation of the IRCALL.BIN (incremental recording). This representation provides a recordings representation as a table where columns are Tag names and rows are recording times. The features is also used in the VIEW area (see “Historical table” on page 151). 8.3.2.
General Reference Guide Export Block Descriptors For fixed interval, $in parameter must be used. The interval is defined in seconds. Example: $in10 to output one value every 10 seconds If $in is not specified, then the output time is defined by the time in the recording file. Example: Let’s assume that we have 2 Tags logged with the following time and values (for clarity, the date has been omitted): Time Tag Value 10:01:00 Tag1 1 10:10:00 Tag1 1.
General Reference Guide 8.3.3 $dtRL [Real time Logging] 8.3.3.1 Export content Export Block Descriptors The Real time logging outputs the data from the File system for ONE Tag. The output format can be TEXT, HTML Table, BINARY or GRAPH. A time range can also be specified for this export. 8.3.3.
General Reference Guide 8.3.4 $dtAH [Alarm History] 8.3.4.1 Export content Export Block Descriptors The Alarm History outputs data from the File system for ONE or ALL the Tags. The output format can be TEXT or HTML Table. A time range can also be specified for this export. 8.3.4.
General Reference Guide 8.3.5 $dtAR [Alarm Real time] 8.3.5.1 Export content Export Block Descriptors The Alarm Real time outputs the real time data for ONE or ALL the Tags. The output format can be TEXT or HTML Table. If only ONE Tag is specified, 1 or 0 lines will be appended to the output header line (Time range is not applicable here). 8.3.5.
General Reference Guide 8.3.6 $dtEV [EVent file] 8.3.6.1 Export content Export Block Descriptors The Event file outputs data from the File system. The output format can be TEXT or HTML Table. A time range can also be specified for this export. 8.3.6.
General Reference Guide 8.3.7 $dtSS [Scheduled Status] 8.3.7.1 Export content Export Block Descriptors The scheduled actions are actions that are executed in a scheduled manner, for example: PutFTP, Send Mail, Send SMS. When one of these actions is requested, it does not occur immediately, but it is queued for a sequential execution. This export allows checking the content of this queue and giving the status of all the actions in queue: "in progress", "executed (success)" and "executed with error".
General Reference Guide 8.3.8 $dtSE [Script Expression] 8.3.8.1 Export content Export Block Descriptors This export provides a means to get the content of a script expression. The script expression is a standard eWON Basic-like expression returning a STRING, and INTEGER or a FLOAT. The evaluation of the expression will always occur between 2 scripts execution, for example between 2 ONTIMER executions, or between 2 cycles of the cyclic sections. 8.3.8.2 Detailed Example $dtSE $se"A$" 8.3.8.
General Reference Guide 8.3.9 $dtUF [User File] 8.3.9.1 Export content Export Block Descriptors The User File export returns the content of a file in the User File area (/usr/ directory – or subdirectory). When the file is exported, the <%#ParamSSI> and <%#TagSSI> Tags are replaced by the actual values. 8.3.9.2 Detailed Example $dtUF $uf/ufdir/uf1.txt 8.3.9.3 $dtUF User file $uf/ufdir/uf1.txt Will export the uf1.
General Reference Guide Export Block Descriptors Examples: Using $fn in a send mail string: SENDMAIL "MailReceiver@YourMail.com", "", "Mail Subject", "Mail text &[$dtUF$fn/myfile.txt]" Use the above syntax if you want the attached file to keep its name . SENDMAIL "MailReceiver@YourMail.com", "", "Mail Subject", "&[$dtUF $uf/myfile.txt $fn/myfile2.txt]" Use the above syntax if you want the attached file to be received with a different name. 8.3.9.3.
General Reference Guide 8.3.10 $dtIV [Instant Values] 8.3.10.1 Instant value - general information Export Block Descriptors Instant value means values of Tags at a given time.
General Reference Guide 8.3.10.
General Reference Guide Export Block Descriptors Then there is a record number for each Tag (the record number can be obtained from the header (NbTag): struct InstantValueRecord { int TagId; float Value; int AlStatus; int AlType; int Reserved; } WARNING: All data in these records are stored in BigEndian Until more information is available in this chapter, please refer to "Technical Note 03" for more information about eWON's data representation of floats and big endian format (http://support.ewon.
General Reference Guide 8.3.11 $dtSV 8.3.11.1 Export content Export Block Descriptors $dtSV returns the value of a defined eWON system variable. A typical use is when the user wants to include the eWON online IP address in an email by using the sendmail Basic syntax. The output format can only be of TEXT type. 8.3.11.2 Detailed Example sendmail "user@user.
General Reference Guide 8.3.12 $dtPP 8.3.12.1 Export content Export Block Descriptors $dtPP exports the dump.ppp file (binary format): the file in which the online eWON activity is logged. The output format can only be of BINARY type. 8.3.12.2 Detailed Example sendmail "user@user.be","","eWON PPP dump","&[$dtPP$fndump.ppp]" $dtPP Data type PPP dump $fn Will give the required name to the file Table 173: $dtPP - detailed example Will attach the eWON PPP dump file to a the eMail. 8.3.12.
General Reference Guide 8.3.14 $dtSC 8.3.14.1 Export content Export Block Descriptors $dtSC exports the communications configuration file (comcfg.txt): the file that lists the current status of the main eWON communication features. The output format can be TEXT or HTML. 8.3.14.2 Detailed Example sendmail "user@user.be","","eWON COM config file","&[$dtSC$ftH$fncomcfg.
General Reference Guide 8.3.15 $dtRE [Real Time Diagnostic] 8.3.15.1 Export content Export Block Descriptors $dtRE exports the Real Time Diagnostic data (equivalent to the real tiime log, see “Real Time Log” on page 161) The output format can be TEXT only. 8.3.15.2 Detailed Example sendmail "user@user.be","","eWON Real Time Log","&[$dtRE$fndiag.txt]" It will attach to an email the file “diag.txt” holding the real time diagnostic of the eWON.
General Reference Guide 8.3.16 $dtTR [TAR file] 8.3.16.1 Export content Export Block Descriptors $dtTR exports the eWON file(s) inside a TAR formated file. The data to include in the TAR file can be defined using a single file list, a directory and wildcard '*', or/and another export block descriptor's. 8.3.16.2 Detailed example $dtTR $td {/usr/*} $fnmytar.tar Put the complete /usr directory in the mytar.tar file.
General Reference Guide 8.3.16.5 Export Block Descriptors Examples $dtTR $td {/usr/file1.txt} $fnmytar.tar Will make a TAR file named “mytar.tar” containing the file /usr/file1.txt $dtTR $td {/usr/MyFile1.txt},{/usr/MyFile2.txt} $fnmytar.tar Will make a TAR file named “mytar.tar” containing the files /usr/MyFile1.txt and /usr/MyFile2.txt $dtTR $td {$dtCF $ftT $fnMyConfig.txt} $fnmytar.tar Will make an eTAR file named “mytar.tar” containing the eWON configuration file named “MyConfig.
General Reference Guide 9 9.1 Upgrading the eWON firmware Upgrading the eWON firmware Purpose There are two ways to upgrade the eWON firmware: by using eBuddy, the eWON utility designed to set up the eWON, or by directly uploading a new firmware on the eWON by means of a FTP client. 9.2 Upgrading the eWON firmware with eBuddy eBuddy allows you to update your eWONs with the latest firmware versions that are available for download from the eWON web site.
General Reference Guide Upgrading the eWON firmware The new firmware is uploaded to the selected eWON: Click on Next when upload is complete, the following dialog box then appears. Please DO NOT power OFF the eWON when it restarts, or this could lead to make it unusable. RG-001-0-EN ver 1.
General Reference Guide Upgrading the eWON firmware Click on the Finish Button when the upgrade is complete and exit from the Wizard. RG-001-0-EN ver 1.
General Reference Guide 9.3 Upgrading the eWON firmware Upgrading the eWON firmware by a direct upload The eWON’s firmware can also be upgraded using FTP. Just download the eWON firmware file (ewonfwr.edf) corresponding to your eWON type form our web site (http://www.ewon.biz), and put this file on your eWON using FTP. You can do this using any FTP client program, just be sure that you use the binary transfer mode and not ASCII.
General Reference Guide Upgrading the eWON firmware • Simply drag the new firmware to be uploaded (from your local hard disk or from another FTP folder) and drop it to the root of the eWON file system (here the window is named "10.0.120.11"). A confirm window will appear asking you the action to be performed. Figure 139: eWON firmware overwrite confirmation window • Click on the Overwrite button and wait the fill in (blue) of the progress bar in the left bottom side of the window.
General Reference Guide 9.4 Upgrading the eWON firmware Downgrade firmware 9.4.1 Firmware prior to 5 On firmware version prior to 5.x, the downgrade procedure is the same as the upgrade procedure : - use the “ewonfwr.edf” of the target firmware and copy it on the eWON root directory by FTP. Note: After a downgrade, it is recommended to format completely your eWON. 9.4.2 Firmware version 5.x (and above) On firmware version 5.x (and above), to downgrade your eWON: - the firmware file “ewonfwr.
General Reference Guide 9.5 Upgrading the eWON firmware Upgrade Bootloader (to upgrade to firmware >= 5.2) Since firmware version 5.2, the Bootloader of the eWON must be greater than 2.0. Every eWON produced with a serial number greater or equal to 0648-xxxx-xx have already this bootloader 2.0. The eWON produced before 0648-xxxx-xx exceptionally need to be upgraded. The Bootloader 2.0 is required to upgrade eWON to firmware 5.2. In order to do that, a bootldr.
General Reference Guide Appendix 10 Appendix 10.1 Access to the eWON Technical Support An eWON technical support is provided on our Web site (http://www.ewon.biz/). Just fill in the support request sheet (/Support/Support request), or send your problem description to support@ewon.biz.
General Reference Guide 10.2.2 Appendix Non-volatile configuration There are 2 additional blocks of flash memory used for: • Non-volatile COM configuration: this block contains the "System COM" setup. • Retentive values: Each time a retentive value changes, a record is written in flash, the record is 12 bytes long. This file is also erased when the flash file system is formatted.
General Reference Guide Appendix 10.5 Resetting the eWON 10.5.1 Overview In some situation it may be desired or required to initialize the eWON. The eWON has a non volatile memory which is used to store configurations and acquired data. Non volatile information is basically divided into 2 groups: • Communication configuration • The rest of the non volatile data (file system, Tag Config, user defined web site, etc.) The reset button is located between the SERIAL and LINE connectors.
General Reference Guide Appendix If an error is detected during the test, the led will show the error code with the following pattern: 1 sec. Error pattern for code = 2 This example shows the case where error code is 2. The pattern is repeated indefinitely until the eWON is manually rebooted (power OFF/Power ON). The pattern starts with a short blink of 200msec indicating the pattern start, then N blinks, each during 1 second are displayed. Then the pattern is repeated, etc.
General Reference Guide Appendix 10.
General Reference Guide Appendix 10.7 Duplicate IP detection (User Led blinking Red) Since firmware 4.3, eWON performs a check on the IP network in order to avoid duplicate IP. eWON makes this test at power up to see if its IP address is not conflicting with another device.
General Reference Guide Appendix 10.9 GSM modem Led behavior Figure 142: GSM level display on led The modem led default behavior is to go solid red while PPP Is established and off otherwise. If this option is selected, the modem led will display the signal level as described here: The led must display 2 informations: • if the modem is connected. • the signal reception level.
