Target Temperature & Temperature range

Target temperature with resolution 0.1°C

This command is available for devices with firmware version ≥ 1.4.

You can change the target temperature with the following command set.

SET

You can set the target temperature with the command:

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

T[15:0] = Ttarget[°C] * 10;

Example command: 0x500102;

Set target temperature - 25,8°C * 10 = 258 [DEC] => 0x0102 [HEX].

GET

This command gets the target temperature. The keepalive data in the example below is omitted for clarity.

Byte index	Sent request	Received response
0	51 – Command code	51 – Command code
1		XX - T[15:8].
2		XX - T[7:0].

Ttarget[°C] = T[15:0] / 10;

Example command: 0x51;

Example response: 0x510102;

0x0102 [HEX] = 258 [DEC] => Ttarget = 258 / 10 = 25,8°C.

The allowed target temperature range is (5°C – 30°C) by default.

Target temperature with resolution 1.0°C

You can change the target temperature with the following command set.

SET

You can set the target temperature with the command:

Byte index	Hex value – Meaning
0	2E – The command code.
1	XX – Target temperature value

Example downlink: 0x2E17 – Sets the target temperature to 0x17 = 23°C.

GET

This command gets the target temperature. The keepalive data in the example below is omitted for clarity.

Byte index	Sent request	Received response
0	2F – Command code	2F – Command code
1		XX - Target temperature value

Example downlink sent by the server: 0x2F;

Example command: 0x2F1B – The target temperature is 0x1B = 27°C.

The allowed target temperature range is (5°C – 30°C) by default.

Manual change from the thermostat's buttons

With this command your application server can understand when the target temperature has been manually changed from the device physically - somebody clicked the buttons on the device and set a specific target temp.

The command is sent together with the keepalive of the device. The keepalive data in the example below is omitted for clarity.

• Manual target temperature change with resolution 0.1°C.

This command is available for devices with firmware version ≥ 1.4.

Byte index	Received response
0	54 – Command code
1	XX - T[15:8].
2	XX - T[7:0].

Tmanual[°C] = T[15:0] / 10;

Example command: 0x540102;

0x0102 [HEX] = 258 [DEC] => Tmanual = 258 / 10 = 25,8°C.

• Manual target temperature change with resolution 1.0°C.

This command is available for devices with firmware version ≤ 1.3.

Byte index	Received response
0	30 – Command code
1	17 - Target temperature is manually set to 23°C.

Target temperature range

You can change the range of selection of target temperature on the device. By default, the user can select between 5 and 30 degrees Celsius.

SET

Byte index	Hex value – Meaning
0	08 – The command code.
1	XX – lower temperature limit. Min. allowed/ Default value: 0x05 (5°C).
2	XX – upper temperature limit. Max. allowed/ Default value: 0x1E (30°C).

Example downlink: 0x081018 – Sets the lower temp. limit to 16°C and the upper temp. limit to 24°C.

GET

This command is used to get the possible min. and max. target temperature values. Server sends the command code as a downlink and the response is sent from the device together with the next keep-alive command. The keepalive data is omitted from the response for clarity.

Byte index	Sent request	Received response
0	15 – Command code	15 – Command code
1		XX - Min. target temperature value.
2		XX - Max. target temperature value.

Example downlink sent by the server: 0x15;

Example command: 0x15051E – The lower temp. limit is 5°C and the upper temperature limit is 30°C.

Delay on target temperature change

Since people usually take some time to decide on a target temperature, we wait for a certain period after the last change before the device sends an immediate uplink.

SET

Byte index	Hex value – Meaning
0	35 – The command code.
1	XX – Time delay in seconds. The default value is 10sec.

Example command: 0x350F – The delay that is set is 15sec.

GET

Byte index	Sent request	Received response
0	36 – Command code	36 – Command code
1		XX - Delay for sending the target temperature

Example downlink sent from server: 0x36;

Example uplink response: 0x360F – The delay for sending the target temperature is 15sec.

Note: Acceptable values: 0...255sec. (1sec. resolution).

Configuring the target temperature step

This command is available for devices with firmware version ≥ 1.4.

You can change the target temperature step, when buttons are used. E.g. when the current target temperature is 22.0°C and the step is 0.5°C, if the user clicks the up button once, the target temperature will become 22.5°C

SET

You can set the target temperature step with the command:

Byte index	Hex value – Meaning
0	52 – The command code.
1	XX - Tstep[°C] * 10. Default value: 0x05 (0.5°C)

Example command: 0x520F;

Sets the temperature step - 1.5°C * 10 = 15 [DEC] => 0x0F [HEX].

GET

This command gets the target temperature step. The keepalive data in the example below is omitted for clarity.

Byte index	Sent request	Received response
0	53 – Command code	53 – Command code.
1		XX - Tstep[°C] * 10.

Example command: 0x53;

Example response: 0x530F;

0x0F - convert to DEC 15 => Tstep = 15 / 10 = 1.5°C.

Note: Acceptable values: 0.1...10°C (0.1°C resolution).

Temperature hysteresis

This command is available for devices with firmware version ≥ 1.4.

SET

Byte Index	Byte value - meaning
0	4E - The command code
1	XX = Temperature hysteresis value, multiplied by 10. Default value: 0x02 (0.2°C)

Example downlink:

0x4E03 - sets the temperature hysteresis to 0.3°C.

GET

Byte index	Sent request	Response - Meaning
0	4F – The command code.	4F – The command code.
1		XX - Temperature hysteresis value, multiplied by 10.

Example uplink:

0x4F03 - The temperature hysteresis is 0.3°C.

Note: Acceptable values: 0.1...25.5°C (0.1°C resolution).

Measured temperature sensor compensation

This command is available for devices with firmware version ≥ 1.4.

This is applies to the measured temperature.

SET

This command is used to set the compensation temperature values.

Byte index	Hex value - Meaning
0	55 – The command code.
1	00: Positive compensation. 01: Negative compensation.
2	XX - Tcomp[°C] * 10. Default value: 0x0000 (0°C).

Example command: 0x550115;

Set the negative temp. compensation - 0x01[HEX].

Set the compensation temperature - 2.1°C * 10 = 21[DEC] => 0x15[HEX].

GET

This command is used to get the compensation temperature values.

Byte index	Sent request	Received response
0	56 – Command code	56 – Command code
1		00: Compensation is positive. 01: Compensation is negative.
2		XX - Tcomp[°C] * 10.

Tcomp[°C] = XX / 10;

Example command: 0x56;

Example response: 0x560115;

0x01 - The compensation is negative.

Convert 0x15[HEX] = 21[DEC] => Tcomp = 21 / 10 = 2,1°C.

Note: The allowed range is -5...5°C (0.1°C resolution).