2.2.74. Multilevel Switch Command Class, version 4

The Multilevel Switch Command Class is used to control devices with multilevel capability.

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

2.2.74.1. Compatibility considerations

Version 4 adds reporting of target value and duration.

A device supporting Multilevel Switch CC, Version 4 MUST support Multilevel Switch CC, Version 3.

A device receiving a V1 Multilevel Set command MAY apply a factory default duration to the transition to a new value.

2.2.74.2. Multilevel Switch Report Command

This command is used to advertise the status of a multilevel device.

Table 2.430 Multilevel Switch Report Command, version 4

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_SWITCH_MULTILEVEL (0x26)
Command = SWITCH_MULTILEVEL_REPORT (0x03)
Current Value
Target Value
Duration

Current Value (8 bits)

The encoding of the Value field MUST be according to Table 2.418.

The device may be queried for its current value while in transition to a new value. The response to a Get command SHOULD be the current value of the device hardware.

A controlling device MUST NOT assume that the Value is identical to a value previously issued with a Set command when a transition has ended.

Target Value (8 bits)

The Target Value field MUST advertise the target value of an ongoing transition or the most recent transition.

The encoding of the Target Value field MUST be according to Table 2.418.

If queried after receiving a Set command, the Target Value field MUST advertise the target value specified in the Set command. The Target Value may change at a later time due to local control or a Multilevel Switch Stop Level Change command.

If the device is in a motion controlled transition, the Target Value field MUST advertise the value 0x00 or 0x63.

Duration (8 bits)

The Duration field SHOULD advertise the time needed to reach the Target Value at the actual transition rate. The encoding of the Duration field MUST be according to Table 2.9.