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
0×05 Lux Measured 2
0×08 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
0×15 GPS Latitude 4
0×16 GPS Longitude 5
0×19 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  0×05
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  0×08
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  0×15
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  0×16
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  0×19
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