Denkovi smartDEN IP-16R Series User Manual

Denkovi smartDEN IP-16R Series User Manual

Web-enabled ethernet-based 16 relay module

Advertisement

Quick Links

smartDEN IP-16R-XX User Manual
13 Apr 2021
smartDEN IP-16R-XX
Web-enabled Ethernet-based 16 Relay Modules
User Manual
Date: 13 Apr 2021
Device
Short Name
Integration Protocol
Firmware version
v1.20 / May 2017
smartDEN IP-16R
SNMPv2
v1.21 / Jul 2020
smartDEN IP-16R-MT
Modbus TCP
smartDEN IP-16R-MQ
MQTT V3.1.1
v1.21 / Sep 2020
-1-

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the smartDEN IP-16R Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Denkovi smartDEN IP-16R Series

  • Page 1 smartDEN IP-16R-XX User Manual 13 Apr 2021 smartDEN IP-16R-XX Web-enabled Ethernet-based 16 Relay Modules User Manual Date: 13 Apr 2021 Device Short Name Integration Protocol Firmware version v1.20 / May 2017 smartDEN IP-16R SNMPv2 v1.21 / Jul 2020 smartDEN IP-16R-MT Modbus TCP smartDEN IP-16R-MQ MQTT V3.1.1...
  • Page 2: Table Of Contents

    smartDEN IP-16R-XX User Manual 13 Apr 2021 Content 1. Features ......................3 2. Ordering Codes....................4 3. Application examples ..................5 4. Technical parameters ..................7 5. Connectors, ports and led indicators ..............8 6. Installation ......................9 7. Default Settings ....................16 8.
  • Page 3: Features

    smartDEN IP-16R-XX User Manual 13 Apr 2021 1. Features smartDEN IP-16R-XX is a LAN relay module with 16 SPDT relays for remote control with integrated web server for set-up, API integration protocol (depending on the model) and http/xml/json support for embedding in other systems. The built-in real time clock allows organizing schedule stand-alone work without connection to computer.
  • Page 4: Ordering Codes

    smartDEN IP-16R-XX User Manual 13 Apr 2021 2. Ordering codes Table 2.1. Ordering codes Short Name Ordering Codes Description SNMP model, PCB version, smartDEN IP-16R-12V-PCB 12VDC supply voltage SNMP model, PCB version, smartDEN IP-16R-24V-PCB 24VDC supply voltage smartDEN IP-16R SNMP model, BOX version, smartDEN IP-16R-12V-BOX 12VDC supply voltage SNMP model, BOX version,...
  • Page 5: Application Examples

    smartDEN IP-16R-XX User Manual 13 Apr 2021 3. Application examples  Remote control of electrical appliances  Industrial automation  Home automation  Watchdog monitoring of network equipment and auto-reboot  Internet of Things (IoT) Figure 3.1. smartDEN IP-16R-XX supports up to 30 schedule events for controlling appliances without connection with computer.
  • Page 6 smartDEN IP-16R-XX User Manual 13 Apr 2021 Figure 3.3. Easily access smartDEN IP-16R-XX via internet or LAN and control appliances remotely for Home Automation and Industrial Automation applications using some of the supported integration protocols. Figure 3.4. smartDEN IP-16R-XX supports periodically sending outgoing ping request to remote host (router, switch, PC, IP camera...) and upon timeout it will perform reboot of the device in order "to keep it alive".
  • Page 7: Technical Parameters

    smartDEN IP-16R-XX User Manual 13 Apr 2021 4. Technical parameters Table 4.1. Technical parameters Parameter Value Box size, mm 210 x 85 x 58 PCB size, mm 203 x 82 Box weight, g PCB weight, g 12 or 24 (depends on the model) ±2 Power supply voltage,VDC Maximum current consumption at 12VDC (when all relays are ON), mA...
  • Page 8: Connectors, Ports And Led Indicators

    smartDEN IP-16R-XX User Manual 13 Apr 2021 5. Connectors, ports and led indicators Bellow is shown a picture with the device connectors, ports and led indicators. Figure 5.1. Device overview...
  • Page 9: Installation

    smartDEN IP-16R-XX User Manual 13 Apr 2021 6. Installation  This device must be installed by qualified personnel;  This device must not be installed directly outdoors;  Installation consists of mounting the device, connecting to an IP network, connecting the relays, providing power and configuring via a web browser. 6.1.
  • Page 10 smartDEN IP-16R-XX User Manual 13 Apr 2021 6.2. Power supply Figure 6.2. smartDEN IP-16R-XX power supply Depending on the selected model during purchase the power supply source for smartDEN IP-16R-XX must be with voltage either 12VDC or 24VDC stabilized and filtered.
  • Page 11 (NC) contacts connected directly to the terminals. If you are connecting inductive loads to the relays an extra measures must be taken in order to ensure the proper work of the device. For more information please refer to this link: http://denkovi.com/controlling-inductive-devices -11-...
  • Page 12 smartDEN IP-16R-XX User Manual 13 Apr 2021 6.4. Network connection smartDEN IP-16R-XX supports AUTO-MDIX so either "crossover" or "straight- through" network cable can be used. Figure 6.5. Connecting smartDEN IP-16R-XX to a computer directly. This is the recommend initial connection. Figure 6.6.
  • Page 13 smartDEN IP-16R-XX User Manual 13 Apr 2021 6.5. Communication setup smartDEN IP-16R-XX is shipped with the following default parameters:  IP address: 192.168.1.100  Subnet mask: 255.255.255.0  Gateway: 192.168.1.1  Web password: admin Initially it is recommended to connect the module directly to the computer. Next you have to change your PC‟s IP address.
  • Page 14 smartDEN IP-16R-XX User Manual 13 Apr 2021 The next step is to enter into IPv4 properties. Figure 6.8. Enter in IPv4 properties section Set the IP address of your PC to be in the same network. Figure 6.9. Set the IP address -14-...
  • Page 15 Figure 6.10. Open the device via browser If the network settings are O‟K, the log-in page should appear: Figure 6.11. Login page smartDEN IP-16R-XX modules connected locally can be easily scanned and found via the tool Denkovi Finder as well. Figure 6.12. Denkovi Finder -15-...
  • Page 16: Default Settings

    smartDEN IP-16R-XX User Manual 13 Apr 2021 7. Default Settings 7.1. Table with default settings The smartDEN IP-16R-XX module is shipped with default (factory) settings shown in below table. The default settings can be reloaded, if necessary (see Steps for loading default settings Table 7.1.
  • Page 17 smartDEN IP-16R-XX User Manual 13 Apr 2021 7.2. Steps for loading default settings When necessary, the factory (default settings) may be applied so the module parameters will be returned back as those in point 6.1 from the current document. Figure 7.1. Loading the default settings 1.
  • Page 18: Web Access

    smartDEN IP-16R-XX User Manual 13 Apr 2021 8. Web access Figure 8.1. Web access To access the setup pages, run a web browser (Internet Explorer, Mozilla Firefox or similar), and enter the smartDEN IP-16R-XX IP address, for example: http://192.168.1.100 Figure 8.2. Open via browser Note: You will need to have JavaScript enabled in your browser.
  • Page 19 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.1. Login Figure 8.3. Login page Enter the password and click "Login" button. This will bring you to the smartDEN IP- 16R-XX main configuration page which contains details for the current firmware version and build date and provides buttons and links to obtain further details. Note: The default password is admin (passwords are case sensitive).
  • Page 20 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.2. General Settings Figure 8.4. General settings  Device Name: The name of the module (max 15 symbols). Every module can have different name in your network so they can be distinguished;  Save Outputs: When checked, each time the relays state is changed, it will be saved in non-volatile memory (EEPROM), so after reboot/restart it will be restored;...
  • Page 21 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.3. Network settings Figure 8.5. Network settings This menu lets you configure the network settings of smartDEN IP-16R-XX relay module:  Enable DHCP: This option allows DHCP to be enabled or disabled. If DHCP is set to Enabled, the Network page must be saved and smartDEN IP-16R-XX must be rebooted before obtaining an IP address;...
  • Page 22 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.4. Date and Time Settings Figure 8.6. Date/Time settings This page lets you configure the following parameters related with the real time clock built-in the module:  Date (dd/mm/yyyy): Enter the current date here in specified format; ...
  • Page 23 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.5. HTTP/XML/JSON Settings Figure 8.7. HTTP/XML/JSON Settings These settings let you configure the HTTP, XML and JSON access parameters of smartDEN IP-16R-XX:  HTTP Port: Port that the Web server listens for HTTP requests (default port is 80).
  • Page 24 smartDEN IP-16R-XX User Manual 13 Apr 2021 Note: When Encrypt Password mode is enabled, the Multiple Access option is not taken into account and, at any given moment, only one user can be logged-in. Note: When Multiple Access mode is enabled, any XML/JSON request will always reset the current HTTP session.
  • Page 25 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.6. Relays Settings Figure 8.8. Relays names This page configures the following parameters for the relays:  Description: Relay identification string (max 7 chars).  Pulse, ms (x100): Determines if the relay works in pulse mode and if so what is the duration of the single pulse (in milliseconds x 100 - for example value of 10 means 1 second).
  • Page 26 smartDEN IP-16R-XX User Manual 13 Apr 2021 (ON) for the specified time by this parameter. During this time, the relay can be set in low level (OFF) via week schedule, via some of the integration protocols, web browser control, HTTP/XML/JSON: o If the relay is set to high level (ON) via browser manually, via some of the integration protocols or HTTP/XML/JSON it will be in high level (ON) for the determined time by this parameter and then set back to low level;...
  • Page 27 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.7. Auto-reboot Settings smartDEN IP-16R-XX can be used for Auto-rebooting of IP devices (servers, PC hosts, switches, cameras etc.). In this mode smartDEN IP-16R-XX checks the working state of the device at regular intervals by sending ping requests. After preset number of successive ping failures smartDEN IP-16R-XX performs a predefined reset/reboot sequence of the monitored device connected to one of the 16 relays.
  • Page 28 smartDEN IP-16R-XX User Manual 13 Apr 2021  Ping Failures Before Reboot - the number of successive failed pings before the device is rebooted (from 1 to 100 pings);  Ping Delay After Reboot, sec – the waiting period after reboot that should pass before the device is checked again (from 1 to 3600 seconds);...
  • Page 29 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.8. Monitoring and control Figure 8.10. Monitoring and control This page provides monitoring and control of the smartDEN IP-16R-XX relays. From here you can control/monitor the relays. There is also provided information about how many reboots are performed and when was the last reboot and button for immediate reboot.
  • Page 30 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.9. Week Schedule Figure 8.11. Week schedule This page configures the Week Schedule table for switching Relays ON or OFF at specific times. You can add up to 30 items to the list. The top table of this page allows you to define a new item, while the bottom table shows the already defined list: ...
  • Page 31 smartDEN IP-16R-XX User Manual 13 Apr 2021 This feature allows you to turn on/off specific relays upon certain date and time or weekday without the need of LAN connection between the computer and the module. To delete an item, select it in Existing Items table and click on "Delete Selected"...
  • Page 32 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.12. SNMP Agent Configuration (for smartDEN IP-16R only) Figure 8.14. SNMP settings These settings let you configure the SNMPv1 (Simple Network Management Protocol Version 1) access to the module:  Enable SNMP: This option enables or disables SNMP access to the module; ...
  • Page 33 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.13. Modbus-TCP Settings (for smartDEN IP-16R-MT only) These settings let you configure the Modbus-TCP parameters of smartDEN IP- 16R-MT Figure 8.15. Modbus-TCP Settings page  Enable Modbus-TCP - this option enables or disables the Modbus-TCP communication;...
  • Page 34 smartDEN IP-16R-XX User Manual 13 Apr 2021 8.14. MQTT Settings (for smartDEN IP-16R-MQ only) These settings let you configure the MQTT communication of smartDEN IP-16R- Figure 8.16. MQTT settings  Enable – enable/disable the MQTT protocol;  MQTT Server - the MQTT server (broker) IP address or domain name (max. 22 chars);...
  • Page 35 smartDEN IP-16R-XX User Manual 13 Apr 2021  Non-encrypted Topic – plain (non-encrypted) topic the clients can subscribe to receive notifications from smartDEN IP-16R-MQ;  Encrypted Read Topic, Encrypted Write Topic, Encrypted Notify Topic - encrypted topics for communication with the Android DAE-aModules application or customized MQTT libraries.
  • Page 36: Http/Xml/Json Access

    smartDEN IP-16R-XX User Manual 13 Apr 2021 9. HTTP/XML/JSON access This operation mode allows custom applications to control the smartDEN IP-16R- XX without using a Web-browser. The custom application acts as a HTTP client, sending HTTP GET requests to the smartDEN IP-16R-XX. Figure 9.1.
  • Page 37 smartDEN IP-16R-XX User Manual 13 Apr 2021 <CurrentState> <LoginKey>65156</LoginKey> </CurrentState> http://192.168.1.100/current_state.json Reply (login required): {"CurrentState": {"LoginKey": "65156"}} Step 2: Request (password is sent as a parameter) http://192.168.1.100/current_state.xml?pw=28237099263eabfd88626124a822c http://192.168.1.100/current_state.json?pw=28237099263eabfd88626124a822 c64c Reply (password is O’K, login accepted): See: Appendix 2. Application reply formats Password encryption algorithm to be implemented in custom application is available upon request.
  • Page 38 smartDEN IP-16R-XX User Manual 13 Apr 2021 9.3. Getting the current state After a login the custom application can obtain the smartDEN IP-16R-XX current state by a request to the page current_state.xml / current_state.json : http://192.168.1.100/current_state.xml The reply contains page in XML format, see: Appendix 2.
  • Page 39 smartDEN IP-16R-XX User Manual 13 Apr 2021 9.4. Multiple XML Access In this mode the password should be passed as non-encrypted parameter with each request: http://192.168.1.100/current_state.xml?pw=admin&Relay1=1 http://192.168.1.100/current_state.json?pw=admin&Relay1=1 Multiple XML/JSON Access is not allowed when Encrypt Password option is enabled. 9.5. Parameters After a login the custom application can also control the smartDEN IP-16R-XX by sending parameters (name/value pairs) with the HTTP GET request.
  • Page 40 smartDEN IP-16R-XX User Manual 13 Apr 2021 9.5.3. smartDEN IP-16R-MQ Table 9.3. Valid smartDEN IP-16R-MQ HTTP parameters Name Value Description Relayi 0...1 Relayi value (i=1...16) SetAll 0...65535 Set all the relays with single command PulseOni 1...65535 Generate a positive (ON) pulse to relay (i=1...16) PulseOffi 1...65535...
  • Page 41: Integration Protocols

    smartDEN IP-16R-XX User Manual 13 Apr 2021 10. Integration protocols 10.1. SNMP (for smartDEN IP-16R only) smartDEN IP-16R supports SNMPv1 protocol – snmpget and snmpset. Most of the parameters can be configured/read via these commands. Read-only community string is used for reading and Read-Write Community String is used for changing the parameters.
  • Page 42 smartDEN IP-16R-XX User Manual 13 Apr 2021 10.1.3. Control Table 10.3. Control Name Access Description Syntax x.6.3.1.0 RelaysState read-write Access all the relays INTEGER32 with single command (0..65535) x.6.3.2.0 Reboot read-write Reboot the device INTEGER (0..255) x.6.3.3.0 sysUpTime read-only The time (in hundredths TIMETICKS of a second) since the device was last re-...
  • Page 43 smartDEN IP-16R-XX User Manual 13 Apr 2021 10.1.5. Auto-reboot Table 10.5. Auto-reboot settings Start OID Name Access Description Syntax x.6.5.1.0 AutorebootMod read- Auto-reboot Mode INTEGER eEnable write Enable (Disabled-0, {no(0),yes(1) } Enabled-1) x.6.5.2.0 IPAddressToPi read- IP Address To Ping DISPLAYSTRING write (SIZE (0..23)) x.6.5.3.0...
  • Page 44 smartDEN IP-16R-XX User Manual 13 Apr 2021 Figure 10.1. Modbus-TCP message format The MBAP header includes the following fields:  Transaction Identifier - used for transaction pairing when multiple messages are sent along the same TCP connection by a client without waiting for a prior response;...
  • Page 45 smartDEN IP-16R-XX User Manual 13 Apr 2021 smartDEN IP-16R-MT uses the following registers to represent the resources accessed by a Modbus command: Table 10.7. Modbus registers Resources Start Value Range Address Address Generate Pulses on Relays 1..16 (write only) 0x0000 0x000F 1..65535 Set Pulse Width for Relays 1..16...
  • Page 46 smartDEN IP-16R-XX User Manual 13 Apr 2021 Note: If the sum of the start address and coil quantity exceeds 16, an error response will be returned. Request example 1: Read Coil Status: Relays 1..3: Table 10.8. Read Coils Request Example 1 Field Length Data...
  • Page 47 smartDEN IP-16R-XX User Manual 13 Apr 2021 Coils Status bit 7 bit 6 bit 5 bit 4 bit 3 bit 2 bit 1 bit 0 (LSB) (MSB) (Relay 3) (Relay 2) (Relay 1) In this example relays states are: Relay 1: ON Relay 2: OFF Relay 3: ON Response example 2: Read Coil Status: Relays 4..16:...
  • Page 48 smartDEN IP-16R-XX User Manual 13 Apr 2021 10.2.1.1. Write Single Coil This command will turn single relay output to ON or OFF. Request The Write Single Coil request specifies the address of the coil to be forced:  Address: 0x0000 (Relay 1) to 0x000F (Relay 16) A value of 0xFF00 requests the coil to be ON, a value of 0x0000 requests the coil to be OFF, and a value of 0xFF02 toggles the coil state.
  • Page 49 smartDEN IP-16R-XX User Manual 13 Apr 2021 Table 10.15. Write Single Coil error response Field Length Data Transaction Identifier 2 Bytes 0x0002 Protocol Identifier 2 Bytes 0x0000 Length 2 Bytes 0x0003 Unit Identifier 1 Byte 0x00 Function Code 1 Byte 0x85 Exception Codes 1 Byte...
  • Page 50 smartDEN IP-16R-XX User Manual 13 Apr 2021 Byte Count 1 Byte 0x02 Outputs Value 2 Bytes 0xFEFF In this example the first byte of the Outputs Value field corresponds to relays 8 to 1, and the second byte – to relays 16 to 9. Response The normal response returns the function code, starting address, and quantity of coils forced.
  • Page 51 smartDEN IP-16R-XX User Manual 13 Apr 2021 Function Code 1 Byte 0x8F Exception Codes 1 Byte 0x01 or 0x02 10.2.1.3. Read Holding Registers This command is used to read the contents of a contiguous block of registers. Request The Read Holding Registers request specifies the starting register address and the number of registers to be read.
  • Page 52 smartDEN IP-16R-XX User Manual 13 Apr 2021 Error response example: Table 10.23. Read Holding Registers error response Field Length Data Transaction Identifier 2 Bytes 0x0004 Protocol Identifier 2 Bytes 0x0000 Length 2 Bytes 0x0003 Unit Identifier 1 Byte 0x00 Function Code 1 Byte 0x83 Exception Codes...
  • Page 53 smartDEN IP-16R-XX User Manual 13 Apr 2021 Error The possible error responses for function code 0x06 are:  Function Code (1 byte): 0x86 (0x80 + 0x06)  Exception Codes (1 byte): 0x01 – Function code not supported 0x02 – Invalid register address 0x03 –...
  • Page 54 smartDEN IP-16R-XX User Manual 13 Apr 2021 Response The normal response returns the function code, starting register address, and quantity of registers written. Response example: Set Week Schedule Start Date to 10/09/2020: Table 10.28. Write Multiple Registers reply Field Length Data Transaction Identifier 2 Bytes...
  • Page 55 smartDEN IP-16R-XX User Manual 13 Apr 2021 10.3. MQTT (for smartDEN IP-16R-MQ only) The smartDEN IP-16R-MQ supports MQTT protocol V3.1.1. The module runs a MQTT client that publishes the relays states, and subscribes to messages to switch the relays On/Off. Figure 10.2.
  • Page 56 smartDEN IP-16R-XX User Manual 13 Apr 2021 10.3.1.1. Get topics The smartDEN IP-16R-MQ publishes data up-on certain conditions. Another MQTT client (Laptop, Smartphone) is subscribed to these topics and receives the data. Table 10.30. MQTT get topics Topic Application Message Description Get/# all messages published by smartDEN IP-16R-MQ...
  • Page 57 smartDEN IP-16R-XX User Manual 13 Apr 2021 duration is in ms x 100. Set/RFi 1 to 65535 Generates a negative (OFF) pulse on a single relay (i=1...16). The pulse duration is in ms x 100. Set/Date Date format Changes the date of smartDEN IP- dd/mm/yyyy 16R-MQ Set/Time...
  • Page 58 smartDEN IP-16R-XX User Manual 13 Apr 2021 Table 10.32. Encrypted topics and reply in XML Topic Application Message Description Admin Read MQTT_COMMAND?GETSTATUS; Get the relays states Topic MQTT_COMMAND?RSXi=x; Turns relay (i=1…16) ON/OFF. x: 0 - OFF, 1 - ON, 2 – TOGGLE MQTT_COMMAND?ALLX=x;...
  • Page 59 smartDEN IP-16R-XX User Manual 13 Apr 2021 relays states - from 0 to 65535 MQTT_COMMAND?RNJi=x; Generates a positive (ON) pulse on a single relay (i=1...16). pulse duration is in ms x 100. MQTT_COMMAND?RFJi=x; Generates a negative (OFF) pulse on a single relay (i=1...16).
  • Page 60 smartDEN IP-16R-XX User Manual 13 Apr 2021 Figure 10.4. MQTT settings Last, the notifications from the DAE-aModules must be allowed in the Android "Notifications management" screen: -60-...
  • Page 61 smartDEN IP-16R-XX User Manual 13 Apr 2021 Figure 10.5. Android "Notifications management" settings for DAE-aModules When configured, the inputs to be monitored can be selected from the navigation menu: Figure 10.6. Navigation menu Example monitoring screens for digital, analog and temperature inputs are shown below: -61-...
  • Page 62 smartDEN IP-16R-XX User Manual 13 Apr 2021 Figure 10.7. Relays in DAE-aModules Examples of status and relays state notifications, published by smartDEN IP-16R- MQ are shown below. Figure 10.8. Status notifications -62-...
  • Page 63 smartDEN IP-16R-XX User Manual 13 Apr 2021 Figure 10.9. Inputs state notifications -63-...
  • Page 64: Security Considerations

    smartDEN IP-16R-XX User Manual 13 Apr 2021 11. Security considerations smartDEN IP-16R-XX runs a special firmware and do not have a general- purpose operating system. There are no extraneous IP services found on general- purpose operating systems (e.g. fingerd, tcp_wrapper, etc.) that can possibly be exploited by an unauthorized agent.
  • Page 65: Appendix 1. Mechanical Dimensions

    smartDEN IP-16R-XX User Manual 13 Apr 2021 12. Appendix 1. Mechanical dimensions Figure 12.1. PCB dimensions Figure 12.2. Box dimensions -65-...
  • Page 66: Appendix 2. Application Reply Formats

    smartDEN IP-16R-XX User Manual 13 Apr 2021 13. Appendix 2. Application reply formats 13.1. XML reply -66-...
  • Page 67 smartDEN IP-16R-XX User Manual 13 Apr 2021 13.2. JSON reply -67-...

Table of Contents