Das Z-Wave JS-Plugin ermöglicht volle Kontrolle über das Z-Wave-Heimautomatisierungsprotokoll in Jeedom basierend auf der Arbeit rund um die sehr berühmte Bibliothek Z-Wave JS-Benutzeroberfläche.
Das Z-Wave JS-Plugin macht Übertragungen zuverlässiger und sicherer, indem es das verwendet MQTT-Protokoll, Gleichzeitig bieten sie den erfahrensten Benutzern erweiterte Verwaltungsmöglichkeiten ihres Z-Wave-Netzwerks.
WICHTIG
Dieses Plugin ist kompatibel mit Debian 11 „Bullseye“ und ist daher das offizielle Plugin, das bevorzugt wird, um Ihr Z-Wave-Netzwerk in Jeedom zu verwalten.
Nach der Installation und Aktivierung des Plugins sollte die Installation von Abhängigkeiten beginnen, es sei denn, die automatische Verwaltung wurde zuvor deaktiviert. In diesem Fall müssen Sie auf die Schaltfläche klicken Beleben um diese Installationsphase einzuleiten. Das offizielle Plugin MQTT-Manager Da es Teil der notwendigen Abhängigkeiten ist, wird es während des Betriebs automatisch installiert und aktiviert, falls dies nicht bereits der Fall ist.
Der Rest der Abhängigkeiten besteht aus dem Herunterladen, Kompilieren und Konfigurieren der Bibliothek Z-Wave JS-Benutzeroberfläche.
INFORMATION
Die erste Installation von Abhängigkeiten einschließlich einer Kompilierungsphase dauert je nach Hardwarekonfiguration wahrscheinlich mehrere zehn Minuten. Abhängigkeitsaktualisierungen lassen sich anschließend viel schneller installieren.
Bei der Konfiguration des Plugins ist der wesentliche Punkt die richtige Auswahl der Z-Wave-Controller-Port entsprechend der physikalischen Schnittstelle, an der der Controller angeschlossen ist.
Andere mögliche Einstellungen sind :
Die von jeedom hinzugefügten spezifischen Module (zusätzlich zu den von zwavejs unterstützten) sind natürlich nicht mehr kompatibel
Wenden Sie die empfohlene Konfiguration an : wendet direkt den vom Jeedom-Team empfohlenen Konfigurationssatz an, wenn ein neues Modul hinzugefügt wird (conseillé).
Ausgeschlossene Geräte löschen : entfernt automatisch Geräte, die vom Z-Wave-Netzwerk ausgeschlossen sind, wenn diese Option aktiviert ist. Andernfalls bleibt das Gerät in Jeedom, auch wenn es vom Netzwerk ausgeschlossen wurde. Das Gerät muss dann manuell gelöscht oder wiederverwendet werden, indem ihm eine neue Z-Wave-Kennung zugewiesen wird.
zwave).Sicherheitsschlüssel müssen an einem sicheren Ort aufbewahrt werden. Wenn Sie diese Schlüssel verlieren, müssen die im sicheren Modus enthaltenen Geräte erneut gekoppelt werden. Die Schlüssel können angegeben werden, wenn die Felder leer oder ungültig sind, generiert das Plugin sie und Sie können sie später anzeigen.
WICHTIG
Wenn Ihr Controller mit dem Openzwave-Plugin verwendet wurde und Sie Module im sicheren Modus eingebunden hatten, ist die S0-Taste : “0102030405060708090A0B0C0D0E0F10”.
Wie in der Präambel erläutert, benötigt das Z-Wave JS-Plugin Unterstützung für das MQTT-Protokoll, um zu kommunizieren, das offizielle Plugin MQTT-Manager wird daher als Unterstützung für diese Kommunikation dienen.
Mehrere Szenarien sind möglich :
Sie verwenden noch keinen MQTT-Broker : In diesem Fall haben Sie nichts zu tun. Plugins Z-Wave JS und MQTT-Manager tauscht die notwendigen Informationen und Konfigurationen automatisch aus (ein „Mosquitto“-Broker wird lokal auf der Maschine installiert).
Sie verwenden bereits das MQTT Manager-Plugin : Es ist kein Eingreifen erforderlich, das Z-Wave JS-Plugin ruft automatisch die Verbindungsinformationen zum MQTT-Broker ab.
Sie verwenden bereits einen MQTT-Broker über ein anderes Plugin als MQTT Manager : In dieser Situation müssen Sie den Modus auswählen Remote-Broker und Anmeldedaten angeben (Adresse und Authentifizierung) in der MQTT Manager-Plugin-Konfiguration.
Sie möchten einen MQTT-Broker unter Docker verwenden : Sie müssen lediglich den Modus auswählen lokaler Broker Docker in der MQTT Manager Plugin-Konfiguration vor der Installation von Mosquitto.
In jedem Fall muss der MQTT-Manager-Plugin-Daemon gestartet werden, bevor Sie fortfahren können. Andernfalls werden Sie durch eine Meldung gewarnt, die den Start des Z-Wave JS-Daemons verhindert.
Es ist auch wichtig, den Fall des Vorhandenseins des OpenZwave-Plug-ins parallel zum Z-Wave-JS-Plug-in zu adressieren, beispielsweise die Zeit, um von einem zum anderen zu wechseln (Siehe Absatz Migration von OpenZwave).
Zunächst einmal sollten Sie wissen, dass es absolut kein Risiko gibt, die Z-Wave JS- und OpenZwave-Plugins parallel zu verwenden. Selbst bei Schwierigkeiten mit dem Z-Wave JS-Plugin reicht es aus, seinen Daemon zu stoppen und den des OpenZwave-Plugins neu zu starten, um ein genau identisches und funktionierendes Z-Wave-Netzwerk zu finden.
Es ist daher notwendig, die automatische Verwaltung zu stoppen und dann den OpenZwave-Plugin-Daemon zu stoppen, um den Z-Wave JS-Plugin-Daemon starten zu können. Wenn nicht, werden Sie erneut durch eine Meldung gewarnt, die den Start des Z-Wave JS-Daemons verhindert.
WICHTIG
Löschen Sie keine Geräte vorzeitig aus dem OpenZwave-Plugin, auch wenn es während des Tests deaktiviert wurde!
Wenn nicht anders angegeben, kann jetzt der Z-Wave JS-Daemon gestartet werden. Andernfalls sollte eine Meldung auf der Plugin-Konfigurationsseite erscheinen, um den Grund für die Blockierung zu identifizieren.
Wenn Sie das Z-Wave JS-Plugin mit einem leeren Controller verwenden, wird das Z-Wave-Netzwerk sofort gestartet und ist verfügbar, bereit für Moduleinbindungen.
Bei Verwendung mit einem Controller, der bereits in einem Z-Wave-Netzwerk enthalten ist, muss das Plugin funktionieren, das die Ausrüstung automatisch in Jeedom hochlädt, wenn die Module interviewt werden. Die erste vollständige Entdeckung eines Z-Wave-Netzwerks wird daher wahrscheinlich lange dauern, abhängig von der Art der verwendeten Module und ihrer Kommunikationsfrequenz.
Die Module erscheinen in zwei Stufen :
node id ohne Bild und ohne Identifikation.Sobald alle Module am Netz initiiert und somit identifiziert wurden, ist es wichtig, die Module am Batteriebetrieb aufzuwecken oder darauf zu warten, dass sie aufwachen. Erst ab diesem Moment können wir das Netzwerk als vollständig gestartet betrachten.
INFORMATION
Im Gegensatz zum OpenZwave-Plug-in erfolgt nach dieser ersten Interviewphase ein sofortiger Neustart des Netzwerks.
Wenn, am Ende dieser Phase (das kann lang sein, erinnern wir uns), Sie feststellen, dass ein Modul, das vom Openzwave-Plug-in gut unterstützt wurde, vom Z-Wave JS-Plug-in nicht unterstützt wird, laden wir Sie ein, auf den Absatz zu verweisen Modul nicht oder schlecht erkannt.
Im Gegensatz zum Openzwave-Plugin gibt es keinen speziellen Abschnitt zum Konfigurieren von Modulen. Tatsächlich erfolgt die Konfiguration eines Moduls über die Befehlsklasse Configuration. Dies ist daher unter den anderen Klassenbefehlen des Moduls in sichtbar Werte.
Mit dieser Schaltfläche auf der Seite eines Geräts können Sie die Informationen des Moduls über mehrere Registerkarten anzeigen :
Zusammenfassung : Zeigt alle Modulidentifikationsinformationen sowie Statusinformationen an.
INFORMATION
Normalerweise sollten Sie diese Funktionen nie berühren müssen, das Plugin erledigt dies selbst.
Statistiken : Wie der Name schon sagt, ermöglicht es Ihnen, die Kommunikationsstatistiken des Moduls anzuzeigen.
Mit dieser Schaltfläche auf der Geräteseite können Sie die Liste aller Befehle der Z-Wave-Klasse abrufen, die vom Modul verwaltet werden.
Jedes kann durch Klicken aufgeklappt werden, um alle Steuerelemente anzuzeigen (nützlich oder nicht) bezogen auf diesen Klassenbefehl.
Dieses Fenster bietet viele Möglichkeiten :
Diese Schaltfläche auf der Seite eines Geräts wird verwendet, um die Zuordnungen des Moduls zu verwalten und zu :
Die Taste Einschlüsse vorhanden auf der Seite, die alle Z-Wave-Geräte JS gruppiert, ermöglicht es Ihnen, den Controller in den Modus zu schalten Aufnahme (Standard, S0, S2) oder im Modus Ausschluss.
INFORMATION
Momentan sind S2-Inklusionen nicht direkt aus dem Plugin möglich. Diese Funktion wird in einem zukünftigen Update implementiert, da die Plugin-Engine bereits gut S2-kompatibel ist.
Denken Sie daran, dass in Z-Wave alle Module, aus denen das Netzwerk besteht, direkt mit dem Controller verbunden sind. Einige Controller mit Batterie (wie der Aeon-labs Z-Stick GEN5) Sie können sogar Module einschließen, ohne in eine Box gesteckt zu werden.
Die Taste Zu synchronisieren ermöglicht es dann, die vom Controller identifizierten Geräte automatisch in Jeedom zu erstellen. Nach der gleichen Idee werden die Geräte, die Peripheriegeräten entsprechen, die von der Steuerung ausgeschlossen sind, automatisch gelöscht, wenn die Option verfügbar ist Ausgeschlossene Geräte löschen ist in der allgemeinen Konfiguration des Plugins aktiviert.
Bevor Sie in Betracht ziehen, dauerhaft vom OpenZwave-Plugin zum Z-Wave JS-Plugin zu wechseln, müssen Sie unbedingt sicherstellen, dass alle Netzwerkmodule vollständig unterstützt werden. Dieser Schritt kann leicht mehrere Tage dauern, um alle Möglichkeiten und Szenarien zu validieren.
Sobald Sie sicher sind, dass das OpenZwave-Plugin nicht mehr erforderlich ist, können Sie das verwenden Austausch von Geräten und Steuerungen des Kerns, um Ihre vorhandene Ausrüstung schnell und einfach auf das neue Plugin zu migrieren.
Wenn Sie feststellen, dass ein Modul nicht oder schlecht vom Z-Wave JS-Plugin erkannt wird während es vom OpenZwave-Plugin gut unterstützt wurde, Sie müssen zuerst sicherstellen, dass die Daten im Fenster vorhanden sind Werte (zugänglich von der Ausrüstungsseite) gut aktualisieren, wenn das Modul physisch betätigt wird.
Sobald Sie sicher sind, dass das Modul selbst gut erkannt wird und dass seine Werte aktualisiert werden, ist dies erforderlich, wenn bestimmte Befehle nicht funktionieren’Öffnen Sie eine Jeedom-Supportanfrage durch zwingende Bereitstellung der folgenden Elemente :
Um weiter zu gehen, können Sie das Modul physisch aktivieren und Screenshots der aufeinanderfolgenden Wertänderungen machen, immer noch im Wertefenster des Knotens.
WICHTIG
Wir bestehen darauf, dass das Team zunächst nur Anfragen für Modulkonfigurationen bearbeitet, die alle oben angeforderten Elemente enthalten und bereits mit dem Openzwave-Plugin funktionieren. Sie können Ihre Screenshots möglicherweise nicht hinzufügen, wenn Sie das Ticket erstellen. Machen Sie sich keine Sorgen, Sie können sie später als Antwort auf Ihre Anfrage senden.
INFORMATION
Durch die physische Bedienung des Moduls können Sie die Zeile identifizieren, deren Werte sich entsprechend im Fenster Knotenwerte ändern und deren Befehl nicht erstellt oder funktionsfähig wäre. Am Ende der Zeile befindet sich eine Schaltfläche mit einem stiftförmigen Symbol, mit der Sie automatisch den entsprechenden Befehl erstellen können, und haben so die Möglichkeit, Ihr Modul trotz fehlender oder fehlerhafter Konfiguration verwenden zu können.
Ist es möglich, die Z-Wave JS-Benutzeroberfläche im Remote-Modus zu verwenden? ?
Die Roadmap des Jeedom-Teams zum Z-Wave JS-Plugin sieht tatsächlich die Hinzufügung dieser Möglichkeit in den kommenden Monaten ohne jegliche Dringlichkeit vor, da es sich nicht um eine wesentliche Funktionalität für das ordnungsgemäße Funktionieren des Plugins handelt.
Ist es möglich, den Z-Wave JS UI-Websocket-Server zu aktivieren? ?
Für die ordnungsgemäße Funktion des Plugins und von Jeedom im Allgemeinen ist es nicht möglich, den Z-Wave JS UI-Websocket-Server zu aktivieren, der kommende Remote-Modus wird jedoch dieselben Anwendungsfälle ermöglichen.