Network-related settings & Others

Join-retry period

See below how to set/get the join-retry period of the device. If the devices is not connected to a gateway, this value basically instructs it how frequent it should try to re-join the network.

Byte index

Hex value – Meaning

0

10 – The command code.

1

T, [s] = XX * 5. Value 0x00 isn’t applicable. Default value: 0x78*5 = 600 sec = 10 minutes.

Example downlink: 0x10F0 – the server sets the join request period to 20 minutes.

Notes to this command:

  • This join retry period (T) must comply to LoRaWAN messages duty cycle. Otherwise the join request will be sent on the next attempt. In most of cases, min. acceptable value for T is 240s. Recommended are higher values, for less battery discharge, e.g. 480s;

  • This join retry period (T) is for the first 15 sent messages. After, the used LoRaWAN stack automatically changes the possibility to send join request to ~20 minutes for 20 network join attempts. If the device is still not joined to the network after these 20 attempts, next join request can be sent after ~3 hours and 15 minutes.

Communication watch-dog

This command is used to set independent radio watch-dog configurations for confirmed and unconfirmed uplink messages sent from the device. In other words, the radio watch-dog configuration for confirmed uplinks no matter when the device works with unconfirmed uplinks, and vice versa. When no downlink (regular or MAC comamnd) is received for the defined Watch-Dog Period (WDP), the device resets itself.

Byte index

Hex value – Meaning

0

1C – The command code.

1

XX – Watch-dog period (WDP) when confirmed uplinks are used by the device.

WDP_confirmed [min] = (XX * Keepalive period) + 7

Default value for XX: 0x02.

Note that value 0x00 disables the watch-dog functionality when confirmed uplinks are used.

2

XX – Watch-dog period (WDP) when unconfirmed uplinks are used by the device.

WDP_unconfirmed [min] = XX * 60

Default value for XX: 0x18.

Note that value 0x00 disables the watch-dog functionality when unconfirmed uplinks are used.

Example downlink: 0x1C0300 – Assuming that the send Keepalive period is 5 minutes, WDP_confirmed = (0x03 * 5)+7 = (3*5)+7 = 22 minutes.

The watch-dog functionality for unconfirmed messages is totally disabled - 0x00.

Deep-sleep activation

If you plan to store the device and you want it to conserve maximum power, you can put it to sleep with the following command:

Byte index

Hex value – Meaning

0

3B – The command code.

1

01 – Enter deep sleep mode.

Example downlink: 0x3B01

If you put the device to sleep, you then need to follow the commissioning procedure described in the user manual to wake-up the device.

Full display refresh

In order to protect the display of the device from the so-called "ghosting", where an image becomes permanently imprinted on the e-ink display, we have to refresh it fully every max. 24 hours. If you decide, you can lower the full-refresh period, which can remove some dim artefacts from the display's partial refreshes.

Byte index

Hex value – Meaning

0

33 – The command code.

1

XX - Full display refresh in hours.

Acceptable values: 1 - 24 hours (0x01 - 0x18)

Default: 12 hours (0x0C)

Example downlink: 0x330E - set the full display refresh period to 10 hours.

Last updated