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.

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	AC voltage, [V].
9	-	XX	AC current data, bits - [15:8].
10	-	XX	AC current data, bits - [7:0]. AC 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	AC voltage: 0xE7 = 231V.
9	-	19	AC current data, bits - [15:8].
10	-	52	AC current data, bits - [7:0]. 0x1952 = 6482mA.
11	-	01	Relay state: 0x01 - ON.

Keepalive period

SET

This command is used to set the period of the keep-alive command messages.

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 0F=15min.

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

Example command: 0x020A

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

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
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 – the keep-alive is 9 minutes.

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.