Der modulare Aufbau von Home Assistant ermöglicht die Kommunikation mit anderen Geräten oder Diensten und erweitern Home Assistant um zusätzliche Funktionen. 

Was ist eine Integration in Home Assistant?

Home Assistant unterstützt eine Vielzahl an unterschiedlichen Herstellern und bindet deren Geräte oder Dienste über sogenannte Integrationen ein. Die Integrationen sorgen unter anderem dafür, dass unterschiedliche Geräte einheitlich in Home Assistant zur Verfügung gestellt werden können.
Ein Beispiel für eine Integration wäre ein Zigbee-Gateway: Home-Assistant kommuniziert über die Integration mit dem Gateway, wodurch dessen Geräte - als Beispiel verbundene Lampen oder Sensoren - in Home Assistant einheitlich zur Verfügung gestellt werden können. Die Kommunikation muss abhängig von den Geräten nicht zwingend über ein Gateway erfolgen: Bestimmte WLAN-Geräte werden über eine Integration meist direkt mithilfe der IP-Adresse angesprochen (siehe: Shelly). Neben dem Bereitstellen von Geräten kann eine Integration aber auch dazu dienen bestimmte Dienste in Home Assistant hinzuzufügen, als Beispiel der Home Assistant Community Store, siehe HACS. 

Was sind Entitäten in Home Assistant?

Entitäten in Home Assistant spiegeln bestimmte Werte, Details oder Eigenschaften eines Geräts wider. Zum Beispiel kann ein Temperatursensor bestimmte Werte als Entität zur Verfügung stellen: die Temperatur, Luftfeuchtigkeit, Luftdruck oder den Batteriestatus. Ein anderes Beispiel wären die Eigenschaften einer Lampe, diese besitzt als Entität voraussichtlich einen Schalter für das Ein- und Ausschalten und eventuell eine weitere Entität für das Einstellen der Helligkeit oder dessen Lichtfarbe.

ZigBee-Integration am Beispiel des Conbee2 - USB-Sticks

Damit ich mit Home Assistant ZigBee-Geräte verwenden kann, habe ich den ConBee2 USB-Stick im Einsatz. Alternativ zur Gatewaylösung des Herstellers: Phoscon empfehle ich die Verwendung von ZigBee2MQTT oder noch besser ZHA, siehe: HA: 3 verschiedene Integrationen für den ConBee 2 USB-Stick.

Home Assistant Community Store (HACS)

Ein Beispiel für eine Integration, die ein Service bereitstellt, ist die Anbindung an den Home Assistant Community Store (HACS). HACS ist eine Integration um GitHub Repositories über eine Art Softwarekatalog herunterzuladen. 

Installiert habe ich HACS über einen Befehl im Docker-Container:

user@rechner:~$ docker exec -it home-assistant bash
bash-5.0# wget -q -O - https://install.hacs.xyz | bash -

Das Aktivieren des Stores erfolgt über: Einstellungen, Integration

und im Anschluss muss die Installation auf GitHub registriert werden, siehe: hacs.xyz/docs/configuration/basic

Wurde der Store aktiviert, können zusätzliche benutzerdefinierte Komponenten: Integrationen oder Frontend-Pakete hinzugefügt werden.

Das Hinzufügen eines Repositories über den Home Assistant Community Store bewirkt zunächst nur, dass die zugehörige Integration über "Integration Hinzufügen" gefunden wird. 

Integrationen, die über ein HACS-Repository installiert wurden, sind als "Benutzerdefinierte Integration" markiert:

System Monitor

Um das Betriebssystem - auf dem Home Assistant läuft - rudimentär zu überwachen, können in der configuration.yaml zusätzliche Sensoren hinzugefügt werden, als Beispiel Disk und Memory:

configuraton.yaml:

sensor:
  - platform: systemmonitor
    resources:
      - type: disk_use_percent
        arg: /
      - type: disk_use_percent
        arg: /daten
      - type: memory_free    

Server oder Linux-Systeme überwachen

Wer den Status anderer Linux-Systeme überwachen will, kann dazu die Integration „Glances“ verwenden. Glances sammelt Daten zu CPU, Memory oder dem freien Speicherplatz einer Festplatte u.v.m.. Als Voraussetzung muss Glances zuvor auf den zu überwachenden Systemen installiert werden, siehe auch:  Glances - Linux-Server überwachen

Shelly

Als Beispiel für eine Integration, die direkt mit einem WLAN-Device kommuniziert, kann der WLAN-Switch Shelly genannt werden: Shelly ist ein kleiner Unterputz-WLAN-Schalter für das Steuern z.B. einer Steckdose.

Nach dem Setup wird das Gerät automatisch dem Standard-Home-Dashboard zugewiesen:

Device Tracker OpenWrt

Wer über OpenWrt die Anwesenheit von Geräten tracken will, kann dies mit dem Eintrag device_tracker in der configuration.yaml-Datei:

device_tracker:
  - platform: luci
    host: 192.168.1.2
    username: root
    password: ???
    interval_seconds: 30
    consider_home: 360
    new_device_defaults:
       track_new_devices: true

Für OpenWRT wird dazu das Paket luci-mod-rpc vorausgesetzt. 

Informationen zu OpenWrt, siehe: Alternative Router Firmware: OpenWrt und nicht mehr DD-WRT

Alternativ kann der Status auch über einen Ping abgefragt werden:

Ping auf ein Netzwerkgerät

Wer über OpenWrt die Anwesenheit von Geräten über einen Ping tracken will, kann dies mit dem Eintrag binary_sensor in der configuration.yaml-Datei:

..
binary_sensor:
  - platform: ping
    name: FireTV
    scan_interval: 120
    host: 192.168.1.104
..

Der Status des Sensors ist je nach Erreichbarkeit des Geräts: "off" oder "on"

MQTT-Geräte als Sensor verbinden 

Nachdem die MQTT-Integration hinzugefügt wurde, kann in der configuration.yaml-Datei ein neuer Sensor angelegt werden:

Voraussetzung für MQTT ist ein MQTT-Broker-Server, siehe MQTT - Broker : Docker Setup.

Hinzufügen von einzelnen Sensoren in der configuration.yaml-Datei:

sensor:
  - platform: mqtt
    state_topic: "flowmeter/flow"   
    name: "flowmeter"
    unit_of_measurement: "m³/h"

Services die den MQTT-Broker verwenden:

• Zigbee2MQTT, siehe : Inbetriebnahme Zigbee2MQTT in Docker - Schritt für Schritt
• "AI-on-the-edge-device" Digitizer, siehe : Wasserzähler überwachen, Verbrauch aufzeichnen: ESP32-Cam
• Smart Meter , siehe : Smart Meter des Netzbetreibers auslesen KAIFA MA309M