Verbrauchermodule und betriebsartabhängige Angebote ergänzen

docs/module/Wassererwaermer/README.md

@@ -1,12 +1,12 @@
 # Verbraucher Warmwassererwaermer
 
-> Status: implementiert fuer IP-Symcon 8.0+ und den Enelix-2-Vertrag `3.0`.
+> Status: implementiert fuer IP-Symcon 8.0+ und den Enelix-2-Vertrag `4.0`.
 
 Das Modul bindet einen elektrischen Warmwasserspeicher mit einer oder mehreren
 exklusiven Leistungsstufen an den Enelix-Manager an. Der Manager kann nur eine
-der aktuell angebotenen Leistungen vorgeben. Lokale Schutz- und Komfortregeln
-fuer Mindesttemperatur, Maximaltemperatur, Zeitplan und Legionellenfunktion
-haben Vorrang vor einer Manager-Vorgabe.
+der aktuell angebotenen Leistungen vorgeben. Mindesttemperatur, Hysterese,
+Zeitplan und Legionellenfunktion bestimmen dabei zustands- und
+betriebsartabhaengig das Leistungsangebot.
 
 Das Modul ist eine gezielte Adaption des Enelix-1-Moduls
 `Boiler_x_Stufig`. Zyklische Altlogik und alte Kommunikationsvariablen wurden
@@ -20,7 +20,7 @@ ausschliesslich den Enelix-2-Nachrichtenvertrag.
 | Modul-ID | `{B7C54AF4-AD7D-4FE4-B75D-203693906251}` |
 | Modultyp | Geraeteinstanz (`3`) |
 | Funktionspraefix | `ENELIX` |
-| Enelix-Vertrag | `3.0` |
+| Enelix-Vertrag | `4.0` |
 
 ## Funktionsumfang
 
@@ -65,22 +65,22 @@ Eine Neuberechnung wird insbesondere ausgeloest durch:
 vollstaendige Rueckmeldung sicher. Die Lastwechselsperre verwendet einen
 einmaligen Timer und loest nach ihrem Ablauf genau eine Neuberechnung aus.
 
-Die Zielentscheidung folgt dieser Prioritaet:
+Die Zielentscheidung folgt der Enelix-1-Zustandsmatrix:
 
 1. Bei deaktivierter Instanz oder ungueltiger Temperatur ist der Verbraucher
    nicht verfuegbar und wird ausgeschaltet. Eine ungueltige Konfiguration wird
    bereits beim Uebernehmen mit Status `202` abgewiesen.
-2. Unterschreitet die Temperatur die wirksame Mindesttemperatur oder reicht die
-   verbleibende Zeit bis zum naechsten Zeitplanziel rechnerisch nicht aus, wird
-   die hoechste Leistungsstufe lokal erzwungen.
-3. Ab der wirksamen Maximaltemperatur wird ausgeschaltet.
-4. Im Bereich unmittelbar unter der Maximaltemperatur wird eine bereits aktive
-   Stufe bis zum Erreichen der Abschaltgrenze gehalten.
-5. In allen anderen Zustaenden darf der Manager zwischen `0 W` und allen
-   konfigurierten Leistungsstufen waehlen.
+2. Unter der wirksamen Mindesttemperatur sowie in der unteren Hysterese bei
+   aktiver Stufe gilt: PV erzwingt die Maximalleistung, Peak bietet
+   `[0, ...Leistungsstufen]` an.
+3. Ausserhalb dieses Mindesttemperaturbereichs bietet Peak nur `[0]` an.
+4. Im PV-Betrieb werden unterhalb von `Maximaltemperatur - Hysterese` alle
+   Stufen angeboten. In der oberen Hysterese gilt dies nur, solange bereits
+   eine Stufe aktiv ist.
+5. An oder oberhalb der wirksamen Maximaltemperatur wird ausgeschaltet.
 
-Lokale Zwangsvorgaben werden mit `AenderungMoeglich=false` und einem
-entsprechend eingeschraenkten `Leistungswerte_W` gemeldet.
+Eine erzwungene PV-Maximalleistung wird mit `AenderungMoeglich=false`
+gemeldet. Das Peak-Array bleibt dagegen durch den Manager waehlbar.
 
 ## Konfiguration
 
@@ -129,10 +129,11 @@ Stufe konfiguriert werden.
 
 Der jeweils naechste Zeitplaneintrag wird fuer heute oder den folgenden Tag
 ermittelt. Reicht die verbleibende Zeit bei maximaler elektrischer Leistung
