--- 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 (16 kWh Virtual Battery) | Parameter | Value | Hinweis | |-----------|-------|---------| | `battery_nominal_energy_capacity` | 16000 | BYD 11k + Marstek 5k kombiniert | | `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** (numerisch bewiesen): `norm_key()` erzeugt Berlin-Wallclock-Keys, Zurückparsen als `tzinfo=timezone.utc` → +2h-Versatz im gesamten PV-Plan. Fix pending Approval: `stamps = [datetime.strptime(k, "%Y%m%d%H%M").replace(tzinfo=BERLIN) for k in keys]`. 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. Solcast läuft nur mit EINER gemittelten Site ("Schön Rohr", 16 kW, -132,6°/19°) für die gesamte physisch heterogene Anlage (SO/SW-Dach + flach SW-Schuppen + SW/NE-Zelt). ## 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`