Wie bekommst du Zigbee-Geräte in Home Assistant? Ein USB-Stick ist der Anfang. Damit du deine Geräte anschließend steuern und automatisieren kannst, müssen aber noch ein paar Komponenten miteinander sprechen.

Ich habe mit Zigbee2MQTT gute Erfahrungen gemacht und zeige dir den Weg vom Zigbee-Stick über den MQTT-Broker bis zum ersten Gerät in Home Assistant. Als Beispiel nutzen wir den Aqara Smart Pet Feeder C1. Anschließend bauen wir ein Dashboard mit Fütterungsplan und einer Erinnerung zum Nachfüllen auf.

Zum Video: MQTT und Zigbee2MQTT mit dem Aqara C1

Werbung / Kooperation: Das begleitende Video entstand in Kooperation mit Aqara. Die inhaltliche Gestaltung lag bei mir.

Zigbee, MQTT und Zigbee2MQTT: Was macht welche Komponente?

Bevor wir installieren, schauen wir uns die einzelnen Aufgaben an:

Zigbee ist das Funkprotokoll, über das unser Futterspender kommuniziert.
Der Zigbee-Stick verbindet das Zigbee-Netz mit unserem Home-Assistant-Rechner.
Zigbee2MQTT spricht mit dem Stick und übersetzt zwischen Zigbee und MQTT.
Der Mosquitto-Broker vermittelt MQTT-Nachrichten zwischen den verbundenen Programmen.
Die MQTT-Integration verbindet Home Assistant mit dem Broker und stellt die Gerätefunktionen als Entitäten bereit.

MQTT arbeitet nach dem Prinzip Veröffentlichen und Abonnieren. Ein Programm veröffentlicht eine Nachricht unter einem Thema, dem sogenannten Topic. Der Broker verteilt diese Nachricht an die Programme, die das Topic abonniert haben. So tauschen Zigbee2MQTT und Home Assistant Zustände und Befehle aus. Mehr dazu findest du in der MQTT-Dokumentation von Home Assistant.

Unsere Verbindung sieht damit so aus:

Aqara C1 ↔ Zigbee-Stick ↔ Zigbee2MQTT ↔ Mosquitto ↔ MQTT-Integration ↔ Home Assistant

Das klingt zunächst nach vielen Teilen. Sobald diese Verbindung steht, kannst du weitere unterstützte Zigbee-Geräte über dieselbe Infrastruktur hinzufügen.

Was du dafür brauchst

Wir arbeiten wie im Video mit Home Assistant OS und installieren die benötigten Programme als Apps. In älteren Versionen heißt dieser Bereich noch „Add-ons“.

Du benötigst:

Ein laufendes Home-Assistant-System, beispielsweise den Home Assistant Green.
Einen von Zigbee2MQTT unterstützten Zigbee-Koordinator.
Ein USB-Verlängerungskabel.
Ein kompatibles Zigbee-Gerät – in unserem Beispiel den Aqara Smart Pet Feeder C1.

Falls du gerade erst einsteigst, findest du die Grundlagen in meinem Beitrag Home Assistant: Einstieg Schritt für Schritt.

Die Gerätekommunikation läuft in dieser Einrichtung lokal. Der Futterspender wird nicht in dein WLAN eingebucht. Trotzdem ist die Funkplanung wichtig: Zigbee und 2,4-GHz-WLAN teilen sich dasselbe Frequenzband und können sich gegenseitig stören.

1. Zigbee-Stick anschließen

Im Video verwende ich einen Sonoff-USB-Stick. Verbinde deinen Koordinator über ein USB-Verlängerungskabel mit dem Home-Assistant-Rechner. Dadurch bekommt er Abstand zum Rechner und möglichen Störquellen. Auch Zigbee2MQTT empfiehlt diese Maßnahme bei Verbindungsproblemen.

Den Gerätepfad findest du unter:

Einstellungen → System → Hardware → Gesamte Hardware

Suche dort den Eintrag deines Sticks und notiere den Gerätepfad. Verwende möglichst den Eintrag unter /dev/serial/by-id/.

