Metz Connect EWIO 2 User Manual Download Page 93

Page: 93 / 96

EWIO

User Manual

V 1.1 | Stand 10/2020

Seite 93 von 96

METZ CONNECT GmbH | Im Tal 2 | 78176 Blumberg | Germany
Tel. +49 7702 533-0 | Fax +49 7702 533-433
For additional documentations look at www.metz-connect.com

12.

API – Programming interface

The communication between EWIO

and the web interface is done via HTTP on TCP/IP.

The data of the application layer, which are transferred, can also be operated by other

applications than a web browser.
In addition, general functions (like for SQL commands) are available to enable additional

functionality.
Details can be taken from the separate document "EWIO

API.pdf", which can be found at

www.metz-connect.com.

Summary of Contents for EWIO 2

Page 1: ...er Manual V 1 1 Stand 10 2020 Seite 1 von 96 METZ CONNECT GmbH Im Tal 2 78176 Blumberg Germany Tel 49 7702 533 0 Fax 49 7702 533 433 For additional documentations look at www metz connect com EWIO2 User Manual ...

Page 2: ...device 8 2 1 Controller unit 9 2 2 In and outputs 9 2 3 Housing and terminals 10 2 4 Indication 10 2 5 Communication interfaces 11 2 6 Communication protocols and languages 11 3 Scope of delivery and incoming inspection 12 3 1 Scope of delivery basic unit 12 3 2 Available accessories 12 3 3 Incoming inspection 13 4 Installation 14 4 1 Installation location and state 14 4 2 Elektronic block 14 4 3 ...

Page 3: ...rating elements 25 6 1 Manual operating 25 7 Availability of the EWIO2 via LAN und WLAN 26 7 1 MAC address and Device Host name 26 7 2 LAN connection 26 7 3 WLAN connection 27 7 4 BACnet Server 27 7 5 Modbus Server 27 8 Browser 28 9 Reset to factory settings 29 10 Web Interface 31 10 1 Responsive Web design 31 10 2 Operation 31 10 3 Wizard setup 33 10 4 Authorization levels and login 36 10 5 Menu ...

Page 4: ...w 66 10 5 6 2 New counter 73 10 5 6 3 Measurements 76 10 5 6 4 Modbus settings counter 78 10 5 6 5 Synchronous pulse 79 10 5 7 Data server 79 10 5 7 1 CSV Format 79 10 5 7 2 Settings 81 10 5 8 Logout 82 11 Access the IOs from the command line or via script application 83 11 1 Calling conventions 83 11 2 Rückgabewerte 84 11 3 Examples 84 11 3 1 Set an analog value for an analog output 84 11 3 2 Set...

Page 5: ...ns look at www metz connect com 11 4 1 1 Generate the SSH keys 86 11 4 1 2 Deploy the public key 87 11 4 1 3 Test the ssh connection 88 11 4 2 Remote call 88 11 5 Usage of aliases 88 11 6 Shell Script example measuring and control 89 11 7 Sensor IDs for the analog inputs and their meaning 90 12 API Programming interface 93 13 Creating a template for Modbus counters 94 ...

Page 6: ...ins information on the use and installation of the device If you have any questions that cannot be answered with the help of this manual please contact the supplier or manufacturer for further information The stated installation and assembly regulations and guidelines apply to the Federal Republic of Germany If the device is used abroad the national regulations must be observed at the sole respons...

Page 7: ... of the instructions for use and installation The user must ensure that the device is not operated outside the specified technical parameters Any unauthorized alteration or modification of the device as well as any repairs carried out by the user on his own authority shall constitute misuse and or negligence within the meaning of the warranty for the product and shall therefore exclude the warrant...

Page 8: ...he functional range of the EWIO2 for storing settings data and applications The EWIO2 M variant M for metering focuses on energy consumption recording and energy monitoring in buildings on machines plants and systems These variants have a powerful data logger based on an SQLite database and a M eter Bus interface The M Bus and Modbus RTU interfaces allow the reading of different meters for electri...

Page 9: ...itchable digital 24 Volt outputs with current carrying capacity of up to 20 mA DC per output 3 analogue inputs Configurable for 0 10 Volt DC voltage measurement Resistance measurement in the range from 40 Ohm to 4 Megaohm or Temperature measurement 17 different sensor types can be selected 0 20mA DC current measurement 3 analog outputs with manual operation with 0 10 Volt DC with a current carryin...

