ESP32 Zigbee Coordinator (ZBOSS) ZBOSS
Firmware, die einen Standard-ESP32-C6 in einen vollwertigen Zigbee-Coordinator verwandelt — ZBOSS-NCP-Protokoll für Zigbee2MQTT, über USB oder UART.
ESP32 Zigbee Coordinator (ZBOSS)
Diese Open-Source-Firmware macht aus einem Standard-ESP32-C6 (oder -H2) einen vollwertigen Zigbee-Coordinator. Sie implementiert das ZBOSS NCP Serial Protocol, sodass ein Host wie Zigbee2MQTT den Chip als Coordinator über USB oder UART ansteuert. Es ist kein dediziertes Dongle nötig — auch ein einfaches Entwickler-Board funktioniert (getestet u.a. auf dem Seeed XIAO ESP32-C6).
Dieser Fork (tostmann/esp-coordinator) ist der aktiv gepflegte Upstream; das ursprüngliche andryblack/esp-coordinator-Repository ist archiviert.
Eigenschaften
- Bis zu 200 direkte Knoten — die Firmware nutzt die 512 KB SRAM des ESP32-C6 und ist auf 200 direkte Children konfiguriert (statt der 20–40 älterer Chips wie dem TI CC2531).
- Sendeleistung bis +20 dBm — der ESP32-C6 hat einen integrierten Leistungsverstärker; kein externer PA nötig.
- Wi-Fi 6 + Zigbee in einem Chip — beide Funkschichten on-die.
- Native NVRAM-Sicherung & -Wiederherstellung — vollständiger Netzwerk-Stand (PAN, Ext-PAN, Kanal, NWK-Key, Frame-Counter, Nachbartabelle) als Backup. Defekten Chip tauschen, Backup einspielen, gekoppelte Geräte kommen ohne erneutes Pairing zurück.
- USB und UART parallel — der NCP-Frame-Stream liegt gleichzeitig auf USB-Serial/JTAG und auf einem Hardware-UART (Standard: TX = GPIO22, RX = GPIO23, 115200 8N1). So lässt sich der Coordinator direkt an die TTL-Stiftleiste eines Hosts hängen (OpenWRT-Router, Raspberry-Pi-Header, ser2net).
- ZBOSS-Stack — kommerzieller, zertifizierter Stack.
Firmware flashen
- Web-Installer (empfohlen): ESP-Coordinator Web Flasher — direkt im Browser (Chrome / Edge / Opera), keine Software-Installation.
- CLI:
esptool.py --chip esp32c6 write_flash 0x0 binaries/factory.bin
Zigbee2MQTT
Die Firmware arbeitet mit dem Standard-Zigbee2MQTT (adapter: zboss). Für automatische NVRAM-Snapshots und reibungslose Hardware-Migration empfiehlt sich das angepasste Docker-Image ghcr.io/tostmann/zigbee2mqtt-esp32:latest.
serial: port: /dev/serial/by-id/usb-Espressif_USB_JTAG_serial_debug_unit_... adapter: zbossadvanced: transmit_power: 20Details, UART-Verdrahtung und Migrations-Leitfaden: siehe Doku und das GitHub-README.
Experimentell
- Natives Wi-Fi (Coexistence): ein separater Build lässt den Coordinator selbst ins WLAN gehen und den NCP über TCP anbieten — ohne USB-Host. WiFi-Coex-Flasher. Single-Radio-Coexistence → Testaufbau, nicht Produktion.
- Home Assistant ZHA: über die Komponente
tostmann/zha-zboss-esp(zigpy-zboss). Für den Produktivbetrieb bleibt der Zigbee2MQTT-Pfad die empfohlene Option.
Verfügbarkeit
Die Firmware ist Open Source und läuft auf handelsüblichen ESP32-C6-Boards — eine eigene Hardware ist nicht erforderlich. Eine dedizierte busware-Hardware ist (Stand dieser Seite) nicht im Shop gelistet.
Diskussion
Fragen, Erfahrungen, Bug-Reports? Die Diskussion läuft über GitHub Discussions : Zur Diskussion auf GitHub ↗