LoRaWAN communication
General uplink payload structure
Byte 0
Byte 1
Byte 2
Byte 3
Byte 4
Byte 5
Distance data
MSB
Distance data
LSB
Material
level
percentage
Battery
Voltage
MSB
Battery
Voltage
LSB
Error Code
MSB = most significant byte, LSB = least significant byte
Error codes bit structure
Certain error codes will be detected and reported by the firmware using the last byte of the
LoRa payload (byte 5). Each bit in the byte represents an error as described below.
BIT 7
BIT 6
BIT 5
BIT 4
BIT 3
BIT 2
BIT 1
BIT 0
RFU
RFU
RFU
RFU
TOF-TIM
EOUT
BATTERY
LORA_LO
W_POWE
R_FAIL
WDT_RES
ET
RFU = reserved for future use
Data output definition
1 - Distance data : raw distance measurements performed by the onboard ToF sensor.
Output is provided in millimeters. Possible outputs under distance data include:
Output type
Output
(decimal)
Output
(hexadecimal)
Meaning
Valid reading
500 to 60000
0x1F4 - 0xEA60
ToF sensor successfully registered a
distance measurement
Target too close
0
0x0000
Detected target is closer than the
minimum range of the ToF sensor
(50cm)
Target too far
65535
0xFFFF
Detected target is farther than the
maximum range of the ToF sensor
(60m)
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
31/36