Page 10: ...s from 0 33 to 2 5 mm or AWG 22 to 12 Laying out The diameter of the cores can range from 0 3 to a maximum of 2 7 mm 2 4 Indication The operation indicator which can also be seen when the flap is closed lights up green in normal operation During the boot process after a device reset or after a power recovery it lights up red It also glows red when a software service is not running The indicator fl...

Page 11: ...s interface Only for the EWIO2 W variants are available 1 WLAN interface 802 11 bgn Connection to EWIO2 W RP SMA socket male Connection of the antenna RP SMA plug female See picture 2 6 Communication protocols and languages Protocols For the EWIO2 and EWIO2 M variants are available Transmission Control Internet Protocol TCP IP Network communication Dynamic Host Configuration Protocol DHCP Network ...

Page 12: ...WIO2 M 110935 EWIO2 M BM 110931 EWIO2 MW 110934 EWIO2 MW BM Jumper plug for I O components Terminal block for I O components Mounting instruction Only for the EWIO2 W variants WLAN antenna 3 2 Available accessories Power supply 110561 Power supply NG4 Expansion modules 11083013 MR TO4 Modbus RTU 1108311319 MR DI10 Modbus RTU 11083213 MR AI8 Modbus RTU 1108331326 MR DIO4 2 Modbus RTU 1108341319 MR ...

Page 13: ... to packaging Completeness of the package contents Visible external damage to the device If one or more of the above mentioned cases should occur please contact your METZ CONNECT sales partner Warning Damaged devices may neither be installed nor put into operation They can lead to death serious physical injury or damage to property It is to be assumed that safe operation is no longer possible if t...

Page 14: ...and operation inside enclosed rooms in electrical distribution boards and suitable control panels The EWIO2 is designed for mounting on TH35 mounting rails in accordance with IEC 60715 It can be installed in any position Horizontal installation is recommended It is possible to add them to other control cabinet components without spacing 4 2 Elektronic block In case of service the EWIO2 may have to...

Page 15: ...th this IP address if the MAC address is exchanged in the DHCP server 4 3 MicroSD card The EWIO2 has an integrated MicroSD memory card that can be expanded up to a maximum of 32 GB It is used to store device configurations data and applications After the electronic block has been replaced it can be made available again in the new device Access to the MicroSD card is only possible after removing th...

Page 16: ...ust be ensured that the EWIO2 has been taken out of operation and that all supply lines are de energised Once all supply lines have been removed use a slotted screwdriver to move the bolt on the EWIO2 outwards and remove the device from the mounting rail After use the EWIO2 must be disposed of as electronic scrap in accordance with the WEEE Directive and the laws in force in the respective country...

Page 17: ...d out by qualified personnel in compliance with VDE regulations and local regulations The correct connection must be checked before commissioning Incorrect connection can destroy the EWIO2 5 1 Power supply The operating voltage of the EWIO2 is 24 Volt DC 10 SELV The current consumption is for EWIO2 at maximum 350 mA for EWIO2 M at maximum 500 mA The easiest way to supply voltage ist o use the powe...

Page 18: ...3 For additional documentations look at www metz connect com Power can also be supplied directly via the power supply terminals 24V 0V 5 2 Ethernet interface The EWIO2 has a switch module with two Ethernet ports This makes it possible to build a network in daisy chain topology The EWIO2 is connected to the network via standard patch cables ...

Page 19: ... from live cables so that the measured values are not affected 5 3 1 Relay The terminals of the respective relay outputs have the following meanings the common connections COM with 11 21 31 41 51 61 the normally closed contacts NC 12 22 32 42 52 62 and the normally open contacts NO 14 24 34 44 54 64 They can be switched individually and can carry up to 6 A resistive load 5 3 2 TRIAC Only for the E...

Page 20: ... The respective minus terminals are electrically connected to the terminals oV and GND Inputs 5 to 8 are electrically isolated from the device and require external voltage 5 3 4 Digital outputs The terminals of the respective digital outputs are called D1 to D4 The outputs are internally supplied with 24 volts They are individually switchable and can be loaded up to 20 mA Wiring example 5 3 5 Anal...

Page 21: ...th 0 10 Volt 0 20 mA or resistance sensors in the range of 40 Ohm to 4 Megaohm can be measured The changeover of voltage resistance measurement and current measurement is done Hardware side by means of the red dip switches on the bottom right Wiring examples On the software side each input can be individually configured to measure voltage current two wire resistance or semiconductor temperature se...

