User Manual: Z-Gprs3, Z-Umts, Z-Logger3, Z-Lte, Z-Lte-Ww
User Manual: Z-Gprs3, Z-Umts, Z-Logger3, Z-Lte, Z-Lte-Ww
User Manual: Z-Gprs3, Z-Umts, Z-Logger3, Z-Lte, Z-Lte-Ww
SENECA s.r.l.
This document is property of SENECA srl. Duplication and reproduction of its are forbidden
(though partial), if not authorized. Contents of present documentation refers to products and
technologies described in it. Though we strive for reach perfection continually, all technical data
contained in this document may be modified or added due to technical and commercial needs;
it’s impossible eliminate mismatches and discordances completely. Contents of present
documentation is anyhow subjected to periodical revision. If you have any questions don’t
hesitate to contact our structure or to write us to e-mail addresses as above mentioned.
MI00446-24-EN
Page 1
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
01/02/2017 1.07 Fixed lower Supply voltage limit for Z-UMTS product
Added new “Emergency Mode” function (from firmware 1.2.1 Z-UMTS, 2.4.2
Z-GPRS3/Z-LOGGER3)
Added Chapter Z-GPRS3 consumption estimate for use with solar panels
06/07/2017 1.11 Fixed Modbus command value for “DOWNLOAD AND UPDATE PHONEBOOK
FROM FTP SERVER”
28/02/2018 1.12 Added new firmware 2.5 and 1.5 features: MQTT Protocol, DDNS, Modbus
TCP-IP to RTU Passthroug, Syslog Client, Unicode
17/12/2018 1.14 Changed Z-UMTS HW2 Modbus Addresses for HW1 compatibility from
firmware 3.0.3
13/02/2019 1.15 Added info for Embedded Digital input and Analog input speed
19/04/2019 1.16 Added new commands for new firmware into SEAL 2.6.0.0
2
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Table of Contents
1. CHARACTERISTICS .................................................................................................... 8
7.1. SENDING A SMS COMMAND USING THE PASSWORD (ONLY Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW) ...........15
7.2. MICROSD CARD PHONE BOOK (ONLY Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW) .............................................15
8.2. THE DATA LOGGER AND THE DATA LOGGER ON TRIGGER .............................................................................20
8.2.1. Sending data logger file to a FTP server ...................................................................................................... 21
8.2.2. Sending data logger and data logger on trigger data to an E-MAIL server ................................................. 22
8.2.1. Sending data logger and data logger on trigger data to an HTTP server .................................................... 24
8.2.1. Saving data logger data to the microSD card .............................................................................................. 24
3
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
11.1. ACTIONS........................................................................................................................................................27
16.1. SEAL PROGRAM AND SEAL CONFIGURATION UPDATE FROM WEBSERVER ...................................................33
17.2. MODBUS ADDRESSES TABLE (Z-UMTS HW2 from firmware 3.0.3 / Z-LTE / Z-LTE-WW) .................................39
19. DYNAMIC DNS (DDNS) (Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW ONLY) .......... 45
4
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
22. Z-GPRS3 POWER ESTIMATE FOR USE WITH SOLAR PANELS ........................ 53
23. TROUBLESHOOTING............................................................................................. 53
5
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
CAUTION!
Contact your telephone provider for information on GSM and GPRS service costs. It is best to
quantify log and SMS costs before setting up and installing Z-GPRS3, Z-UMTS OR Z-LOGGER3.
The use of Z-GPRS3 / Z-UMTS / Z-LTE-WW in data roaming (for example, abroad with an Italian
SIM card) may generate unexpected costs. Contact your telephone provider for further
information.
IN NO CASE MAY SENECA OR ITS SUPPLIERS BE HELD LIABLE FOR ANY INCOMING DATA OR
PROFIT LOSSES DUE TO INDIRECT, CONSEQUENTIAL OR INCIDENTAL CAUSES (INCLUDING
NEGLIGENCE) CONNECTED WITH THE USE OR INABILITY TO USE Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-
LTE-WW EVEN IF SENECA WAS INFORMED OF THE POTENTIAL OF THESE DAMAGES.
SENECA HAS TAKEN THE UTMOST CARE AND CAUTION IN DRAFTING THIS MANUAL. HOWEVER,
IT MAY CONTAIN ERRORS OR OMISSIONS. SENECA SRL RESERVES THE RIGHT TO MODIFY
AND/OR VARY PARTS OF THIS MANUAL TO CORRECT ERRORS OR TO ADJUST TO PRODUCT
FEATURE CHANGES WITHOUT ANY PRIOR NOTICE.
CAUTION!
-Contact your telephone service provider for GSM and GPRS service costs especially when using
Z-GPRS3, Z-UMTS, Z-LTE-WW with a sim issued by a country other than the one in which it is
used (international roaming).
-It is best to estimate telephone costs before setting up Z-GPRS3, Z-UMTS and Z-LTE-WW.
-Internet send/receive costs can be tied to Kbytes sent/received, a monthly ceiling included in a
package or internet connection time. Contact your telephone service provider for further
information.
6
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
-For internet connections whose costs is associated with connection time, please remember that
communications are active for an amount of time that depends on the number of log rows to be
sent. Typically, a 2 Kbyte data log takes about 10-15 seconds (in GPRS mode) to be sent in
addition to the time necessary to establish the connection (from 5 to 30 seconds) and the time
due to any server login attempts.
-Check the data quantity sent via internet and SMS before using Z-GPRS3, Z-UMTS, Z-LTE-WW.
Please remember that mobile phone service providers also consider the entire communication
that permits file transmission (and thus data transmission overhead, the number of connection
attempts, etc.) and not just the dimensions as data traffic in each transaction.
7
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
1. CHARACTERISTICS
8
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The information regarding technical specifications, electrical connections and functionality of the LEDs
can be found in the installation manual for each product. To consult the installation manual use the link
below:
Z-LOGGER3: https://www.seneca.it/products/z-logger3/doc/installation_manualEN
Z-GPRS3: https://www.seneca.it/products/z-gprs3/doc/installation_manualEN
Z-UMTS / Z-UMTS HW2: https://www.seneca.it/products/z-umts/doc/installation_manualEN
Z-LTE / Z-LTE-WW: https://www.seneca.it/products/z-lte/doc/installation_manualEN
9
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
2. DEVICES OVERVIEW
Z-GPRS3, Z-LOGGER3, Z-UMTS and Z-LTE-WW are equipped with 4 counters and 4 totalizers. Up to
a maximum of 30 Hz signals can be acquired, 4 digital inputs, 2 analog inputs and 2 relay digital
outputs.
Z-UMTS HW2 and Z-LTE, Z-LTE-WW are also equipped with a GNSS positional system.
A maximum of 100 External TAGs (Modbus RTU and/or Modbus TCP) plus the internal TAGs
(Embedded IO and signals) can be logged.
The logs are sent in csv format (comma separated values, microsoft excel™ compatible) via ftp,
email or microSD card.
Http REST functions or MQTT protocols can also be used for send logs, alarms and send/receive
commands.
Z-GPRS3, Z-UMTS and Z-LTE, Z-LTE-WW can also send the last row of the log file via SMS.
An internal UPS is also available, in UPS mode the RTUs will works for about 1h without external
power.
All configurations are possible via the SEAL software, available for free download at www.seneca.it
in the Z-GPRS3 / Z-UMTS / Z-LOGGER3 / Z-LTE, Z-LTE-WW section.
SEAL is a graphical environment that allow you to configure the datalogger and to create simple
automation without knowing any programming language.
For more info refers to the SEAL help, SEAL is available for free download at address:
http://www.seneca.it/en/linee-di-prodotto/software/seal/
Others manuals, quickstart and examples on SEAL are availables on the Z-UMTS/Z-GPRS3/Z-LOGGER3 /Z-
LTE, Z-LTE-WW sections on website.
RTUs are equipped with back-up batteries (internal UPS) to perform programmable actions in case
of blackout.
Switch ON:
1 ) Supply power to the RTU via screw terminal or via BUS IDC10
10
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Switch OFF:
3) Press the button PS1 until the led PWR will flash fast.
Z-GPRS3 / Z-UTMS / Z-LTE / Z-LTE-WW support the following types of SIM CARDS:
"Zero cost" operations can be run only on voice type SIM CARDS, if the RTU receive a ring an action can be
made.
For "top-up" SIM CARDS RTU can manage residual credit requesting the amount from the telephone service
provider.
CAUTION!
-Before inserting the SIM CARD, CANCEL ALL MESSAGES ON THE CARD USING A MOBILE PHONE.
-Before inserting the SIM CARD, CANCEL ALL ADDRESS BOOK CONTACTS ON THE CARD USING A
MOBILE PHONE.
-UMTS SIM CARDS are supported only by the Z-UMTS/Z-LTE / Z-LTE-WW product.
-The Product was tested with leading international provider SIM CARDS. However, operations
are not guaranteed with all providers.
11
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The GSM signal level can be found via SEAL software (in the “test“ section) or in the Webserver.
To view the GSM signal level, the SIM CARD must be inserted (signal may change radically based
on the selected provider).
Into the log fileThe field is expressed in DBm where -115 dBm it’s the minimum, -52 dBm it’s the
maximum.
For correct ftp or email log operations the minimum required field level is 2/7 (please remember
that the signal often fluctuates).
For SMS operations only the minimum required field level is 2/7.
SIGNAL LEVEL 1 = INSUFFICIENT SIGNAL (NOT RELIABLE FOR SMS AND GPRS)
SIGNAL LEVEL 2 = MINIMUM SIGNAL (MINIMUM SIGNAL FOR SMS AND GPRS)
12
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
To increase the GSM signal level, Seneca provides various GSM antenna models to reach the
minimum signal level in most situations.
Visit www.seneca.it, refer to the general catalogue or contact Seneca srl for further information.
CAUTION!
-Before inserting the SIM card, delete all SMS on the SIM using a mobile phone
-Wait at least 5 minutes in order for the GSM signal to be correctly read.
CAUTION!
-Contact your telephone service provider for GSM and GPRS service costs especially when using
the RTU with a sim issued by a country other than the one in which it is used (international
roaming).
6. INTERNAL UPS
When the voltage batteries is insufficient the RTU will runs the following algorithm:
C) Without external power the board will send log data and then shutdown
13
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
CAUTION!
RTUs ARE SUPPLIED WITHOUT CHARGED BATTERIES.
CHARGE THE BATTERIES BY POWER UP RTUs FOR AT LEAST 48H BEFORE USE
CAUTION!
THE BATTERIES CAN BE RECHARGED FOR A MAXIMUM OF ABOUT 300 TIMES.
CAUTION!
TO CONSERVE BATTERY, IN CASE OF DAILY BACKUP, USE THE CONFIGURATION WITH POWER-
OFF WHEN BACKUP
7. ADDRESS BOOK
For security reason Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW accept SMS command or audio call only from
numbers that are in the Address Book.
Groups of numbers/emails can be used for sending alarms/logs to a restrict number of users.
14
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
7.1. SENDING A SMS COMMAND USING THE PASSWORD (ONLY Z-GPRS3 / Z-UMTS / Z-
LTE / Z-LTE-WW)
A SMS command can be accepted also if the telephone number isn’t in the address book.
For obtain this feature you must insert before the SMS command a password.
The password is different for every RTUs and is obtained from the last 4 digits of the modem IMEI.
For obatin the password you must connect the RTU with SEAL:
“2966 NET”
The RTU will respond also if the telephone number isn’t in the address book.
7.2. MICROSD CARD PHONE BOOK (ONLY Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW)
It’ s possible to expand the internal phone book using a file in the microSD card.
You can add a maximum of 1000 telephone number but this numbers are enabled only to send a ring (and
so execute a ring command).
For editing the MicroSD card phone book refers to the SEAL Help on line.
15
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
When the logger is activated the RTU save data into an internal Flash, then can send it to email server, ftp
server, http server or MicroSD card.
When the internal Flash space is full the oldest data will be overwritten (circular buffer).
The files are in standard csv text format (windows excel ™ compatible).
The Event Logger, The Data logger and the Data logger on Trigger
The internal flash stores at maximum of 8192 rows for the Event Logger, a new row will overwrite the
oldest (circular buffer).
The number of rows that the Data Logger can store in the internal flash depends from the TAGs size (16, 32
or 64 bits) and the number of tags.
Activating all the embedded tags the maximum number of rows that can be stored in the internal flash is
16384, a new row will overwrite the oldest (circular buffer).
Activating all the embedded tags and all 100 Extended Tags at 32bit the maximum number of rows that can
be stored in the internal flash is 16384/8=2048, a new row will overwrite the oldest (circular buffer).
The event logger works defining Events (Digital input/output Events, Blackout, Analog Alarms etc…) with
the SEAL software configuration.
When an event is created a new row text (with the Timestamp) is inserted into the log, the event must be
configured with the SEAL software.
The event logger can be sent a minimum of 1 time for day if files are sent to FTP, E-MAIL or microSD card.
NOTE:
If no events are generated, the Event logger file will be composed of only 1 row with the text :
The RTUs are compatible with ftp server configured into passive mode.
16
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
If the connection with the server is lost the RTU will accumulate the data and when the connection returns
all data is sent up to align to actual acquisition.
RTUNAME_msgyyyyMMddhhmmss.csv
Where:
17
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
ZGPRS3TEST_msg20160606000057.csv
RTUs are compatible only with SMTP servers without encryption using the Ethernet or GPRS Always ON
(PPP) connection.
Z-GPRS3 / Z-UMTS /Z-LTE / Z-LTE-WW are compatible also with SMTPS server with SSL 3.0 encryption (for
example GMAIL™) but only with GPRS connection NOT always ON (PPP must be off)
An example of SMTP server that works without encryprion is hMailServer for windows™ , for more info:
https://www.hmailserver.com/.
See the application note for installing and use hMailServer on a windows™ machine.
If the connection with the server is lost the RTU will accumulate the data and when the connection is
returned all data is sent up to align to actual acquisition.
A tipical mail sent has a text in the body with the timestamp and the log file in attachment.
18
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
RTUNAME_msgyyyyMMddhhmmss.csv
Where:
19
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
ZGPRS3TEST_msg20160606000057.csv
RTUs are compatible only with microSD card formatted in FAT32 (FAT16 filesystem is not recommended).
The event log files are stored into the /SYS directory.
The file name is different from the name that is sent to the FTP/EMAIL and is
Exxxxxxx.csv
The data logger works defining a Data acquisition time (sample time).
1) Notification
2) Report
The Notification sends data every sample time (minimum = 1 minute), the file will have only 1 row data.
This row can be sent to SMS, EMAIL or HTTP POST.
The Report sends data every report time (for sample time = 1 minute and report time = 5 minutes then the
report is made of 5 rows data).
The data logger on trigger works defining one or more event trigger actions, when the event trigger action
is true a row acquisition is made.
If no event trigger actions are performed, no Notifications or Reports are sent.
NOTE:
For http POST function only the Notification data can be used so only one row will be sent at a
time.
20
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The RTU is compatible with ftp server configured into passive mode.
If the connection with the server is lost the RTU will accumulate the data and when the connection is
returned all data is sent up to align to actual acquisition.
INDEX TYPE TIMESTAMP DIN1 DIN2 DIN3 DIN4 DOUT1 DOUT2 VBAT POW VAL1 AVG1 MIN1 MAX1
Where:
The others values are the TAG name and variables entered by the user in the SEAL configuration.
The Data Logger on Trigger file when is open with excel™ is:
INDEX TYPE TRIGGER TIMESTAMP POW VBAT DIN1 DIN2 DIN3 DIN4 DOUT1 DOUT2 VAL1 AVG1 MIN1 MAX1
1 ASYNC A------- 05/12/2016 16:11 1 1 1 0 0 0 0 0 -4 -3 -5 -3
2 ASYNC A------- 05/12/2016 16:11 1 1 1 0 0 0 0 0 -5 -3 -5 -3
3 ASYNC A------- 05/12/2016 16:11 1 1 1 0 0 0 0 0 -5 -3 -5 -3
4 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
5 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
6 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
7 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
8 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
9 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
10 ASYNC AB------ 05/12/2016 16:11 1 1 1 1 0 0 0 0 -4 -3 -5 -3
A New column named Trigger is the Trigger Source that generated the log line.
For example the line indexed 9 is generated from the “B” trigger (DIN2 HIGH).
The line indexed 10 is generated from “A” and “B” trigger at the same time (DIN1 and DIN2 HIGH).
21
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Note that the RTU directly calculates Average/Minimum/Maximum of an embedded analog input.
RTUNAME_logyyyyMMddhhmmss.csv
Where:
ZGPRS3TEST_log20160605143600.csv
8.2.2. Sending data logger and data logger on trigger data to an E-MAIL server
RTUs are compatible only with SMTP servers without encryption using the Ethernet or GPRS/UMTS+ Always
ON (PPP) connection.
Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW are compatible also with SMTPS server with SSL encryption (for
example GMAIL™) but only with GPRS/UMTS+ connection NOT always ON (PPP must be off).
An example of SMTP server that can works without encryprion is hMailServer for windows™ , for more info:
https://www.hmailserver.com/.
If the connection with the server is lost the RTU will accumulate the data and when the connection is
returned all data is sent up to align to actual acquisition.
A typical mail sent has a text in the body with the timestamp and the log file in attachment:
22
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
INDEX TYPE TIMESTAMP DIN1 DIN2 DIN3 DIN4 DOUT1 DOUT2 VBAT POW VAL1 AVG1 MIN1 MAX1
Where:
The others values are the TAG name and variables entered by the user in the SEAL configuration.
The Data Logger on Trigger file when is open with excel™ is:
INDEX TYPE TRIGGER TIMESTAMP POW VBAT DIN1 DIN2 DIN3 DIN4 DOUT1 DOUT2 VAL1 AVG1 MIN1 MAX1
1 ASYNC A------- 05/12/2016 16:11 1 1 1 0 0 0 0 0 -4 -3 -5 -3
2 ASYNC A------- 05/12/2016 16:11 1 1 1 0 0 0 0 0 -5 -3 -5 -3
3 ASYNC A------- 05/12/2016 16:11 1 1 1 0 0 0 0 0 -5 -3 -5 -3
4 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
5 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
6 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
7 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
8 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
9 ASYNC -B------ 05/12/2016 16:11 1 1 0 1 0 0 0 0 -4 -3 -5 -3
10 ASYNC AB------ 05/12/2016 16:11 1 1 1 1 0 0 0 0 -4 -3 -5 -3
A New column named Trigger is the Trigger Source that generated the log line.
For example the line indexed 9 is generated from the “B” trigger (DIN2 HIGH).
23
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The line indexed 10 is generated from “A” and “B” trigger at the same time (DIN1 and DIN2 HIGH).
Note that the RTU directly calculates Average/Minimum/Maximum of an embedded analog input.
If the Data Logger file is sent to an ftp server or by email the filename is:
RTUNAME_logyyyyMMddhhmmss.csv
Where:
ZGPRS3TEST_log20160605143600.csv
8.2.1. Sending data logger and data logger on trigger data to an HTTP server
Data logger Logs are sent using the Notification (connection is made every sample time).
For more info refers to the SENECA HTTP PROTOCOL user manual (must be required to [email protected]).
Z-GPRS3 / Z-LOGGER3 / Z-UMTS / Z-LTE / Z-LTE-WW are compatible only with microSD card formatted in
FAT32 (FAT16 filesystem is not recommended).
If the log report must be sent more frequently than daily, the RTU will create a directory for every days, for
example:
24
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
ROOT
--LOG
--20160618
--20160619
--20160620
The file name is different from the name that is sent to the FTP/EMAIL and is
Lxxxxxxx.csv
http://mqtt.org/
For more info about the MQTT implementation refers to the SENECA MQTT PROTOCOL user manual (must
be required to [email protected]).
A microSD is pre-formatted FAT32 with allocation unit that depends from the constructor.
The number of logs data that can be stored in a microSD card depends from the microSD and the allocation
unit size.
Using a classic microSD of 4GBytes formatted with a file allocation of 32768 bytes, the number of allocation
are about:
Typically the RTU can save data to a microSD every 15 minutes, in this case the microSD will be full in:
122070 / 96 files for day = about 1272 days = about 3.5 years
Writing to a microSD every 1 minute, in this case the microSD will be full in:
25
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
If you need to increase the number of log that can be stored, you must format the microSD with the
minimum allocation unit size.
You will obtain an allocation unit of 1024 bytes so the number of allocation units is:
Saving a file every 15 minutes will create a file of about 10K so use 10 allocation unit:
3906250/(10 allocation units*96 file for day) = about 4096 days => about 11 years
3906250 / 3600 files for day = about 1085 days => about 3 years
26
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
11.1. ACTIONS
Actions are commands that must be executed from the RTU when an event is TRUE or FALSE.
Example of actions are: writing to a modbus register, Toggle the digital output 1, reset a totalizer etc…
Messages are text that must be sent from the RTU when an event is TRUE or FALSE.
A Messages can be sent to: EMAILS, SMS, AUDIO CALL and HTTP POST
Example of messages are: sending a text alarm “Input 1 high ALARM!” when the analog input 1 is higher
than 15 mA.
Audio messages are located into the /AUDIO directories, a preset of audio messages are loaded with seal
but can be edited.
Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW can receive audio calls for executing commands using DTMF code.
/AUDIO/80.pcm
Now the RTU can execute the FAST COMMANDS from 0 to 15 simply typing the command number and then
confirm with the “*”, use “#” for cancel.
The FAST COMMANDS are editable from SEAL in the APP icon -> Fast command, for example:
27
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The Webserver is reachable from the Ethernet or from the Modem PPP connection.
CAUTION!
The webserver must be enabled from the SEAL software (default is webserver OFF).
NOTE
The webserver must be enabled from the SEAL software (default is webserver OFF).
The maintenance webserver can be used for maintenance and debug purposes, for accessing this
webserver type in a browser (with default ip address):
http://192.168.1.101/maintenance/index.html
28
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
192.168.1.101 must be replaced with the Ethernet or the Modem PPP IP address.
With the webserver is possible to download all the log files that are store in SD card:
For debug you can see in real time all the external/internal TAGs values in the “Extended Variables”/
“Status” / “Digital IO” / “Analog IN” / “Counters” sections.
The last 16 Diagnostic Messages can be viewed in the “Diagnostic Messages” section.
29
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The “Upload file” section can be used for sending a new configuration or a new firmware to the RTU.
The custom webserver is located in the provided microSD card ( /WEB directory ).
http://192.168.1.101/index.html
192.168.1.101 must be replaced with the Ethernet or the Modem PPP IP address.
For example is possible to write directly to an external modbus tag entering in upper right corner a tag
name and the new value.
30
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Seal is a programming environment for the Seneca RTU, for more info refers to the SEAL help.
http://www.seneca.it/en/linee-di-prodotto/software/seal/
CAUTION!
31
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
In order to include new functions, the system includes firmware update options.
Via Webserver: Connect to the section “Upload File” for updating the firmware
Via USB: A complete update takes about 8 minutes. The device must be connected to a PC with SEAL
software installed.
Via microSD card: A complete update takes about 20 seconds. A microSD adapter for PC (many mobile
phones can also read/write microSD) is required.
Via FTP Server: When the RTU is not reachable directly, the firmware update can be made by sending a
SMS or a HTTP command, then the update file is downloaded directly by the RTU from a FTP server.
Via HHTP Server: When the RTU is not reachable directly, the firmware update can be made by sending a a
HTTP command, then the update file is downloaded directly by the RTU from the HTTP server.
1) Download and Install the last SEAL software from Seneca Website (the last firmware is located in
C:\Program Files\Seneca\SeAL\devices).
2) Connect to the RTU webserver at address:
http://ipaddress/maintenance/index.html
where “ipaddress” is the PPP modem or Ethernet ip address.
3) Go to the “Upload File” section.
4) Under “Firmware Binary File” select the “fw.bin” file from the last firmware folder and then click
“UPLOAD”
5) The RTU will reboot with the new firmware.
32
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Firmware can be updated via microSD card formatted with the FAT16 or FAT32 filesystem
(purchased microSD cards are usually already formatted this way).
1. Copy the file called “fw.bin” containing the firmware to a microSD card, The file must be
copied to the main microSD folder.
2. With the RTU OFF, insert the microSD card in the slot
3. Turn ON the RTU.
4. The SD/STS led starts to flash at 1 second intervals for about 20 seconds. The new firmware
is written in flash memory during this phase.
5. When finished, the SD/STS led starts to flash fast
6. At this point, remove the microSD
7. The green PWR led starts to flash fast (several times a second); in this phase the module is
copying firmware from flash to the microprocessor flash.
8. When finished, the module automatically turns off and back on
-Connecting the module to SEAL software, the firmware version has changed.
CAUTION!
-Once the firmware is updated, the previous setup may be deleted so RTU must be re-configured.
You can update a SEAL program and or configuration from the RTU Webserver.
33
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
7) Under “Configuration Tags File” select the “setup.tag” file and then click “UPLOAD”
8) The RTU will restart with the new SEAL Program/Configuration
CAUTION!
When use this feature with Remote RTU be sure that the connection parameters are correct
before upload the new SEAL Program/Configuration or the RTU will be unreachable!
You can create a backup file for the SEAL program (.seal file) for archive and upload it to the RTU.
3) Under “Configuration SEAL File” select the “.seal” file and then click “UPLOAD”
4) The RTU will store the .seal file to the SD card
34
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
CAUTION!
When a “.seal” file is uploaded the RTU will not change the actual program/configuration.
This operation is only for backup purpose, for changing the program/configuration you must
upload the “setup.tag” file (see chapter 16.1)
The RTUs can activate a Modbus TCP-IP Server and a Modbus RTU Slave (on serial ports) for accessing the
Embedded and Modbus I/O.
The external variables addresses are placed from the SEAL compiler so, after compiling, the addresses can
be showed:
35
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
FIRMWARE MAJOR
40003 2 UNSIGNED 16 READ ONLY (EXAMPLE 204 = 2.04)
REVISION
In decimal format
KMMBB
Where:
K=4= Bugfix Release
K=3= New Release
MM = Minor Revision
FIRMWARE MINOR
40004 3 UNSIGNED 16 READ ONLY BB = Build
REVISION
Example:
Value = 40110
4 = Bugfix Release
01 = Minor revision 1
10 = Build 10
36
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Digital Inputs
Bit 0 = INPUT1 VALUE
Bit 1 = INPUT2 VALUE
DIGITAL INPUTS
40008 7 BIT READ ONLY Bit 2 = INPUT3 VALUE
AND SIGNALS
Bit 3 = INPUT4 VALUE
Bit 7 = EXTERNAL POWER
Bit 8 = BATTERY GOOD
37
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
BITS
UNSIGNED 16 Value in [Seconds]
40091 90 Worktime 3 LSW READ ONLY
BITS Less significant 16 bits
UNSIGNED 16 Value in [Seconds]
40092 91 Worktime 3 MSW READ ONLY
BITS Most significant 16 bits
UNSIGNED 16
40101 100 Totalizer value 4 LSW READ ONLY Less significant 16 bits
BITS
Totalizer value 4 UNSIGNED 16
40102 101 READ ONLY Most significant 16 bits
MSW BITS
UNSIGNED 16
40103 102 Counter value 4 LSW READ ONLY Less significant 16 bits
BITS
UNSIGNED 16
40104 103 Counter value 4 MSW READ ONLY Most significant 16 bits
BITS
UNSIGNED 16 Value in [Seconds]
40117 116 Worktime 4 LSW READ ONLY
BITS Less significant 16 bits
UNSIGNED 16 Value in [Seconds]
40118 117 Worktime 4 MSW READ ONLY
BITS Most significant 16 bits
UNSIGNED 16
40128 127 Battery Voltage READ ONLY [mV]
BITS
40130 129 Analog input 1 SIGNED 16 BITS READ ONLY Value in [mA] or [V]
40131 130 Scaled Analog Input 1 SIGNED 16 BITS READ ONLY Custom scaled value
40144 143 Analog input 2 SIGNED 16 BITS READ ONLY Value in [mA] or [V]
40145 144 Scaled Analog Input 2 SIGNED 16 BITS READ ONLY Custom scaled value
40158 157 GSM Field SIGNED 16 BITS READ ONLY Value in [dBm]
41003 1002
External Use the compile output window
… … - READ/WRITE
Variables Tags for Tags address position
41203 1202
Command Register
UNSIGNED 16
49001 9000 COMMAND READ/WRITE (see Table with supported
BITS
commands)
38
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
17.2. MODBUS ADDRESSES TABLE (Z-UMTS HW2 from firmware 3.0.3 / Z-LTE /
Z-LTE-WW)
FIRMWARE MAJOR
40003 2 UNSIGNED 16 READ ONLY (EXAMPLE 204 = 2.04)
REVISION
In decimal format
KMMBB
Where:
K=4= Bugfix Release
K=3= New Release
MM = Minor Revision
FIRMWARE MINOR
40004 3 UNSIGNED 16 READ ONLY BB = Build
REVISION
Example:
Value = 40110
4 = Bugfix Release
01 = Minor revision 1
10 = Build 10
Digital Inputs
Bit 0 = INPUT1 VALUE
Bit 1 = INPUT2 VALUE
DIGITAL INPUTS
40008 7 BIT READ ONLY Bit 2 = INPUT3 VALUE
AND SIGNALS
Bit 3 = INPUT4 VALUE
Bit 7 = EXTERNAL POWER
Bit 8 = BATTERY GOOD
39
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
40
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
41
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
If you have enabled the Modbus TCP-IP server by Ethernet connection or the Modbus Slave RTU from a
serial port you are able to send commands to RTUs.
RESET RTU 1
UNMOUNT SD CARD 7
STOP DATALOGGER 18
START DATALOGGER 17
42
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
43
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The devices can be used for convert in real time the protocol Modbus TCP-IP to Modbus RTU from Ethernet
or 2G/3G connection.
For example is possible to connect a scada in Modbus TCP-IP to directly acquire the Modbus I/O slaves
Modbus RTU:
2 The RTU Converts the Modbus TCP-IP Request to the Modbus RTU Slave
4 The RTU Converts the Modbus RTU Response to the Modbus TCP-IP Scada
44
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Dynamic DNS (DDNS or DynDNS) is a method of automatically link the name server with a dynamic IP.
http://senecazumts.ddns.net/ index.html
Also the RTU Modbus TCP-IP server can reached, for example configuring in the scada:
Port: 502
NoIP.com
DDNS.org
DDNS.it
45
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The RTU lets you run commands if the SMS sender number is enabled.
Command list:
46
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
For example:
SET TAG <VARIABLE_LABEL> <VALUE> Write <VALUE> to the external variable named
<VARIABLE_LABEL>
For example:
47
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
48
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
STATUS Returns the variables set by setup software. All available variables
can be included. If the SMS text exceeds 160 characters, it will be
truncated (three dots “…” at the end of the SMS ).
SET GSM.APN apn_name user Set the APN with the APN name, user and password. For example,
password set vodafone APN that does not require user name and password:
for example:
SET GSM.SMTP name_ip port set SMTP server connection settings to send emails
user password
name_ip IP address or FTP server name
for example:
EMAIL TEST Forces an email sent with an attachment to the first administrator in the
email address book
49
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
FTP TEST Forces a text file sent to the currently set ftp server
EMAIL TAG Sends the value indicated by "TAG" to the first email contact
EMAIL DIN sends an email with the value of the digital inputs
EMAIL DIN1 sends an email with the value of the digital input 1
EMAIL DIN2 sends an email with the value of the digital input 2
EMAIL DIN3 sends an email with the value of the digital input 3
EMAIL DIN4 sends an email with the value of the digital input 4
EMAIL TEMP sends an email with the internal temperature sensor value
EMAIL SYSLOG Sends the last week syslog.csv log file on microSD via email (first
administrator address in the address book)
FTP SYSLOG Sends the last week syslog.csv log file in the microSD via FTP
UPLOAD LOG Create a dump of the actual internal flash log into the microSD
logdump.csv, then Sends this file to the actual upload channel (E-MAIL or
FTP).
DOWNLOAD FW The RTU will download from the FTP download folder the
“RTUNAME_fwupdt.bin” firmware file (where RTUNAME is the name
inserted in the “Cloud” SEAL section) Then (if the release il different from
the installed) a firmware update is done.
for example:
“Datalogger005_fwupdt.bin”
Note that if in the “Cloud” SEAL section you have flagged one of the
followed flags:
50
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
DOWNLOAD SETUP The RTU will download from the FTP download folder the “RTUNAME_
setup.tag” setup file (where RTUNAME is the name inserted in the
“Cloud” SEAL section) Then a configuration update is done.
For example:
“Datalogger005_setup.tag”
Note that if in the “Cloud” SEAL section you have flagged one of the
followed flags:
DOWNLOAD FW-SETUP The RTU will download from the FTP download folder the firmware AND
the setup file. Then (if the release is different from the installed) the
firmware and the configuration are updated.
“fwupdt.bin”
“fwupdt.tag”
DOWNLOAD DATA The RTU will download from the FTP download folder the “data.bin” with
the extended ring action phonebook (up to 1000 users). Then the
extended phonebook is updated.
NET RTU will send actual Ethernet and modem PPP IP address
GSM ICCID Return the SIM ICCID code (Integrated Circuit Card IDentifier)
51
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
NOTE
If the command is not recognized by the RTU, an error SMS will be sent:
You can configure the RTU to send a confirmation (SMS or ring) when the command is
successfully completed.
CAUTION!
When a command is successfully completed, a ring can only be generate when a voice SIM is
used (data SIM do not permit voice call service).
It’s possible to disable the SEAL program execution putting ALL dip switches to ON at boot-up.
This emergency mode is useful if a SEAL program does not allow to connect to SEAL (for example because
the board will reboot continuously).
In emegency mode the SEAL program is not executed and the datalogger is stopped.
52
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
The following table is obtained using a Modbus TCP-IP client connection with the Modbus TCP-IP Z-GPRS3
server using the GPRS connection.
Test condition:
-Outputs OFF
23. TROUBLESHOOTING
PROBLEM SOLUTION
Sending the SMS command: -Make sure the set APN corresponds to the mobile service
provider's and whether access requires authorisation. See:
email test
http://wiki.apnchanger.org/Main_Page
no email reaches the administrator's email
address -Make sure the GSM signal is over 2/7
Using the configuration software in the If you send Log via Ethernet, Seneca recommended to
"Test configuration" section when you use an owner SMTP server.
launch the command:
-The email is in the SPAM directory
TEST E-MAIL COMMAND -The SMTP server supports only SSL security, in the
ethernet port or Modem PPP connection you can not
53
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
Sending the SMS command: -The FTP server folder does not exist. Create the folder on
the ftp server first.
Using the configuration software in the -The folder on the FTP server on which you created the
"Test configuration" section when you file does not exist, first create the folder in the ftp
launch the command server
-Check the correctness of the IP / name of the FTP
TEST FTP server
-Make sure that the username / password to access the
ftp server are correct
no ftp file arrives in the configured ftp
server
The GSM signal is always 0/7 and the GSM led -The inserted SIM is not recognised. Clean or replace the SIM
continues to flash fast
-The SIM PIN is enabled. Insert the SIM in a mobile phone and
disable the PIN or enable it and insert the PIN code in the
setup software
The GSM signal is too low -Wait at least 10 minutes from turning on the device before
reading the GSM value
Residual credit is not sent for the SIM -Check the method used to receive residual credit from the
mobile service provider (ring or SMS, SMS request text).
Z-GPRS3 / Z-UMTS / Z-LTE / Z-LTE-WW worked -No SIM credit. Top-up the SIM card.
correctly for a few days/months but stopped
sending SMS and logs. -The SIM card expired, replace the SIM card or contact your
mobile phone provider.
54
USER MANUAL – Z-GPRS3, Z-UMTS, Z-LOGGER3, Z-LTE-WW
You get the "NTP error" The clock synchronization is activated, via ethernet this
is done via NTP (network time protocol), but you can
not contact the NTP server:
UDP/TCP 21
UDP 123
55