> For the complete documentation index, see [llms.txt](https://docs.mclimate.eu/mclimate-lorawan-devices/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-16a-switch-and-power-meter-lorawan-16aspm/mclimate-16aspm-device-communication-protocol/keep-alive.md). # Keep-alive ## Keep-alive decoding The Keep-alive is a periodically sent message which contains the most important device data. The data is described in the table below, where an example is also given in a second table. {% hint style="warning" %} Current below 100mA is not registered and measured, thus a device consuming less than this threshold would produce keep-alives with 0 values for the current, power and the accumulated energy will not increase. This will not impact functionality otherwise and the connected appliance will still be powered correctly. {% endhint %} {% tabs %} {% tab title="FW ≥ 1.3" %}

Byte	Bit Index	Value	Meaning
0	-	01	Command byte for this packet.
1	7	X	Set to 1 when the temperature is negative.
1	6:0	XX	Internal temperature sensor data – T[°C].
2	-	XX	Energy data, bits - E[31:24].
3	-	XX	Energy data, bits - E[23:16].
4	-	XX	Energy data, bits - E[15:8].
5	-	XX	Energy data, bits - E [7:0]. Energy [kWh] = E[31:0] / 1000.
6	-	XX	Power data, bits - [15:8].
7	-	XX	Power data, bits - [7:0]. Power, [W].
8	-	XX	Voltage, [V].
9	-	XX	Current data, bits - [15:8].
10	-	XX	Current data, bits - [7:0]. Current, [mA].
11	-	XX	Relay state: 0x00 - OFF; 0x01 - ON.

### Keepalive example

Byte	Bit index	Value	Meaning
0	-	01	Command byte for this packet.
1	7	0	0: The temperature is positive.
1	6:0	1C	Internal temperature sensor: 0x1C = 28°C.
2	-	03	Energy data, bits - E[31:24].
3	-	4A	Energy data, bits - E[23:16].
4	-	24	Energy data, bits - E[15:8].
5	-	18	Energy data, bits - E[7:0]. Energy [kWh] = E[31:0] / 1000. Energy = 0x34A2418 / 1000 = 55 190,552kWh.
6	-	05	Power data, bits - [15:8].
7	-	D9	Power data, bits - [7:0]. 0x05D9 = 1497W.
8	-	E7	Voltage: 0xE7 = 231V.
9	-	19	Current data, bits - [15:8].
10	-	52	Current data, bits - [7:0]. 0x1952 = 6482mA.
11	-	01	Relay state: 0x01 - ON.

{% endtab %} {% tab title="FW ≤ 1.2" %}

Byte	Bit Index	Value	Meaning
0	-	01	Command byte for this packet.
1	-	XX	Internal temperature sensor data – T[°C].
2	-	XX	Energy data, bits - E[31:24].
3	-	XX	Energy data, bits - E[23:16].
4	-	XX	Energy data, bits - E[15:8].
5	-	XX	Energy data, bits - E [7:0]. Energy [kWh] = E[31:0] / 1000.
6	-	XX	Power data, bits - [15:8].
7	-	XX	Power data, bits - [7:0]. Power, [W].
8	-	XX	Voltage, [V].
9	-	XX	Current data, bits - [15:8].
10	-	XX	Current data, bits - [7:0]. Current, [mA].
11	-	XX	Relay state: 0x00 - OFF; 0x01 - ON.

### Keepalive example

Byte	Bit index	Value	Meaning
0	-	01	Command byte for this packet.
1	-	1C	Internal temperature sensor: 0x1C = 28°C.
2	-	03	Energy data, bits - E[31:24].
3	-	4A	Energy data, bits - E[23:16].
4	-	24	Energy data, bits - E[15:8].
5	-	18	Energy data, bits - E[7:0]. Energy [kWh] = E[31:0] / 1000. Energy = 0x34A2418 / 1000 = 55 190,552kWh.
6	-	05	Power data, bits - [15:8].
7	-	D9	Power data, bits - [7:0]. 0x05D9 = 1497W.
8	-	E7	Voltage: 0xE7 = 231V.
9	-	19	Current data, bits - [15:8].
10	-	52	Current data, bits - [7:0]. 0x1952 = 6482mA.
11	-	01	Relay state: 0x01 - ON.

{% endtab %} {% endtabs %} ## Keepalive period {% tabs %} {% tab title="SET" %} This command is used to set the period of the keep-alive command messages.

Byte index	Hex value - Meaning
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 0A = 10min.

The keep-alive in the example is omitted for clarity. **Example command:** 0x020F The example sets the keep-alive period to 15 minutes. {% endtab %} {% tab title="GET" %} This command is used to get the 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
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:** 0x120F – the keep-alive is 15 minutes. {% endtab %} {% endtabs %} {% hint style="warning" %} Note that the period value must respect the LoRaWAN messages duty cycle limitations. Otherwise the message will be sent when this is allowed. In most of cases, min. allowed period is 3 minutes and recommended values are 10 minutes or greater. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-16a-switch-and-power-meter-lorawan-16aspm/mclimate-16aspm-device-communication-protocol/keep-alive.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.