Page 22: ...ng Examples 5 4 RS485 Fieldbus Interface The terminals of the RS485 fieldbus interface are called B and A B indicates the non inverted bus line and A indicates the inverted bus line The interface is electrically isolated The interface is equipped with failsafe bias resistors Note Bus cables including shielded ones must be laid at a sufficient distance from live cables so that the signals are not a...

Page 23: ...lled B and A and are located to the left and right of the flap B indicates the non inverted bus line and A indicates the inverted bus line The interface is electrically isolated Die Schnittstelle ist mit Failsafe Bias Widerständen ausgestattet A maximum of 6 expansion modules of the MR xxx series can be connected to the EWIO2 via jumper plug The jumper plug connects supply voltage and bus to the e...

Page 24: ...minals of the M Bus interface are called M and M and are located at the top right The interface is electrically isolated The bus topology and the polarity of the bus lines are arbitrary The EWIO2 M supplies the M Bus with power The power of the integrated level converter is designed for 80 bus loads of 1 5 mA each 5 7 USB interface The EWIO2 has a USB A socket It is located under the flap It is us...

Page 25: ...variants T1 to T3 are assigned to relays 1 to 3 T4 and T5 to TRIAC 1 and 2 and T6 to T8 to relays 4 to 6 In the data logger versions the buttons T1 to T4 are assigned to relays 1 to 4 and the buttons T5 to T8 are assigned to digital outputs D1 to D4 Long keystroke greater than 1 second switches between manual and automatic operation of the corresponding output Manual operation is indicated by a gr...

Page 26: ...ed in the network settings on the Web page 7 2 LAN connection The EWIO2 has DHCP enabled by default The default network configuration is automatically set if no active DHCP server is found When resetting the IP configuration to factory default chapter 9 and 10 5 2 13 IP adddress 192 168 0 111 Subnetmask 255 255 255 0 Standard Gateway 192 168 0 1 DNS Server 192 168 0 2 This configuration can be cha...

Page 27: ...gue I Os and the I Os of any connected expansion modules can be queried and controlled via BACnet IP In addition values can be read from the database via BACnet TrendLog objects Details can be found in the separate document EWIO2 BACnet Server PICS pdf available at www metz connect com 7 5 Modbus Server The EWIO2 variants BM have a Modbus server that uses the network protocol Modbus TCP which is b...

Page 28: ...ith the following browsers Google Chrome Version 84 0 Firefox Version 79 0 Microsoft Edge Version 44 17763 831 0 Apple Safari Version 13 6 It is recommended to use one of the browsers in a current version With other especially older browsers the functionality cannot be guaranteed As the page content is dynamically changed by the EWIO2 they must not be kept in the browser cache Otherwise updates to...

Page 29: ...Resetting the IP configuration to factory settings 1 Power off the unit or disconnect it from the power supply 2 Remove the transparent upper part of the housing including the flap 3 Place the jumper on the middle pins 2 and 3 of the pin strip on the electronic unit 4 Power on the device the status LED flashes slowly at about 2 Hz 5 Remove the jumper from the pins on the pin header and plug it bac...

Page 30: ...ctronic unit 4 Power on the device The status LED flashes rapidly at approx 4 Hz 5 Remove the jumper from the pins on the pin header and reinsert it on the outer pin The status LED turns green 6 Wait until the status LED turns red The the unit has been reset to factory settings 7 Remount the transparent upper part of the housing In both cases an accidentally initiated reset process can still be ab...

Page 31: ... resolution of the display device used such as PC monitors smartphones or tablet 10 2 Operation The EWIO2 web pages have the following display and control elements Indicates the status of the yellow LED on the device OFF Indicates the status of the yellow LED on the device ON Indicates the status of the green LED on the device OFF Indicates the status of the green LED on the device ON Slide switch...

Page 32: ... on small display units System status System is OK System status Invalid system time System status Error was detected or Alarm Hilfetext erscheint automatisch beim Berühren The menu bar is located on the left side of the screen Pressing the individual menu item open zhe corresponding page or if available the sub menus appear The browser arrows for page forward and page backward can be used to swit...

Page 33: ...ect com 10 3 Wizard setup The first time the IP address or host name is called up a setup wizard guides you through the basic settings of the EWIO2 The settings are only applied when the Next action field is activated The language can be selected in the welcome window The default language is German In the next window the passwords for the authorisation levels must be assigned See chapter 10 4 ...

