This document is property of SENECA srl. Duplication and reprodution are forbidden, if not authorized. Contents of the present documentation refers to products and
technologies described in it. All technical data contained in the document may be modified without prior notice Content of this documentation is subject to periodical
revision.
To use the product safely and effectively, read carefully the following instructions before use. The product must be used only for the use for which it was designed and
built. Any other use must be considered with full responsibility of the user. The installation, programmation and set-up is allowed only for authorized operators; these
ones must be people physically and intellectually suitable. Set up must be performed only after a correct installation and the user must perform every operation described
in the installation manual carefully. Seneca is not considered liable of failure, breakdown, accident caused for ignorance or failure to apply the indicated requirements.
Seneca is not considered liable of any unauthorized changes. Seneca reserves the right to modify the device, for any commercial or construction requirements, without
the obligation to promptly update the reference manuals.
Page 1
(Other) This document is property of SENECA srl. Duplication and reprodution are forbidden, if not authorized. Contents of the present documentation refers to products and technologies described in it. All technical data contained in the document may be modified without prior notice Content of this documentation is subject to periodical revision.
1 Preliminary information / Informazioni preliminari WARNING! IN NO EVENT WILL SENECA OR ITS SUPPLIERS BE LIABLE FOR ANY LOST DATA, REVENUE OR PROFIT, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, REGARDLESS OF CAUSE (INCLUDING NEGLIGENCE), ARISING OUT OF OR RELATED TO THE USE OF OR INABILITY TO USE Z-TWS4/Z-PASS2-S/S6001-RTU, EVEN IF SENECA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Page 7
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Date Revision Notes 06/09/2016 - Chapter "Features": new features forZ-PASS2-S-R01 - Chapter "LEDs signalling": new par. " Z-PASS2-S-R01" - New chapter "Ethernet Mode (Z-PASS2-S-R01)" - Chapter: "Discovering the IP address": network parameters setting - Chapter "Upgrading the firmware by a USB pen": revision - Par.
Page 8
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU - OpenVPN, Configuration File: added rules on “dev” and “log” options - StratON FBs and Functions, new paragraphs: S7_DB_READ, S7_DB_WRITE 23/05/2017 - Chapter "Features": new features for Z-PASS2-S-IO - New “LEDs signaling” sub-paragraph for IO HW revision - New chapter “Remote Access Disable”...
Page 9
- Chapter “Technical specifications”: updated info about modem - Removed “None” value of “Security Level / Service Disable” parameter. 15/03/2018 - Removed CTS signal from COM1 port (Z-TWS4, Z-PASS2-S) - Added parts related to Z-TWS4-IO 30/07/2018 - Paragraph “Router Configuration”: new “Ethernet Bandwidth (FW rel.
Z-PASS2-S and S6001-RTU integrate a 3G HSPA modem. S6001-RTU is equipped with a rich set of analog and digital inputs/outputs. Z-PASS2-S, S6001-RTU and Z-TWS4 (when connected to an external modem) can be used as a Router, routing packets between the WAN (Mobile Network) and the LAN (Ethernet).
Maximum connection length 100 m In Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO, the two ports can work either as LAN/WAN ports (ETH1=LAN, ETH2=WAN) or ports of an Ethernet switch. In Z-TWS4/Z-PASS2-S, the two ports can work only as ports of an Ethernet switch. USB #1 HOST...
Page 12
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU RS 232 Baud rate: maximum 115 Kbps, minimum 110 bps COM 1 (DB9 male connector) Optional Bus for future extensions screw terminals 60-61-62 Ethernet Ethernet 10/100 Mbps RJ45 connector Maximum connection length 100 m USB #1 HOST...
Page 13
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 4G (LTE Cat. 1) MODEM (Z-PASS2-S-IO-4G) LTE FDD: max 10 Mbps (DL), max 5Mbps (UL) Speed LTE TDD: max 8.96 Mbps (DL), max 3.1 Mbps (UL) DC-HSPA+: max 42Mbps (DL), max 5.76 Mbps (UL) UMTS: max 384 Kbps (DL), max 384 Kbps (UL) EDGE: max 296 Kbps (DL), max 236.8 Kbps (UL)
Page 14
Rear IDC10 connector for DIN 46277 rail Removable 4 pin connector Two RJ45 connectors Type A USB connector and micro USB connector (only in Z-TWS4) Plug in: micro SD card Two SMA antenna connectors: - for Main and Diversity antennas (only in Z-PASS2-S, Z-PASS2-S-R01)
Page 15
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Digital Outputs Max. number of channels: 4 Voltage (+Vext): 10 – 24VC Max. current delivered: 400mA INPUTS / OUTPUTS (S6001-RTU) Analog inputs 4, current, 0..20 mA resolution: 12 bit accuracy: += 0.3% of full scale input impedance: 50 Ω...
The Device has two RS 485 serial ports for Modbus communication: COM 4 and COM 2. The RS485 connection for COM 2 can be set up by means of the corresponding screw terminals or by the IDC10 connector. On Z-TWS4, to select...
Page 17
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The Z-TWS4 has a CAN port available on screw terminals 10-11-12. As an alternative, the connection can be set up on the IDC10 connector. To select CAN port on IDC10 connector, put the SW1 DIP-switch on ON position.
Page 18
4 (top) The Device has a USB HOST type A connector, that can be used as an additional serial port (using a Seneca S117P1, for example) or to connect an external USB memory; this is used for FW upgrade (see chapter 17).
Page 19
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The Device has two Ethernet ports with RJ45 connectors on the front panel. The two ports are internally connected in HUB/SWITCH mode. The two ports have the same MAC Address. The Device has a plug-in connector for micro SD card placed in the side part of the case.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 4.1.1 Z-TWS4-IO Digital I/Os In Z-TWS4-IO, the electrical connections for the Digital Inputs shall be arranged as in the following figures. The electrical connections for the Digital Outputs shall be arranged as in the following figure. 4.1.2...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The electrical connections for the Digital Outputs shall be arranged as in the following figure. 4.2 S6001-RTU Power supply must be connected to screw terminals 52 and 53. The supply voltage must be 24 ± 15 % Vac/dc (any polarity).
Page 22
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Signal COM2 COM4 An RS232 serial port with full handshaking signals is available on DB9 male connector on the left side of S6001-RTU. Use the CS-DB9F-DB9F cable to connect RS232 devices. Signals on DB9 connector are listed in the table below.
Page 23
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Analog inputs and outputs are available on screw terminals 43-50, as shown in the following figure and table. 4 analog current inputs (0-20 mA) Four active sensors are available from 43 to 46 screw terminals. Screw terminal 49 is a supply voltage (+12 Vdc) for passive current sensor.
Page 24
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The 8 digital outputs (relays) are available on screw terminals 71-94, as shown in the following figure. Eight SPDT relays are available to control, for example, external pumps. The operating voltage is 250 Vdc @ 2 A.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 5 LEDs signaling 5.1 Z-TWS4, Z-PASS2-S Status Meaning PWR Green The module is powered on RUN Red Blinking The module is ready for use LINK1 Yellow Ethernet 1 connection detected Ethernet 1 connection absent ACT1 Green...
Page 26
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Yellow SWITCH Green The Ethernet ports are working in “Switch” mode VPN Yellow VPN connection is working properly Blinking VPN connection is not working properly VPN functionality is disabled or VPN Box/Point-to-Point functionality is enabled but no client is connected or...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 5.3 Z-PASS2-S-IO Status Meaning PWR Green The module is powered on RUN Green Blinking The module is ready for use DIDO1 Green Configurable Digital Input/Output 1 state is HIGH Configurable Digital Input/Output 1 state is LOW...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU No data transmission (COM 2-4) 3G PWR Green The 3G Modem is powered on STAT Yellow Slow blinking (200 ms OFF, Searching for GSM network 1800 ms ON) Slow blinking (1800 ms OFF, Registered on GSM network...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU VPN Box/Single LAN functionality is enabled but the Device is not configured LAN/WAN The Ethernet ports are working in “LAN/WAN” mode Green The Ethernet ports are working in “Switch” mode SERV Green VPN Box “SERVICE” connection is working properly Blinking VPN Box “SERVICE”...
Z-TWS4/Z-PASS2-S/S6001-RTU devices come out of the factory with the default 192.168.90.101 IP address on the Ethernet network interface. If this address is changed, and forgotten, it can be retrieved by running the “Seneca Device Discovery” (SDD) application, as shown in the following figure:...
Page 31
This application shows the IP address, MAC address, FW version and some other useful information, for every Z-TWS4/Z-PASS2-S/S6001-RTU device (and other Seneca products) found in the LAN. Moreover, by clicking on the “Assign” button, it is possible to change the network configuration parameters of a device, as shown in the following figure: For security reasons, this feature can be disabled on the Device (see paragraph 18.1.2);...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The SDD can be easily installed by running the installer program available at the following link: http://www.seneca.it/products/sdd NOTE: - when the Device is working in “Switch” mode, the IP Address shown by the SDD is the same regardless of the Ethernet port which the PC running the SDD is connected to;...
(SFC), Function Block Diagram (FBD), Ladder Diagram (LD), Structured Text (ST), Instruction List (IL). With StratON IDE, it’s simple to write, download and debug IEC 61131-3 code. 8.1 Writing, downloading and running the first program To let the PLC developer easily create StratON applications for Seneca CPUs, the following libraries are available: ...
Furthermore, two project templates are available for Z-PASS2-S and S6001-RTU CPUs, respectively. An installer program, called “Seneca StratON Package setup”, is available which automatically installs the above Seneca libraries and templates. The installer can also be used to install the StratON IDE and Z-NET4 SW (see chapter 20).
Page 35
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Then, import the Library (menu “Tools / Import”):...
Page 36
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Save the library (menu “File / Save Library”). The procedure to add the “Profiles library” to the IDE is identical to the one just explained; the only difference that SenecaStratonProfiles.XL5 file shall selected (instead SenecaStratonLibrary.XL5 file).
Page 37
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The UDFB library is provided as a zip file, containing the following folders: TWS_MISC ZPASS2_Template S6001_Template The TWS_MISC folder shall be copied into the following directory: C:\Users\Public\Documents\Copalp\STRATON\LIBS The ZPASS2_Template and S6001_Template folders shall be copied into the following directory:...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 8.1.2 Creating a project for Seneca CPUs Run the StratON IDE and create a new project based on a template, as in the following figure:...
Page 39
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Select the “ZPASS2_Template” (or “S6001_Template”) in the template list. Now, as you can see in the following figure, in the Main program a ZMODEM_MNG UDFB instance is already available, which lets you easily control the Z-PASS2-S/S6001-RTU modem.
Page 40
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Set the correct target IP address (for example 192.168.85.106); normally, the port shall be set to 502: Then press the icon: to compile the project. Download the code by pressing the icon:...
Page 41
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The project file will be placed into the /disk directory of the Device. If the Straton project is not based on “ZPASS2_Template”/”S6001_Template”, the Seneca UDFB library can still be used, as described in the following. In the Straton IDE, go to the “Project Settings” window, shown below (menu “Project/Settings”):...
Page 42
Now, the UDFB library is available in the project, as shown in the following figure: If the Straton project has been built using the Seneca Z-NET4 SW (see chapter 20), the TWS_MISC is already included, so the above procedure is not needed.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In particular, when using S6001-RTU CPU, Z-NET4 SW provides a simple way to create the base Straton project; in fact, all the variables corresponding to the CPU I/Os will be inserted in the project, as shown in the following figure.
GPS not fixed; variables contain not updated, possibly invalid, values - GPS_ERROR = -2 some error has occurred; variables contain invalid values 8.1.4 Z-TWS4-IO profile The “ZPASS_DIO” profile is available also for Z-TWS4-IO, providing variables corresponding to the available Digital I/Os, as shown in the following figure.
Seneca for further information. The StratON PLC provides a “Redundancy” functionality: when this feature is enabled, two CPUs (Z-TWS4 or Z-PASS2-S or S6001-RTU) run the same StratON application; the two CPUs connect each other via the Ethernet, in order to keep variables, state-machines etc.
Please see paragraph 18.1.2 for a description of the configuration parameters related to StratON Redundancy. 9 Ethernet Mode (Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO) In Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO products, the two available Ethernet ports can be configured as two fully separated network interfaces (“LAN” and “WAN”) or, as in the older versions, they can work as...
Page 47
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU ports of an Ethernet switch; the user can choose between the “LAN/WAN” mode and the “Switch” mode, by means of a configuration parameter (“Ethernet Mode”) (see paragraph 18.1.2). The “LAN/WAN” mode is needed when the “industrial” network connected to the LAN interface (comprising e.g.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 10 VPN Z-TWS4/Z-PASS2-S/S6001-RTU support the standard OpenVPN protocol. The main advantages that come from using a VPN are: secure connections, since transported data are encrypted; the ability to establish connections without interfering with the corporate LAN;...
Page 49
If the VPN infrastructure does not exist yet, the advisable choice is to adopt the “VPN Box” solution, developed by Seneca. The “VPN Box” is an hardware appliance (or a virtual machine) which lets the user easily setup two alternative kinds of VPN: “Single LAN”...
LAN” case) or to a specific device (in the “Point-to-Point” case) A detailed description of “VPN Box” can be found in the “VPN Box User Manual”. A detailed description of Z-TWS4/Z-PASS2-S/S6001-RTU VPN configuration parameters is given in 18.1.4 paragraph. The following two sub-paragraphs give some more info about the two kinds of VPN.
In this scenario a PC (acting as a VPN Client) can connect, on demand, to only one Device and its subnet, using local IP addresses. Since the client “sees” just one Z-TWS4/Z-PASS2-S/S6001-RTU (and attached devices) at time, the same subnet configuration can be assigned to different sites, without creating conflicts.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The “VPN Client Communicator” application retrieves the list of devices which are available for the logged user; then the user can select one device on the list and connect to it. 11 Network Redundancy “Network Redundancy” is a functionality than can be enabled on the Device when a 3G modem is available (true for Z-PASS2-S and S6001-RTU).
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 12 Router As already told before, “Router” functionality routes packets between the WAN (Mobile Network) interface and the LAN (Ethernet) interface and vice versa; so, this functionality especially makes sense when a 3G connection is active, which needs the availability of a 3G modem (true for Z-PASS2-S and S6001-RTU).
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 13 Remote Connection Disable Z-PASS2-S-IO and Z-TWS4-IO products provide a dedicated digital input and a dedicated digital output to control and monitor remote connection to the device. In details: when “Remote Connection Disable” digital input is set to HIGH state, remote connection to the device is disabled;...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU To handle M-Bus devices, the following resources are provided: the “M-Bus” section web pages the MBUS_READ_CTL function the MBUS_WRITE_RAW function block The M-BUS web pages lets you scan the bus, searching for devices, detecting either their primary addresses or secondary addresses;...
7) remove the USB pen 18 Web Configuration Pages NOTE: in this chapter, the web pages screen-shots are shown for only one of the products (Z-TWS4, Z- PASS2-S, Z-PASS2-S-R01, Z-PASS2-S-IO, S6001-RTU); the pages for the other products are identical, except for the product name shown in the top of the pages and for some details explained in the following paragraphs.
18.1.2 Network and Services The parameters shown in this page slightly change, depending on the HW version of the product (Z- TWS4/Z-PASS2-S or Z-PASS2-S-R01 or Z-TWS4-IO/Z-PASS2-S-IO) and, for new HW versions, on the selected “Ethernet Mode”; this is shown in the following figures.
Page 59
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a Z-PASS2-S-IO, when the “Ethernet Mode” parameter is set to “Switch” ; it also applies to a Z-TWS4-IO in “Switch” mode.
Page 60
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a Z-PASS2-S-IO, when the “Ethernet Mode” parameter is set to “LAN/WAN” it also applies to a Z-TWS4-IO in “LAN/WAN” mode.
Page 61
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a Z-PASS2-S-R01, when the “Ethernet Mode” parameter is set to “Switch”.
Page 62
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a Z-PASS2-S-R01, when the “Ethernet Mode” parameter is set to “LAN/WAN”.
Page 63
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a S6001-RTU; it also applies to a Z-TWS4 and Z-PASS2-S (old version). There is an important difference between the parameter values shown in this page and those shown in the...
Page 64
This parameter is available only for Z-PASS2-S-R01, Z-PASS2-S-IO and Z-TWS4-IO products. For all other products, only “Switch” mode is available, hence the parameter is not shown. Ethernet Mode = “Switch”...
Page 65
When “Ethernet Mode” is set to products “LAN/WAN”, the Default Gateway shall be in the WAN subnet. NETWORK/DNS Mode Tells if the DNS Server shall be set DHCP, for Z-TWS4-R0x and Z- statically (value: “Static”) PASS2-S-R0x (x=1,2) dinamically assigned by the DHCP Static, for all other products Server (value: “DHCP”)
Page 66
IP Address used as ping destination 8.8.4.4 Address to check if access to the Internet through the primary interface (Ethernet) is available. This address shall be different from the one set for “DNS Server” The correct License Key string is provided by Seneca.
Page 67
Z-MBUS (Meter extension) RS232 and Z-MBUS parameters are available only for Z-TWS4-IO and Z- PASS2-S-IO products. Some notes about the “DHCP” parameters: the “DHCP” parameter can be set to “ON” only if the “DHCP Server” parameter of the “Router Configuration”...
Page 68
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Depending on the LAN configuration, a login may be needed to access the shared folder; if so, use the credentials shown in the following figure (username: “\guest”, password: “” [empty]). 18.1.3 Real Time Clock Setup By clicking on the “Real Time Clock Setup” link, in the “General Configuration” menu, you come to the...
Page 70
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This page is made up of two sections: “NTP” and “RTC”. In the “NTP” section, you can change the parameters related to the Network Time Protocol and to the Time Zone, as listed in the following table:...
Page 71
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Field Meaning Default value NTP/Enable Flag enable/disable time synchronization by means of NTP protocol NTP/Primary Server IP address or FQDN of the Primary ntp1.inrim.it NTP Server NTP/Secondary Server IP address or FQDN of the Secondary ntp2.inrim.it...
Page 72
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The “RTC” section of the page lets you manually change the Device date/time settings; since this makes sense only if NTP time synchronization is not enabled, when “NTP/Enable” parameter is “ON” the input fields and the “SET CLOCK” button are disabled and the parameters are only for viewing.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.4 VPN Configuration By clicking on the “VPN Configuration” link, in the “General Configuration” menu, you come to the following page: The page has a different layout depending on the value of the “VPN Mode” parameter, which can be “OpenVPN”...
Page 74
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The “VPN Files” section lets you load the files needed to configure Open VPN and establish a secure VPN connection; these files are described in the following. 18.1.4.1.1 Configuration File This file shall contain all the information needed to configure the Open VPN behaviour; the main configuration options are ...
Page 75
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU the transport protocol (UDP or TCP) the server IP address/host name and port the files needed to perform authentication procedures etc. This file has the .ovpn extension (in Windows systems) or .conf extension (in Linux systems); regardless of the original name, it will be renamed as ovpn.conf on the Device.
Page 76
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
Page 77
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU You can check which VPN files are stored on the Device by clicking on the “SHOW VPN STATUS” button, as shown in the following figure (remember that the configuration file is renamed as “ovpn.conf”): As reminded by the web page, the VPN files can be downloaded from the Device, if needed, via FTP/SFTP;...
Page 78
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Is is possible to clear all the VPN files, by clicking on the “RESET” button; a pop-up will appear, requiring a confirmation: If VPN is enabled, the user is not allowed to delete VPN files, as warned by the following pop-up: In the “VPN Configuration”...
Page 79
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Device will run the Open VPN process with loaded configuration As already told above, if you try to enable the VPN connectivity, but no configuration file has been uploaded to the Device yet, an error is given as shown in the following figure: When you click on the “SHOW VPN STATUS”...
Page 80
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU the IP address assigned to the VPN interface when “Connected”, the “dummy” IP address “0.0.0.0” when “Disconnected” the “OpenVPN Status” (i.e.: “Stopped” or “Running”) the number of packets/bytes received from the VPN interface, when connected; “0/0” when disconnected ...
Page 81
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU An important status information is given by the “OpenVPN Status” field; if VPN is enabled (“ON”), but this status is “Stopped”, Open VPN process could not be correctly started: probably, the configuration file contains some errors or, maybe, some options not supported by the Device Open VPN implementation.
Page 82
3 system verb 3 18.1.4.1.8 LED signalling (Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO) In Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO products, when VPN functionality is enabled in “OpenVPN” mode, the “SERV” and “VPN“ LEDs give the following status information (see chapter 5): Status Meaning VPN Yellow VPN connection is working properly...
Page 83
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU VPN functionality is disabled SERV Green Not used 18.1.4.2 VPN Box The page contains only ony section: “VPN Box”, as shown in the following figure.
Page 84
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The “VPN Box” section contains the following parameters: Field Meaning Default value VPN BOX/Enable Flag to enable/disable the “VPN Box” functionality, that is the procedure/protocol that lets the...
Page 85
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Device setup the VPN, by interacting with the “VPN Box” server (see “VPN Box User Manual”) VPN BOX/Server IP address or FQDN of the “VPN Box” 192.168.90.1 server VPN BOX/Password Password to access the “VPN Box”...
Page 86
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
Page 87
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
Page 88
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU For an explanation of the differences between a “Single LAN” VPN and a “Point-to-Point” VPN, see chapter The “VPN Box Status” string has the following format:...
Page 89
Finally, you can hide the “VPN Status” section, by clicking on the “HIDE VPN STATUS” button. 18.1.4.2.1 LED signalling (Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO) In Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO products, when VPN functionality is enabled in “VPN Box/Single LAN” mode, the “SERV” and “VPN“ LEDs give the following status information (see chapter 5):...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Blinking VPN connection is not working properly The Device has not been configured by the VPN Box yet or VPN Box functionality is disabled SERV Green VPN Box “SERVICE” connection is working properly Blinking VPN Box “SERVICE” connection is not working properly VPN Box functionality is disabled Similarly, when VPN functionality is enabled in “VPN Box/Point-to-Point”...
Page 91
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can change the parameters related to the Router functionality. First, you have a set of general parameters, as listed in the following table: Field Meaning Default value Router Enable Flag to enable/disable the Router...
Page 92
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU large amount of data is forwarded from one interface to the other (LAN ↔ WAN). Since this does not occur when the two ethernet interfaces work in “switch” mode, the parameter is not shown when “Ethernet Mode”...
Page 93
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU assigned to the Mobile Network (3G) interface. To open a port in the firewall, a “Port Mapping / Virtual Server” rule shall be defined. The above parameter shall be set to ON, to protect the Device against undesired (maybe malicious) accesses.
Page 94
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Finally, there are 5 sections which let you define up to 5 “Port Mapping” rules (also known as “Virtual Servers”); in each section, the available parameters are the following: Field Meaning Default value Protocol This parameter defines the transport...
Page 95
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU originally sent to Server IP Address IP address which the received packet Empty is forwarded to Internal Port TCP or UDP port which the received Empty packet is forwarded to If Router is left disabled (Router Enabled = OFF), you can still change parameters; changes will be saved without actually applying them (except for the “Mobile Network Firewall”...
Page 96
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU If you try to enable the DHCP server functionality (DHCP Server Enable = ON), but the “DHCP First Address” and “DHCP Last Address” parameters define an address range that is not congruent with the Ethernet configuration (IP address and network mask), an error is given, as shown in the following figure:...
Page 97
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU As already told before, the Router configuration page lets you define up to 5 “Port Forwarding” rules or “Virtual Servers”. An example is given in the following figure:...
Page 98
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this example, 2 rules have been set: the first rule tells the Device that any TCP packet received on the 80 (HTTP) port has to be forwarded to the 8080 port, leaving the original destination IP address unchanged; so, this rule lets you access the Device configuration web site on the standard HTTP port;...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU and to the SSH console, through the public IP address assigned to the 3G interface, the 8080 and 22 TCP ports shall be open; this can be done as shown in the following figure. 18.1.6 OPC UA Server Configuration By clicking on the “OPC UA Server Conf”...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can set the parameters related to the OPC Unified Architecture (OPC UA), as listed in the following table: Field Meaning Default value Enable Enable or not Port The server port to use...
Page 101
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can change the “Web Administrator”, “Web User”, “Web Guest” and “FTP User” credentials, as explained in the following table: Field Meaning Default value WEB ADMINISTRATOR/Username Username access admin configuration site (full access)
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU WEB ADMINISTRATOR/Password Password access admin configuration site (full access) WEB USER/Username Username access user configuration site (limited access) (see paragraph 18.2) WEB USER/Password Password access user configuration site (limited access) (see paragraph 18.2) WEB GUEST/Username Username...
Page 103
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Now, if you want to leave this page without performing the FW upgrade, the “RESTART TWS SERVICES” button lets you restart the TWS services which, otherwise, would remain in the “stopped” state. Otherwise, if you click on the “Cancel” button of the pop-up, TWS Services are not stopped and you come...
Page 104
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU So, it is up to the user to choose if Soft PLC shall be stopped or not, during FW Upload; on one side, stopping it is more safe and let the upload be completed in a shorter time; on the other side, there are...
Page 105
Since an erroneous use of the FW Upgrade functionality might compromise the proper Device operation, use this page only to apply upgrades provided by Seneca, with the support of Seneca personnel. This page lets you browse your PC to select the file containing the FW, which shall have a name of the following type: SW002940_xxx.bin...
Page 106
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Once a file is selected, you can start the upload, by pressing the “UPLOAD” button.
Page 107
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Once the upload is successfully completed, the following page is shown:...
Page 108
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can: press the “Upgrade and Reboot” button: this will start the upgrade procedure, which takes some minutes to be completed; during this time, the Device MUST NOT be switched off; during the...
Page 109
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU procedure, the Device will be rebooted several times; also, during the procedure, several LEDS will blink simultaneously ; the upgrade procedure is ended when only the LED “RUN” is blinking This applies only to products with HW revisions IO and R01; in details: for IO HW revision, all LEDs will blink simultaneously, except for Power, LAN/WAN, COM and modem LEDs;...
Page 110
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU press the “Cancel and Reboot” button: this will delete the uploaded file on the Device and perform the reboot.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.9 Configuration Management By clicking on the “Conf. Management” link, in the “General Configuration” menu, you come to the following page:...
Page 112
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This page lets you save and load the whole Device configuration; this is very useful, for example, when you have to apply the same configuration to many devices. The configuration archive file is named SW002940_conf.tar.gz; its contents depend on the selected option,...
Page 113
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Please note that, to get detailed debug logs, the “DEBUG LOGS / Enable” parameter, in “Network and Services” page, shall be set to ON. 18.1.9.1 Factory reset by USB pen A USB pen can be used also to reset the Device to its factory state; the procedure is the following:...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU create an empty file named SW002940_reset_cmd into the root of the USB pen; switch off the Device; insert the USB pen into the USB#1 port of the Device; switch on the Device; the procedure will take some minutes to be completed; during this time, the Device MUST NOT be switched off;...
Page 115
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This page lets you change the IP Address and TCP Port of the Modbus TCP Client (“Open MODBUS”) in the “Fieldbus Configurations” of the Straton project; the change can be done without the need of recompiling...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU To apply the parameters set in this page to the “Open MODBUS” configuration, the string “mbtcpcli_params” shall be written in the “Address” field. It should be noted that the value of the “Port” field is overwritten with the one set in the “Modbus TCP Client Configuration”...
Page 117
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The above figure shows the “Mobile Network” page for Z-PASS2-S-IO. For Z-PASS2-S-R01, Z-PASS2-S and S6001-RTU, the “Operator Selection” section and the “GET OPERATOR LIST” button are not available, so the page is as shown in the following figure.
Page 118
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can change the parameters related to the Mobile Network, as listed in the following table: Field Meaning Default value SIM/PIN (if required by SIM) PIN needed to unlock the SIM card, 1234...
Page 119
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU on it Operator Selection/Mode This parameter tells if the modem shall Automatic (only on Z-PASS2-S-IO) select the Mobile Network Operator: automatically (Mode=Automatic) as selected by the user (Mode=Manual) reverting to “automatic” mode, if “manual” selection fails (Mode =...
Page 120
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU is “None” Data Connection/Password Password needed for UMTS/GPRS pass connectivity, as given by the Mobile Network Operator; it may be empty, if “Authentication Type” parameter is “None” Data Connection/Ping Connection FQDN or IP address used to www.google.com...
Page 121
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
Page 122
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU As shown in the above figures, only for Z-PASS2-S-IO, the last row of the “Mobile Status” gives the “GPS Location” as Latitude,Longitude values; clicking on the link, the Google Maps on the current position are shown.
Page 123
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU If the GPS signal is not available, the “GPS Location” row contains the string “Not fixed” and the link is not shown. The following figure shows the situation when an error in PIN setting has occurred, due to a wrong value of...
Page 124
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU It should be noted that, when the PIN is set during procedures automatically performed by the Device firmware, if the number of remaining attempts is 1, no more attempt is done to avoid blocking the SIM.
Page 125
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU You can hide the “Mobile Status” section, by clicking on the “HIDE MOBILE STATUS” button. As already told above, the “GET OPERATOR LIST” button lets you retrieve the list of the operators currently available, that is detected by the modem (only on Z-PASS2-S-IO).
Page 126
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Tipically, it takes about 1 minute to get the list, so the page shows the number of seconds elapsed.
Page 127
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU When the procedure is completed, the following page is shown.
Page 128
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU After some seconds, the page automatically evolves to the “Mobile Network” page, with the operator list filled, as shown in the following figure.
Page 129
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU You can choose an operator from the list, to perform “Manual” or “Manual/Automatic” selection.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.12 DDNS Configuration By clicking on the “DDNS Configuration” link, in the “Mobile Configuration” menu, you come to the following page:...
Page 131
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can set the parameters related to the Dynamic DNS service, as listed in the following table: Field Meaning Default value Type Type of None Dynamic DNS service; possible values are: None dyndns.it dyndns.org...
Page 132
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU When an IP address assigned to the Mobile Network Interface has been bound with the hostname, the “DDNS Update Status” section appears like in the following figure.
Page 133
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
By clicking on the “Digital I/O Configuration” link, in the “Digital I/O” menu, you come to the page described in the following sub-paragraphs ; the page differs between Z-TWS4-IO and Z-PASS2-S-IO: 18.1.13.1 Z-PASS2-S-IO This page is available only for Z-TWS4-IO and Z-PASS2-S-IO products.
Page 135
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, you can configure the operating modes of the Digital I/Os and the security level applied by the “Remote Connection Disable” feature (see chapter 13). Field Meaning Default value Input 1 Mode This parameter...
Page 136
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU operating mode of the Digital Input 1 (DI 1). Since this is the digital input used for “Remote Disable” Connection feature, value (“Remote connection disable”) cannot be changed. Output 1 Mode This parameter represents Remote connection active operating mode of the Digital Output 1 (DO 1).
Page 137
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU description of these values. The “Digital I/O Status” section of the page gives the current status values (“LOW”/”HIGH”) for each of the six available digital I/Os.
Page 138
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The status of the digital input configured as “Local Alarm” is reported in the “ALARM” column in the “Devices” tab of the “Seneca VPN Box Manager” and “Seneca VPN Client Communicator” applications.
Page 139
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.13.2 Z-TWS4-IO In this page, you can configure the operating modes of the Digital I/Os and the security level applied by the “Remote Connection Disable” feature (see chapter 13). Field Meaning Default value Output 1 Mode...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Since this is the digital output used to monitor remote connection, its value (“Remote connection active”) cannot be changed. Output 2 Mode This parameter represents General output operating mode of the Digital Output 2 (DO 2).
Page 141
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The following parameters are shown: Field Meaning Values DIGITAL INPUTS/Input 1..Input 15 Status of Digital Input LOW/HIGH DIGITAL OUTPUTS/Output Status of Digital Output (relay) OPEN/CLOSED 1..Output 8 DIGITAL OUTPUTS/12 Volt Enable Status of Digital Output enabling 12...
Page 142
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Current 4 ANALOG OUTPUT/Current Value of analog current output (in 0..20000 ANALOG OUTPUT/Voltage Value of analog voltage output (in 0..10000 ELECTRODES/Level Liquid level value 0,1,2 ELECTRODES/Sensitivity Sensitivity value applied in liquid 0..255 level measurement (in kΩ)
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.15 FW Versions By clicking on the “FW Versions” link, in the “Diagnostics” menu, you come to the following page:...
Page 144
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, the following information are shown: the product name along with its HW revision (in the above figure: “Z-PASS2-S-R01”) the version strings of all the FW components, which are: o Linux Kernel (kernel)
Default Disk File System (diskdfl) o Disk File System (disk) 18.1.16 Ethernet Interfaces By clicking on the “Ethernet Interfaces” link, in the “Diagnostics” menu, you come to the following page: The above figure applies to a Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO CPU, when the “Ethernet Mode” is “LAN/WAN”.
Page 146
Ethernet interface, when the link is up; “0/0” when the link is down For Z-TWS4, Z-PASS2-S, S6001-RTU and for Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO when the “Ethernet Mode” is “Switch”, the “Ethernet Interfaces” page is similar to the one shown in the following figure.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page, for the one available Ethernet interface, the following information is shown: the number of packets/bytes received from the Ethernet interface the number of packets/bytes sent to the Ethernet interface You can refresh the Ethernet status, by clicking on the “REFRESH” button.
Page 148
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This page shows a table containing a row for each Modbus RTU Slave modules configured in the Z- NET4 /Straton project; each row contains the following information: a progressive index the Modbus Slave Address ...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.18 M-Bus Scan By clicking on the “M-Bus Scan” link, in the “M-Bus” menu, you come to the following page.
Page 150
To let these procedures properly work, you have to: connect the Seneca “Z-MBUS” RS232-MBUS adapter to the COM1 serial port; set the COM1 mode to Z-MBUS (see paragraph 18.1.2). The “SECONDARY SCAN” button lets you scan the bus, detecting M-Bus secondary addresses; select the correct baud-rate for the COM1 serial port or select “All”...
Page 151
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The scan procedure may take several minutes to be completed, so the page shows the number of seconds elapsed; the devices are shown in term of their secondary address and baud rate as soon as they are detected.
Page 152
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The baud rate value shown in the table header remembers the parameter choice for the last scan procedure. The table with the detected M-Bus devices is stored in a permanent way, so after switching off and on the CPU, the results of the last scan are still available;...
Page 153
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this page: - the first table contains only one row, providing the “slave information”; - the second table contains a variable number of rows, each providing a “data record”. By clicking on the “REFRESH” button, you can refresh the data; by clicking on the “BACK” button, you come back to the page with the devices table.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this way you have stored the actual M-BUS configuration. The webserver than move automatically to the next “M-Bus Configuration” page. 18.1.19 M-Bus Configuration When you have pressed the “Create Configuration” in the M-Bus Scan page you will obtain the following...
Page 155
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The scan result can now be edited. The 1st column represent the Straton Tag Prefix name for the device. The 2nd column represent the Baud Rate to use. The 3rd column represent the Device Address. The 4 column represent the Scan Rate in seconds for this device.
Page 156
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Now the tags automatic acquisition process will start: At the end of the process a zip file (mbus_tags.zip) will be downloaded: The zip contain 4 files: Two of these files must be used in Straton: mbus_shm.csv (the shared memory configuration)
Page 157
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Extract the zip file in a directory. Now launch Straton PLC: Select Main then Global Variables: Now click the right mouse button and select “Edit Variables as Text”:...
Page 158
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Select the “mbus_vars.csv” file and click “save”: The variables are imported:...
Page 159
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Now we must create the shared memory used for sharing the data from M-BUS: Click on fieldbus icon: Click with the right mouse button and select “Insert Configuration”:...
Page 160
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Now create the Embedded Shared Memory: Insert a Master/Port:...
Page 161
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The Shared configuration MUST be (don’t change any setting): Now insert the data Block: Create a name group (use the name that you want): Then import the shared memory file:...
Page 162
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Select the “mbus_shm.csv” file:...
Page 163
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.19.2 Delete unused M-BUS variables For delete one or more variables clear the variables and the corresponding shared memory entry: Note that in the shared memory the offsets of others variables are not changed: 18.1.19.3 Replace a M-BUS Device For Replace an existing M-BUS device (for example in case of a replace for failure) 1.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.19.4 Adding a M-BUS Device 1. Go to M-BUS Scan and make a Secondary or Primary Scan 2. Take note of the new address and baudrate 3. Go to M-BUS Configuration and manually add the address and baudrate of the new device with the “ADD”...
Page 165
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU...
Page 166
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This page shows the contents of the SD card which, typically, is used to store “Data Logs” files; these files are created by the “Data Logger” functionality available in Z-NET4 “Telecontrol Functions” (see chapter 20). The page lets you perform the following operations: ...
Page 167
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU uploading a file, selecting it by means of the “Choose file” button or dragging it into the dashed area; the file is created in the folder currently shown clean the SD, by means of the “Clean SD” button; please note that this is done by formatting the SD, so all SD contents will be lost If an SD card is not available on the Device, the “Logs”...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.2 User pages It is also possible to access the Device configuration site as a “non-administrator” user; this user is allowed to access only the “Main View” and “Network and Services” pages, viewing and setting only a limited number of configuration parameters;...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.2.1 Main View In this page, some Network parameters and the Web User credentials are shown, with their current values. To change the parameter values, you have to go to the “Network and Services” page, described in the...
18.2.2 Network and Services The parameters shown in this page slightly change, depending on the HW version of the product (Z- TWS4/Z-PASS2-S or Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO) and, for new HW versions, on the selected “Ethernet Mode”; this is shown in the following figures.
Page 171
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO, when the “Ethernet Mode” parameter is set to “Switch”; it also applies to a Z-TWS4 and Z-PASS2-S (old versions) and to a S6001-RTU.
Page 172
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The previous figure shows the “Network and Services” page for a Z-PASS2-S-R01/Z-PASS2-S-IO/Z-TWS4-IO, when the “Ethernet Mode” parameter is set to “LAN/WAN”. There is an important difference between the parameter values shown in this page and those shown in the “Main View”...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU interface (disabled when “DHCP on WAN” is set to “ON”) NETWORK/WAN Network Mask Network mask of the WAN 255.255.255.0 Ethernet interface (disabled when “DHCP on WAN” is set to “ON”) NETWORK/Default Gateway Default Gateway address 192.168.100.1 , for Z-TWS4-...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.3 Guest pages It is also possible to access the Device configuration site as a “guest” user; this user is allowed to access all the pages except for “FW Upgrade”, “Configuration Management”” and “Data Logs” pages, viewing all configuration parameters and status information, without changing any parameter;...
Page 175
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU and, when asked, provide the following credentials (default values): Username: guest Password: guest You come to the “Main View” page, shown in the following figure.
Page 176
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Note that, as told above, the “FACTORY DEFAULT”, “RESTART” and “CLEAN INTERNAL DATA LOGS” buttons are disabled. Another example of a page accessed by the “guest” user is given in the following figure.
STATUS”/”HIDE MOBILE STATUS” and “REFRESH” buttons are enabled, letting the “guest” user to view the Mobile Status. 19 Seneca StratON Library To let the users exploit Z-TWS4/Z-PASS2-S/S6001-RTU features in their IEC 61131-3 programs, Seneca has developed a set of “Function Blocks” and Functions, supplied with the Seneca library for StratON.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In this chapter, all the FBs and functions available on Z-TWS4/Z-PASS2-S/S6001-RTU are listed, providing a description of input/output parameters and some notes for each of them. 19.1 Function Blocks 19.1.1 General FB behavior The description given in this paragraph apply to all the FBs available on Z-TWS4/Z-PASS2-S/S6001-RTU, except for the LINUX_SHELL FB, which has a particular behavior (see related paragraph).
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU - PASSWORD : password for authentication - REM_FILE : name of the file (with path) on the remote server - LOC_FILE : name of the file (with path) on the local device - @ENABLE : TRUE ->...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.4 GET_ALARMS This FB retrieves all alarm records with the specified status from the DB; the records are written as lines into the specified file. INPUTS: - STATUS : this parameter is handled as a "negative bitmask", meaning that this FB will provide alarm records such that: (alarms.stat &...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.5 GET_SMS The GET_SMS FB gets an SMS, previously received, by means of a GSM modem; once read, the SMS is deleted. When first called, the FB runs a process which starts getting the SMS; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.6 LINUX_SHELL Seneca FB for access to the Linux Shell. Max 255 command line characters. For access to the output use "> output.txt" Shell_cmd : string command @Enable : if true execute the shell command Result : the return value of the "system"...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU - RESULT : -2, when called with ENABLE=FALSE -1, in case of any failure 0, if the process is still running 1, if the process has successfully finished 2, if timeout has expired - CMD_RESULT: command exit code 19.1.8 MBUS_WRITE_RAW...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU - RESULT : -2, when called with ENABLE=FALSE -1, in case of any failure 0, if the process is still running 1, if the process has successfully finished 2, if timeout has expired 5, if MBUS_READ_DATA or MBUS_WRITE_RAW FB is running - ERROR : this parameter is meaningful when RESULT=-1;...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU (NOTE: this only means that the command was successfully sent and the response was successfully received; it does not necessarily mean that the AT command was successfully executed; in other words, it is up to the application to tell if the...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The MODEM_RESET FB sends an AT reset command to the GSM modem and waits for a specified time. When first called, the FB runs a process which starts sending the command; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The PPP_CONNECT FB performs PPP connection setup or release, by means of a GPRS/UMTS modem. When first called, it runs a process which starts the connection setup or release; on subsequent calls, it only checks if the process has finished its job.
Page 188
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The PPP_CONNECT_R2 FB performs PPP connection setup or release, by means of a GPRS/UMTS modem. When first called, it runs a process which starts the connection setup or release; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU - TIMEOUT : timeout, in seconds - @ENABLE : TRUE -> FB is executed FALSE -> FB is skipped When CONNECT=FALSE, GPRS_APN, USERNAME, PASSWORD and PING_HOST parameters can be empty. The FB has the following output parameters:...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.15 PUT_ALARM This FB stores an alarm record into the DB; the "index" and "timestamp" fields are set by the FB; the "status" field is set to 0 by the FB. The FB is also responsible for keeping the DB size (number of records) under a specified limit (e.g.: 1000).
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.16 S7_DB_READ This FB performs an S7 protocol Data Block read operation. It connects to the specified S7 server IP address, rack and slot, performs the operation and then disconnects. The data read are written to the Straton shared-memory specified in the SHM_NAME parameter.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.17 S7_DB_WRITE This FB performs an S7 protocol Data Block write operation. It connects to the specified S7 server IP address, rack and slot, performs the operation and then disconnects. The data to be written are read from the Straton shared-memory specified in the SHM_NAME parameter.
465, for SMTPS) - CRYPTO_ON : if cryptography (SSL) shall be used (FALSE -> SMTP, TRUE -> SMTPS) (CRYPTO_ON=TRUE is available only for Z-TWS4/Z-PASS2-S) - AUTH_ON : if authentication shall be executed - AUTH_USERNAME : username for authentication - AUTH_PASSWORD : password for authentication...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.19 SEND_SMS The SEND_SMS FB sends an SMS, by means of a GSM modem. When first called, it runs a process which starts sending the SMS; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.20 SERVICE_CTRL The SERVICE_CTRL FB enables or disables connection services, based on the required service level. When first called, it runs a process which starts the procedure; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.21 SET_ALARMS_STAT This FB sets the value of the "status" field for the alarm records specified by the passed arguments. INPUTS: - STATUS : this parameter is handled as a bitmask, meaning that the status of the relevant alarm records will be set as: alarms.stat = (alarms.stat | STATUS), where:...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.22 TIME_SYNC The TIME_SYNC FB performs time synchronization, by means of the NTP protocol. When first called, the FB runs a process which starts performing the synchronization; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The FB has the following input parameters: - SERVER_ADDR : OPC UA Server URL (e.g.: opc.tcp://192.168.90.2:53530/OPCUA/SimulationServer) - USER_NAME : user name for authentication - USER_PSW : password for authentication - @ENABLE : TRUE -> FB is executed FALSE ->...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This Function Block can be used to read a tag from an OPC-UA Server. When first called, it runs a process which starts the procedure; on subsequent calls, it only checks if the process has finished its job.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The FB has the following output parameters: - RESULT : -2, when called with ENABLE=FALSE -1, in case of any failure 0, if the process is still running 1, if the process has successfully finished 19.1.27 VPNBOX_STATUS This FB provides information about the VPN Box functionality.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.2.1 FM_WRITE_NCRLF Same behaviour as FM_WRITE but without inserting final CR-LF Input parameters: - ID: id of the file (already open) - IN: string to write into the file Output parameters: - OK: boolean result value: (TRUE:success, FALSE:failure) 19.2.2 TXBAPPENDFILE...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU This function returns the current number of minutes since January 1, 2000 0:00:00, if DATETIME is empty or DATETIME is not a valid date/time; otherwise, it returns the number of minutes since January 1, 2000 0:00:00, corresponding to DATETIME.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.2.5 WDOG_KEEP_ALIVE This function restarts the HW Watchdog timer. NOTICE: once enabled, the HW Watchdog cannot be disabled; the WDOG_KEEP_ALIVE function shall be called to restart the timer; if timeout elapses, an HW reboot is triggered.
-2: watchdog controlled by system ("WATCHDOG/Enable" parameter set to "ON") 20 Z-NET4 When using Z-TWS4/Z-PASS2-S/S6001-RTU with Modbus RTU I/O Modules, a very useful and powerful tool is provided by the Z-NET4 program suite, running on Windows PCs. Among other things, these programs let you: ...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 21 Access to Straton variables The aim of this chapter is to explain how an application (typically, web-based) can access the variables of the Straton Soft-PLC running on Z-TWS4/Z-PASS2-S/S6001-RTU. Currently, there are two ways to access Straton variables: ...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU The list of variables in the shared-memory, along with their properties, can be saved to / loaded from a csv file; the format of this file is as in the following example: "NAME";"OFFSET";"SIZE";"FORMAT";"MODE";"ERROR_REPORT" "VarINT";"0";"2";"0";"2";"CPU_ErrorReport_dummy" "VarUINT";"2";"2";"1";"2";"CPU_ErrorReport_dummy" "VarDINT";"4";"4";"0";"2";"CPU_ErrorReport_dummy"...
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU Note that the above code will print shared-memory byte values, without any knowledge of the variables properties. Indeed, it is important to understand that the shared-memory contains only the variables values; the variables properties shall be retrieved, for example, by loading them from the csv file, shown above.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU In the Device FW, a daemon is running which: parses the CGI requests reads/writes the requested variables from/to the shared-memory gives back the values/results in the CGI responses Two CGIs are defined, one to read and one to write variables, as described in the following.
USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU request goform/writeVariable?nVars=1&var1=M1_Output_1&value1=1 response (successful case): # M1_Output_1 response (failure case): # M1_Output_1 5 Operation timeout The CGI can be extended to write N variables (N>1), for example to write 2 variables: goform/writeVariable?nVars=2&var1=<var_name1>&var2=<var_name2>&value1=<va r_value1>&value2=<var_value2> The response contains N sections with the format described above.
Need help?
Do you have a question about the Z-TWS4 and is the answer not in the manual?
Questions and answers