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.
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".
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...
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...
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-...
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.
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.
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...
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-...
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.
Need help?
Do you have a question about the smartDEN IP-16R Series and is the answer not in the manual?
Questions and answers