Page 34: ...es 1 5 10 15 20 30 45 and 60 minutes can be selected The default time is 45 minutes In the next window the network settings must be configured The device host name is freely selectable max 255 characters a z A Z 0 9 dot and hyphen Default is the name composed of EWIO2 and the last 6 digits of the MAC address Here you can also define if the EWIO2 gets an IP address from a DHCP server or by manual i...

Page 35: ... and time must be set Use the pop up menu to select the time zone via the cities specified The date and time can be set in three different ways by taking over the PC time by manual input or through a time server In case the time server is not available a second backup server can be entered By activating the Done field the settings are accepted and a device restart is performed Afterwards you have ...

Page 36: ... with the corresponding password is entered here If no password or an incorrect password is entered access is denied The passwords were set in the setup wizard during initial commissioning Depending on the authorization level there may be menu items that are not displayed EWIO2 has three authorization levels for access to the device functions Administrator Unrestricted reading and writing in all m...

Page 37: ...Tel 49 7702 533 0 Fax 49 7702 533 433 For additional documentations look at www metz connect com 10 5 Menu 10 5 1 Overview After successfully logging in the system overview appears with the most important current device statuses and settings in the following areas General Memory Network WLAN Date and Time ...

Page 38: ...displays the model name serial number and software version The installation location can be entered in the Location input field In the pop up menu the time until automatic logoff can be selected The times 1 5 10 15 20 30 45 and 60 minutes can be selected The default time is 45 minutes With the slide switch Expert view additional configuration parameters can be switched on in the following submenus...

Page 39: ...ese messages can contribute to error detection in case of service 10 5 2 3 Sessions The menu window Sessions displays the permission level IP address and period of inactivity of the participants who are currently logged in on the device Here it is also possible to close the sessions of participants with lower authorization level Attention Only one administrator and one operator may be active at th...

Page 40: ...255 characters a z A Z 0 9 dot and hyphen Default is the name composed of EWIO2 and the last 6 digits of the MAC address displayed below The respective radio button is used to select if the EWIO2 gets an IP address from a DHCP server or by manual input If manual input is used the IP address the subnet mask the default gateway and if necessary the DNS server must be entered Attention If the network...

Page 41: ...whether WLAN is switched off should act as an access point or as a client Depending on the operating mode the necessary configuration parameters are shown or hidden In the operating mode Off only the MAC address of the own WLAN chip is displayed In the Access Point operating mode it is possible to change the SSID name and the network key PSK The default settings for the SSID are the device name ho...

Page 42: ...e to list the found networks by clicking the action field Show table In the settings the respective radio button is used to select whether the EWIO2 in this network is assigned an IP address from a DHCP server or by manual entry In case of manual entry the IP address the subnet mask the default gateway and if necessary the DNS server must be entered Attention If the network settings are changed th...

Page 43: ...m which medium you are booting The additional information about the SD card shows whether it is set up as a boot medium and which software version is on it In the area Prepare SD card the following actions can be selected by slide switch and executed by pressing the action button Format Is used to delete the contents of the SD card or to initialize a new one This is only possible when booting from...

Page 44: ...ry Other mount points where the SD card may also be available depend on the boot medium and should not be used for user applications The files can be downloaded or deleted in the Data Server and Backup Files area Here one or more files can be selected whereby several files are packed into an archive tar bz2 This is done by clicking on the files or the action fields Select all and Invert selection ...

Page 45: ...tomatically the communication is encrypted With the selection Activate HTTPS Upload own certificate the menu window is extended by the possibility to upload an own certificate file and a private key If the expert mode is activated see Chapter 10 5 2 1 General the menu window is extended by the configuration parameter Force SSL This functionality is only available if HTTPS is activated Attention Th...

Page 46: ...et Use the pop up menu to select the time zone for the specified cities The date and time can be set in three different ways by adopting the PC time by manual input or through a time server In case the time server is not available a second backup server can be entered Only after activating the action field Save the settings are applied 10 5 2 9 Password In the menu window Password the passwords of...

Page 47: ...field Save the settings are taken over 10 5 2 10 E Mail In the menu window E Mail the necessary information for sending messages is entered The sender the recipient address the URL of the desired mail server and its communication port are entered here Here you can select whether the messages are encrypted by SSL which user name should be used and whether the messages should be sent password protec...

