How to declare custom ZigBee cluster?

[AnnaR]

I am trying to follow the section “Declaring custom cluster” ( https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.thread_zigbee.v3.0.0%2Fusing_zigbee__z_c_l.html&anchor=att_declaration )

in order to declare one, but the mentioned example files (simple_gw_device.h and simple_gw.c) are missing in the nRF5 SDK for Thread and Zigbee v3.0.0, as well in the previous SDK version.

Can it be downloaded somewhere? Or, maybe, it is possible to point me to another example?

[AndreasF]

Hi.

in order to declare one, but the mentioned example files (simple_gw_device.h and simple_gw.c) are missing in the nRF5 SDK for Thread and Zigbee v3.0.0, as well in the previous SDK version.

 I have made a notification to the developer team that this is missing.

I also see that you have a similar case where you ask how this is done, I will answer that there (Link to case).

Best regards,

Andreas

[AnnaR]

Hi, thanks for the reply, but the mentioned case is not so close to this one (at least, as I think), because here I need to add our own (non-ZCL) cluster.

Maybe, you could provide an example, how to declare a custom cluster and using it in .c file?

[AndreasF]

Hi again.

Could you take a look at the header files in \examples\zigbee\experimental\multi_sensor\zb_multi_sensor.h and components\zigbee\pressure_cluster\zb_zcl_pressure_measurement.h?

These two files contains the necessary declarations for a custom non-ZCL cluster.

Best regards,

Andreas

[AnnaR]

Hi, Andreas.

Thank you very much for these references! 

Indeed, the pressure cluster escaped my attention.

Sincerely,

Anna

[AnnaR]

Just a minor addition to the answer, in case someone will have the same issue.

The Pressure Measurement Cluster belongs to ZCL, and its ID (ZB_ZCL_CLUSTER_ID_PRESSURE_MEASUREMENT) is already declared in zb_zcl_common.h. However, the cluster itself isn’t realized in the current SDK version. Also, as it from standard ZCL, it doesn’t require a Manufacturer Code, that is mandatory for a custom cluster.

So, in order to add a custom manufacturer-specific cluster, one can use the multi-sensor example, but need to:
1) Define Custom Cluster ID as well as Manufacturer ID in custom cluster header file:

#define ZB_ZCL_CLUSTER_ID_?????????? 0xXXXX
#define ZB_ZCL_MANUF_CODE_?????????? 0xXXXX

2) Use the defined manufacturer code instead of ZB_ZCL_MANUF_CODE_INVALID in ZB_ZCL_CLUSTER_DESC macros while forming the device cluster list.

Sincerely,

Anna