Wichtig: Derselbe Stick darf nicht gleichzeitig von ZHA und Zigbee2MQTT verwendet werden. In dieser Anleitung übernimmt Zigbee2MQTT den Koordinator.

2. Mosquitto als MQTT-Broker installieren

Öffne Einstellungen → Apps → App installieren, suche nach Mosquitto broker und installiere die App.

Für Zigbee2MQTT brauchen wir Zugangsdaten. Im Video lege ich einen eigenen Login in der Mosquitto-Konfiguration an. Verwende dafür einen eigenen Benutzernamen und ein langes, individuelles Passwort.

Speichere die Einstellungen, starte die App und prüfe die Protokolle. Der übliche MQTT-Port für diese lokale Einrichtung ist 1883.

3. Zigbee2MQTT installieren und konfigurieren

Gehe zurück zur App-Installation. Öffne oben rechts das Menü mit den drei Punkten und wähle Repositories.

Füge diese Quelle hinzu:

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

Anschließend findest du Zigbee2MQTT in der Übersicht. Installiere die normale Version. Die Edge-Version verfolgt den Entwicklungsstand und ist für diesen Einstieg nicht erforderlich.

Starte die App und aktiviere Beim Systemstart starten. Bei Bedarf kannst du außerdem den Watchdog einschalten und die Benutzeroberfläche in der Seitenleiste anzeigen lassen. Der Ablauf steht auch im offiziellen App-Repository.

Das Onboarding

Öffne die Benutzeroberfläche und gehe die Ersteinrichtung durch:

Wähle deinen Zigbee-Stick unter den gefundenen Geräten aus.
Falls er nicht erkannt wird, hinterlege den zuvor notierten Gerätepfad und den passenden Adaptertyp.
Trage den nächstgelegenen 2,4-GHz-WLAN-Kanal ein, damit die Zigbee-Kanalwahl ihn berücksichtigen kann.
Aktiviere das Frontend und die Home-Assistant-Anbindung.
Trage die MQTT-Serveradresse sowie Benutzername und Passwort ein.

Bei der hier verwendeten Mosquitto-App lautet die interne Serveradresse:

mqtt://core-mosquitto:1883

Als Client-ID kannst du beispielsweise zigbee2mqtt verwenden. Diese muss am Broker eindeutig sein. Die Client-ID ersetzt weder Benutzername noch Passwort. Die Einstellungen beschreibt die Zigbee2MQTT-App-Dokumentation.

Speichere mit Submit und warte auf den Start. Erscheint kurz „502 Bad Gateway“, gib der App etwas Zeit und lade die Oberfläche neu. Bleibt der Fehler bestehen, prüfe die Protokolle.

Wähle den Funkkanal möglichst vor dem Anlernen. Eine spätere Änderung kann bei einzelnen Geräten erneutes Pairing erfordern. Mehr dazu findest du unter Zigbee-Netzwerk konfigurieren.

4. Den Aqara C1 anlernen

Jetzt verbinden wir unseren Futterspender:

Halte die Reset-Taste am C1 etwa fünf Sekunden gedrückt, bis die LED schnell blinkt.
Aktiviere in Zigbee2MQTT Beitritt erlauben.
Warte, bis das Gerät erkannt und die Einrichtung abgeschlossen ist.
Vergib einen verständlichen Namen, beispielsweise „Katzenfutterspender“.
Beende anschließend die Beitrittsfreigabe.

Falls das Pairing nicht funktioniert, beachte die Hinweise auf der Zigbee2MQTT-Geräteseite zum C1. Bei manchen Geräten hilft es, zunächst die zwei Signaltöne abzuwarten und erst danach den Beitritt freizugeben.

Lege die Namen deiner Entitäten möglichst fest, bevor du Automationen darauf aufbaust.

5. MQTT mit Home Assistant verbinden

Der Broker läuft und Zigbee2MQTT kennt den Futterspender. Jetzt fehlt die Verbindung zu Home Assistant.

Öffne Einstellungen → Geräte und Dienste. Die MQTT-Integration wird normalerweise bereits vorgeschlagen. Richte sie ein. Falls sie fehlt, wähle Integration hinzufügen → MQTT.

Anschließend findest du unter MQTT die Bridge und den Futterspender. Ordne ihn dem Bereich zu, in dem er tatsächlich steht.

Was der Aqara C1 mitbringt

Der C1 besitzt einen abnehmbaren Vier-Liter-Vorratsbehälter und einen Napf mit Edelstahleinsatz. Wie viele Kilogramm Trockenfutter hineinpassen, hängt von der Futtersorte ab.

Am Gerät gibt es eine Taste für die manuelle Ausgabe und eine Aufnahmefunktion für eine Sprachnachricht. Die Aufnahme lässt sich über die hier gezeigte Home-Assistant-Anbindung nicht bedienen. Die Wiedergabe klingt für mich außerdem recht mechanisch.

Die Stromversorgung erfolgt über USB. In meinem Lieferumfang war kein USB-Netzteil enthalten. Zusätzlich lassen sich drei D-Batterien einsetzen. Diese versorgen allerdings nur den Feeder, nicht deinen Home-Assistant-Rechner.

Über Zigbee2MQTT steuern wir den C1 in dieser Einrichtung ohne zusätzlichen Aqara-Hub. Die verfügbaren Funktionen findest du auf der Zigbee2MQTT-Geräteseite, die Herstellerangaben auf der Aqara-Produktseite.

Dashboard und Automationen: Das ZIP-Paket installieren

Im Video zeige ich ein Katzendashboard mit Fütterungszeiten, Wochentagen und Portionszahlen. Dazu kommen Tagesportionen, die letzte angeforderte Ausgabe, Tastensperre, Fehlerstatus und ein geschätzter Restvorrat.

Die Kartenidee stammt aus diesem Community-Beitrag zur Aqara C1 Pet Feeder Card. Für die Weitergabe gibt es ein eigenes Paket mit Dashboard-Karte, Helfern, Scripts, Fütterungsautomation und Nachfüll-Erinnerung.

Download: Aqara-C1-Dashboard und Automationen v1.0.0

Schritt 1: ZIP entpacken

Erstelle zuerst eine Sicherung deiner Home-Assistant-Konfiguration. Lade anschließend das Paket herunter und entpacke es auf deinem Rechner.

Das ZIP wird nicht als Home-Assistant-Backup wiederhergestellt. Wir übernehmen gezielt diese Dateien:

packages/aqara_c1_feeder.yaml
dashboards/katzenfutter.yaml
www/community/aqara-c1-feeder-card.js

Voraussetzung ist ein bereits über Zigbee2MQTT eingerichteter C1.

Schritt 2: Deine Entitäts-IDs eintragen

Öffne die Dateien packages/aqara_c1_feeder.yaml und dashboards/katzenfutter.yaml in einem Texteditor.

Ersetze darin YOUR_FEEDER durch die passenden Namen deiner Geräteentitäten. Du findest sie unter Einstellungen → Geräte und Dienste → MQTT → dein Futterspender.

Das Paket erwartet:

binary_sensor.YOUR_FEEDER_error – Fehlerstatus.
select.YOUR_FEEDER_mode – Betriebsmodus mit der Option manual.
number.YOUR_FEEDER_serving_size – Anzahl der auszugebenden Portionen.
select.YOUR_FEEDER_feed – Ausgabe über die Option START.
sensor.YOUR_FEEDER_weight_per_day – gemeldete Tagesmenge in Gramm.
sensor.YOUR_FEEDER_portions_per_day – ausgegebene Tagesportionen.
switch.YOUR_FEEDER_child_lock – Tastensperre.

Prüfe jede vollständige ID. Falls deine Entitäten unterschiedliche Namensbestandteile haben, reicht ein pauschaler Austausch des Präfixes nicht aus.

Die eigenen Helfer mit dem Präfix aqara_c1_ bleiben unverändert.

Schritt 3: Die Package-Datei kopieren

Kopiere die angepasste Datei aqara_c1_feeder.yaml nach:

/config/packages/aqara_c1_feeder.yaml

Erstelle den Ordner packages, falls er noch fehlt. Je nach Dateieditor wird /config als /homeassistant angezeigt.

Du kannst die Datei beispielsweise über einen Dateieditor mit Upload-Funktion, Studio Code Server oder eine vorhandene Netzwerkfreigabe übertragen.

Schritt 4: Packages aktivieren

Öffne deine Home-Assistant-Datei configuration.yaml und ergänze die Package-Einbindung:

homeassistant:
  packages: !include_dir_named packages

Falls bereits ein homeassistant:-Abschnitt vorhanden ist, ergänze darunter nur die Zeile packages:. Lege keinen zweiten Abschnitt mit demselben Schlüssel an.

Wenn du Packages schon verwendest, füge die Datei in deine bestehende Struktur ein. Weitere Informationen liefert die Home-Assistant-Dokumentation zu Packages.

Die Package-Datei enthält bereits die Helfer, Scripts und Automationen. Du musst die Fütterungsautomation und die Nachfüll-Erinnerung deshalb nicht zusätzlich im visuellen Editor anlegen.

Schritt 5: Die Dashboard-Karte kopieren

Kopiere die Datei aus www/community/ im ZIP an diesen Ort:

/config/www/community/aqara-c1-feeder-card.js

Erstelle fehlende Ordner. Prüfe anschließend deine Home-Assistant-Konfiguration und starte Home Assistant neu.

Schritt 6: Die JavaScript-Ressource hinzufügen

Öffne Einstellungen → Dashboards → Ressourcen. Falls der Menüpunkt fehlt, aktiviere den erweiterten Modus in deinem Benutzerprofil.

Füge folgende Ressource hinzu:

/local/community/aqara-c1-feeder-card.js?v=1.0.0

Wähle als Typ JavaScript-Modul.

Verwaltest du Ressourcen bereits über YAML, übernimm stattdessen den Eintrag aus examples/resources.yaml in deine vorhandene Ressourcenliste.

Schritt 7: Das Dashboard erstellen

Erstelle unter Einstellungen → Dashboards ein neues, leeres Dashboard.

Verwende den URL-Pfad:

katzen-futter

Öffne das Dashboard, aktiviere den Bearbeitungsmodus und öffne den Rohkonfigurationseditor. Füge dort den vollständigen, bereits angepassten Inhalt von dashboards/katzenfutter.yaml ein.

Speichere die Konfiguration. Die JavaScript-Ressource aus dem vorherigen Schritt gehört nicht in diesen Editor.

Das Dashboard verwendet die Ansicht plan. Damit lautet sein Pfad:

/katzen-futter/plan

Diesen Pfad verwendet auch die Nachfüll-Erinnerung. Wenn du ihn änderst, musst du den Link in der Automation anpassen.

Schritt 8: Den Fütterungsplan testen

Bei der ersten Einrichtung legt das Paket als Beispiel 07:00 und 18:00 Uhr mit jeweils einer Portion an. Der Plan bleibt zunächst ausgeschaltet.

Stelle den Feeder auf den Modus manual. Prüfe geräteeigene Zeitpläne und deaktiviere eine bisherige Home-Assistant-Fütterungsautomation, bevor du den neuen Plan aktivierst.

Teste zunächst bei ausgeschaltetem Plan die Funktion Jetzt füttern. Sie fordert eine echte Futterausgabe an.

Wenn das funktioniert, passe Zeiten, Wochentage und Portionen an und aktiviere den Plan.

Wichtig: Dieser Zeitplan läuft in Home Assistant. Home Assistant, Mosquitto und Zigbee2MQTT müssen zu den Fütterungszeiten funktionieren. Verpasste Zeiten werden nicht nachgeholt. Die Anzeige „Letzte Ausgabe angefordert“ bestätigt den Befehl, nicht die tatsächlich im Napf gelandete Menge.

Futtervorrat schätzen und ans Nachfüllen erinnern

