2026-09-22 15:13:04 +00:00
2026-09-17 12:36:37 +00:00
2026-09-17 12:36:37 +00:00

Enelix EMS

Energiemanagement, Manager und steuerbare Verbraucher fuer IP-Symcon.

Status

Das Repository befindet sich im Aufbau. Der gemeinsame Nachrichtenvertrag, die Verbraucherbasis, der Manager, der mehrstufige Warmwassererwaermer, der Pufferspeicher, die Batterie, der 1-stufige Verbraucher, die Ladestation Stand-Alone sowie das Easee Gateway mit Ladestation Gateway sind implementiert. Die weiteren Module sind als Diskussionsentwuerfe dokumentiert.

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:

  1. Der Manager bestimmt die neue Betriebsart.
  2. Er sendet sie mit Sollleistung_W: null an alle aktiven Verbraucher.
  3. null ist nur eine Ankuendigung und kein Schaltbefehl.
  4. Jeder Verbraucher berechnet sein zustandsabhaengiges Leistungsangebot neu und meldet es mit derselben Betriebsart zurueck.
  5. 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

Dokumentation

S
Description
Energiemanagement, Manager und steuerbare Verbraucher für IP-Symcon
Readme
2.4 MiB
Languages
PHP 100%