zigbee2mqtt Home Assistant Add-On einrichten

  • Beitrags-Kommentare:7 Kommentare

In der Welt der Hausautomatisierung gibt es viele Funkstandards, die es den Geräten ermöglichen nahtlos miteinander zu kommunizieren und ein vernetztes Zuhause zu schaffen. Einer der vielversprechendsten und am weitesten verbreiteten Standards ist Zigbee – eine drahtlose Kommunikationstechnologie, die nicht nur eine breite Palette von intelligenten Geräten unterstützt, sondern auch eine Fülle von Vorteilen bietet.

Die Vorteile sind:

  • energieeffiziente Kommunikation
  • Robustes MESH Netzwerk
  • sehr große Anzahl an Geräten
  • Sicherheit und Datenschutz

Daher geht es in diesem Beitrag, um die Installation von zigbee2mqtt.

zigbee2mqtt kann als Erweiterung (Add-On) in Home Assistant installiert werden, um Zigbee Geräte in Home Assistant zu integrieren. Home Assistant selbst bietet mit ZHA (Zigbee Home Automation) ebenfalls eine eigene Integration. zigbee2mqtt, kurz Z2M, ist aus meiner Erfahrung heraus die umfangreichere Lösung, weshalb ich die Installation und Konfiguration in diesem Artikel vorstellen werde.

Damit zigbee2mqtt funktioniert benötigt es ebenfalls das Home Assistant Ad-On Mosquitto. Im Gegensatz zu Z2M ist Mosquitto ein offizielles Add-On und kann direkt über den Add-On Store installiert werden. Z2M muss als Repository erst hinzugefügt werden.

Los gehts!

Home Assistant Grundlagen Kurs fuer Einsteiger
Home Assistant Grundlagen Kurs fuer Einsteiger

Mosquitto MQTT Broker installieren

Damit die MQTT Informationen verarbeitet werden können benötigt es einen MQTT Broker. Mosquitto ist solch ein Broker, derr über den Add-On Store installiert werden kann. Das Add-On findet sich im Store unter:

Einstellungen > Add-Ons > Add-On Store > Mosquitto Broker

Als nächstes die Installation ausführen

Mosquitto Broker Add-On installieren.

Nach der Installation ist innerhalb des Add-On keine weitere Konfiguration notwendig und das Add-On kann gestartet werden. Dadurch wird eine neue Integration erstellt, die im Bereich der Integrationen automatisch Entdeckt wird.

MQTT Broker Integration konfigurieren

MQTT Benutzer anlegen

Als nächstes empfehle ich immer einen dedizierten Benutzer anzulegen. Das geht im Bereich:

Einstellungen > Personen > Benutzer

Im folgenden Dialog lediglich die Felder ausfüllen und das Benutzerkonto erstellen. Ich beschränke die Anmeldung auf das lokale Netzwerk.

MQTT Benutzer anlegen

Damit der MQTT Broker den erstellten Benutzer verwendet muss die Broker Konfiguration geändert werden. Das geht unter:

Einstellungen > Geräte und Dienste > MQTT

Jetzt auf Konfigurieren klicken.

MQTT Konfiguration ändern

Dann auf MQTT Neu konfigurieren gehen.

MQTT Konfiguration ändern

In diesem Dialog kann der Standard Benutzer geändert werden, welcher bei der Installation angelegt wird.

MQTT Broker Konfiguration ändern und Benutzer hinzufügen

Nun mit weiter bestätigen und den Wizard mit der neuen Benutzer Konfiguration ohne weitere Änderungen beenden.

SONOFF Zigbee Gateway, ZBDongle-E 3.0 USB Dongle Plus,EFR32MG21 + CH9102F/CP2102N Zigbee USB-Stick...
  • SONOFF Zigbee Dongle plus vorgeflasht mit...
  • Der Zigbee USB Stick unterstützt Smart Home...
  • SONOFF Zigbee hub SMA-Schnittstelle externe...
  • Based on EFR32MG21 + CH9102F/CP2102N, +20dBm...
  • SONOFF Zigbee 3.0 USB Dongle Plus kann mit den...

zigbee2mqtt Add-On installieren

zigbee2mqtt ist kein offizielles Home Assistant Add-On, weshalb eine Installation erst möglich ist nachdem das Repository hinzugefügt wurde. Das Repository ist im Prinzip der Speicherort mit den Installationsdateien, der Home Assistant bekannt gemacht werden muss.

Hierzu einfach das Github Repo über den Link unten öffnen und über die blaue My Add Integration Schaltfläche das Repository hinzufügen.

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Im nächsten Dialog prüfen, dass die URL der Home Assistant Instanz die richtige ist und ggf. anpassen. Im Weiteren mit Open Link fortfahen.

Home Assistant URL für HA Add-On

