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)

Auch wenn Home Assistant eine Vielzahl von Integrationen unterstützt, kann dank des Einsatzes der Community das Angebot um unzählige zusätzliche Integrationen erweitert werden. HACS ist eine Integration um GitHub Repositorys über eine Art Softwarekatalog herunterzuladen. Voraussetzung für den Einsatz der Community-Integrationen ist die Installation des Home Assistant Community Store. Der Download des Home Assistant Community Store startet im Terminal, welches abhängig von der Home Assistant-Installation etwas unterschiedlich aufgerufen werden kann.

Docker

Wer Home-Assistant in Docker betreibt, kann HACS über das Terminal des Containers installieren:

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

HAOS

Bei einer HAOS-Installation kann das Terminal über ein Add-on aufgerufen werden.

Fehler: 502: Bad Gateway

An dieser Stelle fehlt noch ein beliebiges komplexes Passwort. Einfache Passwörter werden an dieser Stelle nicht akzeptiert ..

Installation

Der Download und die Installation kann mit folgendem Befehl gestartet werden:

wget -q -O - https://install.hacs.xyz | bash -

HACS-Integration Aktivieren

Das Aktivieren des Stores erfolgt über: Einstellungen, Integration

und im Anschluss muss die Installation auf GitHub registriert werden:

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, kann die Integration "System Monitor" verwendet werden:

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 die kostenlose Routersoftware OpenWrt einsetzt, kann diese mit Home Assistant verbinden und damit den Anwesenheitsstatus tracken.

In Home-Assistant wird dazu der Eintrag device_tracker in der configuration.yaml-Datei vorausgesetzt:

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 im Netzwerk über einen Ping tracken will, kann dies über die Ping (ICMP) Integration:

Der Status des Sensors ist je nach Erreichbarkeit des Geräts: "getrennt" oder "verbunden"

InfluxDB

Um bestimmte Sensordaten außerhalb von Home Assistant auszuwerten, kann beispielsweise Grafana für die Visualisierung verwendet werden. Damit die Daten in Grafana zur Verfügung stehen, können bestimmte Sensordaten an eine externe InfluxDB übertragen werden. Die InfluxDB läuft dabei parallel zur Home-Assistant Datenbank. Für die Verbindung auf die v1 Influx-Datenbank habe ich folgenden Block in die configuration.yaml-Datei hinzugefügt:

influxdb:
  include:
    entities:
       - sensor.flowmeter
       - sensor.heating_vorlauf
       - sensor.heating_ruecklauf
       - sensor.aussen_temperature
       - sensor.heating_warmwasser
       - sensor.heating_pufferspeicher
       - sensor.heating_waermetauscher
       - sensor.heating
       - sensor.heating_active_power
       - sensor.heizstab_power
  host: influxdb
  port: 8086
  database: ha
  username: ha
  password: ???
  max_retries: 3

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