Lokale Sprachsteuerung mit Matter und ohne Cloud-Anbindung

Möchte man seinen Home Assistant mit der Sprache steuern, so war dies bisher nur mit einem Cloud-Dienst möglich. Wollte man keinen, meist kostenpflichtigen, Cloud-Dienst verwenden blieb einem nur, seine Home Assistant Instanz aus dem Internet erreichbar zu machen.

Doch mit dem Home Assistant Add-on "Home-Assistant-Matter-Hub" ist das nun auch im lokalen Netzwerk möglich.

Home Assistant Add-on?

Auch wenn deine Home Assistant Instanz nicht unter Home Assistant OS sondern in einem Docker Container läuft kannst Du das Add-on "Home-Assistant-Matter-Hub" verwenden, der Autor hat hierzu eine Anleitung verfasst.

Die Verwendung des Add-on ist also in jeder Installationsart des Home Assistant möglich. Auf einem Home Assistant Green konnte ich jedoch keine Verbindung zu Alexa aufbauen.

Voraussetzungen

Meine Home Assistant Instanz lief zunächst in einem Docker Container, später als Home Assistant Yellow. Zur Sprachsteuerung verwende ich Alexa und als Controller kommt ein Echo Dot zum Einsatz. Hier beschreibe ich wie ich vorgegangen bin.

IPv6 in Docker aktivieren

Leider ist nach der Installation von Docker IPv6 deaktiviert. Aus diesem Grund ist es vor der Installation des Add-on "Home-Assistant-Matter-Hub" notwendig IPv6 zu aktivieren.

Der folgende Code beinhaltet:

  • Aktivieren der IPv6-Unterstützung
  • Aktivieren von IPv6 im Standard-Bridge-Netzwerk
  • Dynamische IPv6-Subnetzzuweisung

Der Code wird in die Datei "/etc/docker/daemon.json" eingetragen.

Achtung: Die Zeilen 3 und 14 müssen noch geändert werden!

{
  "ipv6": true,
  "fixed-cidr-v6": "XXXX:YYYY:1::/64",
  "experimental": true,
  "ip6tables": true,
  "default-address-pools": [
    { "base": "172.17.0.0/16", "size": 16 },
    { "base": "172.18.0.0/16", "size": 16 },
    { "base": "172.19.0.0/16", "size": 16 },
    { "base": "172.20.0.0/14", "size": 16 },
    { "base": "172.24.0.0/14", "size": 16 },
    { "base": "172.28.0.0/14", "size": 16 },
    { "base": "192.168.0.0/16", "size": 20 },
    { "base": "XXXX:YYYY::/104", "size": 112 }
  ]
}


In den Zeilen 3 und 14 müssen die ersten beiden Adressblöcke "XXXX" und "YYYY" auf einen eigenen IPv6 Adressbereich angepasst werden.

Deinen eigenen, privaten Addressbereich bekommst Du über die Seite simpledns.plus.

Sobald der Docker Dienst neu gestartet wurde steht dann IPv6 auch für Docker Container zur Verfügung.

systemctl restart docker

Erstellen eines langlebigen Zugriffstoken

Ein Erstellen eines langlebiger Zugriffstoken wird über das Profil erstellt:

Wechseln in den Reiter "Sicherheit":

Ganz unten im Bereich "Langlebige Zugriffstoken" den Button "TOKEN ERSTELLEN" betätigen:

Einen Namen für den Token vergeben und mit "OK" bestätigen:

Im Folgenden Dialog den Token mit dem Button kopieren, irgendwo sichern und später im Skript "setup.sh" eintragen:

Somit ist der Token erstellt und aktiv:

Installation als Docker Container

Zum Erzeugen eines Docker Containers für "Home-Assistant-Matter-Hub" zu erstellen habe ich mir ein kleines Shell script "setup.sh" erstellt:

docker run -d \
  --name homeassistantmatterhub \
  --restart=always \
  -e HAMH_HOME_ASSISTANT_URL="http://IP-Home Assistant:8123/" \
  -e HAMH_HOME_ASSISTANT_ACCESS_TOKEN="Langlebiger Zugriffstoken" \
  -e HAMH_LOG_LEVEL="info" \
  -e HAMH_WEB_PORT=8482 \
  -v Daten-Verzeichnis:/data \
  --network=host \
  ghcr.io/t0bst4r/home-assistant-matter-hub:latest


Folgende Anpassungen müssen vorgenommen werden:

IP-Home Assistant IP-Adresse unter der dein Home Assistant erreichbar ist
Langlebiger Zugriffstoken Ein Zugriffstoken für einen Home Assistant
Daten-Verzeichnis Ein Verzeichnis in dem die veränderlichen Daten des Docker Containers abgelegt werden. Wird hier kein Verzeichnis angegeben, werden die veränderlichen Daten innerhalb des Containers abgelegt und gehen beim Löschen des Containers verloren

