Files
memory/reference/emhass-cascade-automation-architecture.md
T
2026-10-08 22:00:16 +00:00

6.8 KiB
Raw Blame History

title, category, tags, created, modified
title category tags created modified
EMHASS Kaskaden-Automations-Architektur reference
emhass
battery
cascade
homeassistant
byd
marstek
2026-10-02 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

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)
  • systems/homeassistant — HA System Seite
  • Solution Doc: docs/solutions/integrations/2026-10-02-emhass-set-config-overwrite-pitfall.md