Die zweite Funktion finde ich besonders praktisch: Home Assistant erinnert mich daran, den Behälter zu prüfen und nachzufüllen.

Der C1 liefert dafür keinen gemessenen Behälterfüllstand. Wir berechnen eine Schätzung:

Restvorrat = Gesamtmenge nach dem Auffüllen − gemeldeter Verbrauch seit dem Auffüllen

Die Grammangaben hängen von der eingestellten Portionsmenge ab. Wiege deshalb eine typische Portion und hinterlege den passenden Grammwert in der Geräteeinstellung portion_weight. Auch Aqara beschreibt diese Kalibrierung bei den Fütterungsstatistiken.

So aktivierst du die Vorratsschätzung:

Fülle den Behälter und ermittle die gesamte Futtermenge darin.
Trage diese Menge unter Vorrat nach Auffüllen ein.
Stelle deine Nachfüllgrenze ein, beispielsweise 100 g.
Drücke Aufgefüllt.

Die eingetragene Menge entspricht der gesamten Menge im Behälter nach dem Auffüllen, nicht nur dem zusätzlich eingefüllten Futter.

Bis zum ersten Bestätigen bleibt der Restvorrat nicht verfügbar. Sinkt die Schätzung unter die Grenze, erscheint eine Benachrichtigung in Home Assistant. Sie wird einmal pro Füllung erzeugt.

Nach dem nächsten Auffüllen trägst du die neue Gesamtmenge ein und drückst erneut Aufgefüllt.

Die Erinnerung erscheint in Home Assistant. Ein Handy-Push ist im Paket nicht eingerichtet. Die Schätzung kann außerdem durch Portionsschwankungen oder fehlende Verbrauchsmeldungen während eines Ausfalls abweichen.

Wenn etwas nicht funktioniert

Zigbee2MQTT startet nicht: Prüfe Gerätepfad, Adaptertyp und ob eine andere Anwendung den Stick verwendet.
Keine Verbindung zu Mosquitto: Prüfe Serveradresse, Benutzername, Passwort und die Einstellung für vorgehashte Passwörter.
Gerät fehlt in Home Assistant: Prüfe die MQTT-Integration und die Home-Assistant-Anbindung in Zigbee2MQTT.
Unbekannte Dashboard-Karte: Prüfe Dateipfad und JavaScript-Ressource. Lade anschließend den Browser vollständig neu.
Fütterungsplan reagiert nicht: Prüfe Planaktivierung, Modus manual, Fehlerstatus, Entitäts-IDs und Home-Assistant-Zeitzone.
Restvorrat ist nicht verfügbar: Trage die Füllmenge ein und drücke erstmals Aufgefüllt.

Weitere Hinweise findest du in der README.md des ZIP-Pakets. Die darin enthaltenen YAML-Helfer und Automationen werden in der Paketdatei gepflegt und lassen sich nicht vollständig im visuellen Editor bearbeiten.

Mein Fazit

Für Anfänger ist diese Einrichtung durchaus eine Herausforderung. Wir brauchen einen Zigbee-Stick, Zigbee2MQTT, einen MQTT-Broker und die MQTT-Integration. Sobald die Aufgaben der einzelnen Komponenten klar sind, lässt sich die Verbindung aber gut nachvollziehen.

Beim Aqara C1 geht es anschließend über das reine Schalten hinaus: Ich kann Fütterungszeiten im Dashboard verwalten und bekomme einen Hinweis, wenn der geschätzte Vorrat knapp wird. Genau solche Abläufe machen Home Assistant für mich interessant.

Wenn du Automationen besser verstehen möchtest, schau dir meinen Beginner-Guide zum Automationseditor an. Wie KI bei Dashboards und der Analyse deines Systems helfen kann, zeige ich im Beitrag KI baut kostenlos Dashboards und prüft dein Smart Home.

Welches Zigbee-Gerät möchtest du als Nächstes in Home Assistant einbinden? Schreib es gern in die Kommentare.

Bis bald, euer Tristan.

Zigbee2MQTT in Home Assistant einrichten – Schritt für Schritt erklärt