Zigbee: Light bulb¶
This Zigbee light bulb sample demonstrates a simple light bulb whose brightness can be regulated by another device.
You can use this sample with the Zigbee network coordinator and the Zigbee light switch to set up a basic Zigbee network.
Requirements¶
The sample supports the following development kits:
Hardware platforms |
PCA |
Board name |
Build target |
---|---|---|---|
PCA10056 |
|
||
PCA10100 |
|
||
PCA10095 |
|
||
nRF21540 DK |
PCA10112 |
|
You can use one or more of the development kits listed above and mix different development kits.
For this sample to work, the following samples also need to be programmed:
The Zigbee network coordinator sample on one separate device.
The Zigbee light switch sample on one or more separate devices.
Overview¶
The Zigbee light bulb sample takes the Zigbee Router role and implements the Dimmable Light profile. This profile allows changing the brightness level of a LED of the light bulb.
Configuration¶
See Configuring your application for information about how to permanently or temporarily change the configuration.
FEM support¶
Note
Software FEM support is not present on nRF53 Series devices yet. For now, it also cannot be combined with multiprotocol operation.
You can add support for the nRF21540 front-end module to the sample. See Radio front-end module (FEM) support for more information.
To add support for the nRF21540 FEM, add the provided dts-nrf21540-fem.overlay
devicetree overlay file when building.
The file is located in the samples/zigbee/common
folder.
Make sure that the GPIOs in the file correspond to those in which your front-end module is connected.
Note
You must add the provided overlay file if you use the nRF21540 EK. If you use the nRF21540 DK, build your application for the nrf21540dk_nrf52840 board. The devicetree for the nRF21540 DK already contains the required FEM configuration, so you do not need to add the overlay file.
See Set devicetree overlays for different ways of adding the overlay file.
The easiest way to add the file when building is to set it in the DTC_OVERLAY_FILE
variable.
However, doing so will override the default settings.
For some boards, this sample requires additional overlay files, which are automatically included when building with the default settings.
When you set the DTC_OVERLAY_FILE
variable, you must specify all overlay files that are needed for building.
Check the boards
folder to see the additional overlay files.
Follow the instructions in Providing CMake options to specify the DTC_OVERLAY_FILE
variable.
For example, to build the sample from the command line for an nRF52833 DK with an attached nRF21540 EK, invoke the following command within the sample directory:
west build -b nrf52833dk_nrf52833 -- -DDTC_OVERLAY_FILE="boards/nrf52833dk_nrf52833.overlay;../common/dts-nrf21540-fem.overlay"
Alternatively, you can copy the contents of dts-nrf21540-fem.overlay
to the board’s overlay file.
To add support for other front-end modules, add the respective overlay files in the same way.
User interface¶
- LED 3:
Turns on when the light bulb joins the network.
- LED 4:
Indicates the dimmable light option, that is changes to the light bulb brightness. It can be controlled by another Zigbee device in the network, for example a light switch.
- Button 4:
Puts the light bulb in Identify mode.
Building and running¶
Make sure to configure the Zigbee stack before building and testing this sample. See Configuring Zigbee in nRF Connect SDK for more information.
This sample can be found under samples/zigbee/light_bulb
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 kits, test it by performing the following steps:
Turn on the development kit that runs the network coordinator sample. When LED 3 turns on, this development kit has become the Coordinator of the Zigbee network and the network is established.
Turn on the development kit that runs the light bulb sample. When LED 3 turns on, the light bulb has become a Router inside the network.
Tip
If LED 3 does not turn on, press Button 1 on the Coordinator to reopen the network.
Turn on the development kit that runs the light switch sample. When LED 3 turns on, the light switch has become an End Device, connected directly to the Coordinator.
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.
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:
include/zigbee/zigbee_error_handler.h
Zigbee subsystem:
zb_nrf_platform.h
This sample uses the following sdk-nrfxlib libraries:
ZBOSS Zigbee stack 3.6.0.0 (API documentation)
In addition, it uses the following Zephyr libraries: