Advanced motor force control
The functions explained in this page should be used with caution. Please, do not change any default parameters unless you know exactly what you are doing.
The following functions are for advanced users only.
The default settings of the device have been selected by MClimate after hundreds of hours in our lab.

Foreword

In order to ensure enough force is applied on the thermostatic radiator valve as the batteries of the device are slowly depleted, Vicki uses different motor speeds to ensure enough force.
There are 4 defined battery ranges for that purpose, as illustrated below. Each battery range corresponds to (1) range boundary (measured in mV) and motorSpeed (measured in pulse per second or pps).
When determining in which battery range does the device operate right now, the battery voltage is measured during rotation of the motor to ensure maximum accuracy.
​
Vop: the lower limit, measured by the device until the motor is rotating, at which motor operation is forbidden;
Boundary 1-4: the voltage value at which the motor rotation speed is changed. These boundaries can be read or modified through the Get/Set battery ranges boundaries commands. Note that boundary 1 must be lower than Vop (2.2V) to not use the rotation speed for Bat. range 1.
To determine the available physical space for valve movement, calibration is performed. The device microcontroller measures continuously the motor current during rotation and get the result through its analog to digital converter (ADC). A valve end is detected by increasing the motor current or the voltage the ADC measure. When the valve end is reached, extra over-voltage is measured by the ADC. This over-voltage is different for the different batteries ranges from Figure 2 and can be read or modified with the Get/Set battery ranges over-voltage commands.
For the device proper operation in noisy environment (During motor rotation noises are measured by the ADC), a special logic is implemented. It’s called Over-Voltage Additional Checks (OVAC) and can be additionally configured through the Get/Set OVAC commands. This is particularly useful when operating old and calcified thermostatic valves.

Battery Ranges

GET
SET
​
Byte index
Sent request
Received response
0
21 – Command code
21 – The command code.
1
Boundary 1 value - bits 15:8.
2
Boundary 1 value - bits 7:0. Value in mV.
Default value: 2100mV.
3
Boundary 2 value - bits 15:8.
4
Boundary 2 value - bits 7:0. Value in mV.
Default value: 2500mV.
5
Boundary 3 value - bits 15:8.
6
Boundary 3 value - bits 7:0. Value in mV.
Default value: 2800mV.
Example command sent from the server, [Hex]: 21
Example response, [Hex]: 2107D009C80B37 – Boundary 1: 2000mV, Boundary 2: 2504mV, Boundary 3: 2871mV.
Byte index
Hex value – Meaning
0
20 – The command code.
1
Boundary 1 value - bits 15:8.
2
Boundary 1 value - bits 7:0. Value in mV.
3
Boundary 2 value - bits 15:8.
4
Boundary 2 value - bits 7:0. Value in mV.
5
Boundary 3 value - bits 15:8.
6
Boundary 3 value - bits 7:0. Value in mV.
Example command, [Hex]: 2007D009C80B37 – Sets Boundary 1 to 2000mV, Boundary 2 to 2504mV and Boundary 3 to 2871mV.

Battery Ranges Over-Voltage Threshold

GET
SET
​
Byte index
Sent request
Received response
0
23 – Command code
23 – The command code.
1
Not used.
2
Used for over-voltage detection when the device operates in Bat. range 2. Value in mV. Default value: 16mV.
3
Used for over-voltage detection when the device operates in Bat. range 3. Value in mV. Default value: 25mV.
4
Used for over-voltage detection when the device operates in Bat. range 4. Value in mV. Default value: 90mV.
Example command sent from the server, [Hex]: 23
Example response, [Hex]: 230E10195A – Over-voltage in Bat. range 1: 14mV; Over-voltage in Bat. range 2: 16mV; Over-voltage in Bat. range 3: 25mV; Over-voltage in Bat. range 4: 90mV.
​
Byte index
Hex value – Meaning
0
22 – The command code.
1
Not used.
2
Used for over-voltage detection when the device operates in Bat. range 2. Value in mV.
3
Used for over-voltage detection when the device operates in Bat. range 3. Value in mV.
4
Used for over-voltage detection when the device operates in Bat. range 4. Value in mV.
Example command, [Hex]: 220E10195A – Sets Over-voltage for Bat. range 1 to 14mV, Over-voltage for Bat. range 2 to 16mV, Over-voltage for Bat. range 3 to 25mV, Over-voltage for Bat. range 4 to 90mV.

Over Voltage Additional Checks (OVAC)

GET
SET
Byte index
Sent request
Received response
0
27 – Command code
27 – The command code.
1
OVAC value. Maximum value: 0x28 = 40. Default value: 8. The higher the value, the higher the noise filtering. The default value should be sufficient for proper device operation in noisy environment.
Example command sent from the server, [Hex]: 27
Example response, [Hex]: 2708 – the device operates with OVAC=8.
Byte index
Hex value – Meaning
0
26 – The command code.
1
OVAC value. Maximum value: 0x28 = 40. Default value: 8. The higher the value, the higher the noise filtering. The default value should be sufficient for proper device operation in noisy environment.
Example command, [Hex]: 260C – Sets OVAC to 12.
​