Seneca Z-KEY User manual

Page 1
MI003790
MI00379_10
SENECA s.r.l.
Via Austria, 26 –35127 –PADOVA –ITALY
Tel. [phone] Fax. [phone]
Web site: www.seneca.it
Technical assistance: supp[email protected] (IT), [email protected] (Other)
Commercial reference: [e-mail] (IT), [e-mail] (Other)
This document is property of SENECA srl. Duplication and reproduction 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,
implementation 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.
No liability for the contents of this documents can be accepted. Use the concepts, examples and other content at your own risk. There
may be errors and inaccuracies in this document, that may of course be damaging to your system. Proceed with caution, and although
this is highly unlikely, the author(s) do not take any responsibility for that. Technical features subject to change without notice.
USER MANUAL
Z-KEY / Z-KEY WIFI
MODBUS ETHERNET SERIAL GATEWAY
AND SERIAL DEVICE SERVER

USER MANUAL –Z-KEY / Z-KEY WIFI
2
Date
Revision
Notes
06/02/2015
00
First revision.
31/03/2015
01
Added Export tag setup Webserver function, added
Seneca discovery and Easy Z-KEY utilities.
08/04/2015
02
Added Glossary.
Added Z-modem protocol issue through internet
Minor fix
14/07/2015
03
Added support for 7 bits Uarts (from SW004100_105)
20/11/2015
04
Added CGI command chapter
18/05/2016
05
Added Gateway Optimzed function from revision
Firmware 4100_108
Added Chapter Easy Setup APP for Android
Added Chapter Seneca Discovery Device
Updated Seneca Device Discovery Chapter
01/12/2016
06
Removed WARNING about using multi TCP Clients in
Bridge mode
02/11/2017
07
Changed PDF title
03/05/2018
08
Changed document to new code: from MI00379x to
MI00379_xx
Updated for Firmware revision 119
02/10/2018
09
Added Modbus Register
-LAST_LOOP_TIME_COM1
-LAST_LOOP_TIME_COM2
In the extended diagnostic
20/02/2020
10
Updated for Firmware revision 300 (Z-KEY):
-New: Serial Sniffer
-New: Added support to Seneca Cloudbox HTTP REST APIs

USER MANUAL –Z-KEY / Z-KEY WIFI
3
-New: Gateway Serial to Ethernet
-New: Modbus ASCII supported
-New: Added new product Z-KEY WIFI

USER MANUAL –Z-KEY / Z-KEY WIFI
4
Table of Contents
1. GLOSSARY..................................................................................................................8
2. INTRODUCTION.........................................................................................................10
2.1. Features........................................................................................................................................................10
3. ELECTRICAL CONNECTIONS..................................................................................12
3.1. Terminal Positions ........................................................................................................................................12
4. DEBUG LEDS (Z-KEY)...............................................................................................14
5. DEBUG LEDS (Z-KEY WIFI)......................................................................................14
6. DEFAULT (FACTORY) CONFIGURATION................................................................15
7. ETHERNET COMMUNICATION.................................................................................17
7.1. Searching Z-KEY / Z-KEY WIFI devices in a network with the Seneca Discovery Utility ..................................17
7.2. Changing the IP address from the USB port...................................................................................................18
8. WIFI CONNECTION (ONLY Z-KEY-WIFI MODEL)....................................................21
8.1. Wifi mode: Access Point................................................................................................................................22
8.1. Wifi mode: Station ........................................................................................................................................22
8.2. Wifi mode: First Configuration Access Point..................................................................................................22
9. THE EMBEDDED WEBSERVER................................................................................23
9.1. Access to the webserver ...............................................................................................................................23
10. WEBSERVER WIFI CONFIGURATION FOR Z-KEY-WIFI (ONLY Z-KEY-WIFI) ...25
11. MODBUS RTU / ASCII AND MODBUS TCP-IP PROTOCOL.................................26
11.1. Modbus function code supported .................................................................................................................26

