Denkovi smartDEN IP-Maxi Скачать руководство пользователя страница 53

Страница: 53 / 63

smartDEN

IP-Maxi

User Manual

09 Mar 2018

- 53 -

8. HTTP XML/JSON operation

This operation mode allows custom applications to control the

smartDEN IP-Maxi

without using a Web-browser. The custom application acts as a HTTP client, sending
HTTP GET requests to the

smartDEN IP-Maxi

(Fig. 8.1). As a reply the

smartDEN

IP-Maxi

returns data as either JSON or XML file for parsing and/or processing by the

custom application.

Figure 8.1.

smartDEN IP-Maxi

working as a HTTP server

To receive the current state of the

smartDEN IP-Maxi,

the application requests

the page

current_state.xml

current_state.json

, for example:

http://192.168.1.100/current_state.xml
http://192.168.1.100/current_state.json

In order to use this mode, XML/JSON access should be enabled (see

7.6

The XML/JSON login process differs depending on the selected Encrypt Password

option.

8.1. XML access

8.1.1.

XML login (encrypted password)

This mode can be used to prevent unauthorized access to

smartDEN IP-Maxi

When selected, a two-step login sequence is performed as a protection against
unauthorized access.

The first time the custom application requests the page

current_state.xml

, a

random login key is issued in the reply. Next the custom application uses this key to
encrypt the password. The encrypted password is sent as a parameter with the next
request to the page

current_state.xml

Bellow is an example of login process:

Step 1:

Request

http://192.168.1.100/current_state.xml

Reply (login required):

</CurrentState>

Содержание smartDEN IP-Maxi

Страница 1: ... smartDEN IP Maxi User Manual 09 Mar 2018 1 smartDEN IP Maxi Web enabled IP Controller User Manual Date 09 March 2018 For firmware version v1 24 March 2018 ...

Страница 2: ...emarks of Microsoft Corporation in the United States and or other countries 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 registered trademark of Denkovi Assembly Electronics LTD in European Union Other product names and company names described in this document are trademarks or registered t...

Страница 3: ...1 Features 4 2 Application examples 6 3 Technical parameters 14 4 Connectors ports and led indicators 17 5 Installation 18 6 Default settings 30 7 Web access 33 8 HTTP XML JSON operation 53 9 SNMP 59 10 Security considerations 62 11 Mechanical drawing 63 ...

Страница 4: ... to digital inputs 4 analog inputs input voltage range 0 10V DC 4 temperature inputs for sensors NTC thermistors type B57500M Linearization scaling for the analog inputs Programmable temperature units Celsius Fahrenheit Configurable filters for the digital analog inputs Outputs 8 SPDT relays with NO and NC contacts 2 analog outputs 0 10V DC 10 bit resolution Single pulse feature for the relay outp...

Страница 5: ... 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 Power supply protection against reverse polarity Physical and Environment Working temperature range 0 to 70 C DIN rail standard housing ...

Страница 6: ...l implementations 2 1 Electrical appliances remote control applications smartDEN IP Maxi can be used to control remotely electrical appliances Fig 2 1 Up to 8 electrical devices connected to Relays can be controlled independently Various integration protocols SNMP HTTP XML JSON Web browser access can be used by any modern device to control the appliances from all over the world Figure 2 1 Controll...

Страница 7: ...sed 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 2 2 Provided SNMP and HTTP XML JSON APIs allow for easy integration with third party applications Figure 2 2 Remote sensors monitoring ...

Страница 8: ...ndalone 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 2 3 In addition a Week Schedule table for switching Relays On Off at specific time can be specified Figure 2 3 Standalone control of electrical devices ...

Страница 9: ...that can be used to count various events for example detect when a person enters in a shop through the door Fig 2 4 Upon detecting the specified edge level condition smartDEN IP Maxi increments the corresponding Counter With suitable software and database one could easily organize a simple monitoring and statistic system Figure 2 4 Counting visitors in a shop ...

Страница 10: ...ller can be configured to switch different Relays upon the value of single differential Analog Input one input can control many Relays For example one Relay can be set for heating another for cooling and etc Fig 2 5 All the process may be monitored online and this makes smartDEN IP Maxi suitable for building standalone Web enabled thermo regulators Figure 2 5 Web based thermo regulator ...

Страница 11: ... panel must be monitored and controlled based on two temperature sensors values The first sensor monitors the temperature of the panel water and the second monitors the temperature from the boiler water If the boiler water is cooler than the panel water the valve is opened and the hot water from the panel comes in to the boiler Figure 2 6 Differential thermo regulator ...

Страница 12: ...sing the blinds and curtains depending on the level of the outside sunlight Use of Pulse mode of the Relays for controlling garage doors windows roofs and for any other application where a certain period of time should be maintained etc Use of integrated Week Schedule features to switch On Off appliances up to 30 times per day in a standalone mode Use of many inputs to one relay controlling mode e...

Страница 13: ...ifferent 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 Figure 2 8 smartDEN IP Maxi can be used in home irrigation systems ...

Страница 14: ... settings restore button Yes Reset button Yes Table 3 3 Digital inputs Parameter Value Digital inputs number 8 Digital inputs voltage range V DC 0 up to 30 Input switching threshold from 0 to 1 V DC 7 6 Input switching threshold from 0 to 1 mA 3 2 Input switching threshold from 1 to 0 V DC 4 5 Input switching threshold from 1 to 0 mA 1 8 Supported sensor output type PNP Input type Resistive with S...

Страница 15: ...odule Intensive communication HTTP SNMP with the module Table 3 6 Temperature inputs Parameter Value NTC inputs number 4 Sensor type B57500M Units Celsius Fahrenheit Sensor working temperature range 55 C 67 F to 155 C 311 F Accuracy 0 5 C 0 9 F Sample period ms Min 25 Max 300 No communication HTTP SNMP is taking place with the module Intensive communication HTTP SNMP with the module Table 3 7 Rela...

Страница 16: ...Table 3 9 Network protocols Parameter Value Network parameters IP Mask Default gateway MAC lock protection Yes DHCP Yes DNS Yes ICMP Yes SNMP SNMPv2c SMTP traps format SNMPv2 Web server for configuration access Yes Secure HTTP XML JSON access Yes ...

Страница 17: ... smartDEN IP Maxi User Manual 09 Mar 2018 17 4 Connectors ports and led indicators A picture with the smartDEN IP Maxi connectors ports and led indicators is shown in Fig 4 1 Figure 4 1 Device overview ...

Страница 18: ...nting the device connecting to an IP network connecting sensors providing power and configuring via a web browser 5 1 Box mounting smartDEN IP Maxi can be mounted to a standard 35 mm by 7 55 mm DIN rail Fig 5 1 Attach the module to the DIN rail by hooking the hook on the back of the enclosure to the DIN rail and then snap the bottom hook into place Figure 5 1 Mounting the device to a DIN rail ...

Страница 19: ...y Fig 5 2 Figure 5 2 smartDEN IP Maxi power supply Please keep the polarity and the power supply voltage range smartDEN IP Maxi does not accept AC power supply voltage It is highly recommended to check the power supply source parameters before the module is powered on The power supply equipment shall be resistant to short circuit and overload in secondary circuit When in use do not place the equip...

Страница 20: ...s Fig 5 3 shows the typical connection of dry contact sensors switches buttons door sensors etc to the Digital Inputs 12V Fuse 1 5A Sw1 Fuse 0 5A Sw2 Sw8 Figure 5 3 Connecting SPST NO output dry contact sensors switches buttons door sensors etc to the Digital Inputs ...

Страница 21: ...ith PNP output they can be powered from the additional internal 12V DC power source Fig 5 4 Fuse 0 5A PNP OUT Sensor1 PNP OUT Sensor2 PNP OUT Sensor8 12V Fuse 1 5A Figure 5 4 Connecting PNP output digital sensors requiring power supply voltage 12V DC to the Digital Inputs ...

Страница 22: ...9 Mar 2018 22 Sensors with 0 20 mA output can be connected to the Analog Inputs as shown in Fig 5 5 12V Fuse 1 5A Resistors 470R 0 250 Watts 0 20mA 0 20mA 0 20mA AGND Figure 5 5 Connecting 0 20 mA output sensors to the Analog Inputs ...

Страница 23: ...5 6 shows the connection of analog sensors with output from 0 up to 10V DC to the Analog Inputs 12V Fuse 1 5A VCC GND Vo Sensor1 VCC GND Vo Sensor2 AGND VCC VCC Figure 5 6 Connecting analog sensors with output from 0 up to 10V DC to the Analog Inputs ...

Страница 24: ...r Manual 09 Mar 2018 24 NTC thermistors type B57500M can be connected to the Temperature Inputs Fig 5 7 12V Fuse 1 5A Rt 1 Rt 2 Rt 4 Rt 1 Rt 4 B57500M Figure 5 7 Connecting NTC sensors type B57500M to the Temperature Inputs ...

Страница 25: ... smartDEN IP Maxi User Manual 09 Mar 2018 25 Below is shown example connection how to control load with relays lamp Figure 5 8 Connecting lamp to relay ...

Страница 26: ...ll Please note that a separate dimmer could be necessary Figure 5 9 Controlling led lights with analog outputs 5 4 Network connection smartDEN IP Maxi supports AUTO MDIX so either crossover or straight through network cable can be used Fig 5 8 5 9 Figure 5 10 Direct connection of smartDEN IP Maxi to a computer ...

Страница 27: ...to connect the module directly to the computer Next you have to change your PC s IP address You can google how to change you computer IP settings or just visit this web page http www howtochangeipaddress com changeip php For Windows 7 OS for example you can do that in the following way Navigate to Control Panel Network and Internet View network and status tasks Change adapter settings Then just se...

Страница 28: ...s Fig 5 12 Figure 5 13 IPv4 properties section Set the IP address of your PC to be in the same network as smartDEN IP Maxi Fig 5 13 Figure 5 14 Set the IP address Finally in the address bar of your Web browser enter the IP address of the smartDEN IP Maxi and press Enter or select Go Fig 5 14 ...

Страница 29: ...device in a browser If the network settings are O K the login page should appear Fig 5 15 Figure 5 16 Login page smartDEN IP Maxi modules connected locally can be easily scanned and found via the Denkovi Finder tool as well Fig 5 16 Figure 5 17 Denkovi Finder utility ...

Страница 30: ...er sec 0 Relays Filter ms 0 Save Outputs Disabled Monitoring Timeout sec 3 Max Monitoring Errors 5 Network Settings DHCP Disabled IP Address 192 168 1 100 Gateway 192 168 1 1 Subnet Mask 255 255 255 0 Primary DNS 192 168 1 1 Secondary DNS 0 0 0 0 Date Time Settings Date dd mm yyyy Current Day of Week Current Time hh mm Current Time Zone GMT Auto Synchronization Enabled Time Server pool ntp org Ser...

Страница 31: ...gital Inputs Description DIN n where n 1 8 Counter 0 Filter ms 0 SNMP Trap Disabled SNMP Trap Value 0 Off Analog Inputs Description In1 to In4 AIN n where n 1 4 Description In5 to In8 TIN n where n 1 4 Min In1 to In4 0 0 Max In1 to In4 10 0 Min In5 to In8 55 Max In5 to In8 155 Label In1 to In4 Volt Label In5 to In8 degC Trap Low Threshold 0 Trap High Threshold 0 SNMP Trap Disabled Relays Descripti...

Страница 32: ... to those pointed out in 6 1 of the current document To return the settings to their factory default values next steps take place 1 Turn Off the power supply of the device 2 Press and hold the DEFAULT button Fig 6 1 3 Turn On the power supply of the device 4 Wait until STATUS LED indicator become On approximately after 10 sec 5 Release the DEFAULT button 6 The device is restarted and configured wi...

Страница 33: ...ilar and enter the smartDEN IP Maxi IP address for example http 192 168 1 100 Figure 7 2 Open the device in a browser Note You will need to have JavaScript enabled in your browser 7 1 Login Figure 7 3 Login page Enter the password and click Login button or press Enter Fig 7 3 This will bring you to the smartDEN IP Maxi main configuration page which contains details of the ...

Страница 34: ...n the password is entered it is transmitted across the network in encrypted form so eavesdropping on the data transmission will not reveal the password Note In order to prevent setup control conflicts at any given moment only one user can be logged in Figure 7 4 Version Build Date info 7 2 Menu The main menu Fig 7 5 consists of the following items located in the left window frame Figure 7 5 Naviga...

Страница 35: ...uts Filter sec analog inputs filter constant The range is from 0 up to 30 sec The filter is disabled when its value is set to 0 This parameter sets a low pass software filter that removes the short term fluctuations from the input signal and reduces the effect of occasional spikes Note that the higher filter constants give a slower response to changes Relays Filter ms relays filter constant The ra...

Страница 36: ...twork settings of smartDEN IP Maxi module Figure 7 7 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 must be rebooted before obtaining an IP address IP address this is the IP address of the smartDEN IP Maxi It has to be manually assigned only if DHCP is disabled With DHCP enabled this field...

Страница 37: ...lect the time zone for your geographic location Auto Synchronization this option enables or disables automatic synchronization with the SNTP server with period specified by Synchronization Period Time Sever the SNTP server used for synchronizing the time automatically Server Port the SNTP server port Synchronization Period min the period in which automatic synchronization will take place if enable...

Страница 38: ...dress of the HTTP client Session Timeout min specifies the timeout period for the HTTP XML JSON sessions in minutes Enable Access this option enables or disables the XML JSON access Encrypt Password when the XML JSON access is enabled this option adds additional security level by encrypting the login password Multiple Access this option enables simultaneous XML JSON access from several HTTP client...

Страница 39: ...et the MAC Address to 00 00 00 00 00 00 Setting the Access Mask to 255 255 255 255 allows the HTTP XML JSON access only from the exactly specified Access IP Address You can allow the HTTP XML JSON access to a range of IP addresses by setting an appropriate value for Access Mask For example setting the Access IP Address to 192 168 1 0 and Access Mask to 255 255 255 0 allows the access from IP addre...

Страница 40: ...dress the IP address of the trap server Trap Receiver Port determines the UDP port the trap message will be sent to Trap Community the trap community string Trap Sending determines if the traps will be sent by level or by edge conditions With the Level Triggered option the trap message will be sent every 5 seconds when the trap condition is met This mode is preferred in cases where the UDP trap me...

Страница 41: ... 4294967295 Filter ms the input may be adjusted to work with a digital filter It is valid for counting SNMP trap notifications as well as input visualization The range for this parameter is from 0 up to 200 milliseconds The filter is disabled when its value is set to 0 SNMP Trap determines if the Digital Input will send trap notifications or not SNMP Trap Value this parameter determines the condit...

Страница 42: ...o 1 On the Counter is incremented on the rising edge 0 1 With SNMP Trap enabled and Trap Sending Edge Triggered the rising edge triggers a trap message Fig 7 15 With SNMP Trap enabled and Trap Sending Level Triggered the trap message is sent while the Digital Input is high 1 in intervals of 5 seconds Fig 7 16 Figure 7 15 SNMP Trap Value 1 On Trap Sending Edge Triggered ...

Страница 43: ...and Trap Sending Edge Triggered both edges trigger a trap message Fig 7 17 With SNMP Trap enabled and Trap Sending Level Triggered the trap message is sent in intervals of 5 seconds regardless of the Digital Input state Fig 7 18 Figure 7 17 SNMP Trap Value 2 Both Trap Sending Edge Triggered Figure 7 18 SNMP Trap Value 2 Both Trap Sending Level Triggered Save button once you have changed the settin...

Страница 44: ...he actual frequency depends also on the filter constant At the moment the module is saving the configuration in the EEPROM some count pulses may be missed due to the blocking time which may be several seconds Inputs Counters 4 5 6 and 7 When the Filter is disabled set to 0 it is possible to count pulses with frequency up to 50 Hz Note that it is not appropriate at high frequencies to configure the...

Страница 45: ...range is from 9999 9 to 9999 9 o For Input 5 to Input 8 range is from 70 0 to 300 0 degF or 55 0 to 150 0 degC Max the measured value used for scaling corresponding to Analog Input value 1023 o For Input 1 to Input 4 range is from 9999 9 to 9999 9 o For Input 5 to Input 8 range is from 70 0 to 300 0 degF or 55 0 to 150 0 degC Label the label for the measured value for example mA Kg Volt max 4 char...

Страница 46: ...ng Level Triggered o If Traps Sending parameter from web page SNMP Traps Settings is set to Edge Triggered a single trap is sent when measured value crosses over the High Threshold or below the Low Threshold values Fig 7 21 Figure 7 21 Sending traps with Traps Sending Edge Triggered In addition Analog Input trap notifications will be sent in the following cases o When the parameter Low Threshold i...

Страница 47: ...N protocol o Multiple in this mode the Relay can be controlled by Analog Inputs Digital Inputs Week Schedule or manually via Web browser SNMP HTTP XML JSON This mode is designed for cases where the input event does not depend on the output reaction for example controlling lamp depending on the sunlight DI No if set to non zero 1 to 8 this is the number of the Digital Input which is attached to the...

Страница 48: ...nput AI No if set to non zero 1 to 8 this is the lead of the differential input If AI No is non zero and AI No is zero the Relay is controlled by the AI No measured value If both AI No and AI No are non zero the Relay is controlled by the difference of AI No and AI No measured values If AI No is zero the Relay is not controlled by the Analog Input in this case the AI No is not relevant AI Threshol...

Страница 49: ...TTP XML JSON command Week Schedule and manually from Web Monitoring Control page At any time the pulse is active the Relay can be switched back Off by attached Digital or Analog Input SNMP or HTTP XML JSON command Week Schedule and manually from Web Monitoring Control page Disable Week Schedule enables disables globally the week schedule control for this Relay This means the Relay may be in the sc...

Страница 50: ...ts Fig 7 26 A relay can be switched On Off from the Monitoring Control page only if it s Working Mode Multiple Figure 7 26 Monitoring Control page 7 14 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 defi...

Страница 51: ...w item click Add This item will be added as a new row in a Week Schedule table This feature allows you to turn specific Relays On Off upon certain date and time or weekday without the need of LAN connection between the computer and the module A Relay can be included in Week Schedule only if it s Working Mode Multiple To delete an item select it in Existing Items table and click the Delete Selected...

Страница 52: ... smartDEN IP Maxi User Manual 09 Mar 2018 52 Figure 7 28 Log off 7 16 Reboot Figure 7 21 Reboot ...

Страница 53: ...2 168 1 100 current_state json In order to use this mode XML JSON access should be enabled see 7 6 The XML JSON login process differs depending on the selected Encrypt Password option 8 1 XML access 8 1 1 XML login encrypted password This mode can be used to prevent unauthorized access to smartDEN IP Maxi When selected a two step login sequence is performed as a protection against unauthorized acc...

Страница 54: ... the password is passed as non encrypted parameter with the request http 192 168 1 100 current_state xml pw admin Getting the LoginKey in the answer in this mode means that the provided password is wrong or the login session has been expired If there is no data traffic between the custom application and the smartDEN IP Maxi for time specified by Session Timeout parameter the session times out and ...

Страница 55: ...smartDEN IP Maxi User Manual 09 Mar 2018 55 Figure 8 2 XML file with current values 8 2 JSON access 8 2 1 JSON login encrypted password The encrypted login sequence is similar to those for the XML access ...

Страница 56: ...SON login non encrypted password The password should be passed as non encrypted parameter with the request http 192 168 1 100 current_state json pw admin Getting the LoginKey in the answer means only that the provided password is wrong or the login session has been expired If there is no data traffic between the custom application and the smartDEN IP Maxi for time specified by Session Timeout para...

Страница 57: ... User Manual 09 Mar 2018 57 Figure 8 3 JSON file with current values 8 3 Multiple XML JSON access With Multiple Access option selected see 7 6 the password should be passed as a non encrypted parameter with each request ...

Страница 58: ...ame Value Description Relayi i 1 8 0 Switch the Relay Off 1 Switch the Relay On 2 Toggle the Relay state SetAll 0 65535 Switch Relays On Off Counti i 1 8 0 4294967295 Set Counter value Pulsei i 1 8 0 65535 Generate pulse AnalogOutputi i 1 2 0 1023 Set Analog Output units pw password Required at login Multiple name value pairs separated by the ampersand can be passed with a single request for examp...

Страница 59: ...1 1 3 0 x 8 2 1 1 3 7 Digital Input Counter R W Counter32 0 4294967295 x 8 2 1 1 4 0 x 8 2 1 1 4 7 Digital Input Filter ms R W Integer 0 200 x 8 2 1 1 5 0 x 8 2 1 1 5 7 Digital Input Trap Enable Flag R W Integer No 0 Yes 1 x 8 2 1 1 6 0 x 8 2 1 1 6 7 Digital Input Trap Value R W Integer Off 0 On 1 Both 2 x 8 2 1 1 7 0 x 8 2 1 1 7 7 Digital Input State R Integer Off 0 On 1 Table 9 3 Analog Inputs S...

Страница 60: ... 3 1 15 7 Relay Filter ms R W Integer 0 9999 Table 9 5 Analog Outputs Start OID End OID Description Access Syntax x 8 2 4 1 2 0 x 8 2 4 1 2 1 Analog Output Description R W DisplayString SIZE 0 7 x 8 2 4 1 3 0 x 8 2 4 1 3 1 Analog Output Units R W Integer 0 1023 9 1 3 Control Table 9 6 Control OID Description Access Syntax x 8 3 1 0 TemperatureScale R W Integer Celsius 0 Fahrenheit 1 x 8 3 2 0 Anal...

Страница 61: ...29 Relays State R W Integer Off 0 On 1 x 8 5 2 1 5 0 x 8 5 2 1 5 29 Hour hh mm R W DisplayString x 8 5 2 1 6 0 x 8 5 2 1 6 29 Week Days Code R W Integer 0 127 9 2 SNMP Traps Each of the inputs can be individually configured to send trap notifications when an event is triggered With Level Triggered option selected the trap message will be sent every 5 seconds when the trap condition is met With Edg...

Страница 62: ...vesdropping on the data transmission will not reveal the password Subsequent transmissions of the password to login onto the device are encrypted and safe The only case when the password is transmitted across the network in the open is when it is being changed and submitted in General Setting form Therefore you must set passwords in a secure environment where you can make sure that no one is eaves...

Страница 63: ... smartDEN IP Maxi User Manual 09 Mar 2018 63 11 Mechanical drawing Figure 11 1 Device dimensions ...

Результаты поиска

Содержание smartDEN IP-Maxi

Отзывы:

Похожие инструкции для smartDEN IP-Maxi

Бренды по названию

Популярные бренды

Denkovi smartDEN IP-Maxi, Руководство пользователя

Результаты поиска

Содержание smartDEN IP-Maxi

Отзывы:

Похожие инструкции для smartDEN IP-Maxi

Бренды по названию

Популярные бренды