2.2.21. Binary Switch Command Class, version 2¶

The Binary Switch Command Class is used to control the On/Off state of supporting nodes.

The Binary Switch Command Class is an actuator control Command Class. Refer to Section 2.1.6.

2.2.21.1. Compatibility considerations¶

\requirement{CC:0025.02.00.21.001}{0}

A node supporting Binary Switch Command Class, version 2 MUST support the Binary Switch Command Class, version 1.

\requirement{CC:0025.02.00.21.002}{0}

Commands not described in this version MUST remain unchanged from version 1.

Version 2 adds duration and target value control and reporting.

This command is used to set the binary state at the receiving node.

Table 2.108 Binary Switch Set Command, version 2¶
7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_SWITCH_BINARY (0x25)
Command = SWITCH_BINARY_SET (0x01)
Target Value
Duration

Target Value (8 bits)

\requirement{CC:0025.02.01.11.001}{0}

This field is used to specify the On/Off state that the receiving node MUST assume. This field MUST be encoded according to Table 2.104.

Duration (8 bits)

\requirement{CC:0025.02.01.12.001}{0}

This field is used to specify the duration that the transition from the current value to the Target Value SHOULD take.

\requirement{CC:0025.02.01.12.002}{0}

A supporting node SHOULD respect the specified duration value.

\requirement{CC:0025.02.01.11.002}{0}

The encoding of the Duration value MUST be according to Table 2.9

This command is used to advertise the current On/Off state at the sending node.

Table 2.109 Binary Switch Report Command, version 2¶
7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_SWITCH_BINARY (0x25)
Command = SWITCH_BINARY_REPORT (0x03)
Current Value
Target Value
Duration

Current Value (8 bits)

\requirement{CC:0025.02.03.11.001}{0}

This field is used to advertise the current On/Off state at the sending node. This field MUST be encoded according to Table 2.107.

\requirement{CC:0025.02.03.11.002}{0}

The advertised Current Value MUST NOT be updated to the Target Value before the hardware actuator has actually reached the Target Value.

Target Value (8 bits)

\requirement{CC:0025.02.03.11.003}{0}

This field MUST advertise the target value of an ongoing transition or the most recent transition.

\requirement{CC:0025.02.03.11.004}{0}

This field MUST be encoded according to Table 2.107.

Duration (8 bits)

\requirement{CC:0025.02.03.12.001}{0}

The duration field SHOULD advertise the duration of a transition from the Current Value to the Target Value.

\requirement{CC:0025.02.03.11.005}{0}

The encoding of the Duration field MUST be according to Table 2.10.