USER MANUAL –Z-KEY / Z-KEY WIFI
5
12. GATEWAY MODBUS TCP-IP TO MODBUS RTU/ASCII .......................................28
12.1. How it works.................................................................................................................................................29
12.2. Modbus Gateway Webserver configuration..................................................................................................29
13. GATEWAY WITH SHARED MEMORY ...................................................................34
13.1. Gateway with shared memory Modbus TCP-IP / Modbus RTU (Port 1 and Port 2 Modbus Master)..............35
13.2. Gateway with shared memory Modbus TCP-IP / Modbus RTU (1 port Master and 1 port Slave) ..................37
13.2.1. How it works ............................................................................................................................................... 38
13.3. Gateway with shared memory Modbus TCP-IP / Modbus RTU (2 port Slaves) ..............................................39
13.3.1. How it works ............................................................................................................................................... 40
13.4. Gateway with shared memory Modbus TCP-IP / Modbus MIX RTU-TCP-IP ...................................................41
13.5. Modbus Gateway with shared memory configuration ..................................................................................42
13.5.1. Modbus Gateway with shared memory HTTP POST configuration ............................................................ 46
13.6. Simplified Tags Diagnostic.............................................................................................................................47
13.7. Extended Tags Diagnostic..............................................................................................................................48
13.8. Modbus Gateway Tags Setup, export and import .........................................................................................49
13.9. Modbus Gateway Real Time view .................................................................................................................52
13.10. Using the Microsoft Excel ™ template for Tags setup................................................................................52
14. GATEWAY SERIAL TO ETHERNET ......................................................................55
14.1.1. HOW IT WORKS...........................................................................................................................................55
14.1. Modbus Gateway Serial to Ethernet Webserver configuration .....................................................................56
15. EXTEND RS485 OVER ETHERNET: MODBUS SERIAL TO ETHERNET AND
THEN ETHERNET TO SERIAL.........................................................................................61
16. REMOTE SERIAL COM PORT ...............................................................................61
16.1. How it works.................................................................................................................................................62
16.2. Remote Serial Com Port Webserver configuration ........................................................................................62
16.3. Seneca Serial to Ethernet Connect ................................................................................................................67
16.3.1. Installing Seneca Serial to Ethernet Connect driver....................................................................................67
16.3.2. Select the Com port for Seneca Serial to Ethernet Connect....................................................................... 69
16.3.3. Configuring Seneca Serial to Ethernet Connect.......................................................................................... 71

USER MANUAL –Z-KEY / Z-KEY WIFI
6
16.3.4. Debugging the Connection .........................................................................................................................71
16.3.5. Changing the COM port number................................................................................................................. 72
17. TRAFFIC MONITOR (NOT FOR “REMOTE SERIAL COM” MODE) .....................77
18. INSTALLING MULTIPLE Z-KEY / Z-KEY WIFI IN A NETWORK USING THE
“DHCP FAIL MODE” ........................................................................................................79
19. THE CUSTOM WEBSERVER.................................................................................79
20. ACCESSING THE Z-KEY / Z-KEY WIFI FROM INTERNET...................................80
21. THE KIT-USB ..........................................................................................................82
22. THE RS232 DB9 CABLE ........................................................................................82
23. WINDOWS USB DRIVERS INSTALLATION ..........................................................83
24. FIRMWARE UPDATE..............................................................................................85
24.1. Firmware Update from Webserver ...............................................................................................................85
24.2. Firmware Update from FTP server ................................................................................................................85
24.3. Firmware Update from microSD card............................................................................................................86
25. SENECA DISCOVERY DEVICE..............................................................................86
26. EASY SETUP APP FOR ANDROID........................................................................87
27.CGI (COMMON GATEWAY INTERFACE) COMMAND..........................................88

USER MANUAL –Z-KEY / Z-KEY WIFI
7
Seneca Z-KEY / Z-KEY WIFI
CAUTION!
UNDER ANY CIRCUMSTANCES, SENECA S.R.L. OR ITS SUPPLIERS SHALL NOT BE RESPONSIBLE FOR
LOSS OF RECORDING DATA/INCOMES OR FOR CONSEQUENTIAL OR INCIDENTAL DAMAGE DUE
TO NEGLECT OR RECKLESS MISHANDLING OF Z-KEY / Z-KEY WIFI, EVEN THOUGH SENECA IS WELL
AWARE OF THESE POSSIBLE DAMAGES.
SENECA, ITS SUBSIDIARIES, AFFILIATES, COMPANIES OF THE GROUP, ITS SUPPLIERS AND
RETAILERS SHALL NOT GUARANTEE THAT THE FUNCTIONS WILL SATISFY COMPLETELY
CUSTOMER’S EXPECTATIONS OR THAT Z-KEY / Z-KEY WIFI, THE FIRMWARE AND THE SOFTWARE
SHALL HAVE NO ERRORS OR WORK CONTINUOUSLY.

