-
eWON User Guide - Cover eWON 500-2001-4001-4002 User Guide Version 4.
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 1 Introduction....................................................................................... 14 2 The eWON welcome page ................................................................ 15 3 eWON Login...................................................................................... 16 4 eWON Configuration Interface ....................................................... 17 4.1 Overview.......................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 4.3.4.2.1 Overview ........................................................................................................................33 4.3.4.2.2 Event logging Configuration page...............................................................................34 4.3.4.3 PPP Dump ............................................................................................................35 4.3.4.3.1 Overview ..........................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 4.4.1.1 Tags monitoring and handling ...........................................................................58 4.4.2 Tag definition: Setup....................................................................................58 4.4.2.1 Tag main edit window .........................................................................................60 4.4.2.1.1 Publish as Modbus TCP .........................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 6.4.3 Tag name convention ...................................................................................85 6.4.3.1 ValueName ...........................................................................................................85 6.4.3.2 Device Address .....................................................................................................85 6.5 UNITE IO Server.....................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 6.8.1 Introduction ................................................................................................100 6.8.2 Setup ............................................................................................................100 6.8.3 Communication setup ................................................................................101 6.8.3.1 Supported Devices .............................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 9.1 BASIC language definition ..................................................................122 9.1.1 Introduction ................................................................................................122 9.1.2 Program flow ..............................................................................................122 9.1.3 Character string .........................................................................................126 9.1.
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 9.2.20 DYNDNS ...................................................................................................136 9.2.21 END ...........................................................................................................136 9.2.22 ERASE.......................................................................................................136 9.2.23 EOF........................................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 9.2.52 ONERROR ...............................................................................................152 9.2.53 ONPPP.......................................................................................................152 9.2.54 ONSMS......................................................................................................153 9.2.55 ONSTATUS .........................................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 9.3 Debug a BASIC program.....................................................................169 9.4 BASIC Errors Codes ............................................................................169 9.5 Configuration Fields.............................................................................170 9.5.1 SYS Config ..................................................................................................171 9.5.2 Com Section .............
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 11.2.3 $st [Start Time] and $et [End Time].......................................................195 11.2.3.1 $st, $et with relative time ................................................................................195 11.2.3.2 $st, $et with absolute time ...............................................................................195 11.2.3.3 $st , $et with Last time.................................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 11.3.7 $dtSE [Script Expression] .......................................................................208 11.3.7.1 Export content..................................................................................................208 11.3.7.2 Detailed Example .............................................................................................208 11.3.7.3 Fields used ...............................................................................
-
eWON 500-2001-4001-4002 User Guide - Table Of Contents 12.1 Purpose ................................................................................................219 12.2 Upgrading the eWON firmware with eBuddy .................................219 12.3 Upgrading the eWON firmware by a direct upload........................222 13 Appendix........................................................................................ 225 13.1 Access to the eWON Technical Support....................................
-
eWON 500-2001-4001-4002 User Guide - Introduction 1 Introduction The aim of this guide is to provide you with exhaustive information about the multiple eWON Version 4 features. Providing the gains in terms of optimization and performances that firmware version 4 brings, we incite you to migrate from version 3 to version 4 if not already done.
-
eWON 500-2001-4001-4002 User Guide - Introduction 2 The eWON welcome page Figure 1: eWON welcome page The eWON welcome page will invite you to log on. The Name just below the eWON logo is the name of your eWON, which allows you to identify the eWON you are connected to (see next chapter). A link to the ACT’L site is also provided if you want to know more about the company or download eWON application notes or software updates.
-
eWON 500-2001-4001-4002 User Guide - Introduction 3 eWON Login The default factory defined login of the eWON is: Login adm Password adm Table 1: eWON default login and password IMPORTANT! Password IS case sensitive but user name is not. It is recommended to change the password of the "adm" user to protect it against intrusion. You will be able to change the user configuration in the Users setup screen of your eWON (please refer to chapter “Users Setup” on page 18).
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4 eWON Configuration Interface Figure 3: eWON SCADA page Just after you have logged in successfully, the eWON SCADA will be displayed (as explained in the next chapter). But before analyzing the SCADA 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 4.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.2 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 eWON users and attributes. The first time you connect to the eWON, the default user is Adm. It is recommended to modify the default password of the Administrator user. 4.2.1 To edit a user Click on the user's name link in the User Login column. 4.2.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.2.3 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).
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.2.5 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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.2.6 Tag pages restriction There are 10 user defined pages (please refer to chapter “Pages configuration” on page 68) and one default page.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3 System Setup The system setup page (accessed by clicking on the System Setup item from the configuration menu) allows setting all eWON system parameters and looks as follows: Figure 9: eWON system configuration page This section has a high impact on the eWON behavior (mainly on the communication point of view). You should fill it in carefully.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.1 Main system setup 4.3.1.1 eWON identification (and miscellaneous) Figure 10: eWON main system setup – eWON identification Control Description eWON Identification The name of the eWON. This information is added inside all eWON Email alarm notification. Check that this identification and the next one allow you to identify eWON without any doubt. General Information As for eWON identification.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.1.2 Setup for outgoing actions 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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description SETUP FOR ALARM ACTIONS Action retrig interval Try action Action retry interval If the action on alarm first failed, then a new action on alarm will be triggered, 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). This parameter defines the number of times the action will be retried in case of errors.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.1.3 Resetting eWON Resetting eWON is sometimes necessary (i.e. to validate some configuration changes). eWON version 4 offers two ways to perform a reset: • From the General configuration page (chapter “Reset Request from the General Configuration page” on page 26) • By using the "REBOOT" Basic command, as described in chapter “REBOOT” on page 161. 4.3.1.3.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.2.1 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 right. The standard public community is defined here as read-only. 4.3.2.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.3 Virtual Com Port Setup 4.3.3.1 Introduction VCOM (or more precisely « Virtual COM port ») is a technology that consists in using the eWON’s serial port as if it was a standard COM port of a PC running Windows. Actually, a piece of software is installed on the PC; this software is a kind of driver that simulates additional COM ports on your PC.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.3.2.3 MODBUS/TCP MODBUS/RTU Gateway Although it is possible to use this technology to transfer almost any type of data through the virtual serial port, some protocols require special handling for efficient operation. ModbusRTU is one of these protocols and VCOM technology does not applies well to that protocol. For Modbus RTU communication it is recommended to use the MbsTcpCOM software and use the eWON as a ModbusTCP to ModbusRTU gateway. 4.3.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.3.4.2 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/Virtual Com (from the General menu): 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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Always accept new clients When a PC is connected to the eWON, then a socket is opened by the PC to the eWON. If for example the PC suddenly switches off, the eWON will not know that the socket should be closed, and when the PC will try to connect again, the eWON will refuse its connection.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.4 Diagnostic 4.3.4.1 Overview This part of eWON configuration allows you to fine-tuning the way you monitor 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. 4.3.4.2 4.3.4.2.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.4.2.2 Event logging Configuration page Figure 16: Event logging configuration page Control Initialisation Configuration IO Server Modem Communication Description Allows you to define the level of monitoring about the events concerning eWON boot. Allows you to define the level of monitoring about the events concerning eWON configuration. Allows you to define the level of monitoring about the events concerning the IO Servers that eWON manages.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.4.3 PPP Dump Warning: depending on eWON's version (c.f. Table on page 233) 4.3.4.3.1 Overview WARNING: this configuration is volatile, which means that the dump.ppp file will be cleared each time when eWON is rebooted. The dump.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.5 Clock Setup section Figure 18: eWON clock setup field The eWON’s real time clock can be updated manually with this dialog window. Fill in the edit box with date and time and click on Update Clock button. An event will be added to the event log signaling the time update and the time offset between old and new time.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.1 Ethernet This tab contains the Ethernet setup of the eWON, setting up the LAN side communication. Figure 20: eWON Ethernet setup Control Description Address Setup eWON Ethernet IP address eWON Ethernet IP mask eWON Ethernet IP gateway eWON Use BOOTP IP address of the eWON on the LAN side. Use this IP address to connect to the eWON using a LAN connection. It is 4 numbers from 0 to 255 separated by a dot.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.2 Modem Warning: depending on eWON's version (c.f. Table on page 233) 4.3.6.2.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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.2.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description Modem Settings 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. "BIBAND GSM" in the screenshot above). Enter here the currently valid PIN code on the SIM card you have inserted in eWON. GSM Pin Code (reboot required) This PIN code will be taken in account only after you have power OFF/power ON eWON.
-
eWON 500-2001-4001-4002 User 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 apply.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.2.3 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 place the LLCLT command in the init string. The other side acts as the server and you must place the LLSRV command in the init string.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.3 Dial up (PPP) Warning: depending on eWON's version (c.f. Table on page 233) This tab contains the PPP setup of the eWON, setting up the PPP (Point to Point) settings for the server and client functions of the eWON engine.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description Global Dialup Config This list box lists all modes of allowed connections types. This means: disabled, incoming, outgoing and both incoming and outgoing. Call direction allowed Disabled means that no call will be answered and that no outgoing call will be initiated, under any circumstance (this does not concern the SMS actions, that means you are able to send a SMS from eWON, even if "Disabled" is selected.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description Outgoing Calls Config Table 22: outgoing calls configuration controls Dial-out 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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.4 Callback Warning: depending on eWON's version (c.f. Table on page 233) This tab contains the configuration controls that the eWON will use to perform callback operations. Figure 24: eWON PPP Callback configuration Control Description General Callback Config Callback enabled Callback delay If this box is checked, then the eWON callback feature is enabled.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description IP address publishing Callback on ring This is a mutual exclusive option with Callback on User’s request. Selecting this option disables the User Callback mode. When the eWON sees an incoming call, it will trigger its callback task. Number of RINGS (minimum value is 2): This is the number of rings needed before the eWON callback function is triggered.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description Selection of the callback method Publish IP address EMail No-Ip Username (see http://www.no-ip.com/) This field allows you to define the destination address by default that will receive the callback notification. No-ip is a service that allows you to publish on Internet a domain name that matches the IP address of your PC (fix or dynamic type) e.g. myewon@no-ip.com.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.5 Router Warning: depending on eWON's version (c.f. Table on page 233) This tab contains the router configuration of the eWON, setting up the PPP (Point to Point) settings for the server and client functions of the eWON engine, in order to define the way you will use your eWON to accessing remote devices, and access to them through eWON as if they were on your local site.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control Description If this box is checked, then the eWON IP forwarding feature is enabled. 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 to the internet directly. Enable IP forwarding This feature can be used in order to connect a device to the internet through the eWON.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Figure 28: eWON PPP Router logon screen 4.3.6.6 IP Services This page allows you to redefine the standard eWON's ports. The main interest of this feature is i.e. to be able to go through a firewall when all the ports with value less than 1000 are blocked for access by this firewall.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.6.7 Default Config Using this menu, the user can return to a default well known configuration of the communication setup of the eWON. This will NOT modify anything on the other configuration 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 30: eWON Reset to default page 4.3.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.8.3 Communication Configuration 4.3.8.3.1 Overview The communication configuration needs to be saved in a distinct block in order to allow formatting any other data in the eWON without risking to loose contact with the device (Ethernet IP address, PPP configuration etc.).
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.8.7 Storage management from the eWON Web interface There are three choices that can be accessed by following this way from the Main Menu navigation bar from eWON: Configuration/System Setup/Storage. 4.3.8.7.1 Configure There are five 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).
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.3.8.7.2 Erase & Format Figure 32: Erase & Format panel This control panel function is to allow you to erase some parts of the eWON storage area. • Format All partitions Control Description 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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration • Format Historical Recording File System Control Description Format Historical Recording File System Validating this checkbox will result in erasing the 3 files that stores eWON internal history, which means all of the three following controls together in this table. Erase "Historical Recording" file Validating the checkbox will result in erasing the binary format ircall.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.4 4.4.1 Tag Setup Tag definition: Introduction The eWON SCADA 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 data-source.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.4.1.1 Tags monitoring and handling The eWON engine can handle the following operations on the Tags: Operation Description Alarm monitoring Check for low and high alarm levels or Boolean alarm level and management of alarm acknowledgement, alarm historical logging and action on alarm (Email, SMS, etc.) Historical logging Tags can be monitored and changes on a Tag can be saved in the Flash File System.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration • 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.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.4.2.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Figure 36: eWON Tag main configuration page - eWONs that allow logging feature eWON 500®2001®4001®4002® Version 4_3_0 - User Guide - 10/5/05 - ©ACT'L sa - Page 60
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Control 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 export function or script function. -This Information will be included on the alarm Email Note: the Tag’s name cannot contain: spaces $ character " characters Maximum length from Tag’s name is 64 characters A free text to describe the meaning of the Tag.
-
eWON 500-2001-4001-4002 User 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.
-
eWON 500-2001-4001-4002 User 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 57) 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. Warning: this is a non-volatile logging; data are stored in the flash file system.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.4.2.1.1.2 Modbus TCP rules • When accessing Modbus registers or coils that are not mapped to an eWON register, the returned value is 0. • Maximum number of registers readable in 1 request: 25 • Maximum number of coils readable in 1 request: 2000 4.4.2.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.4.2.2.1 Email on alarm configuration Configuration required if an Email must be sent in case of alarm. If Email must be sent through PPP, the system configuration (Main and COM) must also be setup. Alarm action Properties Email upon Short Message Description Checks the alarm states triggering an Email (ALM, ACK, RTN, END). In some case it is useful to have the whole message sent in the subject. For example if you need to route Email to SMS.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration The syntax for SMS_RECIPIENT is: • DDDD,TTT,MMM,PPP Or • DDDD,TTT,MMM DDDD Destination phone number Protocol type, must be one of the 4 following values: ucp It is possible to add a word datasize and parity specification. The generic syntax is ucpDP: with Datasize D= 8 or 7 with Parity P= n: none, o: odd, e: even Examples: ucp7o ucp7e ucp7n ucp8n (default value) tap It is possible to add a word datasize and parity specification.
-
eWON 500-2001-4001-4002 User 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 0407886633,tap,0475161621 tap protocol does not require to enter a password.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.4.2.2.3 FTP on alarm configuration Alarm action Properties Put FTP upon Destination file name File content Description Checks the alarm states triggering the Put FTP (ALM, ACK, RTN, END) Name of the file to create on the FTP server. The name can contain path specification. The file content can be static or dynamic (see below) Table 47: alarm action properties 4.4.2.2.3.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration You may enter up to 10 user defined pages. When Tags are defined in a specific page and the name of the page is changed, then the same Tags will belong to the renamed page. In other words, the Tag actually belongs to a page number, EXCEPT if the name of the page is changed to (empty field). In that case, all the Tags that belonged to the previous page will return in the default page.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.7.1 The Edit script link The 2 predefined scripts that are present in the eWON are: • The Init section, which is executed once at the startup of the eWON. • The Cyclic section, which is executed cyclically by the eWON. This page is used to create, delete or edit script sections. • The cycle time of the eWON BASIC is not pre-determined! • This cycle depends on script itself. • If well programmed, you can achieve cycle time under one second.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration Enter the name of the script in the Script Name field and the code to execute in the blank edition area. Figure 41: eWON new script section page Click then on the Update button to validate your script, or on the Cancel button to quit without saving.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 4.7.2 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 42: 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 displaying of the result screen.
-
eWON 500-2001-4001-4002 User Guide - eWON Configuration 5 Configuring the eWON by a file upload It is possible to configure eWON by uploading some files with a 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6 The eWON IO Servers 6.1 Introduction This introduction repeats some information already introduced in chapter “Tag definition: Introduction” on page 56. 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.2.1 Standard IO server configuration page When no dedicated configuration page is defined for configuring an IO server, the standard configuration page is used. Figure 44: Standard IO server configuration page As you can see in the example above, 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 ':'.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.3 6.3.1 Modbus IO server Introduction The MODBUS IO Server setup is the standard remote IO communication setup of the eWON. It is used to configure: • eWON as a Modbus TCP slave • eWON as a Modbus RTU master and as a Modbus TCP master.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.3.2.2 Setup for eWON IO server and Gateway - COM Setup Figure 46: Modbus communications configuration If more than one Serial port are available, you must choose on which COM the modbus request will be sent. This configuration part defines the RS485 setup. The four first fields are used to define the baud rate, parity, number of stop bits and the reply timeout (in msec – usually 1000 msec).
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration Three topics can be used for the IO Server. These topics are used to give a common property to a group of MODBUS Tag like: • Enable/Disable • Poll rate • Slave address (Modbus RTU) • Unit address and TCP/IP address (Modbus TCP) Modbus Server Properties Description Topic enabled Enables or disables polling of all the Tags in the topic. Slave address This slave address is a global parameter for all the Tags of the topic.
-
eWON 500-2001-4001-4002 User 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.3.3 Tag name convention IO Server configuration IO Server Name MODBUS Topic Name A or B or C Item Name 6.3.3.1 ValueName,SlaveAddress PLC Address is defined Tag by Tag on serial link (RTU Master) ValueName,SlaveAddress,IPAddress PLC Address is defined Tag by Tag on TCP link ValueName Topic PLC address is used ValueName The Modbus IO Server Tags can be classified following ranges of values. Two types of ranges are used.
-
eWON 500-2001-4001-4002 User 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.3.3.4 Device specific information Warning for new users of WAGO modules: Keep in mind that coil read and write don’t use the same address (offset of 0x200); please consult the Wago™ documentation. Example: If you use Wago™ systems with two digital inputs and two digital outputs, inputs have addresses 1 and 2 and outputs have the same. The only way to distinct them it’s the read-only access or R/W access.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.4 6.4.1 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 mean 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.4.3 Tag name convention IO Server configuration IO Server Name NETMPI A Topic Name B C ValueName,RemoteStationAddress,eLinkIpAddress PLC Address is defined Tag by Tag ValueName Topic PLC Address is used Item Name Table 57: NETMPI - IO server configuration The Item Name can contain the PLC address where the value is polled, or not. If address is not specified at the Tag level, the global topic address will be used.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.5 6.5.1 UNITE IO Server 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration The following parameters can be modified: Baud Rate Parity Stop Bit(s) Master Response Timeout Select the baud rate applying to your industrial network The parity to apply: none / odd / even. This field is set by default to Odd, as in the main cases in a typical UniTE topology. However, eWON allows you to define a different parity type (Even or None), in case this is needful to comply with your industrial network installations.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.5.2.2 Topic configuration Figure 51: XWAY-UNITELWAY topics configuration Three topics can be used for the IO Server. These topics are used to give a common property to a group of UNITE Tags such as: • Enable/Disable • Poll rate • Device address Topic configuration item Topic enabled Device Address Poll rate Description Enables or disable polling of al the Tags in the topic.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.5.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration Notes: SW type cannot be formatted as float eWON allows you to optimize the requests in case you need to read a lot of Tags that have been created on the UniTelWay device. Imagine you have 100 Tags to read, eWon will group the Tags within a predefined limit in order to make the less as reading operations as possible.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.6 6.6.1 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 2 features: • Poll items in SLC controllers using PCCC requests. • Forward PCCC requests from EIP (TCP/IP) to DF1 bus and thus, act as an adapter between EIP and DF1.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration The following parameters can be modified: Baud Rate Parity Stop Bit(s) Frame Error Detection HW mode Master Response Timeout The parity to apply: none / odd / even Number of stop bits Cyclic Redundancy Check (CRC) or Block Check Character (BCC) Full Duplex no handshaking or Half duplex Maximum time the eWON will wait for a valid message from the DF1 master.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration Three topics can be used for the IO Server. These topics are used to give a common property to a group of DF1 Tags like: • Enable/Disable • Poll rate • Destination Device Type and Address Topic configuration item Topic enabled Description Enables or disables polling of all the Tags in the topic Destination Device Type and Address The Destination Device Type and Address is a global parameter for all the Tags of the topic.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.6.3 Tag name convention IO Server configuration IO Server Name DF1 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 65: DF1 IO server configuration The Item Name can contain the PLC address where the value is polled, or not.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.6.3.1.2 Output File Items Output File Item Format: O[n]:e.s[/b] • "n" represents the file number and is optional. Value is always zero • "e" indicates the element number in the file (0..30) • "s" indicates the sub-element number (0..255) • "b" specifies the bit (0..15) decimal 6.6.3.1.3 Input File Items Input File Item Format: I[n]:e.s[/b] • "n" represents the file number and is optional.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.6.3.1.9 Integer File Items Integer File Item Format: N[n]:e[/b] • "n" represents the file number and is optional. If not specified, it is assumed to be seven, otherwise must be between 7 and 255 decimal • "e" indicates the element number in the file (0..255) • "b" specifies the bit (0..15) decimal 6.6.3.1.10 Floating File Items Floating File Item Format: F[n]:e • "n" represents the file number and is optional.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.7 6.7.1 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration Maximum time the eWON will wait for a valid FINS message response (applicable for ethernet and serial interface). ReplyTimeout Ethernet FINS network Source Network Address (SNA) filled in a FINS request message originating from the eWON and sent out on the ethernet interface. Ethernet FINS node Source Node Address (SA1) filled in a FINS request message originating from the eWON and sent out on the ethernet interface.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration Three (3) topics can be used for the IO Server. These topics are used to give a common property to a group of FINS Tags like: • Enable/Disable • Protocol • Global Device Address • Polling Rate Topic configuration item Topic enabled Description Enables or disables polling of all the Tags in the topic. Protocol used for the tags belonging to this topic: FINS Serial, FINS UDP, FINS TCP.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.7.3 Tag Name Convention IO Server configuration IO Server Name Topic Name FINS A B C Item Name ValueName, FINS Network, FINS Node, Hostlink or Ip Address ValueName If FINS Serial has been chosen at topic level, Hostlink value has to be defined. If FINS UDP or FINS TCP has been chosen at topic level, IP address has to be defined. Topic PLC Address is used.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.8 6.8.1 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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.8.3 Communication setup The AS511 link uses a RS-232 Current Loop functioning mode. The communication parameters are fixed to the following values: • 9600 Baud (Fixed) • Even Parity (Fixed) • 8 Data Bits (Fixed) • 1 Stop Bit (Fixed) • Full duplex no handshaking (Fixed) 6.8.3.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration • Bit access modifier: In any of the items above, it is possible to access a single bit. #x must be appended to the Tag name (Bit index goes from 0..31). The syntax can be used for reading bits and for writing them as well. Example: DB1W13#3 represents bit 3 of W13 in DB 1 REM: Bit index range depends on item referenced (for W, bit index maximum value is 15) NOTES: • For DB the smallest element is a WORD and we count addresses in Word.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.9 6.9.1 ABLOGIX IO Server Introduction ABLogix IO server is used to communicate with Allen Bradley Logix Series PLCs on the Ethernet link. With this IO Server, the eWON can poll ABLogix PLCs to read data. 6.9.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration You can define 3 topics to organize your polling strategy. Each Topic can be enabled/disabled separately, have a Poll Rate and are linked to a specific Device. • Poll rate: Is expressed in MilliSeconds and a default value of 2000 will be used if leaved empty. • Global Device Address: Have the following syntax: IP Address, Port, Link. • IP Address = address on your Ethernet network (i.e.: 10.0.0.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.10 EWON IO Server 6.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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration IO Server configuration Comment IO Server Name EWON Topic Name SYS Item Name SN_LO SN_HI Serial number, low part (see example of use below) Analog Serial number, high part (see example of use below) Analog Number of seconds since Power Up Analog GSM_REG GSM Status: 1: Home network 2: Searching registration 3: Registration denied 4: unknown registration 5: Roaming 100: Not applicable 101: Registration in progress usually: 1 or 5: m
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.10.2.2 Energy configuration with the LIx Tags The following parameters can be added to the eWON IO server in order to activate the energy support (enter Energy:1, validate and the other parameters will be automatically added): Parameter Default Value Energy 0 or 1 Enabled or not Debug 0 or 1 Not automaticaly added Once Energy is defined, the eWON will automatically add the other parameters with default value.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.10.2.2.1 ENERGY TAGS The following tags are available for energy management: LI1..LI8 Latched input ST1..ST4 When the Integration Period expires, the number of pulses counted during the integration period are logged in the corresponding LIx. Status variables: ST1 Latch time - 0x30000000 This is the absolute time when counter were latched. Expressed in seconds since 1/1/1970 minus 0x30000000 HEX (or 805306368 decimal).
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.10.2.3 Analog Input Value Range (eWON4002/eWON1002) 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. 6.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.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.10.2.3.2 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 63: Tag’s configuration: reading the tag value in mA If you need to convert in °C: temperature = AI * (-0.0394075) + 161.376.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.10.3 Setup The Energy IO Server is based on the eWON IO Server. The configuration consists in advanced parameters from this latter IO Server. The following screen shot shows the standard empty eWON IO Server configuration page. Figure 64: eWON IO server configuration page 6.10.3.1 Configuration of the counter pulse length Pulse length for counter can be configured on all eWON types.
-
eWON 500-2001-4001-4002 User Guide - IO Servers Configuration 6.11 MEM IO Server 6.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 user input or by a BASIC application.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface 7 eWON Monitoring Web Interface If you have configured the eWON with some Tag name, you can now come back on the eWON SCADA menu (Main Menu). The SCADA menu of the eWON looks like this: Figure 64: eWON SCADA 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 Scada.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface 7.1 Real-time screen Click on the View IO item from the SCADA 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 66: eWON real-time screen 7.1.1 Change Tag value As shown in the example above on the second 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 is available.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface 7.1.3 Real time graph If a real time recording is enabled for a Tag, a small icon will appear next to its name: This small icon is an hyperlink to show the graph picture. When the link is clicked, another window will open and after a small delay (about 3 seconds), a graph will be displayed: This graph displays the whole real time window logged.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface The user has then to select the correct time range for the Tag's selection and click on the Update link to obtain a historical trend. The common axis checkbox allows visualizing all Tag names on the same axis. If the scales are different, it is cleaner to display each curve with its own scale (by unchecking the Common Axis checkbox).
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface 7.3 Real-time Alarm screen Figure 70: eWON real-time alarm screen The real-time alarm page lists all Tag names currently in an alarm state. • The ‘Date’ tab displays the eWON date and hour at which 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.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface It is possible to define an alarm hint: Figure 71: eWON alarm notification: pre-defined hint This alarm hint can be useful to help the users that are allowed to take actions regarding the alarms.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface 7.4 Historical Alarm screen The historical alarm screen is used to find the alarms generated in the past and to know who acknowledged a specified alarm. All the alarms are stacked from the top to the bottom. The information given 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.
-
eWON 500-2001-4001-4002 User Guide - Monitoring Web Interface 7.
-
eWON 500-2001-4001-4002 User Guide - Retrieving data from eWON 8 Retrieving Data from eWON 8.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 you can download from the eWON web site (Support/Documentation/Technical notes on http://www.ewon.biz): • TN02: eWON files format • TN03: ircAll.bin format • TN12: var_lst.txt format File Name Type Description Events.
-
eWON 500-2001-4001-4002 User Guide - Retrieving data from eWON • Files ewonfwr.edf and config.bin are binary files and cannot be modify by users. The config.bin file is Read/Write to allow users to "copy/paste" configuration from one eWON to another. • The program.bas file is Read/Write; that’s allowing you to design your program offline with your text editor and to upload it to the eWON. • Remote.bas is not readable. When a remote.
-
eWON 500-2001-4001-4002 User Guide - Retrieving data from eWON Figure 74: eWON FTP site page 8.3.2 FTP session Using a common FTP session and using all standard FTP command, you can also easily retrieve data from the eWON. The main interest of this method is to automate the upload by a FTP scripting executed automatically. 8.3.3 Via eWON web site One of the Web pages available within the eWON web site is called Files Transfer. This page contains a table with a list of hyperlinks.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9 Programming the eWON 9.1 9.1.1 BASIC language definition Introduction The program of the eWON is based on syntax close to the BASIC, with many specific extensions. 9.1.2 Program flow IMPORTANT: • It is very important to understand how the eWON executes its program. • You should understand the difference between how the eWON stores the program and how it is executed.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON Figure 75: eWON cyclic section code If you download the corresponding program.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON As you can see, the code you have entered is present, but the eWON has added some remarks and labels in order to allow edition and to provide program flow control. For each section in the editor, the eWON has added an END statement at the end to prevent the program from continuing to the next section. The example also shows that any label is global to the whole program and should not be duplicated.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON There are a number of actions that can be programmed to occur upon event, like ONTIMER: TSET 1,10 ONTIMER 1,"goto MyLabel" Suppose you add the above lines in the INIT SECTION, it will start timer 1 with an interval of 10 seconds and program a "goto MyLabel" request when timer 1 ellapses. What actually happens when the ONTIMER occurs is that the eWON posts the "goto MyLabel" request in the BASIC queue.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON Queue pos Content Type … 3 FromWebVar = Var1! PRINT #0;TIME$ 2 goto MyLabel 1 goto ewon_cyclic_section CYCLIC_SECTION Table 89: BASIC Queue - 5 If a request in the queue contains more than 1 BASIC line, what actually happens is the following: • The block is appended to the end of the program as a temporary section: ewon_one_shot_section:: FromWebVar = Var1! PRINT #0;TIME$ END • The temporary label is called (goto ewon_one_shot_section).
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.1.5 Integer An integer is a number between -2147483648 and +2147483647. This number can be stored in an integer variable. When a parameter of integer type is specified for a function or a command and the variable past is of real type, the eWON automatically converts the real value to an integer value. When the expected value is of integer type and the past value is a character string, the eWON generates an error. 9.1.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.1.10 Type of Variables 9.1.10.1 Integer variable Syntax a% a is a letter from "a" to "z". The name of the variable is followed by the "%" letter to indicate that it is an integer variable. An integer variable can contain a number of type integer. 9.1.10.2 Real variable Syntax abcdef abcdef is the name of the variable that can contain up to 200 characters. Variable names are case insensitive: AbCdEf and ABCDEF represent the same variable.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.1.10.5 Real arrays When the DIM command is called, the array is created and replaces any existing array with the same name. To erase an array you can either use the CLEAR command that erases all variables, or bring back the dimension of the array to 1 element if you don’t want to clear everything but need to release memory. In order to assign a value, type a(x, y, z)=value.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2 List of the keywords The commands and functions used to program the eWON are listed below in alphabetical order. 9.2.1 Syntax convention In the following keyword usage description, the following convention is used to represent the parameters: Parameter E1,E2,.. Type Integer S1,S2,.. CA String Character (if string passed, first char is evaluated) Table 90: BASIC keywords syntax convention 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.5 ALSTAT Syntax [function] ALSTAT S1 • S1 is the name of the Tag or Tag TagId. Purpose: Returns the S1 Tag alarm status. The returned values are: Values Description 0 No alarm 1 Pretrigger: no active alarm but physical signal active 2 In alarm 3 In alarm but acknowledged 4 Returns to normal but not acknowledged Table 91: Values returned by the ALSTAT command Example: a% = ALSTAT "MyLittleTag" 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.7 ASCII Syntax [function] ASCII CA Purpose: The function returns the ASCII code of the first character of the chain CA. If the chain is empty, the function returns 0. Example: a% = ASCII "HOP" Returns the ASCII code of the character H See also: “CHR$” on page 133 9.2.8 BIN$ Syntax [function] BIN$ E1 Purpose: The function returns a string of 32 characters that represents the binary value of E1. It does not work on negative values.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.10 CFGSAVE Syntax [Command] CFGSAVE Purpose: Writes the eWON configuration to flash. This command is necessary after SETSYS command on SYS, TAG or USER records because using SETSYS will modify the configuration in memory. The modification will be effective as soon as the SETSYS XXX,"save" (where XXX stands for SYS, USER or TAG), but the config is not saved to the eWON flash file system. See also: “GETSYS, SETSYS” on page 141 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.14 CLS Syntax [Command] CLS Purpose: This command erases the virtual screen of the eWON, visible in the Script control page. See also: “PRINT - AT” on page 159 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.18 DOW Syntax [Function] DOW E1 / S1 • E1 is a date in integer format (number of seconds since 1/1/1970) • S1 is a date in String format ("18/09/2003 15:45:30") Purpose: This function returns an integer corresponding to the value of the day of the week (0--6; Sunday = 0) that matches a defined time variable. REM: Do not call the function with a float variable of value (or this would result to error "invalid parameter").
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.20 DYNDNS Syntax DYNDNS Purpose: The command has no parameter and asks a NO-IP dynamic PPP IP address update to the Dynamic DNS server you have set in the IP address publishing part from the Callback Configuration eWON page. It will be used to synchronize a Dynamic DNS server such as No-IP with the eWON PPP IP address. 9.2.21 END Syntax [Command] END Purpose: Indicates the end of the program.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.23 EOF Syntax [function] EOF E1 • E1 is the file number (1-4) Purpose: Returns 1 when end of file is reached. EOF always returns 1 for files opened for write. Example: PRINT "open file" OPEN "file:/usr/myfile.txt" FOR TEXT INPUT AS 1 ReadNext: IF EOF 1 THEN GOTO ReadDone A$ = GET 1 PRINT A$ GOTO ReadNext ReadDone: PRINT "close file" CLOSE 1 See also: “CLOSE” on page 133, “GET” on page 138, “OPEN” on page 154, “PUT” on page 160 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.25 FOR NEXT STEP Syntax FOR a% = E1 TO E2 STEP E3 NEXT a% • a% is an integer variable used as a counter. • E1, E2, E3 are integer values/variables Purpose: The instructions between the lines containing the FOR and the NEXT are executed until a% = E2. The loop is always executed at least 1 time, even if E1 is greater than E2. During first loop execution, a% equals E1. FOR and NEXT cannot be on the same line of program.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.26.2 /usr Syntax [function] – Text mode GET E1[, E2] • E1 is the file number (1-4) E2 optional: buffer size. When a data is read from the file, it must be read in a buffer to be interpreted. The buffer must be able to hold at least the whole item and the CRLF at the end of the line if the item is the last of the line.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.26.4 TCP/UDP Syntax [function] – Binary mode GET E1, E2 • E1 is the file number returned by OPEN. • E2: maximum number of bytes to read from the socket. Purpose: Returns a string with the data read from the TCP/UDP socket. If there are no data to read from the buffer the returned string is empty. If E1 is specified and the buffer contains more than E1 bytes, the function returns with E1 bytes.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.29 GETSYS, SETSYS The GetSys and SetSys function are used to set or get some special parameters of the eWON.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON PPPIP RW S/I This parameter returns the string corresponding to the current PPP IP address. When the eWON is offline, the value returned is "0.0.0.0". When the eWON is online the value returned is the dotted IP address allocated for the PPP connection The parameter can be written in order to disconnect the eWON. The only value accepted when writing in this parameter is 0 (setsys prg, "PPPIP", 0) TRFWD RW S Transparent forwarding IP address.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON • A block must be loaded for edition with the SETSYS command and a special field called "load". According to the source, this block will be either the eWON system configuration, the eWON COM configuration, or one Tag configuration, or one user configuration. • Then each field of this configuration can be accessed by the GETSYS or SETSYS commands. This edition works on the record loaded values but does not actually affect the configuration.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.30 GO Syntax [Command] GO Purpose: Start program execution (RUN). This is equivalent to clicking RUN in the script control window. This command is mainly useful for remote eWON operation through the use of REMOTE.BAS FTP transfer. See also: “HALT” on page 145), (“REBOOT” on page 161) 9.2.31 GOSUB RETURN Syntax GOSUB Label Label:Expression RETURN Purpose: When the GOSUB line is executed, the program continues at "Label" line.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.33 HALT Syntax [Command] HALT Purpose: Stops program execution. This is equivalent to clicking STOP’ in the script control window. This command is mainly useful for remote eWON operation through the use of REMOTE.BAS FTP transfer. See also: “GO” on page 144, “REBOOT” on page 161 9.2.34 HEX$ Syntax [function] HEX$ E1 Purpose: The function returns a chain of 8 characters that represents the hexadecimal value of the E1 number.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.36 INSTR Syntax [Function] INSTR I1,S1,S2 • I1 is the index in the string to search (valid value goes from 1 to LEN S1) • S1 is the string to be search for S2 • S2 is the string to search for in S1 Purpose: The function returns an integer equal to the position of string S2 in string S1. The returned index is 0 based. If string S2 is not contained in S1, the function returns 0. The I1 parameter should be 1 to search the whole S1 string.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.39 IORCV Syntax [function] IORCV S1 or IORCV S1, I1 • S1 is the STRING IOServerName • I1 is an additional parameter (= 0 OR = 1 OR = -1) Purpose: Function for reading IO server response to an IOSEND request. • First case: • a% in examples below represents the Request number returned by IOSEND. • a% is the result of the IOSEND command.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.40 IOSEND Syntax [function] IOSEND S1, S2, S3 Purpose: Sends a request by using the IO server's protocol. Parameters are: • STRING IOServerName: IO Server name as it appears in the Tag configuration page • STRING Address: Slave address as described in the eWON User manual for each IO server section • STRING IoCommand: Array of bytes with a protocol command, the content depends on the IO server.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.42 LOGEVENT Syntax [command] LOGEVENT S1 [,S2] • S1 is the phrase to log • S2 is the type of logging. This parameter is optional and can take the following ranges of values: Range of values Description 0 .. 99 Error -99 .. -1 Warning 100 .. 199 Trace Table 96: LOGEVENT - ranges of values If the logging level is not specified, it is considered to be an error. Purpose: Appends an event to the log file.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.45 MOD Syntax [Operator] E1 MOD E2 Purpose: Compute the remainder of the division of E1 by E2 Example: 1 MOD 2 REM returns 1 2 MOD 2 REM returns 0 See also: “Operators priority” on page 127 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.49 ONxxxxxx There are some ONxxxxxx commands listed below. These commands are used to register a BASIC action to perform in case of special conditions. For every ONxxxxx command, the action to execute is a string that is used as a BASIC command line. When the condition occurs, the command is queued in an execution queue and is executed when its turn comes.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.51 ONCHANGE Syntax [command] ONCHANGE S1,S2 • S1 is the Tag name to scan for value change • S2 is the command line to execute in case of value change. Purpose: Executes S2 command line when the value of Tag with Tag name given by S1 changes. The EVTINFO parameter (see GETSYS page 141) is set to the Tag id when command is called. Example: ONCHANGE "MyTag","goto MyTagChange" See also: “GETSYS, SETSYS” on page 141, “ONxxxxxx” on page 151 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.54 ONSMS Syntax [command] ONSMS S1 • S1 is the command line to execute when eWON receives a SMS. Purpose: A typical use of the ONSMS syntax is allowing eWON to send a read SMS receipt to the SMS sender.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.56 ONTIMER Syntax [command] ONTIMER E1,S1 • E1 is the timer number (see TSET page 167) • S1 is the command line to execute when timer expires. Purpose: Executes S1 command line when E1 expires. The EVTINFO parameter (see GETSYS page 141) is set to the timer number when command is called. Example: ONTIMER 1,"goto Timer1" ONTIMER 1, "LOGIO ‘mytag’ " See also: “GETSYS, SETSYS” on page 141, “ONxxxxxx” on page 151, “TSET” on page 167 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.57.3 Different File/stream types 9.2.57.3.1 FILE open /usr Syntax [command] OPEN S1 FOR BINARY|TEXT INPUT|OUTPUT|APPEND AS E1 E1 is the file number. After the OPEN operation, the file is referenced by its file number and not by its file name. There are 8 file numbers available. Once a file number is assigned to a file, it is allocated to that file, until the CLOSE command is issued.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON In order to know if the connection is established, the user has 2 options: • Check the scheduled action status by checking the PRG,ACTIONSTAT (See GETSYS, SETSYS on page 141). • Read the file with GET: as long as the file is not actually opened, the function returns #CLOSED#. When the function stops sending #CLOSED# the file can be read and written for socket operations. Example: Example Comment OPEN "tcp:10.0.0.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.57.3.4 EXP export bloc descriptor open Syntax [command] OPEN S1 FOR TEXT|BINARY INPUT AS E1 Note: This command works only with INPUT S1 will be as follows: "exp:XXXXX", where XXXXX is an Export Block Descriptor. E1 is the file number. After the OPEN operation, the file is referenced by its file number and not by its file name. There are 8 file numbers available.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.58 OR Syntax [Operator] E1 OR E2 Purpose: Does a bit-by-bit OR between the 2 integers E1 and E2. WARNINGS: • When executed on float elements (float constant or float variable), the OR functions returns the logical OR operation.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.60 PRINT - AT Syntax [Command] PRINT CA This command displays the text CA followed by a new line. PRINT CA; This command displays the text CA without a new line. PRINT AT E1, E2 CA This command displays the text CA at the E1 column and at the E2 line. PRINT CA1;CA2[;CA3...] Display the CA1, CA2 text etc. one following the other (don't pass to next line).
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.62 PUT The put command works completely differently if the file is opened in Binary mode or in Text mode. The file must be opened for OUTPUT or for APPEND operation (APPEND for /usr files only). • COM, TCP-UDP, /usr The file syntax has been extended in version 3 of the eWON to allow access to the serial port and to TCP and UDP socket.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.62.3 COM Syntax[Command] – Binary mode PUT 1, S1 • S1: string of data to write to serial port. Purpose: Writes the S1 string to the serial port. The function returns only after all the data have been actually sent. Warnings: • The string can contain any byte by using the CHR$ function. • Serial port cannot be used by an IO server in the same time, or it would result to a “IO Error”. 9.2.62.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.65 REM Syntax [command] REM free text Purpose: This command enables the insertion of a line of comment in the program. The interpreter does not consider the line. Example: PRINT a% REM we can put whatever comment we want here a%=2: REM Set a% to 2 9.2.66 RTRIM Syntax[Command] RTRIM S1 • S1 is a copy of a string. Purpose: RTRIM returns a copy of a string with the rightmost spaces removed.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON If instead of putting [EXPORT_BLOCK_DESCRIPTOR] you put &[EXPORT_BLOCK_DESCRIPTOR], then the same data is attached to the Email. The position in the S4 field where the &[..] is placed does not matter, the attachment &[…] descriptor will NOT appear in the content itself, but will produce the given attachment.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.69 SENDTRAP Syntax[command] SENDTRAP I1,S1 • I1 is the first trap parameter (INTEGER) • S1 is the second trap parameter (STRING) Purpose: This command posts a scheduled action request for an SNMP TRAP generation. The first parameter is sent on OID .1.3.6.1.4.1.8284.2.1.4.2 The second parameter is sent in OID .1.3.6.1.4.1.8284.2.1.4.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.70 SETIO Syntax [command] SETIO S1, F1 • S1 is the name of the Tag or Tag TagId. • F1 is the value to give to the Tag. Purpose: Modifies the value of a Tag. The Tag must be writable (not for the read-only Tags). Note: In many cases this function is efficiently replaced by the TagName@ syntax. For example SETIO "MyTag", 10.2 is equivalent to MyTag@=10.2 Example: SETIO "MYTAG", 10.123 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.73 SQRT Syntax [function] SQRT F1 Purpose: Returns the square root of F1. Example: SQRT 16 :REM returns 4 9.2.74 STR$ Syntax [function] STR$ F1/E1 Purpose: The function returns the character string related to an E1 or F1 number. Example: a%=48 a$= STR$ a% REM A$ is worth " 48 " after this affectation See also: “VAL” on page 168 9.2.75 TIME$ Syntax[function] TIME$ Purpose: Returns the string with the current date and time.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.76 TGET Syntax[function] TGET E1 • E1 is the number of the timer (1 to 4). Purpose: Returns N (>0) if the timer expires and then resets the value (N is the number of times the timer has expired) TGET returns. Returns '0' if the timer did not expired since the last call to TGET. Example: REM timer 1 minute TSET 1,60 Label1: IF NOT TGET 1 GOTO LABEL1 See also: “ONTIMER” on page 154, “TSET” on page 167. 9.2.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.2.78 VAL Syntax [function] VAL S1 Purpose: The function evaluates the character string and returns the corresponding expression. Note: VAL is a function that usually takes an expression and returns a Real after expression evaluation. This VAL function can also evaluate an expression that returns a string.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.3 Debug a BASIC program To debug your basic program, you can use the "Script control" screen of the "Script setup" page that is described in chapter “The Script control link” on page 72. 9.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.5 Configuration Fields This section describes the fields found in the config.txt file. All the fields are readable and writable using GETSYS and SETSYS(unless otherwise specified). The file is separated in the several sections (System, UserList and TagList). One of the three sections must first be loaded with the "SETSYS SYS, xxx" command, where xxx is one of SYS, USER or TAG.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON 9.5.1 SYS Config The following table describes the fields accessible from the system configuration. The last column gives the ewon configuration web page where the parameter appears. The web pages are found under Configuration.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON MbsSIP(x) x=1..3, Modbus Topic x IP address IO Server Config Æ Modbus FtpServerPort FTP Server port System Setup/General/General FtpServerAddr FTP server address System Setup/General/General FtpUserName FTP login name System Setup/General/General FtpPassword FTP password System Setup/General/General x=1..3, Modbus Topic x enabled (1 if enabled, 0 otherwise) IO Server Config Æ Modbus SnmpCom(x) x=1..
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON The following table describes the fields accessible from the communication configuration. The last column gives the ewon configuration web page where the parameter appears. The web pages are found under System Setup.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON CBDelay Delay after rings before callback (in seconds) Communication/Callback CBIdleTime Callback mode idle timeout before hang up Communication/Callback CBPubEMail Email address where to send the IP address when callback Communication/Callback CBDDnsType Dynamic DNS Type Communication/Callback Dynamic DNS User Name Communication/Callback Dynamic DNS Password Communication/Callback CBDDnsHName Dynamic DNS Host Name Communication/Ca
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON ***Modem type can be found in the eWON Information page you open by clicking on the eWON Logo. In the above case: “Internal BIBAND GSM (131)” ** The following table describes the SSAM possible values: Description Value The last server that worked will be used for next call -1 Return to first 0 (default) Always use server 1 1 Always use server 2 2 Table 106: SSAM values 9.5.
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON MbsTcpFloat Consider as float value (2 subsequent registers) SnmpEnabled Enable SNMP (enabled = 1) RTLogEnabled Enable real time logging (enabled = 1) AlAutoAck Enable alarm auto-acknowledging (enabled = 1) ForceRO Force read-only Tag SnmpOID SNMP OID AlHint Alarm hint AlHigh Alarm high level (warning level) AlLow Alarm low level (warning level) AlTimeDB Alarm interval deadband AlLevelDB Alarm level deadband PageId Page the Ta
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON TSU Trap (SNMP) subject alarm notification config FEN* Enable FTP alarm notification config FFN FTP destination file name alarm notification config FCO FTP file content (as Export Block Descriptor) alarm notification config Alarm status (0 = no alarm, 1 = in alarm) View IO page ChangeTime Last change time View IO page TagValue Tag current value View IO page DoDelete Delete the Tag (0 = do not delete, 1 = delete) AlStat DoAck D
-
eWON 500-2001-4001-4002 User Guide - Programming the eWON Let’s the MM1 Tag is in alarm state. It is then possible to acknowledge its alarm with the following command SETSYS TAG, "LOAD", "MM1" SETSYS TAG, "DoAck", 1 SETSYS TAG, "SAVE" It is possible to delete a Tag with: SETSYS TAG, "LOAD", "MM1" SETSYS TAG, "DoDelete", 1 SETSYS TAG, "SAVE" 9.5.4 User Section This section describes the configuration fields for a single user.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10 User defined Web Site 10.1 Introduction The eWON can host a web site containing user define web pages. The hosting management can be done like for common web site using the eWON FTP server. When connecting to the eWON FTP server, the root directory contains a /usr directory. The pages from the custom Web site can be located in that directory or in subdirectories of /usr. A file /usr/index.htm Will be accessed using http://10.0.0.53/usr/index.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.2.2.1 TagSSI HTML Tag The TagSSI is used to insert the current value of a Tag into the page: <%#TagSSI,TagName%> TagName is the name of the Tag that must be inserted. Notes: • Do not insert any space in the TagSSI: • TagSSI is case sensistive: <%#TagSSI,TagName%> Below is the example of an user webpage named “TEMP_page.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.2.2.2 ParamSSI HTML Tag The ParamSSI is used to insert the content of an export block into the page (See also chapter “Export Block Descriptor” on page 192) <%#ParamSSI,Parameter%> "Parameter" follows the "Export Block Descriptor" syntax described in this manual. The resulting output is directly inserted into the HTML page returned. This format is useful to return HTML Tables into the page or return Script expression ($dtSE) into the page.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.2.3 VarSSI HTML Tag See: “Web context variable directly inserted with SSI” on page 184" 10.2.4 ExeSSI HTML Tag See: “Building page content by using bASP” on page 182" 10.3 bASP Syntax The bASP allows to insert BASIC blocks in the WEB page in order to build the page on the fly while the page is transmitted to the client's web browser.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site • PRINT #0,xxx is an extended syntax of the PRINT command that will route printed data to the client WEB page. As for the common PRINT command, if the sequence of data to print does not ends with a ";", a
is added to the data to force a new line. • The execution of the blocks occurs as the page is sent to the user. The blocks nearer from the top of page are executed first.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site In this example we print the 2 parameters to the WEB client. The resulting output would be (for the request above):
SSI Demo Param1:1234
Param2:ABCD
10.3.2.2 Web context variable directly inserted with SSI There is another syntax for inserting Web context variables in the client web page.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.3.2.3 Improving WEB performance using Web context variables and bASP The example above introduces how the WEB performance can be improved.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.3.2.4 Using Web context variables with FORMS The Web context variables provide the easiest way to use FORM fields when the FORM is posted. As described below, there is a special form call ExeScriptForm that allows to request execution of a script command. Example:
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.4.1.1 Examples • Single Tag update
This example shows how to update one Tag called “Pressure”. There is one hidden form field for the Tag name and its value is "Pressure" which is the name of the Tag to update.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.4.1.2 Acknowledge Tags alarms The same FORM can be used to acknowledge a Tag alarm; the syntax is exactly the same as for Tag update, the only difference if for the content of the TagValue. For Tag alarm acknowledgement, the TagValue field will contain the keyword "ack" optionally followed by the ",UserName" who will be logged in alarm history.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.4.3 Execute an eWON script The purpose of this form is to execute an eWON script command line by posting a FORM from the web server. Using this feature, you can have a button in the Web page that starts execution of a script section. The form allows executing a sequence of one or more script commands. Each command is executed as if it was typed and executed from the Script Control window.
-
eWON 500-2001-4001-4002 User Guide - User defined Web site 10.4.3.2 Examples • Single command execution:
Note: Please note the use of the (a$=’close’) single quote instead of the common a$="close" syntax that would conflict with the HTML quotes. • Single command execution with no-default result page
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.2 Export fields syntax definition The syntax for the different fields is defined in the following chapters. 11.2.1 $dt [Data Type] The $dt field defines what data to export from the eWON.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.2.2 $ft [Format] The $ft field defines how to format the data exported. The following formats are available: $ft Parameter Format description B Binary G Graph T Text H HTML Table Table 112: $ft parameters description • Binary: the data are sent in a raw binary format, not modified by the export module.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.2.3 $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 196). 11.2.3.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.2.3.3 $st , $et with Last time By adding the $ut command in an Export Block Descriptor, you can ask the eWON to memorize the time of the last point exported, this time can be used for the next export. The last time is reset when the eWON boots. Syntax: $stL L is the time parameter meaning last time. 11.2.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.2.5 $tn [Tag Name] This field is used to specify a Tag name. It is required for graph commands. The parameter specified is the name of the Tag. When a $tn field can be specified for an export and no $tn is given, then the command is executed for ALL Tags. Example: $tnMyTag (MyTag is the name of the Tag) 11.2.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.1 $dtHL [Historical Logging] 11.3.1.1 Export content The Historical logging outputs the data from the File system for ONE or ALL fields. The output format can be TEXT, HTML Table or BINARY. The GRAPH format is also available IF only ONE Tag is specified. A time range can also be specified for this export. 11.3.1.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.1.4 Special parameters and fields $st $et If Last time is specified: ($stL or $etL): there is a last time logged for each Tag plus a last time logged for all Tags. If you specify a given Tag, its own last time will be used, if a specific Tag is not requested, the export is performed for all Tag (concerned by historical logging) and another last time memory is used.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.2 $dtRL [Real time Logging] 11.3.2.1 Export content 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. 11.3.2.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.2.3 Fields used Fields Value if not specified Mandatory $dt $tn Optional $ft Binary $st 01/01/1970 $et 31/12/2030 $ut No time update $fn Export block descriptor $ct Compression type Table 120: $dtRL - fields used 11.3.2.4 Special parameters and fields $st $et If the output format is "graph", $et_0 should be used instead of default value because otherwise the graph spans up to 31/12/2030.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.3 $dtAH [Alarm History] 11.3.3.1 Export content The Alarm History outputs the data from the File system for ONE or ALL Tags. The output format can be TEXT or HTML Table. A time range can also be specified for this export. 11.3.3.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.3.4 Special parameters and fields $ft Acceptable values Text HTML Table 124: [$dtAH] $ft - acceptable values Text format will output a comma-separated file. The separator is ‘;’ to avoid confusion with decimal point. If all Tags are output they will be output in a chronological order in the file.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.4 $dtAR [Alarm Real time] 11.3.4.1 Export content The Alarm Real time outputs the real time data for ONE or ALL of 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). 11.3.4.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.5 $dtEV [EVent file] 11.3.5.1 Export content The Event file outputs the data from the File system. The output format can be TEXT or HTML Table. A time range can also be specified for this export. 11.3.5.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.5.4 Special parameters and fields $ft Acceptable values Text HTML Table 130: [$dtEV] $ft - acceptable values Text format will output a comma-separated file. The separator is ‘;’ to avoid confusion with decimal point.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.6 $dtSS [Scheduled Status] 11.3.6.1 Export content 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 sequential execution.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.7 $dtSE [Script Expression] 11.3.7.1 Export content 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. 11.3.7.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.8 $dtUF [User File] 11.3.8.1 Export content 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. 11.3.8.2 Detailed Example $dtUF $fn/ufdir/uf1.txt 11.3.8.3 $dtUF User file $fn/ufdir/uf1.txt Will export the uf1.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.8.3.1 $fn [File Name] This field is used for specifying a file name to the export data. Usually this file name is used to specify the output of the data, for example when sending an attachment to an Email. In this case, the $fn file name gives the name of the attachment: When doing a PUTFTP, then $fn does not need to be specified, because the PUTFTP command manages the name of the destination file: PUTFTP "MyFileWithANewName.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors The complete path can also be specified: • Syntax 1: /usr/myfile.txt (myfile.txt is in the /usr directory) • Syntax 2: /usr/mydir/myfile.txt (myfile.txt is in the /usr/mydir subdirectory) Note: The first "/" is mandatory. Example: Putftp "/test.txt","[$dtUF $uf/myfile.txt]" 11.3.8.3.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.9 $dtIV [Instant Values] 11.3.10 Instant value - general information Instant value means values of Tags at a given time.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.10.
-
eWON 500-2001-4001-4002 User 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://ww
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.11 $dtSV 11.3.11.1 Export content $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. 11.3.11.2 Detailed Example sendmail "user@user.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.12 $dtPP 11.3.12.1 Export content $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. 11.3.12.2 Detailed Example sendmail "user@user.be","","eWON PPP dump","&[$dtPP$fndump.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.13 $dtES 11.3.13.1 Export content $dtES exports the estat.htm file : the file that lists the current status from the main eWON features. The output format can be TEXT or HTML. 11.3.13.2 Detailed Example sendmail "user@user.be","","eWON estat file","&[$dtES$ftH$fnestat.
-
eWON 500-2001-4001-4002 User Guide - Export Block Descriptors 11.3.14 $dtSC 11.3.14.1 Export content $dtSC exports the communications configuration file (comcfg.txt): the file that lists the current status from the main eWON communication features. The output format can be TEXT or HTML. 11.3.14.2 Detailed Example sendmail "user@user.be","","eWON COM config file","&[$dtSC$ftH$fncomcfg.
-
eWON 500-2001-4001-4002 User Guide - Upgrading the eWON firmware 12 Upgrading the eWON firmware 12.1 Purpose There are two ways to upgrade the eWON firmware: by using eBuddy, the ACT’L utility designed to set up the eWON, or by directly uploading a new firmware on the eWON by means of a FTP client. 12.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.
-
eWON 500-2001-4001-4002 User 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.
-
eWON 500-2001-4001-4002 User Guide - Upgrading the eWON firmware Click on the Finish Button when the upgrade is complete and exit from the Wizard.
-
eWON 500-2001-4001-4002 User Guide - Upgrading the eWON firmware 12.3 Upgrading the eWON firmware by a direct upload You can easily upgrade the eWON firmware using the SmartFTP tool available on our Web site http://www.ewon.biz. To upgrade the eWON firmware, please follow the following instructions: • Start the SmartFTP program. • Type in the eWON IP address in the "URL" field, the user name in the "Login" field and the user password in the "Password" field.
-
eWON 500-2001-4001-4002 User 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 77: 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.
-
eWON 500-2001-4001-4002 User Guide - Upgrading the eWON firmware • Click on the “Disconnect” icon to exit the connection to the eWON and quit the SmartFTP program. WARNING: When you click on the “Disconnect” icon, the eWON begins a flash memory programming operation (about one minute long). Do NOT remove the power from the eWON during this operation. If you have a look at the eWON STATUS led, it will be blinking about once a second. When it finishes blinking, the eWON will reboot.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13 Appendix 13.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.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.3 Tips for Internet setup 13.3.1 Finding the IP address of a given host The eWON does not provide DNS (Domain Name Server) resolution. It means that the usual way to reference nodes on Internet, which is "by name", will not work with the eWON. Instead you have to specify the IP address of the destination node. In order to find the address corresponding to a given name, you can use the ping –a NodeName command.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.5 Resetting the eWON 13.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.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.5.3 Second level initialization diagnostics When the second level initialization is requested, the eWON will also perform a self test. When the initialization ends, the test result is displayed via the "USER" led. If the test is successful, the following pattern will be displayed on the led. The led will flash for 200msec every 1.5 seconds. The pattern is repeated indefinitely until the eWON is manually rebooted (Power OFF/Power ON).
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.6 The eWON firmware upgrade process 13.6.1 Overview of the upgrade process Very important notes: Applying a new firmware on the eWON requires following a very precise process that is described in chapter “eWON firmware upgrade step-by-step” on page 231. Please do not attempt to upgrade your eWON prior reading this chapter if you are not so familiar with this process, otherwise you could severely damage your eWON. Versions 4.
-
eWON 500-2001-4001-4002 User Guide - Appendix Figure 81: eWON information page eWON 500®2001®4001®4002® Version 4_3_0 - User Guide - 10/5/05 - ©ACT'L sa - Page 230
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.6.2 eWON firmware upgrade step-by-step 13.6.2.1 Upgrading from version 3 to version 4 Firmwares versions 3 and 4 are very different, that is the reason why the flash action erases all of the existing files from the eWON (configuration and user files), and the eWON IP address too.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.6.2.3 Monitoring of eWON's behavior during the flashing operation You are able to monitor the eWON behavior during flashing operation, by observing the USER led that is located at the top right of the led panel from the eWON.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.
-
eWON 500-2001-4001-4002 User Guide - Appendix 13.9 TCP/IP Bootstrap Protocol (BOOTP) Since firmware 4.3, eWON is BootP manageable. You can force eWON to ask its IP address to a BootP Server. To correctly set the IP mask and the Gateway, your BootP server must comply with the RFC-1048. Figure 83: Ethernet Setup Page At each startup, eWON will receive its IP address from the Server. eWON will wait for the server unless it is not present.
