Enelix-EMS/docs/module/Waermepumpe/README.md

Wärmepumpe

Status: Implementiert.

Das Modul bindet eine Wärmepumpe über zwei schaltbare Boolean-Ausgänge in den Enelix-Manager ein. Die Ausgänge können als getrennte Kontakte für Sperre und Erhöhung oder als SG-Ready-Eingänge verwendet werden. Die Regelung arbeitet mit dem Nachrichtenvertrag 4.0 und meldet für PV und Peak ein zustandsabhängiges Leistungsangebot.

Verhalten

• Im PV-Betrieb kann eine freigegebene Wärmepumpe aus dem Normalzustand in die Erhöhung geschaltet werden.
• Im Peak-Betrieb kann eine laufende Wärmepumpe gesperrt werden, sofern Mindestlaufzeit und Sperrgrenzen dies erlauben.
• Schaltvorgänge erfolgen als Break-before-Make: beide Kontakte werden zuerst deaktiviert, danach wird höchstens ein Kontakt aktiviert.
• Nach einem erfolglosen PV-Anlauf wird die Erhöhung aufgehoben und bis zum Ablauf der Wiederholsperre nicht erneut angeboten.
• Die maximale Sperrzeit am Stück und innerhalb von 24 Stunden erzwingt eine Erholungsphase im Normalbetrieb.
• Ohne gültige Manager-Vorgabe fällt die Steuerung in den sicheren Normalzustand zurück.

Konfiguration

Property	Standard	Beschreibung
Kontaktart	0	0: Sperre/Erhöhung, 1: SG Ready
Kontakt1VariableID	0	Schaltbarer Ausgang für Sperre beziehungsweise SG Ready 1
Kontakt2VariableID	0	Schaltbarer Ausgang für Erhöhung beziehungsweise SG Ready 2
Kontakt1Invertiert	false	Logik des ersten Ausgangs invertieren
Kontakt2Invertiert	false	Logik des zweiten Ausgangs invertieren
Nennleistung	0 W	Elektrische Nennleistung der Wärmepumpe
Rueckmeldungsart	0	0: gemessene Leistung, 1: Boolean-Betriebsstatus
IstleistungVariableID	0	Leistungsmessung oder Betriebsrückmeldung
Laufschwelle	100 W	Ab dieser Leistung gilt die Wärmepumpe als laufend
Anlaufwartezeit	30 s	Wartezeit auf bestätigten Anlauf
Wiederholsperre	300 s	Pause nach einem erfolglosen Anlauf
Mindestlaufzeit	1200 s	Mindestlaufzeit nach bestätigtem Start
Mindestsperrzeit	1200 s	Mindestdauer einer begonnenen Sperre
MaximaleSperrzeit	7200 s	Maximale zusammenhängende Sperre; 0 deaktiviert
MaximaleSperrzeit24h	21600 s	Maximale Sperrsumme in 24 Stunden; 0 deaktiviert

Hinzu kommen die gemeinsamen Verbraucher-Properties für Prioritäten, Meldeintervall, Vorgabe-Timeout, Visualisierung und Logging.

Variablen

Ident	Typ	Beschreibung
Waermepumpenzustand	Integer	1 normal/aus, 2 normal/laufend, 3 erhöht, 4 gesperrt
WaermepumpeLaeuft	Boolean	Bestätigter Betriebsstatus
SperreAktiv	Boolean	Sperrkontakt ist aktiv
ErhoehungAktiv	Boolean	Erhöhungskontakt ist aktiv
SGReadyZustand	Integer	Bitwert der beiden logischen Kontakte
Laufzeit	Integer	Kumulierte bestätigte Laufzeit in Sekunden

Optionale Diagnosevariablen zeigen unter anderem Ist- und Sollleistung, Verfügbarkeit, Anlaufstatus, Wiederholsperre, Sperrerholung, verbleibende Mindestzeiten und die Sperrsumme der letzten 24 Stunden.

Adaption aus Enelix 1

Bereich	Behandlung in Enelix 2
Grundzustände Normal, Sperre und Erhöhung	angepasst übernommen
Zwei physische Kontakte	angepasst und mit Invertierung sowie Rücklesekontrolle umgesetzt
Leistungsangebot an den Manager	neu nach Nachrichtenvertrag 4.0 implementiert
Mindestlauf- und Sperrzeiten	neu als ereignisbasierte Schutzlogik implementiert
Wetter-, Wolken- und Sonnenaufgangslogik	nicht uebernommen
Warmwasser-Schwellwert im Wärmepumpenmodul	nicht uebernommen
Fester zyklischer Fünf-Sekunden-Regler	nicht uebernommen; Ereignisse und Einmal-Timer

Lizenzierung und Manager

Der Manager erkennt das Modul über die Modul-ID {A31C9274-54F7-4BD2-9804-7AF23E86C4D1}. Es verwendet das bestehende Lizenzkontingent consumer_single, das im Portal als einstufiger Verbraucher mit Wärmepumpe als Beispiel angeboten wird.

Sicherheitshinweise

Die beiden Ausgänge müssen unterschiedliche, schaltbare Boolean-Variablen sein. Die Rückmeldung ist verpflichtend: entweder eine numerische Leistungsmessung oder ein Boolean-Betriebsstatus. Bei ungültiger Konfiguration, fehlgeschlagenem Schalten oder widersprüchlicher Rücklesung setzt das Modul seinen Status auf Fehler und meldet sich dem Manager als nicht verfügbar.

Vollständige Sperr- und Laufzeitdiagnose

DiagnosevariablenAnzeigen ist eine Boolean-Property mit Standard false. Sie ergänzt bei Bedarf folgende reine Anzeigevariablen:

Ident	Typ / Einheit	Bedeutung
AnlaufAusstehend	Boolean	Ein angeforderter Anlauf ist noch nicht abgeschlossen.
WiederholsperreAktiv	Boolean	Erneuter Anlauf ist wegen der Wiederholsperre gesperrt.
SperrerholungAktiv	Boolean	Sperrerholung beeinflusst den aktuellen Betriebszustand.
RestMindestlaufzeit	Integer / s	Noch verbleibende Mindestlaufzeit.
RestMindestsperrzeit	Integer / s	Noch verbleibende Mindestsperrzeit.

Beispiel: Eine ausstehende Schaltung bei RestMindestsperrzeit=120 ist zunächst eine einzuhaltende Schutzzeit, kein Anlass zum Umgehen des Sperrkontakts. Die Wärmepumpe besitzt mit heat_pump ein eigenes Lizenzkontingent; eine Boilerlizenz ersetzt es nicht. Eine Portal-Bestelloberfläche ist erst nach passendem Backend-Rollout nutzbar, nicht allein durch Veröffentlichung im Git.