USER MANUAL –Z-KEY / Z-KEY WIFI
8
1. Glossary
Modbus RTU
An open protocol for the serial communications developed by Modicon Inc. (AEG Schneider Automation
International S.A.S.). Simple and robust, it has since become a de facto standard communication protocol.
For more info http://www.modbus.org/specs.php
Modbus ASCII
A variant or the Modbus RTU protocol where the communication is in ASCII format.
For more info http://www.modbus.org/specs.php
MODBUS TCP-IP
The Modbus RTU protocol with a TCP interface that runs on Ethernet.
For more info http://www.modbus.org/specs.php
MODBUS BRIDGE
A device that translates, in real time, from Modbus TCP-IP ethernet protocol to Modbus RTU serial
protocol.
MODBUS GATEWAY
A device that translate Modbus TCP-IP protocol to Modbus RTU protocol using a buffered memory (called
shared memory). The shared memory can be accessed by multiple devices through Modbus TCP-IP,
Modbus RTU, Webservers etc… but must be configured. The Modbus Gateways are used for speed-up and
for simplify a Modbus network.
SERIAL DEVICE SERVER (REMOTE COM PORT)
A device that enables devices with an RS-232, RS-422 or RS-485 serial interface to connect to an IP network.
This makes it possible to use Ethernet in place of serial cables, minimizing workstation clutter and also
allowing serial devices to be placed far away from the computers with which they are used. A Serial device
server is virtually transparent to the serial protocol.

USER MANUAL –Z-KEY / Z-KEY WIFI
9
MODBUS RTU MASTER-SLAVE
The Master is connected with one or more slaves, the slave waits for an incoming register(s) request from
the master. Only one master is allowed, for overcome this limitation you must use a Modbus gateway.
MODBUS TCP-IP CLIENT-SERVER
The Client (called Master in Modbus RTU) establishes a connection with the Server (called Slave in Modbus
RTU). The Server waits for an incoming connection from the Client. Once a connection is established, the
Server then responds to the registers queries from the Client.
WEBSERVER
A software that store, process and deliver web pages to clients. Clients web can be PCs, Smartphones, Tablets
with a browser (Chrome, Internet Explorer, Firefox etc…).

USER MANUAL –Z-KEY / Z-KEY WIFI
10
2. Introduction
Z-KEY is composed from:
Nr 2 independent serial ports (one RS485 and a RS232/RS485 configurable port)
Nr 1 Fast Ethernet 10-100MBits
Nr 1 USB port
the Z-KEY WIFI also include a WIFI connection.
The USB port can be used also like a communication port supporting the Modbus RTU protocol for
configuration purpose.
An internal Webserver is also available for configuration and real time values view, a custom webserver con
be loaded into a microSD card (not supplied).
Z-Key is configurable in 7 different modes:
Gateway Modbus TCP-IP to Modbus RTU / ASCII
Gateway with shared memory Modbus TCP-IP to Modbus RTU / ASCII
Gateway with shared memory Modbus TCP-IP to Modbus RTU / ASCII (1 port slave and 1 port
Master)
Gateway with shared memory Modbus TCP-IP to Modbus RTU / ASCII (2 ports slaves)
Gateway Modbus TCP-IP and Modbus RTU / ASCII to HTTP POST (Cloudbox)
Gateway Modbus RTU / ASCII to Modbus TCP-IP
Remote Serial COM port
Z-KEY WIFI con also be configured with the Wifi port in Station or Access Point mode (up to 6 Station
Devices can be connected).
2.1. Features
Z-KEY MODEL:
Fast Ethernet port (10-100 Mbit/s)
Support for Transparent Remote Serial Port, Modbus Gateway (real time bridge), Modbus gateway
with shared memory
HTTP POST protocol data send (Seneca Cloudbox supported)
Multiprotocol Gateway, Bridge support: Modbus TCP-IP server protocol (by the fast Ethernet), Modbus
RTU master/slave independent configurable on the NR 2 serial ports (NR 1 RS485, and NR 1
RS232/RS485).
Transparent Ethernet to serial connection with Seneca Ethernet to serial driver connection, no protocol
dependent.
Internal webserver for complete configuration
Up to 8 simultaneous client Modbus TCP-IP supported (Bridge or Gateway mode)
Up to 10 simultaneous server Modbus TCP-IP supported (Gateway mode)
Gateway mode: up to 500 Modbus TAG (up to 1000 Modbus registers)
Export/Import Tags setup from Webserver
Export/Import Tags setup to Excel™ template
USB port for changing IP address configuration
Customizable embedded Webserver with CGI support on microSD card
Configurable by Webserver or by USB (Easy setup software)
Replica of the Modbus registers on TCP-IP protocol, Modbus RTU

