Du möchtest deine Zigbee-Geräte nahtlos mit Home Assistant steuern, unabhängig von herstellerspezifischen Gateways? Dann ist Zigbee2MQTT genau das Richtige für dich! In diesem Artikel zeige ich dir Schritt für Schritt, wie du Zigbee2MQTT auf einem Raspberry Pi installierst und in Home Assistant einbindest.
Weitere Details zum Projekt Zigbee2MQTT sind unter folgendem Link verfügbar:
https://www.zigbee2mqtt.io/
Ich betreibe Zigbee2mqtt übrigens im Docker Container und gehe in dieser Anleitung auf diese Variante ein.
Was ist Zigbee2MQTT überhaupt?
Zigbee2MQTT ist eine Open-Source-Software, die es ermöglicht, Zigbee-Geräte über einen MQTT-Server (z.B. Mosquitto) direkt in Home Assistant oder andere Smarthome-Systeme zu integrieren. Damit bist du unabhängig von Cloud-Diensten oder proprietären Bridges.
Alles, was du brauchst, ist ein Zigbee-USB-Stick (z.B. Sonoff Dongle-P, CC2652P, etc.), ein Raspberry Pi und etwas Zeit.
Voraussetzungen
Ich betreibe das ganze unter einem RaspberryPi 3b+ mit einem SONOFF Zigbee 3.0 USB Dongle (https://amzn.eu/d/0spq7Vn)
Docker muss auf dem RaspberryPi installiert sein. Nutzt dafür gerne folgende Anleitung:
https://docs.docker.com/engine/install/debian
Installation Zigbee2MQTT als Docker Container
Vor der Installation müssen wir die Device-ID des Zigbee-Dongles auslesen. Dies geht mit folgendem Befehl:
ls -l /dev/serial/by-idDie Ausgabe sollte bei euch ungefähr so aussehen:
Nun können wir mit der Device-ID den entsprechenden Docker Container erstellen:
docker run \
--name zigbee2mqtt \
--restart=unless-stopped \
--device=/dev/serial/by-id/usb-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B0018ED3DDF-if00:/dev/ttyACM0 \
-p 8080:8080 \
-v $(pwd)/data:/app/data \
-v /run/udev:/run/udev:ro \
-e TZ=Europe/Amsterdam \
ghcr.io/koenkk/zigbee2mqtt
Passt die Device-ID (–device) mit der zuvor ausgelesenen an.
Nun sollte über den Port 8080 bereits das Zigbee2mqtt Webinterface verfügbar sein.
Die Geräte lassen sich ab diesem Moment anlernen.
Für das Anlernen der einzelnen Geräte schaut gerne in die Zigbee2mqtt Dokumentation. Hier sind so ziemlich alle Geräte aufgenommen und dokumentiert.
https://www.zigbee2mqtt.io/supported-devices
Installation Mosquitto
Um MQTT Nachrichten später an unseren Raspberry Host zu schicken ist ein MQTT Message Broker erforderlich. Ich empfehle den Mosquitto Server.
Dieser lässt sich mit folgenden Befehlen installieren:
apt update
apt install mosquitto mosquitto-clientsWir prüfen anschließend den Mosquitto Dienst mit folgenden Befehlen:
systemctl is-enabled mosquitto
systemctl status mosquitto
Wir können sehen dass der Dienst läuft und ebenfalls nach einem Neustart verfügbar ist.
Hinweis: Die Standardinstallation von Mosquitto erfolgt ohne Authentifizierung. Ich habe meine Netze entsprechend segmentiert und verzichte bei mir auf die Authentifizierung. Für das Einrichten der Authentifizierung nutzt folgende Anleitung:
https://www.howtoforge.de/anleitung/so-installierst-du-mosquitto-mqtt-message-broker-unter-debian-11/
Anbindung Homeassistant
Um nun den MQTT-Broker innerhalb von Homeassistant einzubinden geht auf „Einstellungen -> Geräte & Dienste -> Integration Hinzufügen“ und sucht hier nach „MQTT“
Für die Konfiguration tragen wir die IP-Adresse (die Adresse vom RaspberryPi), sowie den Standard Mosquitto Port 1883 ein.
Solltet ihr bereits Geräte innerhalb von Zigbee2mqtt eingerichtet haben erscheinen diese automatisch in euren Entitäten.
Die Geräte lassen sich nun entsprechend verwalten.
Ich habe folgende Zigbee Geräte im Einsatz und gute Erfahrungen mit diesen gemacht:
- sämtliche Ikea Geräte der TRÅDFRI Serie
- Heizungsthermostate der Firma Eurotronic
- Steckdosen von NOUS
- Diverse Geräte von LIDL
Der Theorie nach sollten aber alle Geräte, welche Zigbee sprechen, funktionieren. Ihr seid eben mit dieser Variante nicht nur auf einen Vendor und ein Gateway beschränkt, sondern könnt vieles probieren 🙂
Teilt gerne eure Erfahrungen und eure Smarthome Ideen/ Projekte!