DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

DF550 Ultrasonic Level Sensor

Protocol_LoRaWAN

V3.0
Date:2020-01-03

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 1
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

Changed Note

V3.0 Modify the format of uplink data, and downlink commands; For firmware
version V2.0.6 and above.
V2.0 Initial version.

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 2
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

Index
1 Terminal Upload Data Format.......................................................................................................4
1.1 Field Definition.................................................................................................................... 4
1.1.1 Packet Header........................................................................................................... 4
1.1.2 Forced Bit.................................................................................................................. 4
1.1.3 Device Type...............................................................................................................4
1.1.4 Report Data Type......................................................................................................4
1.1.5 Packet Size.................................................................................................................5
1.1.6 Payload...................................................................................................................... 5
1.1.7 Reserved Filed.......................................................................................................... 6
1.1.8 Packet Tail................................................................................................................. 6
1.2 Example................................................................................................................................ 6
2 Terminal Downlink Command Format 1......................................................................................7
2.1 0x01 Setting Periodic Upload Time................................................................................... 7
2.2 0x09 Choosing Measuring Range.......................................................................................8
3 Terminal Downlink Command Format 2......................................................................................9
3.1 Read Current Configuration............................................................................................. 10
3.2 Read Air Level.................................................................................................................... 10
3.3 Read Liquid Level.............................................................................................................. 10
3.4 Set ID...................................................................................................................................10
3.5 Set Container Height......................................................................................................... 11
3.6 Set Installation Height.......................................................................................................11

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 3
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

1 Terminal Upload Data Format

1.1 Field Definition

1.1.1 Packet Header

Packet head:0x80；length:1byte.

1.1.2 Forced Bit

Forced bit:0x00; length:1byte

1.1.3 Device Type

Command Device type
0X01 DF550

1.1.4 Report Data Type

Command Type
0x01 Active reporting of information
0x02 Heartbeat data type
0X03 Reply to the downlink command(not used)
0X04 Re-transmit data type(not used)

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 4
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

1.1.5 Packet Size

The size of the packet,in hex.

1.1.6 Payload

Report data type0x01, 0x02 and 0x04:

S/N 1 2 3 4 5 6 7
Payload Height Reserved TEMP Reserve full Reserved Frame
d status counter

Size 2bytes 1byte 1byte 2bytes 0.5byte 1.5byte 2byte

Payload field definition:

(1) Height:2bytes in hex, unit:mm; For example: 060E means1550mm; Height;
(2)Reserved:1byte, default 0x00;
(3) TEMP:temperature; 1byte,in hex, unit:℃; For example, 0x10 means 16℃; Temperature;
(4) Reserved :2bytes, default 0x00;
(5-6)Full status&Reserved: total 2bytes; the high four bits indicate full status(0x00:not full;
0x10:full),others are reserved.
(7)Frame counter: 2bytes, in hex;

DF550 device data information (0x03 type of downlink confirmation , that is, reply
from the device to the host computer or the cloud), as follows:

S/N 1 2 3 4 5 6 7 8
Payload Sensor UPload Reserv- Alarm Alarm Reserv Measu Reserv
version Time ed Height Temp -ed -ring ed
range
Size 2 bytes 1byte 1byte 1byte 1byte 1byte 1byte 10byte
s

Payload field definition:

(1)Sensor version:2bytes ； High 8-digit major version number, low 8-digit minor version
number;
(2)UPloadTime:1byte；in hex；UPloadTime；
(3)Reserved:Reserved,1byte
(4)AlarmHeight；1byte；in hex；AlarmHeight
(5)AlarmTemp；1byte；in hex；AlarmTemp
(6)Reserved:Reserved,1byte
Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700
http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 5
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

(7)Ultrasonic range:00:2m version，01:5m version；

(8)Reserved:Reserved,10bytes

1.1.7 Reserved Filed

Reserved filed: 0x00,1byte

1.1.8 Packet Tail

Packet tail: 0x81,1byte

1.2 Example
Example1:8000010211119A001B0000000001E20081

80：Packet head
00：Forced bit
01：Device type, DF550
02：Heartbeat data type
11：The size of the packet
119A：Height:in hex,4506mm
001B:00 is Reserved,1B:Temperature,in hex,27℃
0000:Reserved
0000:0:Full status,empty;0000:Reserved
01E2:Fram count
00:Reserved filed
81:Packet tail

Example2:8000010319000705001E4B1E00000000000000000000000081
80：Packet head
00：Forced bit
01：Device type, DF550
03：Reply to the downlink command
19：The size of the packet
0007:Sensor version
05:UPloadTime,default is 5 min
00:Reserved
1E:AlarmHeight,default is 30cm
4B:AlarmTemp,default is 75℃
1E:Reserved
00:2m version
00000000000000000000:Reserved

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 6
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

00:Reserved filed
81:Packet tail

2 Terminal Downlink Command Format 1

Downlink command format:

Packet Command Packet

Field Payload
head type tail

Packet Command Payload Command Packet

Instruction content
head type header code tail

Size 1byte 1byte 2byte 1byte n 1byte

Packet head
Packet head: 0x80; 1byte.

Command type
Command type Instruction
0x02 Configure device parameters through the downlink
... ...

