HOWTO: Lokale Anbindung Alexa und Home Assistant mit Matter

Es gibt verschiedene Möglichkeiten Alexa und Home Assistant miteinander zu verbinden, hier eine kurze Anleitung, wie man es Lokal über Matter machen kann.

Möglichkeiten der Anbindung

Es gibt verschiedenste Möglichkeiten, Home Assistant mit Alexa zu verbinden. Anfänglich hatte ich eine Hue Bridge, da funktionierte es über den  Philips Hue Skill. Nachdem Umstieg auf einen Zigbee Stick, gab es noch die Möglichkeit eine Hue Bridge mit Home Assistant zu simulieren. Das funktionierte bei mir aber nie richtig, bzw. hatte ich es höchstwahrscheinlich nie richtig konfiguriert. Seit meinem Versuchen, hat sich auch in der Alexa App einiges geändert.

Zum Schluss gibt es natürlich noch Alexa über die Home Assistant Cloud zu verbinden. Damit ist eine monatliche Gebühr verbunden, die sich bei uns nicht auszahlen würde, weil die Akzeptanz der Steuerung über Alexa bei meinen Mitbewohnern nicht sehr hoch ist.

Anbindung über Matter

Für mich neu ist jetzt die Anbindung über Matter, und das erfolgt noch dazu lokal, benötigt also keine Cloud.  (TODO: funktioniert Steuerung auch wenn es kein Internet gibt?)  Dazu wird ein Add-On benötigt, und zwar die matterbridge-home-assitant-addon bzw. den Nachfolger home-assistant-matter-hub, der sich derzeit (2024-11) noch in einer Alpha-Version befindet. Ich werde mich in diesem HowTo auf den Nachfolger konzentrieren (v3.0.0-alpha>=28). Es sei aber hier erwähnt, dass das Add-On bei mir derzeit noch regelmäßig abstürzt. Wem das zu unsicher ist, der sollte derzeit wohl lieber den Vorgänger nehmen.

Installation home-assistant-matter-hub

Für die Installation des Add-On, muss wie folgt vorgegangen werde

  1. Einstellungen > Add-ons
  2. Button „ADD-ON STORE“
  3. 3 Punkte (rechts oben) > Repositories, um ein Repository hinzuzufügen
  4. Link https://github.com/t0bst4r/home-assistant-addons hinzufügen
  5. STRG-F5 drücken, damit die Seite neu geladen wird
  6. nach „Matter“ suchen und „Home-Assistant-Matter-Hub“ installieren

Starten des Add-On

Um „Home-Assistant-Matter-Hub“ zu starten, muss man auf das Add-On klicken und danach auf Starten.
Nachdem bei mir die Alpha-Version sich derzeit noch regelmäßig beendet, habe ich Watchdog aktiviert, damit das Add-On immer wieder neu gestartet wird.

„Benutzeroberfläche öffnen“ klicken und konfigurieren. Wenn es nicht gleich angezeigt wird, dem Add-On einfach ein bisschen Zeit geben

Konfiguration des Add-On

Bridge hinzufügen

Als Erster müssen wir eine „Bridge“ hinzufügen. Dazu das „+“ drücken und anfänglich muss nur ein Name und ein Port vergeben werden. Damit nicht alle Geräte von Home Assistant geladen werden müssen, und es etwas dauert, bis man weiter machen kann (Oberfläche reagiert nicht mehr), empfiehlt es sich noch einen Filter hinzuzufügen. Der Filter kann nachträglich wieder geändert werden. Was genau das bedeutet, erkläre ich etwas weiter unten unter „Filtern“.

{
  "filter": {
    "include": [
      {
        "type": "domain",
        "value": "scene"
      }
    ],
    "exclude": []
  }
}

Danach SAVE drücken. Schon sollte die Bridge erscheinen.

Filtern

Damit nicht alle Geräte bei Alexa aufschlagen, ist es sinnvoll nach gewünschten Geräten zu filtern, die an Alexa weitergegeben werden sollen. Dazu gibt es bestimmte Möglichkeiten, aber auch Einschränkungen. Erst einmal kann man Geräte inkludieren (INCLUDE) bzw.  ausschließen (EXCLUDE).

Eine Einschränkung besteht darin, dass nur bestimmte Gerätetypen unterstützt werden, und zwar vom Matter-Standard, aber auch noch nicht alle möglichen Gerätetypen im Home-Assistant-Matter-Hub inkludiert sind.

Derzeit werden nur folgende Gerätetypen unterstützt:
wurden von mir verwendet

  • light
    ein, aus, dimmen, Farbtemperatur, Farbe
  • switch
    ein, aus
  • scene
    ein, aus
  • automation
    ein, aus
  • cover

dazu wird weiters noch unterstützt …

  • lock
  • fan
  • climate
  • sensor
  • binary_sensor
  • input_boolean

