Version 1.0 (2021-03-12)

This document describes the downlink possibilities of the IoT SoundSensor, and also contains the encryption and decryption-logic in Javascript.
Tip: Press [F12] and watch console for detailed info.

Examples in the source of this page: This document contains several functions that are copied from our working codebase. Because your local telecom provider probably differs from KPN Telecom (Dutch), you can use it as pseudo-code.

• Pseudo code for transmitting KPN downlink message (Dutch telecom provider)
• Pseudo code for composing settings downlink message
• Pseudo code for validating ACK uplink message
• Parsing example of the settings uplink message

There are two downlink possibilities: transmit settings to the IoT SoundSensor and request settings from the IoT SoundSensor. After transmitting an uplink, the sensor opens a window to receive a downlink. Be aware that it can take 1 LoRa transmission interval length before the sensor can receive a downlink.

Transmit settings
After the sensor receives the settings, the sensor transmits an ACK uplink message (acknowledgement). This ACK message contains a CRC value. This value is calculated by the sensor and based on its current settings. You should use this CRC value to validate if your downlink configuration attempt succeeded.
The CRC value calculation: Polynomial is 0x8005 (Koopman calls this ANSI-16 0xC002), see Javascript for example.

The settings payload format (14 bytes):

byte index	value
0	message type (0x02)
1 - 4	transmit interval in ms (60000 - 3600000)
5	sample count
6	correction (-6.0 - 6.0, transmitted as byte)
7	dB(A) fast bit, dB(A) slow bit, dB(C) fast bit, dB(C) slow bit, Leq(A) bit, Leq(C) bit, Positive Peak Hold (A) bit, Postive Peak Hold(C) bit
8	Negative Peak Hold (A) bit, Negative Peak Hold (C) bit, Bat bit, First Timestamp bit, Last Timestamp bit, Message Info bit, LED bit, Headphone bit
9	GPS Mode: OFF (0x00), ONCE (0x01), INTERVAL (0x02)
10 - 13	GPS interval in ms (3600000 - 43200000)

The ack payload format (3 bytes):

byte index	value
0	message type (0xC0)
1 - 2	CRC value

Request settings
After the sensor receives the settings request, the sensor transmits its settings.

The request payload format (1 byte):

byte index	value
0	message type (0x04)

The settings payload format (14 bytes, same as transmit message):

byte index	value
0	message type (0x80)
1 - 4	transmit interval in ms (60000 - 3600000)
5	sample count
6	correction (-6.0 - 6.0, transmitted as byte)
7	dB(A) fast bit, dB(A) slow bit, dB(C) fast bit, dB(C) slow bit, Leq(A) bit, Leq(C) bit, Positive Peak Hold (A) bit, Postive Peak Hold(C) bit
8	Negative Peak Hold (A) bit, Negative Peak Hold (C) bit, Bat bit, First Timestamp bit, Last Timestamp bit, Message Info bit, LED bit, Headphone bit
9	GPS Mode: OFF (0x00), ONCE (0x01), INTERVAL (0x02)
10 - 13	GPS interval in ms (3600000 - 43200000)