Manual Web-IO Analog-In/Out PoE W&T Typ Modell Release 10/100BaseT 57661, 57662 FW 1.76 1.
W&T © 06/2012 by Wiesemann & Theis GmbH Microsoft, MS-DOS, Windows, Winsock und Visual Basic are registered trademarks of Microsoft Corporation Subject to errors and modifications: Since errors are always possible, none of this information should be used without checking. Please let us know of any mistakes or unclear descriptions so that we can become aware of them and correct them as quickly as possible.
W&T Introduction The W&T Web-IO Analog-In/Out models include all the functions in a single box for capturing your analog measurements (0..20mA/4..20mA or 0..10V), tunneling them through the network, saving and displaying them. A variety of alarm and report functions are also available which can be custom added to your own applications or into existing systems (Modbus-TCP, OPC, SNMP).
W&T Content Introduction ............................................................................................ 3 1 Quick-start, Commissioning ......................................................... 7 1.1 Connect to power ........................................................... 7 1.2 Wiring the in- and outputs ............................................... 9 1.3 Network connection ...................................................... 11 1.4 Assigning the IP address using „WuTility“ ..........
W&T 3.8.5 Password protection ......................................... 52 3.8.6 BINARY - The IO structures ................................ 54 3.8.7 Definition of the IO structures ........................... 55 3.8.8 Working with the IO structures .......................... 56 3.9 Box-to-Box (tunneling measurement network) ................ 60 3.9.1 Configuring the Slave Web-IO (Server) ............... 61 3.9.2 Configuring the Master (Client) ......................... 63 3.9.
W&T 3.20.3 Special case: Report -> FTP ............................ 121 3.21 Syslog messages incl. alarm sending .......................... 122 3.21.1 Basic Settings -> Syslog ................................ 122 3.21.2 Alarm X -> Syslog .......................................... 123 3.22 Time-based report ..................................................... 125 3.23 Check Alarm ............................................................. 126 3.24 UP-/Download ............................................
W&T 1 Quick-start, Commissioning To start up the W&T Web-IO Analog-In/Out and make it visible in your network only a few steps are necessary. 1.1 Connect to power If you want to use a power supply, connect 18-48V DC or 1830V AC to the screw terminal provided. Polarity is uncritical when connecting AC power supplies.
W&T PoE supply The Web-IO Analog-In/Out can be used in PoE (Power-overEthernet) environments in accordance with IEEE802.3af. The supply voltage is provided then by the network infrastructure through the RJ45 terminal. The device supports both phantom power using data pairs 1/2 and 3/6 as well as power on the unused wire pairs 4/5 and 7/8. To enable power management for the supplying components, the W&T Web-IO Analog-In/Out is identified as a Power Class 1 device with a power consumption of 0.44 to 3.8W.
W&T 1.2 Wiring the in- and outputs Depending on the configuration the W&T Web-IO Analog-In/Out can be wired as follows, whereby Ports 1 and 2 are indicated by an „X“. The configuration is identical for both ports: 1.2.1 Current input 0..20mA, passive (#57661) 1.2.2 Current input 0..20mA, active (#57661) Note: If you need to connect two passive sensors, 1.1 and 2.1 may be jumpered in order to save wires. 1.2 and 2.
W&T 1.2.3 Current output 0..20mA (#57661) Note: Current outputs cannot be connected directly to active inputs. Please use isolation amplifiers. If you need to connect two passive sensors, 1.1 and 2.1 may be jumpered in order to save wires. 1.2 and 2.2 may not be jumpered however, since otherwise cross-currents will flow which falsify the input values. 1.2.4 Voltage input 0..10V (#57662) 1.2.
W&T Jumper directly on the device For longer cable distances the jumper should be made on the remote end so that fluctuations are automatically compensated: Jumper on the remote end 1.3 Network connection The W&T Web-IO Analog-In/Out has an IEEE 802.3 compatible network connection on a shielded RJ45 connector. The pin configuration corresponds to an MDI interface, so that the connection is made to the hub or swtich using a 1:1 shielded patch cable.
W&T Power-over-Ethernet The W&T Web-IO Analog-In/Out can obtain its supply voltage through the network interface in accordance with IEEE802.3af / Power-over-Internet. The feed comes in over the data pairs or on the wire pairs not used for 10/100BaseT (see PoE section). 1.4 Assigning the IP address using „WuTility“ Once the hardware has been connected to the power supply as described above, the IP address needed for operating in a TCP/ IP network must be assigned.
W&T Be sure that the PC you are using to assign the IP address is located in the same subnet as the W&T unit and that both the PC and the unit are connected to the network. When first started, WuTility automatically searches the local network for all connected W&T network devices and generates an inventory list.
W&T All the columns in the WuTility device list are filled with information. After clicking on the globe in the WuTIlity menu bar your standard browser is opened and you see the start page of the device. 1.5 Assigning the IP address using DHCP protocol Many networks use DHCP (Dynamic Host Configuration Protocol) or the predecessor protocol BOOTP (described in the following section) for centralized and dynamic assignment of the network parameters.
W&T default setting, so that in network environments wtih dynamic IP assignment you need only to connect the W&T Web-IO Analog-In/Out to the network. The following parameters can be set using DHCP: • IP address • Subnet mask • Gateway address • DNS server • Lease time 1 To prevent unintended address assignments or address changes, we recommend disabling DHCP, BOOTP and RARP protocols unless they are expressly used in the respective network environment.
W&T 1.5.2 System Name To suypport any automatic updating of the DNS system by the DHCP server the W&T Web-IO Analog-In/Out identifies itself within the DHCP protocol by its system name. The factory default setting is WEBIO- followed by the last three places of the Ethernet address. For example, the factory set system name of a W&T Web-IO Analog-In/Out with Ethernet address 00:c0:3d:01.02.03 is WEBIO-010203. The system name of the W&T Web-IO Analog-In/Out can be changed using Web Based Management. 1.5.
W&T 1 If the DHCP server is no longer accessible after expiration of the lease time, the W&T Web-IO Analog-In/Out deletes its IP address. All existing TCP/UDP connections between the W&T Web-IO Analog-In/Out and other network clients are thereby closed. To prevent such situations, we recommend configuring the assigned lease time in the DHCP server to infinite whenever possible. 1.5.
W&T services located in the network, dynamic changing IP addresses can also be used. 1.6 Start page As soon as an IP address is assigned, the start page of the device can be opened in the Web browser: When first opened you must select the device language. Once this is done, you are taken to the actual start page of the device. To get to the configuration menu, click above on the page on the „Show menu“ link. If you assign a password later in the configuration, you can login here.
W&T Also on this page you can switch to the User page to directly read out the data logger of the unit. Display the menu to go to the Smartphone page or to proceed with the rest of the configuration. 1.7 Assigning the basic network parameters At left in the configuration tree click on „Config“.
W&T You are now prompted to enter a password. The factory default setting is for no password, so that you can simply click on the Login button without entering a password (or with entering any password) . On the next page select the configuration path using the profiles. Select the profile „Network basic parameters“ and click on the „Show profile“ button“.
W&T The device now automatically displays the necessary menu points for this profile. In the configuration menu click on the entry „Network“.
W&T On the following page enter all the necessary network parameters and then click on the „Logout“ button. Clicking on the „Save“ button stores the settings in the device and closes your configuration session. After the network parameters are changed the device automatically performs a restart.
W&T The device is now ready to use in your network. For ease of handling use the additional profiles for adapting the device to your needs. 1.8 Smartphone Page In addition to the start page, users of smartphones (such as the iPhone) can make use of a special Web page. This is tailored to the resolution of most phones. Here you can read the 2 analog measurement values and adjust them as necessary if the corresponding device terminal is configured as an output.
W&T 2 Graphical Representation of the Measurements 2.1 Basic functions The device provides a table of the current values and a chart of the stored values on the home.htm page. The navigation buttons on the bottom provide the following control functions. Scrolls the chart to the right or left by the size of the display interval. Scrolls the chart right or left by one unit of the x-axis. Zooms in to the area of the chart indicated by „Zoom +“ on the lower right edge.
W&T Zooms out to the previous zoom level. Activates automatic updating of the chart. Updates the display. Opens the configuration menu beneath the chart. Displays the values current displayed in the chart in table format. Opens a new page with a snapshot of the chart display. Measured value representation: Large point: This value is stored in the data logger of the device. Small point: This value is a volatile one which is used only for display and is not stored in the data logger.
W&T The design and configuration of the graphical display can be varied. For additional information, see the section Configuring the graphical display. 2.
W&T End: Specify the end time point for the x-axis. Sensors: Turn individual sensors for the display on and off. Polling Rate: Enter here the desired polling rate for the graphical display. The device makes a new value available no sooner than 0.5 seconds. Entering a value of less than 0,.5 has no effect.
W&T 2.3 Table This function is used to show the currently displayed values in table format.
W&T 3 Other Basic Settings 3.1 Configuring the port and device name 3.1.1 Text Enter your personal descriptions in the fields and then click on Temporary Storage.
W&T 3.1.2 Ports Port 1..2: First enter a name and a descriptive text for the port and select the measuring range for adapting the input wiring for your measuring point (For model 57661 only: Measuring range 0..20mA or 4..20mA). To disable the port, select „Disconnect.
W&T Configuring the voltage input and output (Model 57662): Subject to errors and modifications 31
W&T 3.1.3 Port Config In the Port-Config menu you can specify which values are displayed when then input is in between 0% and 100% of the scale . This entry also refers to the data logger and the output value. Example: 0% -> 10 100% -> 3000 If there is no input signal on the unit (0%), it will show a value of „10“. If you set your output to the value „10“ the device will output 0V or 0mA . If there is an input signal of 10V or 20mA on the unit (100%), the value „3000“ is displayed.
W&T 3.2 Calibration The sensor can be calibrated using single-point and two-point reference measurements and corresponding entries for offset values. In single-point compensation the entered offset value is added to the measured value, whereas in two-point compensation a straight line is calculated for compensating the entire measuring range. The offset is allowed to be max. 20% of the total range. The offset may be negative, but the full scale values may not fall below the 0% mark.
W&T 3.3 Specifying Output Mode You must specify which mode you want each individual output to operate in. The corresponding configuration can be made under Config >> Ports >> PortX >> Output Mode.
W&T Output Mask: Here you specify which operating mode is used for each output. The factory default setting for all ports is HTTP. Please note that for most of the modes you must make a few other settings in addition to output mode, such as enabling the operating mode. Additional information can be found in the description for the respective operating mode. ! Please note when using the active input that in Output Mode “Output OFF” causes passive Input Mode to be set for Config >> Ports >> Port x.
W&T 3.4 Compensation of the output controller (57662 only) During the use of applications, which have a high entrance capacity, it is necessary to compensate the voltage regulator to prevent an overshooting of the output value. Example: Output regulation with entrance capacity of 100µF, without compensation: This overshooting can be avoided with a compensation value between 0 and 1000. This value can be configured manually, or determined automatically.
W&T „Send Testpulses, please wait ...“ After clicking the button the device begins with the automatic compensation. The test pulses with a capacity of 100µF appear as follows: Value: The device enters the determined compensation value automatically. This value is valid immediately. The value can also be set manually. Subsequently, the desired value which was present before the determination will be adjusted again. Mode: Auto adaptive enable: The device determines the compensation at run-time.
W&T Example: Output regulation with entrance capacity of•n 100µF, with compensation: 3.5 HTTP - Controlling outputs in the browser (Control) Access from the browser is probably the simplest way of working with the Web-IO Analog-In/Out. To operate the outputs from the browser it is necessary to log in as Administrator or with Config rights. After successfuly logging in the control elements for the output are enabled using the Control menu point.
W&T The Follow slider checkbox causes the selected output value to be set as soon as the slide controller is released at a certain point. At the same time the slide controller automatically changes its position when the device changes its output value, for example using TCP commands. If the Follow slider checkbox is not selected, an input field and a button appear which can be used to manually set the output. The value in the input field can also be set using the slide controller.
W&T Properties of device regarding HTTP have to be configurated on Config >> Devices >> Basic Settings >> HTTP. Startup: Specify here which HTML page you want displayed when the device starts up. Enable: The device can, when polled using an HTTP-Get command, also send along with the measured value a header with the IP address and name of the device. Check the corresponding box to enable this. If this function is disabled only the actual measurement is sent.
W&T 3.
W&T In addition to TCP/IP commands the device can also reply to UDP datagrams. Here you need to set the local Port you want the device to listen to. The factory default setting is 42279. The Remote Port default is AUTO for answering to Source Port. In special cases Web-IO have to answer to defined port that is not equal 0. The Enable function turns on UDP. The setting for the header which can be appended to the measurement value also applies here. 3.
W&T . Customer socket application (binary with password protection) . TCP-Server . TCP-Client . UDP-Peer . Customer socket application which uses the same structure as the W&T Digital- EA-Com-Server 50xxx. . TCP-Server . TCP-Client . UDP-Peer . Box-to-Box Master (with password) . TCP-Client . Box-to-Box Slave (with password) . TCP-Server . OPC-Device together with the W&T OPC-Server (with password) .
W&T In the navigation tree select Config >> Device >> Basic Settings >> Binary 1 if you want to configure the operation mode for access through Binary 1. m Necessary access rights: Administrator After selecting the desired mode and setting Enable Binary send the setting to the Web-IO Analog-In/Out by clicking on the Temporary Storage button. For access from your own application programs the developer is provided with two levels of the socket programming. 1. Socket Device (password protected access) 2.
W&T In the navigation tree select Config >> Device >> Basic Settings >> Binary 1>> TCP Server. m Necessary access rights: Administrator Local Port The local port on the device is factory set to 49153. If your application requires a different local port for the Web-IO, enter the desired port number in the Local Port field. Client HTTP Port Is only relevant for OPC and Box2Box modes and specifies the HTTP port on which a control line should open a connection to the OPC server or slave box.
W&T Application Mode Select here: . Socket Device - If you want access to the Web-IO password protected. . Compatible 50xxx - If you want access to the Web-IO using applications which were programmed for the older Digital I/O Com-Servers. You can also use this mode for new applications that do not require password protection. i A more detailed discussion of Box2Box Slave and OPC Device modes can be found in the corresponding sections.
W&T 3.8.3 The Web-IO as Socket-Client To operate the Web-IO as a socket client, a few additional settings must be made. In the navigation tree select Config >> Device >> Basic Settings >> Binary 1>> TCP Client m Necessary access rights: Administrator Local Port The local port of the Web-IO is factory set to AUTO. If your application requires a special local port for the Web-IO, enter the desired port number in the Local Port field.
W&T Server HTTP Port Is only relevant for Box2Box mode and specifies the HTTP port on which a control line should open a connection to the slave box. Unless otherwise specified, always use Port 80 here. Server IP Addr Enter here the IP address of the server. Server Password A server password only needs to be entered if the Web-IO is used as a Box-to-Box Master or needs to access a different WebIO as a TCP client in Server mode. More about this in the Boxto-Box section.
W&T 1 Please note that for connections using fee-based dialup connections too small an interval may result in the connection not being closed, in turn resulting in permanent fees! Mode Select here: . Socket device - If you want access to the Web-IO password protected. . Compatible 50xxx - If you want access to the Web-IO using applications which were programmed fo the older Digital IO Com-Servers. You can also use this mode for new applications that do not require password protection.
W&T After you have made all your settings, send them by clicking on the Logout button. Clicking on the Save button activates the settings. 3.8.4 The Web-IO as UDP-Peer To use the Web-IO as a UDP peer a few additional settings must be made. In the navigation tree select Config >> Device >> Basic Settings >> Binary 1>> UDP Peer m Necessary access rights: Administrator Local Port The local port on the device is factory set to 45889.
W&T Remote Port Enter here the port number you want the UDP application to use for receiving data when communicating with the Web-IO. Remote IP Addr Enter here the IP address of the communication partner. Binary Trigger Enter here the inputs whose change of state should be used as the trigger for sending a UDP datagram (important for eventtriggered applications). Interval If you want the status of the inputs to be sent cyclically to the communication partner, enter here the interval in 100ms increments.
W&T 3.8.5 Password protection As already mentioned earlier, the Web-IO enables you in TCP server mode to protect access through the application using a password. Before the actual connection to the Web-IO is opened, the BinInfo structure defined here must be sent over a separate TCP connection to the HTTP port (factory set to Port 80) on the WebIO. For the reply the Web-IO also uses the structure BinInfo.
W&T n stands for the number of bytes used and corresponds to 14 + the length of the password. The length of the password is limited to 31 characters. In the reply from the Web-IO HTTPLogin is always 8 characters in length and contains the following string: GET /bin Dummy Slash between the ASCII and the binary section of the structure. Is always = 0x00 Type Determines the type in which Binary mode is used. The application must enter 0x10 here in order to open a TCP connection.
W&T If 0x01 or 0x04 was received, the actual data connection can be opened. SrcPort The client application alwlays enters a 0 here. The Web-IO returns here the opened server port (e.g. 49153 for Binary 1). If the login attempt has failed, the Web-IO enters 80. DestPort The client application enters here which port will be used for the connection (e.g. 49153 for Binary 1 or 49154 for Binary 2). The Web-IO always returns 0.
W&T Socket-Interface UDP-/TCP-Header IP-Header IO-Structures UDP-/TCP-Data IP-Data Ethernet-Data Ethernet-Header Which of the two protocols are used, UDP or TCP, depends on the type of application. Both protocols offer advantages and disadvantages which must be considered depending on the application you want to create. i Help with socket programming including the basics of TCP/IP can be found in a short and clear form in our manual „Ready in 1 day for TCP/IP Sockets“.
W&T length length indicates the total length of the structure in bytes, i.e. including the first 4 WORDs. The result is the following packet structure: WORD WORD WORD WORD Variable ............... Structure buildup 1 send_sequence rec_sequence struct_type length ............... ............... always 0 always 0 identifies the structure length of the structure in bytes depends on the function additional variables Note: The following applies for all IO structures.
W&T IO-Structure ReadRegister Sending this structure to the Web-IO causes it to send the status of the port to the user program. The packet consists only of these four WORDs. This structure is used only by the user program, and the Web-IO always responds by sending the structure AnalogRegisterState.
W&T AnalogSingleRegister (Web-IO <-> PC) WORD WORD WORD WORD LONG LONG LONG send_sequence rec_sequence struct_type length word_anz channel value always 0 always 0 0x01BB 0x0014 1 0 or 1 in 1/1000 % IO structure Send Mode This structure determines the trigger conditions the Web-IO Analog-In/Out uses to send the state of the ports to the user program. The trigger can be configured for state changes on both ports. The respective hysteresis for the trigger must be set in the Web configuration.
W&T ReadDiagnosis (PC -> Web-IO) WORD WORD WORD WORD send_sequence rec_sequence struct_type length always 0 always 0 0x00D1 0x0008 In reply the Web-IO sends a Diagnosis type structure. IO structure Diagnosis The Web-IO sends the Diagnosis structure in reply to the ReadDiagnosis structure.
W&T 3.9 Box-to-Box (tunneling measurement network) In this mode the inputs of a Web-IO Analog are transferred to the outputs of a second Web-IO. In this way you can for example send signals from one location to another over a WAN connection. The values are sent as a percentage. This means a model #57662 can send (“convert”) voltage values of 0…10V to a model #57661 with current values of 0…20mA and vice-versa.
W&T 3.9.1 Configuring the Slave Web-IO (Server) m Necessary access rights: Administrator In the navigation tree of the Slave Web-IO select Config >> Device >> Basic Settings >> Binary 1 For Operation Mode set TCP-Server mode and activate Enable Binary 1. Then click on the Temporary Storage button to send the changes to the Web-IO.
W&T Now in the navigation tree select: Config >> Device >> Basic Settings >> Binary1 >> TCP-Server Local Port Unless your network administrator has informed you otherwise, the factory default set Port 49153 may be used. One reason for changing the factory default set local port may be for example a fireweall which permits access only to a particular port. 1 In any case the set local port on the Slave must be identical to the Server Port entry for the Master.
W&T Activate the outputs to be set by the corresponding inputs on the Slave for Binary 1 and confirm by clicking on the Temporary Storage button. The outputs activated for Box-to-Box are no longer accessible for other modes. Next the new settings still need to be activated. Use the Logout button or select Config >> Session Control >> LogOut. 3.9.
W&T Then click on the Temporary Storage button to the Web-IO. Now in the navigation tree select: Config >> Device >> Basic Settings >> Binary1 >> TCP-Client.
W&T Local Port Unless otherwise specified by your network administrator, the factory default setting AUTO can be used. ServerPort Here the Local Port for the Slave must be entered. Here again the basic setting 49153 can be used unless otherwise specified by the network administrator. i Local Port and Slave Port do not necessarily have to be set the same as the factory default settings.
W&T This means for example that the inputs which control the outputs on the Master Web-IO can at the same time be read out over HTTP. "Input Trigger" allows sending based on an input change. Use “Hysteresis” to specify how great the change should be in order for a new value to be sent. Interval: If no interval is entered, the state of the inputs is sent to the outputs of the other respective Box-to-Box partner whenever there is a change.
W&T Activate here the outputs which are to be set by the corresponding inputs on the Slave for Binary 1 and confirm by clicking on the Temporary Storage button. In contrast to the inputs, the outputs activated for Box-to-Box mode are no longer accessible for other modes. Now the new settings still need to be activated. Use the Logout button or select Config >> Session Control >> LogOut.
W&T Here you are shown in which mode the individual inputs are currently working. In addition the current status of a Box-toBox connection is displayed in the footer of the Web page. 3.9.4 Quitting Box-to-Box mode Box-to-Box mode only for the Master m Necessary access rights: Administrator Quitting Box-to-Box mode should always be done by configuring the Master correspondingly. Master and Slave WebIO must be connected in the network.
W&T In the navigation tree select des Slave: Config >> Device >> Basic Settings >> Binary1 >> TCP Server and set Application Mode to Socket Device. Confirm by clicking on the Temporary Storage button. In the navigation tree select Config >> Ports >> Port X >> Output Mode and set the outputs which are no longer to operate Box-to-Box to HTTP. Confirm by clicking on the Temporary Storage button. Now the changed settings still need to be activated.
W&T After logging in again and opening Config >> Session Control >> LogOut the Stopp Box2Box Slave button will be shown. Clicking on the button resets the Slave to Box-to-Box mode. 3.9.6 Preconfiguring Box-to-Box for another network You can configure Box-to-Box mode from your desk. Then carry out the following steps (Master = Client, Slave = Server): Master: Use Binary disable to close the connection, then save. Now the slave is ready to accept a new connection.
W&T 3.10 Modbus TCP Modbus TCP is a software interface for address-based access to process data. The W&T Web-IOs work as Modbus servers (slaves) which can be controlled by a variety of Modbus TCP controllers (clients). Modbus TCP access allows you to read the analog in- and outputs. You can also set outputs. The Web-IOs are not intended to be configured using Modbus. This is done from the Web browser. 3.10.
W&T Then click on the Apply button to send the changes to the Web-IO. In the navigation tree select: Config >> Device >> Basic Settings >> Binary 1 >> TCP-Server. Local Port: For use in the normal Modbus TCP environment the local port on the Web-IO should be set to 502. This can be selected only in a binary channel. If you need to access the device with 2 clients, you must select a different port for Binary 2.
W&T After you have entered all the parameters, confirm by clicking on the Temporary Storage button. From the navigation tree select: Config >> Ports >> Port 1 >> Output Mode. Here you select the analog output as Binary 1 which you want to be controlled by Modbus. Confirm by clicking on the Temporary Storage button. Now you must still enable the new settings. Use the Logout button or menu sequence Config >> Session Control >> LogOut.
W&T 3.10.2 Modbus variables for Web-IO Analog In/Out All address information is in hex format. There are various Modbus memory ranges for the Web-IO: . . . . Bit range (starting at Address 1000 or 1800) 16-bit range (starting at Address 2000), 32-bit range (starting at Address 5000, 6000 or 7000), 8-bit range (Exception Status, no address). Addressing is done in the bit-range, i.e. 1 bit requires an address. In the 16-bit and 32-bit range addressing is by the word (2 bytes).
W&T The Exception-Status is located in the bit range starting at address 1060, in the 16-bit range at 200D (Low Byte). Alternately the Exception Status is read out using the function code 0x07. The Configuration-Status is located in the bit range at Address 1068, in the 16-bit range at 200D (High Byte). The Diagnostics-Status (number of errors) is located in the 16bit range at 2006, in the 32-bit range at 504A.
W&T Diagnostics status writing of the Master: Reset (corresponds to „Delete Report“) - regardless of the written value. 1 At present the configuration byte is 0, i.e. only Modbus and Big Endian are supported. Others (JBUS, LIttle Endian) are available on request. 3.10.4 Modbus - Alarm triggering incl. special memory An alarm trigger bit in the bit memory range can be used to trigger individual device alarms with the rising edge. The bits are located starting at Address 1800 (Alarm 1).
W&T Memory which is made available lies in the 32-bit range starting at Address 7000. These are 32 long values and double words (128 bytes). This memory range can be written and read as desired. Special so-called embedded tags can be used for read access to this memory for sending data when alarms are issued (mail, FTP, SNMP). Embedded Tags allow byte, word and long access to the address base. Access is in 2-character hex format. The output values are send decimal or hex in ASCII format.
W&T displaying an analog measurement value: . Likewise the tags are applicable to e-mail etc. Using the above tags you can access the free memory as follows: , whereby the syntax after the colon corresponds to the syntax for embedded tags. This means each byte can be read by the byte. The memory can be read out by the word or in double words.
W&T Memoryregion MB-Startaddress [hex] Read m. FC / Read m. FC / Write m. FC / Port access Block access Port access Write m. FC / Block access 5766x Bit Definition Alarm- / Report-Status (1-8) Alarm- / Report-Status (9-16) 1048 1,2 - - - 9 Bit Exception-Status 1060 1,2 - - - Bit Bit Bit Bit Bit Bit Bit Bit Bit Conf.
W&T 3.11 OPC - Standardized access OPC (OLE for Process Control) is a software interface for accessing process data based on OLE technology from Microsoft. Application programs such as visualization systems which use this interface are called OPC clients. On the opposite side of the interface are OPC servers. These are device drivers which represent certain hardware in abstract form as a set of OPC variables. The OPC server used here implements the specifications OPC Data Access 2.0 and Alarms & Events.
W&T The OLE server name which OPC clients will need to specify later in order to connect to the server is: Wiesemann-Theis.NetworkIO. The OPC server starts automatically upon such requests. To configure the server you can also run it manually. A corresponding entry W&T OPC-Server Version 4 can be found in the Start menu under „Programs.“ 3.11.2 Uninstalling You can remove the OPC server using the control panel component „Software.“ It is listed there under OPC-Server for network-I/O devices Version 4. 3.
W&T Host name or IP address: Must agree with the IP address which was assigned to the unit. If there is also a DNS name for the address, you can also use this instead of a number combination. HTTP port: Should normally be 80. The port number entered here is also used for opening the external browser („WebBrowser“ button“). Device type: In case of doubt the „Identify“ function can help to select the proper type here. Some input fields with unneeded parameters may be deactivated after a selection is made.
W&T If there is a need to eliminate an undesirably high network load, the OPC client would be the first place to start. There you could select any unnecessarily high update rate and choose not to subscribe to any OPC items which are not really essential. If this does not help (or if the behavior of the OPC client cannot be modified in these ways), a lower limit for the time between read accesses can be specified in the OPC server.
W&T 3.11.4 m Configuring the Web-IO as an OPC device Necessary access rights: Administrator In the navigation tree of the Web-IO select Config >> Device >> Basic Settings >> Binary 1. As Operation Mode set TCP-Server. Then click on the Temporary Storage button to send the changes to the Web-IO. Now in the navigation tree select: Config >> Device >> Basic Settings >> Binary1 >> TCP-Server.
W&T Local Port Unless otherwise specified by your network administrator, the factory default setting Port 49153 can be used. One reason for changing the factory default local part setting may be for example a firewall which only allows certain port accesses. 1 In any case the set local port on the Web-IO must be identical with the corresponding settings in the OPC server. Client HTTP Port Specifies the HTTP port on which the control connection to the OPC server should be opened.
W&T describes by how much the state must change in order for a message to be triggered. Application Mode Select OPC Device. After all the parameters have been entered confirm by clicking on the Temporary Storage button. Now in the navigation tree select: Config >> Ports >> Port X >> Output Mode Activate here the output mask Binary 1 for the respective output and confirm by clicking on the Temporary Storage button. Now the new settings still need to be activated.
W&T Release I/O devices: In this context „release“ means disconnecting the network connections to the devices so that other applications can again have access to them. Watchdog (VT_R8, R/W) is a global OPC variable, i.e. not associated with any particular I/O device. It contains a seconds value which is continually counted down if this option is enabled. As soon as a value of 0 is reached, the I/O devices are released.
W&T 3.11.6 Data model for OPC Data Access From the view of the OPC client an OPC-DA server provides a collection of named variables which can be read or written. Each variable is associated which a value, a time stamp and a signal quality, all of which are continually refreshed. In addition, variables can have other attributes written to them, item properties which for example may contain physical units or a general comment text.
W&T VT_BOOL: Binary value VT_I2, VT_I4: Whole number (16bit/32bit) R: Read-only VT_R8: Floating point number W: Write-only VT_BSTR: Character string 3.11.7 OPC variables for Web-IO Analog Each Web-IO Analog has two ports for current and/or voltage depending on the model. Configuration settings can also be used to scale a connected sensor, and instead of current or voltage the device then provides the measurement values of this sensor in any other physical unit.
W&T 3.11.8 OPC Alarms & Events Various device types (described individually below) provide not only variables for OPC Data Access, but can also provide events for OPC Alarms & Events.
W&T first received an event from this device, and you cannot know in adavance when this will happen, or whether it will happen at all.(It is not the case for example that newly connected clients are automatically greeted with an event from Category 1 or 2 for each device.). If this information needs to be reliably made available, it can be determined instead from the signal quality of the OPC-DA item of the affected device.
W&T 3.12 Local time setting 3.12.1 Time zone Define here the time zone where the device is located. The settings refer to UTC (Universal Time Coordinated). Then click on Temporary Storage.
W&T 3.12.2 Summertime If you want your device to automatically take daylight savings time into account, first enter the offset to UTC. The standard value (e.g. for Germany) is two hours. Enable this function using „Apply Summertime“ and apply the settings.
W&T Define when summer time begins and ends. The parameters are already preconfigured: Start: Last Sunday in March at 02:00 Stop: Last Sunday in October at 03:00 3.12.3 Device Clock If you do not wish to use a time server, you can set the clock manually here. Then click on „Logout“ and save your settings.
W&T i The device has an internal, battery-buffered clock, so that the time remains stored even after a device is turned off. 3.
W&T 3.13.1 Time server If you want to use a time server to adjust the time, enter the necessary information here. The preset addresses are only an example and do not necessarily have to be used. ! If you enter an address for a name, be sure that you have first configured the gateway and DNS server so that the device can resolve the addresses. Click on the „Logout“ button and save your settings.
W&T 3.14 Configuring the data logger 3.14.1 Select Select Sensor: Der hier ausgewählte Sensor wird für das Abspeichern der Werte im Datenlogger berücksichtigt. Make the following settings: Timebase: Defines at what time intervales (min. 15s) the measurement data are stored in the data logger. The device will in any case measure two values per second.
W&T 3.14.2 Clear Clicking on the „Clear memory“ button clears the entire contents of the data logger. 3.
W&T 3.15.1 Basic Settings Enable: Auto scroll enable: After opening the graphics display the measurements are automatically refreshed. The navigation buttons are not available for the Auto Scroll function. Show table: Shows the current values in table form as well. Show graph: Enables graph display of the measurements. Show control buttons: Shows the navigation buttons. Show config menu: Shows the configuration menu for the graph display below the navigation buttons.
W&T Show alarm monitor: Uses a bar graph to show whether the alarm monitor for each alarm is active or inactive. Width: Enter here the desired width of the graph display. Height: Enter here the desired height of the graph display. Frame Color: Enter here the desired color for the frame of the graph display, or select a color using the adjacent color selector: Background Color: Here you select the color of the background of the graph. This color is also used for the table display.
W&T Graphics Selection: The following parameters can be set for each sensor: Sensor X enable/disable: (Checkbox blank/filled in) Sensor Color: Enter the desired sensor color, or use the color selector to choose. Show extreme values: If a zoom level is selected in the graph display where a display point represents a measurement interval and not an individual measuring point, this function is used to show the maximum and minimum measured in this interval.
W&T Scale: The following parameters can be associated with the scale: unit: The unit to be shown for this scale. min: The lower value shown for this scale max: The upper value shown for this scale auto scale: The lower and upper values for this scale are automatically selected based on the measurement values, so that an optimal, dynamic representation can be achieved. If this function is enabled, the „min“ and „max“ parameters are ignored.
W&T 3.16 Alarms The device provides 8 alarms and a report (see separate section). Valid outputs are mail, SNMP trap, Syslog and TCP and FTP client. An alarm is triggered by the following inputs / events: Sensor 1 or 2 exceeds or falls below configurable threshold values, cold or warm start, the Box-to-Box connection is interrupted. Activation of the alarm can be made dependent on a time window. Here the desired alarm conditions are configured.
W&T 104
W&T Trigger: Define here the triggers for the alarm. Multiple selections are possible. Min./Max.: Specifies the lower and upper limit. The range within these limits is considered to be „valid“. Hysteresis: You can also specify a hysteresis value used to reset the alarm status. Example: min. 2V / max. 8V / Hysteresis 1V When a limit is violated the alarm status is reset when 7V (8-1) or 3V (2+1) is reached. This function prevents the limit value from ‚flickering‘.
W&T / : Interval within the entered range, e.g. minute „0-45/2“ triggers the timer in a range between the 0th and 45th minute every two minutes (0, 2, 4, 6 ,8, 10, ... , 44). , : Indicates an absolute value. For example: Minute 0. 15, 30 triggers the timer at each full hour, at the 15th minute and at the 30th minute. Note: All fields must be filled in for the times to be accepted. When the device detects invalid character combinations, it outputs a question mark and rejects the time.
W&T 3.17 Sending alarms via e-mail 3.17.1 Basic Settings -> Mail Here the basic settings for e-mail sending are made.
W&T The e-mail function allows you to sent an information of alarm mail to one or more e-mail or SMS recipients. Name: Enter the name you want to appear for the e-mail recipient. ReplyAddr: The reply address the device uses to identify itself. MailServer: In the next step enter the IP address of your mail server or its host name (for configured DNS servers) you want the device to use. If the e-mail port is not the same as the standard port 25, append the actual port to the address using a colon: mail.
W&T Authentication: If authentication is required on the mail server, enter here the corresponding procedure for user identification: SMTP authentication off: No authentication ESMTP: A user name and password are required in order to log in on the mail server. SMTP after POP3: For an SMTP access it is necessary first to access through POP3, so that the user can be identified. For this setting you also enter an associated POP3 server.
W&T E-Mail-Addr: Enter here the recipient‘s e-mail address. To send the e-mail to multiple recipients, separate the addresses with a semicolon. Subject & Mailtext: Specifies the subject line and mail text for the e-mail. ! Please note: No mail (neither for alarm nor for clear alarm) is sent without a mail text! In these text boxes the following tags are also accepted.
W&T W&T tag value comma spelling dot spelling (##.####) (##,####) Function Measurand 1: Displays the value for channel 1. Measurand 2: Displays the value for channel 2. Alarm active: Shows all alarms (numbers, komma separatet) which are currently active. Alarm sensor number:Shows all sensors (numbers, komma separated) which match with the configured alarm values per alarm.
W&T 3.18 SNMP incl. alarm sending per Trap Send alarm messages as SNMP trap. 3.18.1 Basic Settings -> SNMP Define here the basic settings needed for SNMP operation. Community String: Read: Using this string you can have read access to measurements in your SNMP manager. Community String: Write: Using this string you can have both read and write access to measurements in your SNMP manager. If you want to fill a field without no information, please write „public“ instead of „“.
W&T System Traps: Two system traps can be generated. Cold Start: After power is disconnected (intentionally or unintentionally) Warm Start: For device reset SNMP Enable: To use the SNMP functionality, enable this checkbox. 3.18.2 Alarm X -> SNMP Under this menu item the actual contents of the SNMP is specified.
W&T Manager IP: Contains the IP address of your SNMP manager. The device sends SNMP messages to this address. Trap Text: Specifies the text for the trap. The following tags are also accepted in these text boxes.
W&T W&T tag value comma spelling dot spelling (##.####) (##,####) Function Measurand 1: Displays the value for channel 1. Measurand 2: Displays the value for channel 2. Alarm active: Shows all alarms (numbers, komma separatet) which are currently active. Alarm sensor number:Shows all sensors (numbers, komma separated) which match with the configured alarm values per alarm.
W&T 3.19 Sending alarms per TCP (Client Mode) Send the alarm messages as a TCP datagram. 3.19.1 Alarm X -> TCP IP Addr: The IP address you want the message sent to. Port: At the receiver end there must be a TCP server service on this port which can accept incoming connections. TCP Text: The text corresponds to the same specifications as apply to the other message types.
W&T 3.19.2 Alarm to localhost It is possible that for example the channel 2 as a function of channel 1 is switched. So, first the trigger for channel 1 is configured. If this trigger is reached, the device can send a TCP alarm to itself so that channel 2 sets values. In IP-Addr. you can type in the own IP address of the device, 127.0.0.1 or localhost as the recipient. The TCP port is set to the local HTTP port (default: 80).
W&T 3.20 Sending alarms per FTP (Client Mode) Write the analog values directly to an FTP server. 3.20.1 Basic Settings -> FTP Here you find the basic settings needed for FTP mode. FTP Server IP: Enter here the IP address or host name of the FTP server you want the data to be sent to. FTP Control Port: This is the port needed for the connection. The standard port for FTP access is 21. This port is already preset and should work fine on most systems.
W&T User: Enter here the user name required for FTP access. Password: This is the password assigned to the user. FTP Account: Some FTP servers require a special Account entry for login. If this is the case with your server, enter the account name here. Options / PASV: If this option is enabled the server is instructed to operate in passive mode. This means the Web-IO opens the data connection. If this option is disabled, the FTP server handles opening of the data connection.
W&T 3.20.2 Alarm X -> FTP FTP Local Data Port: This is the local data port on the Web-IO. Valid are entries between 1 and 65536. Entering „AUTO“ causes the device to select the port dynamically. File Name: Enter here the path to the file you want the device to access. FTP Alarm Text: Specify the text for the FTP contents. The following tags are accepted in these text boxes. The device replaces these tags with the respective values: W&T tag value comma spelling dot spelling (##.
W&T STORE: Stores a file and writes the data to it. If this file already exists it is overwritten. APPEND: Appends the data to an existing file. If the file does not exist, it is created. 3.20.3 Special case: Report -> FTP If the values should be sent through FTP cyclically, then the report function can be used.
W&T 3.21 Syslog messages incl. alarm sending Send alarm messages as a Syslog message. 3.21.1 Basic Settings -> Syslog Server Server IP: The IP address you want the device to send status messages to. Syslog Server Port: A Syslog server service must be located on this port at the recipient end. This port must be able to receive incoming connections (Standard: 514). System Messages: Select which status messages you want the device to send. Enable: Enables/disables the Syslog function.
W&T 3.21.2 Alarm X -> Syslog IP Addr: The IP address you want the message sent to. Port: A Syslog server service must be located on this port at the recipient end. This port must be able to receive incoming connections (Standard: 514). Syslog Text: This text has the same specifications as apply to the other message types. Alarm Clear Text: s.o.
W&T 124
W&T 3.22 Time-based report Timer: The timer interval set here is based on the CRON service as used in Linux.Unix systems. Valid characters can be found in chapter „alrms - CRON service“. The „Report enable“ box must be checked for this function.
W&T 3.23 Check Alarm On the configuration page Diag >> Test >> Check Alarm you can test the alarms (Alarm 9 represents time based report) you set. Clicking on the „Trigger“ button for the respective alarm simulates the corresponding alarm status, so that the configured actions can be run accordingly. Clicking on the „Reset“ button returns the alarm state to its normal state (only alarm 1-8).
W&T 3.24 UP-/Download In the Download area you can download the XML configurations as well as the three user pages (home.htm, user.htm, log.htm) for further processing. With XML Download you can read out the settings of the WebIO, make any needed changes, and upload them back to the device using XML Upload. i With some Web browsers the correct code is not output until „View -> (Frame-) Show source text“ is selected after clicking the „XML Download“ button.
W&T ! ! Please note, especially for mass updates/configurations, that the IP address stored in the XML file is also sent and must then be changed accordingly. Please note when using the active input that in Output Mode “Output OFF” causes passive input mode to be set. This must then be manually reset to active input mode after the upload. This protects the hardware from inadvertent damage. In addition, the user pages (user.htm, home.htm, log.htm) can also be replaced in the Upload area.
W&T 4 Individual Measurement Polling 4.1.1 HTTP - Polling logger using a ASCII command string It is possible to manually poll the current values in CSV format using a socket connection (comma-delineated data). This function is also used to poll the individual data without using the Web interface. To do this, send the following string to Port 80: GET /logger.
W&T 4.1.2 HTTP - Controlling outputs of device You can also use a TCP client in HTTP mode to set the outputs using HTTP-GET commands. Here you use the expression: GET /outputaccessX?PW=&State=& X: Number of the output: 1=Port 1, 2= Port 2 password: If an Admin password is assigned, it must be entered here in order to be able to set the output value. If no password is assigned, leave this place blank (...?PW=&...) value: Here you enter the value you want to set on the respective output.
W&T If this box is checked the device sends its IP address in front in the reply along with the system name and sensor name. If the box is unchecked only the actual measurement values are sent. The expression for polling the respective port is: GET /SingleX X: Number of the Inputs: 1=Port 1, 2= Port 2 Example, Display with option GET Header enable: 10.40.42.
W&T 4.1.4 HTTP - Reading diagnostics infos from device For diagnostics and the error memory the following applies: GET /diagnosis Requests the status of the diagnostics memory. The Web-IO returns: diagnosis;0000;00000000;00000000;00000000 The 4-place value indicates the number of stored messages. For the three 8-place hexadecimal values each set bit represents one of the possible messages. GET /diagnosisx “x” specifies the index for the currently stored message.
W&T enable“ under „Config >> Device >> Basic Settings >> HTTP“. 4.3 Polling via SNMP The input/output can be directly polled or set using SNMP Get instructions. Reach the respective port using the following paths: 1.3.6.1.4.1.5040.1.2.28.1.3.1.1.1 = Output value 1 as Octet String (Read/Write). 1.3.6.1.4.1.5040.1.2.28.1.4.1.1.1 = Output value as integer value in thousandths, not comma delineated (Read/ Write). 1.3.6.1.4.1.5040.1.2.28.1.3.1.1.
W&T If you want to change settings (IP address, subnet mask, etc.) or output values in the device via SNMP, you must first use your SNMP manager to start a session on the device. Entering the Administrator password into the variable wtWebGraphAnalog57661SessCntrlPassword or wtWebGraphAnalog57662SessCntrlPassword opens a session. Reading out the variable wtWebGraphAnalog57661SessCntrlConfigMode allows you to check whether the session was successfully opened.
W&T Administrator rights loses his browser access as soon as an SNMP session is opened. The description for the individual SNMP variables, OIDs etc. can be found in the private MIB.
W&T 5 Including Measurements in your own Web Page It is possible to use an implemented Java applet to integrate the measured values on your own Web page. The applet is refreshed every 60s. An example for this applet can be found here in the device itself: http://172.0.0.10/app.htm To incorporate the applet for the analog value monitoring in the HTMP page, the following HTML tag must be inserted at the point where the applet is located:
W&T resp. „off“ on and off. The standard value is „off“. Once all parameters have been entered, the HTML tag must be closed using geschlossen werden. Example: