载荷格式

上行数据包解析

追踪器数据协议提供不同的数据包来对应不同的信息，每个数据包的字节数可能有所不同。帧结构如下图所示。帧内容以大端字节序发送。

数据ID	数据值
1字节	50字节（最大）

数据ID：功能编号。 数据值：位置、传感器数据和其他信息。

设备状态数据包 - 事件模式 0x01

设备状态数据包在加入LoRaWAN网络时上传。设备状态数据包在不同工作模式下有两种数据包格式：

事件模式，ID=0x01
周期模式，ID= 0x02

设备状态数据包 - 事件模式：0x01

0x01	字节2	字节3~4	字节5~6	字节7	字节8	字节9~10	字节11~12
ID	电池电量	软件版本	硬件版本	工作模式	定位策略	心跳间隔	上行间隔

字节13~14	字节15	字节16	字节17	字节18~19	字节20~21
事件模式上行间隔	温度和光照开关	SOS模式	启用运动事件	3轴运动阈值	运动开始间隔

字节22	字节23~24	字节25	字节26~27	字节28	字节29~30
启用静止事件	静止超时	启用震动事件	3轴震动阈值	启用温度事件	温度事件上行间隔

字节31~32	字节33~34	字节35~36	字节37	字节38	字节39~40
温度采样间隔	温度阈值最大值	温度阈值最小值	温度告警类型	启用光照事件	光照事件上行间隔

字节41~42	字节43~44	字节45~46	字节47
光照采样间隔	光照阈值最大值	光照阈值最小值	光照告警类型

原始载荷：

0153010501050207001e00050005010000001e000500016801012c000005001e025800000000000500010064000000

字节	值	类型	原始数据	描述
1	帧ID	uint8	01	01是数据包ID。
2	电池电量	uint8	53	53是0x53 = 83（十进制）电池电量为83%
3~4	软件版本	uint16	0105	0105是0x0105 == v1.5 软件版本为v1.5
5~6	硬件版本	uint16	0105	0105是0x0105 == v1.5 硬件版本为v1.5
7	工作模式	uint8	02	02是0x02，表示设备使用"事件模式"。 00：待机模式 01：周期模式 02：事件模式
8	定位策略	uint8	07	07是0x07，表示设备使用蓝牙 + Wi-Fi + GNSS定位策略。 00：仅GNSS 01：仅Wi-Fi 02：Wi-Fi+GNSS 03：GNSS + Wi-Fi 04：仅蓝牙 05：蓝牙 + Wi-Fi 06：蓝牙 + GNSS 07：蓝牙 + Wi-Fi + GNSS
9~10	心跳间隔	uint16	001e	001e是0x001E = 30（十进制），心跳间隔为30分钟。
11~12	上行间隔	uint16	0005	0005是0x0005 = 5（十进制），上行间隔为5分钟。
13~14	事件模式上行间隔	uint16	0005	0005是0x0005 = 5（十进制），事件模式上行间隔为5分钟。
15	温度和光照开关	uint8	01	01表示打开温度和光照传感器。 00：关闭温度和光照传感器。 01：打开温度和光照传感器。
16	SOS模式	uint8	00	00表示使用SOS单次模式。 00：使用SOS单次模式。 01：使用SOS连续模式。
17	启用运动事件	uint8	00	00表示禁用事件模式。 00：禁用事件模式。 01：启用事件模式。
18~19	3轴运动阈值	uint16	001e	001e是0x001E=30（十进制）mg 当加速度超过30mg时，判断设备处于运动状态，当低于此值2分钟时，判断设备处于静止状态。
20~21	运动开始间隔	uint16	0005	0005是0x0005 = 5（十进制），当设备处于运动状态时，间隔为5分钟。
22	启用静止事件	uint8	00	00表示禁用静止事件。 00：禁用静止事件。 01：启用静止事件。
23~24	静止超时	uint16	0168	0168是0x0168 = 360（十进制），当设备在一个位置静止超过360分钟时，触发静止超时事件。
25	启用震动事件	uint8	01	01表示启用震动事件。 00：禁用震动事件。 01：启用震动事件。
26~27	3轴震动阈值	uint16	012c	012c是0x012C=300（十进制）mg 当加速度超过300mg时，触发震动事件。
28	启用温度事件	uint8	00	00表示启用震动事件。 00：禁用震动事件。 01：启用震动事件。
29~30	温度事件上行间隔	uint16	0005	0005是0x0005 = 5（十进制），当温度超过阈值时，位置和传感器数据将每5分钟上传一次。
31~32	温度采样间隔	uint16	001e	001e是0x001E=30（十进制）秒每30秒检测一次温度。当触发阈值时，上传位置和传感器数据。
33~34	温度阈值最大值	int16	0258	0258是0x0258 = 600（十进制），最大阈值 =600/10=60.0 ℃
35~36	温度阈值最小值	int16	0000	0000是0x0000 = 0（十进制），最小阈值=0/10=0.0 ℃
37	温度阈值规则	uint8	00	00表示当温度 ≤ 最小阈值时，设备将上传位置和温度事件。 00：温度 ≤ 最小阈值 01：温度 ≥ 最大阈值 02：温度 ≤ 最小阈值且温度 ≥ 最大阈值 03：最小阈值≤ 温度 ≤最大阈值
38	启用光照事件	uint8	00	00表示禁用光照事件。 00：禁用光照事件。 01：启用光照事件。
39~40	光照事件上行间隔	uint16	0005	0005是0x0005 = 5（十进制），当光照超过阈值时，位置和传感器数据将每5分钟上传一次。
41~42	光照采样间隔	uint16	0001	0001是0x0001=1（十进制）秒每1秒检测一次温度。当触发阈值时，上传位置和传感器数据。
43~44	光照阈值最大值	uint16	0064	0064是0x0064 = 100（十进制）% 最大阈值 =100%
45~46	光照阈值最小值	uint16	0000	0000是0x0000 = 0（十进制）% 最小阈值=0%
47	光照告警类型	uint8	00	00表示当光照 ≤ 最小阈值时，设备将上传位置和光照事件。 00：光照 ≤ 最小阈值 01：光照 ≥ 最大阈值 02：光照 ≤ 最小阈值且光照 ≥ 最大阈值 03：最小阈值≤ 光照 ≤最大阈值

设备状态数据包 - 周期模式 0x02

设备状态数据包在加入LoRaWAN网络时上传。设备状态数据包在不同工作模式下有两种数据包格式：

事件模式，ID=0x01
周期模式，ID= 0x02

设备状态数据包 - 周期模式：0x02

0x02	Byte2	Byte3~4	Byte5~6	Byte7	Byte8	Byte9~10	Byte11~12
ID	电池电量	软件版本	硬件版本	工作模式	定位策略	心跳间隔	上行间隔

Byte13~14	Byte15	Byte16
事件模式上行间隔	温度和光照开关	SOS模式

原始载荷：

025601050105010002d0003c003c0000

字节	值	类型	原始数据	描述
1	帧ID	uint8	02	02是数据包ID。
2	电池电量	uint8	56	56是0x56 = 86(十进制) 电池电量为86%
3~4	软件版本	uint16	0105	0105是0x0105 == v1.5 软件版本为v1.5
5~6	硬件版本	uint16	0105	0105是0x0105 == v1.5 硬件版本为v1.5
7	工作模式	uint8	01	01是0x01，表示设备使用"周期模式"。 00：待机模式 01：周期模式 02：事件模式
8	定位策略	uint8	00	00是0x01，表示设备使用"仅GNSS"定位策略。 00：仅GNSS 01：仅Wi-Fi 02：Wi-Fi+GNSS 03：GNSS + Wi-Fi 04：仅蓝牙 05：蓝牙 + Wi-Fi 06：蓝牙 + GNSS 07：蓝牙 + Wi-Fi + GNSS
9~10	心跳间隔	uint16	02d0	02d0是0x02D0 = 720(十进制)分钟，心跳间隔为720分钟。
11~12	上行间隔	uint16	003c	003c是0x003C = 60(十进制)分钟，上行间隔为60分钟。
13~14	事件模式上行间隔	uint16	003c	003c是0x003C = 60(十进制)，事件模式上行间隔为60分钟。
15	温度和光照开关	uint8	00	00表示打开温度和光照传感器。 00：关闭温度和光照传感器。 01：打开温度和光照传感器。
16	SOS模式	uint8	00	00表示使用SOS单次模式。 00：使用SOS单次模式。 01：使用SOS连续模式。

心跳数据包 -0x05

当设备在心跳间隔内没有上传数据时，将触发心跳数据包。此数据包仅包含电池信息。

0x05	Byte2	Byte3	Byte4	Byte5
ID	电池电量	工作模式	定位策略	SOS模式

原始载荷：

0564010001

