2.2.20. Binary Switch Command Class, version 1

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.20.1. Binary Switch Set Command

This command is used to set the On/Off state at the receiving node.

\requirement{CC:0025.01.01.13.001}{0}

A receiving node MAY apply a non-zero duration to the transition from one value to a new value.

Table 2.103 Binary Switch Set Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_SWITCH_BINARY (0x25)

Command = SWITCH_BINARY_SET (0x01)

Value

Value (8 bits)

\requirement{CC:0025.01.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.

Table 2.104 Binary Switch Set - Value encoding

Value

Level

State

0 (0x00)

0%

Off

1..99 (0x01..0x63)

100%

On

255 (0xFF)

100%

On

\requirement{CC:0025.01.01.11.002}{0}

All other values are reserved and MUST NOT be used by a sending node. Reserved values MUST be ignored by a receiving node.

\requirement{CC:0025.01.01.11.003}{0}

If the supporting node uses this Command Class, the values MUST be interpreted as follow:

  • The value 0 MUST represent the lowest possible throughput (light, water, sound, etc.)

  • The values 1..99 and 255 MUST represent the highest possible throughput (light, water, sound, etc.)

The above value mapping of the Binary Switch Command Class Value allows a controlling node to control a mixed group of Binary Switch and Multilevel Switch supporting nodes via Basic Set commands. Nodes supporting the Binary Switch Command Class turn On or Off while nodes supporting the Multilevel Switch Command Class are set at the specified value level.

2.2.20.2. Binary Switch Get Command

This command is used to request the current On/Off state from a node.

\requirement{CC:0025.01.02.11.001}{0}

The Binary Switch Report Command MUST be returned in response to this command.

\requirement{CC:0025.01.02.11.002}{0}

This command MUST NOT be issued via multicast addressing.

\requirement{CC:0025.01.02.11.003}{0}

A receiving node MUST NOT return a response if this command is received via multicast addressing. The Z-Wave Multicast frame, the broadcast NodeID and the Multi Channel multi-End Point destination are all considered multicast addressing methods.

Table 2.105 Binary Switch Get Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_SWITCH_BINARY (0x25)

Command = SWITCH_BINARY_GET (0x02)

2.2.20.3. Binary Switch Report Command

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

Table 2.106 Binary Switch Report Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_SWITCH_BINARY (0x25)

Command = SWITCH_BINARY_REPORT (0x03)

Value

Value (8 bits)

\requirement{CC:0025.01.03.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.107.

Table 2.107 Binary Switch Report - Value encoding

Value

Level

State

0 (0x00)

0%

Off

254 (0xFE)

Unknown

Unknown

255 (0xFF)

100%

On

\requirement{CC:0025.01.03.11.002}{0}

All other values are reserved and MUST NOT be used by a sending node. Reserved values MUST be ignored by a receiving node.

\requirement{CC:0025.01.03.12.001}{0}

This field SHOULD advertise the current value of the node’s hardware; also while in transition to a new value.

\requirement{CC:0025.01.03.11.003}{0}

A controlling node MUST NOT assume that this field’s value is identical to the value previously issued with a Binary Switch Set Command.