ZCL Advanced Platform (ZAP)#

The ZCL Advanced Platform (ZAP) is a tool used to configure endpoints for Zigbee and Matter. When you open ZAP, it launches in a new tab next to the <project>.slcp tab. A Zigbee or Matter application can have multiple endpoints. Each endpoint contains a device configuration made up of Clusters on that end-point. The cluster groups differ depending on whether you re configuring a Zigbee or a Matter project, and the interface differs slightly.

ZAP for Zigbee:

ZAP with Zigbee skinZAP with Zigbee skin

ZAP for Matter:

ZAP with the Matter skinZAP with the Matter skin

This section is illustrated with a Zigbee project, but the information applies to Matter as well. For more details about using ZAP with Matter, see Matter References: Using ZAP, the ZCL Advanced Platform.

At any point click Tutorial in the menu for an interactive tutorial.

Click ADD ENDPOINT to add a new endpoint.

ZAP opening tab with one endpointZAP opening tab with one endpoint

In the next dialog, select a device type for the endpoint, and optionally change the endpoint number. Click CREATE to create the endpoint.

ZAP creation dialogZAP creation dialog

To modify an endpoint, select it in the left panel.

Zigbee Cluster Configurator with endpoint selectedZigbee Cluster Configurator with endpoint selected

The Filter dropdown in the upper right filters the clusters shown. To see only clusters that are enabled on the endpoint, select 'Enabled Clusters'.

The Show dropdownThe Show dropdown

Settings in the Enable column enable either the Client or Server (or both) sides of a cluster. Depending on the changes you make, you may be notified that components have been added to your project. To remove the cluster entirely from the configuration, select 'Not Enabled'.

The selection available in the Enable columnThe selection available in the Enable column

Click the Gear icon next to a cluster to enable or disable attributes, manage how they are stored, manage attribute reporting, and also manage the handling of commands on that cluster. The cluster configuration interface consists of three tabs:

  • Attributes

  • Attribute Reporting

  • Commands

Configuring a clusterConfiguring a cluster

Configuration changes made through the Zigbee Cluster Configurator for a Zigbee project are saved to <project-folder>\config\zcl\zcl_config.zap. For a Matter project the configuration is saved to <project-folder>\config\zap\<name>.zap. The .zap file is the backing data file for the Zigbee Cluster Configurator configuration for your application. When you save the file, the Zigbee Cluster Configurator not only saves the .zap file into your project, but also automatically generates all the files required for your application. For Zigbee, the files are placed in the project's autogen folder and all start with the 'zap' prefix. For Matter, the files are placed in the project's autogen > zap-generated folder.

For additional details about cluster configuration and adding a custom cluster, see the Zigbee-focused AN1325: Zigbee Cluster Configurator User's Guide.