Verbrauchermodule und betriebsartabhängige Angebote ergänzen

docs/module/Verbraucher-1-Stufig/README.md

@@ -1,12 +1,15 @@
 # Verbraucher 1-Stufig
 
-> Status: implementiert fuer IP-Symcon 8 und den Enelix-2-Vertrag `3.0`.
+> Status: implementiert fuer IP-Symcon 8 und den Enelix-2-Vertrag `4.0`.
 
-Das Modul schaltet einen elektrischen Ein-/Aus-Verbraucher. Im freien Zustand
-meldet es dem Manager das Leistungsangebot `[0, Nennleistung]`. Waerend einer
-Mindest-Ein- oder Mindest-Aus-Zeit, waehrend einer ausstehenden Rueckmeldung
-und bei lokal erzwungener Tagesmindestlaufzeit wird nur der aktuelle
-bestaetigte Leistungswert angeboten.
+Das Modul schaltet einen elektrischen Ein-/Aus-Verbraucher. Im frei
+schaltbaren Zustand meldet es bei PV `[0, Nennleistung]` und bei Peak `[0]`.
+Ist die Tagesmindestlaufzeit faellig, wird bei PV die Nennleistung erzwungen.
+Bei Peak ist konfigurierbar, ob `[0, Nennleistung]` angeboten oder die
+Nennleistung ohne Sperrmoeglichkeit erzwungen wird. Waerend einer
+Mindest-Ein- oder Mindest-Aus-Zeit sowie bei einer ausstehenden Rueckmeldung
+wird unabhaengig von der Betriebsart nur der aktuelle bestaetigte
+Leistungswert angeboten.
 
 ## Architekturentscheidung
 
@@ -27,7 +30,7 @@ Regelberechnung.
 ## Properties
 
 Zu den sechs gemeinsamen Verbraucher-Properties aus
-[`Schnittstelle.md`](../../Schnittstelle.md) kommen acht
+[`Schnittstelle.md`](../../Schnittstelle.md) kommen neun
 Modul-Properties hinzu.
 
 | Ident | Typ | Standard | Beschreibung |
@@ -37,6 +40,7 @@ Modul-Properties hinzu.
 | `SchaltkontaktInvertiert` | Boolean | `false` | Kehrt die Ein-/Aus-Semantik des Aktors um. |
 | `RueckmeldungVariableID` | Integer | `0` | Optionale Boolean-Rueckmeldung; `true` bedeutet physisch eingeschaltet. |
 | `Mindestlaufzeit` | Integer | `0` | Geforderte Laufzeit pro lokalem Kalendertag in Sekunden, maximal 86400. |
+| `PeakSperreBeiMindestlaufzeitAnbieten` | Boolean | `true` | Bietet bei faelliger Tagesmindestlaufzeit im Peakbetrieb zusaetzlich `0` als Sperre an. Bei `false` wird die Nennleistung lokal erzwungen. |
 | `Mindesteinschaltdauer` | Integer | `5` | Mindestzeit in Sekunden, die ein bestaetigter Ein-Zustand gehalten wird. |
 | `Mindestausschaltdauer` | Integer | `5` | Mindestzeit in Sekunden, die ein bestaetigter Aus-Zustand gehalten wird. |
 | `DiagnosevariablenAnzeigen` | Boolean | `false` | Legt gemeinsame und modulspezifische Diagnosevariablen an. |
@@ -126,15 +130,20 @@ beruecksichtigt. Nur der bestaetigte Ein-Zustand zaehlt.
 
 Ist die konfigurierte Tagesmindestlaufzeit noch nicht erreicht, wird der
 Verbraucher zum spaetestmoeglichen Zeitpunkt angefordert, an dem die
-Restlaufzeit bis Mitternacht noch erfuellt werden kann. Eine noch aktive
-Mindestausschaltdauer hat dabei Vorrang; eine unmoegliche Restlaufzeit kann
-nicht rueckwirkend nachgeholt werden.
+Restlaufzeit bis Mitternacht noch erfuellt werden kann. Im PV-Betrieb wird die
+Nennleistung dann lokal erzwungen. Im Peakbetrieb meldet das Modul bei
+aktivierter Property `PeakSperreBeiMindestlaufzeitAnbieten` wie Enelix 1
+`[0, Nennleistung]`, sodass der Manager zwischen Sperren und Nachholen der
+Laufzeit waehlen kann. Ist die Property deaktiviert, wird auch im Peakbetrieb
+nur die Nennleistung angeboten und lokal erzwungen. Eine noch aktive
+Mindestausschaltdauer hat Vorrang; eine unmoegliche Restlaufzeit kann nicht
+rueckwirkend nachgeholt werden.
 
 ## Managerkommunikation
 
 Das Modul implementiert
 `VerbraucherSchnittstelle::ManagerdatenEmpfangen()` und verwendet
-ausschliesslich Vertrag `3.0`. Der Verbraucher besitzt keine
+ausschliesslich Vertrag `4.0`. Der Verbraucher besitzt keine
 Manager-ID-Property. Er akzeptiert nur Manager, in deren manueller oder
 automatischer Verbraucherzuordnung seine Instanz aktiv eingetragen ist.