History

rbaron bc3d834b20 Make it mandatory to select a factory reset method ... in order to avoid unhappy surprises		2023-07-01 08:26:21 +02:00
..
media/power-profile	More accurate power profile	2022-12-10 15:48:02 +01:00
src	Make it mandatory to select a factory reset method	2023-07-01 08:26:21 +02:00
.gitignore	Zigbee sample works with nRF52840dk + zigbee2mqtt	2022-12-07 20:10:51 +01:00
b-parasite.js	Add illuminance cluster & reporting	2022-12-10 10:47:16 +01:00
CMakeLists.txt	[ZigBee sample] Introduce debug counters	2023-06-07 08:08:34 +02:00
Kconfig	Fixes (minor?) issues with the ZigBee sample	2023-07-01 08:04:15 +02:00
prj.conf	Fixes (minor?) issues with the ZigBee sample	2023-07-01 08:04:15 +02:00
prj_debug.conf	Setup Kconfig for prstlib	2022-12-19 18:34:03 +01:00
README.md	[zb] Implement double-reset factory resetting method	2022-12-27 19:22:01 +01:00
zigbee.code-workspace	Links prstlib and restructures project to match other samples	2022-12-07 20:10:52 +01:00

README.md

Zigbee firmware sample

This sample is adapted from the zigbee_template from the nRF Connect SDK. It's a basic experimental/educational/exploratory firmware sample for b-parasite.

Clusters

These clusters are defined in the sample:

Cluster ID	Name
0x0001	Power Configuration
0x0400	Illuminance Measurement
0x0402	Temperature Measurement
0x0405	Relative Humidity Measurement
0x0408	Soil Moisture Measurement

Pairing Mode

The sample will first boot and start looking for a Zigbee coordinator - in pairing mode. The onboard LED will be flashing once a second while in this mode. Once a suitable network is found, the LED will briefly flash 3 times and remain off.

Factory Reset

A factory reset will make b-parasite forget its network pairing information and switch to pairing mode. There are two (mutually exclusive) methods to perform a factory reset, controlled by the CONFIG_PRST_ZB_FACTORY_RESET_METHOD config flag.

Factory Reset Method 1 (default) - Double reset

Resetting b-parasite twice in the timestamp of 5 seconds will perform a factory reset. With this method, both shorting the RST pin to ground and removing-inserting the battery counts as a reset.

For better results, wait > 1 and < 5 seconds second between the resets. The LED will flash a total of 8 times to indicate it worked.

Factory Reset Method 2 - Reset Pin

In this method, there's a distinction between two reset modes.

Power up mode

The device enters this mode when it is powered. For example, swapping an old battery or connecting to eternal power. This is the "usual" reset mode, and joined networks will be remembered.

Reset pin mode

If the device's RESET pin is briefly grounded, the device will effectively be factory reset. The device will leave its previous network and start looking for a new one.

While it works, this method can be finicky - an accidental pin reset will perform an unwanted factory reset.

Configs

Available options in Kconfig. Notable options:

CONFIG_PRST_ZB_SLEEP_DURATION_SEC: amount of time (in seconds) the device sleeps between reading all sensors and updating its clusters
CONFIG_PRST_ZB_PARENT_POLL_INTERVAL_SEC: amount of time (in seconds) the device waits between polling its parent for data

Home Assistant Integration

This firmware sample has only been tested with Home Assistant, using one of the following integrations.

Zigbee Home Automation (ZHA)

With the ZHA Home Assistant integration, b-parasite should work out of the box.

Zigbee2MQTT & Home Assistant

With Zigbee2MQTT, a custom converter is required. The b-parasite.js file contains such a converter. See Support new devices for instructions.

Battery Life

While sleeping, the device consumes around 2 uA: In the active cycle, it averages around 125 uA for 1 second: