Keep-alive

The keep-alive is a periodic message sent by the Wireless Thermostat with sensor data and more. In this page you will learn how to decode keepalive messages and how to set the keepalive interval.

Keep-alive decoding

Periodically sent message which contains the most important device data.

The data is described in Table 3. In Table 4 example packet is given.

f.w. 1.4 or later

Byte	Value	Meaning
0	81	Command byte for this packet.
1	XX	Internal temperature sensor data, bits 15:8 – T[15:8].
2	XX	Internal temperature sensor data, bits 7:0 - T[7:0]. t [°C] = (T[15:0]-400)/10
3	XX	Relative Humidity data; RH [%] = (XX*100)/256
4	XX	Supply voltage of the device data, bits 15:8.
5	XX	Supply voltage of the device data, bits 7:0. Battery voltage, [mV].
6	XX	Target temperature data, bits 15:8 – T[15:8].
7	XX	Target temperature data, bits 7:0 - T[7:0]. t [°C] = T[15:0] / 10.
8	XX	Power source status. Тhe device is powered by: 00 - Built-in photovoltaic panel; 01 - АА batteries; 02 - USB power supply.
9	XX	Device light intensity data, bits 15:8.
10	XX	Device light intensity data, bits 7:0. Light intensity [Lux].
11	XX	PIR sensor status: 00 - No motion detected; 01 - Motion detected.

Table 3.

Keepalive example

Byte	Value	Meaning
0	81	Command byte for this packet.
1	02	Internal temperature sensor data, bits 15:8 – T[15:8].
2	88	Internal temperature sensor data, bits 7:0 - T[7:0]. t [°C] = (T[15:0]-400)/10 t [°C] = (0x0288-400)/10 = (648-400)/10 = 24.8°C.
3	80	Relative Humidity data; RH [%] = (XX*100)/256 (0x80 * 100)/256 = (128*100)/256 = 50% RH
4	0A	Supply voltage of the device data, bits 15:8.
5	45	Supply voltage of the device data, bits 7:0. Battery voltage, [mV]. 0x0A45 = 2629mV.
6	01	Target temperature data, bits 15:8 – T[15:8].
7	09	Target temperature data, bits 7:0 - T[7:0]. t [°C] = T[15:0] / 10. t [°C] = 0x0109 / 10 = 265 / 10 = 26.5°C.
8	00	Power source status. Тhe device is powered by: 00 - Built-in photovoltaic panel;
9	02	Device light intensity data, bits 15:8.
10	7A	Device light intensity data, bits 7:0. Light intensity [LUX]. 0x027A = 634 LUX.
11	00	PIR sensor status: 00 - No motion detected;

Table 4.

f.w. 1.3 or older

Byte	Value	Meaning
0	01	Command byte for this packet.
1	XX	Internal temperature sensor data, bits 15:8 – T[15:8].
2	XX	Internal temperature sensor data, bits 7:0 - T[7:0]. t [°C] = (T[15:0]-400)/10
3	XX	Relative Humidity data; RH [%] = (XX*100)/256
4	XX	Supply voltage of the device data, bits 15:8.
5	XX	Supply voltage of the device data, bits 7:0. Battery voltage, [mV].
6	XX	Target temperature in Celsius.
7	XX	Power source status. Тhe device is powered by: 00 - Built-in photovoltaic panel; 01 - АА batteries; 02 - USB power supply.
8	XX	Device light intensity data, bits 15:8.
9	XX	Device light intensity data, bits 7:0. Light intensity [Lux].
10	XX	PIR sensor status: 00 - No motion detected; 01 - Motion detected.

Table 3.

Keepalive example

Byte	Value	Meaning
0	01	Command byte for this packet.
1	02	Internal temperature sensor data, bits 15:8 – T[15:8].
2	88	Internal temperature sensor data, bits 7:0 - T[7:0]. t [°C] = (T[15:0]-400)/10 t [°C] = (0x0288-400)/10 = (648-400)/10 = 24.8°C.
3	80	Relative Humidity data; RH [%] = (XX*100)/256 (0x80 * 100)/256 = (128*100)/256 = 50% RH
4	0A	Supply voltage of the device data, bits 15:8.
5	45	Supply voltage of the device data, bits 7:0. Battery voltage, [mV]. 0x0A45 = 2629mV
6	17	Target temperature in Celsius: 0x17 = 23°C.
7	00	Power source status. Тhe device is powered by: 00 - Built-in photovoltaic panel;
8	02	Device light intensity data, bits 15:8.
9	7A	Device light intensity data, bits 7:0. Light intensity [LUX]. 0x027A = 634 LUX.
10	00	PIR sensor status: 00 - No motion detected;

Table 4.

Keepalive period

SET keep-alive period

Byte index	Hex value - Meaning
0	02 – Command code to set keepalive period
1	XX – keep-alive period in minutes. Value 0x00 isn’t applicable. Default value: 0x0A.

Example command: 0x020A

The example sets the keep-alive period to 10 minutes.

Note that the period value must respect the LoRaWAN messages duty cycle limitations. Otherwise the message will be sent when this is allowed. Also, the bigger period value, the less battery discharge. In most of cases, min. allowed period is 3 minutes and recommended values are 10 minutes or greater.

GET keep-alive period

This command is used to get Wireless Thermostat's period of the keep-alive command messages. Server sends the command code and the response is sent from the device together with the next keep-alive command.

The keep-alive in the example is omitted for clarity.

Byte index	Sent request	Received response
0	12 – The command code.	12 – The command code.
1		XX – device keep-alive period in minutes.

Example command sent from server: 0x12;

Example command response: 0x1209 – Wireless Thermostat's keep-alive is 9 minutes.

Note: Acceptable values: 1...255 minutes (1min. resolution).