Configuring a Cluster#

Each cluster can be configured to implement Zigbee cluster attributes and commands. The Enable Command Discovery toggle, under the ZCL Global options, allows the list of commands supported by the device to be visible through the Zigbee General Command Discovery command interface.

Enable Command Discovery optionEnable Command Discovery option

To configure a cluster, click on the gear icon on the right side of the cluster row.

Gear iconGear icon

When you click the icon, a page opens specific to that cluster on that endpoint. In this interface, you can enable or disable attributes, manage how they are stored, manage attribute reporting, and manage the enabled commands on that cluster.

The cluster configuration interface consists of three tabs:

  • Attributes

  • Attribute Reporting

  • Commands

Configuring Attributes#

Attributes are configured through the first tab in the cluster configuration interface, as shown.

Attributes viewAttributes view

To enable or disable an attribute for a given cluster, click the On/Off toggle. When the toggle is shaded blue and to the right the attribute is on. If the toggle is grey and to the left, the attribute is off and thus not enabled for that cluster. In the figure below, the on/off attribute is implemented, whereas the reporting status attribute is not.

Enable attributeEnable attribute Disable attributeDisable attribute

Configuring Attribute Reporting#

Default attribute reporting is configured through the Attribute Reporting tab in the cluster configuration interface.

Attribute ReportingAttribute Reporting

As with attribute enablement, default attribute reporting is controlled through the toggle interface to the left of the Attribute Reporting table. An attribute is set up to be reported by default when the toggle is on.

Enable attribute reportedEnable attribute reported

For instance, in the following example, Endpoint 1 only implements the Server side of the On/Off cluster. Therefore, it is only possible for the cluster to receive the Off command In, which is in fact enabled for that cluster.

On/Off commandOn/Off command

With this setting enabled, ZCL automatically generates command header code for the On/Off cluster’s Off command.

Note: To ensure that enabled commands in the ZCL Configurator tool are handled, follow Section 6.4 ZCL Command Handling Callbacks of UG491: Zigbee Application Framework Developer’s Guide for SDK 7.0 and Higher.