Advanced

Custom Clusters

When to use?

You can use Custom Clusters when your device requires functionality that is not covered by standard Matter clusters. This typically applies during vendor-specific development or testing, where you need to validate features unique to your implementation.

Why use?

• To test proprietary features or device-specific capabilities.
• To ensure interoperability while still supporting vendor-defined extensions.
• To verify behavior in non-standard scenarios before integrating into a production Matter ecosystem.

Binding UI Controls

When building or testing with Matter Utilities, UI fields can be directly bound to a cluster, attribute, or command ID. This allows user interactions in the app to map to the corresponding Matter functionality on the device.

*guide + image/video*

Automation recipes

Automation Recipes in Matter Utilities are pre-configured transactions that allow users to test devices immediately without manual intervention. These ready-to-run transactions cover common actions such as turning devices on/off, dimming lights, and validating power cycles.

Users can also customize parameters like timing, sequence, or cluster/attribute IDs to match their device or any custom clusters.

For background on transactions in Matter, see Transactions in Concepts.

Ready-to-run Transactions

The Transactions tab offers advanced users powerful features for direct interaction with a Matter device. This utility includes a library of Ready-to-run Transactions that simplify common operations like reading key attributes or triggering essential commands, thus eliminating the need to manually enter Cluster and Attribute IDs.

How to use

1. Select the “Endpoint”

   Use the Endpoint dropdown menu (e.g., Endpoint 0, Endpoint 1) to choose the specific endpoint you want to target with the transaction.

   *Image/Gif: choose endpoint*

2. Choose Ready-to-run Transaction

   In the second dropdown menu, choose the predefined action that Matter Utilities provides, including:

   • Get Node Type
   • Get Node Name
   • Get Vendor ID
   • Get Vendor Name
   • Get Product ID
   • Get Product Name
   • Get Serial Number
   • Get Manufacturing Date
   • Get Version
   • Custom Read Cluster
   • Custom Write Cluster

   *Image/Gif: choose transaction*

   → If you select a standard action, no further input is required.

   → If the required action is not available in the ready-to-run list, you can use the Custom Read Cluster or Custom Write Cluster options to manually target any Cluster and Attribute ID.

   In that case, follow these steps:

   • Choose action type

     Choose Custom Read Cluster or Custom Write Cluster from the dropdown menu.

   • Enter Cluster and Attribute IDs

     Enter the Cluster ID in hexadecimal format (e.g., 0006 for the On/Off Cluster, 0008 for the Level Control Cluster).

     Enter the Attribute ID in hexadecimal format (e.g., 0000 for the On/Off State attribute).

     *Image/Gif: custom cluster IDs*

   • Set value (Custom Write only)

     If you selected Custom Write Cluster, enter the Value you want to write to the attribute.

3. Process the transaction

   • Click Process to send the ready-to-run or customized transaction to the Matter device.

   The device response appears in the Response data section at the bottom of the screen.

   Choose Clear Response to clear the content currently shown in the Response data field.