Files
memory/systems/homeassistant.md
T
2026-11-10 22:00:22 +00:00

33 KiB
Raw Blame History

title, category, tags, created, modified
title category tags created modified
Home Assistant systems
homeassistant
smart-home
mqtt
automation
2026-09-27 2026-11-01

Home Assistant

Smart Home Zentrale auf Proxmox. Steuerung, Automatisierung und Benachrichtigungen.

Infrastruktur

  • Host: 10.0.30.10 (HAOS VM)
  • SSH: hassio@10.0.30.10 (PW: 1P Vault "Hermes")
  • URL: https://homeassistant.familie-schoen.com
  • Container: homeassistant (Docker)

MQTT

  • Broker: Mosquitto Add-on v7.1.1 auf localhost:1883
  • HA MQTT User: ehemals opendtu (BROKEN — ACL blockiert), gefixt
  • ACL: /etc/mosquitto/acl definiert user homeassistant + user addons
  • Auth Plugin: go-auth.so (files,http backends)

Automations

  • File: /config/automations.yaml (35 Automations)
  • Schreibmethode: SSH → docker exec homeassistant chmod 666, danach restore 644
  • Reload: REST API mit JWT (HS256, signed from /config/.storage/auth)

Frigate AI Notification v3 (ID 1714065780832)

  • Trigger: MQTT frigate/reviews (severity=alert, Kameras Einfahrt/Terrasse) — NICHT frigate/events (Raw=Spam)
  • Gate: llmvision.image_analyzer (noris gemma-4-31b-it) VOR Push, binär KRITISCH/NORMAL
  • Suppress: sub_labels Sarah/Dominik; 300s Kamera-Cooldown; Review-ID-Dedup
  • Push: GENAU EIN kombinierter (Titel+Verdict+Objekte+Bild) nur bei KRITISCH ∨ KI-Fail ∨ Person (24/7, v3.1)
  • Siehe systems/frigate + Solution Doc bug-fixes/2026-10-10-frigate-notification-spam-review-alerts.md

Büro EG: Licht nach Präsenz (ID buero_eg_licht_praesenz_nachlauf, seit 02.11.2026)

  • Trigger: binary_sensor.esp32_c3_buero_eg_presence → on schaltet switch.licht_buro an; off für 15 min schaltet aus (Nachlauf)
  • Sweep: time_pattern /10 nur als Restart-Recovery (Licht an + Präsenz ≥15 min aus → aus). Kein Re-Assert auf on — manuelles Ausschalten bei Anwesenheit bleibt respektiert
  • Sensor-Verhalten: ESP32-C3 (10.0.50.147, Büro EG) meldet Präsenz in 30–120-s-Bursts, nicht dauerhaft → der 15-min-Nachlauf ist der eigentliche Träger der Logik; bei Fehl-Aus später Sensor-Config prüfen
  • E2E verifiziert 02.11.: On-Pfad live (Trigger → Licht an, 2×), Off-Pfad über 10-s-Testkopie (Prod-Config: 15 min), Testkopie gelöscht
  • Entity-ID nach Anlegen via WS-Entity-Registry umbenannt (Alias-Slugify verschluckt Umlaute: „Büro"→buro, „Präsenz"→prasenz)

Notify Services

Service Status
notify.mobile_app_iphone_dominik ✅ aktiv (DER Service für iPhone-Pushes)
notify.mobile_app_sarahs_iphone_app verfügbar
notify.mobile_app_ipad_2 / notify.mobile_app_sm_x205 verfügbar

⚠️ SERVICE ≠ ENTITY (Falle, 12.10.2026 live erlebt): mobile_app registriert zusätzlich notify-ENTITIES mit anderem Namen (z.B. Entity notify.iphone_dominik). Diese Entities existieren in get_states, sind aber KEINE Service-Targets. Als action-Target in Automations ist IMMER notify.mobile_app_* zu verwenden; Verifikation ausschließlich via get_services (nicht get_states!). Verwechslung führte am 12.10. zu einem fehlgeleiteten 14-fachen-Rename, der via Backup sofort revertiert wurde.

Entitäten

  • Kameras: camera.einfahrt_2, camera.terrasse_2 (Suffix _2 wegen verwaister Integration)
  • Motion: binary_sensor.einfahrt_motion_2, binary_sensor.terrasse_motion_2
  • Input Text: input_text.frigate_last_event_id (dedup storage, max 255 chars)

Snapshots

  • Gespeichert: /config/www/snapshots/{camera}_latest.jpg
  • URL: /local/snapshots/ (HTTP 200, keine Auth)

JWT Auth

  1. jwt_key aus /config/.storage/auth lesen
  2. Client Hermes_202606 (token id 1444b2c6757b4d66a6f8f8e5899b4e6a)
  3. HS256 signieren, Bearer Header
  4. ?return_response=true für Service-Call Responses

Integrations

  • Frigate (MQTT)
  • LLM Vision (noris AI gemma-4-31b-it)
  • Tibber (Strom)
  • Marstek Speicher (VENUS-E, IP 10.0.50.113)
  • NUT (APC Back-UPS ES 700G via ms-a2-1, 10.0.20.92:3493, User monuser; Sensors sensor.apc_*; Entry 5e1d2138235140eb9b476e9d6779c228; deployed via iac-homelab/epic-9-ups-nut)
  • Various sensors (Xiaomi BLE, etc.)

