Leitfaden- Geräte-Inklusion und Exklusion via Z-Wave JS UI

Beta Versionen Z-Wave-JS-Gen7-Beta
1

Leitfaden: Geräte-Inklusion und Exklusion via Z-Wave JS UI

Wenn ein Z-Wave Gerät sich nicht wie gewohnt in homee einlernen lässt, bietet das Z-Wave JS UI (ZWJS-UI) leistungsstarke Werkzeuge zur Fehlerbehebung. Oft blockieren alte Netzwerk-Informationen auf dem Gerät den Prozess.

1. Zugriff auf die Benutzeroberfläche

Das Z-Wave JS UI ist beim homee in der Regel über die IP-Adresse deines homee und den Port 8091 erreichbar (z.B. http://192.168.178.50:8091).

2. Der wichtigste Schritt: Die Exklusion (Reset)

Schlägt eine Inklusion fehl, liegt es meist daran, dass das Gerät noch glaubt, mit einem anderen Controller verbunden zu sein. Führe immer zuerst eine Exklusion durch, auch wenn das Gerät neu ist.

  1. Klicke in der Z-Wave JS UI in der Seitenleiste auf „Actions“ (oder das Plus-Icon unten rechts im Dashboard).
  2. Wähle „Manage Nodes“.
  3. Klicke auf „Exclusion“. Der Controller befindet sich nun im Exklusions-Modus.
  4. Aktiviere am Gerät den Inklusions-/Exklusions-Mechanismus (meist 3-maliges Drücken der Taste).
  5. Achte auf die Meldung im UI: Node removed oder Exclusion finished. Sobald dies erscheint, ist das Gerät „sauber“ und bereit für homee.

3. Gezielte Inklusion (Add Node)

Wenn die Exklusion erfolgreich war, starte die Inklusion direkt aus dem UI:

  1. Gehe erneut zu „Manage Nodes“ → „Inclusion“.
  2. Wähle den Modus:
  • Default: Empfohlen für die meisten Geräte.
  • NWI (Network Wide Inclusion): Wenn das Gerät weiter vom Controller entfernt ist.
  1. S2 Sicherheit: Falls das Gerät S2 unterstützt, erscheint ein Pop-up. Du wirst nach dem DSK (Device Specific Key) gefragt. Gib die ersten 5 Ziffern ein (zu finden auf dem QR-Code/Aufkleber des Geräts).
  • Tipp: Wenn S2 Probleme macht, kann man testweise „Unauthenticated“ wählen, falls das Gerät dies zulässt.
  1. Starte den Vorgang am Gerät.

4. Den Interview-Prozess überwachen

Im Dashboard siehst du nun den Status des „Interviews“.

  • Protocol Info: Die grundlegende Kommunikation steht.
  • Interview: Z-Wave JS fragt alle Funktionen (Command Classes) ab.
  • Ready: Das Gerät ist vollständig erkannt.

Was tun, wenn das Interview bei 50% stehen bleibt?

  • Batteriegeräte aufwecken: Drücke die Taste am Gerät erneut, um es „wach“ zu halten, damit der Controller die Abfrage beenden kann.
  • Heilung (Heal): Klicke bei dem entsprechenden Node auf „Heal Node“, um die Nachbarschaftsbeziehungen zu aktualisieren.

5. Fehlerbehebung: „Failed“ oder „Dead“ Nodes

Geräte, die als „Dead“ markiert sind oder bei denen die Kommunikation dauerhaft fehlschlägt, können das gesamte Mesh-Netzwerk verlangsamen, da der Controller wiederholt versucht, sie zu erreichen.

Lösungsschritte für Failed Nodes:

  1. Prüfen: Stelle sicher, dass das Gerät Strom hat (Batterien prüfen oder Netzstecker kontrollieren).
  2. Ping: Klicke in der Zeile des Geräts auf den Button „Ping“. Antwortet das Gerät, springt der Status zurück auf „Alive“.
  3. Re-Interview: Wenn das Gerät „Alive“ ist, aber nicht richtig funktioniert, wähle im Menü des Nodes „Advanced“ → „Re-interview Node“.
  4. Entfernen (Remove Failed Node): Wenn ein Gerät physisch defekt oder nicht mehr vorhanden ist, muss es aus der Controller-Liste gelöscht werden:
  • Gehe zu „Actions“ → „Manage Nodes“.
  • Wähle „Remove Failed Node“.
  • Wähle den entsprechenden Node aus der Liste aus. Der Controller prüft nun ein letztes Mal, ob das Gerät antwortet. Wenn nicht, wird es endgültig gelöscht.

6. Synchronisation mit homee

Sobald das Gerät in der Z-Wave JS UI als „Ready“ markiert ist, erkennt der homee Core das neue Gerät automatisch über den internen Handler und bindet es in die homee App ein.

Best Practices für ein stabiles Mesh

  • Zuerst exkludieren: Ein „Reset“ des Geräts löst 90% der Inklusionsprobleme.
  • In der Nähe einlernen: Lerne Geräte (besonders mit Security S0/S2) in unmittelbarer Nähe des homee ein und bringe sie erst danach an ihren finalen Ort.
  • Logs prüfen: Sollte ein Gerät gar nicht reagieren, schau unter „Store“ → „zwave-js.log“ nach Fehlermeldungen wie CAN (Controller Busy) oder Timeout.
6 „Gefällt mir“