Page 48: ...Save the settings are applied 10 5 2 11 BACnet In the menu window BACnet the required information about the BACnet server is entered With the slide switch the BACnet server is activated The configuration parameters can be changed in the input fields Device Instance Device Name Device Description and the UDP Port for BACnet IP Factory settings are For the devices instance 421000 For the device name...

Page 49: ...g and digital outputs via the menu windows Digital Outputs and Analog Outputs is disabled A note is displayed in the corresponding windows Only after activating the action field Save the settings are applied 10 5 2 12 Modbus In the menu window Modbus the required information about the Modbus server is entered With the slide switch the Modbus server is activated The parameter can be changed in the ...

Page 50: ...ich data or configurations are to be saved in the browser or on the SD card These can also be used to transfer configurations from one EWIO2 to another General device configurations security settings time source password I O configurations their recording intervals and those of the expansion modules Counter configurations their data point selection and their recording intervals Network and WLAN co...

Page 51: ...l is set to Never no automatic backup is performed With the Restore function you can select which data or configurations are to be uploaded to the device via the browser or from the SD card Clicking the action field Choose a file opens an explorer window to select the desired tar bz2 file Only then the action field Restore can be activated Here only the data can be restored that were saved before ...

Page 52: ...ith the function Reboot the device is restarted With the Factory settings function the device is reset to its delivery status by activating the Load factory settings action field All settings and configurations will be lost Afterwards the device is restarted with the new settings The hardware is not reset The setup wizard chapter 10 3 is executed After a new restart the login window is displayed a...

Page 53: ...firmware can be uploaded to the device Clicking the Choose a file action field opens an Explorer window to select the desired tar gz file Only then can the Start update action field be activated Attention Don t turn off or unpower the device at firmware update This can brick the device Afterwards the device is restarted with the new firmware The hardware will not be reset The login window shows th...

Page 54: ...icates the input channel The designation in brackets corresponds to the terminals on the EWIO2 The text field is intended for a user defined description of the signal connected to the input If the Impulse counter checkbox is black the value corresponds to the binary state of the input If the Pulse counter checkbox is yellow the value is incremented on the rising edge at the input Additionally the ...

Page 55: ...inputs The port name shown indicates the input channel The designation in brackets corresponds to the terminals on the EWIO2 The text field is intended for a user defined description of the signal connected to the input The configuration dependent process value at the input is displayed live The input configuration can be changed in the pop up menu Configurations are available for Voltage measurem...

Page 56: ... menu you can select the recording interval with which the measured values are written to the database with a time stamp These can be selected and displayed in the menu window Record Chapter 10 5 3 7 Intervals of 1 5 10 15 and 30 minutes 1 2 4 6 and 12 hours daily weekly and monthly are available If the search for extension modules described in chapter 10 5 3 5 was carried out they are listed belo...

Page 57: ...nals on the EWIO2 The text field is intended for a user defined description of the actuator connected to the output With the slide switch the output can be switched manually It is locked when the BACnet server is activated If the checkbox is red the output states Event controlled are written with timestamp to the database and can be displayed under the menu window Recording Chapter 10 5 3 7 can be...

Page 58: ...ayed live The setpoint input field is for setting a voltage at the output In the pop up menu the recording interval can be selected with which the actual values are written to the database with time stamp These can be selected and displayed in the menu window Record Chapter 10 5 3 7 Intervals of 1 5 10 15 and 30 minutes 1 2 4 6 and 12 hours daily weekly and monthly are available If the search for ...

Page 59: ...s are set to these communication parameters after the search When the Expert Mode is switched on see Chapter 10 5 2 1 General the menu window is expanded In the input fields Repetitions 0 10 and Timeout Frame ms 0 5000 you can select how often a Modbus request should be sent and how long to wait for a response from a counter By activating the action field Search extension modules a request is sent...

Page 60: ...oltage with connected pull up resistor current and resistance linear or exponential are available In the input field Unit a unit can be entered In the input fields x and y the given value pairs can be edited Here in the example the X value as a support point for the temperature and the Y value for the corresponding resistance value Up to 10 value pairs can be defined by activating the action field...

Page 61: ...rce and in the case of the outputs whether automatic or manual operation was active at the time of recording appears Up to 50 entries can be displayed in the browser When exporting the values in a CSV file all stored values are used 10 5 4 Applications Under the menu item Applications the EWIO2 offers the possibility to create and execute applications Applications are small programs with which e g...

