5.9 KiB
5.9 KiB
title, category, tags, created, modified
| title | category | tags | created | modified | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| EMHASS Kaskaden-Automations-Architektur | reference |
|
2026-10-02 | 2026-10-02 |
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
- Double-Counting (behoben 2026-10-01):
sensor.sma_target_powernahm volle EMHASS-Target, ließ Marstek 0W. Fix:sma_target_powergelöscht,marstek_target_powernutzt jetzt echte BYD-Werte (discharge - charge) statt Forecast-Split. - Overnight Hold Too High (behoben 2026-10-02): EMHASS hielt bei 65% weil
target_state_of_charge=0.30. Geändert auf 0.15. - BYD ignoriert Hold (behoben 2026-10-02): 802-Bedingung war
target < 0, jetzttarget <= 0(Hold bei target=0 eingeschlossen).
Template Sensoren (configuration.yaml)
sensor.smart_battery_target— EMHASS p_batt_forecast, gerundetsensor.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 |
Runner: /home/debian/.hermes/scripts/emhass-optimizer-runner.sh
Optimizer: /home/debian/scripts/emhass_optimizer.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)
Related
- systems/homeassistant — HA System Seite
- Solution Doc:
docs/solutions/integrations/2026-10-02-emhass-set-config-overwrite-pitfall.md