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

[Arsanios]

Hi AnnaR

First, i want to thank u for your post and final response, it helped me a lot.

Second, i am wondering if you have tried to enable the reporting for the attributes of the custom cluster?

I am trying to enable the reporting custom clusters's attribute, but i found that the end device responds just one time on the request and the doesn't send any other attributes reports.

Using the zigbee sniffer, i found that in the reporting request sent from the coordinator the ZCL Header -> manufacturer-specific is always false (0), which is wrong by ZigBee specification, it should be 1

Here what i found in the specs:
"The manufacturer specific sub-field SHALL be set to 0 if this command is being
used to configure attribute reports defined for any cluster in the ZCL or 1 if this command is being used to configure attribute reports for manufacturer specific attributes."

The problem is that value is set by the macro "ZB_ZCL_GENERAL_INIT_CONFIGURE_REPORTING_SRV_REQ" and it set always to 0.

I have tried to change it manually, but it doesn't work. it gave me a Malformated packet

So i want to know if you had some issues like that one or not.

I want also to ask AndreasF, if can he help me.

Thanks in advance