Payload Format
Uplink Packet Parsing
The Tracker data protocol provides different packets to correspond to different information, and the number of bytes of each packet may vary. The structure of the frame is shown in the image below. The frame content is sent in big-endian byte order.
Data ID | Data Value |
---|---|
1 byte | 50 bytes (Max) |
Data ID: Function number. Data Value: Position, sensor data an d other information.
Device Status Packet -Event Mode 0x01
The Device Status Packet is uploaded when join LoRaWAN network. The Device Status packet has two packet formats in different working modes:
1) Event Mode, ID=0x01
1) Periodic Mode, ID= 0x02
Device Status Packet -Event Mode: 0x01
0x01 | Byte2 | Byte3~4 | Byte5~6 | Byte7 | Byte8 | Byte9~10 | Byte11~12 |
---|---|---|---|---|---|---|---|
ID | Battery level | Software version | Hardware version | Work mode | Positioning strategy | Heartbeat interval | Uplink interval |
Byte13~14 | Byte15 | Byte16 | Byte17 | Byte18~19 | Byte20~21 |
---|---|---|---|---|---|
Event mode uplink interval | Temp&light switch | SOS mode | Enable motion event | 3-axis motion threshold | Motion start interval |
Byte22 | Byte23~24 | Byte25 | Byte26~27 | Byte28 | Byte29~30 |
---|---|---|---|---|---|
Enable motionless event | Motionless timeout | Enable shock event | 3-axis shock threshold | Enable temperature event | Temperature event uplink interval |
Byte31~32 | Byte33~34 | Byte35~36 | Byte37 | Byte38 | Byte39~40 |
---|---|---|---|---|---|
Temperature sample interval | Temperature threshold max | Temperature threshold min | Temperature warning type | Enable light event | Light event uplink interval |
Byte41~42 | Byte43~44 | Byte45~46 | Byte47 |
---|---|---|---|
Light sample interval | Light threshold max | Light threshold min | Light warning type |
The raw payload:
0153010501050207001e00050005010000001e000500016801012c000005001e025800000000000500010064000000
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 01 | 01 is the packet ID. |
2 | Battery level | uint8 | 53 | 53 is 0x53 = 83(DEC) The battery level is 83% |
3~4 | Software version | uint16 | 0105 | 0105 is 0x0105 == v1.5 The software version is v1.5 |
5~6 | Hardware version | uint16 | 0105 | 0105 is 0x0105 == v1.5 The hardware version is v1.5 |
7 | Work mode | uint8 | 02 | 02 is 0x02, means the device use “Event mode”. 00: Standby mode 01: Periodic mode 02: Event mode |
8 | Positioning strategy | uint8 | 07 | 07 is 0x07, means the device use Bluetooth + Wi-Fi + GNSS positioning strategy. 00: Only GNSS 01: Only Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi 04: Only Bluetooth 05: Bluetooth + Wi-Fi 06: Bluetooth + GNSS 07: Bluetooth + Wi-Fi + GNSS |
9~10 | Heartbeat interval | uint16 | 001e | 001e is 0x001E = 30(DEC), the heartbeat interval is 30 minutes. |
11~12 | Uplink Interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), the uplink interval is 5 minutes. |
13~14 | Event mode uplink interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), the event mode uplink interval is 5 minutes. |
15 | Temp&light switch | uint8 | 01 | 01 means open the temperature and light sensor. 00: Close the temperature and light sensor. 01: Open the temperature and light sensor. |
16 | SOS mode | uint8 | 00 | 00 means use SOS single mode. 00: use SOS single mode. 01: use SOS continuous mode. |
17 | Enable motion event | uint8 | 00 | 00 means disable Event mode. 00: disable Event mode. 01: enable Event mode. |
18~19 | 3-Axis motion threshold | uint16 | 001e | 001e is 0x001E=30(DEC) mg When the acceleration exceeds 30mg, determine that the device is in motion, when it is 2 minutes below this value, determine that the device is in motionless. |
20~21 | Motion start interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), when device is on motion, the interval is 5 minutes. |
22 | Enable motionless event | uint8 | 00 | 00 means disable motionless event. 00: disable motionless event. 01: enable motionless event. |
23~24 | Motionless timeout | uint16 | 0168 | 0168 is 0x0168 = 360(DEC), when the device is stationary in a location for more than 360 minutes, a motionless timeout event is triggered. |
25 | Enable shock event | uint8 | 01 | 01 means enable shock event. 00: disable shock event. 01: enable shock event. |
26~27 | 3-Axis shock threshold | uint16 | 012c | 012c is 0x012C=300(DEC) mg When the acceleration exceeds 300mg, the shock event is triggered. |
28 | Enable temperature event | uint8 | 00 | 00 means enable shock event. 00: disable shock event. 01: enable shock event. |
29~30 | Temperature event uplink interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), when the temperature exceeds the threshold, the location and sensor data will upload every 5 minutes. |
31~32 | Temperature sample interval | uint16 | 001e | 001e is 0x001E=30(DEC) seconds The temperature is detected every 30 seconds. When the threshold is triggered, upload location and sensor data. |
33~34 | Temperature threshold max | int16 | 0258 | 0258 is 0x0258 = 600(DEC), Maximum threshold =600/10=60.0 ℃ |
35~36 | Temperature threshold min | int16 | 0000 | 0000 is 0x0000 = 0(DEC), Minimum threshold=0/10=0.0 ℃ |
37 | Temperature threshold rule | uint8 | 00 | 00 means when temperature ≤ min threshold, device will upload location and temperature event. 00: temp ≤ min threshold 01: temp ≥ max threshold 02: temp ≤ min threshold and temp ≥ max threshold 03: min threshold≤ temp ≤max threshold |
38 | Enable light event | uint8 | 00 | 00 means disable light event. 00: disable light event. 01: enable light event. |
39~40 | Light event uplink interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), when the light exceeds the threshold, the location and sensor data will upload every 5 minutes. |
41~42 | Light sample interval | uint16 | 0001 | 0001is 0x0001=1(DEC) seconds The temperature is detected every 1 seconds. When the threshold is triggered, upload location and sensor data. |
43~44 | Light threshold max | uint16 | 0064 | 0064 is 0x0064 = 100(DEC) % Maximum threshold =100% |
45~46 | Light threshold min | uint16 | 0000 | 0000 is 0x0000 = 0(DEC) % Minimum threshold=0% |
47 | Light warning type | uint8 | 00 | 00 means when light ≤ min threshold, device will upload location and light event. 00: light ≤ min threshold 01: light ≥ max threshold 02: light ≤ min threshold and light ≥ max threshold 03: min threshold≤ light ≤max threshold |
Device Status Packet -Periodic Mode 0x02
The Device Status package is uploaded when join LoRaWAN network. The Device Status packet has two packet formats in different working modes:
1) Event Mode, ID=0x01
1) Periodic Mode, ID= 0x02
Device Status Packet -Periodic Mode: 0x02
0x02 | Byte2 | Byte3~4 | Byte5~6 | Byte7 | Byte8 | Byte9~10 | Byte11~12 |
---|---|---|---|---|---|---|---|
ID | battery level | software version | hardware version | work mode | positioning strategy | heartbeat interval | uplink Interval |
Byte13~14 | Byte15 | Byte16 |
---|---|---|
event mode uplink interval | temp&light switch | SOS mode |
The raw payload:
025601050105010002d0003c003c0000
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 02 | 02 is the packet ID. |
2 | Battery level | uint8 | 56 | 56 is 0x56 = 86(DEC) The battery level is 86% |
3~4 | Software version | uint16 | 0105 | 0105 is 0x0105 == v1.5 The software version is v1.5 |
5~6 | Hardware version | uint16 | 0105 | 0105 is 0x0105 == v1.5 The hardware version is v1.5 |
7 | Work mode | uint8 | 01 | 01 is 0x01, means the device use “Periodic mode”. 00: Standby mode 01: Periodic mode 02: Event mode |
8 | Positioning strategy | uint8 | 00 | 00 is 0x01, means the device use “GNSS only” positioning strategy. 00: Only GNSS 01: Only Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi 04: Only Bluetooth 05: Bluetooth + Wi-Fi 06: Bluetooth + GNSS 07: Bluetooth + Wi-Fi + GNSS |
9~10 | Heartbeat interval | uint16 | 02d0 | 02d0 is 0x02D0 = 720(DEC) minutes, the heartbeat interval is 720 minutes. |
11~12 | Uplink Interval | uint16 | 003c | 003c is 0x003C = 60(DEC) minutes, the uplink interval is 60 minutes. |
13~14 | Event mode uplink interval | uint16 | 003c | 003c is 0x003C = 60(DEC), the event mode uplink interval is 60 minutes. |
15 | Temp&light switch | uint8 | 00 | 00 means open the temperature and light sensor. 00: Close the temperature and light sensor. 01: Open the temperature and light sensor. |
16 | SOS mode | uint8 | 00 | 00 means use SOS single mode. 00: use SOS single mode. 01: use SOS continuous mode. |
Heartbeat Packet -0x05
When no data is uploaded by the device within the heartbeat interval, a heartbeat packet will be triggered. This packet only contains battery information.
0x05 | Byte2 | Byte3 | Byte4 | Byte5 |
---|---|---|---|---|
ID | battery level | work mode | positioning strategy | SOS mode |
The raw payload:
0564010001
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 05 | 05 is the packet ID. |
2 | Battery level | uint8 | 64 | 64 is 0x64 = 100(DEC) The battery level is 100% |
3 | Work mode | uint8 | 01 | 01 is 0x01, means the device use “Periodic mode”. 00: Standby mode 01: Periodic mode 02: Event mode |
4 | Positioning strategy | uint8 | 00 | 00 is 0x01, means the device use “GNSS only” positioning strategy. 00: Only GNSS 01: Only Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi 04: Only Bluetooth 05: Bluetooth + Wi-Fi 06: Bluetooth + GNSS 07: Bluetooth + Wi-Fi + GNSS |
5 | SOS mode | uint8 | 00 | 00 means use SOS single mode. 00: use SOS single mode. 01: use SOS continuous mode. |
GNSS Location and Sensor Packet-0x06
ID 0x06 is used to upload GNSS location, sensor data and battery.
0x06 | Byte2~4 | Byte5 | Byte6~9 | Byte10~13 | Byte14~17 |
---|---|---|---|---|---|
ID | event status | motion segment number | UTC time | longitude | latitude |
Byte18~19 | Byte20~21 | Byte22 |
---|---|---|
Temperature | Light | battery level |
The raw payload:
06000008006462248d06ca502801587ec600fe000057
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 06 | 06 is the packet ID. |
2~4 | event status | uint24 | 000008 | 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
5 | Motion segment number | uint8 | 00 | 00 is 0x00 == 0. When the motion begins, the count increases by 1. Record that this is a movement. |
6~9 | UTC time | uint32 | 6462248d | 6462248d is 0x6462248D = 1684153485(DEC) seconds. Convert it to Beijing Time: 2023-05-15 20:24:45 |
10~13 | Longitude | int32 | 06ca5028 | 06ca5028 is 0x06CA5028 = 113922088(DEC), the longitude= 113922088/1000000=113.922088 |
14~17 | Latitude | int32 | 01587ec6 | 01587ec6 is 0x01587EC6 = 22576838(DEC), the Latitude = 22576838/1000000=22.576838 |
18~19 | Temperature | int16 | 00fe | 00fe is 0x00FE = 254(DEC), temperature=254/10=25.4℃ |
20~21 | Light | uint16 | 0000 | 0000 is 0x0000 = 0(DEC) minutes, the light=0=0% |
22 | Battery level | uint8 | 57 | 57 is 0x57 = 87(DEC) The battery level is 87% |
Wi-Fi Location and Sensor Packet-0x07
ID 0x07 is used to upload Wi-Fi Mac addresses, sensor data and battery.
0x07 | Byte2~4 | Byte5 | Byte6~9 | Byte10~15 | Byte16 |
---|---|---|---|---|---|
ID | event status | motion segment number | UTC time | MAC address 1 | The RSSI of MAC address 1, int8 |
Byte17~22 | Byte23 | Byte24~29 | Byte30 | Byte31~36 | Byte37 |
---|---|---|---|---|---|
MAC address 2 | The RSSI of MAC address 2, int8 | MAC address 3 | The RSSI of MAC address 3, int8 | MAC address 4 | The RSSI of MAC address 4, int8 |
Byte38~39 | Byte40~41 | Byte42 |
---|---|---|
Temperature | Light | battery level |
The raw payload:
070000080064622472487397162234bb3ccd5798fd2ebc74cf002f3ad0a9ec26ca022958b900fe000057
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 07 | 07 is the packet ID. |
2~4 | event status | uint24 | 000008 | 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
5 | Motion segment number | uint8 | 00 | 00 is 0x00 == 0. When the motion begins, the count increases by 1. Record that this is a movement. |
6~9 | UTC time | uint32 | 64622472 | 64622472 is 0x64622472 = 1684153458 (DEC) seconds. Convert it to Beijing Time: 2023-05-15 20:24:18 |
10~15 | MAC address 1 | ---- | 487397162234 | 487397162234 the MAC address (HEX)= 48:73:97:16:22:34 |
16 | The RSSI of MAC address 1 | int8 | bb | bb is 0xBB = -69(DEC), the type is int8 the RSSI = -69 |
17~22 | MAC address 2 | ---- | 3ccd5798fd2e | 3ccd5798fd2e the MAC address (HEX)= 3C:CD:57:98:FD:2E |
23 | The RSSI of MAC address 2 | int8 | bc | bc is 0xBC = -68(DEC), the type is int8 the RSSI = -68 |
24~29 | MAC address 3 | ---- | 74cf002f3ad0 | 74cf002f3ad0 the MAC address (HEX)= 74:CF:00:2F:3A:D0 |
30 | The RSSI of MAC address 3 | int8 | a9 | a9 is 0xA9 = -87(DEC), the type is int8 the RSSI = -87 |
31~36 | MAC address 4 | ---- | ec26ca022958 | ec26ca022958 the MAC address (HEX)= EC:26:CA:02:29:58 |
37 | The RSSI of MAC address 4 | int8 | b9 | b9 is 0xA9 = -71(DEC), the type is int8 the RSSI = -71 |
38~39 | Temperature | int16 | 00fe | 00fe is 0x00FE = 254(DEC), temperature=254/10=25.4℃ |
40~41 | Light | uint16 | 0000 | 0000 is 0x0000 = 0(DEC) minutes, the light=0=0% |
42 | battery level | uint8 | 57 | 57 is 0x57 = 87(DEC) The battery level is 87% |
Bluetooth Location and Sensor Packet-0x08
ID 0x08 is used to upload Bluetooth Beacon MAC addresses, sensor data and battery.
0x08 | Byte2~4 | Byte5 | Byte6~9 | Byte10~15 | Byte16 |
---|---|---|---|---|---|
ID | event status | motion segment number | UTC time | MAC address 1 | The RSSI of MAC address 1, int8 |
Byte17~22 | Byte23 | Byte24~29 | Byte30 | Byte31~32 | Byte33~34 | Byte 35 |
---|---|---|---|---|---|---|
MAC address 2 | The RSSI of MAC address 2, int8 | MAC address 3 | The RSSI of MAC address 3, int8 | Temperature | light | battery level |
The raw payload:
0800000800646225bb5162d2c1b9d3ca1b5bd2afeae5c0d0e2d70529e8c900fa000057
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 08 | 08 is the packet ID. |
2~4 | event status | uint24 | 000008 | 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
5 | Motion segment number | uint8 | 00 | 00 is 0x00 == 0. When the motion begins, the count increases by 1. Record that this is a movement. |
6~9 | UTC time | uint32 | 646225bb | 646225bb is 0x646225BB = 1684153787 (DEC) seconds. Convert it to Beijing Time: 2023-05-15 20:29:47 |
10~15 | MAC address 1 | ----- | 5162d2c1b9d3 | 5162d2c1b9d3 the MAC address (HEX)=51:62:D2:C1:B9:D3 |
16 | The RSSI of MAC address 1 | int8 | c0 | c0 is 0xC0 = -64(DEC), the type is int8 the RSSI = -64 |
17~22 | MAC address 2 | ----- | 1b5bd2afeae5 | 1b5bd2afeae5 the MAC address (HEX)= 1B:5B:D2:AF:EA:E5 |
23 | The RSSI of MAC address 2 | int8 | bc | bc is 0xBC = -68(DEC), the type is int8 the RSSI = -68 |
24~29 | MAC address 3 | ----- | d0e2d70529e8 | d0e2d70529e8 the MAC address (HEX)= D0:E2:D7:05:29:E8 |
30 | The RSSI of MAC address 3 | int8 | c9 | c9 is 0xC9 = -55(DEC), the type is int8 the RSSI = -55 |
31~32 | Temperature | int16 | 00fa | 00fa is 0x00FA = 250(DEC), temperature=254/10=25.0℃ |
33~34 | Light | uint16 | 0000 | 0000 is 0x0000 = 0(DEC) minutes, the light=0=0% |
35 | battery level | uint8 | 57 | 57 is 0x57 = 87(DEC) The battery level is 87% |
GNSS Location Only Packet-0x09
When the sensor is turned off, the device does not upload the sensor measurement value. Only the location data is uploaded.
0x09 | Byte2~4 | Byte5 | Byte6~9 | Byte10~13 | Byte14~17 | Byte18 |
---|---|---|---|---|---|---|
ID | event status | motion segment number | UTC time | longitude | latitude | battery level |
The raw payload:
09000000006463186806ca506801587e4c56
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 09 | 09 is the packet ID. |
2~4 | event status | uint24 | 000000 | 000000 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
5 | Motion segment number | uint8 | 00 | 00 is 0x00 == 0. When the motion begins, the count increases by 1. Record that this is a movement. |
6~9 | UTC time | uint32 | 64631868 | 64631868 is 0x64631868 = 1684215912 (DEC) seconds. Convert it to Beijing Time: 2023-05-16 13:45:12 |
10~13 | Longitude | int32 | 06ca5068 | 06ca5068 is 0x06CA5068 = 113922152 (DEC), the longitude= 113922152/1000000=113.922152 |
14~17 | Latitude | int32 | 01587e4c | 01587e4c is 0x01587E4C = 22576716 (DEC), the Latitude = 22576716/1000000=22.576716 |
18 | Battery level | uint8 | 56 | 56 is 0x56 = 86(DEC) The battery level is 86% |
Wi-Fi Location Only Packet-0x0A
0x0A | Byte2~4 | Byte5 | Byte6~9 | Byte10~15 | Byte16 |
---|---|---|---|---|---|
ID | event status | motion segment number | UTC time | MAC address 1 | The RSSI of MAC address 1, int8 |
Byte17~22 | Byte23 | Byte24~29 | Byte30 | Byte31~36 | Byte37 | Byte38 |
---|---|---|---|---|---|---|
MAC address 2 | The RSSI of MAC address 2, int8 | MAC address 3 | The RSSI of MAC address 3, int8 | MAC address 4 | The RSSI of MAC address 4, int8 | battery level |
The raw payload:
0A0000080064622472487397162234bb3ccd5798fd2ebc74cf002f3ad0a9ec26ca022958b957
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 0A | 0A is the packet ID. |
2~4 | event status | uint32 | 000008 | 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
5 | Motion segment number | uint8 | 00 | 00 is 0x00 == 0. When the motion begins, the count increases by 1. Record that this is a movement. |
6~9 | UTC time | uint32 | 64622472 | 64622472 is 0x64622472 = 1684153458 (DEC) seconds. Convert it to Beijing Time: 2023-05-15 20:24:18 |
10~15 | MAC address 1 | ----- | 487397162234 | 487397162234 the MAC address (HEX)= 48:73:97:16:22:34 |
16 | The RSSI of MAC address 1 | int8 | bb | bb is 0xBB = -69(DEC), the type is int8 the RSSI = -69 |
17~22 | MAC address 2 | ----- | 3ccd5798fd2e | 3ccd5798fd2e the MAC address (HEX)= 3C:CD:57:98:FD:2E |
23 | The RSSI of MAC address 2 | int8 | bc | bc is 0xBC = -68(DEC), the type is int8 the RSSI = -68 |
24~29 | MAC address 3 | ----- | 74cf002f3ad0 | 74cf002f3ad0 the MAC address (HEX)= 74:CF:00:2F:3A:D0 |
30 | The RSSI of MAC address 3 | int8 | a9 | a9 is 0xA9 = -87(DEC), the type is int8 the RSSI = -87 |
31~36 | MAC address 4 | ----- | ec26ca022958 | ec26ca022958 the MAC address (HEX)= EC:26:CA:02:29:58 |
37 | The RSSI of MAC address 4, int8 | int8 | b9 | b9 is 0xA9 = -71(DEC), the type is int8 the RSSI = -71 |
38 | battery level | uint8 | 57 | 57 is 0x57 = 87(DEC) The battery level is 87% |
Bluetooth Location Only Packet-0x0B
0x0B | Byte2~4 | Byte5 | Byte6~9 | Byte10~15 | Byte16 |
---|---|---|---|---|---|
ID | event status | motion segment number | UTC time | MAC address 1 | The RSSI of MAC address 1, int8 |
Byte17~22 | Byte23 | Byte24~29 | Byte30 | Byte31 |
---|---|---|---|---|
MAC address 2 | The RSSI of MAC address 2, int8 | MAC address 3 | The RSSI of MAC address 3, int8 | battery level |
The raw payload:
0B00000800646225bb5162d2c1b9d3ca1b5bd2afeae5c0d0e2d70529e8c957
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 0B | 0B is the packet ID. |
2~4 | event status | uint24 | 000008 | 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
5 | Motion segment number | uint8 | 00 | 00 is 0x00 == 0. When the motion begins, the count increases by 1. Record that this is a movement. |
6~9 | UTC time | uint32 | 646225bb | 646225bb is 0x646225BB = 1684153787 (DEC) seconds. Convert it to Beijing Time: 2023-05-15 20:29:47 |
10~15 | MAC address 1 | ----- | 5162d2c1b9d3 | 5162d2c1b9d3 the MAC address (HEX)=51:62:D2:C1:B9:D3 |
16 | The RSSI of MAC address 1, int8 | int8 | c0 | c0 is 0xC0 = -64(DEC), the type is int8 the RSSI = -64 |
17~22 | MAC address 2 | ----- | 1b5bd2afeae5 | 1b5bd2afeae5 the MAC address (HEX)= 1B:5B:D2:AF:EA:E5 |
23 | The RSSI of MAC address 2, int8 | int8 | bc | bc is 0xBC = -68(DEC), the type is int8 the RSSI = -68 |
24~29 | MAC address 3 | ----- | d0e2d70529e8 | d0e2d70529e8 the MAC address (HEX)= D0:E2:D7:05:29:E8 |
30 | The RSSI of MAC address 3, int8 | int8 | c9 | c9 is 0xC9 = -55(DEC), the type is int8 the RSSI = -55 |
31 | battery level | uint8 | 57 | 57 is 0x57 = 87(DEC) The battery level is 87% |
Error Code Packet-0x0D
ID 0x0D packet is used to upload the error code.
The raw payload:
0D00000001
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 0D | 0D is the packet ID. |
2~5 | Error code | uint32 | 00000001 | 0x00000001: UTC time acquisition failed 0x00000002: Almanac too old 0x00000003: Doppler error |
Positioning Status and Sensor Packet-0x11
ID 0x11 is used to upload the positioning status, sensor data and battery.
The raw payload:
110100000064a763a0014100002f
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 11 | 11 is the packet ID. |
2 | Positioning status | uint8 | 01 | 00: Positioning successful 01: The GNSS scan timed out and failed to obtain the location. 02: The Wi-Fi scan timed out and failed to obtain the location. 03: The Wi-Fi + GNSS scan timed out and failed to obtain the location. 04: The GNSS + Wi-Fi scan timed out and failed to obtain the location. 05: The Bluetooth scan timed out and failed to obtain the location. 06: The Bluetooth + Wi-Fi scan timed out and failed to obtain the location. 07: The Bluetooth + GNSS scan timed out and failed to obtain the location. 08: The Bluetooth + Wi-Fi + GNSS scan timed out and failed to obtain the location. 09: Location Server failed to parse the GNSS location. 0A: Location Server failed to parse the Wi-Fi location. 0B: Location Server failed to parse the Bluetooth location. 0C: Failed to parse the GNSS location due to the poor accuracy. 0D: Time synchronization failed. 0E: Failed to obtain positioning due to the old Almanac. |
3~5 | Event status | uint24 | 000000 | 000000 is 0x000000, 0x0000XX is reserved and 0x00 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event. Bit7: SOS event. Bit8: Press once event. Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. 0x000080: Press once event. |
6~9 | UTC Timestamp | uint32 | 64a763a0 | 64a763a0 is 0x64a763a0 = 1688691616 (DEC) seconds. Convert it to Beijing Time: 2023-07-07 09:00:16 |
10~11 | Temperature | int16 | 0141 | 0141 is 0x0141 = 321(DEC), temperature=321/10=32.1℃ |
12~13 | Light | uint16 | 0000 | 0000 is 0x0000 = 0(DEC) minutes, the light=0=0% |
14 | Battery level | uint8 | 2F | 2F is 0x2F = 47(DEC) The battery level is 47% |
Downlink Packet, FPort=5
The tracker supports LoRaWAN to downlink some commands to adjust parameters. If the device is hibernated, the downlink command takes effect the next time the device wakes up to upload data.
Note: FPort=5
Setting the SOS Mode -0x80
0x80 | Byte2 |
---|---|
ID | SOS mode 0: single mode 1: continuous mode |
8001: set SOS to single mode.
8002: set SOS to continuous mode.
Setting the Uplink Interval -0x81
0x81 | Byte2~3 | Byte4~5 | Byte6~7 |
---|---|---|---|
ID | Heartbeat uplink interval 0000: Keep current configuration Unit: minutes | Periodic mode uplink interval 0000: Keep current configuration Unit: minutes | Event mode uplink interval 0000: Keep current configuration Unit: minutes |
Example: set the periodic mode interval to 30 minutes
Command: 810000001E0000
Open the buzzer -0x82
After sending this command, a buzzer alarm tone will be turned on after the device wakes up and will continue to sound for 1 minute.
0x82 | Byte2 |
---|---|
ID | Open the buzzer. 00: close 01: open |
8200: close the buzzer
8201: open the buzzer
Setting the Work Mode -0x83
0x83 | Byte2 |
---|---|
ID | Open the buzzer. 00: standby mode 01: periodic mode 02: event mode |
8300: set work mode to standby mode
8301: set work mode to periodic mode
8302: set work mode to event mode
Setting the Work Mode -0x84
0x84 | Byte2 | Byte3~4 | Byte5~6 | Byte7 | Byte8~9 |
---|---|---|---|---|---|
ID | enable motion event | 3-Axis motion threshold | motion start interval | enable motionless event | motionless timeout |
Byte10 | Byte11~12 | Byte13 | Byte14~15 | Byte16~17 | Byte18~19 |
---|---|---|---|---|---|
enable shock event | 3-Axis shock threshold | enable temperature event | temperature event uplink interval | temperature sample interval | temperature threshold max |
Byte20~21 | Byte22 | Byte23 | Byte24~25 | Byte26~27 | Byte28~29 |
---|---|---|---|---|---|
Temperature threshold min | Temperature warning type | Enable light event | light event uplink interval | light sample interval | light threshold max |
Byte30~31 | Byte32 |
---|---|
light threshold min | light warning type |
The command:
8400001e000500016801012c000005001e025800000000000500010064000000
Byte | Value | Type | Raw Data | Description |
---|---|---|---|---|
1 | Frame ID | uint8 | 84 | 84 is the packet ID. |
2 | Enable motion event | uint8 | 00 | 00 means disable Event mode. 00: disable Event mode. 01: enable Event mode. |
3~4 | 3-Axis motion threshold | uint16 | 001e | 001e is 0x001E=30(DEC) mg When the acceleration exceeds 30mg, determine that the device is in motion, when it is 2 minutes below this value, determine that the device is in motionless. |
5~6 | Motion start interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), when device is on motion, the interval is 5 minutes. |
7 | Enable motionless event | uint8 | 00 | 00 means disable motionless event. 00: disable motionless event. 01: enable motionless event. |
8~9 | Motionless timeout | uint16 | 0168 | 0168 is 0x0168 = 360(DEC), when the device is stationary in a location for more than 360 minutes, a motionless timeout event is triggered. |
10 | Enable shock event | uint8 | 01 | 01 means enable shock event. 00: disable shock event. 01: enable shock event. |
11~12 | 3-Axis shock threshold | uint16 | 012c | 012c is 0x012C=300(DEC) mg When the acceleration exceeds 300mg, the shock event is triggered. |
13 | Enable temperature event | uint8 | 00 | 00 means enable shock event. 00: disable shock event. 01: enable shock event. |
14~15 | Temperature event uplink interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), when the temperature exceeds the threshold, the location and sensor data will upload every 5 minutes. |
16~17 | Temperature sample interval | uint16 | 001e | 001e is 0x001E=30(DEC) seconds The temperature is detected every 30 seconds. When the threshold is triggered, upload location and sensor data. |
18~19 | Temperature threshold max | int16 | 0258 | 0258 is 0x0258 = 600(DEC), Maximum threshold =600/10=60.0 ℃ |
20~21 | Temperature threshold min | int16 | 0000 | 0000 is 0x0000 = 0(DEC), Minimum threshold=0/10=0.0 ℃ |
22 | Temperature threshold rule | uint8 | 00 | 00 means when temperature ≤ min threshold, device will upload location and temperature event. 00: temp ≤ min threshold 01: temp ≥ max threshold 02: temp ≤ min threshold and temp ≥ max threshold 03: min threshold≤ temp ≤max threshold |
23 | Enable light event | uint8 | 00 | 00 means disable light event. 00: disable light event. 01: enable light event. |
24~25 | Light event uplink interval | uint16 | 0005 | 0005 is 0x0005 = 5(DEC), when the light exceeds the threshold, the location and sensor data will upload every 5 minutes. |
26~27 | Light sample interval | uint16 | 0001 | 0001is 0x0001=1(DEC) seconds The temperature is detected every 1 seconds. When the threshold is triggered, upload location and sensor data. |
28~29 | Light threshold max | uint16 | 0064 | 0064 is 0x0064 = 100(DEC) % Maximum threshold =100% |
30~31 | Light threshold min | uint16 | 0000 | 0000 is 0x0000 = 0(DEC) % Minimum threshold=0% |
32 | Light warning type | uint8 | 00 | 00 means when light ≤ min threshold, device will upload location and light event. 00: light ≤ min threshold 01: light ≥ max threshold 02: light ≤ min threshold and light ≥ max threshold 03: min threshold≤ light ≤max threshold |
Request Location -0x85
The request tracker initiates location and uploads based on the current configuration. It is usually used in standby mode.
0x85 |
---|
ID |
Example:
85: request location.
Setting Positioning strategy -0x86
0x86 | Byte2 |
---|---|
ID | Positioning strategy 00: Only GNSS 01: Only Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi 04: Only Bluetooth 05: Bluetooth + Wi-Fi 06: Bluetooth + GNSS 07: Bluetooth + Wi-Fi + GNSS |
Example:
8600: Set the positioning strategy to “Only GNSS”.
Request Event Parameters -0x87
0x87 |
---|
ID |
Example:
85: request event parameters.
Request Device Status Packet -0x88
0x88 |
---|
ID |
Example:
88: request Device Status packet(0x01 or 0x02).
Reboot Device -0x89
0x89 |
---|
ID |
Example:
89: After the command is sent, the device reboots and join the network again. Please use this command with caution.
Enable Temperature and Light Sensor -0x8C
Enable data collection and upload for the temperature and light sensor.
0x83 | Byte2 |
---|---|
ID | Open the temperature and light sensor. 00: Close the temperature and light sensor. 01: Open the temperature and light sensor. |
Example:
8300: Close the temperature and light sensor.
8301: Open the temperature and light sensor.
Enable SOS Alarm -0x8D
Enable SOS continuous mode, upload positioning quickly, once every minute, stop after 30 consecutive times, accompanied by sound and light alarm.
Turn off SOS by closing the command or by double clicking the key.
0x8D | Byte2 |
---|---|
ID | Open the SOS. 00: Close. 01: Open. |
Example:
8D00: Close the SOS alarm.
8D01: Open the SOS alarm.