Zigbee2mqtt ließ sich anfangs nur über die Konfigurationsdatei oder Zugriff auf den MQTT-Server konfigurieren und steuern.
Mittlerweile gibt es aber eine sehr nützliche Erweiterung für zigbee2mqtt die es möglich macht zigbee2mqtt über einen integrierten Webserver zu konfigurieren. Das heißt man besucht einfach eine Webseite, die über den selben Raspberry Pi erreichbar ist, auf dem auch zigbee2mqtt installiert ist.
Dort werden dann alle Konfigurationsoptionen übersichtlich und recht schick zur Verfügung gestellt. Man muss sich also nicht mehr durch die Konfigurationsdatei quälen und kann alles bequem aus dem Browser konfigurieren.
Hinweise dazu wie Ihr das Dashboard von zigbee2mqtt aktiviert und eine kurze Übersicht über die Funktionen habe ich im folgenden Artikel zusammengefasst.
Inhalte
- 1 Sicherheitshinweise
- 2 Affiliatelinks/Werbelinks
- 3 Voraussetzungen
- 4 Zigbee2mqtt Dashboard aktivieren
- 5 Dashboard aufrufen
- 6 Sprache einstellen
- 7 Neue Geräte an zigbee2mqtt anmelden
- 8 Übersicht der an zigbee2mqtt angemeldeten Geräte anzeigen
- 9 Dashboard von zigbee2mqtt
- 10 Karte / Networkmap der an zigbee2mqtt angemeldeten Geräte anzeigen
- 11 Zigbee2Mqtt konfigurieren / einstellen
- 12 Geräte als Gruppe zusammenfassen
- 13 Over the Air (OTA) Update anstoßen
- 14 Touchlink Funktion mit zigbee2mqtt nutzen
- 15 Log von zigbee2mqtt anzeigen
- 16 Design zwischen Hellem und dunklem Modus umschalten
- 17 Weitere Artikel zum Thema
- 18 Viel Spaß mit dem Projekt
Sicherheitshinweise
Ich weiß die folgenden Hinweise sind immer irgendwie lästig und wirken unnötig. Aber leider haben schon viele Menschen die es "besser" wussten aus Leichtsinnigkeit Augen, Finger oder anderes verloren bzw. sich verletzt. Im Vergleich dazu ist ein Datenverlust fast nicht der Rede Wert, aber auch diese können echt ärgerlich sein. Deswegen nehmt Euch bitte fünf Minuten Zeit um die Sicherheitshinweise zu lesen. Denn auch das coolste Projekt ist keine Verletzung oder anderen Ärger wert.
https://www.nerdiy.de/sicherheitshinweise/
Affiliatelinks/Werbelinks
Die hier in aufgeführten Links zu Online-Shops sind sogenannte Affiliate-Links. Wenn Du auf so einen Affiliate-Link klickst und über diesen Link einkaufst, bekommt Nerdiy.de von dem betreffenden Online-Shop oder Anbieter eine Provision. Für Dich verändert sich der Preis nicht. Falls Du Deine Einkäufe über diese Links tätigst unterstützt Du Nerdiy.de dabei auch in Zukunft weitere nützliche Projekte anbieten zu können. 🙂
Voraussetzungen
Hilfreiche Artikel:
Bevor ihr mit diesem Artikel startet solltet ihr einen RaspberryPi soweit vorbereitet haben, dass dieser über das Netzwerk erreichbar und per SSH Steuerbar ist. Außerdem sollte natürlich zigbee2mqtt bereits installiert sein.
Die folgenden Artikel beschreiben was zu tun ist um den RaspberryPi soweit vorzubereiten.
- Zigbee – Installation von zigbee2mqtt auf dem Raspberry Pi
- Zigbee – Geräte, Sensoren und Aktoren an zigbee2mqtt anmelden
In der folgenden Listen findet Ihr alle Teile die Ihr zur Umsetzung dieses Artikels benötigt.
Benötigtes Werkzeug:
Benötigtes Material:
Zigbee2mqtt Dashboard aktivieren
Standardmäßig ist das Dashboard von zigbee2mqtt (noch) nicht aktiviert.
Um es zu aktivieren reicht ein einfacher Eintrag in der Konfigurationsdatei von zigbee2mqtt.
Öffnet dazu die Konfigurationsdatei mit dem folgenden bash Befehl.
sudo nano /opt/zigbee2mqtt/data/configuration.yaml
Navigiert dann mit den Pfeiltasten bis zum Ende der Konfigurationsdatei und fügt dort den unten stehenden Teil in die Konfigurationsdatei ein.
Dabei solltet Ihr unbedingt das Passwort (auth_token) anpassen. Dies wird später benötigt um das Dashboard zu öffnen.
frontend: port: 8080 host: 0.0.0.0 auth_token: secretPassword url: https://url.org
Weitere Infos zu den Konfigurationsoptionen des Dashboard findet ihr auch unter folgendem Link.
Dashboard aufrufen
Das Dashboard kann über einen einfachen Webbrowser geöffnet werden. Dazu müsst Ihr lediglich die Adresse des Raspberry Pi auf dem zigbee2mqtt installiert ist in der Adresszeile Eures Browser eingeben. Wichtig dabei ist, dass Ihr die Adresse um den in der Konfigurationsdatei definierten Port ergänzt.
Wenn der Raspberry Pi zum Beispiel unter er Adresse “ADRESSE_DES_PIS” erreichbar ist und der konfigurierte Port “8083” lautet, so würdet Ihr das zigbee2mqtt Dashboard unter folgender Adresse erreichen.
- http:// ADRESSE_DES_PIS :8038/
Sprache einstellen
Die erste Einstellung die Ihr vermutlich verändern wollt ist die Sprache des Dashboards.
Über ein einfaches Menü könnt Ihr das Dashboard nämlich auf Eure gewünschte Sprache einstellen. Klickt dazu einfach auf das Flaggensymbol in der oberen Menüleiste des Dashboards und wählt Eure gewünschte Sprache aus.
Neue Geräte an zigbee2mqtt anmelden
Über das Dashboard könnt Ihr auch sehr leicht neue zigbee Geräte anmelden. Früher musste dazu die Konfigurationsdatei verändert oder Nachrichten über MQTT versendet werden.
Über das Dashboard ist dieser Vorgang erheblich erleichtert. Hier reicht ein Klick und zigbee2mqtt erlaubt das hinzufügen neuer Zigbee-Sensoren bzw. Aktoren.
Wie man Zigbee-Geräte hinzufügt habe ich etwas ausführlicher auch im folgenden Artikel beschrieben.
Um neue Geräte zu zigbee2mqtt hinzufügen zu können reicht ein Klick auf den gezeigten Button in der oberen Menüleiste.
Daraufhin ist es möglich neue Zigbee-Geräte hinzuzufügen.
Diese Erlaubnis wird automatisch nach Ablauf von 255 Sekunden wieder deaktiviert.
Übersicht der an zigbee2mqtt angemeldeten Geräte anzeigen
Nun ein paar Worte zu den einzelnen Menüpunkten des zigbe2mqtt Dashboard.
In der oberen Menüleiste könnt Ihr unter dem Reiter “Devices” alle an Eure zigbee2mqtt Installation angemeldete Geräte einsehen. Hier ist auf einem Blick der “Friendly Name”, die IEEE Adresse, der Hersteller, das Modell, die Signalstärke und ggf. der Ladezustand zu sehen. Über das letzte Icon wird außerdem angezeigt ob das jeweilige Gerät von einer Batterie oder Netzstrom versorgt wird.
Dashboard von zigbee2mqtt
Der nächste Reiter im Menü des Dashboard ist der “Dashboard”-Reiter. Hier werden ebenfalls die meisten Zigbee-Geräte aufgelistet. Der Unterschied hier ist, dass die angemeldeten Geräte auch gesteuert bzw. ausgelesen werden können.
Dazu sind die einzelnen Zigbee-Geräte in Kacheln zusammengefasst. Jede Kachel steht dabei für ein Zigbee-Gerät. Dabei ist das Aussehen der Kachel je nach Geräteart unterschiedlich.
Links seht Ihr die Ansicht der Dashboard-Kachel für einen Xiaomi Aqara MCCGQ11LM Tür- bzw. Fenstersensor.
Dabei sind die folgenden Daten einsehbar:
- Friendly Name
- Name des ersten Status
- Name des zweiten Status
- Zustand des ersten Status
- Zustand des zweiten Status
- “Last seen”-Zeitstempel
- Empfangsstärke-Icon
- Empfangsstärke im Wertebereich 0-255 (größer besser)
- Ladezustand bzw. Versorgungsart
Links seht Ihr die Ansicht der Dashboard-Kachel für eine IKEA Lampe LED1903C5/LED1835C6.
Dabei sind die folgenden Daten einsehbar:
- Friendly Name
- Name des ersten Status
- Name des zweiten Status
- Name des dritten Status
- Zustand des ersten Status
- Zustand des zweiten Status
- Zustand des dritten Status
- “Last seen”-Zeitstempel
- Empfangsstärke-Icon
- Empfangsstärke im Wertebereich 0-255 (größer besser)
- Ladezustand bzw. Versorgungsart
Karte / Networkmap der an zigbee2mqtt angemeldeten Geräte anzeigen
Eine wirklich coole Funktion um einen Überblick über die verbundenen Geräte zu bekommen ist der Map-Reiter.
In diesem werden nicht nur alle Geräte gezeigt. Es ist auch sichtbar wie diese untereinander verbunden sind. Manche Endgeräte sind nämlich nicht immer direkt mit dem Zigbee-USB-Dongle verbunden. Viele Netzstrombetriebene Geräte fungieren nämlich auch als Repeater bzw. Router für das Zigbee Netzwerk. So kann ein Endgerät indirekt über einen Router mit dem Zigbee-USB-Dongle verbunden sein. So eine Konfiguration wird mithilfe der Map-Ansicht sehr gut sichtbar.
Damit die Network-Map angezeigt wird müsst Ihr zunächst auf den “Load Map”-Button klicken.
Dadurch wird die Netzwerk-Konfiguration abgerufen und kurz darauf angezeigt.
Zigbee2Mqtt konfigurieren / einstellen
Hinter dem Settings-Reiter verbergen sich die meisten Einstellungen für zigbee2mqtt.
Die meisten Einstellungen könnt Ihr also hier konfigurieren ohne die Konfigurationsdatei von zigbee2mqtt bearbeiten zu müssen.
Geräte als Gruppe zusammenfassen
Eine andere hilfreiche Funktion verbirgt sich hinter dem Groups-Reiter. Hier könnt Ihr nämlich Zigbee-Geräte in Gruppen zusammenfassen.
So lassen sich zum Beispiel zwei oder mehr Lampen zu einer Gruppe zusammenfassen und zentral steuern. Schaltbefehle werden so zu jeder Lampe der Gruppe parallel weitergeleitet. Dies ist zum Beispiel dann praktisch, wenn Ihr alle Lampen in einem Kronleuchter gleichzeitig schalten wollt.
Over the Air (OTA) Update anstoßen
Der OTA-Reiter bietet die Möglichkeit (wenn verfügbar) ein Over-the-Air (OTA) Update auf den Zigbee-Geräten auszuführen.
Falls also eine neue Firmware für Eure Zigbee-Sensoren bzw. Aktoren verfügbar ist, könnt Ihr diese sehr leicht mithilfe eines einfachen Klicks auf das jeweilige Gerät übertragen.
Touchlink Funktion mit zigbee2mqtt nutzen
Die Optionen für die Touchlink-Funktion findet Ihr im Touchlink-Reiter. Diese Funktion ist vor allem von IKEA Zigbee-Geräten bekannt und ist praktisch, wenn Ihr Geräte einfach und schnell koppeln wollt.
Dazu müsst Ihr die Touchlink-Funktion aktivieren und das zu verbindende Gerät nah an die Zigbee-Basisstation (zum Beispiel der Sonoff zigbee 3.0 USB Dongle Plus) halten.
Hinweise wie Ihr Geräte zu Eurem Zigbee-Netzwerk hinzufügen könnt findet Ihr auch in dem folgenden Artikel.
Log von zigbee2mqtt anzeigen
Besonders zum debuggen und zum anmelden neuer Zigbee-Geräte ist es praktisch die Log-Ausgabe von zigbee2mqtt anzeigen zu können.
In dem Logs-Reiter könnt Ihr (je nach eingestelltem Log level) alle Status Änderungen in zigbee2mqtt sehen.
Mithilfe von einfachen Filtermöglichkeiten könnt Ihr hier auch noch einstellen welche Nachrichten ihr sehen wollt und auch nach welchem log level diese gefiltert werden sollen.
Design zwischen Hellem und dunklem Modus umschalten
Mit dem Sonnen- bzw. Mond-Icon könnt Ihr das aussehen Eures zigbee2mqtt Dashboards zwischen dunklem und hellem design wechseln. Klickt dazu einfach auf die rot markierten Icons und das Design wird entsprechend angepasst.
Links seht ihr die “helle” Ansicht des Dashboards von zigbee2mqtt.
Durch einen Klick auf die Sonne im rot markierten Bereich könnt Ihr das Design zum dunklen Design umschalten.
Hier seht ihr die “dunkle” Ansicht des Dashboards von zigbee2mqtt.
Durch einen Klick auf den Mond im rot markierten Bereich könnt Ihr das Design zum hellen Design umschalten.
Weitere Artikel zum Thema
Weitere Artikel zum Thema Zigbee bzw. zigbee2mqtt habe ich in der folgenden Kategorie zusammengefasst. Dort findet Ihr auch Artikel zu diversen Zigbee Geräten und wie diese aus NodeRed angesteuert werden können.
In der folgenden Kategorie habe ich außerdem einige Zigbee-Geräte aufgelistet welche sich mit dem dort angebotenen NodeRed code ansteuern bzw. auslesen lassen.
Viel Spaß mit dem Projekt
Ich hoffe bei euch hat alles wie beschrieben funktioniert. Falls nicht oder ihr Fragen oder Anregungen habt lasst es mich in den Kommentaren bitte wissen. Ich trage dies dann ggf. in den Artikel nach.
Auch Ideen für neue Projekte sind immer gerne willkommen. 🙂
P.S. Viele dieser Projekte - besonders die Hardwareprojekte - kosten viel Zeit und Geld. Natürlich mache ich das weil ich Spaß daran habe, aber wenn Du es cool findest, dass ich die Infos dazu mit Euch teile, würde ich mich über eine kleine Spende an die Kaffeekasse freuen. 🙂
Danke für die Artikelserie zu zigbee2mqtt. Habe diese Funktion bisher mit homegear realisiert und dann in NodeRED meine Verknüpfungen erstellt. Dies scheint mir aber deutlich komfortabler zu sein!
Hi Werner,
danke für dein Feedback. 🙂
Beste Grüße
Fabian
Hallo, mein Name ist Dietmar,
ich habe es versucht, und bis zum Dashboard klappt aus alles. Zigbee2mQtt hat auch den Test gut durchlaufen.
Allerding kann ich das Dashbord nicht aufrufen. Ich habe die Einträge in die “configuration” Datei vorgenommen, aber wenn ich versuche, von außen zuzugreifen, dann bekomme ich die Meldung, die Seite sei nicht erreichbar. Wo habe ich was vergessen? Hat der Stick eine eigene Adresse? Wohl eher ich.
Für Hilfe bin ich dankbar.
Viele Grüße
Dietmar
Hi Dietmar,
Kannst du mal prüfen ob du beim aufruf der Adresse auch den korrekten Port genutzt hast?
Wenn du in der Konfiguration den Port 8080 eingestellt hast musst du das Dashboard wie folgt aufrufen: http://:ADRESSE_DES_PIS:8080
Ich merke gerade, dass mein Beispiel dahingehend etwas irreführend ist. 🙂
Beste Grüße
Fabian
Hallo Fabian,
vielen Dank für die schnelle Antwort.
Ja, den Port habe ich eingetragen, sogar versuchshalber den Port explizit im Router für den Raspi gesetzt.
Hat aber nichts gebracht.
Also wie gesagt, den Test hat Zigbee2mqtt gut durchlaufen.
Viele Grüße
Dietmar
P.S.: Unter ADRESSE_DES_PIS gebe ich die Adresse XXX.XXX.XXX.YYY ein
Hallo Dietmar,
SUPER Zusammenfassung !! Hst Duvielleich eie Idee wie man Heizkörperthermostatventile gruppiert und dann auch steuert ?? (Gruppieren selbst bekomme ich hin – in meinem Fall mit mehreren HAMA/Saswell Ventilen) ABER wie steuert man das Ganze?? Ich kann Szenen über das WebGui erstellen – aber die haben irgendwie keinerlei Funktion, bzw beim Abrufen über das WebGui ändert sich keine Einstellung der einzelnen Ventile). Noch obskurer wird es wenn ich dann die Gruppe in DOMOTIZ ansteuern möchte – da ist das ganze dann nur ein einfacher Switch.
Bonjour
Est-il possible de commuter directement une lampe ou un module Zigbee via zigbee2mqtt
dans le genre : http:// ADRESSE_IP :8083/Light1/switch_on ??
Merci