Enelix EMS

Energiemanagement, Manager und steuerbare Verbraucher fuer IP-Symcon.

Status

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: null an alle aktiven Verbraucher.
null ist nur eine Ankuendigung und kein Schaltbefehl.
Jeder Verbraucher berechnet sein zustandsabhaengiges Leistungsangebot neu und meldet es mit derselben Betriebsart zurueck.
Erst wenn alle aktiven Verbraucher synchronisiert sind, verteilt der Manager konkrete Sollleistungen.

Der Manager verwendet damit nie ein PV-Angebot fuer Peak oder umgekehrt. Eine technische Schaltsperre, eine ausstehende Rueckmeldung 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

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

5.4 KiB Raw Permalink Blame History