-rechnerisch nicht mehr aus, wird sofort die hoechste Stufe angefordert. Die
-Berechnung verwendet Wasser mit `4186 J/(kg K)` und beruecksichtigt keine
-Speicher- oder Leitungsverluste. Fuer Datum und Uhrzeit gilt die in IP-Symcon
-eingestellte lokale Zeitzone.
+rechnerisch nicht mehr aus, wird das Zeitplanziel zur wirksamen
+Mindesttemperatur. Im PV-Betrieb wird dann die hoechste Stufe erzwungen, im
+Peakbetrieb werden alle Stufen angeboten. Die Berechnung verwendet Wasser mit
+`4186 J/(kg K)` und beruecksichtigt keine Speicher- oder Leitungsverluste. Fuer
+Datum und Uhrzeit gilt die in IP-Symcon eingestellte lokale Zeitzone.
 
 ### Erweiterte sonstige Einstellungen
 
@@ -179,14 +180,14 @@ nur erlaubt, wenn `EinstellungenInVisu=true` gesetzt ist.
 
 ## Hysterese und lokales Nachladen
 
-Sinkt die Temperatur unter die wirksame Mindesttemperatur, beginnt das lokale
-Nachladen mit der hoechsten Leistungsstufe. Es endet, sobald mindestens
-`Mindesttemperatur + Hysterese` erreicht ist. Oberhalb der wirksamen
-Maximaltemperatur wird ausgeschaltet.
+Sinkt die Temperatur unter die wirksame Mindesttemperatur, erzwingt PV die
+hoechste Leistungsstufe; Peak bietet dagegen Aus und alle Stufen an. In der
+unteren Hysterese bis `Mindesttemperatur + Hysterese` bleibt dieses Verhalten
+nur erhalten, solange bereits eine Stufe aktiv ist.
 
-Ist bereits eine Stufe aktiv und liegt die Temperatur bei mindestens
-`Maximaltemperatur - Hysterese`, wird diese Stufe bis zur Abschaltgrenze
-gehalten. Dadurch werden unnoetige Stufenwechsel kurz vor dem Ziel vermieden.
+Im PV-Betrieb werden unter `Maximaltemperatur - Hysterese` alle Stufen
+angeboten. Innerhalb der oberen Hysterese bleibt das Angebot nur bei einer
+bereits aktiven Stufe erhalten. An der Maximaltemperatur wird ausgeschaltet.
 
 ## Legionellenfunktion
 
@@ -196,8 +197,8 @@ Die Legionellenfunktion arbeitet zweistufig:
    wirksamen Maximaltemperatur. Der Manager kann die Aufheizung innerhalb des
    verbleibenden Zeitfensters ermoeglichen.
 2. Ab `LegionellenMaximalintervallTage` wird die Legionellentemperatur auch zur
-   wirksamen Mindesttemperatur. Die hoechste Stufe wird dadurch lokal
-   erzwungen, bis das Ziel erreicht ist.
+   wirksamen Mindesttemperatur. PV erzwingt dadurch die Maximalleistung; Peak
+   bietet das vollstaendige Stufenarray bis zum Ziel an.
 
 Erreicht die gueltige Speichertemperatur die Legionellentemperatur, wird der
 Zeitpunkt als erfolgreicher Abschluss gespeichert und das Intervall beginnt
@@ -268,7 +269,7 @@ Anzeigevariablen.
 
 Das Modul implementiert
 `VerbraucherSchnittstelle::ManagerdatenEmpfangen()` und verwendet den
-Enelix-2-Vertrag `3.0`. Es besitzt keine Manager-ID-Property. Zugelassen sind
+Enelix-2-Vertrag `4.0`. Es besitzt keine Manager-ID-Property. Zugelassen sind
 nur Manager, in deren manueller oder automatischer Verbraucherzuordnung die
 Instanz aktiv eingetragen ist.
 
@@ -382,7 +383,7 @@ PT1, Lastwechselsperre, Energieberechnung, thermische Prognose, Zeitplan und
 Legionellengrenzen.
 
 `WarmwassererwaermerModulstrukturTest.php` prueft Metadaten, Formular, alle 19
-Properties, ereignisbasierte Lastwechselsperre, Vertrag `3.0`, bedarfsgesteuerte
+Properties, ereignisbasierte Lastwechselsperre, Vertrag `4.0`, bedarfsgesteuerte
 Diagnosevariablen, Legionellentemperatur, Temperatursollwerte und
 Break-before-make-Schaltung.