USER MANUAL –Z-KEY / Z-KEY WIFI
11
Baud rate for Modbus RTU: from 1200 baud up to 115200 baud
1500 Vac galvanic isolation between power supply and communication
Quick installation on DIN 46277 rail
Removable screw terminals with section of 2.5 mm2
Firmware update by internal Webserver, FTP server or microSD card
Z-KEY WIFI MODEL:
Fast Ethernet port (10-100 Mbit/s)
WIFI Port with WPA2, WPA and WEP encryption
WIFI Station (WPA2, WPA or WEP encryption) or Access Point Mode (WEP encryption)
Support for Transparent Remote Serial Port, Modbus Gateway (real time bridge), Modbus gateway
with shared memory
HTTP POST protocol data send (Seneca Cloudbox supported)
Multiprotocol Gateway, Bridge support: Modbus TCP-IP server protocol (by the fast Ethernet), Modbus
RTU master/slave independent configurable on the NR 2 serial ports (NR 1 RS485, and NR 1
RS232/RS485).
Transparent Ethernet to serial connection with Seneca Ethernet to serial driver connection, no protocol
dependent.
Internal webserver for complete configuration
Up to 8 simultaneous client Modbus TCP-IP supported (Bridge or Gateway mode)
Up to 10 simultaneous server Modbus TCP-IP supported (Gateway mode)
Gateway mode: up to 500 Modbus TAG (up to 1000 Modbus registers)
Export/Import Tags setup from Webserver
Export/Import Tags setup to Excel™ template
USB port for changing IP address configuration
Customizable embedded Webserver with CGI support on microSD card
Configurable by Webserver or by USB (Easy setup software)
Replica of the Modbus registers on TCP-IP protocol, Modbus RTU
Baud rate for Modbus RTU: from 1200 baud up to 115200 baud
1500 Vac galvanic isolation between power supply and communication
Quick installation on DIN 46277 rail
Removable screw terminals with section of 2.5 mm2
Firmware update by internal Webserver, FTP server or microSD card

USER MANUAL –Z-KEY / Z-KEY WIFI
12
3. Electrical Connections
For more info please refer to the Installation manual, downloadable from www.seneca.it in the Z-KEY \ Z-
KEY WIFI section.
3.1. Terminal Positions
For power ON Z-KEY / Z-KEY WIFI, connect the screw terminal 2-3 or use the Seneca BUS for connect the
IDC10 connector:
The RS485#1 is available from the IDC10 connector
The RS485/RS232 port #2 is available from the screw terminals 10-11-12:

USER MANUAL –Z-KEY / Z-KEY WIFI
13
For configure port 2 in RS485 mode set the SW2 to OFF:
For configure port 2 in RS232 mode set the SW2 to ON:
Note: before to insert the cable into RJ45 connector, remove the protection rubber:
Micro USB port for a PC connection:

USER MANUAL –Z-KEY / Z-KEY WIFI
14
4. Debug Leds (Z-KEY)
LED
STATE
MEANING
TX1
FLASHING
Data transmission on RS485
port #1
RX1
FLASHING
Data reception on RS485 port
#1
TX2
FLASHING
Data transmission on
RS485/RS232 port #2
RX2
FLASHING
Data reception on
RS485/RS485 port #2
PWR
ON
Z-KEY is POWERED ON
SD
FLASHING
ACCESSING TO THE SD CARD
ETH TRF
FLASHING
Data traffic on Ethernet port
ETH LINK
ON
Ethernet port connected
5. Debug Leds (Z-KEY WIFI)
LED
STATE
MEANING