Die aktuellsten Informationen, was schon alles unterstützt wird, gibt es unter https://github.com/t0bst4r/home-assistant-matter-hub.

Jetzt gibt es einige Möglichkeiten, die vorhandenen Geräte aus Home Assistant zu filtern. Ich habe mich zum Beispiel darauf beschränkt, alle Szenen und vor allem die Lichter, Schalter und Rollos aus unserem Wohnzimmer in Alexa einzubinden.

Die Konfiguration des Filters ist vielleicht noch nicht sehr komfortabel, aber auch keine Hexerei. Das Format für die Konfiguration ist das JSON Format und so ergibt sich bei mir folgende Konfiguration.

{
  "filter": {
    "include": [
      {
        "type": "domain",
        "value": "scene"
      },
      {
        "type": "pattern",
        "value": "cover.wz*"
      },
      {
        "type": "pattern",
        "value": "cover.az_rollo_fenster"
      },
      {
        "type": "pattern",
        "value": "light.wz*"
      },
      {
        "type": "pattern",
        "value": "switch.wz_plug*"
      }
    ],
    "exclude": []
  }
}

Es gibt folgende „Type“ Möglichkeiten

  • pattern
    Ein String der die ID der Entität filtert, „cover.*“ fügt alle Rollos hinzu, „cover.wz*“ fügt bei mir zum Beispiel alle Rollos im Wohnzimmer (wz) hinzu
  • domain
    Domain, die hinzugefügt werden soll, „light“ fügt alle Lichter hinzu, „scene“ fügt alle Szenen hinzu
  • platform
    Integration die hinzugefügt werden soll
  • label
    alle Entitäten mit dem label werden hinzugefügt, „alexa included“ fügt zum Beispiel alle Entitäten hinzu, die in Home Assistant mit dem Label „alexa included“ gekennzeichnet wurden

Home-Assistant-Matter-Hub bei ALEXA hinzufügen

  1. App Amazon Alexa am Handy oder Tablet öffnen
  2. „Geräte“ (unten mitte) anklicken, dann „+“ (oben rechts) klicken
  3. „Gerät hinzfügen“ auswählen
  4. runter scrollen bis  Sonstiges
  5. Bei „Welches Logo ist auf deinem Gerät?“ den Button „Matter“ auswählen
  6. „Hat Gerät ein Matter-Logo“ mit JA beantworten
  7. „Ist das Gerät eingeschaltet“ mit JA beantworten
  8. „QR-Code scannen“
  9. Warten bis Alexa eine Verbindung herstellen konnte
    Ich musste das Pairing 3 mal machen, bis es geklappt hat. Was nicht funktioniert ist, das Pairing vom Büro über VPN auszulösen 😉
  10. Meldung: „Dieses Gerät ist mit Matter nicht kompatibel“, mit Trotzdem einrichten bestätigen
  11. Nachdem alle Geräte hinzugefügt wurden, den Namen der Geräte ggf. bearbeiten

Folgendes ist mir aufgefallen

  • Einen Vorteil den ich sehe, Home Assistant über Matter anzubinden ist, dass wenn ich den Filter beim Home-Assistant-Matter-Hub ändere, dass Geräte in ALEXA verschwinden bzw. neue hinzukommen. Bis jetzt war ich gewohnt, dass einmalig hinzugefügte Geräte solange vorhanden sind, bis man sie über die APP wieder rauslöscht.
  • Wenn man beim Erstellen die Liste nicht einschränkt, dauert es einige Zeit, bis die Oberfläche wieder reagiert. In den „Live“ Logs sieht man, dass das Add-On im Hintergrund beschäftigt ist, alle möglichen und unmöglichen Geräte einzubinden.
  • Manchmal wird die Aktion etwas zeitverzögert ausgeführt, oder es wird ausgeführt, aber ALEXA meint, dass das Gerät nicht vorhanden ist.
  • Filter konfigurieren ist noch nicht komfortabel
  • Beim Filter „domain:cover“ werden bei mir nicht alle Rollos inkludiert. Bei Filter „domain:scene“ funktioniert es, und alle Szenen sind vorhanden.

Fazit

Die Verbindung von Home Assistant mit Alexa, war für mich noch nie so einfach, und hat ohne größere Probleme funktioniert. Nachdem es sich bei der Version noch um eine Alpha Version handelt, funktioniert noch nicht alles zufriedenstellend, aber ich bin trotzdem schon sehr Happy damit. Es ist anfänglich ein Bastelprojekt und schauen wir mal, wie und ob es wir wirklich verwenden werden.

Quellen und Links

 

