Von: Simon

Mit Home Assistant ZigBee Geräte steuern über Zigbee2MQTT

Suchst du nach einer Möglichkeit, deine ZigBee-Geräte mit Home Assistant zu steuern? In diesem Video erfährst du, wie ZigBee2MQTT dir dabei helfen kann.

ZigBee2MQTT ist ein Add-on, mit dem du dich durch einen ZigBee-Stick mit ZigBee-Geräten verbinden und sie von Home Assistant über einen MQTT-Broker (Mosquitto) steuern kannst. Das ganze funktioniert sehr zuverlässig, ist extrem schnell 🚀 und es werden unglaublich viele Geräte unterstützt.

Außerdem ist es Open Source und kostenlos, also probiere es noch heute aus 🙌

Falls du prüfen willst, ob dein ZigBee Geräte mit ZigBee2MQTT kompatibel ist oder wissen möchtest, wie du den Pairing-Modus aktivieren kannst, kannst du auf der offiziellen Seite nachschauen.

Inhaltsverzeichnis

Voraussetzungen

  1. Home Assistant Installation auf Raspberry Pi
  1. www.zigbee2mqtt.io
  2. Empfohlene Adapter
  3. Mosquitto (MQTT Broker)
  4. Link für die Add-on Repository:
    https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Der ZigBee USB-Stick

Home Assistant
SONOFF Zigbee 3.0 USB Dongle Plus,TI CC2652P + CP2102(N)*
SONOFF Zigbee 3.0 USB Dongle Plus,TI CC2652P + CP2102(N)
ZigBee
Prime  Preis: € 34,99 Zu Amazon*
Preis inkl. MwSt., zzgl. Versandkosten
Zuletzt aktualisiert am 28.01.2023 um 21:03 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

Hinweis zur V2 Version des Sticks

Vielen Dank nochmals an Andy für den Hinweis, dass es den Stick mittlerweile in einer 2ten Version mit verändertem Chipsatz gibt:

Den Sonoff Stick gibt es mittlerweile in einer V2 Edition. Das ist auf der Verpackung (und bei meiner Bestellung) nur bei sehr genauem Hinsehen zu erkennen. Das Ding heißt immer noch “Zigbee USB 3.0 Dongle Plus”. Auf der Rückseite des Dongles ist aber die Modellnummer “ZBDongle-E” zu lesen. Gemäß den Herstellerangaben wird hier aber ein andere Chipsatz ( “EFR32MG21”) verbaut. Um diese Version mit Zigebee2MQTT zum Laufen zu bringen, muss in der Config YAML unter Serial neben dem Port noch der zusätzlich der Wert “adapter: ezsp” eingetragen werden. Ohne diesen Wert kann Zigbee2MQTT nicht auf den Adapter zugreifen und startet nicht durch. Diese Option hat aktuell noch den Status “Experimental”, bei mir läuft’s aber bisher stabil.

https://www.youtube.com/watch?v=PR-ugz1uLWc&lc=UgwM0rwRbVFqgJWpYuN4AaABAg

Addon-Konfiguration für die Sticks

SONOFF Zigbee 3.0 USB Dongle Plus ZBDongle-P (CC2652P)

Dies ist die Version, die auch im Video genutzt wurde.

serial:
  port: /dev/ttyUSB0

Sonoff Zigbee 3.0 USB Dongle Plus ZBDongle-E (EFR32MG21)

Dies ist die neuere Version des Chipsatzes.

serial:
  port: /dev/ttyUSB0
  adapter: ezsp

Port herausfinden

Neben dem gezeigten Weg im Video gibt es noch eine weitere Möglichkeit:

  1. Im SSH-Addon den Befehl ls -l /dev/serial/by-id eingeben
  2. Der Port wird rechts nach dem -> angezeigt, aber ohne /dev/
  3. port des zigbee sticks uber ssh herausfinden
  4. In diesem Beispiel wäre also port: /dev/ttyUSB0 korrekt

Alternative Addon-Konfigurationen

Hier noch ein paar weitere Konfigurationen für andere Hardware (nicht der Sonoff-Stick, diese sind hier oben drüber ☝)

Diese Hardware habe ich nicht selber getestet, es handelt sich um Feedback aus der Community. Vielen Dank an euch alle 🙌

SONOFF ZBBridge

Zuletzt aktualisiert am 29.01.2023 um 07:30 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.
serial:
    port: 'tcp://IP.Adresse.Der.Bridge:20108'
    adapter: ezsp

ConBee / ConBee II / RaspBee / RaspBee II

Zuletzt aktualisiert am 29.01.2023 um 07:30 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

Über USB angeschlossene Adapter (ConBee und ConBee II) und Raspberry Pi GPIO Module (RaspBee und RaspBee II). Wenn Zigbee2MQTT nicht startet, versuche Folgendes:

serial:
  adapter: deconz

Home Assistant SkyConnect

Home Assistant SkyConnect
Quelle: https://www.home-assistant.io/skyconnect/
serial:
  port: >-
    /dev/serial/by-id/usb-Nabu_Casa_SkyConnect_v1.0_2e07db08b114ed11a749bc8be054580b-if00-port0
  adapter: ezsp

Schau dir auch gerne den zugehörigen Beitrag zum SkyConnect an, indem du auch erfährst, wie man den Coordinator (Funk-Stick) von ZigBee2MQTT tauschen kann!

Fehlerbehebung

Was tun, wenn Zigbee2MQTT nicht startet?

  1. Der Zugriff auf den Stick darf nicht durch ZHA oder andere Integrationen / Add-ons blockiert werden. Wenn diese eingerichtet waren, bitte deaktivieren oder löschen!
  2. Das Mosquitto-Addon (oder dein eigener MQTT-Broker) muss bereits gestartet sein, bevor Zigbee2MQTT gestartet wird! (Kann zu 502: Bad Gateway Fehlern führen)
  3. Kontrolliere, ob du die richtige Konfiguration für deinen Stick hast ☝
  4. Home Assistant Host neu starten
  5. Port des Zigbee-Sticks kontrollieren
  6. Zigbee2MQTT deinstallieren, Home Assistant Host neu starten, Zigbee2MQTT wieder installieren
  7. Was sagen die Log-Files des Add-on?
  8. Wenn du dir die Add-on-Konfiguration als YAML anzeigen lässt (3 Punkte oben rechts in der Ecke): Stimmt die Datei überein, mit deinen eingegebenen Werten? (Besonders der Abschnitt serial:)
  9. Zigbee2MQTT Add-on starten und dann erst den Stick anschließen 👇
  10. Du nutzt RaspberryMatic? Schau mal hier

ZigBee2MQTT startet nicht, wenn der Stick eingesteckt ist

Bei manchen Installationen kommt es vor, dass Zigbee2MQTT erst gestartet sein muss und anschließend der Stick an den USB-Port gesteckt werden muss. Sonst kommt es beim Starten von Zigbee2MQTT zu Fehlermeldungen, wie beispielsweise der hier:

'AddonManager.Install' blocked from execution, system is not healthy

Davor muss aber der Port (port: /dev/ttyUSB0) schon angegeben wurden sein.

Im Zweifelsfall also einfach mal testen und danke an Maikel für das Feedback 😉

Geräte tauchen in Home Assistant nicht auf

Wenn die Geräte zwar in Zigbee2MQTT sind, aber nicht in Home Assistant als Entität auftauchen, ist vermutlich mit dem MQTT-Broker irgendwas im Argen.

Hinweis: Ich gehe hier mal davon aus, du nutzt wie im Video gezeigt Mosquitto und hast dieses Add-on bereits gestartet.

  1. (Empfohlen) Ist die MQTT-Integration wie im Video ab 14:20 zu sehen eingerichtet?
  2. Falls das nicht klappt, kannst du alternativ versuchen, folgenden Code in diene configuration.yaml hinzuzufügen:
mqtt:
  broker: http://homeassistant.local

Natürlich musst du http://homeassistant.local gegebenenfalls gegen deine eigenen Home Assistant URL oder die deines MQTT-Brokers austauschen.

ZigBee Reichweite verbessern

Die Reichweite von ZigBee wird durch alle “Router”-fähigen Geräte erweitert (fast alle Geräte, die an der Steckdose betrieben werden). Falls das nicht reicht, gibt es noch zusätzlich folgende Optionen:

2,4 GHz Antenne

Zuletzt aktualisiert am 29.01.2023 um 07:30 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

Prinzipiell funktioniert jede, oben ist nur die, die ich benutze. Bringt etwas mehr LQI, aber vor allem funktionieren bei mir nun die Geräte mit geringem LQI deutlich zuverlässiger.

Der Aufstellungsort ist essenziell, möglichst entfernt von Störquellen und ohne Metall bzw. dicke Wände im “Weg” zu den Geräten.

Zigbee-Repeater von Ikea

Apple Home (HomeKit) Google Home Alexa Home Assistant
TRÅDFRI Signalverstärker (ZigBee)*
TRÅDFRI Signalverstärker (ZigBee)
Zentrale ZigBee
 Preis: € 12,99 Zu IKEA!*
