EN DE
Busware Logo

ESP-Coordinator (ZBOSS NCP)

Version: lädt…
Hardware: ESP32-C6
Zweck: Zigbee Coordinator Firmware für Z2M
Quellcode: GitHub Repository
Information: Dieses Tool flasht die aktuelle Factory-Firmware (Version siehe oben) direkt über den Browser auf deinen ESP32-C6. Der Prozess überprüft automatisch, dass es sich bei dem angeschlossenen Gerät um einen ESP32-C6 handelt.
Release Notes
lädt…
lädt…

1. Verbinde dein Gerät via USB

Klicke auf den Button unten, wähle deinen seriellen Port (z.B. USB JTAG/serial debug unit) und starte den Flash-Vorgang.

Unterstützte Browser: Chrome, Edge, Opera. (Safari/Firefox unterstützen WebSerial noch nicht vollständig).

2. Zigbee2MQTT (Z2M) Einrichtung

Sobald das Flashen abgeschlossen ist, kann der Coordinator in Zigbee2MQTT eingebunden werden. Passe dazu deine configuration.yaml (unter `zigbee2mqtt/data/`) wie folgt an:

serial:
  # Ersetze diesen Pfad durch deinen tatsächlichen USB-Pfad
  port: /dev/serial/by-id/usb-Espressif_USB_JTAG_serial_debug_unit_...
  # Zwingend erforderlich für die ESP32 ZBOSS Firmware:
  adapter: zboss

advanced:
  # Sendeleistung (TX Power) - Optional
  transmit_power: 20
Optional: passendes Docker-Image. Für nahtloses Coordinator-Backup/-Restore (genau das NVRAM-Image, das auch die Backup/Restore-Buttons in Abschnitt 3 unten nutzen) gibt es ein Community-gepflegtes Z2M-Image, das die ZBOSS-NCP-Erweiterungen bereits eingebaut hat:
image: ghcr.io/tostmann/zigbee2mqtt-esp32:latest
Das offizielle koenkk/zigbee2mqtt-Image funktioniert genauso — nur ohne den NVRAM-Blob in coordinator_backup.json. Details siehe ZIGBEE2MQTT.md.
Wichtige Hinweise:
• Die Firmware ist auf maximale Stabilität für das ZBOSS Protokoll optimiert.
• Wenn Z2M beim Starten "Port is busy" meldet, stellen Sie sicher, dass keine anderen Dienste (wie z.B. ModemManager) den Port blockieren.
• Zigbee2MQTT ist der empfohlene Host-Stack. Home Assistant ZHA ist experimentell — aktueller Status siehe GitHub README.

3. Coordinator (bereits geflasht) — Identify, Backup, Restore

Für einen Stick mit bereits installierter Firmware: über USB anschließen und Identify klicken, um Live-Netzwerk-Status, Firmware-Version, IEEE-Adresse und Anzahl gepairter Geräte abzurufen. Darunter kann das Netzwerk als Z2M-kompatible coordinator_backup.json gesichert oder aus einer Datei wiederhergestellt werden — und falls die Firmware veraltet oder der Chip Factory-fresh ist, lässt sich die aktuelle Firmware direkt flashen.

Firmware
NCP
Stack / Protocol
IEEE
Rolle
Netzwerk
PAN ID
Ext PAN ID
Kanal
Gepairte Geräte
Frame Counter
⚠️ Veraltete Snapshots können bei einzelnen Endgeräten den Replay-Schutz auslösen, wenn deren Frame-Counter über die Luft den gespeicherten Wert überholt hat. Vor jeder Hardware-Migration einen frischen Snapshot ziehen.

    

Chip startet neu…

Warte bis der ESP32-C6 über USB neu erkannt wurde.