--- title: "Home Assistant" category: systems tags: [homeassistant, smart-home, mqtt, automation] created: "2026-09-27" modified: "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.) ## 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` ## 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,,"` (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** (`" ()"`, 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": }` → Formular mit **einem** Feld `ble_scanner_mode`: `disabled | auto | active | passive`, **Default `auto`** 2. `POST /api/config/config_entries/options/flow/` `{"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//reload`; WS `config_entries/reload` existiert NICHT). Repair-Issue `scanner_without_area` verschwindet danach. - Neue Distanz-Sensoren (`sensor.*_ble_distance_to_`) 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._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._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._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`). ## Related - [[systems/frigate]] — NVR Integration - [[systems/noris-ai]] — LLM Vision Provider - [[reference/ip-map]] — IP Assignments - [[reference/emhass-cascade-automation-architecture]] — Kaskaden-Architektur Details ## 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).