Files
memory/reference/emhass-cascade-automation-architecture.md
T
2026-11-03 22:00:35 +00:00

176 lines
8.2 KiB
Markdown
Raw 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.5 | Strafe für Unterschreitung |
| `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 | |
## ⚠️ 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`