Preis inkl. MwSt., zzgl. Versandkosten
Zuletzt aktualisiert am 29.01.2023 um 07:30 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

Siehe hier: https://www.zigbee2mqtt.io/devices/E1746.html

ZigBee-Kanal ändern

In ZigBee2MQTT kannst du den Standard-Kanal 11 des 2,4 GHz-Bandes wechseln. Denn genau wie bei WLAN (auch 2,4 GHz), überlagern sich diese Kanäle gegenseitig und angenommen dein WLAN funkt auch auf Kanal 11, kann es zu Störungen kommen.

Generell empfehle ich immer den Kanal eher am WLAN-Router zu ändern (also einen anderen Kanal als 11), da du, wenn du ihn in ZigBee2MQTT änderst, alle Geräte neu anlernen musst.

Falls du das trotzdem machen willst, kannst du das in den Add-on-Einstellungen (Code als YAML anzeigen) wie folgt tun:

advanced:
  # Optional: ZigBee channel, changing requires re-pairing of all devices. (Note: use a ZLL channel: 11, 15, 20, or 25 to avoid Problems)
  # (default: 11)
  channel: 6

Anschließend musst du noch, falls der Stick bereits angesteckt war, die Datei coordinator_backup.json löschen (Auffindbar über das File Editor Add-on)

Hinweis zu Schaltern & Dimmern

Bei manchen Geräten wie Fernbedienungen, Schaltern und Co. kann es sein, dass man für die Schalter-Aktionen Home Assistant Automationen erstellen muss.

Häufig gibt es hierfür aber bereits Blueprints (also Vorlagen für Automationen) in denen lediglich das Gerät ausgewählt werden muss und dann für jede mögliche Aktion, wie das Drücken einer Taste, eine Zeil-Entität ausgewählt werden kann 👇

Aquara Cube

Apple Home (HomeKit) Home Assistant
Aqara Cube, Zigbee-Verbindung, 6 Anpassbare Gesten*
Aqara Cube, Zigbee-Verbindung, 6 Anpassbare Gesten
Zentrale ZigBee
Prime  Preis: € 18,99 Zu Amazon*
Preis inkl. MwSt., zzgl. Versandkosten
Zuletzt aktualisiert am 29.01.2023 um 07:30 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

Zigbee2MQTT – Xiaomi Cube Controller Blueprint

Hue Dimmer

Zuletzt aktualisiert am 29.01.2023 um 07:30 . Wir weisen darauf hin, dass sich hier angezeigte Preise inzwischen geändert haben können. Alle Angaben ohne Gewähr.

Hue Dimmer Switch Universal Blueprint

Ikea Fernbedienung (5 Buttons)

Ikea 5 Button Remote

Zigbee2Mqtt – IKEA five button remote

Geräte für HA

Mehr Geräte für Home Assistant, HACS oder auch Alexa, Google Home, HomeKit sowie Homebridge findest du in unserem Smart Home Gerätefinder!

Hardware für Home Assistant

Dein Home Assistant ist langsam, reagiert unzuverlässig oder stürzt ab? Du hast noch gar keinen am Laufen?

Im Beitrag unten findest du empfehlenswerten Hardware & Tipps, damit dein Home Assistant so richtig gut läuft und dein Smarthome schnell wie der Blitz wird 🚀

Fazit

Wenn du also nach einer Möglichkeit suchst, deine ZigBee-Geräte mit dem Home Assistant zu steuern, oder einfach nur einen einfachen und zuverlässigen Weg suchst, all deine ZigBee-Zentralen in den Home Assistant zu vereinen, dann schau dir ZigBee2MQTT an.

Es ist schnell, quelloffen und kostenlos. Was kann man mehr verlangen?

close
HomeKit Geräte Übersicht

smarte News

Erfahre als Erster, wenn wir neue Artikel zu Smart Home oder anderen interessanten Themen veröffentlichen!

Wir senden keinen Spam und verkaufen keine Daten! Erfahre mehr in unserer Datenschutzerklärung.

Die Anzeige der Produkte wurde mit dem affiliate-toolkit Plugin umgesetzt.

Gründer von simon42. Schreibt hier ehrlich und leidenschaftlich über Smart Home und Technik Themen, denn das Zuhause wurde bereits von Sprachassistenten übernommen und die Kontrolle abgegeben 😁 Kaffeespende

Abonnieren
Benachrichtige mich bei
guest
49 Comments
Newest
Oldest Most Voted
Inline Feedbacks
Alle Kommentare anzeigen

Send this to a friend