Show page

Differences

This shows you the differences between two versions of the page.

--- iothings:laboratoare:2025:lab5 [2025/10/22 10:13]
dan.tudose [Platformio Project Setup]
+++ iothings:laboratoare:2025:lab5 [2025/10/28 11:35] (current)
dan.tudose [Switch as a Sleepy ED]
@@ Line 1: / Line 1: @@
-====== Lab 5. Zigbee ======
+====== Lab 5. Zigbee Networking ======
 Zigbee is a low‑power, low‑data‑rate wireless protocol for building sensor/actuator networks (home automation, smart energy, lighting, industrial monitoring). It sits on top of IEEE 802.15.4 radios and adds networking, security, and application profiles.
@@ Line 102: / Line 102: @@
 As a coordinator we will be using a [[https://www.home-assistant.io/green/|Home Assistant Green]] gateway with a [[https://www.home-assistant.io/connectzbt1|Connect ZBT-1]] Zigbee Coordinator attached.
-===== Platformio Project Setup  =====
 You will need to edit platformio.ini and add these compile flags and libraries:
@@ Line 148: / Line 147: @@
 </code>
 Then you can add the main.cpp contents.
@@ Line 157: / Line 157: @@
 The device registers itself on the Zigbee network with manufacturer and model identifiers, sets reporting intervals and tolerances for each sensor type, and reacts to identify commands by blinking its LED. If Zigbee fails to initialize or connect, it restarts the ESP32.
+====== Zigbee Router + End Device ======
+In this next example we will simulate a Zigbee smart lightbulb controlled by a Zigbee light switch, using two ESP32-C6 Sparrow nodes.
+=== Node 1: Zigbee End Device – Light Switch Profile ===
+  * Acts as a Zigbee switch (e.g. On/Off Switch cluster).
+  * GPIO 9 (BOOT button) acts as a toggle input.
+  * Sends On or Off commands via Zigbee to a bound target (another Zigbee device).
+  * Minimal power draw = good for battery operation.
+=== Node 2: Zigbee Router – Lightbulb Profile ===
+  * Acts as a Zigbee Router (always powered).
+  * Implements On/Off Light Device cluster.
+  * Toggles onboard NeoPixel based on received commands.
+When the ED button is pressed it sends an On or Off Zigbee command to the bound router device. The router receives the command and toggles the NeoPixel accordingly. Zigbee binding or group addressing links the two.
+=== Platformio Project Setup ===
+You will need to modify platformio.ini with this dual-environment file:
+<code bash platformio.ini>
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; See https://docs.platformio.org/page/projectconf.html for details.
+[platformio]
+default_envs = sparrow-switch
+[env]
+platform = https://github.com/pioarduino/platform-espressif32/releases/download/54.03.20/platform-espressif32.zip
+board = esp32-c6-devkitm-1
+framework = arduino
+; use SPIFFS for on-board files
+;board_build.filesystem = spiffs
+build_flags =
+  -D ARDUINO_USB_MODE=1
+  -D ARDUINO_USB_CDC_ON_BOOT=1
+  -D ESP32_C6_env
+  ; (optional) more logs while bringing up Zigbee
+  ;-D CORE_DEBUG_LEVEL=5
+; Use a partitions.csv that contains Zigbee NV partitions (see step 2)
+board_build.partitions = partitions.csv
+monitor_speed = 115200
+[env:sparrow-switch]
+build_flags =
+  ${env.build_flags}
+  -D ZIGBEE_MODE_ED
+  -D SPARROW_SWITCH
+  -D CONFIG_ZB_ENABLED=1
+  -L$PLATFORMIO_PACKAGES_DIR/framework-arduinoespressif32-libs/esp32c6/lib
+  -lesp_zb_api.ed
+  -lzboss_stack.ed
+  -lzboss_port.native
+  -lzboss_port.remote
+[env:sparrow-light]
+build_flags =
+  ${env.build_flags}
+  -D ZIGBEE_MODE_ROUTER
+  -D SPARROW_LIGHT
+  -D CONFIG_ZB_ENABLED=1
+  -L$PLATFORMIO_PACKAGES_DIR/framework-arduinoespressif32-libs/esp32c6/lib
+  -lesp_zb_api.zczr
+  -lzboss_stack.zczr
+  -lzboss_port.native
+  -lzboss_port.remote
+lib_deps =
+  adafruit/Adafruit NeoPixel@^1.12.0
+</code>
+When building and deploying on the two nodes, switch ''default_envs'' between ''sparrow-switch'' and ''sparrow-light''.
+Keep the same partitions.csv file.
+The main is a dual one, depending on which type of device you are building for from platformio.ini.
+[[iothings:laboratoare:2025_code:lab5_2|Click here to get the code for this example.]]
+====== Switch as a Sleepy ED ======
+The previous example has the downside that the ED can be battery powered, but the code is not particularly optimized for energy saving. As a regular user will not press the switch more that a dozen times a day, it makes a lot of sense to keep the switch ED in deep sleep and wake only when the button is pressed. waking from deep sleep equates to having a hardware reset, so we will need to persist switch logic into the non-volatile RTC memory. This is all handled in the code below.
+[[iothings:laboratoare:2025_code:lab5_3|Click here to get the code for this example.]]
+<note>**Assignment 1:**
+Use the on-board BME680 sensor to switch lights on/off depending on the switch temperature instead of pushing a button. For example, if the temperature is above 25 degrees C, the light should turn on.
+</note>
+<note>**Assignment 2:**
+Encode more than simple on/off behavior from the switch. For example, a press toggles, and a hold dims up/down. Add a long-press detector on GPIO 9 and send MoveWithOnOff / Stop commands; on the bulb, implement Level Control callbacks to set NeoPixel brightness with transition times.
+</note>
+<hidden>
+Pentru asistenți: la laboratorul ăsta o să aveți nevoie de un gateway Home Assistant cu stick Zigbee Coordinator atașat. Dacă nu aveți așa ceva, întrebați-l pe Dan Tudose.
+</hidden>