Data Packet Format
The following section describes how survey and sensor data is formatted and sent to the gateway. A data packet is sent in LoRa Demo Mode, Survey Single and Survey Sweep Modes if sending is enabled with the +DATA configuration command. The formats are different depending on the specific mode selected.
Overview
The Data Packet Format is a binary format. The first byte of each field is an identifier. From this, the receiver knows how long that particular field is and how to interpret it. All bytes after the identifier are data.
Note: If you are using Node-RED to process the data packets, change the LoRa node to binary mode (the default is UTP-8) .
Demo Mode Fields
| ID |
Name |
# of Bytes |
| 0x05 |
Lux Measured |
2 |
| 0x08 |
Pressure Measured |
3 |
| 0x0B |
Temperature Measured |
2 |
| 0x0E |
Acceleration 3-Axis Measured |
3 |
Survey Single and Sweep Current Fields
| ID |
Name |
# of Bytes |
| 0x1D |
Data Start/Stop |
1 |
| 0x15 |
GPS Latitude |
4 |
| 0x16 |
GPS Longitude |
5 |
| 0x19 |
GPS Lock Status |
1 |
| 0x1A |
QOS Uplink |
4 |
| 0x1B |
QOS Downlink |
3 |
| 0x1D |
Data Start/Stop |
1 |
Field Descriptions
The following section provides a detailed description of each field in the Data Packet Format for LoRa Demo mode.
Lux Measured
| Description |
The measured value of the light sensor. |
| ID |
0x05 |
| Size |
2 |
| Data |
| Index |
Value |
| 0-1 |
Lux Value (Unsigned MSB) |
|
| Direction |
Node -> Gateway |
Pressure Measured
| Description |
The measured value of the barometric pressure. |
| ID |
0x08 |
| Size |
3 |
| Data |
| Index |
Value |
| 0 – 2 |
0.25 Pa (Signed MSB) |
|
| Direction |
Node -> Gateway |
Temperature Measured
| Description |
The measured value of the temperature. |
| ID |
0x0B |
| Size |
2 |
| Data |
| Index |
Value |
| 0 – 1 |
0.0625 Degrees C (Signed MSB) |
|
| Direction |
Node -> Gateway |
Acceleration Measured
| Description |
The measured value of the acceleration. |
| ID |
0x0E |
| Size |
3 |
| Data |
| Index |
Value |
| 0 |
X-Axis 0.0625 g (Signed) |
| 1 |
Y-Axis 0.0625 g (Signed) |
| 2 |
Z-Axis 0.0625 g (Signed) |
|
| Direction |
Node -> Gateway |
The following section provides a detailed description of each field in the Data Packet Format for Survey Single and Survey Sweep mode.
GPS Latitude
| Description |
The GPS latitude. |
| ID |
0x15 |
| Size |
4 |
| Data |
| Index |
Value |
| 0 |
Degrees – Negative is South (Signed) |
| 1 |
Minutes (Unsigned) |
| 2 – 3 |
0.006 Seconds (Unsigned MSB) |
|
| Direction |
Node -> Gateway |
GPS Longitude
| Description |
The GPS longitude |
| ID |
0x16 |
| Size |
5 |
| Data |
| Index |
Value |
| 0 -1 |
Degrees – Negative is West (Signed MSB) |
| 2 |
Minutes (Unsigned) |
| 3-4 |
0.006 Seconds (Unsigned MSB) |
|
| Direction |
Node -> Gateway |
GPS Lock Status
| Description |
The GPS lock status.
Bits 0 – 3 are the lock status:
| 0 |
No GPS device detected. |
| 1 |
No fix |
| 2 |
2D fix – only latitude, longitude, and time are valid |
| 3 |
3D fix – all data valid |
Bits 4 -7 are the number of satellites seen. |
| ID |
0x19 |
| Size |
1 |
| Data |
| Index |
Value |
| 0 |
Compound Data (Unsigned) |
|
| Direction |
Node -> Gateway |
QOS Uplink Status
| Description |
The number of gateways that saw the link check request, the signal margin
above the demodulation floor, and the TX power. |
| ID |
0x1A |
| Size |
4 |
| Data |
| Index |
Value |
| 0 – 1 |
Gateways (Signed MSB) |
| 2 |
Margin (Signed) |
| 3 |
RF Power dBm (Signed) |
|
| Direction |
Node -> Gateway |
QOS Downlink Status
| Description |
The downlink RSSI and SNR values. |
| ID |
0x1B |
| Size |
3 |
| Data |
| Index |
Value |
| 0 – 1 |
RSSI (Signed MSB) |
| 2 |
SNR 0.25 dB Step (Signed) |
|
| Direction |
Node -> Gateway |
Data Start/Stop
| Description |
The start and stop bytes for the packet. |
| ID |
0x1D |
| Direction |
Node -> Gateway |