字节	值	类型	原始数据	描述
1	帧ID	uint8	05	05是数据包ID。
2	电池电量	uint8	64	64是0x64 = 100(十进制) 电池电量为100%
3	工作模式	uint8	01	01是0x01，表示设备使用"周期模式"。 00：待机模式 01：周期模式 02：事件模式
4	定位策略	uint8	00	00是0x01，表示设备使用"仅GNSS"定位策略。 00：仅GNSS 01：仅Wi-Fi 02：Wi-Fi+GNSS 03：GNSS + Wi-Fi 04：仅蓝牙 05：蓝牙 + Wi-Fi 06：蓝牙 + GNSS 07：蓝牙 + Wi-Fi + GNSS
5	SOS模式	uint8	00	00表示使用SOS单次模式。 00：使用SOS单次模式。 01：使用SOS连续模式。

GNSS位置和传感器数据包-0x06

ID 0x06用于上传GNSS位置、传感器数据和电池信息。

0x06	Byte2~4	Byte5	Byte6~9	Byte10~13	Byte14~17
ID	事件状态	运动段编号	UTC时间	经度	纬度

Byte18~19	Byte20~21	Byte22
温度	光照	电池电量

原始载荷：

06000008006462248d06ca502801587ec600fe000057

字节	值	类型	原始数据	描述
1	帧ID	uint8	06	06是数据包ID。
2~4	事件状态	uint24	000008	000008是0x000008，0x0000XX为保留位，0x08是事件状态。此字节有8位，每位代表一个事件。 Bit1：开始移动事件。 Bit2：结束移动事件。 Bit3：静止事件。 Bit4：震动事件。 Bit5：温度事件。 Bit6：光照事件。 Bit7：SOS事件。 Bit8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS事件。 0x000080：单击事件。
5	运动段编号	uint8	00	00是0x00 == 0。当运动开始时，计数增加1。记录这是一次移动。
6~9	UTC时间	uint32	6462248d	6462248d是0x6462248D = 1684153485(十进制)秒。转换为北京时间：2023-05-15 20:24:45
10~13	经度	int32	06ca5028	06ca5028是0x06CA5028 = 113922088(十进制)，经度= 113922088/1000000=113.922088
14~17	纬度	int32	01587ec6	01587ec6是0x01587EC6 = 22576838(十进制)，纬度 = 22576838/1000000=22.576838
18~19	温度	int16	00fe	00fe是0x00FE = 254(十进制)，温度=254/10=25.4℃
20~21	光照	uint16	0000	0000是0x0000 = 0(十进制)分钟，光照=0=0%
22	电池电量	uint8	57	57是0x57 = 87(十进制) 电池电量为87%

Wi-Fi位置和传感器数据包-0x07

ID 0x07用于上传Wi-Fi Mac地址、传感器数据和电池信息。

0x07	Byte2~4	Byte5	Byte6~9	Byte10~15	Byte16
ID	事件状态	运动段编号	UTC时间	MAC地址1	MAC地址1的RSSI，int8

Byte17~22	Byte23	Byte24~29	Byte30	Byte31~36	Byte37
MAC地址2	MAC地址2的RSSI，int8	MAC地址3	MAC地址3的RSSI，int8	MAC地址4	MAC地址4的RSSI，int8

Byte38~39	Byte40~41	Byte42
温度	光照	电池电量

原始载荷：

070000080064622472487397162234bb3ccd5798fd2ebc74cf002f3ad0a9ec26ca022958b900fe000057

字节	值	类型	原始数据	描述
1	帧ID	uint8	07	07是数据包ID。
2~4	事件状态	uint24	000008	000008是0x000008，0x0000XX为保留位，0x08是事件状态。此字节有8位，每位代表一个事件。 Bit1：开始移动事件。 Bit2：结束移动事件。 Bit3：静止事件。 Bit4：震动事件。 Bit5：温度事件。 Bit6：光照事件。 Bit7：SOS事件。 Bit8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS事件。 0x000080：单击事件。
5	运动段编号	uint8	00	00是0x00 == 0。当运动开始时，计数增加1。记录这是一次移动。
6~9	UTC时间	uint32	64622472	64622472是0x64622472 = 1684153458(十进制)秒。转换为北京时间：2023-05-15 20:24:18
10~15	MAC地址1	----	487397162234	487397162234 MAC地址(十六进制)= 48:73:97:16:22:34
16	MAC地址1的RSSI	int8	bb	bb是0xBB = -69(十进制)，类型为int8 RSSI = -69
17~22	MAC地址2	----	3ccd5798fd2e	3ccd5798fd2e MAC地址(十六进制)= 3C:CD:57:98:FD:2E
23	MAC地址2的RSSI	int8	bc	bc是0xBC = -68(十进制)，类型为int8 RSSI = -68
24~29	MAC地址3	----	74cf002f3ad0	74cf002f3ad0 MAC地址(十六进制)= 74:CF:00:2F:3A:D0
30	MAC地址3的RSSI	int8	a9	a9是0xA9 = -87(十进制)，类型为int8 RSSI = -87
31~36	MAC地址4	----	ec26ca022958	ec26ca022958 MAC地址(十六进制)= EC:26:CA:02:29:58
37	MAC地址4的RSSI	int8	b9	b9是0xA9 = -71(十进制)，类型为int8 RSSI = -71
38~39	温度	int16	00fe	00fe是0x00FE = 254(十进制)，温度=254/10=25.4℃
40~41	光照	uint16	0000	0000是0x0000 = 0(十进制)分钟，光照=0=0%
42	电池电量	uint8	57	57是0x57 = 87(十进制) 电池电量为87%

