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