Others

Force-close

Usage of this command must be avoided. Sending the command from the server causes the valve to be closed until over-voltage is detected from the device.

Byte index	Hex value - Meaning
0	0B – The command code.

Example command: 0x0B

Force-attach

Command for advanced users. Use with care.

Available in firmware >= 4.2

When you mount Vicki on a backplate, a small hidden button indicates that Vicki is mounted and it will start calibrating.

If the device that has been working fine previously and starts reporting it's not attached to a backplate and motorRange = 0, then you might want to force-attach it.

In it's essence, the force-attach command makes Vicki ignore the status of the aforementioned hidden button and starts the normal operation of the device.

If Vicki e.g. has been fiddled with by the customer and they did not attach it correctly afterwards, this command might be helpful.

If Vicki is not attached to a backplate and a valve at all, calibration will not be successful, as it wouldn't be able to determine the maximum closed position of the valve.

SET

Byte index	Byte value - meaning
0	47 – the command code
1	Bits 7:1 – Reserved. Bit 0 – 1 to force device attaching to valve disregarding the button which sense that. 0 to force device detaching from the valve.

Example command 1: 0x4701 - activate force-attach

Example command 1: 0x4700 - deactivate force-attach

GET

Set temperature with resolution 1.0°C

Set target temperature with resolution 1.0°C

This command is applicable only in online automatic control mode or in online automatic control mode with external temperature reading. The command sets the temperature to be reached by the device internal control algorithm. It’s described in details in the table below.

Byte index	Hex value - Meaning
0	0E – The command code.
1	XX – The desired temperature in Celsius degrees. The value must be inside the range of allowed device working temperatures (Set with command code 0x08).

Example command: 0x0E16 – sets the device target temperature to 22 Celsius degrees.

Set External temperature sensor value with accuracy 1.0

Byte index	Hex value - Meaning
0	0F – The command code.
1	XX – The ext. temperature in Celsius degrees. The value must be greater than 0°C!

Example downlink: 0x0F14 – the server notifies Vicki that the measured temperature by the external sensor is 20 degrees Celsius.

New setpoint LED indication duration

SET

Byte index	Hex value / Meaning
0	63 – command code
1	XX – LED indication duration with resolution 0.5s. Default value is 2 => 1s. Allowed values are in range [1:20] which gives duration from 0.5s to 10s.

Example command: 0x63

Example response: 0x6306 – LED indication duration is 6 / 2 = 3s.

GET

External crystal malfunctioning

This command is generated internally in case the device detects a malfunction in the external crystal oscillator It is created for debug/troubleshooting purposes.

Byte index	Hex value / Meaning
0	A6 – command code

Example command: 0xА6 – Тhe crystal oscillator is malfunctioning.

LoRaWAN Region

This command reports the LoRaWAN Region your device is setup to work in. Make sure it matches you network as LoRaWAN regions/bands are country dependent. This region is hardcoded in the FW and the user can not change it, only report on it. The keep-alive in the command response is omitted for clarity.

GET

Byte index	Sent request	Received response
0	A4 – Command code	A4 – Command code
1		Radio region: 00 => EU868 01 => AS923 02 => AU915 03 => US915

Example command: 0xA4

Example response: 0xA400 – extracting the 1st byte value we get 0x00, thus the device operates in the EU868 LoRaWAN band.

Remote reset the device

This feature is available in firmware >= 4.0

When sending this command, always use unconfirmed downlink.

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.

Example command: 0x30 - remote reset the device

Change AppEUI and AppKey

Use with increased caution!

This feature is available in firmware >= 4.1

You can now change the AppEUI and AppKey of a device. Once the device has received this command, it restarts and re-join the network using the new keys.

SET

Byte index	Hex value – Meaning
0	33 – The command code.
1	AppEUI byte 0 (most significant).
2	AppEUI byte 1.
...	...
8	AppEUI byte 7 (least significant)
9	AppKey byte 0 (most significant).
10	AppKey byte 1.
...	...
24	AppKey byte 15.

Example command: To change the AppEUI to AABBCCDD11223344 and the AppKey to AABBCCDDEEFF00010203040506070809 you would need to use the following:

0x33AABBCCDD11223344AABBCCDDEEFF00010203040506070809