Page 62: ...on las_vegas sh serves only as an example code for the control of relays 1 to 4 When the application is started the relays switch To the right of the application name use the slide switch to activate the application the status display is green and deactivated the status display is red Clicking the action field Trashcan deletes the application Clicking the Pen action field opens the editing window ...

Page 63: ... like the example applications can be modified by assigning a new name and making changes in the script Changes can now be made in this template By activating the action field Save the changes are accepted Afterwards a name of your own must be assigned The name may contain the characters A Z a z 0 9 and _ For writing the script tools are offered which can be helpful during the script creation Afte...

Page 64: ...iguration can be changed by the script In the pop up menu Module the device where the I O is located is selected If extension modules are connected and known to the EWIO2 they will be listed as well In the Port pop up menu the desired I O is then selected The Cycle action field is used to generate program code for program loops The slide switch is used to generate program code for an endless loop ...

Page 65: ...he action field Upload file opens a file system window to upload script files created by other text editors During saving the script syntax is checked Once the script has been saved it can be found in the Application Overview Chapter 10 5 4 1 To start it it must be activated there with the slide switch Created scripts can be found in the EWIO2 directory structure var www html resources upload 10 5...

Page 66: ...e action field with the trashcan symbol the link can be removed from the list 10 5 6 Counter Under the menu item Counter are all menu windows that are necessary for data logger operation It is recommended to check the time set in the EWIO2 M before starting the counter setup and to set it if necessary This is important so that the time stamps given to each measured value are correct The setup date...

Page 67: ...ter trade installation location and cost center is displayed These were entered in the New Counter menu window when setting up the counter By clicking the Live Check action field you can check whether the counters are still responsive After the number a green tick or a red cross appears By activating the action field Messages the logged messages can be opened and closed by the counter controller T...

Page 68: ...wo METZ CONNECT counter types Additional functions are offered for the types 4xS0 M Converter and 4xT M Converter 4xS0 M converter With this selection a slide switch for Use FREEZE command appears This allows the exact time of the measurement request of all meters of this type by using the BTR Freeze command A freeze command is sent by broadcast to all connected meters at the beginning of the meas...

Page 69: ...our T M converters in the device not all of them Various common temperature sensors are available in the Sensor type pop up menu In the Temp offset input field the temperature value can be compared in 0 1 C steps with a value measured on site The Modbus address and the device type are displayed for the Modbus counter The device type is selected in the menu window New Counter in the drop down menu ...

Page 70: ... center comment client and customer number Clicking the Metering Code optional action field opens and closes the entries required for the code The Metering Code is a worldwide unique identification of a measuring point It is used for unique identification in large networks and is composed of different components Country e g DE for Germany 2 letters Operator Network operator identification 6 digits...

Page 71: ... measured values are written into the database With the setting the value is not written Only for the digital inputs of the system counters there is the additional polling interval Event based Here each change of the data point value immediately leads to the saving of the new data point value with the time of change as time stamp To identify the non periodic data point query flag 3 of this query i...

Page 72: ...600 bit s 60 counters per minute can be polled An approximate value can be assumed for Modbus counters At 300 bit s 60 counters per minute can be polled At 2400 bit s the maximum number of 247 counters per minute can be polled The time required for system counters can be neglected For counters with large data packets with multi response each data packet must be evaluated as one counter for the tim...

Page 73: ...t fields Factor U and Factor I are changed if a voltage or current transformer is connected upstream of the counter The measured value is multiplied by the factors before being saved These input fields are only available for MBus meters and the electrical trade In the input field OBIS code a code matching the measured value can be entered OBIS indices are internationally standardized and are used ...

Page 74: ...er baud rate The counter search can be done by primary or secondary address When searching for secondary addresses it is limited to the first specified max 8 from left digits In the input field Preselection for search addresses various criteria can be entered to shorten a search The syntax for searching with the secondary address is NNNNNNNNNN for the search for exactly one address NNNN to search ...

Page 75: ...ess can be followed When the search is complete all counters found are listed The table shows the MBus ID and the baudrate and the status if it is a new found or already known counter By clicking the action field Known counters the counters are listed which were found during the last search Use the slide switch to add a new counter to the list in the Overview menu window if the entries in the next...

Page 76: ... described in Chapter 13 The other input fields are explained in the menu window Edit counter which is described in chapter 10 5 6 1 System counters Select Input of EWIO2 M and click on Next to open the window for setting up the counter The other input fields are explained in the menu window Edit counter which is described in chapter 10 5 6 1 10 5 6 3 Measurements In the Measurements menu window t...

