dh
74a2d6c685
Approved by Daniel Haefliger for develop and beta. Author dh_Agent, authenticated account dh. Preserve published battery, charging and overall Energy Pie changes. No deployment or plant control authorization.
Enelix EMS
Energiemanagement, Manager und steuerbare Verbraucher fuer IP-Symcon.
Status
Dokumentationsabgleich: 8. Oktober 2026. Funktionsstände vor dieser reinen Dokumentationsänderung:
| Kanal | Quellbasis | Tatsächlicher Umfang |
|---|---|---|
Testing / develop |
5885681 |
Alle unten genannten Module, neue Ladestatus-/Phasenprüfung, Forecast-/SDL-Integration und begrenzter V4-Testpfad. |
Beta / beta |
5885681 |
Gleicher veröffentlichter Quellstand wie Testing; keine zusätzliche Anlagenabnahme daraus ableiten. |
Stable / main |
b6253f9 |
Nur Bibliotheksgrundlage und Nachrichtenvertrag 3.0, noch keine installierbaren EMS-Module. |
Stable enthält die nachfolgend beschriebenen Module noch nicht. Diese README beschreibt den Testing-/Beta-Stand. Ein Dokumentationscommit nach der genannten Quellbasis ändert weder Modulverhalten noch Freigabestatus. Die kanalgenaue Referenz liegt jeweils im gleichnamigen Git-Branch.
Version 0.1 Build 1 ist die erste Beta fuer kontrollierte Anlagen- und Feldtests. Der gemeinsame Nachrichtenvertrag, die Verbraucherbasis, der Manager und alle unten aufgefuehrten Module sind implementiert. Produktiver Einsatz setzt eine anlagenspezifische Pruefung, Sicherung und Rueckfallplanung voraus.
Module
- Manager (implementiert)
- Batterie (implementiert)
- Wassererwaermer (implementiert)
- Pufferspeicher (implementiert)
- Verbraucher 1-Stufig (implementiert)
- Waermepumpe (implementiert)
- Ladestation Stand-Alone (implementiert)
- Ladestation Gateway (implementiert)
- Easee Gateway (implementiert)
Die Properties, Variablen, Zustandsdaten und offenen Punkte stehen in der Modulübersicht. Gemeinsame Felder werden dort nicht abweichend neu definiert, sondern verweisen auf den zentralen Vertrag.
Die Verbraucher kommunizieren mit dem Manager ueber den gemeinsamen Vertrag
in libs/. Der Manager waehlt die Verbraucher aus; in einem Verbraucher gibt
es keine Manager-ID-Property.
Betriebsartabhaengige Leistungsangebote
Der Nachrichtenvertrag 4.0 uebermittelt in beiden Richtungen verpflichtend
die aktuelle Betriebsart. Zulaessige Werte sind PV fuer Solarbetrieb und
Peak fuer die Lastspitzenbegrenzung. Dadurch kann jeder Verbraucher fuer
beide Betriebsarten unterschiedliche PowerSteps melden.
Ein Betriebsartwechsel wird synchronisiert:
- Der Manager bestimmt die neue Betriebsart.
- Er sendet sie mit
Sollleistung_W: nullan alle aktiven Verbraucher. nullist nur eine Ankuendigung und kein Schaltbefehl.- Jeder Verbraucher berechnet sein zustandsabhaengiges Leistungsangebot neu und meldet es mit derselben Betriebsart zurueck.
- Der Manager verteilt konkrete Sollleistungen an alle bereits synchronisierten Verbraucher.
- Fehlende, veraltete oder noch nicht umgeschaltete Verbraucher bleiben von der Verteilung ausgeschlossen und werden als Stoerung ausgewiesen.
Der Manager verwendet damit nie ein PV-Angebot fuer Peak oder umgekehrt. Ein nicht antwortender Verbraucher blockiert die Regelung der uebrigen Anlage nicht; sein aktueller Einfluss ist bereits in der Netzleistungsmessung enthalten. Eine technische Schaltsperre oder eine Mindestzeit kann das Angebot weiterhin auf die aktuell gehaltene Leistung begrenzen.
| Verbraucher | PV-Angebot | Peak-Angebot |
|---|---|---|
| Verbraucher 1-Stufig | Normal [0, Nennleistung]; bei faelliger Tagesmindestlaufzeit [Nennleistung] |
Normal [0]; bei faelliger Tagesmindestlaufzeit konfigurierbar [0, Nennleistung] oder [Nennleistung] |
| Ladestation Stand-Alone | Mit Solarladen [0, ...Ladestufen], sonst maximale Ladeleistung |
Mit Solarladen [0], sonst [0, ...Ladestufen] |
| Ladestation Gateway | Mit Solarladen [0, ...Ladestufen], sonst maximale Ladeleistung |
Mit Solarladen [0], sonst [0, ...Ladestufen] |
| Warmwassererwaermer | Unter Mindesttemperatur maximale Stufe, sonst zustandsabhaengig | Unter wirksamer Mindesttemperatur [0, ...Leistungsstufen], sonst [0] |
| Pufferspeicher | Unter Einschaltschwelle [0, ...Leistungsstufen], sonst [0] |
Unabhaengig vom Zustand [0] |
| Batterie | SoC-abhaengiges Lade-/Entladeraster | SoC-, Reserve- und netzabhaengiges Angebot |
Die vollstaendigen Nachrichtenfelder und JSON-Beispiele stehen in der Manager-Verbraucher-Schnittstelle. Hintergrund, Alternativen und Folgen beschreibt ADR 0004.
Voraussetzungen
- IP-Symcon ab Version 8.0
- PHP ab Version 8.0 fuer die Entwicklungstests
Entwicklung und Tests
composer install
composer check
python3 tests/check_documentation.py
Der Gesamttest schliesst alle Modulsuiten ein. Der einstufige Verbraucher kann zusaetzlich unabhaengig ausgefuehrt werden:
composer check:verbraucher-einstufig
Neue oder geaenderte Funktionen werden zusammen mit ihren PHPUnit-Tests eingecheckt. Jedes Modul besitzt zusätzlich einen standardisierten Laufzeittest für IP-Symcon 8.x. Einzel-, Änderungs- und Gesamtläufe sowie Cleanup und Berichte sind im Testleitfaden beschrieben. Die CI-Pruefung muss vor der Uebernahme in einen Freigabebranch erfolgreich sein.
| Git-Branch | IP-Symcon-Kanal |
|---|---|
main |
Stable |
beta |
Beta |
develop |
Testing |
Dokumentation
Neuerungen und Fehlerstatus
Die aktuellen Erweiterungen umfassen schrittweise Leistungsverteilung bei gleicher Priorität, separate SDL-Bilanzierung mit SOC, erweiterte Energiefluss- und Diagrammdarstellung sowie eine zusammengeführte Prognosebedienung. Die vollständige ausgewählte Eingangsprognose wird von dem durch veröffentlichte Preise begrenzten ausführbaren Plan unterschieden. Eine Prognose ist kein Nachweis einer realen Einsparung.
Behoben wurden unter anderem veraltete Sollwertanzeigen nach dem Verwerfen einer Vorgabe, Go-e-Regelübergänge, Easee-Wiederverbindung und stehenbleibende Ladeleistung, falsch erkannte Ladeenden während Solarpausen, veraltete Pico-Statusdaten, unbudgetierte Phasenproben, Festlastbilanzierung und mehrere V4-Empfangs-/Messdatenprobleme. Die belegten Korrekturen und ihre Git-Nachweise stehen im Changelog.
Weiter offen: V4-Dauerbetriebsfreigabe und physische Abnahme, Ursache der wiederholt beobachteten Batterietimerblockade nach Modul-Reload sowie der separat zu bestätigende Forecast-Backend-Rollout. Am 7. Oktober wurden laufende periodische Timer dokumentiert; der historische Stillstand ist damit kein behaupteter aktueller Zustand. Diese Dokumentationsarbeit ist keine Live-Prüfung. Die frühere V4-Testfreigabe ist seit 7. Oktober abgelaufen und wird nicht erneuert. Bei alten Plänen können vollständige Forecast- Kurven fehlen; fehlende Werte bleiben Lücken. Signierte produktive Lizenz- Leases und die Prüfung der Untermanager-Messabgrenzung bleiben offene Grenzen.
Vor SDL-Visualisierungsupdates zuerst Enelix Utils aktualisieren. Bestehende
Zähler, Quellen, individuelle Diagramme und Schutzfreigaben erhalten.
EnergieanteileBerechenbar=false bedeutet nicht bestimmbare Anteile, nicht 0 %.
Git-Veröffentlichung und Portal-Dokumentation aktualisieren keine Symcon-Anlage.