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

142 lines
5.9 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-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
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 |
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`