Payload
Payload header: 9999 by default
Command code:
Command code Function Description
01 Setting Periodic upload time
09 Choosing measuring range

Content: please refer to detailed command description part2.1-2.2

Packet head
Packet tail: 0x81,1byte.

2.1 0x01 Setting Periodic Upload Time

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 7
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

Function: setting periodic upload time interval

Default: 5min
Range: 1-60min, 1-24hours
Command type: ASCII
Format:
Packet Command Packet
Field Payload
head type tail

Instruction 80 02 9999 01 Content 81

Size 1byte 1byte 2byte 1byte n 1byte

Content：
1byte, in hex;The value range is 0x00-0x54; 0x00-0x3C means 1-60min; 0x3D-0x54 means
1-24h;

For example1:
Setting periodic upload time to 10min:
Command: 80029999010A81

For example2:
Setting periodic upload time to 1hour:
Command: 80029999013D81

2.2 0x09 Choosing Measuring Range

Function: Choosing measuring range,like 2meters(112k),5meters(75k), 12meters(40k),It
have configured before shipping.Therefore, donot modify it when you received it.
Default: It have configured before shipping according your order.
Command type: ASCII
Format:
Packet Command Packet
Field Payload
head type tail

Instruction 80 02 9999 09 Content 81

Size 1byte 1byte 2byte 1byte n 1byte

Content：
1byte; Value:0x07,0x08, 0x0F, 07 means 2meters(112k), 08 means 5meters(75k), 0F means
12meters(40k).
Note: It have configured before shipping.Therefore, donot modify it when you received it.

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 8
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

For example1:
Setting measuring range to 2meters,
Command: 80029999090781

3 Terminal Downlink Command Format 2

1 2 2 n 2 2
Header Comman ID Content Checksum Tail
d

Header/Tail
Header 1 byte，$ in ASCII and in hex 0x24 for the request to sensor. And * in ASCII and in hex
0x2A for the reply from sensor. Tail 2 byte, in hex 0x0D 0A.

Command
Command list:

Command Function
RC Read Current Configuration
RA Read Air Level
RL Read Liquid Level
SH Set container Height
SI Set ID
IH Set Install Height

ID
01~FF

Content
0~32 bytes.

Checksum
Sum of bytes from header to id, then select the low 8 bit, finally convert to ASCII
and show in Hex. E.g. If sum is 0x0356, then low 8 bit is 0x56, to ASCII, the value
is 56 (0x35 0x36 in Hex).
Example：
$SI0100000142 Set ID to 01
0x 24 53 49 30 31 30 30 30 30 30 31 0D 0A
0x24 + 53+ 49+30+31+30+30+30+30+30+31=0x242, checksum is ASCII 42, in
hex 0x34 32.
Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700
http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 9
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

3.1 Read Current Configuration

Read basic sensor parameters:$RC01FA
Request from computer to sensor:
ASCI : $RC01FA
Hex:24524330314641OD0A
Reply from sensor:
User parameter in flash Rom
Example:
ID: 01
Container Type: 1
Container Height: 1000

3.2 Read Air Level

Read air height:$RA0118
Request from computer to sensor:
ASCI : $RA0118
Hex:245241303131380D0A
Reply from sensor:
ASCII : *RA0100080046

3.3 Read Liquid Level

Read level:$RL0123
Request from computer to sensor:
ASCII: $RL0123
Hex:24524C303132330D0A
Reply from sensor:
ASCII: *RL01001 2004C
01 is sensor id, 00 is filler to reach 6 bytes, 1200 is liquid level. Unit is mm. Before
using this command, the tank height should be set in advance.

3.4 Set ID
SetID: $SI0100000142
Request from computer to sensor:
ASCI : $SI01 00000142
Hex:245349303130303030303134320D0A
Reply from sensor:
*SI01 OKOKOKEF
01 is sensor id, 00 is filler to reach 6 bytes, 01 is the new id, id range is 00~FF.

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 10
 DF550 Ultrasonic Level Sensor_LoRaWAN_ Protocol

3.5 Set Container Height

Set container height:$SH0100200042
Request from computer to sensor:
ASCI : $SH0100200042
Hex:245348303130303230303034320D0A
Reply from sensor:
*SH01 OKOKOKF4
01 is sensor id, 00 is filler to reach 6 bytes, 2000 is the tank height, unit is mm.

3.6 Set Installation Height

Setting the installation height:$IH010001503C

The installation height is the parameter which can be used to correct the
liquid level can not meet 100%. It is recommend to use the min Air height
as the installation height. After configuration,
the liquid percent = {Hf ( Tank Height)- Air height measured (RA command )}/ { Hf (tank
height) - Installation height (recommend min air height)}
Request from computer to sensor:
ASCII : $IH010001503C
Hex:244948303130303031353033430D0A
Reply from sensor: .
*IH01 OKOKOKEA
01 is sensor id, 000 is filler to reach 6 bytes. 150 is the Installation height, unit is
mm.

Beijing Dingtek Technology Corp., Ltd. Tel:86-10-64718863,64753700

http://www.dingtek.com E-mail: [email protected]
Room A209, Flounder Business Park, Shunbai Road 12, Chaoyang District, Beijing, China 100022 Page 11