Zigbee / Zigbee2MQTT (Stand 10.11.2026)

  • Stack: Z2M Add-on 45df7312_zigbee2mqtt 2.14.3-1, zigbee-herdsman 11.2.0, ZHC 26.125.0; Addon-Zugriff nur über HA-Ingress-WS (Details: Skill-Ref smart-home-automation/references/zigbee2mqtt-remote-diagnosis.md)
  • Coordinator: SONOFF Dongle-M, EmberZNet 7.4.5 [GA], EZSP 13, TCP tcp://10.0.50.145:6638
  • Netz: Kanal 25, PAN 33072; 8 Geräte (5× Schlafzimmer-Lampen, Esszimmertür, Garagentor-Neigungssensor, Wetterstation)
  • permit_join: nur via switch.zigbee2mqtt_bridge_permit_join (254-s-Fenster, Refresher-Loop beim echten Pairing); mqtt.publish auf zigbee2mqtt/bridge/request/permit_join wird von der Broker-ACL still verworfen
  • HA-MQTT-Entry-Titel 192.168.100.27 ist kosmetisch/veraltet — Discovery läuft normal

Shelly/Ecowitt WS90 (gekoppelt 10.11.2026, Zigbee-Variante)

  • IEEE 0xc02cedfffe774579, EndDevice, interview complete, FW 251015/v1.1.6@62, Manufacturer Shelly, Model-ID WS90
  • 22 Entities sensor.wetterstation_* / binary_sensor.wetterstation_rain_status / button.wetterstation_identify (Auto-Discovery, keine Handarbeit)
  • Alle 12 Reportings + 7 Bindings von ZHC selbst provisioniert (inkl. precipitation); keine manuellen Reporting-Fixes nötig
  • Einheiten real: pressure hPa (nicht kPa wie Z2M-Doku), Wind km/h (nicht m/s), precipitation mm total_increasing
  • Live-Nachweis: humidity 51→42 % / Wind + Richtung / Gust innerhalb 95 s
  • Offen: battery 0 %, capacitor_voltage 0.1 V (frische Unit, lädt erst in der Sonne), voltage unknown
  • Kein weather.-Entity von Z2M — Wetterzustand nur als sensor.wetterstation_weather_condition (z. B. „cloudy")

Xenia Kaffeemaschine (Stand 11.10.2026)

  • ESP32 FW 3.9, IP 10.0.50.128 (VLAN 50, SSID IoT), REST /api/v2/overview (enthält MA_CUR_PWR in A!), /api/v2/machine/data|status|control
  • WARNUNG: MA_CUR_PWR ist AMPERE — Power (W) = MA_CUR_PWR × Spannung L1 (sensor.sn_3007105790_metering_voltage_l1 ≈ 234 V)
  • Sensoren: sensor.xenia_machine_data (REST, scan_interval 1s, attr-basiert robust), sensor.xenia_current_power_2 (GUI-Template, W), sensor.xenia_total_energy_2 (Integration daraus), sensor.xenia_status, switch.xenia_power (Alexa-Pfad, rest_command control), Wrapper sensor.xenia_active_power (Disagg)
  • Fix 11.10.: xenia_current_power_2 war seit ~Aug tot (Entity-Rename xenia_current_power→current_power_consumption brach GUI-Template-String) → neu: state_attr('sensor.xenia_machine_data','MA_CUR_PWR')|float(0) × voltage_l1|float(0); Metadaten (W/power/measurement) via Options-Flow komplett erhalten. Lesson: GUI-Template-Strings überleben Entity-Renames NICHT; REST-Sensoren feuern nur bei Wertänderung (idle = wenige History-Punkte ≠ offline); ESP32-Ping-Jitter (bis 550 ms) ist Power-Save, HTTP ist schnell (12–50 ms)
  • OFFEN (manuell, Setter defekt): Web-UI http://10.0.50.128: MA_MAX_AMPERE 0→10, MA_SET_TIMER_ECO_MA 0→5 restaurieren (Fehlschrieb 05.10.)
  • 4 Leichen im HA-Config-Dir: xenia_fix/modern/patch/remove_di.py (Alt-Sessions, ignorieren)

EMHASS Batteriesteuerung

  • Endpoint: http://10.0.30.10:5000 (v0.18.4)
  • Architektur: EMHASS = Sole Optimizer. Virtuelle Batterie 12,32 kWh (SMA SBS 7,2 kWh nutzbar + Marstek 5,12 kWh). Bis 03.11.2026 stand hier fälschlich 16 kWh (11k + 5k) — gemessen aus 10 Tagen Lade-/Entladehistorie, siehe unten.
  • Config API: POST /set-config überschreibt GESAMTE Konfig (kein Partial-Update!). Immer alle Felder senden. Siehe Solution Doc integrations/2026-10-02-emhass-set-config-overwrite-pitfall.md.
  • Aktuelle Config (2026-11-03):
    • Capacity 12320 Wh, Charge/Discharge 6700 W, Efficiency 0.9 (Backup: /config/config.json.bak-20261103 im Add-on-Container)
    • ⚠️ config.json liegt im Add-on unter /config/config.json, NICHT über die Add-on-Options (dort nur Solcast-Keys). Änderung = Datei editieren + docker restart app_5b918bf2_emhass.
    • Target SoC 0.15 (15%), Min SoC 0.1, Max SoC 1.0
    • set_battery_dynamic: True, set_use_battery: True
    • SoC sensor: sensor.total_soc, Power sensor: sensor.batteries_power_out_total
  • Kaskaden-Automation (1774430238377, ON): EMHASS target → BYD (803 Auto default, 802 bei target<=0 && pv<100) + Marstek (Rest via sensor.marstek_target_power)
  • Template Sensoren: sensor.smart_battery_target (EMHASS), sensor.marstek_target_power (Plan A: smart_target − actual_BYD_discharge). sensor.sma_target_power ENTFERNT (Double-Counting Bug).
  • Cutover (2026-10-09): v2 (emhass_optimizer_v2.py --publish --allow-grid-charge) ist EINZIGER Produzent; Cron a32005d62226 (runner emhass-optimizer-v2-runner.sh). v1 + Shadow-Collector d046e808f543 + Watchdog 19aef2351273 pausiert = Rollback-Hebel. Race-Guard 30/20 s. Details: reference/emhass-cascade-automation-architecture
  • Cutover 2 (2026-11-02 16:19): Produzent lebt jetzt IN Home Assistant. AppDaemon-Add-on a0d7b954_appdaemon (v0.19.3, boot: auto), App emhass_optimizer unter /mnt/data/supervisor/app_configs/a0d7b954_appdaemon/apps/ (Quelle: ~/scripts/emhass_app/: emhass_core.py = per AST verbatim aus v2 extrahierte Mathematik, emhass_cycle.py = Input-Phase, emhass_app.py = Trigger/POST/Verify/Ledger). Trigger :04/:19/:34/:49, Ledger /share/emhass/ledger.jsonl, Fehler → persistent_notification. Kein Long-Lived-Token mehr im Produktionspfad (AppDaemon bekommt HA-URL+Token automatisch vom Supervisor); EMHASS-Add-on bleibt unangetastet (nur /action/dayahead-optim + /action/publish-data). Hermes-Cron a32005d62226 pausiert = Rollback (cronjob_manage resume, Token-Symlink existiert weiter). Parity-Nachweis: 19/19 Unit-Tests Kern↔v2 + Payload-Gate PARITY OK (v2 --dump-payload vs. Shadow, 48 Slots, 0 Warnungen). E2E 16:04 (Cutover) und 16:19 (erster Einzelproduzent, CSV synchron 16:19:00). SolDoc architecture/2026-11-02-emhass-producer-appdaemon-cutover.md
  • Publish-Pfadbruch 11.10. (GEFIXT ~20:30 UTC): Nach HA-Core-Restart (Recorder-Incident) DEADLOCK: p_batt_forecast/soc_batt_forecast/plan_* sind set_state-Entities (überleben Restart NICHT), v2 liest sie hart → jeder Tick FATAL → nichts publizierte je wieder. Zweiter RC: rest_command-URLs localhost:5000 — HA läuft im HOST-Netz, Addon in HassIO-Bridge; nach Restart connection-reset (10.0.30.10:5000 ging stets). Fix: beide URLs → http://10.0.30.10:5000 (Backup configuration.yaml.bak-20261011-restcmd) + rest_command/reload. Heal-Pattern: POST :5000/action/publish-data direkt ans Addon. Verifikation: v2-Tick 20:32 komplett, plan_* 48 Slots, Kaskade folgt. ⚠️ Legacy-Automation „Trigger EMHASS" (*/15): dayahead-call 400 (Payload ohne pv/load-Arrays) — funktional durch v2-Cron abgedeckt, disable/fix offen. Solution Doc integrations/2026-10-11-emhass-publish-path-break-after-restart.md
  • Token-Pfad (seit 02.11.2026): HA-Token kanonisch ~/.hermes/secrets/ha_token.txt (0600, aus 1P op://Hermes/ewviwqhnpcpd2tg2gh5jbv76xm/password), /tmp/ha_token.txt nur Symlink; ~/.hermes/scripts/ha-token-ensure.sh heilt fehlenden Symlink/Token bei jedem v2-Lauf. Grund: /tmp wurde beim Boot 30.10. geleert → v2-Cron starb 3 Tage still (FATAL: token file missing), während automation.trigger_emhass per /action/publish-data weiter die letzte Zeile des alten Plans postete (frische Zeitstempel, eingefrorene Werte).
  • Cron-Schedule (seit 02.11.2026): a32005d62226 nicht mehr every 15m (Anker driftet in den Race-Guard → dauerhaft REFUSED rc=2), sondern 4,19,34,49 * * * * Europe/Berlin.
  • Watchdog: 3a99e3837250 check_emhass_plan_freshness.sh, stündlich :12, silent-on-healthy, Alarm wenn die Result-CSV-Mtime >40 min alt ist oder der Plan-Horizont <10 h (Telegram). ⚠️ Keine Sensor-Zeitstempel als Liveness nutzen: automation.trigger_emhass ruft alle 15 min rest_command.emhass_publish_data und frischt p_batt_forecast/soc_batt_forecast bei eingefrorenem Plan auf (dieselbe Maske wie beim 3-Tage-Ausfall); der Display-Publisher tut dasselbe für plan_*. Nur opt_res_latest.csv schreibt ein echter dayahead-optim. Test-Overrides EMHASS_MAX_AGE_MIN / EMHASS_CSV_PATH. Der alte Kaskaden-Watchdog a2a1b429bc2e ist seit 25.09.2026 pausiert (und enthält ein SSH-Klartextpasswort in cron/jobs.json).
  • automation.trigger_emhass (1774260225020) ist seit 03.11.2026 06:40 OFF (initial_state: false, Backup automations.yaml.bak-20261103-0620). Sie rief nur alle 15 min rest_command.emhass_publish_data und hat damit einen eingefrorenen Plan mit frischen Zeitstempeln übermalt — die zentrale Maske beider EMHASS-Ausfälle. Der Produzent publiziert selbst; die Automation ist nicht mehr nötig.
  • Incident 03.11. 01:04–05:49 (5 h still): Idempotenz-Bug in der App — _slot_key war %Y%m%d_{minute//15} → nur 4 Marker/Tag, danach already ran … skip für jeden weiteren Tick (Optimierung lief nur 4×/Tag um 00:xx). Fix: Key %Y%m%d_%H%M; App-Arg run_on_start als Ops-Hebel für Sofort-Zyklus nach Deploy. Warum unbemerkt: Watchdog maß p_batt_forecast, das die Publish-Automation alle 15 min auffrischte → jetzt CSV-Mtime. Verifiziert: Zwangszyklus 05:49:45 + planmäßiger Tick 06:04 nach dem Fix.
  • Display-Publisher (seit 02.11.): Cron 4bc13a052329 (:05/:20/:35/:50, no_agent) → emhass-extra-publisher-runner.sh → emhass_extra_publisher.py. Spiegelt die EMHASS-CSV (per SSH, read-only) in sensor.plan_pv_forecast / plan_netz_forecast / plan_last_forecast fürs Akku-Dashboard. Optimiert nie; braucht den HA-Token nur zum Schreiben dieser drei Anzeige-Sensoren.
  • Historie: Phase-2 Shadow (08.10., Dual-Solve, Deferrables als Phantom-Last entfernt, CSV 17 Spalten); Arbitrage-Flip produktiv (08.10. 22:20, set_nocharge_from_grid false).
  • Backup: .bak.20261001_175804 für configuration.yaml + automations.yaml
  • NFS-Backups (Fix 2026-10-07): Supervisor-Mounts Backup_NFS (usage=backup) + Medien_NFS (usage=media) → 10.0.20.100:/pool01_n2_redundant/HomeAssistant (vorher tote 10.0.30.100, verloren beim NAS-Crash-Reboot 03.10.). Volle automatische Backups ~03:27 UTC nightly. Monitoring: Hermes-Cron 2006a91fba21 (Alert bei Backup-Alter >30h). Lösungsdoku: docs/solutions/bug-fixes/2026-10-07-ha-audit-nfs-mount-failure-after-nas-crash.md

PV-Anlage & Forecasts (Stand 11.10.2026)

Arrays/WR:

Array WR Strings kWp/Real Forecast-Lage
Dach Teil 1 SMA SB SN 3006252807 (10.0.50.201) 2 (A+B, je String Ausrichtung unklar, SO/SW-Mix) ~5,7 kWp; 6,7 kWh/11.10. nur via FS-Site "Dach Südwest" (225°/23°/5760 W) — Zuordnung zu WR unbelegt
Dach Teil 2 SMA SB SN 3006252817 (10.0.50.203) 2 (dto.) ~4,0 kWp; 6,7 kWh/11.10. FS-Site "Dach Südost" (145°/24°/4000 W) — Zuordnung unbelegt
Speicher SMA SBS SN 3007105790 (10.0.50.202, BYD) keine PV-Strings — n/a
Zelt Hoymiles HM-1500 (OpenDTU 10.0.40.55) 2 Module zeltartig SW/NE aneinandergelehnt 1,5 kWp; 2,1 kWh ✅ FS-Sites "Zelt Südwest"+"Zelt Nordost" (65°/225°+65°/45°, je 750 W) seit 11.10.
Schuppen 1 Hoymiles HMS (Limit 2250 W) SW, ~5° flach 2,2 kWp; 2,9 kWh FS-Site ✓ (225°/5°/2200)
Schuppen 2 Hoymiles HMS (Limit 2250 W) SW, ~5° flach 2,64 kWp; 3,5 kWh FS-Site ✓ (225°/5°/2640)

Aggregation: sensor.pv_production = min_max über 5 Sensoren (2×SMA grid_power + 3×Hoymiles) ✓ korrekt. ⚠️ sensor.pv_daily_energy_total = SUMME der 3 SMA daily_yields OHNE Hoymiles (−11%) und inkl. SBS-Batteriedurchsatz — nicht als PV-Tagesertrag verwenden!

Forecast-Systeme (3 parallel):

  1. Solcast (Custom, Entry 01KKTKEN0VAWQTQCS4WWCQJWPT) = PV-Input für EMHASS-v2-Optimizer (pooled aus *_prognose_heute/morgen/tag_3 detailedHourly). Sites: "Schön Rohr" (043e-b831-88bf-b087, 16 kW, Azimut -132,6°/Tilt 19°, Freystadt = gemittelte Gesamtanlage) AKTIV; "Ogdak Netherlands" (59c8-caae-52f5-1686, Solcast-DEMO-Site Apeldoorn/NL) seit 11.10. excludiert (war ~9,6/23,4 kWh Phantom-PV!). API-Quota 30/Tag (Site-getrieben), hard_limit 100.
  2. forecast.solar (Core, 4 Subentries): Dach SW/SO, Schuppen 1/2 — Dashboard-only, kein Optimizer-Input. Nutzer-Beschluss 11.10.: komplett neu bauen (war unbedacht eingerichtet). Achtung: API liefert lokale Timestamps; HA-Sensoren zeigten +2h-versetzte Werte (physikalisch unmögliche "Resttag"-Energie nach Sonnenuntergang) — beim Rebuild prüfen.
  3. EMHASS-Addon intern (open-meteo + pvlib, generisches Fronius/CSUN-Modell) — irrelevant, v2-Optimizer published eigene Pläne.

Bekannte Issues (11.10.):

  • ✅ TZ-Bug emhass_optimizer_v2.py::build_pv_series GEFIXT 18:29 (tzinfo=BERLIN statt utc, Backup .bak-20261011-tzfix): Live-Tick 18:28 zeigte erstmals korrekte Abendkurve (36 W/18:30, 0 W nach Sunset statt ~1750 W Phantom).
  • ✅ Reload-Race-Gefahr GEHÄRTET 18:47: collect_solcast_pools() mit 3×10s-Retry (Solcast-Options-Reload setzt Sensoren ~16s unavailable; 18:43-Tick crashte laut doctrine-konform).
  • ✅ forecast.solar: Zelt-Sites ergänzt — "Zelt Südwest" (65°/225°/750 W) + "Zelt Nordost" (65°/45°/750 W), Area Photovoltaik. Dach/Schuppen-Entries validiert (SW/SE-Split ~62/38 ↔ 5,76/4,0 kWp passt zu Messdaten). HA-Parser ist KORREKT (Bibliothek fordert time=utc an; früherer +2h-Verdacht war Eigen-Parse-Artefakt).
  • ✅ Solcast: auto_dampen=True + get_actuals=True + Kalibrierquelle sensor.pv_production (Validator-Kopplung "dampen_without_actuals" beachtet). Dämpfung lernt ab jetzt.
  • ✅ sensor.pv_daily_energy_total repariert: Hoymiles REIN, SBS-Batteriedurchsatz RAUS (19,44→22,03 kWh, real ~22,4).
  • 🟡 Solcast-Single-Site "Schön Rohr" = Mittelung (1 Azimut/Tilt für 6 Arrays) — Struktur grob, aber jetzt kalibrierend gedämpft; Feintuning über auto_dampen-Daten (Tage) beobachten.
  • ✅ Sauna-Shelly misst NETTO (HM-1500 speist auf dem Sauna-Stromkreis rück): Shelly = Kreislast − Zelt-PV (validiert 11.10.: Steigung −0.983, r=−0.9985; Integrale 2,07 vs. 2,13 kWh). Template Sauna Active Power GEFIXT 19:39: max(0, ΣPhasen + hm_1500_power) mit float(0)-Guards — liefert jederzeit die wahre Sauna-Last, "Rest"-Helfer korrekt.
  • Solution Doc: docs/solutions/integrations/2026-10-11-solcast-sample-site-contamination-and-tz-shift.md

Garagentor (free@home ch0003) — Flanken-Toggle-Semantik

  • Kanal: switch.garagentor = free@home Schaltaktor ABB20C351F51/ch0003, treppenlicht-parametriert (Kanal nach Aktivierung AN bis Timer-Ablauf). cover.garagentor = Template-Cover darüber (open/close = je EINE Kanalaktivierung).
  • Motor toggelt auf JEDE Kanalflanke. Einzelimpuls = sauber Umschalten (belegt: 17:51 Puls → schloss in ~90s). Zwei schnelle Flanken = Start-Stopp (belegt: 17:07 mein OFF→ON-Doppelpuls, 17:48 Nutzer-Doppelklick — jeweils blieb das Tor offen!). Doppelklick-Gewohnheit wirkt der Schließfahrt aktiv entgegen.
  • BUG (seit 05.10.): switch.garagentor = unknown, 0 Logbook-Events — Statusrückmeldung SysAP→HA für ch0003 tot. SysAP-REST-Zugang ist bekannt (Local-API-User Installer, s. Abschnitt „free@home Local-API" unten), SSH-Addon gestoppt.
  • Automations (2026-10-10, REST-config): warn_offen_beim_verlassen (Person weg >2min + Garagentor/Esszimmertür offen → time-sensitive Push mit CLOSE_GARAGE-Button) + garagentor_push_close v8 Single-Edge (Guards: offen+90s stabil+45s Anti-Doppeltipp; EIN switch.turn_on, KEIN turn_off-Präludium; 45s-Verifikation per Neigungssensor; Retry erst nach 480s; ehrliche Fehler-Push). Tag warn_offen_beim_verlassen aktualisiert Notifications.
  • Nur 2 physische Öffnungssensoren im Haus: Garagentor (Neigungssensor+Cover) + Esszimmertür (binary_sensor.esszimertur_contact, Aqara). free@home-Panels sind Taster, KEINE Fensterkontakte.
  • Solution Doc: docs/solutions/integrations/2026-10-10-freeathome-garage-impulse-toggle-semantics.md

free@home SysAP XMPP-Wedge & Remote-Reboot (Stand 12.10.2026)

  • Chronik: 05.10. IqTimeout-Massenausfall (22 Entities, Fix: 120s-getAll-Timeout+300s-Keepalive, ephemeral in Container). 11.10. 19:56 erneuter Totalausfall — diesmal trotz Patch: XMPP-RPC-Dispatcher lebte (echoTest/HW 0,1s), aber getAll hing serverseitig (>280s, REST liefert dieselben Daten instantan). HA-Restart wirkungslos (Fehler kam direkt nach frischem HA-Start 19:53).
  • HEBEL: RemoteInterface.reboot(0) via XMPP — derselbe RPC, den die SysAP-Web-UI nutzt (Qt-WASM, kein REST-Endpoint). Funktioniert AUCH im Wedge (ACK 7,6s, ~4min Downtime, Konfig unversehrt). Param: RestartEraseCode 0=simpleRestart, 1=factoryReset(!), 2=resetUsingFlags, 3=factoryResetWithoutIA — nur 0. Danach homeassistant/reload_config_entry.
  • Recovery ist push-gestaffelt (Normverhalten, kein Defekt): Steuerplane (Switch/Light/Cover-Pos) sofort aus getAll-Seed; Sense-Plane (Panel-Temp odp0010, Climate, BinSens, Locks) erst beim ersten Bus-Push (Min–Std). Identisch nach 05.10.-Vorfall (Recorder-History belegt).
  • Garagentor-switch BUG bleibt: ch0003-Status weiterhin unknown (Status-Datapoint seit 05.10. tot, auch nach SysAP-Reboot 12.10.). Befehlspfad funktioniert. → dauerhafte Lösung nur via Local-API-Migration.
  • Kollateral 12.10.: Automation „Dimmer Schlafzimmerlicht" (1697532906675) von HA deaktiviert (Trigger-Entity bei setup_error aus Registry geräumt). Analyse: leere Action-Hülle ohne Wirkung — echte Logik in „Helligkeit Schlafzimmerlicht"/script.adjust_lights_schlafzimmer (intakt). Empfehlung: löschen.
  • Migrations-Kandidat: kingsleyadam/local-abbfreeathome-hass (REST+WS statt XMPP; SysAP-Kompatibilität verifiziert: REST 200, WS-Frame-Empfang ok, restApiStatus enabled). Impact: 152 Entities, 29 Refs automations.yaml, 241 Refs Lovelace. WebSocket live getestet 12.10.: verbindet + pusht.
  • Watchdog AKTIV (12.10.): Cron-Job 43612c6d52b6 (jede 15 min, script-only, still bei Gesundheit, Telegram-Alert bei Intervention): setup_error ≥30 min → automatischer reboot(0) via persistentem Rescue-Kit /config/fah_rescue/rescue.py (HA-Container, überlebt Recreation) → SysAP-HTTP-Wait ≤8 min → reload_config_entry → Verifikation. Schutz: 6h-Reboot-Cooldown, Lock, Blind-Alert 1×/Tag, Throttle-Hinweis 1×/Tag. Lokal: ~/.hermes/scripts/fah_watchdog.py (--selftest prüft Kette read-only).
  • Watchdog-Reparatur 06.11.2026 (war blind + interventionsunfähig): Meldung „BLIND (RuntimeError)" kam, weil get_token() bei jedem Tick op read gegen 1Password machte — Service-Account war rate-limitet („Too many requests"; Reads ~1.000/h + Tageslimit). Zweiter, schwererer Defekt: guest_exec() hardcodete root@10.0.20.93 (ms-a2-2), VM 106 lief aber auf proxmox3 → Configuration file nodes/ms-a2-2/qemu-server/106.conf does not exist, der Rettungs-Reboot hätte nie gefeuert. Fix: Token cache-first aus ~/.hermes/secrets/ha_token.txt (1P nur on-miss/401, Fallback auf Cache bei 1P-Ausfall) + resolve_pve_host() via pvesh get /cluster/resources --type vm. Verifiziert: --selftest → „Kette intakt" (ECHOTEST_OK, GETALL_OK 40,8 s), Entry freeathome = loaded. 1P-Limit hielt >8 min an (kein lokaler Verursacher-Prozess) — betrifft alle op-Skripte. Solution Doc: docs/solutions/bug-fixes/2026-11-06-fah-watchdog-blind-1p-ratelimit-node.md.
  • Solution Doc: docs/solutions/integrations/2026-10-12-freeathome-sysap-xmpp-rpc-wedge-reboot-fix.md

HA-Freeze via Memory-Leak + Verbindungs-Fix (Stand 08.11.2026)

  • Freeze (2× am 08.11.): HAOS-VM 106 (12 GB) erstarrte — Kernel lebte (ICMP ok), Userspace tot (:8123 refused, SSH-Banner-Timeout, Guest-Agent down) → nur qm reset hilft. Kernel-Beweis des toten Boots: 391× „Under memory pressure" ab 14:51 (10,3 h nach Boot). RCA: freeathome v1.0.12-Reconnect-Pathologie (wait_for_connection/aiohttp ohne Timeout, blockierende SSL-Init im Event-Loop, reconnect=True → Client-Akkumulation) als Reaktion auf die SysAP-XMPP-Session-Instabilität. SysAP selbst gesund (REST 200, WS 101, 5222 connectet). Solution Doc: docs/solutions/bug-fixes/2026-11-08-ha-freeze-freeathome-xmpp-leak.md.
  • Fix 1: Integration v1.0.13 (PR #317 „monitor no longer stops updates") via update/install + Core-Restart. E2E bewiesen: REST-Write ABB24F351F51.ch0001.idp0000=1 → switch.techniklicht in 1,5 s in HA aktualisiert (XMPP-Event-Stream intakt).
  • Fix 2: VM-RAM 12→16 GB (qm set 106 --memory 16000; balloon=0 → Stop/Start nötig; Node-Headroom vorher geprüft).
  • Fix 3 — Watchdog gehärtet: Stufe 0: ha_http_up()+vm_agent_alive() beide tot = Freeze → nach 2 Ticks (~30 min) autom. qm reset 106 (6 h Cooldown, Boot-Verifikation 10 min). Stufe 0b: Memory-Probe je Tick → ~/.hermes/scripts/ha_mem_log.jsonl; Alerts ab HA-Container 9,5 GiB / avail<1,5 GiB / Steigung ≥250 MiB/h (2-h-Fenster). Selbsttest + Tick grün.
  • Pitfalls: HAOS-Host-Shell = busybox-artig: /dev/tcp gibt FALSE NEGATIVE, nc/python3 fehlen → TCP-Tests via docker exec homeassistant python3 (socket.create_connection). curl -m telnet:// Exit 28 beweist nichts. HA-Log-Dateien: .log.1 war von 2025 (Jahreszahl beim Grep prüfen!), aktuelles Log nur im Journal (docker logs). journald volatile → Kernel-Beweise des Vorboots nach Reboot weg. Custom-Integration-Logger WARNING-gefiltert → fehlende INFO-Zeilen sind kein Beweis. Cron-Fehler „worker exited before ownership acknowledgement" = Hermes-Dispatch, nicht Skript (failure_streak beobachten).

free@home Local-API & Wanddisplay-Widgets (Stand 03.11.2026)

  • Zugang: REST https://10.0.50.40/fhapi/v1/api/rest, HTTP Basic, User Installer; Passwort im HA-Config-Entry freeathome (01K6JFZYN6J1FWDSTEHD5H4BHK) — nur über das Dateisystem lesbar. VM 106 läuft auf proxmox3 (10.0.20.30), nicht auf .93.
  • API v1: configuration, devicelist, device, datapoint, pairings, sysap, notification, virtualdevice, ws. Swagger https://10.0.50.40/swagger/, Spec /fhapi/v1/openapi.yaml. Kein Panel-/Widget-Endpoint.
  • Display: ABB6BC5495EA „free@homeTouch 7"" (deviceId 1038), Raum Essbereich (EG) — nur ein Display im SysAP (die drei HA-HomeKit-Einträge sind Bridge-Accessories, keine Panels).
  • Widgets = Panel-Kanäle ch0000–ch000f + /pairings: 9 belegt, 7 frei; leere Slots auto-benannt " 1,<row>,<col>" (4×4-Raster, Kanalindex zeilenweise). Kanäle ch0010–ch001c = Türsprech-Funktionen.
  • Live-Status nur über Ziel-Aktor-odp lesen — Panel-Kanäle sind eigene, nicht gespiegelte Datapoints.
  • Solution Doc: docs/solutions/integrations/2026-11-03-freeathome-panel-widgets.md · Skill-Ref: smart-home-automation/references/freeathome-local-api.md

BLE-Proxies / Trilateration (Stand 01.11.2026)

Bermuda (Entry 01M1CF5AT5FAKMBHTMVCX0DRBS) = Trilateration. HA hat KEINEN lokalen BT-Adapter (VM, manager.adapters = {}), alles läuft über Remote-Scanner.

Proxy Typ Area connectable
shellypro3em-08f9e0e98b9c ("Stromverbrauch Heizung") Shelly Heizraum ❌
shellypro3em-08f9e0e952e0 ("Strommessung Sauna") Shelly Garage (EG) — Gerät sitzt in der Garage, nur die Sauna steht auf dem Garagendach (Dachterrasse OG) ❌
shellyplus1-d0ef76d91930 ("Bewässerungskreis vorne") Shelly Garten ❌
6× shellyplus1 (Beete/Hochbeete/hinten/mitte/Pumpe/Licht Terrasse Gartenhaus) Shelly Garten ❌
shellyplus1-a0a3b3c396e4 ("LED Streifen Windfang") Shelly Windfang ❌
shellypro4pm-841fe89726d0 Shelly Garten (gesetzt 01.11.) ❌
ble-proxy (10.0.50.206) ESPHome Wäscheraum ✅
esp32c3-supermini-buero-eg (10.0.50.147) ESPHome Büro EG ✅
esp32c3-supermini (90:DA:72:88:EB:42) ESPHome System OFFLINE

→ 13/13 aktive Proxies (sensor.bermuda_global_active_proxy_count), alle Mode auto; jede Shelly liefert 5–21 distinkte Geräte/Minute (Diagnostics data.devices[*].stamps, 45-s-Fenster).

Area-Zuordnung der Scanner (Falle 01.11.): Bermuda nimmt die Area NICHT vom Shelly-Gerät, sondern vom Bluetooth-Geräte-Record ("<Name> (<MAC>)", angelegt von der bluetooth-Integration). Beide Records müssen dieselbe Area haben, sonst gewinnt der BT-Record. Beispiel Sauna: Shelly-Gerät + 3 Phasen-Kinder auf garage gesetzt → Bermuda zeigte weiter „Dachterrasse (OG)", bis auch der BT-Record Strommessung Sauna (08:F9:E0:E9:52:E2) auf garage stand. Danach: area_name=Garage, floor_name=EG. Area garage hatte floor=None → auf eg gesetzt.

Shelly als BLE-Scanner freischalten (der einzige Weg, 01.11. verifiziert): nicht per RPC (BLE.SetConfig enable=true reicht NICHT, BLE.GetStatus bleibt {}), sondern HA-Options-Flow der Shelly-Integration:

  1. POST /api/config/config_entries/options/flow {"handler": <shelly entry_id>} → Formular mit einem Feld ble_scanner_mode: disabled | auto | active | passive, Default auto
  2. POST /api/config/config_entries/options/flow/<flow_id> {"ble_scanner_mode":"auto"} → create_entry (löst Reload des Shelly-Entry aus)
  3. Verify: Shelly-Scanner erscheint im BT-Manager (scanning=true, last_detection frisch) — Device-seitig bleibt BLE.GetStatus leer, das ist normal.
  4. Beweis (A/B, 01.11.): disabled → Scanner weg (13→12), auto → wieder da (12→13). Die Option ist die Steuerung; der Wert selbst ist im REST-/WS-Entry-Listing NICHT sichtbar (options={}) — nicht als Statusquelle nutzen, sondern die Scanner-Liste prüfen.

Wichtig:

  • Shelly-Scanner sind passiv (connectable=False) → GATT-Geräte (LD2410-Presence, Schlösser, aktive Sensoren) brauchen ESPHome-Proxies.
  • 13 Scanner > 3 Slots → HA bluetooth.auto_scheduler teilt Scan-Fenster (15 s) im Round-Robin zu; nicht auf always stellen (2,4-GHz-Kollision).
  • Bermuda cached Scanner-Areas beim Setup → nach Area-Änderung Config-Entry reloaden (REST POST /api/config/config_entries/entry/<id>/reload; WS config_entries/reload existiert NICHT). Repair-Issue scanner_without_area verschwindet danach.
  • Neue Distanz-Sensoren (sensor.*_ble_distance_to_<scanner>) entstehen erst beim Bermuda-Reload; Werte None = Scanner hört das Gerät aktuell nicht.
  • Distanzen sind unkalibriert (Default ref_power=-55, attenuation 3). Korrektur 01.11.: ref_power ist PRO GETRACKTEM GERÄT (iPhone/Tag/Schlüssel), NICHT pro Scanner — Bermuda-Entity number.<device>_ble_calibration_ref_power_at_1m_0_for_default, 0 = Default. Pro Scanner gibt es nur attenuation (Pfadverlust-Exponent, options.attenuation=3). Kalibrierung = Gerät auf 1 m neben einen Scanner legen, sensor.<device>_ble_nearest_rssi (Default deaktiviert → config/entity_registry/update disabled_by=null + Bermuda-Reload) samplen, Median als ref_power setzen. Werkzeug: ~/workspace/bermuda_calib.py {status,sample,apply,geometry}.
  • Geometrie ist der eigentliche Engpass, nicht die Kalibrierung (Messung 01.11., 30-s-Fenster): 18 von 27 BLE-Geräten werden von ≥3 Scannern gleichzeitig gesehen (Top: 11) — aber nur im/am Garten, weil 9 der 13 Scanner dort hängen. Indoor (iPhone Dominik) sieht genau 2 Scanner (BLE Proxy, Büro EG), beide ESPHome → Area-Ausgabe fürs iPhone unbrauchbar (Wäscheraum bei 8,3 m). Vor weiterer Kalibrierung: mehr ESPHome-Proxies indoor (Wohnen/Schlafen/Essen).
  • sensor.<device>_ble_nearest_rssi / _nearest_scanner sind per Default disabled; nach dem Aktivieren braucht es einen Bermuda-Entry-Reload, sonst 404 im State-Machine.
  • Config-Entry-Titel umbenennen geht per WS config_entries/update {"entry_id":..,"title":..} (existiert, im UI nicht dokumentiert); config_entries/reload existiert dagegen nicht (nur REST).
  • $HA_TOKEN in der Host-Env ist veraltet (401) — funktionierender Token liegt in /tmp/ha_token. Skripte müssen die Datei bevorzugen, sonst 401 auf jedem API-Call.
  • Shelly-Devices haben Kind-Geräte (Pro3EM Phase A/B/C, Pro4PM Output 0..3); Area-Zuweisung nur am Eltern-Gerät reicht nicht — Kinder können vereinzelt ohne Area bleiben (Fix 01.11.: Output 0/„Brunnenstein" → Garten via config/device_registry/update).

Security-Status

  • CVE-2026-98432: geschlossen (2026-11-02) — HAOS VM106 läuft 6.18.58-haos (Fix ab 6.18.56/57). Kernel-Check via qm guest exec 106 -- uname -r (QGA aktiv, VM liegt auf proxmox3).

free@home Zombie-Session (09.11.2026 — 2. IqTimeout-Rezidiv, gefixt)

  • Failure-Mode: Nach Event-Loop-Blockaden (Galera-SST-Sturm/Ceph-slow-ops 08.11. 19:01–19:21) blieb die XMPP-Session zombie: slixmpp „connected" (keine Connection-lost-Warnungen mehr, kein setup_error), aber set_datapoint → IqTimeout, keine PubSub-Events (Kanari stale). SysAP gesund. Watchdog blind dagegen (HA up, Memory ok).
  • Fix: docker restart homeassistant (qm guest exec auf VM106) → Integration lädt, E2E: turn_on via HA-API → State-Change in 3,0 s.
  • E2E-Verifikation IMMER über HA-Service-Call (testet den XMPP-Write-Pfad), nicht REST-datapoint-PUT (404t auf dieser Firmware — auch /configuration zeigt keine Datapoints, weder alt noch neu).
  • Offen: Watchdog-Stufe 0c Kanari-Staleness (Vorschlag an Owner).