Payload decoding for Ultrasonic level sensor set

There are 3 references for the ultrasonic level sensors:

• Ref : 7052 : #16 (cm)
• Ref : 7360,7369 : #46 (mm)
• New US sensor (2020) : #75 (mm)
• New US sensor (2021) : #99 (mm)

The sensor set of level sensor is : 16

This configuration need to be set into the device through a DOWNLINK MESSAGE 

The uplink structure is on 4 byte in hexadecimal.

To decode it please use this rules :

Example for payload: 10EE001964

	Byte 0	Byte 1	Byte 2	Byte 3	Byte 4
Value	Message Code	lsb** Distance	msb* Distance	Temperature	Battery
Hexa	0x{10}	0x{ee}	0x{00}	0x{19}	0x{64}
Decimal	10	238 decoded using little endian convention		25	100
Unit	-	cm		°C	%

* lsb : less significant byte

** msb most significant byte

The sensor set of level sensor is : 75

This configuration need to be set into the device through a DOWNLINK MESSAGE 

The uplink structure is on 8 byte in hexadecimal.

To decode it please use this rules :

Example for payload: 1020182018201964

	Byte 0	Byte 1	Byte 2	Byte 3	Byte 4	Byte 5	Byte 6	Byte 7
Value	Message Code	lsb** Time MAX	msb* Time MAX	lsb** Time MEDIAN	msb* Time MEDIAN	Mesure reliability (32= 100%)	Temperature	Battery
Hexa	0x{10}	0x{20}	0x{18}	0x{20}	0x{18}	0x{20}	0x{19}	0x{64}
Decimal	10	6176 decoded using little endian convention		6176 decoded using little endian convention		32	25	100
Unit	-	Micro second				-	°C	%

* lsb : less significant byte

** msb most significant byte

The new ultrasonic sensor will send the time measured in micro second. To get a distance is is necessary to convert the time in distance. The most basic calcul consist in divide by 59

--> distance_cm = time_microsecond /  59

The sensor set of level sensor is : 99

This configuration need to be set into the device through a DOWNLINK MESSAGE 

The uplink structure is on 11 byte in hexadecimal.

To decode it please use this rules :

Example for payload: 10 fd 13 f2 13 eb 13 ef 13 18 5c 

	Byte 0	Byte 1	Byte 2	Byte 3	Byte 4	Byte 5	Byte 6	Byte 7	Byte 8	Byte 9	Byte 10
Value	Message Code	lsb** Blind zone 15 cm	msb* Blind zone 15 cm	lsb** Blind zone 25 cm	msb* Blind zone 25 cm	lsb** Blind zone 35 cm	msb* Blind zone 35 cm	lsb** Blind zone 50 cm	msb* Blind zone 50 cm	Temperature	Battery
Hexa	0x{10}	0x{fd}	0x{13}	0x{f2}	0x{13}	0x{eb}	0x{13}	0x{ef}	0x{13}	0x{18}	0x{5c}
Decimal	10	5117 decoded using little endian convention		5106 decoded using little endian convention		5099 decoded using little endian convention		5103 decoded using little endian convention		24	100
Unit	-	Micro second								C°	%

* lsb : less significant byte

** msb most significant byte

In case of communication error between the sensor and the Device, the device may report an error code that needs to be filtered.

This new sensor set send back the measure @ different blind zone from 15 cm to 50 cm to improve accurary.

Sensor	Error Code (decimal)
Ultrasonic sensor	9998 / 9999

In case of successive error code the device can be reboot remotely: How to reset a device trought a downlink message