Enelix-EMS/examples/Demoanlage/README.md

Enelix-2-Demoanlage

Die Demo erzeugt idempotent eine vollständige, spielbare EMS-Anlage in IP-Symcon 8.x:

• Enelix Manager mit manueller Zuordnung von fünf steuerbaren Teilnehmern,
• zwei mehrstufige Boiler (1,2/2,4 kW und 1,5/3,0 kW),
• einen einstufigen Entfeuchter (0,9 kW),
• einen zweistufigen Pufferspeicher (1,8/3,6 kW) mit Heizkurve,
• einen bidirektionalen Batteriespeicher (10 kWh, +/-3,5 kW),
• eine technische Anlagentopologie mit Hybridwechselrichter, PV-Fläche und Batteriespeicher für die Prognoseanbindung,
• simulierte Istleistungs- und Leistungsbegrenzungsregister des Wechselrichters,
• eine aktive anlagenweite Einspeisebegrenzung auf 3.000 W mit 100 W Toleranz,
• Prognosetelemetrie aus PV, Hausverbrauch, Netzleistung und Batterie-SOC im 60-Sekunden-Intervall,
• simulierte PV-Erzeugung, variable Bewölkung, Tageslastgang, Zusatzlast, Außentemperatur, Wärmeverluste, Netzleistung und Speicherzustände,
• native Symcon-Instanz Energy Distribution für acht Energieflussknoten,
• eigene Kachelansichten mit Laufzeitparametern für Boiler, Puffer und Batterie,
• kombinierten Verlauf für PV-Leistung, Hausverbrauch, EMS-Leistung und Netzleistung,
• kombinierten Verlauf der kumulierten PV-, Haus-, Bezugs- und Einspeiseenergie,
• Archivierung der Leistungs-, Energie- und Temperaturwerte.

Installation

Das Repository muss in der IP-Symcon-Modulverwaltung auf dem gewünschten Stand installiert sein. Danach in der Schnellausführung starten:

require_once IPS_GetKernelDir() . 'modules/Enelix-EMS/examples/Demoanlage/bootstrap.php';

$result = enelixDemoInstall();
print_r($result);

Ein weiterer Lauf aktualisiert dieselbe Anlage anhand stabiler Idents und erzeugt keine Duplikate. Bestehende, nicht zur Demo gehörende Objekte werden nicht verändert oder gelöscht.

Der Bootstrap hinterlegt absichtlich keinen Lizenzcode und überschreibt eine bereits konfigurierte Manager-Lizenz nicht. Bei einer neuen Anlage wird die Struktur vollständig erstellt; der Manager bleibt bis zur regulären Lizenzaktivierung im Konfigurationsformular auf Status 203. Solange der Manager nicht freigegeben ist, bleiben seine Zuordnung und die Verbraucher deaktiviert, damit keine Lizenzfehler protokolliert werden. Nach der Aktivierung den Bootstrap erneut ausführen; er ordnet dann alle fünf Teilnehmer zu und startet die Regelung.

Die Demo übernimmt die einstellbare PV-Spitzenleistung als AC- und DC-Anlagenleistung. Für die feste Beispieltopologie gelten 30 Grad Neigung und Südausrichtung. Der 10-kWh-Speicher nutzt den gemeinsamen Hybridwechselrichter; seine dynamischen Lade- und Entladegrenzen werden beim Bootstrap in die technischen Stammdaten übernommen. Bei aktiver Manager-Lizenz uebertraegt der Manager zusaetzlich PV-Leistung, Hausverbrauch, Netzleistung und Batterie-SOC alle 60 Sekunden an den Enelix-Prognosedienst. Die Demo verwendet ein absolutes Wechselrichter-Leistungsregister in Watt. Der Manager begrenzt die tatsächliche PV-Produktion so, dass die Gesamtanlage höchstens 3.000 W einspeist; innerhalb einer Toleranz von 100 W bleibt der zuletzt gesetzte Stellwert bestehen. Der intelligente Netzfahrplan bleibt deaktiviert, solange dessen Backendfassung nur als ausstehende Version bereitliegt.

Bedienung

In der Kachelvisualisierung öffnet die Startkategorie Enelix 2 Demoanlage. Unter Simulation lassen sich Tageslauf, Tageszeit, Geschwindigkeit, dynamische Profile, PV-Spitzenleistung, mittlere Bewölkung, Haus-Grundlast und eine ungeregelte Zusatzlast verändern. Bei aktivierten dynamischen Profilen entstehen reproduzierbare Morgen- und Abendspitzen, ziehende Bewölkung und ein Tagesgang der Außentemperatur. Der Manager verteilt den verfügbaren PV-Überschuss nach Priorität auf beide Boiler, Entfeuchter, Pufferspeicher und Batterie. Bei hoher PV-Erzeugung ist die Abregelung an den technischen Variablen PV-Wechselrichter Istleistung und PV-Wechselrichter Leistungsgrenze sowie an der auf etwa 3.000 W begrenzten Netzeinspeisung sichtbar.

Übersicht zeigt die native Symcon-Energieverteilung. Die Kacheln Boiler 1, Boiler 2, Pufferspeicher und Batteriespeicher öffnen direkt die jeweiligen Bedien-, Status- und Diagnosevariablen, ohne zuerst das Instanz-Konfigurationsformular zu zeigen. Positive Batterieleistung bedeutet Laden, negative Leistung Entladen. Unter Leistung und Energie liegen die beiden kombinierten Zeitdiagramme und die Energiezähler. Die Energiesummen, Temperaturmodelle und der Ladezustand verwenden die beschleunigte Simulationszeit.

Validierung

• Die fünf Verbraucher müssen Status 102 besitzen; der Manager nach Lizenzaktivierung ebenfalls (vorher erwarteter Status 203).
• Der Manager muss fünf Teilnehmer aus vier unterschiedlichen Modultypen melden.
• Bei ausreichendem PV-Überschuss müssen thermische Verbraucher schalten und die Batterie laden.
• Bei höherem verbleibendem PV-Überschuss muss das Wechselrichterregister die PV-Leistung so begrenzen, dass ungefähr 3.000 W ins Netz eingespeist werden.
• Wechselrichter-Istleistung und Leistungsgrenze müssen in der technischen Kategorie vorhanden und im Manager zugeordnet sein.
• Puffertemperatur, Außentemperatur und Batterie-Ladezustand müssen sich über den Tageslauf verändern.
• Netzleistung, PV-Leistung, Hausverbrauch, EMS-Leistung, Einzelverbräuche, Speicherleistung, Energiesummen und Temperaturen werden archiviert.
• Die native Energieverteilung muss acht Knoten enthalten.
• Beide Diagrammkacheln müssen mindestens drei beschriftete Zeitreihen anzeigen.
• Ein erneuter Installationslauf muss dieselbe Root-ID zurückgeben.

Rollback

Nur die eindeutig gekennzeichnete Demo wird entfernt:

require_once IPS_GetKernelDir() . 'modules/Enelix-EMS/examples/Demoanlage/bootstrap.php';

enelixDemoRemove(true);

Der boolesche Parameter ist eine bewusste Löschbestätigung. Fremde Objektbäume und Systeminstanzen bleiben unberührt.