Hide thumbs Also See for Z-TWS4:
Table of Contents

Advertisement

Quick Links

USER MANUAL
SENECA s.r.l.
Via Austria, 26 – 35127 – Z.I. CAMIN – PADOVA – ITALY
Tel. +39.049.8705359 – 8705408 Fax. +39.049.8706287
Web site:
Support:
Sales:
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.
Z-TWS4
Z-PASS2-S
S6001-RTU
www.seneca.it
supporto@seneca.it
(IT),
commerciale@seneca.it
MI003773
MI003770_121
Page 1
support@seneca.it
(Other)
(IT),
sales@seneca.it
(Other)

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Z-TWS4 and is the answer not in the manual?

Questions and answers

Summary of Contents for Seneca Z-TWS4

  • 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.
  • Page 2: Table Of Contents

    Table of contents ............................... 2 Preliminary information / Informazioni preliminari .................. 6 Features ..............................10 Technical specifications ........................... 11 Electrical Connections ..........................16 Z-TWS4, Z-TWS4-IO, Z-PASS2-S, Z-PASS2-S-R01, Z-PASS2-S-IO ............16 4.1.1 Z-TWS4-IO Digital I/Os ......................20 4.1.2 Z-PASS2-S-IO Digital I/Os ......................20 S6001-RTU ............................
  • Page 3 USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU M-Bus (ONLY Z-TWS4-IO and Z-PASS2-S-IO) ..................54 OPC Unified Architecture (OPC UA) protocol ..................55 Upgrading the firmware by USB pen ....................55 Web Configuration Pages ........................56 18.1 Administrator pages ........................56 18.1.1 Main View ..........................57 18.1.2...
  • Page 4 USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 19.1.3 FTP_PUT ..........................179 19.1.4 GET_ALARMS ......................... 180 19.1.5 GET_SMS ..........................181 19.1.6 LINUX_SHELL .......................... 182 19.1.7 LINUX_SH_ASYNC ........................182 19.1.8 MBUS_WRITE_RAW....................... 183 19.1.9 MODEM_CTRL ........................184 19.1.10 MODEM_ONOFF ........................ 185 19.1.11 MODEM_RESET ......................... 185 19.1.12 PPP_CONNECT ........................
  • Page 5 USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 21.1 Shared Memory ..........................205 21.2 C program example ........................206 21.3 CGI ..............................208 21.3.1 CGI “readVariable” ........................ 209 21.3.2 CGI “writeVariable” ....................... 209 Glossary ............................. 210...
  • Page 6: Preliminary Information / Informazioni Preliminari

    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.
  • Page 10: Features

    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).
  • Page 11: Technical Specifications

    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 Ω...
  • Page 16: Electrical Connections

    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.
  • Page 20: Z-Tws4-Io Digital I/Os

    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...
  • Page 21: S6001-Rtu

    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.
  • Page 25: Leds Signaling

    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...
  • Page 27: Z-Pass2-S-Io

    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...
  • Page 28: Z-Tws4-Io

    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...
  • Page 29: S6001-Rtu

    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”...
  • Page 30: Discovering The Ip Address

    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);...
  • Page 32: Ftp/Sftp Access

    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;...
  • Page 33: Straton Plc

    (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: ...
  • Page 34: Seneca Libraries And Templates Installation

    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:...
  • Page 38: Creating A Project For Seneca Cpus

    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.
  • Page 43: Z-Pass2-S-Io Profiles

    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.
  • Page 44: Z-Tws4-Io Profile

    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.
  • Page 45: Energy Management Protocols

    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.
  • Page 46: Ethernet Mode (Z-Pass2-S-R01/Z-Pass2-S-Io/Z-Tws4-Io)

    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.
  • Page 48: Vpn

    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”...
  • Page 50: Single Lan" Vpn

    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.
  • Page 51: Point-To-Point" 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.
  • Page 52: Network Redundancy

    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).
  • Page 53: Router

    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).
  • Page 54: Remote Connection Disable

    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;...
  • Page 55: Opc Unified Architecture (Opc Ua) Protocol

    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;...
  • Page 56: Web Configuration

    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.
  • Page 57: Main View

    USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU 18.1.1 Main View In this page, main Device configuration parameters are shown, with their current values.
  • Page 58: Network And Services

    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...
  • Page 69: Real Time Clock Setup

    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.
  • Page 73: Vpn Configuration

    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):...
  • Page 90: Router Configuration

    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;...
  • Page 99: Opc Ua Server Configuration

    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”...
  • Page 100: Users Configuration

    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)
  • Page 102: Fw Upgrade

    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.
  • Page 111: Configuration Management

    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:...
  • Page 114: Modbus Tcp Client Configuration

    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...
  • Page 116: Mobile Network

    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.
  • Page 130: Ddns Configuration

    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...
  • Page 134: Digital I/O Configuration

    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...
  • Page 140: I/O View (S6001-Rtu)

    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Ω)
  • Page 143: Fw Versions

    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)
  • Page 145: Ethernet Interfaces

    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.
  • Page 147: Modbus Modules

    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 ...
  • Page 149: M-Bus Scan

    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.
  • Page 154: M-Bus Configuration

    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.
  • Page 164: Data Logs

    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”...
  • Page 168: User

    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;...
  • Page 169: Main View

    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...
  • Page 170: Network And Services

    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”...
  • Page 173: I/O View (S6001-Rtu)

    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-...
  • Page 174: Guest

    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.
  • Page 177: Seneca Straton Library

    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.
  • Page 178: Function Blocks

    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).
  • Page 179: Ftp_Put

    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 ->...
  • Page 180: Get_Alarms

    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 &...
  • Page 181: Get_Sms

    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.
  • Page 182: Linux_Shell

    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"...
  • Page 183: 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 - CMD_RESULT: command exit code 19.1.8 MBUS_WRITE_RAW...
  • Page 184: Modem_Ctrl

    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;...
  • Page 185: Modem_Onoff

    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...
  • Page 186: Ppp_Connect

    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.
  • Page 187: Ppp_Connect_R2

    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.
  • Page 189: Ppp_Status

    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:...
  • Page 190: Put_Alarm

    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).
  • Page 191: S7_Db_Read

    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.
  • Page 192: S7_Db_Write

    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.
  • Page 193: Send_Mail

    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...
  • Page 194: Send_Sms

    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.
  • Page 195: Service_Ctrl

    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.
  • Page 196: Set_Alarms_Stat

    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:...
  • Page 197: Time_Sync

    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.
  • Page 198: Uac_Disconnect

    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 ->...
  • Page 199: Uac_Write

    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.
  • Page 200: Vpnbox_Status

    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.
  • Page 201: Fm_Write_Ncrlf

    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...
  • Page 202: Mbus_Read_Ctl

    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.
  • Page 203: Wdog_Keep_Alive

    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.
  • Page 204: Net4

    -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: ...
  • Page 205: Access To Straton Variables

    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: ...
  • Page 206: C Program Example

    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"...
  • Page 207 USER MANUAL – Z-TWS4/Z-PASS2-S/S6001-RTU printf (" /offset= Memory offset\n"); return 0; if (strncmp (argv[i], "/name=", 6) == 0) strcpy (szName, (argv[i] + 6)) ; else if (strncmp (argv[i], "/size=", 6) == 0) wSize = atoi (argv[i] + 6); else if (strncmp (argv[i], "/offset=", 8) == 0) wOffset = atoi (argv[i] + 8);...
  • Page 208: Cgi

    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.
  • Page 209: Cgi "Readvariable

    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.
  • Page 210: Glossary

    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.

This manual is also suitable for:

Z-pass2-sS6001-rtuZ-pass2-s-ioZ-tws4-ioZ-pass2-s-r01

Table of Contents