Zigbee: Network coordinator

This Zigbee network coordinator sample establishes the Zigbee network and commissions Zigbee devices that want to join the network.

You can use this sample together with the Zigbee light bulb and the Zigbee light switch to set up a basic Zigbee network.

Overview

This Zigbee network coordinator sample demonstrates the Zigbee Coordinator role. It is a minimal implementation that supports only the network steering commissioning mechanism.

Requirements

The sample supports the following development kits:

Hardware platforms

PCA

Board name

Build target

nRF52840 DK

PCA10056

nrf52840dk_nrf52840

nrf52840dk_nrf52840

nRF52833 DK

PCA10010

nrf52833dk_nrf52833

nrf52833dk_nrf52833

nRF5340 DK

PCA10095

nrf5340dk_nrf5340

nrf5340dk_nrf5340_cpuapp

You can use one of the development kits listed above.

Optionally, you can use this sample with one or both of the following samples:

You can mix different development kits.

User interface

LED 3:

Indicates whether the network is open or closed:

  • On - The network is open.

  • Off - The network is closed.

Button 1:

Reopens the network for 180 seconds.

Note

The network is also opened after start-up.

Building and running

Make sure to enable the Zigbee stack before building and testing this sample. See Zigbee for more information.

This sample can be found under samples/zigbee/network_coordinator in the nRF Connect SDK folder structure.

See Building and programming a sample application for information about how to build and program the application.

Testing

After programming the sample to your development kit, test it by performing the following steps:

  1. Turn on the development kit that runs the coordinator sample. When LED 3 turns on, this development kit has become the Coordinator of the Zigbee network and the network is established.

  2. Turn on the other development kits that you programmed.

    • When LED 3 turns on the development kit that runs the light bulb sample, it has become a Router inside the network.

    • When LED 3 turns on the development kit that runs the light switch sample, it has become an End Device, connected directly to the Coordinator.

    Tip

    If LED 3 on the development kits does not turn on, press Button 1 on the Coordinator to reopen the network.

  3. Optionally, if you are testing with both the light bulb and the light switch samples, complete the following additional steps:

    1. Wait until LED 4 on the development kit that runs the light switch sample turns on. This LED indicates that the switch found a light bulb to control.

    2. Use buttons on the development kit that runs the light switch sample to control the light bulb, as described in the light switch sample’s user interface section. The result of using the buttons is reflected on the light bulb’s LED 4.

You can now use buttons on the light switch to control the light bulb, as described in the User interface section of the light switch sample page.

Dependencies

This sample uses the following nRF Connect SDK libraries:

  • Zigbee subsystem:

    • zb_nrf_platform.h

    • zigbee_helpers.h

    • zb_error_handler.h

  • DK Button and LEDs

This sample uses the following sdk-nrfxlib libraries:

In addition, it uses the following Zephyr libraries:

  • include/zephyr.h

  • include/device.h

  • Logging