Page 77: ...ximum of 50 entries are displayed Clicking the action field Download values as CSV initiates the manual CSV download A browser dependent window opens how to proceed with the file The records consist of the sequence number the timestamp the value and the flags The flags indicate the status of the measured value The meaning is listed below Flag 1 Time zone designation CET CEST W winter time correct ...

Page 78: ...sured value S synchronization pulse T internal timer of the EWIO2 M 10 5 6 4 Modbus settings counter In the menu window Modbus settings counter the communication parameters baud rate and parity for the fieldbus interface are set In the pop up menus the baud rates of 1200 2400 4800 9600 19200 38400 57600 and 115200 bps and the parity none with 1 stop bit none with 2 stop bits even and odd parity ca...

Page 79: ...he following settings become effective In the one of the 8 digital inputs on the EWIO2 can be selected for the external synchronous pulse The radio button for the contact type can be used to select the signal edge which shall trigger the synchronous pulse In the pop up menu for the time grid you can set the interval 15 30 or 60 minutes after which the synchronisation will take place 10 5 7 Data se...

Page 80: ...s to be assigned to which line If nothing is selected for a line the following lines will move up and the page will be updated after clicking the Save action field This way you only select the configuration settings that you need The settings are entered under the menu item Counter in the New Counter menu window or via the menu item Counter in the Overview menu window Edit counter changed In the d...

Page 81: ...tivating the checkboxes for sending via FTP server the URL user name and password must be specified and whether the data should be encrypted via SSL When activating the checkboxes for sending by email the email address and subject must be specified The settings made in the menu item System in the menu window Email are relevant here In the pop up menu you can select whether individual files are cre...

Page 82: ...om the EWIO2 via FTP client As client a special program e g Filezilla or a web browser can be used FTP URL ftp ftpuser ip adr data When logging in the password for the FTP user specified in the Setup Wizard Chapter 10 3 or in Expert Mode Chapter 10 5 2 1 under the menu window Password Chapter 10 5 2 9 must be used The user name is ftpuser 10 5 8 Logout With the menu item Logout the session is term...

Page 83: ...ase_command _ io category _ module addr _ pin addr _value The base command possible values are set or get The io category may be one of ai ao di do aisensor or dicount Each individual pin digital or analog In Output is identified by it s address The address consists of two parts module address and pin address The module address module addr ever has the value 0 for the EWIO2 base device and the val...

Page 84: ...ange For get commands the return value will be a digital or analog value in floating point format or the keyword err in case of errors 11 3 Examples 11 3 1 Set an analog value for an analog output ewioIOControl set_ao_0_01_3 73 The command above will set 3 73 V to the analog output AO2 O2 the return value is ok ewioIOControl set_ao_0_02_25 5 The command above will try to set a value out of range f...

Page 85: ...input ewioIOControl set_dicount_0_00_366 The command above will set the counter initial value of the first digital input DI1 1 to 366 The return value is ok ewioIOControl set_dicount_0_57_134 The command above will try to set the counter value of a not axisting digital input The return value is err 11 3 5 Get the analog value of an analog input ewioIOControl get_ai_0_01 The command above will retu...

Page 86: ...ve will try to get the counter value of a not axisting digital input The return value is err 11 4 Remotely query control IOs of an EWIO2 For the sake of security the ewioIOControl tool can only be executed locally on EWIO2 In order to remotely access the IOs of another EWIO2 device you must call the tool via SSH on this one This can be only useful if an implicit authentification method is used i e...

Page 87: ...nt Always let the passphrase empty otherwise the user will be asked on every login for it Enter same passphrase again Press ENTER If the keys were successful generated you ll get the following output Your identification has been saved in home root ssh id_rsa Your public key has been saved in home root ssh id_rsa pub The key fingerprint is SHA256 jYgP6ipdp9OrPzf1KaM7Gacnfh7g88gdbqeceD9jWKg root EWI...

Page 88: ...fication for the remote EWIO2 you can call the tool using following command ssh n remote ewio2 host usr bin ewioIOControl command The remote ewio2 host parameter is the hostname if an entry in the etc hosts file exists or the IP Address of the remote EWIO2 11 5 Usage of aliases On the command line you can use the alias ewiolc command for local control or ewiorc hostname IP command for remote contr...