USER MANUAL –Z-KEY / Z-KEY WIFI
15
TX1
FLASHING
Data transmission on RS485
port #1
RX1
FLASHING
Data reception on RS485 port
#1
TX2
FLASHING
Data transmission on
RS485/RS232 port #2
RX2
FLASHING
Data reception on
RS485/RS485 port #2
PWR
ON
Z-KEY WIFI is POWERED ON
SD
FLASHING
ACCESSING TO THE SD CARD
ETH TRF
FLASHING
Data traffic on Ethernet port
ETH LINK
ON
Ethernet port connected
4 LED
ON
Signal Strenght 0 = MIN 4 =
MAX
AP
FLASHING
Wifi in Access Point for first
configuration (without
user/password)
AP
ON
Wifi in Access Point mode
ST
ON
Wifi in Station mode
6. Default (Factory) Configuration
The default (factory) configuration is:
IP STATIC: 192.168.90.101
Gateway: 192.168.90.1
Mode: Modbus RTU Gateway on port 1 and port 2
For return to the default configuration:
1) Switch off Z-KEY / Z-KEY WIFI
2) Move to “ON” all the dip switched:

USER MANUAL –Z-KEY / Z-KEY WIFI
16
3) Switch ON Z-KEY / Z-KEY WIFI
4) Wait 10 seconds
5) Switch OFF Z-KEY / Z-KEY WIFI
6) Switch OFF all the dip switches:
Now Z-KEY / Z-KEY WIFI is loaded with the default configuration.

USER MANUAL –Z-KEY / Z-KEY WIFI
17
7. Ethernet communication
The Z-KEY / Z-KEY WIFI include a fast Ethernet port (10-100Mbit), the TCP-IP integrated protocol supports:
-Static IP address or DHCP
-Gateway support
-Modbus TCP-IP server protocol (support up to 8 Modbus TCP-IP client at the same time)
-Webserver (with user / password protection)
The default configuration for the Ethernet port is:
Static IP address 192.168.90.101
Gateway 192.168.90.1
All the functionality are also available from the Wifi Connection
WARNING!
BEFORE CONNECT Z-KEY / Z-KEY WIFI ON THE NETWORK BE SURE THAT THE IP ADDRESS 192.168.90.101
IT’S NOT USED BY ANOTHER ETHERNET DEVICE!
WARNING!
DON’T CONNECT MORE THAN 1 Z-KEY / Z-KEY WIFI WITH THE DEFAULT IP ADDRESS ON THE NETWORK! IF
YOU NEED TO CONNECT MORE THAN ONE Z-KEY IN A NETWORK SIMULTANEOUSLY REFERS TO THE
CHAPTER 18.
7.1. Searching Z-KEY / Z-KEY WIFI devices in a network with the Seneca
Discovery Utility
From the seneca website (www.seneca.it) in the Z-KEY section you can freely download the Seneca
Discovery Utility for obtain the actual Z-KEY / Z-KEY WIFI ip address in your network.
Click on Search for start the discovery process:

USER MANUAL –Z-KEY / Z-KEY WIFI
18
A list of devices found will be displayed:
7.2. Changing the IP address from the USB port
From the seneca website (www.seneca.it) in the Z-KEY / Z-KEY WIFI section you can freely download the
Seneca Easy Setup software.
The Z-KEY section launch the EASY Z-KEY Utility for changing or obtaining the Z-KEY / Z-KEY WIFI actual IP:

USER MANUAL –Z-KEY / Z-KEY WIFI
19
Connect Z-KEY to a PC with a standard micro USB cable, power up the Z-KEY and Click on “TEST” to obtain
the actual IP address:

USER MANUAL –Z-KEY / Z-KEY WIFI
20
For changing the actual IP configuration return to the home page and click on “CONFIGURATION”:
Than click on “Automatic Search”, read the configuration from the Z-KEY than modify the actual
configuration with the new parameters: