Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Seneca Manuals
  4. Gateway
  5. KEY-C Series
  6. User manual

Seneca KEY-C Series User Manual

Multiprotocol modbus to cloud (mqtt/http) gateways
Hide thumbs

Advertisement

Quick Links

Download this manual
USER MANUAL
MULTIPROTOCOL "KEY-C" GATEWAYS SERIES
MODBUS TO CLOUD (MQTT/HTTP) GATEWAYS
SENECA S.r.l.
Via Austria 26 – 35127 – Z.I. - PADOVA (PD) - ITALY
Tel. +39.049.8705355 – 8705355 Fax +39 049.8706287
www.seneca.it
ORIGINAL INSTRUCTIONS

Advertisement

loading
Need help?

Need help?

Do you have a question about the KEY-C Series and is the answer not in the manual?

Questions and answers

Related Manuals for Seneca KEY-C Series

Summary of Contents for Seneca KEY-C Series

  • Page 1 USER MANUAL MULTIPROTOCOL “KEY-C” GATEWAYS SERIES MODBUS TO CLOUD (MQTT/HTTP) GATEWAYS SENECA S.r.l. Via Austria 26 – 35127 – Z.I. - PADOVA (PD) - ITALY Tel. +39.049.8705355 – 8705355 Fax +39 049.8706287 www.seneca.it ORIGINAL INSTRUCTIONS...
  • Page 2 SENECA's liability in relation to its products is governed by the general conditions of sale, which can be downloaded from www.seneca.it. Neither SENECA nor its employees, within the limits of applicable law, will in any case be liable for any lost profits and/or sales, loss of data and/or information, higher costs incurred for goods and/or replacement services,...
  • Page 3 AUTHOR 14/02/2025 First revision 24/02/2025 Added chapter on the meaning of LEDs This document is the property of SENECA srl. Copies and reproduction are prohibited unless authorised. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 3...
  • Page 4 FEATURES OF THE “KEY” SERIES COMMUNICATION PORTS ..................6 DEVICE HARDWARE REVISION ................7 FLEX TECHNOLOGY FOR PROTOCOL CHANGE ..........8 CHANGING PROTOCOLS WITH THE SENECA DISCOVERY DEVICE SOFTWARE ............9 LED MEANING ......................10 LED MODEL Z-KEY-C (CLOUD) ............................10 ETHERNET PORT ....................13 FIRMWARE UPDATE....................
  • Page 5 MSB and LSB BYTE CONVENTION WITHIN A MODBUS HOLDING REGISTER ..............39 REPRESENTATION OF A 32-BIT VALUE IN TWO CONSECUTIVE MODBUS HOLDING REGISTERS ......40 TYPE OF 32-BIT FLOATING POINT DATA (IEEE 754) ......................41 www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 5 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 6 FEATURES OF THE “KEY” SERIES COMMUNICATION PORTS PRODUCT ETHERNET SERIAL PORTS ISOLATED SERIAL PORTS No. PORTS Z-KEY-C Yes, both ports R-KEY-LT-C Z-KEY-2ETH-C Yes, both ports www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 6 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 7 2. DEVICE HARDWARE REVISION With a view to continuous improvement, Seneca updates and makes the hardware of its devices increasingly more sophisticated. It is possible to know the hardware revision of a product via the label on the side of the device.
  • Page 8 Flex allows you to change the combination of industrial communication protocols supported by the gateways at will from a list of available ones, the development is continuously updated, for a complete list refer to the page: https://www.seneca.it/flex/ Some examples of supported protocols are: The gateway then becomes “universal”...
  • Page 9 “KEY-C” GATEWAYS CHANGING PROTOCOLS WITH THE SENECA DISCOVERY DEVICE SOFTWARE From revision 2.8 the Seneca Discovery Device software identifies the devices that support the “Flex” technology: For example, in the case in the figure it is possible to press the “Change Protocol” button and select the destination protocol from those in the list: At the end of the operation, bring (only at the first power-on) the dip switches 1 and 2 to “ON”...
  • Page 10 Flashing: presence of data on ethernet port ETH ACT Steady on: ethernet port connected but no data present (GREEN) Off: check wiring of the ethernet port www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 10 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 11 (GREEN) Off: check wiring of the ethernet port Steady on: ethernet cable connected (YELLOW) Off: check the wiring of the ethernet port www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 11 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 12 Off: check wiring of ethernet port #1 Flashing: presence of data on ethernet port #2 Steady on: ethernet port #2 connected but no data present Off: check wiring of ethernet port #2 www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 12...
  • Page 13 DO NOT CONNECT 2 OR MORE FACTORY-CONFIGURED DEVICES ON THE SAME NETWORK, OR THE DEVICE WILL NOT WORK (CONFLICT OF IP ADDRESSES 192.168.90.101) 6. FIRMWARE UPDATE In order to improve, add or optimize the functions of the product, Seneca releases firmware updates on the device section on the www.seneca.it website The firmware update is performed using Seneca tools or the webserver.
  • Page 14 This operating mode allows you to load data from Modbus RTU/ASCII Slave and/or remote TCP Server I/Os to a cloud (and vice versa). Below are some examples of possible connections: www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 14 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 15 In addition to the serial devices, it is also possible to connect up to 3 remote Modbus TCP-IP servers. It is also possible to write Modbus registers from the cloud. The Gateway simultaneously always activates a Modbus TCP-IP server. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 15 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 16 Each Modbus register contains 2 tags, so for example: 49033 TAG02_TAG01 49034 TAG04_TAG03 … 49282 TAG500_TAG499 49283 LAST_LOOP_TIME_COM1 [x1 ms] 49284 LAST_LOOP_TIME_COM2 [x1 ms] www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 16 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 17 10 ms) so, for example: 49283 25 49284 42 It means that the serial 1 loop was 250ms, the serial 2 loop was 420ms. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 17 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 18 SENECA DISCOVERY DEVICE SOFTWARE STEP 2 If you need to change the IP address of the device (default 192.168.90.101), launch the Seneca Discovery Device software and perform the SCAN, select the device and press the “Assign IP” button, set a configuration compatible with your PC, for example: Confirm with OK.
  • Page 19 The first column represents the name of the parameter, the second column “current” is the current value of the parameter. The last column “updated” is used to modify the current configuration. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY...
  • Page 20 Disabled: A static Network Configuration is set up Enabled: The IP address, IP mask and gateway address are obtained from the DHCP server. The gateway address can be found by the Seneca Discovery Device software. ETHERNET STATIC IP Static IP address when the DHCP is disabled...
  • Page 21 It forces the webserver to use the https secure protocol instead of http one ETHERNET IP CHANGE FROM DISCOVERY Set whether a user is authorized to change the IP configuration from the "Seneca Discovery Device" software. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY...
  • Page 22 Set the maximum number of registers that can be written with the multiple writing functions (the gateway will optimize writings with this maximum number of registers). WATCHDOG ENABLE Enable or disable the time restart of gateway. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 22...
  • Page 23 This is the IP address of the second NTP server (in case the first one does not respond) ATTENTION! PLEASE REMEMBER THAT NTP SERVERS USE THE UDP 123 PORT (WHICH MUST THEREFORE ALWAYS BE OPEN IN THE CONFIGURATION OF THE NETWORK USED) www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 23...
  • Page 24 Set the address of the Gateway memory location where the TAG is saved, these registers are accessible both from Modbus serial and Modbus TCP-IP. TARGET MODBUS DEVICE Select the Modbus RTU slave model from the Seneca device database or select "custom" if you are not using a Seneca Modbus RTU slave. TARGET RESOURCE If you are using a Seneca Modbus RTU Slave select the resource name from the Seneca database.
  • Page 25 (IEEE 758-2008) BIT: 1 Boolean Coil or Discrete Input, value true or false. N.B. This field is automatically filled in if a Seneca slave device has been selected in the "TARGET MODBUS DEVICE" field.
  • Page 26 DELAYED = Once the set retry number has been reached, the polling of the tag is delayed (the tag will be interrogated again after the configured quarantine time) EXC = Modbus protocol exception response www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 26 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 27 CLOUD AUTHENTICATION This parameter defines whether user/password authentication should be used to access the cloud CLOUD AUTHENTICATION USER Broker or server username www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 27 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 28 %j[field] Adds double quotes " to [field]. The double quotes represent a string in JSON for example: Device Client ID = Padova13 Publish Topic for Logs = seneca/%c/data The data logs will be sent to the topic: Seneca/Padova13/data www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 28 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 29 Direl ADM: Sets up the device to connect to the Direl ADM cloud On-Board: Sets up the device to connect to the On-Board cloud To add other clouds to the list, you can make a request to Seneca. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY...
  • Page 30 File that represents the Client key in .pem format. CERTIFICATE/DATABASE UPDATE PAGE On this page you can upload X.509 certificates for the webserver to the device (if https mode is enabled) and update the Seneca device database. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY...
  • Page 31 4) Remove power from the device 5) Turn 2 SW2 dip switches to OFF. 6) At the next restart the device will have loaded the factory configuration www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 31...
  • Page 32 The preparation of the Tag configuration can be a frustrating operation if done with the webserver, so a software and a Microsoft Excel™ Template are available to create a .bin file to import into the gateway or vice versa. The model can be freely downloaded from the Seneca website. www.seneca.it ALL RIGHTS RESERVED.
  • Page 33 The Traffic Monitor shows all packets received from the serial line, for example if it is a serial slave with an incorrect Modbus response: The Traffic Monitor will also display defective packets in yellow (for example a serial master with wrong baud rate): www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 33...
  • Page 34 Discovery Device" software and force the preferred IP address to all devices. 14. THE DB9 RS232 CABLE The DB9 CABLE RS232 CABLE can be obtained from Seneca (it can also be purchased from the e-commerce website www.seneca.it) for connection with a DB9 RS232 device.
  • Page 35 ▪ ATTENTION! All 32-bit variables are contained in 2 consecutive Modbus registers All 64-bit variables are contained in 4 consecutive Modbus registers www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 35 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 36 32-bit, single-precision floating-point register (IEEE 754) FLOAT 32 BIT https://en.wikipedia.org/wiki/IEEE_754 Boolean register, which can take the values 0 (false) or 1 (true) www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 36 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 37 According to the Modbus standard the Holding Registers are addressable from 0 to 65535, there are 2 different conventions for numbering the addresses: "0-BASED" and "1-BASED". For greater clarity, Seneca shows its register tables in both conventions. ATTENTION! CAREFULLY READ THE DOCUMENTATION OF THE MODBUS MASTER DEVICE IN ORDER TO UNDERSTAND WHICH OF THE TWO CONVENTIONS THE MANUFACTURER HAS DECIDED TO SENECA USES THE “1 BASED”...
  • Page 38 A further convention is also possible where the number 4 is omitted in front of the register address: HOLDING MODBUS ADDRESS MEANING WITHOUT 4x FIRST REGISTER SECOND REGISTER THIRD REGISTER FOURTH REGISTER FIFTH REGISTER www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 38 BE REPRODUCED WITHOUT PRIOR PERMISSION.
  • Page 39 LSB Byte (Least Significant Byte) defines the 8 bits ranging from Bit 0 to Bit 7 included, we define MSB Byte (Most Significant Byte) the 8 bits ranging from Bit 8 to Bit 15 inclusive: BYTE MSB BYTE LSB www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 39...
  • Page 40 In the reading registers it is possible to swap the most significant word with the least significant word, therefore it is possible to obtain 40064 as LSW and 40065 as MSW. www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY...
  • Page 41 Since we have 16-bit registers available, the value must be divided into MSW and LSW: 0x4022 (16418 decimal) are the 16 most significant bits (MSW) while 0x8F5C (36700 decimal) are the 16 least significant bits (LSW). www.seneca.it ALL RIGHTS RESERVED. NO PART OF THIS PUBLICATION MAY MI00725-1-EN Page 41 BE REPRODUCED WITHOUT PRIOR PERMISSION.

This manual is also suitable for:

Z-key cloudR-key-lt cloudZ-key-2eth cloudZ-key-cR-key-lt-cZ-key-2eth-c