sondinetwork Logo
sondinetworkTech Innovation Hub
Zurück zu allen Artikeln
IoT

Aqara T1M via Matter in Home Assistant Cloud-Setup einbinden

admin
2 min Lesezeit
Aqara T1M via Matter in Home Assistant Cloud-Setup einbinden

Einleitung

Dieses Tutorial beschreibt die Integration der Aqara T1M Deckenleuchte über einen Aqara Hub M2 in eine Home Assistant Instanz, die auf einem Cloud-Server oder VPS betrieben wird. Da Matter ein lokales Protokoll ist, wird ein lokaler Raspberry Pi als Brücke genutzt.

Voraussetzungen:

  • Aqara Hub M2 mit aktuellster Firmware und T1M Leuchten.
  • Home Assistant Instanz auf einem Cloud-Server.
  • Lokaler Raspberry Pi mit installierter NetBird-Verbindung zum Cloud-Server.
  • Docker-Installation auf dem Raspberry Pi.

Überblick

  • Lokaler Betrieb des Matter-Servers via Docker auf dem Raspberry Pi.
  • Sichere Vernetzung von lokalem Matter-Server und Cloud-Home-Assistant via NetBird.
  • Exponieren des Aqara Hub M2 an Home Assistant mittels Matter-Pairing-Code.
  • Automatische Erkennung der T1M Entitäten (Hauptlicht und Effekt-Ring).

Schritt-für-Schritt

  1. Raspberry Pi vorbereiten: Falls Fehlermeldungen bei apt-get update auftreten (z.B. durch veraltete Signaturen unter Debian Trixie), kommentieren Sie die betroffene Quelle in /etc/apt/sources.list.d/ mit einem # aus.
  2. Docker installieren: Führen Sie das Installationsskript aus und berechtigen Sie den Nutzer pi. 
    curl -sSL https://get.docker.com | sh
sudo usermod -aG docker pi

    Melden Sie sich anschliessend einmal aus und wieder an.

  3. Matter-Server starten: Starten Sie den Python-Matter-Server Container, um die Brücke zum Netzwerk zu schlagen. 
    docker run -d \
  --name matter-server \
  --restart=unless-stopped \
  --security-opt apparmor=unconfined \
  --network=host \
  -v /home/pi/matter-data:/data \
  ghcr.io/home-assistant-libs/python-matter-server:stable
  4. Home Assistant Cloud konfigurieren: Navigieren Sie zu Einstellungen > Geräte & Dienste > Integration hinzufügen > Matter. Geben Sie die NetBird-IP Ihres Pi an: ws://100.x.x.x:5580/ws.
  5. Aqara Hub M2 koppeln: Öffnen Sie die Aqara App, wählen Sie den Hub M2 und klicken Sie auf «An Matter binden». Generieren Sie den numerischen Pairing-Code.
  6. Inbetriebnahme: Wählen Sie in Home Assistant «Matter-Gerät hinzufügen» und markieren Sie «Ja, es ist bereits im Einsatz». Geben Sie den Code aus der Aqara App ein.

Hinweise

Verwenden Sie niemals «localhost» bei der URL-Eingabe in der Cloud-Instanz, da der Matter-Server physisch im lokalen Netzwerk steht.

Stellen Sie sicher, dass die NetBird-Verbindung stabil ist, da die Kommunikation zwischen Matter-Server und Home Assistant dauerhaft über diesen Tunnel erfolgt.

Fazit

Die Aqara T1M ist nun erfolgreich über den Hub M2 in das Cloud-System integriert. Die Trennung von Haupt- und Effektlicht erlaubt präzise Automatisierungen. Als nächster Schritt bietet sich die Konfiguration von Szenen für den LED-Ring in Home Assistant an.

Ähnliche Artikel