Network-related settings

Set network join retry period command explanation.

This command is used to set the period (T) of LoRaWAN join request sending from Vicki, in case it was unable to join the network from the first attempt. The command is described in Table 17.
Byte index
Hex value – Meaning
0
10 – The command code.
1
​
T,[s]=XXβˆ—5.T, [s] = XX * 5.
Value 0x00 isn’t applicable. Default value: 3 minutes.
Table 17
Example command: 0x10F0 – the server sets Vicki LoRaWAN join request send 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.

Get network join retry period command explanation

This command is used to get the period (T) of LoRaWAN join request sending from Vicki, in case it was unable to join the network from the first attempt. Server sends the command code and the response is sent from Vicki together with the next keep-alive command. The sent command request and the received command response are described in Table 26. The keep-alive in the response is omitted for clarity.
Byte index
Sent request
Received response
0
19 – Command code.
19 – The command code.
1
​
XX – Network join retry period value.
T,[s]=XXβˆ—5T, [s] = XX*5
​
Table 26
Example command sent from server: 0x19;
Example command response: 0x19C6 => T = 0xC6*5 = 198*5 = 990s = 16.5 minutes.
​

Set device radio communication watch-dog parameters command explanation

This command is used to set independent Vicki radio watch-dog configurations for confirmed and unconfirmed uplink messages sent from the device. It 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 is received for the defined Watch-Dog Period (WDP), the device resets itself. The command is described in Table 28. The keep-alive in the response is omitted for clarity.
Byte index
Hex value – Meaning
0
1C – The command code.
1
XX – Watch-dog period (WDP) when confirmed uplinks are used by the device.
XX defines how many uplinks should be received without ack so that the device restarts. On top of that XX uplinks, another 7 minutes should pass before the device restarts.
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.
Default value for XX: 0x18.
Note that value 0x00 disables the watch-dog functionality when unconfirmed uplinks are used.
Table 28
Example command, [Hex]: 1C0300 – Assuming that the send Keep-alive period is 5 minutes, = 22 minutes, but the watch-dog functionality for unconfirmed messages is totally disabled.

Get device radio communication watch-dog parameters command explanation

This command is used to get the radio watch-dog configurations. The command is described in Table 29. The keep-alive in the response is omitted for clarity.
Byte index
Sent request
Received response
0
1D – Command code.
1D – The command code.
1
​
​
WDPconfirmedWDP _{confirmed}
value, as described in Table 28.
2
​
​
WDPunconfirmedWDP _{unconfirmed}
value, as described in Table 28.
Table 29

Remote reset the device

This feature is available in firmware >= 4.0
The command forces the device to fully reset (not reverting to factory settings), triggering recalibration as well as joining the network.
Byte index
Sent request
0
30 – Command code.