2.2.72. Multilevel Switch Command Class, version 2¶

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.72.1. Compatibility considerations¶

A device supporting Multilevel Switch CC, version 2 MUST support Multilevel Switch CC, version 1.

Version 2 adds a “Duration” parameter to the Multilevel Switch Set and Multilevel Switch Start/Stop Level Change commands.

Commands not described in Version 2 remain unchanged from Version 1.

This command is used to set a multilevel value in a supporting device.

Table 2.421 Multilevel Switch Set Command, version 2¶
7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_SWITCH_MULTILEVEL (0x26)
Command = SWITCH_MULTILEVEL_SET (0x01)
Value
Duration

Value (8 bits)

Refer to Multilevel Switch Set Command.

Duration (8 bits)

The Duration field MUST specify the time that the transition should take from the current value to the new target value.

A supporting device SHOULD respect the specified Duration value.

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

The factory default duration SHOULD be the same as the duration used for the Multilevel Switch Set Command.

This command is used to initiate a transition to a new level.

Table 2.422 Multilevel Switch Start Level Change Command, version 2¶
7	6	5	4
Command Class = COMMAND_CLASS_SWITCH_MULTILEVEL (0x26)
Command = SWITCH_MULTILEVEL_START_LEVEL_CHANGE (0x04)
Reserved	Up/ Down	Ignore Start Level	Reserved
Start Level
Duration

Up/Down (1 bit)

This field MUST specify the direction of the level change.

If the Up/Down bit is set to 0 the level change MUST be increasing.

If the Up/Down bit is set to 1 the level change MUST be decreasing.

Ignore Start Level (1 bit)

A receiving device SHOULD respect the start level if the Ignore Start Level bit is 0.

A receiving device MUST ignore the start level if the Ignore Start Level bit is 1.

A controlling device SHOULD set the Ignore Start Level bit to 1.

Reserved

This field MUST be set to 0 by a sending node and MUST be ignored by a receiving node.

Start Level (8 bits)

The Start Level field MUST specify the initial level of the level change.

Duration (8 bits)

The dimming rate to use MUST be calculated to match a transition from 0 to 99 during the time specified by the Duration field.

A supporting device SHOULD respect the specified Duration value.

For encoding of the duration value refer to Section 2.2.72.2.