Home Assistant

Zentrale Smart-Home-Plattform auf dem Raspberry Pi 4. Läuft als Home Assistant OS (nicht mehr als Docker-Container). Zurück zum Homelab-Überblick.


Hardware

EigenschaftWert
GerätRaspberry Pi 4 (4 GB RAM)
IP192.168.178.4
OSHome Assistant OS
BootNVMe SSD (via USB 2 — bewusst kein USB 3 wegen Zigbee-Interferenz)
ZigbeeRaspBee II HAT, angebunden via USB 2 Kabel
BLEESP32-S3 Proxy via WLAN

Boot-Konfiguration

# /boot/firmware/config.txt
dtparam=i2c_vc=on,sd_poll_once=on
dtoverlay=miniuart-bt
dtoverlay=i2c-rtc,pcf85063

# /boot/firmware/cmdline.txt
apparmor=1 security=apparmor

dtoverlay=miniuart-bt verschiebt Bluetooth auf den Mini-UART und gibt den primären UART für den RaspBee II frei. Falls Zigbee-Probleme auftreten: dtoverlay=disable-bt als Eskalation.

Wichtig: USB 2 für Zigbee

USB 3.0 erzeugt Störstrahlung im 2,4-GHz-Band (genau wo Zigbee funkt). Der RaspBee II HAT muss über ein USB-2-Kabel angebunden sein, nicht USB 3. Das gilt auch für die NVMe-SSD — ebenfalls an USB 2.


Zigbee (ZHA)

Integration: ZHA (Zigbee Home Automation), nicht deCONZ.

EinstellungWert
Device/dev/ttyAMA0
Baudrate38400
Hardware Flow ControlAktiviert

Zigbee-Geräte

GerätTypRaum
Aqara HubBridgeWohnzimmer
(weitere Geräte hier ergänzen)

ESP32-S3 BLE Proxy

Der Pi kann Zigbee und Bluetooth nicht gleichzeitig zuverlässig betreiben. Ein ESP32-S3 übernimmt BLE-Sensordaten und leitet sie per WLAN an HA weiter.

EigenschaftWert
IP192.168.178.32
FrameworkESPHome (ESP-IDF)
Modusbluetooth_proxy: active: true

iPad Dashboard

An der Wand montiertes iPad mini 5 als zentrale Steuerung. Drei Views: Steuerung, Pflanzen, Analyse.

Scripts

ScriptFunktion
Bin daAnkunft zuhause
Bin wegAbwesenheit
Gute NachtNacht-Modus
GamingGaming-Beleuchtung
FernsehenTV-Beleuchtung

Automationen

AutomationTrigger
GießerinnerungZeitbasiert + Pflanzensensor
LüftungserinnerungLuftfeuchtigkeit/CO2

Backup

HA-Backups laufen automatisch auf einen Samba-Share am Proxmox-Host (//192.168.178.3/homeassistant_backup). Details siehe Homelab – Storage & Backup.

EinstellungWert
ZielNetwork Storage (Samba)
ScheduleWöchentlich
Retention3 Backups
EncryptionAktiviert
Backup vor UpdateAktiviert

Emergency Kit (Encryption Key) separat sichern — ohne den Key sind die Backups nutzlos.


CalDAV-Integration

Nextcloud (extern auf Uberspace) liefert per CalDAV einen Geburtstagskalender für das iPad Dashboard.

# In configuration.yaml
calendar:
  - platform: caldav
    url: https://cloud.saschafiedler.com/remote.php/dav
    username: sascha
    password: !secret nextcloud_password
    calendars:
      - 'Contact birthdays'

Troubleshooting

  • ZHA startet nicht: ls -la /dev/ttyAMA0 prüfen. Ist USB 2 Kabel angeschlossen (nicht USB 3)?
  • Zigbee-Geräte fallen aus: USB 3 Interferenz? Bluetooth deaktiviert? Abstand zu USB 3 Geräten prüfen
  • ESP32 nicht erreichbar: WLAN-Signal, OTA-Passwort, ESPHome Dashboard prüfen
  • Backup auf Samba schlägt fehl: Proxmox-Firewall Port 445 offen? Samba-User/Passwort korrekt? Share-Name homeassistant_backup (Unterstrich, kein Bindestrich)