Files
memory/reference/emhass-cascade-automation-architecture.md
2026-11-12 22:00:23 +00:00

213 lines
10 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "EMHASS Kaskaden-Automations-Architektur"
category: reference
tags: [emhass, battery, cascade, homeassistant, byd, marstek]
created: "2026-10-02"
modified: "2026-10-08"
---
# EMHASS Kaskaden-Automations-Architektur
> Steuerung der dualen Batterie-Systems (BYD 11kWh + Marstek 5kWh) via EMHASS Optimizer + HA Kaskaden-Automation.
## Architektur-Übersicht
```
EMHASS (LP Solver) → sensor.smart_battery_target
↓
┌───────────────────┴──────────────────┐
│ Kaskaden-Automation (jede 2 Min) │
├───────────────────────────────────────┤
│ BYD/SMA: 803 Auto (default) │
│ 802 Manual (bei target≤0) │
│ Marstek: force_mode via │
│ sensor.marstek_target_power │
│ (= smart_target − BYD_actual)│
└───────────────────────────────────────┘
```
## EMHASS Configuration (12,32 kWh Virtual Battery)
> **Korrigiert 03.11.2026:** Kapazität war mit 16000 Wh angesetzt (Annahme BYD 11 kWh),
> real nutzbar sind 7,2 kWh (SMA SBS, aus 10 T Lade-/Entladehistorie gemessen) + 5,12 kWh
> (Marstek) = **12320 Wh**. `sensor.total_soc` rechnet seit dem Fix mit demselben Nenner,
> sonst wäre die SOC-Kurve inkonsistent zur Modellkapazität.
| Parameter | Value | Hinweis |
|-----------|-------|---------|
| `battery_nominal_energy_capacity` | 12320 | SMA 7,2 kWh nutzbar + Marstek 5,12 kWh |
| `battery_charge_power_max` | 6700 | 4200 (BYD) + 2500 (Marstek) |
| `battery_discharge_power_max` | 6700 | dto. |
| `battery_charge_efficiency` | 0.9 | Konservativ, gemischt |
| `battery_discharge_efficiency` | 0.9 | dto. |
| `battery_target_state_of_charge` | 0.15 | 15% Reserve (geändert von 0.30 am 2026-10-02) |
| `battery_soc_deficit_cost` | 0.0 | live 12.11.: Strafe ist AUS (Wiki hatte 0.5) |
| `battery_minimum_state_of_charge` | 0.1 | 10% Hard Floor |
| `battery_maximum_state_of_charge` | 1.0 | 100% |
| `set_battery_dynamic` | True | Dynamische Peeling erlaubt |
| `set_use_battery` | True | Batterie aktiv |
| `sensor_battery_state_of_charge` | `sensor.total_soc` | Gewichteter Gesamt-SoC |
| `sensor_power_battery` | `sensor.batteries_power_out_total` | Entladeleistung |
| `use_websocket` | True | |
| `optimization_time_step` | **15** | seit 12.11.2026 (war 30) → 96 Slots/24 h |
| `battery_stress_cost` | 0.0 | kein Wear-Cost im LP |
| `battery_soc_final_reward_factor` | 0.0 | Ende-SoC unbewertet |
## Preise & Gate (neu 12.11.2026)
`emhass_app/emhass_prices.py` ersetzt den Carry-forward-Pfad. Drei Tiers:
1. **Sensor** `sensor.epex_spot_data_total_price` — hält nur *heute* (96×15 min)
2. **energy-charts Day-Ahead** (SMARD/Bundesnetzagentur, CC BY) — per Least-Squares
auf das Endkunden-Niveau gefittet (gemessen 12.11.: a=+0,1529, b=1,190). Optional,
429/404 sind normal (Auktion erst ab ~13:00 veröffentlicht).
3. **Gelernter Tagesgang** — 28-Tage-Median je Viertelstunde aus der
Recorder-Historie des Preissensors; Cache `price_shape.json`, Refresh 03:30.
**Gate:** erste 12 Slots echt, real ≥40 %, Carry-forward ≤25 %, estimated ≤60 % →
sonst kein Solve, kein Publish, persistent_notification + Ledger `blocked`.
Realität 09:00–13:00: ~58 % echt + 42 % Shape (das ist der Ersatz für die
Phantom-Nachtpreise, nicht ein Fehler).
**Slot-Raster:** `slot_min: 15` in `apps.yaml` setzt `core.SLOT_MIN/N_SLOTS`;
die App vergleicht beim Start mit `optimization_time_step` und blockiert bei Mismatch.
## Lastprofil: statisch war 30–40 % zu niedrig (12.11.2026)
Das Profil vom 08.10. (Median aus 02.–08.10.) rechnete mit **27,4 kWh/Tag**. Die
Messung aus dem Recorder ergab für 05.–11.11.: 39,2 / 52,9 / 48,9 / 14,5* / 42,8 /
**69,0** / 40,8 kWh (Do–Mi; *08.11. Sonntag mit Recorder-Lücke, nur 7,8k statt ~50k
Samples). Der Plan unterschätzte die Hauslast also systematisch um 30–40 %.
Konsequenzen, umgesetzt:
- `emhass_profile_refresh.sh` + Cron `ccf94ac266c6` (So 04:00) baut das Profil wöchentlich
aus der Recorder-Historie neu, testet, deployt, verifiziert den nächsten Zyklus.
- Builder überspringt Tage mit `< MIN_SAMPLES_PER_DAY` (20k) Samples, sonst vergiftet
eine Recorder-Lücke Median und Wochenend-Ratio; bei nur einem Wochenendtag wird
das Wochenendprofil aus Wochentag × Ratio skaliert statt aus einem Samstag.
- **Sauna-Overlay nutzt `max(profil, 8600 W)` statt `+8600 W`**: das rollierende Profil
enthält historische Sauna-Sitzungen, mit `+=` wäre der Saunatag doppelt gezählt.
## ⚠️ Known Pitfall: set-config Full Overwrite
`POST /set-config` ersetzt die **gesamte** Konfiguration, nicht nur gesendete Felder.
Nicht angegebene Parameter fallen auf Defaults zurück (capacity→5000, power→1000, etc.).
**Regel:** Immer ALLE Parameter zusammen senden. Nach jedem Write mit `GET /get-config` verifizieren.
Siehe Solution Doc: `docs/solutions/integrations/2026-10-02-emhass-set-config-overwrite-pitfall.md`
## Kaskaden-Automation
**Automation ID:** `1774430238377` (ON)
**Schedule:** Alle 2 Minuten
**File:** `/mnt/data/supervisor/homeassistant/automations.yaml`
### BYD/SMA Steuerung
| EMHASS target | PV | BYD Modus | Bedeutung |
|--------------|-----|-----------|-----------|
| `> 0` (Entladung) | egal | **803 Auto** | BYD self-managed, Marstek kriegt Rest |
| `≤ 0` (Hold/Ladung) | `< 100W` | **802 Manual** | BYD hält/zwingt Ladung, EVCC hold |
| `< 0` (Ladung) | `≥ 100W` | **803 Auto** | PV reicht, BYD lädt selbst |
- BYD läuft permanent in Auto/Normal — nur bei EMHASS-Hold/Zwangsladung auf 802
- Modbus Register: 44425 (Mode), 44427 (Power)
- BYD IP: `10.0.50.202:502`
### Marstek Steuerung
- `sensor.marstek_target_power` = `smart_battery_target − actual_BYD_discharge + actual_BYD_charge`
- Cap: ±2500W
- Force modes: `charge`, `discharge`, `standby`
- Writable entities: `select.marstek_venus_modbus_force_mode`,
`number.marstek_venus_modbus_ladeleistung_einstellen`,
`number.marstek_venus_modbus_entladeleistung_einstellen`
- Marstek IP: `10.0.50.113`
### Gelöste Bugs
1. **Double-Counting (behoben 2026-10-01):** `sensor.sma_target_power` nahm volle EMHASS-Target,
ließ Marstek 0W. Fix: `sma_target_power` gelöscht, `marstek_target_power` nutzt jetzt
echte BYD-Werte (discharge - charge) statt Forecast-Split.
2. **Overnight Hold Too High (behoben 2026-10-02):** EMHASS hielt bei 65% weil
`target_state_of_charge=0.30`. Geändert auf 0.15.
3. **BYD ignoriert Hold (behoben 2026-10-02):** 802-Bedingung war `target < 0`,
jetzt `target <= 0` (Hold bei target=0 eingeschlossen).
## Template Sensoren (configuration.yaml)
- `sensor.smart_battery_target` — EMHASS p_batt_forecast, gerundet
- `sensor.marstek_target_power` — Plan A: smart_target − actual_BYD_net_discharge
- Guards: SoC-Checks, ±2500W cap
- `sensor.sma_target_power` — **ENTFERNT** (war Double-Counting Source)
## Cron Jobs
| Job ID | Schedule | Typ | Funktion |
|--------|----------|-----|----------|
| `a32005d62226` | every 15m | no_agent script | Ruft EMHASS Optimization auf, published Plan zu HA |
| `d046e808f543` | */15m | LLM-Agent (silent-on-healthy) | Shadow-Dual-Solve A/B + Ledger |
| `19aef2351273` | hourly :35 | no_agent script | Shadow-Staleness-Watchdog (>45 min -> Alert) |
Runner: `/home/debian/.hermes/scripts/emhass-optimizer-runner.sh`
Optimizer: `/home/debian/scripts/emhass_optimizer.py`
Shadow: `/home/debian/scripts/emhass_optimizer_v2.py --shadow` - Ledger `~/shadow_phase2/ledger.jsonl` - Report `~/scripts/report_phase2.py`
## Shadow Phase-2 (live seit 2026-10-08)
Dual-Solve-Validierung (A=Standard, B=grid-charge erlaubt) auf IDENTISCHEN
Inputs; Incumbent unangetastet. Bewiesene CSV-Gesetze: `+P`=Entladung,
`P_grid` signed net import (**Export NEGATIV**), Deferrable-Spalten =
Phantom-Last (+12 kWh Summeninvarianz, KEINE Consumer) ->
**produktiv entfernt 2026-10-08** (`number_of_deferrable_loads: 2->0`,
Direct-File-Edit + Addon-Restart im :50-Fenster, Backup
`config.json.hermesbak-20261008`; Beweis: Incumbent-CSV faellt auf 17
Spalten). Auswertung: `python3 ~/scripts/report_phase2.py`.
## Deaktivierte Komponenten
| Component | Status | Grund |
|-----------|--------|-------|
| Tibber Smart Charging Bridge | OFF | EMHASS ist sole optimizer |
| Marstek Kaskaden-Steuerung (Modbus) | OFF | Alte PV-only Kaskade, ersetzt durch EMHASS-Kaskade |
## Hardware Referenz
| Device | IP | Capacity | Max Power | Interface |
|--------|----|----------|-----------|-----------|
| BYD/SMA SBS | 10.0.50.202:502 | 11 kWh | 4.2 kW | Modbus 44425/44427 |
| Marstek Venus E | 10.0.50.113 | 5 kWh | 2.5 kW | HA Entities (Modbus) |
| SMA SB #1 | 10.0.50.201:502 | — | — | PV Wechselrichter |
| SMA SB #2 | 10.0.50.203:502 | — | — | PV Wechselrichter |
| Hoymiles | 10.0.40.55 | — | — | OpenDTU |
## Known Issues (2026-10-11)
1. **TZ-Bug in v2 build_pv_series — GEFIXT 11.10. 18:29**: `norm_key()` erzeugt Berlin-Wallclock-Keys,
Zurückparsen war als `tzinfo=timezone.utc` → +2h-Versatz im gesamten PV-Plan. Fix deployed:
`stamps = [datetime.strptime(k, "%Y%m%d%H%M").replace(tzinfo=BERLIN) for k in keys]`.
Backup: `emhass_optimizer_v2.py.bak-20261011-tzfix`. Live-Tick 18:28: korrekte Sunset-Kurve.
2. **Solcast-Kontamination (GEFIXT 11.10.)**: Demo-Site "Ogdak Netherlands" trug ~9,6 kWh/Tag
Phantom-PV bei; via Options-Flow `exclude_sites=["59c8-caae-52f5-1686"]` entfernt.
Optimizer-Tick danach: PV-Summe 59,0→36,3 kWh/24h, Peak 10,0→5,7 kW.
3. **Reload-Race-Crash (GEHÄRTET 11.10. 18:47)**: Solcast-Options-Reload → Sensoren ~16 s
`unavailable` → 18:43-Tick crashte. Fix: `collect_solcast_pools()` 3×10s-Retry, loud.
4. Solcast läuft mit EINER gemittelten Site ("Schön Rohr", 16 kW, -132,6°/19°); seit 11.10.
kalibriert via `auto_dampen=True` + `get_actuals=True` + `sensor.pv_production` als
Generationsquelle (Validator-Kopplung: auto_dampen erfordert get_actuals).
## Zugriff
- EMHASS API: `http://10.0.30.10:5000`
- HA intern: `http://10.0.30.10:8123`
- HA extern: `https://homeassistant.familie-schoen.com`
- SSH: `ssh -i ~/.ssh/id_ed25519_proxmox -p 22222 root@10.0.30.10`
- HA Token: `/tmp/ha_token.txt`
- HA Config: `/mnt/data/supervisor/homeassistant/`
- Backups: `.bak.20261001_175804` (configuration.yaml + automations.yaml)
## Related
- [[systems/homeassistant]] — HA System Seite
- Solution Doc: `docs/solutions/integrations/2026-10-02-emhass-set-config-overwrite-pitfall.md`