2.2.15. Basic Command Class, version 2

The Basic Command Class allows a controlling device to operate the primary functionality of another device without any further knowledge.

The Basic Command Class ensures a basic interoperability if no other Command Class is shared by two devices.

The Basic Command Class is an actuator control command class. Refer to Section 2.1.6.

2.2.15.1. Compatibility considerations

\requirement{CC:0020.02.00.21.001}{0}

A device supporting Basic Command Class, version 2 MUST support Basic Command Class, version 1. Commands not described in this version remain unchanged from version 1.

Version 2 adds the distinction between the Current Value and the Target State of the device.

\requirement{CC:0020.02.00.21.002}{4}

Version 2 elevates the requirement level so that the Current Value field of the Basic Report command MUST advertise the current value of the device hardware; also while in transition to a new target value.

The compatibility considerations from version 1 also apply to this version. Refer to Section 2.2.14.1.

2.2.15.2. Basic Report Command

This command is used to advertise the status of the primary functionality of the device.

Table 2.91 Basic Report Command, version 2

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_BASIC (0x20)

Command = BASIC_REPORT (0x03)

Current Value

Target Value

Duration

Current Value (8 bits)

\requirement{CC:0020.02.03.11.001}{0}

The Current Value field MUST advertise the current value of the device hardware; also while in transition to a new target value.

\requirement{CC:0020.02.03.11.002}{4}

The advertised values may vary depending on the device class implemented by the supporting device. A controlling device MUST interpret the value according to Table 2.90. For details on the mapping of values, refer to [35] and Section 7.

\requirement{CC:0020.02.03.12.001}{0}

The Current Value SHOULD be identical to the Target Value when a transition has ended.

Target Value (8 bits)

\requirement{CC:0020.02.03.11.003}{0}

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

\requirement{CC:0020.02.03.11.004}{4}

The advertised values may vary depending on the device class implemented by the supporting device. A controlling device MUST interpret the value according to Table 2.90.

For details on the mapping of values, refer [35] and Section 7.

\requirement{CC:0020.02.03.11.005}{0} \requirement{CC:0020.02.03.13.001}{4}

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 “Stop” motion control command.

\requirement{CC:0020.02.03.11.006}{0}

If the device is in a motion controlled transition, the Target Value field MUST advertise the min or max value (depending on the direction) according to the command class mappings defined in [35] and Section 7.

Duration (8 bits)

\requirement{CC:0020.02.03.12.002}{0}

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.10