How to get commands generated from client cluster in coordinator

RE: How to get commands generated from client cluster in coordinator

Marte Myrvold — Fri, 31 May 2024 13:02:09 GMT

Hi,

Here is an example of a handpoint handler that prints the IEEE address, cluster ID, command ID, and payload. You can modify it to fit your requirements.

#define IEEE_ADDR_BUF_SIZE 17

zb_uint8_t zb_nwk_coordinator_ep_handler(zb_bufid_t bufid)
{
	zb_zcl_parsed_hdr_t *cmd_info = ZB_BUF_GET_PARAM(bufid, zb_zcl_parsed_hdr_t);
	size_t payload_length = zb_buf_len(bufid);
	const zb_uint8_t *payload = zb_buf_begin(bufid);

	zb_uint16_t short_addr;
	zb_ieee_addr_t ieee_addr;
	
	switch (ZB_ZCL_PARSED_HDR_SHORT_DATA(cmd_info).source.addr_type) {
	case ZB_ZCL_ADDR_TYPE_SHORT:
		short_addr = ZB_ZCL_PARSED_HDR_SHORT_DATA(cmd_info).source.u.short_addr;
		zb_address_ieee_by_short(short_addr, ieee_addr);
		break;
	case ZB_ZCL_ADDR_TYPE_IEEE:
		ZB_IEEE_ADDR_COPY(ieee_addr, ZB_ZCL_PARSED_HDR_SHORT_DATA(cmd_info).source.u.ieee_addr);
		short_addr = zb_address_short_by_ieee(ieee_addr);
		break;
	}

	char ieee_addr_str[IEEE_ADDR_BUF_SIZE] = { 0 };
	char payload_str[255];
	ieee_addr_to_str(ieee_addr_str, IEEE_ADDR_BUF_SIZE, ieee_addr);
	to_hex_str(payload_str, sizeof(payload_str), payload, payload_length, false);

	LOG_INF("Received ZCL cmd: IEEE_src_addr=%s, cluster_id=0x%04x, cmd_id=0x%02x, payload=[%s]", 
						ieee_addr_str, 
						cmd_info->cluster_id,
						cmd_info->cmd_id,
						payload_str);

	return 0;
}

I have tested this in the network coordinator sample. Make sure to register the endpoint handler after registering the device context like this:

ZB_AF_REGISTER_DEVICE_CTX(&nwk_coordinator);
ZB_AF_SET_ENDPOINT_HANDLER(ZIGBEE_COORDINATOR_ENDPOINT, zb_nwk_coordinator_ep_handler);

Best regards,
Marte

RE: How to get commands generated from client cluster in coordinator

masayuki_i — Fri, 31 May 2024 05:34:42 GMT

Thanks for the helpful info.

[quote userid="92402" url="~/f/nordic-q-a/111607/how-to-get-commands-generated-from-client-cluster-in-coordinator/486569"]Can you clarify your goal? Do you want the nRF5340 to retrieve information about ZCL commands that are sent specifically to the nRF5340, or commands that are sent on the network in general? What kind of information do you want to retrieve?[/quote]

The goal is to be able to receive commands in general. I would like to get the eui64, cluster ID, command ID, and payload information for the device sending the command. For example, I would like to achieve the following.
I have multiple Dimmer switches in my house and I want to know at the hub which switch sent which command and with what payload.

RE: How to get commands generated from client cluster in coordinator

Marte Myrvold — Thu, 30 May 2024 07:43:28 GMT

Hi,

Just to add to my colleague's response.

[quote user=""]1. Is this log defined in a callback function that is called when the hub gets a command? Where is that callback function defined?[/quote]

The logs you refer to come from zigbee_logger_eprxzcl_ep_handler(). This is the endpoint logger, which parses and logs incoming ZCL frames. You can read more about this in Configuring Zigbee endpoint logger. As described there, you can set endpoint handlers with ZB_AF_SET_ENDPOINT_HANDLER().

[quote user=""]2. Is there a correct way to use "zdo bind on" to retrieve information about a command? I would like to know if there is an easier way to get information about the command.[/quote]

Can you clarify your goal? Do you want the nRF5340 to retrieve information about ZCL commands that are sent specifically to the nRF5340, or commands that are sent on the network in general? What kind of information do you want to retrieve?

Best regards,
Marte

RE: How to get commands generated from client cluster in coordinator

JONATHAN LL — Wed, 29 May 2024 13:52:58 GMT

Hi,

You can use the tools here : https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/libraries/zigbee/shell.html#zigbee-shell-command-list and follow the method mentioned here: https://infocenter.nordicsemi.com/topic/sdk_tz_v4.2.0/zigbee_multi_sensor_example.html?cp=9_3_3_8_5_3_1#zigbee_multi_sensor_example_test witch is close to the old nRF5SDK that does not support nRF5340. info on that can be found here: https://infocenter.nordicsemi.com/index.jsp?topic=%2Fsdk_tz_v4.2.0%2Fzigbee_example_cli_reference.html