[Erfahrungsbericht] [V4.5 IP4] Integration von Informationen von Unifi Kameras / Unifi Protect über Home Assistant Docker Container

[fechter65]

Ausgangslage
Meine Kameras stammen von Ubiquiti / Unifi. Gesteuert / ausgewertet werden sie über die eine "Dream Maschine (UDM)" resp. über die dort laufende App "Protect".

Zielsetzung
Aufgrund der an den Kameras ausgelösten Events über den TWS Aktionen auslösen (bspw. Licht einschalten).

Lösungsweg
Die Unifi- und MQTT-Integration von Home Assistant verwenden, um die Daten auf den TWS zu bringen.
Die vorgängig erwogenen Varianten sind hier beschrieben.

Voraussetzungen

• MQTT-Broker installiert [bei mir als Docker Container auf einem TWS (Anleitung)

• MQTT-Subsystem auf dem TWS eingerichtet

• MQTT-Explorer ( https://mqtt-explorer.com/ ) auf einer Windows-Maschine eingerichtet

Vorgehen

• Docker Container für Home Assistant installieren (siehe Post #2)

• Home Assistant einrichten (siehe Post #3)

• MQTT-Tokens auswerten (siehe Post #4)

Gruss
Diego

[fechter65]

Docker Container für Home Assistant installieren
(massgebliche Inspirationsquelle: viewtopic.php?t=2093 )


1. Voraussetzung: MacVLAN muss auf dem entsprechenden TWS aktiviert sein.

• Systemeinstellungen / Netwerk / LAN / eth0 / Schnittstelle im MacVLAN-Modus betreiben aktiviert

• In Portainer unter "Networks" ist ein MacVLAN-Netwerk eingerichtet (Anleitung) :
  Name: Nach eigener Wahl
  Subnet: Nach eigener Wahl (ich habe 10.0.1.0/24)
  Driver: macvlan
  Driver Option: name: parent / value: eth0

1. Schritt: In Portainer ein Volume (bspw. mit dem Namen "HomeAssistant" erstellen.

2. Voraussetzung: SSH-Zugriff auf den Container eingerichtet (wird später für die Konfiguration benötigt)

• Empfehlung: Vorgehen gemäss viewtopic.php?p=39540

• Bei Volume-Mapping noch einen weiteren Eintrag erstellen:
  Container: Nach eigener Wahl (bei mir: " /mnt/HomeAssistant ")
  Volume: das soeben erstellte Volume auswählen (bei mir: " HomeAssistant ")

2. Schritt: In Portainer einen neuen Container erstellen:

• Name: nach eigener Wahl (bei mir "HomeAssistant")

• Image: "homeassistant/home-assistant:stable"

• Always pull the image: aktiviert

• Publish all exposed ports; aktiviert

• Unter Advanced container settings
  • Command:
    • Command: leer
    • Entry Point: "/init"
    • Working Dir: "/config"
  • Volumes
    • Container: /config
    • Volume: das soeben erstellte Volume auswählen (bei mir: " HomeAssistant ")
  • Network
    • Network: das soeben erstellte MacVLan-Netzwerk
    • Hostname: nach eigener Wahl
    • Domain Name: nach eigener Wahl
    • Mac Address: nach eigener Wahl und in eigener Verantwortung, damit keine doppelten Adressen vergeben werden
    • IP-Adresse: nach eigener Wahl
  • Env
    • neuer Eintrag erstellen (name: "TZ" / value: "Europe/Zurich "
  • Labels (keine Einträge)
  • Restart policy
    • Nach eigener Wahl (bei mir "Unless stopped"
  • Deploy the container

Gruss
Diego

[fechter65]

Home Assistant einrichten
(siehe auch: viewtopic.php?t=4723 )

• Im Webrowser http://IP_ADDRESS:8123 öffnen (IP-Adresse wurde soeben im Rahmen der Netwerkangaben bei der Container-Installation festgelegt)

• Erst-Einstellungen gemäss: https://www.wundertech.net/how-to-insta ... portainer/

• MQTT-Integration installieren
  • https://www.home-assistant.io/integrations/mqtt/ aufrufen, dort auf "Add Integration to my HA" klicken, erstmalig "http://IP_ADDRESS:8123" eintragen, dann Anweisungen befolgen

• "MQTT Statestream"-Integration installieren (nicht zwingend, aber bequem: erstellt automatisch MQTT-Tokens; siehe https://www.home-assistant.io/integrati ... atestream/ )
  • über ssh Verbindung mit dem TWS herstellen (bspw. mit WinSCP), dort das im SSH-Container (siehe Post #2, 2. Voraussetzung) das gemountete Verzeichnis auswählen ( im Beispiel "/mnt/HomeAssistant " )
  • in einem Texteditor die Datei " configuration.yaml " anpassen mit den Angaben gemäss https://www.home-assistant.io/integrati ... atestream/ (Hinweis für die Beispiele im folgenden Post): Ich habe als base_topic "homeassistantTWS173" eingetragen

• "UniFi Protect"-Integration installieren
  • Voraussetzung: Unter Unifi Protect muss ein lokaler Benutzer zur Verfügung gestellt werden (siehe: https://www.home-assistant.io/integrati ... local-user)
  • https://www.home-assistant.io/integrati ... fiprotect/ aufrufen, dort auf "Add Integration to my HA" klicken, dann Anweisungen befolgen

Hinweise

• Nach der Anpassung der configuration.yaml muss der Home Assistant neu gestartet werden (Einstellungen / oben rechts auf die drei Punkte )/

• Es dauert eine ganze Weile, bis nach einem Neustart alles läuft und bspw. auf dem MQTT-Explorer Daten ersichtlich sind.

Ergebnis
Im MQTT-Explorer werden unter dem Topic "homeassistantTWS173" zahlreiche weitere Topics angezeigt. Diese können nun im TWS über das MQTT-Subsystem ausgewertet werden.


Exkurs
Für die hier angestrebte Anwendung nicht erforderlich: Im Home Assistant können natürlich noch weitere Integrationen (jedoch keine Addons, da hier Home Assistant in einem Docker Container installiert wurde) integriert werden. Bspw. KNX: https://www.home-assistant.io/integrations/knx/

Gruss
Diego

[fechter65]

MQTT-Tokens auswerten

Der letzte Schritt ist unspektakulär:

• Im MQTT-Explorer die gewünschten Topics heraussuchen

• Im MQTT Geräte Manager des TWS unter dem richtigen MQTT-Subsystem ein neues MQTT Gerät erstellen.

• Unter diesem Gerät ein App Level Topic hinzufügen.

• Unter diesem Topic eine Subskriptions-Transaktion erstellen.

• Diese Transaktion mit den gewünschten TWS-Objekten verknüpfen.

Gruss
Diego

[Mibr85]

Sehr schöne Anleitung
Vielen dank