Motor control

Set motor position and update target temperature

This command is available/works only in Manual Control mode.

The command structure you need to send to Vicki to change the motor position and update the target temperature is shown in the table below.

Byte index	Hex value - Meaning
0	31 – The command will set Vicki motor position and target temperature
1	XX – Motor position in steps – MSB
2	XX – Motor position in steps – LSB
3	XX – Target temperature to be shown on the LED display when the rotary encoder is moved. Currently 0x05 <= XX <= 0x1E

Example command: 0x31012C1D – Set Vicki motor position to 300 and target temperature to 29.

When moving the valve, make sure the difference between the current motor position and the desired motor position is >= 17 steps! If you specify a lower amount of steps, the device will misbehave!

Set motor position only

This command is available/works only in Manual Control mode.

This feature is available in firmware >= 4.0.

This command is used to set desired motor position. It can be used when the temperature control is managed by the server. The allowed motor position to set is limited internally to 800 steps (0x0320).

Byte index	Hex value - Meaning
0	2D – The command code.
1	XX – Motor position in steps - MSB.
2	XX – Motor position in steps – LSB.

When moving the valve, make sure the difference between the current motor position and the desired motor position is >= 17 steps! If you specify a lower amount of steps, the device will misbehave!

Example command: 0x2D01F4 – Set the motor position to 500 steps.

Recalibrate motor

This command calibrates the device motor and closes the valve (drives the motor to maximum available position). Usage of this command must be avoided. The only data sent from the server is the command code.​

Byte index	Hex value - Meaning
0	03 – The command will cause Vicki to recalibrate the motor

Example command: 0x03