Mit dem Ausführen des Skriptes "setup.sh" wird der Container "homeassistantmatterhub" erzeugt und gestartet. Auf die GUI des "Home-Assistant-Matter-Hub" kann über die folgende URL zugegriffen werden:

http://IP-Home Assistant:8482

Fine Tuning

Der Nachteil der Home Assistant im Docker Container: Die GUI des "Home-Assistant-Matter-Hub" muss separat aufgerufen werden und ist nicht über die GUI des Home Assistand erreichbar.

Aber auch dafür habe ich eine Lösung gefunden:

Eigene Menüpunkte im Side Menu der Home Assistant GUI

Repository hinzufügen

Die Installation des "Home-Assistant-Matter-Hub" über den Home Assistant Add-on Store ist schnell erledigt.

Zunächst muss das Repository "https://github.com/t0bst4r/home-assistant-addons" zum Add-on Store hinzugefügt werden.

Über die Einstellungen die Add-ons auswählen:

Unten links "ADD-ON STORE" auswählen:

Oben rechts auf das Drei-Punkte-Menü klicken und "Repositories" auswählen:

Im neuen Fenster das Repository "https://github.com/t0bst4r/home-assistant-addons" eintragen und "HINZUFÜGEN" auswählen:

Das Fenster kann nun geschlossen werden.

Installieren des "Home-Assistant-Matter-Hub"

Im Add-on Store muss nun die Sektion "t0bst4r" und der "Home-Assistant-Matter-Hub" auftauchen. Sollte er nicht sichtbar sein hilft es die Seite zu aktualisieren oder den Browser Cache zu löschen.

Den "Home-Assistant-Matter-Hub" auswählen:

Und den "Home-Assistant-Matter-Hub" installieren:

Die Optionen "Watchdog" und "In der Seitenleiste anzeigen" aktivieren und den "Home-Assistant-Matter-Hub" starten:

Wie geht nach der Installation weiter geht

Die Installation ist geschafft, gehen wir die Konfiguration an. Als nächstes muss eine Bridge eingerichtet und mit Alexa - oder vielmehr mit dem Echo Dot - verbunden werden.

Im Seitenmenü "Matter Hub" auswählen und die Kachel "My Bridges" auswählen:

Da noch keine Bridge eingerichtet ist, ist das Fenster leer. Nun wird der "+" Button ausgewählt:

Zur Konfiguration der Bridge muss ein beliebiger Name angegeben werden.

Wichtig für Alexa: Die Echo Geräte können sich nur über den Port "5540" verbinden!

In den "Include“ und "Exclude“ Feldern könne Filter eingerichtet werden. Über "Include“ kann angegeben werden welche über Alexa gesteuert werden können, über "Exclude“ welche nicht Alexa nicht kennen soll.

Es gibt einige Filtertypen. Ich verwende z.B. "label" und vergebe im Home Assistant für die Geräte, welche Alexa kennen soll das Label "MatterHub“.

Wichtig: In der Bridge Konfiguration muss das Label immer klein geschrieben werden! Großbuchstaben werden nicht funktionieren, auch wenn sie im Home Assistant verwendet werden.

Die Konfiguration wird mit "SAVE" gespeichert:

Nun wird die neue Bridge angezeigt. Am kleinen, grünen Pfeil im Kreis kann man erkennen, dass die Bridge läuft.

Die Kachel der neuen Bridge auswählen:

Es öffnet sich eine Seite mit dem QR-Code zum Koppeln mit Alexa:

Wie geht nach der Installation weiter geht

Alexa mit der neuen Bridge verbinden

Nun ist es an der Zeit Alexa - oder vielmehr den Echo Dot - mit der Bridge zu verbinden.

Auf dem Smartphone die Alexa App öffnen und den "+" Button auswählen:

Die Option "Gerät" auswählen:

In der Liste ganz nach unten scrollen und den Typ "Sonstiges" auswählen:

Nun die Kachel mit dem Matter Logo auswählen und den Anweisungen der App folgen:

Nachdem der QR Code gescannt wurde verbindet sich der Echo Dot mit dem Home Assistant über die Bridge.

Sollte es nicht auf Anhieb funktionieren, ist es eine gute Idee den Echo Dot neu zu starten. Wie schon erwähnt gelang es mir nicht einen Home Assistant Green mit Alexa zu verbinden.

Für dieses Thema gibt es von simon42 ein sehr gutes Video in dem alle Schritte erklärt werden:

"HA Matter HUB/BRIDGE 😲 👉 Das ändert alles für ALEXA und GOOGLE Nutzer"

HA Matter HUB/BRIDGE 😲 👉 Das ändert alles für ALEXA und GOOGLE Nutzer