Operational modes, temperature control algorithms, target temperature and motor control

Device primary operational mode

This command is used to change the device primary operational mode. Possible choices are heating (default for the device) and cooling. Switching from heating to cooling mode is required, when during the summer, cold water flow through the radiator. At the cold radiator water period end, switch to heating mode is required. Note that for both modes device functionalities open window detection and internal temperature control algorithm are available. The command data is described in Table 30. The keep-alive in the response is omitted for clarity.
GET
SET
​
Byte index
Sent request
Received response
0
1F – Command code.
1F – The command code.
1
​
00 – Device primary operational mode is heating;
01 – Device primary operational mode is cooling.
Table 31
Byte index
Hex Value - Meaning
0
1E - The command code
1
00 – Vicki operates in heating mode (default for the device);
01 – Vicki operates in cooling mode.
Table 30

Device operational modes

The device has 4 operation modes:
  • Offline – device is not connected to the network. This means that the device can’t join to the LoRaWAN network or doesn’t receive confirmation on the sent keep-alive commands. In this mode the device uses one of the internal temperature control algorithms to achieve target temperature;
  • Manual control – device is connected to the network; internal temperature control algorithm is disabled. Motor position is determined by the server. Default online mode for fw <= 3.4
  • Automatic temperature control - device is connected to the network; internal temperature control algorithm is enabled; Target temperature is determined by the server. Default online mode for fw >=3.5
  • Automatic temperature control with external temperature reading – device is connected to the network; internal temperature control algorithms are enabled; internal temperature sensor is disabled; Target temperature and sensor reading is determined by the server.
When using Online manual control you MUST use confirmed uplinks.
The offline mode is entered automatically when the device has lost connection with the server. If the device later restores its server connection the mode is changed automatically to the previously selected online mode. In Table 14 is described the command to set the desired device online mode.
GET
SET
This command is used to get Vicki online operational mode. 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 25. The keep-alive in the response is omitted for clarity.
​
Byte index
Sent request
Received response
0
18 – Command code.
18 – The command code.
1
​
XX – Device online mode value:
00 – Online manual control mode;
01 – Online automatic control mode;
02 – Online automatic control mode with external temperature reading.
Table 25
Example command sent from server: 0x18;
Example command response: 0x1801 – Vicki works in online automatic control mode.
​
Byte index
Hex value - Meaning
0
0D – The command code.
1
00 – Online manual control mode. Default for firmware <= 3.4
01 – Online automatic control mode. Default for firmware >= 3.5
02 – Online automatic control mode with external temperature reading.
Table 14
Example command: 0x0D01
With the example command, online automatic control mode is chosen.

Available temperature control algorithms

There are two available temperature control algorithms:
  1. 1.
    Equal directional control - available for all f.w. versions
  2. 2.
    Proportional control - available and default for f.w. versions >= 4.0;
The two algorithms differ significantly. The Proportional control is the successor of the Equal directional control algorithm. Its' main advantage is the quick time to reach the target temperature, as well as the ability to maintain the target temperature, taking into account the natural cooldown of the room and radiator.
Once you have selected operational mode "Automatic temperature control", you have the option to set which temperature control algorithm you want to use.

Temperature control algorithm selection and retrieval

This feature is available in firmware >= 4.0
GET
SET
Byte index
Sent request
Received response
0
2B – The command code.
2B – The command code.
1
XX – Indicate the currently used offline algorithm for temperature control.
0: Proportional control algorithm used. Default for f.w. >= 4.0
1: Equal directional control used.
Example command sent from the server, [Hex]: 2B.
Example response, [Hex]: 2B00 – Currently the Proportional control algorithm is in use.
Byte index
Hex value - Meaning
0
2C – The command code.
1
XX – Value to set according to the desired temperature control algorithm to be used by the device.
0: For the device to use the "Proportional control" algorithm;
1: For the device to use the "Equal directional control" algorithm
Example command, [Hex]: 2C02 – Set the device to use the "Equal directional control" algorithm.
​