Nano User - Manual - en
Nano User - Manual - en
INVEO s.c.
ul. Rzemieślnicza 21
43-340 Kozy
tel: +48 33 444 65 87
www.inveo.com.pl
[email protected]
Dear Customer!
Thank you very much for choosing our product. Before its use, please read these
instructions carefully. Here you find the most appropriate ways of dealing with this
device, the basic principles of safety and maintenance. Please, also keep the user manual
so that you can read it during later use.
Attention!
The manufacturer is not liable for any damage caused by improper use of
the device which differ from its intended purpose, or improper handling, as well
as a fault of driver resulting from improper use.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 2 of 29
[B03a]
Contents:
1 PRELIMINARY INFORMATION...................................................................................................................4
4 SAFETY GUIDELINES.....................................................................................................................................6
4.1 STORAGE, WORK AND TRANSPORT CONDITIONS.........................................................................................................6
4.2 INSTALLATION AND USE OF THE DEVICE..................................................................................................................6
4.3 DECOMMISSIONING OF THE DEVICE.........................................................................................................................6
5 CONSTRUCTION OF THE DEVICE..............................................................................................................7
5.1 NANO TEMPERATURE SENSOR POE.......................................................................................................................7
5.2 NANO TEMP......................................................................................................................................................9
6 CONFIGURATION OF THE DEVICE.........................................................................................................11
6.1 CHANGING THE DEVICE'S IP ADDRESS BY DISCOVERER APPLICATION.........................................................................11
6.2 CHANGING THE PC'S SUBNET ADDRESS, FOR THE DEVICE CONFIGURATION..................................................................12
6.3 SECURITY SETTINGS AND ADMINISTRATION............................................................................................................14
7 THE DEVICE FUNCTIONS...........................................................................................................................15
7.1 PREVIEW OF THE MEASURED TEMPERATURE...........................................................................................................15
7.2 ALARMS..........................................................................................................................................................15
7.3 DESTINATION CLIENT........................................................................................................................................17
7.4 SNMP CONFIGURATION....................................................................................................................................21
7.5 WINDOWS COMMAND LINE SOFTWARE..................................................................................................................22
7.6 LINUX CONTROL PROGRAM.................................................................................................................................22
7.7 MODBUS TCP.................................................................................................................................................23
7.8 MQTT INVEO.................................................................................................................................................24
7.9 COMMUNICATION WITH MODULE USING HTTP......................................................................................................25
7.10 DESCRIPTION OF THE COMMUNICATION PROTOCOL................................................................................................27
8 COMMUNICATION WITH THE MODULE FROM THE EXTERNAL NETWORK...........................28
10 DHCP................................................................................................................................................................28
12 FIRMWARE UPDATE..................................................................................................................................29
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 3 of 29
[B03a]
1 Preliminary information
Before starting work with the device, read The User manual and follow the
instructions contained therein!
Attention: The screenshots in this manual can be dissimilar from actual images at
the time of the device purchase. Due to continuous development of the devices software,
some of the functions may differ from these in the manual. The manufacturer claims no
responsibility for any undesirable effects (misunderstanding) caused by changes of
the software.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 4 of 29
[B03a]
2 Application of the device
NANO Temperature Sensor module is used to read temperature over different LAN
protocols. The temperature readout is possible using built in www website, HTTP GET,
Modbus TCP, SNMP and MQTT protocols. This module can communicate with other Inveo
modules and e.g. trigger relay actions.
all repairs, alterations, extensions and device calibrations are performed by the
manufacturer or authorized service,
supply network installation meets applicable standards in this regard,
the device is operated in accordance with the recommendations outlined in this
manual,
the device is used as intended.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 5 of 29
[B03a]
4 Safety guidelines
The device has been designed and built using modern electronic components, according
to the latest trends in the global electronics. In particular, much emphasis was placed on
ensuring optimum safety and reliability of control. The device has a housing with a high-
quality plastic.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 6 of 29
[B03a]
5 Construction of the device
Technical data:
Power supply::
PoE: 33-57V POE IEEE 802.3af
DC: 10-24VDC (screw terminals 3,5mm)
Power consumption: max 1,5W
Inputs:
1 input: input type: 1-wire bus
type of sensor: DS18B20
temperature measured: -55°C do +125°C
screw connection
Communication:
1 port Ethernet: 10Mbps
PoE IEEE 802.3af
Housing:
IP Code: 30
Dimensions:
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 7 of 29
[B03a]
General features:
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 8 of 29
[B03a]
5.2 Nano Temp
Technical data:
Power supply:
The module is adapted to 12-24VDC power supply.
Power is supplied through the passive PoE adapter.
Inputs:
1 input: input type: 1-wire bus
type of sensor: DS18B20
temperature measured: -55°C do +125°C
screw connection
Communication:
1 port Ethernet: 10Mbps
passive PoE 12-24VDC power supply
Housing:
IP Code: 30
Dimensions:
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 9 of 29
[B03a]
General features:
The device has two LEDs. LEDs indicate power supply and temperature reading.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 10 of 29
[B03a]
6 Configuration of the device
The device when used for first time needs to be configured.
There are two methods to do so. The network configuration can be easily changed by
Inveo “Discoverer” (https://inveo.com.pl/software/) software:
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 11 of 29
[B03a]
6.2 Changing the PC's subnet address, for the device configuration
After the device is connected to a network, a subnet address of a PC which is connected
to the same network has to be changed.
To do so, go to the PC's MS Windows network configuration: Start->Control panel
->Network and Sharing Center->Network and Internet->Network Connections, choose
the related controller and right click on „Properties”.
After selecting this option configuration window will show up:
Next choose "Internet Protocol (TCP/IP)", double click on it and enter following settings:
After saving changes by clicking OK, open an Internet browser and enter in the browser's
address line: 192.168.111.15.
Default user name/password: admin/admin00
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 12 of 29
[B03a]
In the Network tab it is possible to change LAN parameters.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 13 of 29
[B03a]
6.3 Security settings and administration
The Administration settings allow for changing access password and to enable/disable
particular services in the device.
Password change
To change password, in the Current Password field write a current password. Next,
in the New Password field write your new password and confirm it at Re-type
Password field.
Service settings
The device allows to choose which services are to be available. Selecting the check box
next to the service name activates the selected service.
Attention:
TFTP Bootloader and Remote Network Config ought to be disabled during normal
work operation. It should be enabled for a firmware update only.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 14 of 29
[B03a]
7 The device functions
7.2 Alarms
In the Channel tab, it is possible to set alarm thresholds. If the temperature is out of
range, the alarm will be active.
Alarm Mode
• Off – alarm disabled,
• Lower – if the temperature is lower than value set in the Alarm Low field,
the alarm will be active.
• Higher – if the temperature is higher than value set in the Alarm High field,
the alarm will be active.
• Lower or Higher – if the temperature is lower than value set in the Alarm Low
field or if the temperature is higher than value set in the Alarm High field,
the alarm will be active.
Sensor Offset – the value that will be added to the measured value.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 15 of 29
[B03a]
The occurrence of an alarm condition is signaled on the homepage of the module, and
the display or LED is flashes.
http://192.168.111.15/status.xml
<response>
<prod_name>Nano-DS</prod_name>
<sv>1.17</sv>
<mac>54:10:EC:BB:61:17</mac>
<out>00000000</out>
<on>00000001</on>
<in>00000000</in>
<counter1>0</counter1>
<temp1>18.8</temp1>
</response>
Attention!
If an alarm has occurred, return to normal device operation (without alarm signaling) will
take place only after crossing the hysteresis zone equal to 1 degree Celsius.
For example, if the Alarm Low is set to 20 degrees Celsius, the alarm will be activated
when the temperature reaches 20 degrees and turns off when the temperature reaches
21 degrees Celsius.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 16 of 29
[B03a]
7.3 Destination Client
Inveo devices as LanTick, Nano Temperature Sensor, Nano Digital Input, Nano Relay
Output or others are able to send information data to the server or to another
module with outputs using the TCP or UDP protocol. It means that this another module
can react to activation of channel or when alarm occurs (Nano Sensors).
The message is sent each time state is changed and additionally every 5 seconds.
In the Network tab, fill in the Destination IP and Destination Port fields.
The Destination IP field is an IP address of the external device or a server.
The Destination Port field is a port number of the external device (9731 by default).
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 17 of 29
[B03a]
Then, in the Channel tab select the appropriate output which will be enabled in the
external device or – select type of the message.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 18 of 29
[B03a]
TCP frames formats
Format #1
The frame in the format #1 is sent in binary form.
An example TCP frame sent with active alarm and Dest:5 set
SOF CMD CH F_ID ALARM !ALARM TEMP RES RAW RAW CRC
LSB MSB
0x0F 0x01 0x04 0xFF 0x01 0xFE 0x0F 0x00 0x01 0x57 0x7F
An example TCP frame sent with inactive alarm and Dest:5 set
SOF CMD CH F_ID ALARM !ALARM TEMP RES RAW RAW CRC
LSB MSB
0x0F 0x01 0x04 0xFF 0x00 0xFF 0x0F 0x00 0x01 0x57 0x7F
Values RAW_LSB and RAW_MSB is the temperature read directly from the sensor.
The temperature read off should be divided by 16
Calculation of CRC:
CRC = (SOF+CMD+CH+F_ID+ALARM+!ALARM+TEMP+RES+RAW_LSB+RAW_MSB) MOD 256
Format #2
The frame #2 is sent as a string (STRING).
<ALARM>[SPACE]<TEMPERATURE>
• ALARM – value 1 means an alarm is active, 0 means an alarm is inactive
• TEMPERATURE – read temperature
Value in HEX STRING
30 20 33 39 2E 35 0 39.5
Format #3
The frame #3 is sent as a string (STRING).
<MAC>[SPACE]<ALARM>[SPACE]<TEMPERATURE>
• MAC – network address of the module,
• ALARM – value 1 means an alarm is active, 0 means an alarm is inactive,
• TEMPERATURA – read temperature.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 19 of 29
[B03a]
Format #4
Setting Client Mode to HTTP GET causes that the device sends data to the server in the
form:
nano.php?mac=<MAC>&io=<Alarm>&cnt=<Temperature>
• MAC – MAC address,
• Alarm – value 1 means active alarm, 0 means inactive alarm,
• Temperature – counter temperature value.
Format #2
Format #3
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 20 of 29
[B03a]
7.4 SNMP configuration
The module is equipped with an SNMP v2c server.
To enable this feature go to Administration tab and check Enable SNMP option.
The basic parameters that can be read from the Nano Temperature Sensor module can
be found in the table:
Module can send TRAP messages after alarm activation. Destination address should be
entered in Trap IP Address 1 and Trap IP Address 2 fields.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 21 of 29
[B03a]
7.5 Windows command line software
The module can be operated using windows command line software.
To use the command line program, it is necessary to enable the Access program setting
in the Administration tab.
Windows syntax:
TCPRel.exe [Parameters]
Parameter Description
-in=1 The number of the input being read
-host=[HOST] The IP address of the module
-port=[PORT] Module port
-readtemp Reading values from the sensor
Example:
Reading the current value, the module has an address: 192.168.111.15 and listens on
port 9761:
TCPRel -in=1 -host=192.168.111.15 -port=9761 -readtemp
Syntax is as follows:
./TcpRel.exe [Parameters]
Parameter Description
-i 1 The number of the input being read
-h [HOST] The IP address of the module
-p [PORT] Module port
-t Reading values from the sensor
Example:
Read temperature from module at IP address 192.168.111.15 and port 9761:
./tcprel -i 1 -h 192.168.111.15 -p 9761 -t
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 22 of 29
[B03a]
7.7 Modbus TCP
The device supports Modbus TCP protocol.
The Modbus TCP server is available over LAN and listens on port 502.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 23 of 29
[B03a]
7.8 MQTT Inveo
If the MQTT Inveo service has been enabled in the Administration tab, the module
sends to mqtt.inveo.com.pl server the value of measured temperature every 1 minute
and additionally at each change.
After click [Show Info] the settings for the MQTT client will be displayed:
There are many applications on Android, IOS or PC that can display data sent by the
module.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 24 of 29
[B03a]
7.9 Communication with module using HTTP
Modules can be controlled using HTTP GET.
Section Description
<prod_name>PE-DS</prod_name> Type of the module
<sv>1.20</sv> The firmware version
<mac>00:00:00:00:00:00</mac> MAC address
<out>00000000</out> Output state (enabled/disabled),
N/A in Nano Temperature Sensor
<on>00000000</on> Status of virtual outputs:
00000001 means alarm state
<in>00000000</in> Input state (Active/Inactive),
N/A in Nano Temperature Sensor
<counter1>0</counter1> Counter inputs,
N/A in Nano Temperature Sensor
<temp1>21.3</temp1> Temperature sensor reading
Temperature is 21.3 degree
To read measured temperature only, refer to the resource temp1.txt. The temperature
will be displayed in text form.
For example:
http://192.168.111.17/temp1.txt
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 25 of 29
[B03a]
Example of reading the measured value with the CURL command.
Attention!
Access to resource stat.php require authorization.
Access to resources status.xml and temp1.txt do not require authorization.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 26 of 29
[B03a]
7.10 Description of the communication protocol
Nano Temperature Sensor communication data frame.
Byte
1 2 3 4 5 6 7 8 9 10 11
number
Command
Byte
SOF CMD Channel Data1 Data2 Data3 Data4 Data5 Data6 Data7 CRC Returns
name
2 bytes
dec 15 12 0 X X X X X X X CRC
Temperature + CRC
reading 2 bytes
hex 0x0F 0x0C 0x00 X X X X X X X CRC
+ CRC
Examples:
Converted
The value returned by
Temperature value Convert to dec format temperature value
the module to port 9761
(dec/16)
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 27 of 29
[B03a]
8 Communication with the module from the external network
If the module is in a different LAN network than the computer connecting to it, port
forwarding is required.
Depending on the communication method used with the module, it is necessary to
contact the Network Administrator and port forwarding:
10 DHCP
To enable/disable DHCP service:
It is also possible to enable DHCP in the network configuration in the Network tab or
through Discoverer application.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 28 of 29
[B03a]
11 Restoring factory defaults
To reset the device to factory settings:
1. Press and hold RESET button for 10 to 15 seconds
2. Green LED will start flashing 2 times a second (Nano Temperature Sensor), the
display will show: rSt (Nano Temperature Sensor PoE).
3. Release the reset button.
12 Firmware update
The device has the ability to update the firmware. The software update program is
provided as a *.bin file.
Warning! Incorrect use of the update feature may damage the reader. Make sure that
undisturbed power is provided to the device for duration of programming.
Programming takes 1-2 minutes. End of programming confirms the message 'File
Transferred'.
For correct functioning of the reader, after the update operation the „Enable TFTP
Bootloader” option has to be switched off.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor Page 29 of 29
[B03a]