4 Kommentare zu "HOWTO: Lokale Anbindung Alexa und Home Assistant mit Matter"

  1. Hallo Michael,
    danke für die schnelle Antwort. Ein paar Punkte dazu:
    + Ich habe im Prinzip alles in einem Netzwerk (192.168.1.x)
    + Die Fritzbox kann 2,4&5GHz WLAN – habe beides getestet
    – die meisten Alexa Echos hängen im 2,4GHz Netz
    – eines im 5GHz (sollte aber ja keine Rolle spielen) – alle im gleichen Netzwerk
    + Ich habe getestet mit Alpha 38, 40 und 41
    + Könnte es was mit der IP6 Konfiguration zu tun haben?
    – Generell habe ich IP6 aktiviert, aber in der Fritzbox sind Optionen die ich nicht verstehe
    – Ich habe das was bzgl DNS geändert
    * „DNS-Server, Präfix (IA_PD) und IPv6-Adresse (IA_NA) zuweisen“ aktiviert
    * statt „Nur DNS-Server zuweisen“
    + Wenn das AddOn gestartet ist kommt bei der Suche auch „Mit Gerät .. verbinden..“
    + Aber bricht immer ab und nach ein paar Versuchen kommt auch das nicht mehr
    + Ich finde im Log keinen ERROR den ich verstehe …

    Wird vielleicht zu lange, wenn ich den Log hier anhägen und weiß ja nicht, ob Du so tief drin bist …

    MfG
    Frank

    LOG vom AddOn Start bis nix mehr passiert …
    [ +++++ LOGS ENTFERNT sonst kann man nichts mehr lesen 😉 +++++ ]

    • Hallo,
      ich sehe in den Logs keinen Pairing versuch von der Alexa, habe nach „Received pairing request from udp://xxx.xxx.xxx.xxx:5540“ gesucht (xxx.xxx.xxx.xxx = IPAdresse von der Alexa). Zu IPv6 habe ich folgendes noch in den Dokumenten gefunden:

      https://github.com/t0bst4r/home-assistant-matter-hub

      Make sure your docker installation has IPv6 enabled, too. See this guide for more information.
      If you are running docker on a NAS, make sure to enable IPv6 in the NAS settings, too

      Michael

  2. Hallo Michael,
    da ich es nicht zum Laufen bringe, mal 2 – 3 Fragen:

    + Alexa findet die Matter-Bridge nicht.. 100 mal versucht mit QR und Code Eingabe
    + in einem Bild sehe ich Port auf 5541 statt 5540 – ich habe beides getestet – gleiches Verhalten der Alexa App, findet nix
    + ich sehe bei Dir „fabrics=1“, bei mir ist der Wert immer Null?

    Mein HA Server läuft auf einer Synology NAS in einer VM und IP6 ist an im Netzwerk…

    Vielleicht hast Du einen Tipp?
    Wenn das gehen würde, wäre es eine gute und simple Alexa Anbindung..

    MfG
    Frank

    • Hallo,
      ich habe den Home-Assistant-Matter-Hub auf Port 5540 laufen, die Instanz mit Port 5541 hab ich nur für den Blog-Eintrag angelegt. Fabrics hat bei mir bei der neu hinzugefügten den Wert 0, wenn es mit etwas gekoppelt ist, dann ist es 1. Bei der gekoppelten Bridge, sieht man dann unterhalb von Fabrics das Amazon Logo. (Detailansicht)

      Beim Koppeln befindest Du Dich mit Deinem Handy/Tablet im selben WLAN-Netzwerk wie die Alexa und Home Assistant ist nicht irgendwie von Alexa netzwerktechnisch getrennt?

      Das nächste was Du noch schauen kannst, ob sich was im Protokoll tut, und ob eine Anfrage ankommt ….
      Habe es gerade getestet (über VPN) und dann steht folgendes dort …
      [ 2024-11-27T09:48:55.021Z ] [ INFO ] [ matter.js / CaseServer ]: Received pairing request from udp://192.168.0.78:5541
      [ 2024-11-27T09:48:55.049Z ] [ INFO ] [ matter.js / CaseServer ]: session 55850 resumed with udp://192.168.0.78:5541 for Fabric 040E51205FB95B20(index 1) and PeerNode 01605CBBFED43421 with CATs 1114154
      [ 2024-11-27T09:48:55.073Z ] [ INFO ] [ matter.js / InsecureSession ]: End insecure session insecure/XXXXXXXXX4972550393
      [ 2024-11-27T09:48:55.075Z ] [ INFO ] [ matter.js / SecureSession ]: End CASE session secure/55847
      [ 2024-11-27T09:48:55.077Z ] [ INFO ] [ matter.js / ChannelManager ]: Close oldest channel for fabric peer@1:0x1605cbbfed43421 (from session 55847)

      Ach ja, welche Version hast Du? Ich habe das koppeln mit Alpha 28 gemacht. t0bst4r arbeitet ja gerade fleißig an der Version, und es gibt immer wieder kleinere und größere Probleme bei manchen Versionen.

      Michael

Einen Kommentar hinterlassen

Deine E-Mail-Adresse wird nicht veröffentlicht.


*


1 + 6 =