zigbee2mqtt

Zigbee2MQTT ? ?

Ermöglicht Ihnen die Verwendung Ihrer Zigbee-Geräte ohne die Bridge oder das Gateway des Anbieters.

Es überbrückt Ereignisse und ermöglicht Ihnen die Steuerung Ihrer Zigbee-Geräte über MQTT. Auf diese Weise können Sie Ihre Zigbee-Geräte in jede von Ihnen verwendete Smart-Home-Infrastruktur integrieren.

Erste Schritte

Die Dokumentation liefert Ihnen alle Informationen, die Sie für die Inbetriebnahme benötigen! Stellen Sie sicher, dass Sie keine Abschnitte überspringen, wenn dies Ihr erster Besuch ist, da dort möglicherweise wichtige Details für Sie enthalten sind.

Wenn Sie mit der Zigbee -Terminologie nicht vertraut sind, lesen Sie dies unbedingt durch, um weiterzuhelfen.

Integrationen

Zigbee2MQTT lässt sich gut in (fast) jede Hausautomationslösung integrieren, da es MQTT verwendet. Erwähnenswert sind jedoch folgende Integrationen:

Heimassistent

• Home Assistant OS: Verwendung des offiziellen Add-ons
• Andere Installation: Verwenden Sie die Anweisungen hier

Gemütlich

• Integration in der Homey App implementiert
• Dokumentation und Support im Homey Forum

Domoticz

• Integration in Domoticz implementiert (Dokumentation).

Gladys Assistentin

• Integration nativ in Gladys Assistant implementiert (Dokumentation).

IoBroker

• Integration in IoBroker implementiert (Dokumentation).

Architektur

Interne Architektur

Zigbee2MQTT besteht aus drei Modulen, die jeweils in einem eigenen Github-Projekt entwickelt wurden. Ausgehend von der Hardware (Adapter) und nach oben; zigbee-herdsman stellt eine Verbindung zu Ihrem Zigbee-Adapter her und stellt den höheren Ebenen des Stacks eine API zur Verfügung. Für Hardware von Texas Instruments verwendet zigbee-herdsman beispielsweise die TI zStack-Überwachungs- und Test-API, um mit dem Adapter zu kommunizieren. Zigbee-Herdsman kümmert sich um die Kernkommunikation von Zigbee. Das Modul zigbee-herdsman-converters übernimmt die Zuordnung einzelner Gerätemodelle zu den von ihnen unterstützten Zigbee-Clustern. Zigbee-Cluster sind die Schichten des Zigbee-Protokolls über dem Basisprotokoll, die beispielsweise festlegen, wie Lichter, Sensoren und Schalter über das Zigbee-Netzwerk miteinander kommunizieren. Schließlich steuert das Zigbee2MQTT-Modul Zigbee-Herdsman und ordnet die Zigbee-Nachrichten MQTT-Nachrichten zu. Zigbee2MQTT verfolgt außerdem den Zustand des Systems. Es verwendet eine database.db Datei, um diesen Status zu speichern; eine Textdatei mit einer JSON-Datenbank der angeschlossenen Geräte und ihrer Funktionen. Zigbee2MQTT bietet eine webbasierte Schnittstelle, die Überwachung und Konfiguration ermöglicht.

Entwicklung

Zigbee2MQTT verwendet TypeScript (vorerst teilweise). Daher müssen Sie Zigbee2MQTT neu kompilieren, nachdem Sie Änderungen an Dateien im lib/ -Verzeichnis vorgenommen haben. Dies kann durch Ausführen von npm run build erfolgen. Für eine schnellere Entwicklung können Sie anstelle von npm run build npm run build-watch in einer anderen Terminalsitzung ausführen. Dadurch wird eine Neukompilierung durchgeführt, wenn Sie Dateien ändern. Beim ersten Mal vor dem Erstellen müssen Sie npm install --include=dev ausführen. Bevor Sie Änderungen übermitteln, führen Sie npm run test-with-coverage , npm run pretty:check und npm run eslint

Unterstützte Geräte

Unter Unterstützte Geräte können Sie prüfen, ob Ihr Gerät unterstützt wird. Die Liste ist recht umfangreich und umfasst Geräte von Anbietern wie Xiaomi, Ikea, Philips, OSRAM und mehr.

Wenn es nicht unter „Unterstützte Geräte“ aufgeführt ist, kann die Unterstützung (ziemlich) einfach hinzugefügt werden, siehe So unterstützen Sie neue Geräte.

Unterstützung und Hilfe

Wenn Sie Hilfe benötigen, können Sie offene Probleme überprüfen. Helfen Sie gerne mit Pull Requests, wenn Sie Probleme reparieren oder neue Geräte hinzufügen konnten, oder teilen Sie einfach Ihre Liebe in den sozialen Medien.