Distinguishing between Zigbee pairing states?

RE: Distinguishing between Zigbee pairing states?

Marte Myrvold — Tue, 08 Mar 2022 08:25:09 GMT

Hi,

That is good to hear!

[quote user="mytzyiay"]What logic do I need to add in order to keep it from counting children of my router node[/quote]

You can use either the device_type field of zb_nwk_nbr_iterator_entry_t to check if the device is an end device, or the relationship field to check if it is a child.

Device type	The type of the neighbor device: 0x00 = ZigBee coordinator 0x01 = ZigBee router 0x02 = ZigBee end device 0x03 = Unknown
Relationship	The relationship between the neighbor and the current device: 0x00 = neighbor is the parent 0x01 = neighbor is a child 0x02 = neighbor is a sibling 0x03 = None of the above 0x04 = previous child

Best regards,

Marte

RE: Distinguishing between Zigbee pairing states?

mytzyiay — Mon, 07 Mar 2022 20:04:58 GMT

This seems to work for me so far. What logic do I need to add in order to keep it from counting children of my router node?

static bool has_active_neighbors = false;

static void check_neighbors(zb_uint8_t bufid);

static void neighbor_check_cb(zb_uint8_t bufid)
{
 zb_nwk_nbr_iterator_params_t *args = ZB_BUF_GET_PARAM(bufid, zb_nwk_nbr_iterator_params_t);
 has_active_neighbors = args->index != ZB_NWK_NBR_ITERATOR_INDEX_EOT;

 ZB_SCHEDULE_APP_ALARM(check_neighbors, bufid, ZB_MILLISECONDS_TO_BEACON_INTERVAL(1000));
}

static void check_neighbors(zb_uint8_t bufid)
{
 zb_ret_t error_code;

 if (bufid == ZB_BUF_INVALID) {
 error_code = zb_buf_get_out_delayed_func(check_neighbors);
 ZB_ASSERT(error_code == RET_OK);
 return;
 }

 zb_nwk_nbr_iterator_params_t *args = ZB_BUF_GET_PARAM(bufid, zb_nwk_nbr_iterator_params_t);
 args->update_count = 0;
 args->index = 0;

 error_code = zb_nwk_nbr_iterator_next(bufid, neighbor_check_cb);
 ZB_ASSERT(error_code == RET_OK);
}

static void schedule_neighbor_check(void)
{
 ZB_SCHEDULE_APP_CALLBACK(check_neighbors, ZB_BUF_INVALID);
}

RE: Distinguishing between Zigbee pairing states?

Marte Myrvold — Mon, 07 Mar 2022 11:34:04 GMT

Hi,

There is no signal generated for this, but what you can do is to check the neighbor table. The signal ZB_NWK_SIGNAL_NO_ACTIVE_LINKS_LEFT is generated when all entries in the devices neighbor table have aged out, except for the entries for end devices that the device itself is the parent of. Using the function zb_nwk_nbr_iterator_next() you can get entries in the neighbor table, so you can check whether there are any entries that are not a child of the device, and if so, you know that the router is able to communicate with other devices again. As of now, there are no examples showing how to use this function in the latest tag of nRF Connect SDK, but it is used in this pull request: https://github.com/nrfconnect/sdk-nrf/pull/6961/files/ce1cd4337ce0de6de9cc14b26ea740e17d8cccf7, specifically in the function refresh_active_nbt_table().

Best regards,

Marte

RE: Distinguishing between Zigbee pairing states?

mytzyiay — Fri, 04 Mar 2022 16:46:54 GMT

OK. Which signal should I watch for to determine that the router has reconnected with other devices (i.e. the number of active links is >0) and so I can turn the LED green again?

RE: Distinguishing between Zigbee pairing states?

Marte Myrvold — Fri, 04 Mar 2022 09:03:21 GMT

Hi,

[quote user="mytzyiay"]If I start up the nRF52 board when the ZC is completely powered off, it's still claiming that it joined the network and it's illuminating the ZIGBEE_NETWORK_STATE_LED[/quote]

This is actually correct. In this case the router has previously been commissioned to and joined the network, and it has the network data stored in NVRAM. When it restarts it does not need to be commissioned again, since it will use the stored network data to rejoin the network.

The coordinator is not necessary for a Zigbee network to work. In typical Zigbee networks where the coordinator is the Trust Center, the coordinator is responsible for creating a network and for commissioning new devices. However, if the coordinator is turned off or not reachable for some reason, the network will not stop working. You will be unable to commission new devices without a Trust Center, but the devices that have already been commissioned will keep working and can keep communicating.

[quote user="mytzyiay"]W: Parent is unreachable[/quote]

This is printed when the signal ZB_NWK_SIGNAL_NO_ACTIVE_LINKS_LEFT is generated, which happens when a device is unable to reach any router or coordinator. If you have one coordinator and multiple routers in your network, and the coordinator is turned off this signal will not be generated, since the routers will still be able to find other routers.

[quote user="mytzyiay"]I want it to be clear to the user whether the nRF52 board has successfully established communication with other Zigbee nodes. In the case where I power up a paired node and it can't find any other Zigbee devices on the PAN, I'd like to flash red rather than green to alert the user to the connectivity issue.[/quote]

You can use ZB_NWK_SIGNAL_NO_ACTIVE_LINKS_LEFT in zboss_signal_handler() for this.

Best regards,

Marte

RE: Distinguishing between Zigbee pairing states?

mytzyiay — Thu, 03 Mar 2022 18:19:15 GMT

I saw this code and have tested it with a simple two node network, just the ZC and my router/lightbulb on nRF52840. If I start up the nRF52 board when the ZC is completely powered off, it's still claiming that it joined the network and it's illuminating the ZIGBEE_NETWORK_STATE_LED:

I: ZBOSS Light Bulb example started
I: Production configuration is not present or invalid (status: -1)
I: Zigbee stack initialized
I: Unimplemented signal (signal: 54, status: 0)
I: Joined network successfully on reboot signal (Extended PAN ID: XXX, PAN ID: YYY)
W: Parent is unreachable
W: Parent is unreachable
W: Parent is unreachable
W: Parent is unreachable

I do not want this. I want it to be clear to the user whether the nRF52 board has successfully established communication with other Zigbee nodes. In the case where I power up a paired node and it can't find any other Zigbee devices on the PAN, I'd like to flash red rather than green to alert the user to the connectivity issue.

> Zigbee router devices do not have parent devices

Perhaps I'm using the wrong terminology to refer to "the peer(s) my router talks to", but the documentation at your link and the error message output seems to state otherwise?

RE: Distinguishing between Zigbee pairing states?

Marte Myrvold — Thu, 03 Mar 2022 15:23:20 GMT

Hi,

Something similar to this is already done in both the light bulb and light switch samples, where LED 3 is used to indicate that the device has joined a network. This is done by calling the function zigbee_led_status_update() inside the Zigbee signal handler:

void zboss_signal_handler(zb_bufid_t bufid)

{

/* Update network status LED. */

zigbee_led_status_update(bufid, ZIGBEE_NETWORK_STATE_LED);

The function will turn the LED on if the status of the signal ZB_BDB_SIGNAL_STEERING is equal to RET_OK, which means that the device has successfully joined a network. If the status of this signal is something else or the device leaves the network (ZB_ZDO_SIGNAL_LEAVE) the LED will turn off.

Zigbee router devices do not have parent devices, so the second condition where the device has joined the network but does not have a parent is not relevant. I suggest checking out our Zigbee quick start guide to get more familiar with how Zigbee works, and the different roles.

Best regards,

Marte