Communication Protocol
Note: This description refers to the latest firmware in https://github.com/aqua-scope/lorain or firmwares
221001 and up. Your device in hand may have an older firmware with different settings.
The device can be controlled directly via LoRaWAN. For this purpose, different commands are
defined, which are used either 'uplink’, i.e. from the device to the LoRa network, or 'downlink’,
i.e. from the LoRa network to the device. Commands can be cascaded up to the maximum
number of 52 bytes. All values of the command descriptions are bytes, unless otherwise
specified.
Downlink-Commands (using FPort 2):
•
0x03
: Get hardware ID, device answers with uplink command 0x03
•
0x04 PP VV_MSB VV_LSB
: Set configuration parameter PP for new 16 Bit value VV
•
0x1a
: Get firmware version, device answers with uplink command 0x03a
•
0x14 PP
: Get configuration parameter PP, device answers with uplink command 0x04
Uplink-Commands (using FPort 2):
•
0x03 XX YY_MSB, YY_LSB
: Report hardware version XX and device capabilities bitmap YY
•
0x04 PP VV_MSB VV_LSB
: Report 16 Bit Value VV of configuration parameter PP
•
0x06 YY VV_MSB VV_LSB
: Report 16 Bit Sensor Value
•
YY=0x01: Temperature in 0.1 degree Celsius. Please note, the temp sensor is based
on uncalibrated NTC. Therefore it only gives a rough estimate of the temperature.
•
YY=0x03: Uptime in days
•
YY=0x81: Rain level in measurement steps of 0,5 mm water level (example YY =
0x06 0x81 0x03 means 1.5 mm water or 1.5 l/m3).
•
0x0a YY_MSB YY YY YY_LSB
: Report firmware version as 32 Bit value
•
0x0b XX YY ZZ_MSB, ZZ_LSB
: Report alarm state XX (1 or 0) of alarm type YY with optional
value Z. Current alarm types are
•
XX=0x03: sensor alarm (Z is seconds between two events: 0.5 mm within Z s.),
•
XX=0x0c: battery alarm
•
0x12 XX YY_MSB, YY_LSB
: Battery status, XX = voltage in 100 mV, YY Consumption since
reboot in mAh
Configuration Parameters
Parameter 2 – Heartbeat Interval
This parameter defines after how many measurement intervals the sensor will send a report
regardless of rainfall. The factory default is 24 which translates together with the default value
of parameter #1 (900 seconds = 15 minutes) into 24 * 15 minutes = 6 hours.
Parameter 3 – Heavy Rain Threshold
This parameter defines the heavy rain level as time interval (in seconds) for 0.5 mm rain. The
default value of 120 means that 0.5 in 120 seconds or less will cause heavy rain alarm. This
translates into 15 liter/h.
Parameter 4 – Measurement Interval in Seconds
In case of rain the device reports regularly to the LORA network. This parameter defines the time
interval for these reports in sec. The default is 900 = 15 minutes. The value range is 10 – 60000.
Parameter 5 – Calibration of Temperature Sensor
This parameter allows a linear correction of the reported temperature value. The default value is
100.