Ein Zigbee-Koordinator bildet das zentrale Element eines stabilen Zigbee-Netzwerks. Er initialisiert das Mesh, verwaltet die Netzwerkstruktur und stellt sicher, dass Geräte zuverlässig miteinander kommunizieren. Ohne einen funktionsfähigen Koordinator kann kein Zigbee-Netz aufgebaut oder betrieben werden.
🔌 1. SLZB-Koordinator anschließen
Der SLZB kann über USB oder PoE/Ethernet betrieben werden.
- Bei PoE ist eine freie Positionierung im Raum möglich.
- Optimal ist ein ausreichender Abstand zu WLAN-Routern, Metallflächen und starken Funksendern.
- Beim USB-Betrieb sollte ein kurzes USB-Verlängerungskabel zur Minimierung von Störungen eingesetzt werden.
🧩 2. Betriebsmodus wählen und Anbindung bestimmen
Der SLZB bietet mehrere Betriebsmodi, die je nach Einsatzgebiet gewählt werden können.
Zusätzlich unterscheidet sich die Konfiguration abhängig davon, ob der Koordinator per USB oder PoE/Ethernet angebunden ist.
Verfügbare Betriebsmodi:
- Zigbee-Coordinator → Coordinator Modus für ioBroker
- Zigbee-Router → Gerät fungiert als Mesh-Verstärker
- Matter-over-Thread → Nur Thread/Matter, kein Zigbee
- Zigbee-Hub (beta) → Experimenteller Modus
Für ioBroker wird der Modus Zigbee-Coordinator benötigt.
🔌 USB-Betrieb
- Anbindung erfolgt über
/dev/serial/by-id/... - Dieser Pfad bleibt systemstabil, im Gegensatz zu
/dev/ttyUSB0 - Baudrate für SLZB: 115200
- USB-Port möglichst nicht wechseln
🔌 PoE-/Ethernet-Betrieb
- Zugriff erfolgt über die IP-Adresse des SLZB
- Port 6638 muss erreichbar sein
- Verbindungstyp: TCP/Socket
- URL für ioBroker:
tcp://<coordinator-ip>:6638
Beispiel: tcp://192.168.1.50:6638
- PoE-Betrieb ermöglicht flexible Positionierung ohne USB-Verlängerung
- Ideal für stabile Funkabdeckung
🧩 3. Zigbee-Adapter in ioBroker installieren
Nach der Installation kann der Adapter gestartet werden, auch wenn noch keine Konfiguration vorgenommen wurde.
In diesem Zustand startet das Zigbee-Subsystem bewusst nicht, da der automatische Start nicht aktiviert ist.
Empfohlene Reihenfolge:
- Adapter installieren
- Einstellungen noch nicht speichern
- Test and Verification verwenden
- Erst nach erfolgreichem Test die Konfiguration dauerhaft speichern
🧐 4. ExtPanID – kritischer Parameter
Die ExtPanID definiert das Zigbee-Netz eindeutig.
- Vorgabe erfolgt durch den Koordinator
- Eine Änderung ist nicht zulässig
- Der Wert muss exakt in die Adapterkonfiguration übernommen werden
- Abweichungen verhindern den Netzwerkstart
🧪 5. Test and Verification
ioBroker → Zigbee → Einstellungen → Hardware → Test and Verification
- Prüfung der Ports und IP-Einstellungen
- Kontrolle der ExtPanID
- Teststart des Zigbee-Subsystems
Wichtiger Hinweis:
- Eine übereinstimmende PAN ID reicht nicht aus
- Entscheidend ist die Meldung „Zigbee started“
- Adapter-Neustarts sind in diesem Bereich nicht erforderlich
Änderungen können direkt getestet werden
🔄 6. NVRAM zurücksetzen
Bei vorheriger Nutzung in einem anderen Zigbee-Netz:
→ Test and Verification → NVRAM löschen
Anschließend erneuter Test.
📡 7. Zigbee-Kanalwahl
Empfohlene Kanäle:
- 15
- 20
- 25
Kanal 11 ist nur bei WLAN-Kanal 1 stark überlagert.
🏠 8. Geräte einbinden
Das Einbinden von Zigbee-Geräten erfolgt erst, wenn „Zigbee started“ im Log erscheint.
⚙️ 9. Einrichtung abschließen
Nach erfolgreichem Test:
- Option „Zigbee-Subsystem automatisch starten“ aktivieren
- Konfiguration speichern
- Adapter neu starten
⚠️ 10. Troubleshooting
| Problem | Ursache | Lösung |
|---|---|---|
| Rotes X bei ExtPanID | ExtPanID fehlerhaft oder nicht gesetzt | ExtPanID aus Koordinator übernehmen |
| Failed to connect | USB-/TCP-Konfiguration fehlerhaft | USB: by-id; PoE: korrekte IP/Port |
| Cannot request… | Netzwerk nicht initialisiert | ExtPanID korrigieren und Test wiederholen |
| Geräte verbinden nicht | Kanal oder Funkfeld ungünstig | Kanäle 15/20/25 testen |
| ECONNRESET | Netzwerkverbindung instabil | Kabel/Netzwerkanbindung prüfen |
by Speefak
