inveo DS18B20 Nano Temperature Sensor POE User Manual
- June 6, 2024
- inveo
Table of Contents
- Preliminary information
- Application of the device
- Warranty and liability of the manufacturer
- Safety guidelines
- Construction of the device
- Configuration of the device
- The device functions
- Communication with the module from the external network
- Checking the IP address
- DHCP
- Restoring factory defaults
- Firmware update
- Documents / Resources
User manual
Nano Temperature Sensor POE
Nano Temp Sensor
Soft >= 1.21
INVEO s.c.
ul. Rzemieślnicza 21
43-340 Kozy
tel: +48 33 444 65 87
www.inveo.com.pl
info@inveo.com.pl
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 differs from its intended purpose, improper handling, as well as
a fault of the driver resulting from improper use.
Preliminary information
Before starting work with the device, read The User manual and follow the
instructions contained therein!
Description of visual symbols used in this user manual:
This symbol is responsible for reviewing the appropriate place in the user
instructions, warnings, and important information. Failure to follow warnings
could cause injury or damage to the device
Important information and guidelines
Following this guideline makes the use of the device easier
Attention: The screenshots in this manual can be dissimilar from actual
images at the time of the device purchase. Due to the continuous development
of the device’s software,
some of the functions may differ from those in the manual. The manufacturer
claims no responsibility for any undesirable effects (misunderstanding) caused
by changes in the software.
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.
Warranty and liability of the manufacturer
The manufacturer provides a 2-year warranty on the device. The manufacturer also provides post-warranty service for 10 years from the date of the introduction of the device on the market. The warranty covers all defects in material and workmanship. The manufacturer undertakes to comply with the contract of guarantee if the following conditions are met:
- 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.
The manufacturer assumes no responsibility for consequences resulting from
improper installation, improper use of the device, not following this manual,
and the repairs of the
the device by individuals without permission.
This device doesn’t contain serviceable parts.
Safety guidelines
The device has been designed and built using modern electronic components,
according to the latest trends in global electronics. In particular, much
emphasis was placed on
ensuring optimum safety and reliability of control. The device has a housing
with high-quality plastic.
4.1 Storage, work, and transport conditions
The device has to be stored in enclosed rooms that are free of caustic vapors
and substances and also meet the requirements:
- surrounding temperature from -30°C to +60°C,
- humidity from 25 to 90%,
- atmospheric pressure from 700 to 1060hPa.
The device working conditions:
- surrounding temperature from -10°C to +55°C,
- relative humidity from 30% to 75%,
- atmospheric pressure from 700 to 1060hPa.
Recommended transport conditions:
- surrounding temperature from -40°C to +85°C,
- relative humidity from 5% to 95%,
- atmospheric pressure from 700 to 1060hPa.
4.2 Installation and use of the device
The device should be used following the guidelines shown in the next part
of the user manual.
4.3 Decommissioning of the device
When it becomes necessary to recycle the device (for instance, to decommission
the device from service), please contact the manufacturer or its
representative, who are obliged to respond, appropriately, i.e. collecting the
device from the user. You can also ask the companies involved in recycling of
electrical or computer equipment. Under no circumstances should you place the
device along with other waste material.
Construction of the device
5.1 Nano Temperature Sensor PoE
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:
General features:
The device has a 7-segment display.
There are several ways to communicate with the module:
- using built-in WWW server via any web browser,
- Windows / Linux command line programs,
- MODBUS TCP protocol,
- SNMP protocol,
- MQTT Inveo protocol,
- User application – TCP protocol available for user.
Description of the module connectors:
-
LAN – LAN connection and PoE IEEE 802.3af power supply,
-
RESET – switch used to enable DHCP service, checking the current IP address and restoring the module to the factory settings.
-
1-WIRE – screw connection for connection of the temperature sensor,
-
POWER – power connector. An additional power connector is used in the event of a PoE power failure. Supply voltage 10-24VDC.
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:
General features:
The device has two LEDs. LEDs indicate power supply and temperature reading.
There are several ways to communicate with the module:
- using built-in WWW server via any web browser,
- Windows / Linux command line programs,
- MODBUS TCP protocol,
- SNMP protocol,
- MQTT Inveo protocol,
- User application – TCP protocol available for user.
Description of the module connectors:
- LAN – LAN network and Passive PoE power supply,
- RESET – switch used to enable DHCP service and restore the module to the factory settings.
- 1-WIRE – screw connection for connection of the temperature sensor.
Configuration of the device
The device when used for the 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:
6.1 Changing the device’s IP address by Discoverer applicatio n
When the “Discoverer” is opened and the relevant device is found, choose the
Interface list box and click on Change IP button.
In a new opened dialog box, settings such as IP address, MASK, GATEWAY,
DNS1/DNS2, and the Hostname can be changed.
Please save correct settings by choosing Change button.
If Remote Config is disabled (enabled by default), it is necessary to
configure the device by changing the computer’s subnet (chapter 6.2).
To enable the remote configuration it is necessary to enter the
Administration tab and mark Enable Remote Network Config.
Save the setup by selecting Save Config button.
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 that 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 the 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
In the Network tab, it is possible to change LAN parameters.
To change the network settings, use the following fields:
- Host Name – NETBIOS name,
- DHCP – checking this box forces use of the address assigned by the DHCP server,
- IP Address – the IP address of the reader,
- Gateway – network gateway,
- Subnet Mask – IP subnet mask,
- Gateway – network gateway,
- DNS1, DNS2 – DNS servers addresses.
- Destination IP – the IP address of the device in the M2M connection (chapter 7.3),
- Destination Port – the listening port of the external device in the M2M connection. After all changes, select Save Config.
6.3 Security settings and administration
The Administration settings allow for changing access passwords and to
enable/disable particular services in the device.
Password change
To change the password, in the Current Password field write a current
password. Next, in the New Password field write your new password and
confirm it at the Re-type Password field.
Service settings
The device allows choosing which services are to be available. Selecting
the check box next to the service name activates the selected service.
Enable Program Access – a service of access by a computer program
(Windows, Linux) and TCP / IP protocol operating on port 9761,
Enable MODBUS TCP Protocol – enables Modbus TCP server,
Enable SNMP – enables SNMP protocol supporting,
Enable Destination Client – connecting to a remote host service (chapter
7.3), Enable MQTT Inveo – a service that sends data to the INVEO MQTT
cloud, Enable Remote Network Config – remote configuration (via the
Discoverer application),
Enable TFTP Bootloader – enables a bootloader.
Attention:
TFTP Bootloader and Remote Network Config ought to be disabled
during normal work operations. It should be enabled for a firmware update
only.
The device functions
7.1 Preview of the measured temperature
In the Home tab, the current temperature read from the sensor connected to
the bus is displayed and the over-temperature condition is signaled.
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.
All changes must be confirmed with the Save button.
The occurrence of an alarm condition is signaled on the homepage of
the module, and the display or LED is flashing.
If the alarm is active, the virtual output No. 1 is enabled **(
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.
7.3 Destination Client
Inveo devices such 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
an alarm occurs (Nano Sensors). The message is sent each time state is changed
and additionally every 5 seconds.
Configuration of devices receiving messages (external devices)
To enable the service, enter the Administration tab and select Enable
Program Access and confirm with the Save Config button.
Configuration of devices sending alarm status messages
To enable the service, enter the Administration tab and select Enable
Destination Client and confirm with the Save Config button.
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).
Then, in the Channel tab select the appropriate output which will be enabled in the external device or – select type of the message.
The user can choose the following fields:
- TCP Ch:x – the function uses the connection protocol e. the TCP protocol. Number Ch:x is the selected output channel in an external device, e.g. LanTick, which will be enabled when the channel state of the local device changes. The TCP frame sends in the format #1,
- UDP Ch:x – the function uses the connectionless protocol e. the UDP protocol. Number Ch:x is the selected output channel in an external device, e.g. LanTick, which will be enabled when the channel state of the local device changes. The UDP frame sends in the format #1,
- Status – sends the device channel status, TCP frame sent in the format #2,
- MAC+Status – sends the MAC address of the device and current channel status, TCP frame sent in the format #3,
- HTTP GET – sends the MAC address of the device’s current alarm status and temperature value, a frame sent in format #4.
TCP frames formats
Format #1
The frame in 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 LSB | RAW MSB | CRC |
---|---|---|---|---|---|---|---|---|---|---|
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 LSB | RAW MSB | CRC |
---|---|---|---|---|---|---|---|---|---|---|
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
Value TEMP it’s the temperature without the decimal part.
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 – value 1 means an alarm is active, 0 means an alarm is inactive
- TEMPERATURE – read temperature
Value in HEX | STRING |
---|---|
30 | 20 |
Format #3
Frame #3 is sent as a string (STRING).
- MAC – network address of the module,
- ALARM – value 1 means an alarm is active, 0 means an alarm is inactive,
- TEMPERATURA – read the temperature.
Value in HEX | STRING |
---|---|
35 | 34 |
5410EC655021 0 46.9
Format #4
Setting Client Mode to HTTP GET causes the device to send data to the
server in the form: of nano. PHP?mac=
- MAC – MAC address,
- Alarm – value 1 means active alarm, 0 means inactive alarm,
- Temperature – counter temperature value.
An example of a frame received by the server:
GET /nano.php?mac=123456789012&io=0&value=7
MAC address = 123456789012,
io=0, the input is inactive
value=7, the current temperature value 7
The TCP frame can be handled with your own software.
An example of using the Netcat command for Linux: Format #1
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 SNMP protocol allows to read the current value.
The MIB file describing the structure can be downloaded the SNMP tab.
The basic parameters that can be read from the Nano Temperature Sensor module can be found in the table:
Name | Format | OID |
---|---|---|
CH1_TEMP | STRING | .1.3.6.1.4.1.42814.14.3.5.1.0 |
CH1_TEMPINT (integer) | INTEGER | .1.3.6.1.4.1.42814.14.3.5.2.0 |
CH1_TEMPINT10 (temperature *10) | INTEGER | .1.3.6.1.4.1.42814.14.3.5.3.0 |
CH1_ON (Alarm active) | INTEGER | .1.3.6.1.4.1.42814.14.3.1.1.0 |
Module can send TRAP messages after alarm activation. Destination address
should be entered in Trap IP Address 1 and Trap IP Address 2
fields.
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 -readtem p
7.6 Linux control program
To use the linux command line software, it is necessary to enable the Access
program setting in the Administration tab.
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
7.7 Modbus TCP
The device supports Modbus TCP protocol.
The Modbus TCP server is available over LAN and listens on port 502.
Supported Modbus functions
The device supports the following MODBUS functions:
- 0x01 Read Coils,
- 0x03 Read Holding Register,
- 0x06 Write Single Register,
- 0x0F Write Multiple Coils,
- 0x10 Write Multiple Registers.
Modbus TCP – Coils
Address | Name | R/W | Description |
---|---|---|---|
1000 | On1 | R | Alarm state |
1002 | SensError | R | Sensor error (0-ok, 1-error) |
Modbus TCP – Holding Registers
Address | Name | R/W | Opis |
---|---|---|---|
4000 | ThermostatL | R/W | Lower alarm threshold |
4001 | ThermostatH | R/W | Upper alarm threshold |
4002 | Alarm mode | R/W | 1 – OFF (disabled) 2 – Lower |
3 – Higher
4 – Lower or Higher
4004| Temperature x10| R| Temperature x 10 (np. 10,5 st.C to 105)
4005| Temperature Int| R| Integral part of temperature
4006| Temperature Frac| R| Decimal part of temperature
4007| MAC 0| R| MAC address
4008| MAC 1| R| MAC address
4009| MAC 2| R| MAC address
4010| MAC 3| R| MAC address
4011| MAC 4| R| MAC address
4012| MAC 5| R| MAC address
4013| StoreConfig| W| Entering 144 will save to configuration to EEPROM
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.
Application configuration – MQTT Client:
Address: mqtt.inveo.com.pl
Port: 1883
User name: nanouser
User password: nanouser
Topic: /nanoT/
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.
7.9 Communication with module using HTTP
Modules can be controlled using HTTP GET.
To read current state of the module refer to a resource such as
http://192.168.111.15/status.xml
Section | Description |
---|---|
Type of the module | |
The firmware version | |
MAC address | |
Output state (enabled/disabled), N/A in Nano Temperature |
Sensor
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
19.4
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.
7.10 Description of the communication protocol
Nano Temperature Sensor communication data frame.
Command| Byte number| 1| 2| 3| 4| 5| 6| 7| 8| 9| 10| 11|
---|---|---|---|---|---|---|---|---|---|---|---|---|---
Byte name| SOF| CMD| Channel| Data1| Data2| Data3| Data4| Data5| Data6| Data7|
CRC| Returns
Temperature reading
| dec| 15| 12| 0| X| X| X| X| X| X| X| CRC| 2 bytes
+ CRC
hex| 0x0F| 0x0C| 0x00| X| X| X| X| X| X| X| CRC| 2 bytes
+ CRC
As default modules are listening on TCP port 9761.
Reading the current value from the temperature sensor.
SOF | CMD | CH | D1 | D2 | D3 | D4 | D5 | D6 | D7 | CRC |
---|---|---|---|---|---|---|---|---|---|---|
0x0F | 0x0C | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x1B |
CRC = (BYTE) SUM (SOF+CMD+CH+D1..D7)
The device returns 2 bytes (current temperature) + CRC (sum of 2 bytes)
Examples:
**** Temperature value| The value returned by the module to port
9761| **** Convert to dec format| **** Converted temperature value
(dec/16)
---|---|---|---
dec| 2 bytes| CRC| hex| dec| dec
-18,0| E0 FE| DE| FFFF-FEE0| 287| -17,9375
-5,1| AE FF| AD| FFFF-FFAE| 81| -5,0625
26,5| A8 01| A9| 1A8| 424| 26,5
33,8| 1E 02| 20| 21E| 542| 33,875
The converted decimal value have to be divided by 16.
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:
Support via website and HTTP protocol:
- port TCP 80
Service by a computer program or by your own application:
- port TCP 9761
Support via MODBUS TCP:
- port TCP 502
Support via SNMP protocol:
- port UDP 161
Checking the IP address
Concerns only Nano Temperature Sensor PoE.
To check the current IP address of the device:
- Press and hold the reset button until the display shows the four parts of the IP number, e.g. 192 168 111 15.
- Release the reset button.
DHCP
To enable/disable DHCP service:
- Press and hold the RESET button 5 to 10 second.
- Green LED will start flashing 2 times a second (Nano Temperature Sensor), the display will show dhcP (Nano Temperature Sensor PoE).
- Release the reset button.
It is also possible to enable DHCP in the network configuration in the Network tab or through the Discoverer application.
Restoring factory defaults
To reset the device to factory settings:
- Press and hold RESET button for 10 to 15 seconds
- Green LED will start flashing 2 times a second (Nano Temperature Sensor), the display will show: rSt (Nano Temperature Sensor PoE).
- Release the reset button.
With factory defaults restored the module settings are as follows:
- DHCP: enabled
- IP address: 192.168.111.15
- IP mask: 255.255.255.0
- User name: admin
- Password: admin00
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.
To update the software:
- check the Enable TFTP Bootloader option, which is located in the Administration tab,
- run the Windows command line (Start-> Run enter ‘cmd’ and confirm with the Enter key),
- go to the directory where the .bin file is located
- enter the command:
tftp -i
where:
Programming takes 1-2 minutes. End of programming confirms the message ‘File
Transferred’.
For the correct functioning of the reader, after the update operation, the
„Enable TFTP Bootloader” option has to be switched off.
Step-by-step instruction for firmware updates is available at
https://inveo.com.pl.
The latest instructions and software are available on the
sitehttps://inveo.com.pl.
User manual Nano Temperature Sensor PoE / Nano Temp Sensor
[B03a]
Documents / Resources
|
inveo DS18B20 Nano Temperature Sensor
POE
[pdf] User Manual
DS18B20 Nano Temperature Sensor POE, DS18B20, Nano Temperature Sensor POE
---|---
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>