Jetzt wird das Repository mit hinzufügen Home Assistant bekannt gemacht.

zigbee2mqtt Repository hinzufügen

Nun einmal den Browser aktualisieren damit das Add-On zur Installation zur Verfügung steht. Anschließend zurück in den Add-On Store wechseln. Es sollte mehrere neue Einträge zur Installation von zigbee2mqtt zur Verfügung stehen. Die erste Karte installiert die stabile Version!

zigbee2mqtt Sabile Version

Als nächstes kann das Add-On installiert werden.

zigbee2mqtt installieren

Nachdem die Installation angeschlossen ist muss die Konfiguration im entsprechenden Register angepasst werden.

zigbee2mqtt Konfiguration

Im Bereich mqtt wird der zuvor angelegte Benutzer und das Passwort hinterlegt

user: dein Benutzer
password: dein Passwort

Im Bereich serial wird das Zigbee Gateway definiert. Das erfolgt durch Angabe des Ports und des Adapter Typs. Der Port ist in diesem Fall das Zigbee Gateway. Hier muss das Gerät ermittelt werden. Ich empfehle statt dem Geräte Pfad immer die Geräte ID zu benutzen. Diese wird ermittelt in:

Einstellungen > System > Hardware > Gesamte Hardware

Sonoff Dongle Plus E Geräte ID in Home Assistant

Der Adapter ist: ezsp

Der Adapter Typ beschreibt, dass hier ein Zigbee Gateway benutzt wird, welches den Silcon Chip nutzt, wie Home Assistant Yellow oder Sky Connect auch.

Jetzt noch die Konfiguration speichern und den Adapter starten! Um über die Seitenleiste auf das Frontend zugreifen zu können noch den Schalter aktivieren.

zigbee2mqtt starten
SONOFF Zigbee Gateway, ZBDongle-E 3.0 USB Dongle Plus,EFR32MG21 + CH9102F/CP2102N Zigbee USB-Stick...
  • SONOFF Zigbee Dongle plus vorgeflasht mit...
  • Der Zigbee USB Stick unterstützt Smart Home...
  • SONOFF Zigbee hub SMA-Schnittstelle externe...
  • Based on EFR32MG21 + CH9102F/CP2102N, +20dBm...
  • SONOFF Zigbee 3.0 USB Dongle Plus kann mit den...

Fazit zigbee2mqtt Add-on

Über die Benutzeroberfläche können jetzt Geräte angelernt sowie weitere Einstellungen getätigt werden. zigbee2mqtt hat im Weiteren noch folgende Vorteile

Weitere Home Assistant Beiträge findest du hier.

Die komplette Installation als auch weitere Details gibt es im dazugehörigen Youtube Video zu diesem Artikel.

Dieser Beitrag hat 7 Kommentare

  1. Eberhard Kraft

    Habe Home Assistant Yellow.
    Muss ich ZHA abschalten (deinstallieren?) um den Dongle zu nutzen, oder kann beides nebeneinander laufen?
    (bin Home Assistant Neuling und muss mich mit dem System vertraut machen)
    Eberhard

    1. Udo Berndt

      Hallo Eberhard,
      ja bitte ZHA deaktivieren. Du kannst den Dongle nur mit einer Integration verwenden. Wenn gleichzeitig ZHA und zigbee2mqtt aktiviert sind führt dies zu Problemen.

      Viele Grüße
      Udo

      1. Eberhard Kraft

        Hallo Udo,
        danke für die schnelle Antwort.
        Habe noch eine Frage:
        ZHA deaktivieren (wird nicht wieder beim Neustart aktiviert?), Dongle (habe mir den Sonoff gekauft) einstecken,
        und dann nach der Anleitung zigbee2mqtt einrichten.
        Danach alle ZigBee Geräte neu anlernen?
        Viele Grüße
        Eberhard

  2. Eberhard Kraft

    habe noch etwas vergessen:
    ZHA deaktivieren oder löschen?
    Viele Grüße
    Eberhard

    1. Udo Berndt

      Deaktivieren reicht aus.

  3. Hans Peter Durand

    Hallo Udo,
    Besten Dank für die genau, detaillierte Anleitung. Hier habe ich gefunden wo bei mir der „der Hase im Pfeffer“ liegt (Thema „adapter: ezsp“). Somit bin ich in der Lage „ZHA“ (produktive Umgebung) und „zigbee2mqtt“ (Testumgebung) zu vergleichen.

    Herzliche Grüsse aus der Schweiz

    Hans Peter

    1. Udo Berndt

      Hallo Hans Peter,

      es freut mich, dass du den Blog und damit die Lösung gefunden hast.
      Veröffentliche regelmäßig neue Beiträge. Schau gerne wieder vorbei!

      Viele Grüße,
      Udo

Schreibe einen Kommentar