蓝牙位置和传感器数据包-0x08

ID 0x08 用于上传蓝牙信标 MAC 地址、传感器数据和电池信息。

0x08	Byte2~4	Byte5	Byte6~9	Byte10~15	Byte16
ID	事件状态	运动段编号	UTC 时间	MAC 地址 1	MAC 地址 1 的 RSSI，int8

Byte17~22	Byte23	Byte24~29	Byte30	Byte31~32	Byte33~34	Byte 35
MAC 地址 2	MAC 地址 2 的 RSSI，int8	MAC 地址 3	MAC 地址 3 的 RSSI，int8	温度	光照	电池电量

原始载荷：

0800000800646225bb5162d2c1b9d3ca1b5bd2afeae5c0d0e2d70529e8c900fa000057

字节	值	类型	原始数据	描述
1	帧 ID	uint8	08	08 是数据包 ID。
2~4	事件状态	uint24	000008	000008 是 0x000008，0x0000XX 是保留位，0x08 是事件状态。此字节有 8 位，每位代表一个事件。 Bit1：开始移动事件。 Bit2：结束移动事件。 Bit3：静止事件。 Bit4：震动事件。 Bit5：温度事件。 Bit6：光照事件。 Bit7：SOS 事件。 Bit8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS 事件。 0x000080：单击事件。
5	运动段编号	uint8	00	00 是 0x00 == 0。当运动开始时，计数增加 1。记录这是一次移动。
6~9	UTC 时间	uint32	646225bb	646225bb 是 0x646225BB = 1684153787 (DEC) 秒。转换为北京时间：2023-05-15 20:29:47
10~15	MAC 地址 1	-----	5162d2c1b9d3	5162d2c1b9d3 MAC 地址 (HEX)=51:62:D2:C1:B9:D3
16	MAC 地址 1 的 RSSI	int8	c0	c0 是 0xC0 = -64(DEC)，类型是 int8 RSSI = -64
17~22	MAC 地址 2	-----	1b5bd2afeae5	1b5bd2afeae5 MAC 地址 (HEX)= 1B:5B:D2:AF:EA:E5
23	MAC 地址 2 的 RSSI	int8	bc	bc 是 0xBC = -68(DEC)，类型是 int8 RSSI = -68
24~29	MAC 地址 3	-----	d0e2d70529e8	d0e2d70529e8 MAC 地址 (HEX)= D0:E2:D7:05:29:E8
30	MAC 地址 3 的 RSSI	int8	c9	c9 是 0xC9 = -55(DEC)，类型是 int8 RSSI = -55
31~32	温度	int16	00fa	00fa 是 0x00FA = 250(DEC)，温度=254/10=25.0℃
33~34	光照	uint16	0000	0000 是 0x0000 = 0(DEC) 分钟，光照=0=0%
35	电池电量	uint8	57	57 是 0x57 = 87(DEC) 电池电量是 87%

GNSS 仅位置数据包-0x09

当传感器关闭时，设备不上传传感器测量值。仅上传位置数据。

0x09	Byte2~4	Byte5	Byte6~9	Byte10~13	Byte14~17	Byte18
ID	事件状态	运动段编号	UTC 时间	经度	纬度	电池电量

原始载荷：

09000000006463186806ca506801587e4c56

