A Home Assistant egy otthoni automatizációt lehetővé tevő szabad szoftver, vagy inkább platform, amely az egyik legnagyobb közösségi projektté nőtte ki magát.

Szokás szerint onnan indulunk, hogy van egy otthoni szerverünk, rajta Debian és Docker. A HA konténeres telepítése nagyon egyszerű:

$ mkdir -p hass/config
$ cd hass
$ nano compose.yaml
$ docker compose up -d

A fenti compose.yaml tartalma:

services:
  hass:
    image: lscr.io/linuxserver/homeassistant:latest
    container_name: hass
    restart: unless-stopped
    network_mode: host
    privileged: true
    environment:
      - TZ=Europe/Copenhagen
      - PUID=1000
      - PGID=1000
    volumes:
      - ./config:/config
      - /run/dbus:/run/dbus:ro

Indítás után a 8123 porton érjük el a webappot, pár kezdeti beállítás után már használhatjuk is.

Zigbee szenzorok hozzáadása

Zigbee is a low-power, low-data-rate, and close proximity (i.e., personal area) wireless ad hoc network, based on an international standard.

Szeretnénk vezeték nélküli szenzorokat használni, ehhez beszereztünk pár Sonoff márkájú komponenst:

  • Zigbee 3.0 USB Dongle Plus (ZBDongle-E) koordinátor
  • Zigbee Temperature and Humidity Sensor (SNZB-02P)
  • Zigbee Door/Window Sensor (SNZB-04P)

Először is csatlakoztassuk a szerverünkhöz az USB Zigbee-vevőegységet. Aztán meg kell oldanunk ennek Docker-konténerhez csatolását is, amihez szükségünk van az eszköz fájlnevére.

$ ls -l /dev/serial/by-id/
$ # vagy így:
$ find /dev/serial/by-id/* | xargs realpath

Esetünkben ez a /dev/ttyACM0 fájl. Egészítsük ki az alábbival a compose.yaml konfigunkat, majd indítsuk újra a szolgáltatást.

#...
    devices:
      - /dev/ttyACM0:/dev/ttyACM0
#...

Navigáljunk a HA webappban a Settings / Devices & Services / Integrations oldalra, és itt az Add Integration gombbal vegyük fel a ZHA-t. Ezután a Devices fülön egyesével hozzáadhatjuk a Zigbee-eszközeinket (a gombjukat 5 s-ig nyomva kell tartani a párosításhoz). Készen vagyunk – bár a HA elérésén javíthatunk még.

Mobil app

A Google Playből telepíthetjük a HA Android-appját. A http://homeserver:8123 URL megadása és autentikáció után itt is hasonló dolgokat látunk, mint a webappban. De persze csak akkor, ha közös LAN-on vagyunk a szerverünkkel.

További infók

A fentiekben csak a kötelező minimumot érintettük, természetesen rengeteg tudnivaló van a HA-val kapcsolatban. Ajánlott tartalom: The Home Assistant Cookbook.

Custom components

A közösség sokféle eszköz integrációját megoldotta, ezek egyedi komponensként húzhatók be a HA-ba. Vegyük például az ARISTON Lydos Hybrid WiFi vízmelegítő kezelését, amelyet az Ariston NET remotethermo integráció valósít meg. A repóból a custom_components/ mappa tartalmát kell másolni esetünkben a hass/config/custom_components/ lokális (bindelt) mappába, majd újraindítani a konténert. Ezután a HA felületén felvehetjük az integrációt a fentiekben a ZHA-nál leírt módon.

Az egyedi komponensek kezelését a HA felületen is intézhetjük, mégpedig a HACS egyedi komponens segítségével. Ezt a fentiek szerint telepíthetjük, a kezdeti beállítását lásd a doksiban.