Relay state 16ASPM

Relay state change

This command sets/gets the state of the relay, effectively powering/depowering the appliance it is controlling.

By default, the last state of the relay is saved in the device's memory.

For more details, see the command described below.

SET

Byte index	Hex value – Meaning
0	C1 – The command code.
1	00 – OFF; 01 – ON.

Example downlink: 0xC101 – Turn on the relay.

GET

Byte index	Sent request	Received response
0	B1 – Command code	B1 – Command code
1		00 - The relay is off; 01 - The relay is on;

Example downlink sent by the server: 0xB1;

Example command response: 0xB101 – The relay is ON.

Relay state change reason

These commands are available for devices with firmware version ≥ 1.4.

Reason for changing the relay state.

Byte index	Received response
0	54 – Command code
1	00 - Restart the device; 01 - Manual (by button) relay switching; 02 - Overheating protection; 03 - Overvoltage protection; 04 - Overcurrent protection; 05 - Overpower protection; 06 - Radio command: Relay state change; 07 - Radio commands: Relay timer in milliseconds and seconds.

Relay state after return of power supply

You can set/get the relay state after return of power supply with the following command set.

SET

You can set the relay state after return of power supply with the command:

Byte index	Hex value – Meaning
0	5E – The command code.
1	00: Last state. Default value. 01: ON - after return of power supply. 02: OFF - after return of power supply.

Example command: 0x5E02 – Sets the relay state to be off after return of power supply.

GET

Get the relay state after return of power supply.

Byte index	Sent request	Received response
0	5F – Command code.	5F – Command code.
1		00: Last state. 01: ON - after return of power supply. 02: OFF - after return of power supply.

Example command: 0x5F;

Example response: 0x5F02 – The relay state is set to be off after return of power supply.

Relay timer in milliseconds

These commands are available for devices with firmware version ≥ 1.4.

The command is used to configure the state of a relay (ON or OFF) for a specified duration in milliseconds.

After the timer expires, the relay automatically returns to its previous state.

The relay timer is deactivated when setting the relay state with command C1, manually (via the button) or by triggering any of the protections.

SET

Byte index	Hex value – Meaning
0	55 – The command code.
1	00 – OFF; 01 – ON.
2	XX - Timer, bits [15:8];
3	XX - Timer bits [7:0]: Relay timer duration (in milliseconds).

Example downlink: 0x550001F4 – Turn off the relay for 500 milliseconds.

GET

Byte index	Sent request	Received response
0	56 – Command code	56 – Command code
1		00 - The relay is off; 01 - The relay is on;
2		XX - Timer, bits [15:8];
3		XX - Timer bits [7:0]: Remaining time of the relay timer (in milliseconds).

Example downlink sent by the server: 0x56;

Example command response: 0x560000FF – The relay state is off and 255 milliseconds remains to return to the previous relay state.

Adjustable range is 50…65 535 milliseconds (1ms. resolution).

Relay timer in seconds

These commands are available for devices with firmware version ≥ 1.4.

The command is used to configure the state of a relay (ON or OFF) for a specified duration in seconds.

After the timer expires, the relay automatically returns to its previous state.

The relay timer is deactivated when setting the relay state with command C1, manually (via the button) or by triggering any of the protections.

SET

Byte index	Hex value – Meaning
0	57 – The command code.
1	00 – OFF; 01 – ON.
2	XX - Timer, bits [15:8];
3	XX - Timer bits [7:0]: Relay timer duration (in seconds).

Example downlink: 0x57000003 – Turn off the relay for 3 seconds.

GET

Byte index	Sent request	Received response
0	58 – Command code	58 – Command code
1		00 - The relay is off; 01 - The relay is on;
2		XX - Timer, bits [15:8];
3		XX - Timer bits [7:0]: Remaining time of the relay timer (in seconds).

Example downlink sent by the server: 0x58;

Example command response: 0x58000001 –The relay state is off and 1 second remains to return to the previous relay state.

Adjustable range is 1…65 535 seconds (1sec. resolution).

Relay state after overheating protection recovery

These commands are available for devices with firmware version ≥ 1.1.

You can set/get the relay state after overheating protection recovery with the following command set.

SET

You can set the relay state after overheating protection recovery with the command:

Byte index	Hex value – Meaning
0	59 – The command code.
1	00: Last state. Default value. 01: OFF - after overheating protection recovery.

Example command: 0x5901 – Sets the relay state to be off after overheating protection recovery.

GET

Get the relay state after overheating protection recovery.

Byte index	Sent request	Received response
0	5A – Command code.	5A – Command code.
1		00: Last state. 01: OFF - after overheating protection recovery.

Example command: 0x5A;

Example response: 0x5A01 – The relay state is set to be off after overheating protection recovery.

Manual relay state change

This command lets the Application Server know that the relay state has been manually (physically - via a button on the device) changed.

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

Byte index	Received response
0	5D – Command code
1	XX - Relay state.

Example uplink: 0x5D01;

The relay state has been manually changed to 01 (Relay state is ON).