字节	值	类型	原始数据	描述
1	帧 ID	uint8	09	09 是数据包 ID。
2~4	事件状态	uint24	000000	000000 是 0x000008，0x0000XX 是保留位，0x08 是事件状态。此字节有 8 位，每位代表一个事件。 Bit1：开始移动事件。 Bit2：结束移动事件。 Bit3：静止事件。 Bit4：震动事件。 Bit5：温度事件。 Bit6：光照事件。 Bit7：SOS 事件。 Bit8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS 事件。 0x000080：单击事件。
5	运动段编号	uint8	00	00 是 0x00 == 0。当运动开始时，计数增加 1。记录这是一次移动。
6~9	UTC 时间	uint32	64631868	64631868 是 0x64631868 = 1684215912 (DEC) 秒。转换为北京时间：2023-05-16 13:45:12
10~13	经度	int32	06ca5068	06ca5068 是 0x06CA5068 = 113922152 (DEC)，经度= 113922152/1000000=113.922152
14~17	纬度	int32	01587e4c	01587e4c 是 0x01587E4C = 22576716 (DEC)，纬度 = 22576716/1000000=22.576716
18	电池电量	uint8	56	56 是 0x56 = 86(DEC) 电池电量是 86%

Wi-Fi 仅位置数据包-0x0A

0x0A	Byte2~4	Byte5	Byte6~9	Byte10~15	Byte16
ID	事件状态	运动段编号	UTC 时间	MAC 地址 1	MAC 地址 1 的 RSSI，int8

Byte17~22	Byte23	Byte24~29	Byte30	Byte31~36	Byte37	Byte38
MAC 地址 2	MAC 地址 2 的 RSSI，int8	MAC 地址 3	MAC 地址 3 的 RSSI，int8	MAC 地址 4	MAC 地址 4 的 RSSI，int8	电池电量

原始载荷：

0A0000080064622472487397162234bb3ccd5798fd2ebc74cf002f3ad0a9ec26ca022958b957

字节	值	类型	原始数据	描述
1	帧 ID	uint8	0A	0A 是数据包 ID。
2~4	事件状态	uint32	000008	000008 是 0x000008，0x0000XX 是保留位，0x08 是事件状态。此字节有 8 位，每位代表一个事件。 Bit1：开始移动事件。 Bit2：结束移动事件。 Bit3：静止事件。 Bit4：震动事件。 Bit5：温度事件。 Bit6：光照事件。 Bit7：SOS 事件。 Bit8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS 事件。 0x000080：单击事件。
5	运动段编号	uint8	00	00 是 0x00 == 0。当运动开始时，计数增加 1。记录这是一次移动。
6~9	UTC 时间	uint32	64622472	64622472 是 0x64622472 = 1684153458 (DEC) 秒。转换为北京时间：2023-05-15 20:24:18
10~15	MAC 地址 1	-----	487397162234	487397162234 MAC 地址 (HEX)= 48:73:97:16:22:34
16	MAC 地址 1 的 RSSI	int8	bb	bb 是 0xBB = -69(DEC)，类型是 int8 RSSI = -69
17~22	MAC 地址 2	-----	3ccd5798fd2e	3ccd5798fd2e MAC 地址 (HEX)= 3C:CD:57:98:FD:2E
23	MAC 地址 2 的 RSSI	int8	bc	bc 是 0xBC = -68(DEC)，类型是 int8 RSSI = -68
24~29	MAC 地址 3	-----	74cf002f3ad0	74cf002f3ad0 MAC 地址 (HEX)= 74:CF:00:2F:3A:D0
30	MAC 地址 3 的 RSSI	int8	a9	a9 是 0xA9 = -87(DEC)，类型是 int8 RSSI = -87
31~36	MAC 地址 4	-----	ec26ca022958	ec26ca022958 MAC 地址 (HEX)= EC:26:CA:02:29:58
37	MAC 地址 4 的 RSSI，int8	int8	b9	b9 是 0xA9 = -71(DEC)，类型是 int8 RSSI = -71
38	电池电量	uint8	57	57 是 0x57 = 87(DEC) 电池电量是 87%

仅蓝牙定位数据包-0x0B

0x0B	字节2~4	字节5	字节6~9	字节10~15	字节16
ID	事件状态	运动段编号	UTC时间	MAC地址1	MAC地址1的RSSI，int8

字节17~22	字节23	字节24~29	字节30	字节31
MAC地址2	MAC地址2的RSSI，int8	MAC地址3	MAC地址3的RSSI，int8	电池电量

原始载荷：

0B00000800646225bb5162d2c1b9d3ca1b5bd2afeae5c0d0e2d70529e8c957

