4.7.7 Zigbee Custom Cluster Example

Introduction

Zigbee specification supports custom cluster, which is also called manufacturer defined cluster. Due to not all application are defined as standard Zigbee clusters, user can use this approach to define his own cluster including attributes and commands, to meet these special application requirements.

Microchip provided custom cluster feature in Zigbee library, the custom cluster can be easily edited using MCC GUI, generated code and run. Following sections describe a defined custom cluster, demo, and how to create the application from scratch.

Custom Cluster - Flowrate Monitor Definitions

As an example, define a custom cluster and use it into the demo code. Following are the cluster definitions:

Cluster name: flowRateMonitor

Cluster ID: 0xFC00

Server Attributes:

Client Attributes:

Server Commands:

There is no custom command is defined for this cluster, but all standard command like Read Attribute Command, Read Attribute Response command, Report Attribute Command are supported by custom cluster as one default feature.

Client Commands:

There is no custom command is defined for this cluster, but all standard command like Read Attribute Command, Read Attribute Response command, Report Attribute Command are supported by custom cluster as one default feature.

GitHub Repository

Hardware Requirement

SDK Setup

• Gettting Started with Software Development

Software Requirement

• Tera Term

Programming the Precompiled Hex File

This demo includes both cluster server and cluster client, which includes two example code project: custom_cluster_server project and custom_cluster_client project. In each project folder, their precompiled hex file are provided. So, program one WBZ451/WBZ351 Curiosity board with custom_cluster_server.X.production_1.0.0.0.hex, which acts as cluster server and Zigbee end device role, and program second WBZ451/WBZ351 Curiosity board with custom_cluster_client.X.production_1.0.0.0.hex, which acts as cluster client and Zigbee coordinator role.

Board can be programmed by either IPE or MPLABX IDE.

Demo Description

The demo application demonstrates the Zigbee custom cluster functionality of PIC32CXBZ/WBZ family of devices and modules. It consists of a cluster server application (ZigBee End device) and a cluster client application (Zigbee coordinator device) implemented as shown below:

Zigbee device commissioning:

Custom cluster attribute report and read:

Demo Steps

• Supply both WBZ451/WBZ351 Curiosity Board programmed with correct hex files by connecting a USB cable, power supply Green LED will turn on when connect to PC.

• Open Tera Term software for both boards, setup serial port with correct COM port number and settings as 115200/8bit/none parity/1 stop bit/none flow control, enable Local echo and sending line ends with line feeds.

• Input command resetToFN command on custom_cluster_client first, then input same resetToFN command on custom_cluster_server side, custom_cluster_server end device then will join to custom_cluster_client coordinator device, and below log will be shown about device successful commissioning:

• After commissioning, logs “Flowratemonitor Attr Report: Value = 0x0” are shown about periodical attribute report from custom_cluster_server.

• On custom_cluster_client, input readAttribute -s 0xAAAA 0x30 0xfc00 0xB command, it can read specific attribute value from custom_cluster_server manually.

  • -s means 16btis short address to be used.

  • 0xAAAA is the 16bits short address of end device(custom_cluster_server example) assigned by coordinator device(custom_cluster_client example), the short address can be known from the commissioning logs. If don't know the short address, can also input getNetworkAddress command on custom_cluster_server terminal to get it.

  • 0x30 is the end point address of custom_cluster_server example. Since custom_cluster_server uses custom device type, its end point address is 0x30, this can be checked in its MCC graph.

  • 0xfc00 is Cluster ID of custom cluster, it can be modified in MCC graph.

  • 0xB is Attribute ID defined in cluster. For example, in this example, Attribute ID is range from 0x0 to 0x5 and 0xFFFD.

Creating Application From Scratch Using MCC

• Follow steps in Generating project from MCC to create a new Zigbee project, add Zigbee component by device type, and USART, SERCOM0, configure receiving pin for SERCOM0.
• Zigbee device type is selected as Custom Device.

  • For custom_cluster_client project, select COORDINATOR in Custom Device - Manual Configuration - Stack Configuration - Stack Device Type, this is to configure device to Coordinator role.

  • For custom_cluster_server project, select ENDDEVICE in Custom Device - Manual Configuration - Stack Configuration - Stack Device Type, this is to configure device to End Device role.

• After configurations is done, MCC graph should look like figure below.

  

• Cluster Configuration must be like the following figures .

• Clusters selection

  

  

  

  

  

  

• Generate code once MCC configurations are done.
• Modify code mentioned in app_user_edits.c
• Modify CS_UID in zigbeeAppDeviceSelect.h file, to make CS_UID in custom_cluster_server and custom_cluster_client two examples are not identical.
• Clean and Build project.