Page 89: ... here 7 5 Volt the second digital output 0_01 will be set to 1 otherwise to 0 bin sh ai_monitor_addr 0_00 do_under_range_sig_addr 0_00 do_over_range_sig_addr 0_01 lower_voltage_limit 3 5 upper_voltage_limit 7 5 while true do current_in_voltage ewioIOControl get_ai_ ai_monitor_addr cmp_lower echo current_in_voltage lower_voltage_limit bc if cmp_lower 1 then over the lower limit turn do 0 off ewioIO...

Page 90: ...nsor enum Range 1 0 10V UNITS_PERCENT 0 0 100 0 ewioSensor_0_10V_Percent ewioRange_Volt 2 0 5V Pullup UNITS_PERCENT 0 0 100 0 ewioSensor_0_5V_Percent_PU ewioRange_Volt_PU 3 0 10 Volt UNITS_VOLTS 0 0 10 0 ewioSensor_0_10V ewioRange_Volt 4 0 5 Volt Pullup UNITS_VOLTS 0 0 5 0 ewioSensor_0_5V_PU ewioRange_Volt_PU 5 Ohm UNITS_OHMS 40 0 4E6 ewioSensor_Ohm_2Wire ewioRange_Ohm_2Wire 6 User Defined UNITS_N...

Page 91: ...50 0 ewioSensor_NTC5k_Schneider ewioRange_Ohm_2Wire 22 NTC30k Schneider UNITS_DEGREES_CELSIUS 50 0 150 0 ewioSensor_NTC30k_Schneider ewioRange_Ohm_2Wire 23 KP250 UNITS_DEGREES_CELSIUS 50 0 150 0 ewioSensor_KP250 ewioRange_Ohm_2Wire 24 Poti 10k UNITS_PERCENT 0 0 100 0 ewioSensor_Poti_10k_Percent ewioRange_Ohm_2Wire 25 Inactive UNITS_NO_UNITS 0 0 0 0 ewioSensor_Inactive ewioRange_Inactive 26 0 20mA ...

Page 92: ... documentations look at www metz connect com Sensor string Name enum Unit Minimum Maximum enum Sensor enum Range 35 500 Ohm 14 kOhm UNITS_OHMS 500 0 14E3 ewioSensor_Ohm_Test4 ewioRange_Ohm_Test4 36 12 kOhm 180 kOhm UNITS_OHMS 12E3 180E3 ewioSensor_Ohm_Test5 ewioRange_Ohm_Test5 37 140 kOhm 4 MOhm UNITS_OHMS 140E3 4E6 ewioSensor_Ohm_Test6 ewioRange_Ohm_Test6 ...

Page 93: ...ing interface The communication between EWIO2 and the web interface is done via HTTP on TCP IP The data of the application layer which are transferred can also be operated by other applications than a web browser In addition general functions like for SQL commands are available to enable additional functionality Details can be taken from the separate document EWIO2 API pdf which can be found at ww...

Page 94: ...e before they can be used For this purpose the sentence in the configuration file var opt etc ewio2server ini load_modbus_templates false has to be changed to load_modbus_templates true The required Modbus registers can be found in the manufacturer documentation of the new counter The basic format of the template looks like this device Address 0 AddressBase 0 Type manufacturer_type TX function 3 s...

Page 95: ...Byte High Byte INT8 UINT8 INT16 HL INT16 LH UINT16 HL UINT16 LH INT32 HL INT32 LH UINT32 HL UINT32 LH INT32 B0123 any byte sequence INT48 HL INT48 LH UINT48 HL UINT48 LH INT48 B012345 any byte sequence INT64 HL INT64 LH UINT64 HL UINT64 LH INT64 B01234567 any byte sequence FLOAT32 HL FLOAT32 LH HEX8 HEX16 HL HEX16LH HEX32 HL HEX32 LH HEX48 HL HEX48 LH HEX64 HL HEX64 LH unit Unit as text string des...

Page 96: ...2 78176 Blumberg Germany Tel 49 7702 533 0 Fax 49 7702 533 433 For additional documentations look at www metz connect com RX register 2 format FLOAT32 HL unit kWh description Real Energy L1 L2 L3 select register 2 format FLOAT32 HL unit kWh description Real Energy L1 L2 L3 select ...

Search results

Summary of Contents for EWIO 2

Reviews:

Brands by name

Popular brands

Metz Connect EWIO 2, User Manual

Search results

Summary of Contents for EWIO 2

Reviews:

Brands by name

Popular brands