字节	值	类型	原始数据	描述
1	帧ID	uint8	0B	0B是数据包ID。
2~4	事件状态	uint24	000008	000008是0x000008，0x0000XX是保留位，0x08是事件状态。此字节有8位，每位代表一个事件。位1：开始移动事件。位2：结束移动事件。位3：静止事件。位4：震动事件。位5：温度事件。位6：光照事件。位7：SOS事件。位8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS事件。 0x000080：单击事件。
5	运动段编号	uint8	00	00是0x00 == 0。当运动开始时，计数增加1。记录这是一次移动。
6~9	UTC时间	uint32	646225bb	646225bb是0x646225BB = 1684153787（十进制）秒。转换为北京时间：2023-05-15 20:29:47
10~15	MAC地址1	-----	5162d2c1b9d3	5162d2c1b9d3 MAC地址（十六进制）=51:62:D2:C1:B9:D3
16	MAC地址1的RSSI，int8	int8	c0	c0是0xC0 = -64（十进制），类型是int8 RSSI = -64
17~22	MAC地址2	-----	1b5bd2afeae5	1b5bd2afeae5 MAC地址（十六进制）= 1B:5B:D2:AF:EA:E5
23	MAC地址2的RSSI，int8	int8	bc	bc是0xBC = -68（十进制），类型是int8 RSSI = -68
24~29	MAC地址3	-----	d0e2d70529e8	d0e2d70529e8 MAC地址（十六进制）= D0:E2:D7:05:29:E8
30	MAC地址3的RSSI，int8	int8	c9	c9是0xC9 = -55（十进制），类型是int8 RSSI = -55
31	电池电量	uint8	57	57是0x57 = 87（十进制）电池电量是87%

错误代码数据包-0x0D

ID 0x0D数据包用于上传错误代码。

原始载荷：

0D00000001

字节	值	类型	原始数据	描述
1	帧ID	uint8	0D	0D是数据包ID。
2~5	错误代码	uint32	00000001	0x00000001：UTC时间获取失败 0x00000002：历书过旧 0x00000003：多普勒错误

字节

值

类型

原始数据

描述

帧ID

uint8

0D是数据包ID。

2~5

错误代码

uint32

00000001

0x00000001：UTC时间获取失败

0x00000002：历书过旧

0x00000003：多普勒错误

定位状态和传感器数据包-0x11

ID 0x11用于上传定位状态、传感器数据和电池信息。

原始载荷：

110100000064a763a0014100002f

字节	值	类型	原始数据	描述
1	帧ID	uint8	11	11是数据包ID。
2	定位状态	uint8	01	00：定位成功 01：GNSS扫描超时，获取位置失败。 02：Wi-Fi扫描超时，获取位置失败。 03：Wi-Fi + GNSS扫描超时，获取位置失败。 04：GNSS + Wi-Fi扫描超时，获取位置失败。 05：蓝牙扫描超时，获取位置失败。 06：蓝牙 + Wi-Fi扫描超时，获取位置失败。 07：蓝牙 + GNSS扫描超时，获取位置失败。 08：蓝牙 + Wi-Fi + GNSS扫描超时，获取位置失败。 09：位置服务器解析GNSS位置失败。 0A：位置服务器解析Wi-Fi位置失败。 0B：位置服务器解析蓝牙位置失败。 0C：由于精度不佳，解析GNSS位置失败。 0D：时间同步失败。 0E：由于历书过旧，获取定位失败。
3～5	事件状态	uint24	000000	000000是0x000000，0x0000XX是保留位，0x00是事件状态。此字节有8位，每位代表一个事件。位1：开始移动事件。位2：结束移动事件。位3：静止事件。位4：震动事件。位5：温度事件。位6：光照事件。位7：SOS事件。位8：单击事件。转换为十六进制： 0x000000：无事件 0x000001：开始移动事件。 0x000002：结束移动事件。 0x000004：静止事件。 0x000008：震动事件。 0x000010：温度事件。 0x000020：光照事件。 0x000040：SOS事件。 0x000080：单击事件。
6～9	UTC时间戳	uint32	64a763a0	64a763a0是0x64a763a0 = 1688691616（十进制）秒。转换为北京时间：2023-07-07 09:00:16
10～11	温度	int16	0141	0141是0x0141 = 321（十进制），温度=321/10=32.1℃
12～13	光照	uint16	0000	0000是0x0000 = 0（十进制）分钟，光照=0=0%
14	电池电量	uint8	2F	2F是0x2F = 47（十进制）电池电量是47%

下行数据包，FPort=5

追踪器支持通过 LoRaWAN 下行一些命令来调整参数。如果设备处于休眠状态，下行命令将在设备下次唤醒上传数据时生效。

注意：FPort=5

设置 SOS 模式 -0x80

0x80	Byte2
ID	SOS 模式 0: 单次模式 1: 连续模式

8000: 设置 SOS 为单次模式。

