Download
Share
Print this page
Denkovi smartDEN IP-Maxi Series User Manual
  1. Manuals
  2. Brands
  3. Denkovi Manuals
  4. I/O Systems
  5. smartDEN IP-Maxi Series
  6. User manual

Denkovi smartDEN IP-Maxi Series User Manual

Web-enabled ethernet-based i/o relay modules
Hide thumbs

Advertisement

Quick Links

Download this manual
®
smartDEN IP-Maxi-XX User Manual
30 Oct 2023
smartDEN IP-Maxi-XX
Web-enabled Ethernet-based I/O Relay Modules
User Manual
Date: 30 Oct 2023
Device
Short Name
Integration Protocol
Firmware version
v1.27 / Jan 2022
smartDEN IP-Maxi
SNMPv2
v1.27 / Feb 2023
smartDEN IP-Maxi-MT
Modbus TCP
v1.26 / Jul 2021
smartDEN IP-Maxi-MQ
MQTT V3.1.1
- 1 -

Advertisement

loading
Need help?

Need help?

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

Questions and answers

Related Manuals for Denkovi smartDEN IP-Maxi Series

Summary of Contents for Denkovi smartDEN IP-Maxi Series

  • Page 1 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 smartDEN IP-Maxi-XX Web-enabled Ethernet-based I/O Relay Modules User Manual Date: 30 Oct 2023 Device Short Name Integration Protocol Firmware version v1.27 / Jan 2022 smartDEN IP-Maxi SNMPv2 v1.27 / Feb 2023 smartDEN IP-Maxi-MT Modbus TCP v1.26 / Jul 2021 smartDEN IP-Maxi-MQ...
  • Page 2 Apple, Mac, Mac OS, Mac OS logo are either trademarks or registered trademarks of Apple Computer Inc. in the United States and/or other countries. smartDEN is a registered trademark of Denkovi Assembly Electronics LTD in European Union. Other product names and company names described in this document are trademarks or registered trademarks.

  • Page 3: Table Of Contents

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Content 1. Features ....................4 2. Ordering codes..................6 3. Application examples ................7 4. Technical parameters ................ 15 5. Connectors, ports and led indicators ..........18 6. Installation ..................19 7. Default settings ................. 31 8.

  • Page 4: Features

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 1. Features smartDEN IP-Maxi-XX is an Ethernet module (IP controller) that can be used in a wide range of remote monitoring, control, measurement and data-acquisition applications. Thank to its multi-channel design (8 digital inputs, 4 analog inputs, 4 temperature inputs, 8 SPDT relays and 2 analog outputs) this device can perform simultaneously a variety of measurement and control functions.
  • Page 5 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023  Real time clock (can sync up with network time servers); Power Supply:  Supply voltage: 12V DC or 24V DC (selectable during purchase);  Additional source voltage 12V DC or 24V DC provided to power input sensors; ...

  • Page 6: Ordering Codes

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 2. Ordering codes Table 2.1. Ordering codes Short Name Ordering Codes Description SNMP model, 12VDC supply smartDEN IP-Maxi-12V voltage smartDEN IP-Maxi SNMP model, 24VDC supply smartDEN IP-Maxi-24V voltage Modbus TCP model, 12VDC smartDEN IP-Maxi-MT-12V supply voltage smartDEN IP-Maxi-MT...

  • Page 7: Application Examples

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3. Application examples The following examples show some basic applications of smartDEN IP-Maxi-XX. The examples are only conceptual and additional equipment/connections can be required in actual implementations. 3.1. Electrical appliances remote control applications smartDEN IP-Maxi-XX can be used to control remotely electrical appliances (Fig.
  • Page 8 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.2. Monitoring and logging applications smartDEN IP-Maxi-XX can be used to build monitoring and logging systems. Up to 8 various kinds of sensors for temperature, humidity, distance, light etc. can be connected to the Analog Inputs of the device (Fig. 3.2 and Fig. 3.3). Provided SNMP, MQTT or Modbus TCP (depending on the model) along with the HTTP/XML/JSON APIs allow for easy integration with third-party applications.
  • Page 9 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.3. Standalone applications with sensors and electrical devices Once configured, smartDEN IP-Maxi-XX can be used in standalone control applications. For example, the events from Digital Inputs or threshold conditions of single/differential Analog Inputs can be configured to control various devices connected to Relay outputs (Fig.
  • Page 10 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.4. Events counter smartDEN IP-Maxi-XX provides 8 x 32-bit Counters (from 0 up to 2 -1) attached to the Digital Inputs that can be used to count various events - for example detect when a person enters in a shop through the door (Fig.
  • Page 11 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.5. Web based thermo-regulator Each Relay can be set to work in Regulator mode where it can be controlled only from an Analog Input. The controller can be configured to switch different Relays upon the value of single/differential Analog Input (one input can control many Relays).

  • Page 12: Home Automation

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.6. Home automation smartDEN IP-Maxi-XX can be used in a variety of home automation tasks:  Climate: heating, ventilation and air conditioning;  Lighting: switching On/Off the electric lights in the house; ...
  • Page 13 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.7. Irrigation systems Other applications of smartDEN IP-Maxi-XX include irrigation systems. Two different modes can be combined:  Start and stop the irrigation at specific times using the Week Schedule features;  Start and stop the irrigation depending on humidity level by applying a control loop including a humidity or rain sensor and solenoid valve controlled by a Relay.
  • Page 14 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 3.8. Dimming The analog outputs (0-10V) can be used for dimming led lights as well. Please note that a separate dimmer could be necessary. Figure 3.10. Controlling led lights with analog outputs - 14 -...

  • Page 15: Technical Parameters

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 4. Technical parameters Table 4.1. Physical parameters Parameter Value Size (L / W / H), mm 210 x 85 x 58 Weight, g Operating temperature, °C 0 to 70 Table 4.2. System parameters Parameter Value 12 or 24 (depends on the model)
  • Page 16 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Table 4.5. Analog inputs Parameter Value Analog inputs number Analog inputs full scale voltage range, V DC 0 up to 10 Analog inputs absolute maximum non- destructive voltage, V DC Analog inputs resolution, bits ∼10 Value of LSB, mV Input impedance, KΩ...
  • Page 17 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Table 4.9. Network/protocols Parameter Value Network parameters IP/Mask/Default gateway MAC lock (protection) DHCP ICMP Integration protocol SNMPv2c - smartDEN IP-Maxi SNMPv2 - smartDEN IP-Maxi MQTT V3.1.1 - smartDEN IP-Maxi- Web server for configuration/access Secure HTTP/XML/JSON access - 17 -...

  • Page 18: Connectors, Ports And Led Indicators

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 5. Connectors, ports and led indicators A picture with the smartDEN IP-Maxi-XX connectors, ports and led indicators is shown in Fig. 5.1. Figure 5.1. Device overview - 18 -...

  • Page 19: Installation

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 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 sensors, providing power and configuring via a web browser.
  • Page 20 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 6.2. Power supply smartDEN IP-Maxi-XX must be powered with 12V DC stabilized and filtered voltage. After power on, the power led must be on and STATUS indicator must start blinking in 5 seconds which means the module is running normally (Fig. 6.2). Figure 6.2.

  • Page 21: Connecting Inputs

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 6.3. Connecting inputs Fig. 6.3 shows the typical connection of dry contact sensors, switches, buttons, door sensors etc. to the Digital Inputs. Fuse: 0.5A 12V+ Fuse: 1.5A Figure 6.3. Connecting SPST NO output (dry contact) sensors, switches, buttons, door sensors etc.
  • Page 22 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 When connecting sensors with PNP output they can be powered from the additional internal 12V DC power source (Fig. 6.4). Sensor1 PNP OUT Sensor2 PNP OUT Sensor8 PNP OUT Fuse: 0.5A 12V+ Fuse: 1.5A Figure 6.4.
  • Page 23 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Sensors with 0-20 mA output can be connected to the Analog Inputs as shown in Fig. 6.5. AGND Resistors: 470R, 0.250 Watts 0†20mA 0†20mA 0†20mA 12V+ Fuse: 1.5A Figure 6.5. Connecting 0-20 mA output sensors to the Analog Inputs - 23 -...
  • Page 24 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Fig. 6.6 shows the connection of analog sensors with output from 0 up to 10V DC to the Analog Inputs. Sensor1 Sensor2 AGND 12V+ Fuse: 1.5A Figure 6.6. Connecting analog sensors with output from 0 up to 10V DC to the Analog Inputs - 24 -...
  • Page 25 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 NTC thermistors type B57500M can be connected to the Temperature Inputs (Fig. 6.7). Rt°1 Rt°2 Rt°4 12V+ Fuse: 1.5A Rt°1 - Rt°4: B57500M Figure 6.7. Connecting NTC sensors type B57500M to the Temperature Inputs - 25 -...
  • Page 26 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Below is shown example connection how to control load with relays (lamp). Figure 6.8. Connecting lamp to relay - 26 -...

  • Page 27: Network Connection

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 6.4. Network connection smartDEN IP-Maxi-XX supports AUTO-MDIX so either "crossover" or "straight- through" network cable can be used (Fig. 6.9, 6.10). Figure 6.9. Direct connection of smartDEN IP-Maxi-XX to a computer Figure 5.10. Connecting smartDEN IP-Maxi-XX to a wireless router - 27 -...

  • Page 28: Communication Setup

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 6.5. Communication setup smartDEN IP-Maxi-XX ships 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 29 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Figure 6.12. IPv4 properties section Set the IP address of your PC to be in the same network as smartDEN IP-Maxi- XX (Fig. 6.13). Figure 6.13. Set the IP address Finally, in the address bar of your Web-browser enter the IP address of the smartDEN IP-Maxi-XX and press Enter, or select „Go‟...
  • Page 30 If the network settings are O‟K, the login page should appear (Fig. 6.15). Figure 6.16. Login page smartDEN IP-Maxi-XX modules connected locally can be easily scanned and found via the Denkovi Finder tool as well (Fig. 6.17). Figure 6.17. Denkovi Finder utility - 30 -...

  • Page 31: Default Settings

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 7. Default settings 7.1. Table with default settings The smartDEN IP-Maxi-XX module is shipped with default (factory) settings shown in Table 6.1. The default settings can be reloaded, if necessary (see point 7.2).
  • Page 32 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Digital Inputs Description DIN<n>, where <n> = 1..8 Counter Filter (ms) SNMP Trap / MQTT Disabled SNMP Trap Value / Edge (0) Off Analog Inputs Description (In1 to In4) AIN<n>, where <n> = 1..4 Description (In5 to In8) TIN<n>, where <n>...
  • Page 33 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Trap Receiver IP Address 0.0.0.0 Trap Receiver Port Trap Community Trap Sending Level Triggered MQTT Settings Enable Disabled MQTT Server iot.eclipse.org Server Port 1883 Username Password Publish Mode Periodically Publish Period, sec Modbus TCP Enable Modbus-TCP Modbus-TCP Port...
  • Page 34 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 7.2. Steps for loading the default settings When necessary, the factory (default settings) may be applied so the module parameters will be returned back to those pointed out in point 7.1 of the current document.

  • Page 35: Web Access

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8. Web access Figure 8.1. Web access To access the setup pages, start a web browser (Internet Explorer, Chrome, Mozilla Firefox or similar), and enter the smartDEN IP-Maxi-XX IP address, for example: http://192.168.1.100 Figure 8.2.
  • Page 36 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.1. Login Figure 8.3. Login page Enter the password and click Login button or press Enter (Fig. 8.3). This will bring you to the smartDEN IP-Maxi-XX main configuration page, which contains details of the current firmware version/build date and provides a link to the documentation page.

  • Page 37: General Settings

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.2. General settings General settings page is show in Fig. 8.6. 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; ...
  • Page 38 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023  Save Outputs - when checked, each time a Relay or Analog Output value is changed, it will be saved in non-volatile memory (EEPROM), so after reboot/restart it will be restored; This option should be used with care in dynamic systems because of restriction in maximum write cycles of the EEPROM (usually 100 000 write/erase cycles).

  • Page 39: Network Settings

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.3. Network settings The page shown in Fig. 8.5 lets you configure the network settings of smartDEN IP-Maxi-XX module. Figure 8.5. Network settings  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-Maxi-XX must be rebooted before obtaining an IP address;...

  • Page 40: Date/Time Settings

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.4. Date/Time Settings This page lets you adjust the date/time and set the SNTP Simple Network Time Protocol) server for auto synchronization (Fig. 8.6). Figure 8.6. Date/Time settings  Date (dd/mm/yyyy) - the current date in specified format; ...
  • Page 41 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.5. HTTP/XML/JSON These settings let you configure the HTTP and XML/JSON access parameters of smartDEN IP-Maxi-XX (Fig. 8.7). Figure 8.7. HTTP/XML/JSON settings  HTTP Port - port on which the integrated Web server listens for HTTP requests (default port is 80).
  • Page 42 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Note: When Multiple Access mode is enabled, any XML/JSON request will always reset the current HTTP session. Note: When Multiple Access mode is disabled, whether Encrypt Password is enabled or not, it is possible to access the module via XML/JSON only after login for the specified session timeout.

  • Page 43: Digital Inputs

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.6. Digital Inputs Digital Inputs settings page is shown in Fig. 8.8. Figure 8.8. Digital Inputs settings  Description - identification string of the input (max. 7 chars); This description will appear in XML/JSON files, as well as in the Monitoring & Control page.
  • Page 44 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Figure 8.9. SNMP Trap Value="0 (Off)", Trap Sending="Edge Triggered" Figure 8.10. SNMP Trap Value="0 (Off)", Trap Sending="Level Triggered" o 1 (On) – the Counter is incremented on the rising edge (0 -> 1). With Trap Sending="Edge Triggered"...
  • Page 45 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Figure 8.12. SNMP Trap Value="1 (On)", Trap Sending="Level Triggered" o 2 (Both) – Counter update takes place on each Digital Input state change (both falling and rising edges). With Trap Sending="Edge Triggered" both edges trigger a trap message (Fig.
  • Page 46 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 mode), on the Publish Mode parameter and one the selected Digital Input settings;  Edge (for smartDEN IP-Maxi-MQ only) - this parameter determines the condition to increment the counter and to send a MQTT notification: o 0 (Off) –...
  • Page 47 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 o 1 (On) – the Counter is incremented on the rising edge (0 -> 1). With Publish Mode="Periodically" the MQTT notifications are sent periodically over the specified period via Publish Period parameter (Fig. 8.18). With Publish Mode ="Edge Triggered"...
  • Page 48 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 periodically over the specified period via Publish Period parameter (Fig. 8.21). With Publish Mode ="Edge Triggered" a single MQTT notification is sent while the Digital Input is low (0) or high (1) (Fig. 8.22). With Publish Mode ="Edge Triggered + Periodically"...
  • Page 49 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Inputs/Counters 1, 2 and 3 These counters are implemented in software but not in hardware. Due to this there are some considerations which must be taken in mind when working with them: ...

  • Page 50: Analog Inputs

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.7. Analog Inputs Analog Inputs settings page is shown in Fig. 8.24. Input 1 to Input 4 are used to measure voltage in range 0-10VDC. Input 5 to Input 8 are used to measure temperature from 10K NTC sensors B57500M (with range temperature range -55°C/- 67°F to +155°C/311°F).
  • Page 51 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 o For Input 5 to Input 8 range is from -70.0 to +300.0 degF or -55.0 to +150.0 degC;  SNMP Trap (for smartDEN IP-Maxi only) determines Analog/Temperature Input will send SNMP trap notifications or not; o If Traps Sending parameter from web page SNMP Traps Settings is set to "Level Triggered"...
  • Page 52 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023  MQTT (for smartDEN IP-Maxi-MQ only) - enables this Analog Input to publish its status via MQTT protocol. The publish topic and publish mechanism depends on selected Encrypt Topic parameter (encrypted/non- encrypted mode), on the Publish Mode parameter and one the selected Analog Input settings;...
  • Page 53 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 o If Publish Mode parameter from web page MQTT Settings is set to "Edge Triggered + Periodically" a single notification is sent when measured value crosses over the High Threshold or below the Low Threshold values. Notifications are also sent in intervals determined by the parameter Publish Period from the same page when the measured (scaled) value is higher than High Threshold and lower than Low Threshold (Fig.
  • Page 54 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.8. Relays Settings Relays settings page is shown below. Figure 8.30. Relays settings  Description - identification string of the relay (max 7 chars); This description will appear in XML/JSON files, as well as in the Monitoring & Control page.
  • Page 55 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 o Inverse(DI=1) - a rising edge (0 -> 1) of the Digital Input switches the Relay Off.  AI+ No - the number of the Analog Input (1 to 8) which is "attached" to this Relay.
  • Page 56 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023  Pulse, ms (x100) – if set to non-zero, the Relay operates in pulse mode. The pulse duration is set in tenths of second (for example value of 20 means 2 seconds). The range is from 0 and 65535 (0 disables the pulse mode). When enabled, each time the Relay is switched On, it will generate a single pulse with specified duration.

  • Page 57: Analog Outputs

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.9. Analog Outputs Figure 8.33. Analog Outputs page  Description - identification string (max 7 chars); This description will appear in XML/JSON files, as well as in the Monitoring & Control page. ...

  • Page 58: Monitoring & Control

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.10. Monitoring & Control This page is used to monitor the states of the Digital and Analog Inputs as well as to switch On/Off the Relays and set the values of Analog Outputs (Fig. 8.34). A relay can be switched On/Off from the Monitoring &...

  • Page 59: Week Schedule

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.11. Week Schedule This page configures the Week Schedule table for switching Relays On/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 (Fig.
  • Page 60 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.12. Logout Figure 8.36. Log off - 60 -...
  • Page 61 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.13. Reboot Figure 8.37. Reboot - 61 -...
  • Page 62 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.14. SNMP Agent (for smartDEN IP-Maxi only) These settings let you configure the SNMPv2c (Simple Network Management Protocol) access parameters to the smartDEN IP-Maxi-XX (Fig. 8.38). Figure 8.38. SNMP agent configuration  Enable SNMP - this option enables or disables SNMP access; ...
  • Page 63 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.15. SNMP Traps (for smartDEN IP-Maxi only) smartDEN IP-Maxi-XX can be configured to send SNMPv2 trap notifications triggered by Digital/Analog Input conditions (Fig. 8.39). Figure 8.39. SNMP Trap settings  Enable Trap - enables or disables sending of traps to the server; ...
  • Page 64 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.16. MQTT Settings (for smartDEN IP-Maxi-MQ only) These settings let you configure the MQTT communication of smartDEN IP-Maxi- 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 65 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023  Encrypt Topic – when enabled, the MQTT topic is encrypted;  Non-encrypted Topic – plain (non-encrypted) topic the clients can subscribe to receive notifications from smartDEN IP-Maxi-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 66 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 8.17. Modbus-TCP Settings (for smartDEN IP-Maxi-MT only) These settings let you configure the Modbus-TCP parameters of smartDEN IP- Maxi-MT Figure 8.15. Modbus-TCP Settings page  Enable Modbus-TCP - this option enables or disables the Modbus-TCP communication;...

  • Page 67: Http Xml/Json Operation

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 9. HTTP XML/JSON operation This operation mode allows custom applications to control the smartDEN IP-Maxi- XX without using a Web-browser. The custom application acts as a HTTP client, sending HTTP GET requests to the smartDEN IP-Maxi-XX (Fig. 9.1). As a reply the smartDEN IP-Maxi-XX returns data as either JSON or XML file for parsing and/or processing by the custom application.

  • Page 68: Appendix 1. Application Reply

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 <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 1. Application reply formats Password encryption algorithm to be implemented in custom application is available upon request.
  • Page 69 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 9.2. Login (Non-Encrypted Password) In this mode the password is passed as non-encrypted parameter with the request: http://192.168.1.100/current_state.xml?pw=admin http://192.168.1.100/current_state.json?pw=admin Getting the <LoginKey> in the answer in this mode means only that the provided password is wrong or the login session has been expired.
  • Page 70 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 9.3. Getting the current state After a login the custom application can obtain the smartDEN IP-Maxi-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 1.
  • Page 71 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 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=0 Multiple XML/JSON Access is not allowed when Encrypt Password option is enabled. - 71 -...
  • Page 72 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 9.5. Parameters After a login the custom application can also control the smartDEN IP-Maxi-XX by sending parameters (name/value pairs) with the HTTP GET request. Valid parameters and values are shown in the bellow tables. Table 9.1.

  • Page 73: Integration Protocols

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 10. Integration Protocols 10.1. SNMP (for smartDEN IP-Maxi only) 10.1.1. SNMP Agent smartDEN IP-Maxi 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 74 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Analog Input Trap Integer { No(0), Yes(1) 8.2.2.1.5.0 8.2.2.1.5.7 Enable Flag Analog Input ADC 8.2.2.1.6.0 8.2.2.1.6.7 Integer (0..1023) Value Analog Input Min DisplayString 8.2.2.1.7.0 8.2.2.1.7.7 Value (SIZE(0..7)) Analog Input Max DisplayString 8.2.2.1.8.0 8.2.2.1.8.7 Value (SIZE(0..7))
  • Page 75 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 10.1.4. Control Table 10.6. Control Description Access Syntax Integer {Celsius(0), x.8.3.1.0 TemperatureScale Fahrenheit(1) } x.8.3.2.0 AnalogInputFilter Integer (0..30) x.8.3.3.0 RelayFilter Integer (0..9999) x.8.3.4.0 Digital Inputs State Integer (0..255) x.8.3.5.0 Relays State Integer (0..255) x.8.3.6.0 System Date (dd/mm/yyyy) DisplayString x.8.3.7.0 System Time (hh:mm)
  • Page 76 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Each of the inputs can be individually configured to send trap notifications when an event is triggered. Table 10.10. SNMP v1 traps Generic Type Specific Variable Bindings Description Type Name Value coldStart Reboot trap autenticationFailure Wrong SNMP...

  • Page 77: Modbus Commands

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 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 78 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 smartDEN IP-Maxi-MT uses the following holding registers to represent the resources accessed by a Modbus command: Table 10.12. Modbus registers Resources Start Value Range Comm Address Address code Relays 1..8 Generate Pulses on Relays (write 0x0000 0x0007 1..65535...
  • Page 79 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 AI Threshold 2 (AI 8) 0x0870 0x0872 Pulse, ms (x100) 0x0900 0x0907 0..65535 3, 6, 16 Disable Week Schedule 0x0A00 0x0A07 0-Enable 3, 6, 16 schedule 1-Disable schedule Use Filter 0x0B00 0x0B07 0-Disable filter 3, 6, 16 1-Enabel filter...
  • Page 80 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Min (TIN 4) 0x2170 0x2173 Max (Ain1…Ain4) (2) (3) (4) 3, 16 Max (AIN 1) 0x2200 0x2203 7 ASCII chars Value range: Max (AIN 2) 0x2210 0x2213 -9999.9..+9999.9 Max (AIN 3) 0x2220 0x2223 Max (AIN 4) 0x2230...
  • Page 81 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 Week Schedule Row WeekDays Code 0x6700 0x671D 0..127 3, 6, 16 General Settings Save Outputs Option 0x6800 0x6800 0..1 3, 6, 16 System Date (Day) 0x6900 0x6900 1..31 3, 6, 16 System Date (Month) 0x6901 0x6901 1..12...
  • Page 82 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 10.3. MQTT (for smartDEN IP-Maxi-MQ only) The smartDEN IP-Maxi-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.1.
  • Page 83 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 10.3.1. Plain (non-encrypted) mode In this mode, smartDEN IP-Maxi-MQ uses non-encrypted topics to provide I/O monitoring/control and basic parameters configuration. Encrypt option in MQTT Settings page must be turned off in order to work in this mode.
  • Page 84 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 topics (excluding the /All topic) 1 - all the I/O states are published at once in XML format under the /All topic. 2 - all the I/O states are published at once in JSON format under the /All topic.
  • Page 85 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 settings page for the Relays, Digital Inputs, Analog/Temperature Inputs and Analog Outputs. Also they are published:  periodically (see the Publish Mode option from MQTT Settings page);  in case of i/o state change (see the Publish Mode option from MQTT Settings page);...
  • Page 86 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 10.3.2. Encrypted topics mode The encrypted topics mode is designed mainly for communication with Denkovi software applications (for example DAE-aModules, DRMv3 Software…) or other customized MQTT libraries. Encrypt option in MQTT Settings page must be turned on in order to work in this mode.
  • Page 87 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 relay (i=1...8). The pulse duration is in ms x RFXi=x; RFJi=x; Generates a negative (OFF) pulse on a single relay (i=1...8). The pulse duration in ms x 100 DONAMEXi=x; DONAMEJi=x; Sets the relay (i=1...8) name. The length of is 1 to 7 symbols DICXi=x;...

  • Page 88: Software

    Device from DRMv3 list: smartDEN IP-Maxi-MQ-XML (device_xml) Integration (communication) protocol: HTTP/XML XML/JSON Access parameter must be enabled and settings from the HTTP/XML/JSON Settings web server page must mach. The full documentation for the DRMv3 Software can be found on this link: http://denkovi.com/drm-software-v3 - 88 -...
  • Page 89 Device from DAE-aModules Device Model list: smartDEN IP-Maxi - XML Integration (communication) protocol: HTTP/XML XML/JSON Access parameter must be enabled and settings from the HTTP/XML/JSON Settings web server page must mach. The full documentation for the DAE-aModules android app can be found on this link: http://denkovi.com/DAE-aModules - 89 -...
  • Page 90 Device from DAE-iModules Device Model list: smartDEN IP-Maxi Integration (communication) protocol: SNMP SNMP must be enabled and settings from the SNMP Agent Configuration web server page must mach. The full documentation for the DAE-iModules iOS app can be found on this link: http://denkovi.com/DAE-aModules - 90 -...

  • Page 91: Security Considerations

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 12. Security considerations The smartDEN IP-Maxi-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 92: Appendix 1. Application Reply Formats

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 13. Appendix 1. Application reply formats 13.1. XML reply - 92 -...
  • Page 93 ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 13.2. JSON reply - 93 -...

  • Page 94: Appendix 2. Mechanical Drawing

    ® smartDEN IP-Maxi-XX User Manual 30 Oct 2023 14. Appendix 2. Mechanical drawing Device dimensions Figure 14.1. - 94 -...

  • Page 95: Appendix 3. Disclaimer

    Denkovi Assembly Electronics LTD accepts no liability for inclusion or use of Denkovi Assembly Electronics LTD products in such applications and such inclusion or use is at the customer's own risk. Should the customer use Denkovi Assembly Electronics LTD products for such application, the customer shall indemnify and hold Denkovi Assembly Electronics LTD harmless against all claims and damages.

This manual is also suitable for:

Smartden ip-maxiSmartden ip-maxi-mtSmartden ip-maxi-mqSmartden ip-maxi-12vSmartden ip-maxi-24vSmartden ip-maxi-mt-12v ... Show all