Control target temperature and/or motor position and range

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.

Target temperature with resolution 0.1°C

SET

The desired target temperature should be pre-multiplied by 10 to get the value to be send.

Byte index	Hex value - Meaning
0	51 – The command code.
1	XX - Tt [15:8]
2	XX - Tt [7-0]

Target temperature = Tt [15:0] / 10

Example command: 0x510102 => Tt = 0102[HEX]=258[DEC]

Target temperature = 258 / 10 = 25.8

The desired target temperature should be pre-multiplied by 10 to get the value to be sent. If later the target temperature is adjusted manually by rotating the device outer ring, the new value will be with accuracy 1.0°C

GET

This command response is automatically prepended to the keep-alive message when the target temperature isn't integer. The device will not respond to server requests with command code 0x52.

Byte index	Sent request	Received response
0	52 – Command code.	52 – The command code.
1		XX - Tt [15:8]
2		XX - Tt [15:8]

Example response: 0x520102 => Tt = 0102[HEX]=258[DEC]

Target temperature = 258 / 10 = 25.8

Set valve openness in percentage

This command only works in Manual mode.

SET

The desired valve openness in percentage.

Byte index	Hex value - Meaning
0	4E – The command code.
1	XX - Valve openness percentage

Example command: 0x4E0A

0A[HEX] = 10 [DEC] = 10%

The valve will open 10% of its maximum capabilities.

Limit MIN/MAX Valve Openness

This feature is available for firmware >= 4.3

This command allows you to decide what's the minimum and maximum valve openness for Vicki in percentages. It's only applicable when using the internal algorithm for temperature control. For example, you can decide that you want Vicki to control the valve only between 20% and 60% valve openness.

• If Vicki has to heat the room, it'll first open the valve to the MIN value you have specified.

• Vicki will not open more than the MAX value you have specified, which is particularly useful for hydronic balancing.

There is an exception to the set limits. In normal conditions if the internal algorithm calculates that it needs to go beyond the MIN or MAX opennes it will be limited to the value set.

However, if the internal algorithm calculates it needs to completely close the valve it will ignore the MIN limit and completely close the valve (0% openness), no mater what the MIN limit was.

By default Vicki controls the valve openness from 0% to 100%

Not allowed to set values that result in Min - Max < 10%.

SET

The desired range in percentage.

Byte index	Hex value - Meaning
0	4F – The command code.
1	XX - 100-Maximum valve openness in %. Default is 0x00
2	YY - 100-Minimum valve openness in %. Default is 0x64

You have to deduct the desired value from 100!

Meaning, if you want to set the range between min 20% and max 60%, you have to compose the command as follows:

1) MAX: 100 - 60% = 40 [dec] or 0x28 [hex]

2) MIN: 100 - 20% = 80 [dec] or 0x50 [hex]

Full command would be 4F2850. Another example - min 15%, max 90%

1) MAX: 100 - 90 = 10[dec] or 0x0A [hex] 2) MIN: 100 - 15 = 85[dec] or 0x55 [hex]

Full command would be 4F0A55

GET

This command gets the openness range to which the valve can be opened.

Byte index	Sent request	Received response
0	50 – Command code.	50 – The command code.
1		XX -Maximum effective openness parameter.
2		YY - Minimum effective openness parameter.

Example response: 0x500064

Max openness [%] = 100-XX [DEC]

Min openness [%] = 100-YY [DEC]

XX = 00[HEX] = 00[DEC] => Max openness = 100-0 =100%

YY = 64[HEX] = 100[DEC] => Min openness = 0%

Set motor position and update target temperature command explanation

In the table below is described the data which the server sends to Vicki to set new target temperature and new motor position.

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 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, [Hex]: 0x2D01F4 – Set the motor position to 500 steps.