8001: 设置 SOS 为连续模式。

设置上行间隔 -0x81

0x81	Byte2~3	Byte4~5	Byte6~7
ID	心跳上行间隔 0000: 保持当前配置单位: 分钟	周期模式上行间隔 0000: 保持当前配置单位: 分钟	事件模式上行间隔 0000: 保持当前配置单位: 分钟

0x81

Byte2~3

Byte4~5

Byte6~7

心跳上行间隔

0000: 保持当前配置

单位: 分钟

周期模式上行间隔

0000: 保持当前配置

单位: 分钟

事件模式上行间隔

0000: 保持当前配置

单位: 分钟

示例: 设置周期模式间隔为 30 分钟

命令: 810000001E0000

打开蜂鸣器 -0x82

发送此命令后，设备唤醒后将打开蜂鸣器报警音，并持续响铃 1 分钟。

0x82	Byte2
ID	打开蜂鸣器。 00: 关闭 01: 打开

8200: 关闭蜂鸣器
8201: 打开蜂鸣器

设置工作模式 -0x83

0x83	Byte2
ID	打开蜂鸣器。 00: 待机模式 01: 周期模式 02: 事件模式

8300: 设置工作模式为待机模式
8301: 设置工作模式为周期模式
8302: 设置工作模式为事件模式

设置工作模式 -0x84

0x84	Byte2	Byte3~4	Byte5~6	Byte7	Byte8~9
ID	启用运动事件	3轴运动阈值	运动开始间隔	启用静止事件	静止超时

Byte10	Byte11~12	Byte13	Byte14~15	Byte16~17	Byte18~19
启用震动事件	3轴震动阈值	启用温度事件	温度事件上行间隔	温度采样间隔	温度阈值最大值

Byte20~21	Byte22	Byte23	Byte24~25	Byte26~27	Byte28~29
温度阈值最小值	温度警告类型	启用光照事件	光照事件上行间隔	光照采样间隔	光照阈值最大值

Byte30~31	Byte32
光照阈值最小值	光照警告类型

命令:

8400001e000500016801012c000005001e025800000000000500010064000000

字节	值	类型	原始数据	描述
1	帧 ID	uint8	84	84 是数据包 ID。
2	启用运动事件	uint8	00	00 表示禁用事件模式。 00: 禁用事件模式。 01: 启用事件模式。
3~4	3轴运动阈值	uint16	001e	001e 是 0x001E=30(十进制) mg 当加速度超过 30mg 时，判断设备处于运动状态，当低于此值 2 分钟时，判断设备处于静止状态。
5~6	运动开始间隔	uint16	0005	0005 是 0x0005 = 5(十进制)，当设备处于运动状态时，间隔为 5 分钟。
7	启用静止事件	uint8	00	00 表示禁用静止事件。 00: 禁用静止事件。 01: 启用静止事件。
8~9	静止超时	uint16	0168	0168 是 0x0168 = 360(十进制)，当设备在某个位置静止超过 360 分钟时，触发静止超时事件。
10	启用震动事件	uint8	01	01 表示启用震动事件。 00: 禁用震动事件。 01: 启用震动事件。
11~12	3轴震动阈值	uint16	012c	012c 是 0x012C=300(十进制) mg 当加速度超过 300mg 时，触发震动事件。
13	启用温度事件	uint8	00	00 表示启用震动事件。 00: 禁用震动事件。 01: 启用震动事件。
14~15	温度事件上行间隔	uint16	0005	0005 是 0x0005 = 5(十进制)，当温度超过阈值时，位置和传感器数据将每 5 分钟上传一次。
16~17	温度采样间隔	uint16	001e	001e 是 0x001E=30(十进制) 秒每 30 秒检测一次温度。当触发阈值时，上传位置和传感器数据。
18~19	温度阈值最大值	int16	0258	0258 是 0x0258 = 600(十进制)，最大阈值 =600/10=60.0 ℃
20~21	温度阈值最小值	int16	0000	0000 是 0x0000 = 0(十进制)，最小阈值=0/10=0.0 ℃
22	温度阈值规则	uint8	00	00 表示当温度 ≤ 最小阈值时，设备将上传位置和温度事件。 00: 温度 ≤ 最小阈值 01: 温度 ≥ 最大阈值 02: 温度 ≤ 最小阈值且温度 ≥ 最大阈值 03: 最小阈值≤ 温度 ≤最大阈值
23	启用光照事件	uint8	00	00 表示禁用光照事件。 00: 禁用光照事件。 01: 启用光照事件。
24~25	光照事件上行间隔	uint16	0005	0005 是 0x0005 = 5(十进制)，当光照超过阈值时，位置和传感器数据将每 5 分钟上传一次。
26~27	光照采样间隔	uint16	0001	0001是 0x0001=1(十进制) 秒每 1 秒检测一次温度。当触发阈值时，上传位置和传感器数据。
28~29	光照阈值最大值	uint16	0064	0064 是 0x0064 = 100(十进制) % 最大阈值 =100%
30~31	光照阈值最小值	uint16	0000	0000 是 0x0000 = 0(十进制) % 最小阈值=0%
32	光照警告类型	uint8	00	00 表示当光照 ≤ 最小阈值时，设备将上传位置和光照事件。 00: 光照 ≤ 最小阈值 01: 光照 ≥ 最大阈值 02: 光照 ≤ 最小阈值且光照 ≥ 最大阈值 03: 最小阈值≤ 光照 ≤最大阈值

