Files
Enelix-EMS/docs/module/Manager/README.md
T
dh 0f9860356d
Tests / test (push) Canceled after 0s
Entwurf: docs/module/Manager/README.md
2026-09-10 08:00:35 +00:00

4.2 KiB

Manager

Status: Diskussionsentwurf. Führt Hauptmanager und Peakshaving zusammen.

Der Manager liest die Netzleistung, verwaltet ausschliesslich die ausgewählten Verbraucher und verteilt Leistung im PV- oder Peak-Betrieb. Die Prioritäten kommen aus den Verbrauchermeldungen.

Variablen

Ohne Logging sind nur Aktiv, Betriebsart und Netzleistung sichtbar.

Ident Typ / Zugriff Beschreibung
Aktiv Boolean / bedienbar Regelung ein/aus; Start false.
Betriebsart String / Anzeige Inaktiv, PV oder Peak.
Netzleistung Float / Anzeige Aktuelle Netzleistung in W; positiv Bezug, negativ Einspeisung.
NetzleistungGueltig Boolean / Logging Messquelle vorhanden und aktuell.
WirksameLastspitzengrenze Float / Logging Aktuelle feste oder monatliche Grenze in W.
Verteilbudget Float / Logging Aktuell verfügbares Budget in W.
VerbraucherAnzahl Integer / Logging Anzahl zugeordneter Verbraucher.
VerbraucherVerfuegbar Integer / Logging Anzahl aktuell verfügbarer Verbraucher.
Verbraucherstatus String/JSON / Logging Letzte vollständige Meldungen.
Prognosestatus String / Logging NichtVerwendet, Verbunden oder Fehler.
SDLStatus String / Logging Status des SDL/VGT-Anschlusses.
Lizenzstatus String / Logging Status der Lizenzprüfung.
Stoerueberwachungsstatus String / Logging Status der externen Störüberwachung.
Sammelstoerung Boolean / Logging Eigene und weitergeleitete Störungen.
Stoertext String / Logging Lesbare Sammelmeldung.

Properties

Ident Typ Standard / Beschreibung
Rolle Auswahl Alleine; alternativ Hauptmanager oder Untermanager.
NetzleistungVariableID Integer 0*; gültige Messquelle vor Regelstart.
Netzleistungsfaktor Float 1; auf W und die vereinbarte Vorzeichenrichtung normieren.
MesswertMaxAlter Integer 30 s; auf echte Messaktualisierung bezogen.
VerbraucherZuordnung String/JSON []; Instanz-ID und Aktiv je Verbraucher. Einzige gespeicherte Zuordnung.
AutomatischeSuche Boolean true; findet Kandidaten, aktiviert sie aber nicht automatisch.
SuchbereichID Integer 0; optionaler Suchbereich.
Regelintervall Integer 2 s; zusätzlich auf relevante Änderungen reagieren.
Vorgabeintervall Integer 10 s; laufende Vorgaben erneuern.
VerbraucherTimeout Integer 30 s; ausgebliebene Meldung erkennen.
Lastspitzenmodus Auswahl Aus; alternativ Konstant oder Monatlich.
Lastspitzengrenze Float Feste Grenze in W für Modus Konstant.
Monatsgrenzen String/JSON Zwölf Monatswerte in W.
MonatsgrenzenVisuBedienbar Boolean false; Monatstabelle in der Visualisierung bedienen.
SollwertSolarladen Float 0 W; gewünschte Netzleistung im Solarladebetrieb.
UmschaltschwelleUeberschuss Float Feste W-Schwelle für PV-Betrieb.
UmschaltschwelleLastspitze Float Feste W-Schwelle für Peak-Betrieb.
Umschaltdifferenz Float 0 %; Mindestdifferenz der berechneten Sollleistungen vor Umschaltung.
PrognoseAnschluss String/JSON Optionaler Forecast-Anschluss.
SDLAnschluss String/JSON Optionaler SDL/VGT-Anschluss.
LizenzAnschluss String/JSON Optionaler Lizenzanschluss.
StoermeldeAnschluss String/JSON Optionaler Anschluss zur Störüberwachung.
LoggingEin Boolean false; Protokollierung und zusätzliche Variablen anzeigen.

Es gibt keine Sollwertquellenauswahl und keine zweite Prioritätseinstellung im Manager. Im Modus Aus bleibt Solarladen aktiv, nur die Peak-Begrenzung entfällt.

Schnittstellen

  • Empfängt genau VerbraucherdatenEmpfangen(array $daten).
  • Sendet an jeden Verbraucher nur Kopf und Sollleistung_W.
  • Obere Anschlüsse: siehe Obere Anschlüsse.

Offene Punkte

  • Monatliche Batteriereserve aus dem alten Peakshaving-Modul übernehmen?
  • Anbieterformate für Prognose, Lizenzierung und Störüberwachung festlegen.
  • Verhalten und Messabgrenzung bei Untermanagern im Anlagentest bestätigen.