Der SLZB-Koordinator bildet das Herz eines stabilen Zigbee-Netzwerks. Damit ein zuverlässiger Betrieb gewährleistet ist, sollte die Einrichtung des Koordinators vollständig abgeschlossen sein, bevor der Zigbee-Adapter in ioBroker installiert wird.
🔌 1. SLZB-Koordinator anschließen
Der SLZB kann über USB oder per PoE (Power over Ethernet) betrieben werden.
Die Wahl der Betriebsart hat Einfluss auf Störanfälligkeit, Positionierung und Konfiguration.
Wichtige Hinweise:
- Bei PoE freie Positionierung im Raum möglich
- Ideal: Abstand zu WLAN-Routern, Metallflächen und starken Funksendern
- Bei USB-Betrieb ein kurzes USB-Verlängerungskabel zur Reduzierung von Störungen verwenden
🧩 2. Betriebsmodus auswählen + Informationen zu USB- und PoE-Betrieb
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 → Hauptmodus 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
Erst nach abgeschlossener SLZB-Konfiguration:
- Adapter installieren
- ExtPanID eintragen (wird im nächsten Schritt erläutert)
- Port oder IP/Port eintragen (USB oder PoE)
- Kanal festlegen
- Adapter starten
🧐 4. ExtPanID (WICHTIG: häufigste Fehlerquelle) und Test
Die ExtPanID definiert das Zigbee-Netzwerk eindeutig.
Ein falscher oder freier Wert führt zu einem Koordinator, der zwar erreichbar ist, aber kein Netzwerk startet.
Grundlagen:
- ExtPanID wird vom Koordinator vorgegeben
- Wert darf nicht frei gewählt oder abgeändert werden
- Muss 1:1 in die Adapterkonfiguration übernommen werden
- Abweichungen verhindern das Starten des Zigbee-Netzwerks
Test and Verification
- ioBroker → Instanzen → Zigbee → Einstellungen → Hardware → Test and Verification (runterscrollen)
- Auf den Start-Button klicken
- Im Log werden die PAN ID vom Koordinator und die PAN ID vom Adapter angezeigt
- Werte müssen identisch sein, um Netzwerkstart zu gewährleisten
Korrektur:
- ExtPanID übernehmen
- Adapter speichern
- Neustart durchführen
📡 5. Zigbee-Kanalwahl
Empfohlene Kanäle:
- 15
- 20
- 25
Nicht empfehlenswert: 11 (starke Überdeckung mit WLAN).
🔄 6. NVRAM zurücksetzen (falls erforderlich)
Empfohlen bei Vorverwendung, Flash-Wechsel oder Netzwerkproblemen. Beseitigt alte PAN-Einträge und verhindert Konflikte.
=> ioBroker → Instanzen → Zigbee → Einstellungen → Hardware → Test and Verification (runterscrollen) => NVram (Papierkorbsymbol)
🧪 7. Log prüfen
Relevante Erfolgsmeldungen:
- „Coordinator ready“
- „Network started“
- „Zigbee started on channel…“
Fehler:
- „ExtPanID mismatch“
- „Cannot start network“
- „Socket/Serial error“
🏠 8. Zigbee-Geräte einbinden
Erst nach stabiler Koordinator-Initialisierung Geräte in den Pairing-Modus versetzen und hinzufügen
⚠️ 9. Troubleshooting – häufige Fehler
| Problem | Ursache | Lösung |
|---|---|---|
| Adapter zeigt rote X bei ExtPanID | ExtPanID fehlt oder stimmt nicht mit Koordinator überein | ExtPanID aus Koordinator auslesen, exakt in Adapter eintragen, Adapter neu starten |
Log: Failed to connect to the adapter | Falscher COM-Port / TCP-URL oder Port 6638 nicht erreichbar | USB-Pfad prüfen oder bei PoE tcp://<coordinator-ip>:6638 verwenden, Port erreichbar machen (z.B. mit nmap) |
Log: Cannot request when znp has not been initialized yet | Netzwerk noch nicht gestartet oder falsche ExtPanID | ExtPanID prüfen, Adapter speichern, Start-Button in Test and Verification verwenden |
| Geräte lassen sich nicht verbinden | Kanalüberschneidung, schlechtes Funkfeld | Zigbee-Kanal wechseln (15/20/25), Koordinator optimal platzieren |
Log: ECONNRESET oder Socket-Error | Netzwerkverbindung unterbrochen | PoE-Kabel prüfen, IP-Adresse korrekt, Adapter neustarten |
by Speefak