请求定位 -0x85

请求追踪器根据当前配置启动定位并上传。通常在待机模式下使用。

0x85
ID

示例:

85: 请求定位。

设置定位策略 -0x86

0x86	Byte2
ID	定位策略 00: 仅 GNSS 01: 仅 Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi 04: 仅蓝牙 05: 蓝牙 + Wi-Fi 06: 蓝牙 + GNSS 07: 蓝牙 + Wi-Fi + GNSS

8600：将定位策略设置为"仅GNSS"。

请求事件参数 -0x87

0x87
ID

示例：

87：请求事件参数。

请求设备状态包 -0x88

0x88
ID

示例：

88：请求设备状态包（0x01或0x02）。

重启设备 -0x89

0x89
ID

示例：

89：发送命令后，设备重启并重新加入网络。请谨慎使用此命令。

启用温度和光照传感器 -0x8C

启用温度和光照传感器的数据采集和上传。

0x8C	Byte2
ID	打开温度和光照传感器。 00：关闭温度和光照传感器。 01：打开温度和光照传感器。

示例：

8C00：关闭温度和光照传感器。
8C01：打开温度和光照传感器。

启用SOS报警 -0x8D

启用SOS连续模式，快速上传定位，每分钟一次，连续30次后停止，伴有声光报警。

通过关闭命令或双击按键关闭SOS。

0x8D	Byte2
ID	打开SOS。 00：关闭。 01：打开。

示例：

8D00：关闭SOS报警。
8D01：打开SOS报警。

上行数据包解析​

设备状态数据包 - 事件模式 0x01​

设备状态数据包 - 事件模式：0x01​

设备状态数据包 - 周期模式 0x02​

设备状态数据包 - 周期模式：0x02​

心跳数据包 -0x05​

GNSS位置和传感器数据包-0x06​

Wi-Fi位置和传感器数据包-0x07​

蓝牙位置和传感器数据包-0x08​

GNSS 仅位置数据包-0x09​

Wi-Fi 仅位置数据包-0x0A​

仅蓝牙定位数据包-0x0B​

错误代码数据包-0x0D​

定位状态和传感器数据包-0x11​

下行数据包，FPort=5​

设置 SOS 模式 -0x80​

设置上行间隔 -0x81​

打开蜂鸣器 -0x82​

设置工作模式 -0x83​

设置工作模式 -0x84​

请求定位 -0x85​

设置定位策略 -0x86​

请求事件参数 -0x87​

请求设备状态包 -0x88​

重启设备 -0x89​

启用温度和光照传感器 -0x8C​

启用SOS报警 -0x8D​

上行数据包解析

设备状态数据包 - 事件模式 0x01

设备状态数据包 - 事件模式：0x01

设备状态数据包 - 周期模式 0x02

设备状态数据包 - 周期模式：0x02

心跳数据包 -0x05

GNSS位置和传感器数据包-0x06

Wi-Fi位置和传感器数据包-0x07

蓝牙位置和传感器数据包-0x08

GNSS 仅位置数据包-0x09

Wi-Fi 仅位置数据包-0x0A

仅蓝牙定位数据包-0x0B

错误代码数据包-0x0D

定位状态和传感器数据包-0x11

下行数据包，FPort=5

设置 SOS 模式 -0x80

设置上行间隔 -0x81

打开蜂鸣器 -0x82

设置工作模式 -0x83

设置工作模式 -0x84

请求定位 -0x85

设置定位策略 -0x86

请求事件参数 -0x87

请求设备状态包 -0x88

重启设备 -0x89

启用温度和光照传感器 -0x8C

启用SOS报警 -0x8D