feat(ladestation): Phasenerkennung und Schaltsperren erweitern

docs/module/Ladestation-Stand-Alone/README.md

@@ -40,13 +40,20 @@ Die Auswertung folgt bewusst dem Verhalten der bisherigen Enelix-1-Ladestation:
    wird entsprechend `State != 1` ausgewertet.
 2. Die gemessene Leistung wird bei der alten go-e-API mit Faktor 10, bei
    Gemini direkt in Watt und bei Pico von kW in Watt umgerechnet.
-3. Bei einer Leistung ueber 7500 W wird dreiphasiges Laden erkannt. Darunter
-   wird bei verbundenem Fahrzeug einphasiges Laden angenommen.
-4. Der Ladestrom wird aus der Leistung mit `230 V` einphasig beziehungsweise
-   `1.71 * 400 V` dreiphasig berechnet.
-5. War das Fahrzeug bereits im vorherigen Zyklus verbunden und liegt der
-   ermittelte Maximalstrom aus Ladestrom plus `2.5 A` unter `6 A`, wird
-   `FahrzeugGeladen=true` gesetzt.
+3. go-e meldet die drei Phasenstroeme einzeln. Sobald mindestens zwei Phasen
+   Strom fuehren, wird dreiphasiges Laden direkt erkannt.
+4. Sind beim Anstecken noch keine belastbaren Phasenwerte vorhanden, gibt das
+   Modul zunaechst den konfigurierten Maximalstrom als Erkennungsstrom vor. Bis
+   zur abgeschlossenen Erkennung bleibt `Phasenzahl=0` und das EMS-Angebot
+   `[0]`.
+5. Nach `Phasenerkennungszeit` gilt wie in Enelix 1: ueber 7500 W werden drei
+   Phasen erkannt, andernfalls eine Phase. Die erkannte Phasenzahl bleibt bis
+   zum Ausstecken erhalten und kippt waehrend einer Ladepause nicht zurueck.
+6. Der Ladestrom wird aus der Leistung mit `230 W/A` einphasig beziehungsweise
+   `684 W/A` dreiphasig berechnet.
+7. Ein Ladeende wird nur nach zuvor tatsaechlich gemessener Ladeleistung
+   erkannt. Eine vom EMS angeordnete Solarpause gilt deshalb nicht als
+   `FahrzeugGeladen`.
 
 Der normalisierte `Fahrzeugstatus` verwendet folgende Werte:
 
@@ -72,10 +79,18 @@ stoppt die Ladestation.
 | Peak | ein | ausschliesslich `[0]`; die Ladestation wird gestoppt |
 | Peak | aus | `0 W` und alle Ladestufen von 6 A bis zum konfigurierten Maximum |
 
-Die festen ein- und dreiphasigen Leistungsstufen sowie deren Rundung wurden aus
-Enelix 1 uebernommen. Ohne gueltige Manager-Vorgabe faehrt das Modul bei
-aktivem Solarladen mit `0 A`; bei ausgeschaltetem Solarladen verwendet es die
-maximale angebotene Leistung.
+Die Leistungsstufen entsprechen Enelix 1: `230 W` pro Ampere einphasig und
+`684 W` pro Ampere dreiphasig. Ohne gueltige Manager-Vorgabe faehrt das Modul
+bei aktivem Solarladen mit `0 A`; bei ausgeschaltetem Solarladen verwendet es
+die maximale angebotene Leistung.
+
+Nach einer Leistungsaenderung wird die aktuelle Stufe fuer
+`ZeitZwischenZustandswechseln` gehalten. Waehrend der
+`Mindesteinschaltdauer` bleiben positive Leistungsstufen regelbar, `0 W`
+wird jedoch nicht angeboten. Nach dem Abschalten meldet das Modul waehrend der
+`Mindestausschaltdauer` ausschliesslich `[0]`. Sicherheitsabschaltungen
+durch Deaktivierung, fehlende Ladefreigabe, Ausstecken oder ein erkanntes
+Ladeende greifen sofort.
 
 ## Bedienung
 
@@ -114,8 +129,13 @@ gueltige Manager-Vorgabe und berechnet das Leistungsangebot sofort neu.
 | `Benutzername` | String | leer | Benutzername fuer die Pico-API. |
 | `Passwort` | String | leer | Passwort fuer die Pico-API; im Formular als Passwortfeld dargestellt. |
 | `MaximalerLadestrom` | Integer | `16 A` | Obergrenze der angebotenen Ladestufen; zulaessig sind 6 bis 32 A. |
+| `Phasenerkennungszeit` | Integer | `60 s` | Dauer der Maximalstrom-Probe vor der leistungsbasierten Phasenerkennung. |
+| `FahrzeugstromErkennungszeit` | Integer | `90 s` | Zeit, die eine stabile Stromunterschreitung anliegen muss, bevor die Fahrzeuggrenze mit 2,5 A Reserve uebernommen wird. |
+| `ZeitZwischenZustandswechseln` | Integer | `1 min` | Mindestabstand zwischen zwei Leistungsaenderungen. |
+| `Mindesteinschaltdauer` | Integer | `0 min` | Mindestdauer nach dem Einschalten, in der kein Abschalten auf 0 W angeboten wird. |
+| `Mindestausschaltdauer` | Integer | `0 min` | Mindestpause nach dem Abschalten, in der nur 0 W angeboten werden. |
 | `Abfrageintervall` | Integer | `5 s` | Intervall der Geraetestatusabfrage. |
-| `Ladefreigabe` | Boolean | `false` | Startwert der lokalen Ladefreigabe. |
+| `Ladefreigabe` | Boolean | `true` | Startwert der lokalen Ladefreigabe. |
 | `Solarladen` | Boolean | `true` | Startwert der lokalen Solarlogik. |
 | `DiagnosevariablenAnzeigen` | Boolean | `false` | Blendet gemeinsame und ladestationsspezifische Diagnosevariablen ein. |
 
@@ -232,16 +252,22 @@ niemals in Repository-Dateien, Skripte oder Screenshots.
 - Die Instanz erreicht Status `102`, und `Stoerung` bleibt `false`.
 - Ohne Fahrzeug sind `FahrzeugVerbunden=false`, `Phasenzahl=0` und das
   Leistungsangebot `[0]`.
-- Nach dem Anstecken wird das Fahrzeug erkannt und die gemessene Leistung
-  plausibel in `Istleistung` und `Ladestrom` abgebildet.
-- Bei einer Ladeleistung bis 7500 W wird eine Phase, darueber werden drei
-  Phasen angezeigt.
+- Nach dem Anstecken wird das Fahrzeug erkannt und bei unbekannten Phasen
+  zunaechst der konfigurierte Maximalstrom zur Erkennung angefordert.
+- Nach der Erkennungszeit werden bis 7500 W eine Phase, darueber drei Phasen
+  gespeichert. Bei go-e koennen die einzelnen Phasenstroeme die Erkennung
+  bereits vorher abschliessen.
+- Die erkannte Phasenzahl bleibt bei einer anschliessenden Ladepause stabil.
+- Die gemessene Leistung wird plausibel in `Istleistung` und `Ladestrom`
+  abgebildet.
 - `Aktiv=false` oder `Ladefreigabe=false` stoppt die Ladestation.
 - PV mit `Solarladen=true` bietet `0 W` und die Ladestufen an.
 - PV mit `Solarladen=false` bietet nur die maximale Leistung an.
 - Peak mit `Solarladen=true` stoppt die Ladestation und bietet nur `[0]` an.
 - Peak mit `Solarladen=false` bietet `0 W` und die Ladestufen an.
 - Eine Manager-Vorgabe ausserhalb des gemeldeten Angebots wird abgewiesen.
+- Leistungswechsel-, Mindest-Ein- und Mindest-Aus-Zeiten werden im gemeldeten
+  Angebot sichtbar und vom Manager eingehalten.
 - Nach Ablauf des Vorgabe-Timeouts gilt wieder das lokale Ersatzverhalten.
 - Im Debug-Protokoll und in `LetzterGeraetebefehl` erscheinen keine
   Zugangsdaten.
@@ -256,9 +282,11 @@ niemals in Repository-Dateien, Skripte oder Screenshots.
 - Fahrzeug wird nicht erkannt: Rohstatus der Geraete-API kontrollieren. Der
   Adapter erwartet bei go-e `car` und `nrg[11]`, bei Pico `State` und
   `ActiveChargingPower`.
-- Falsche Phasenzahl bei sehr kleiner oder stehender Ladung: Die kompatible
-  Enelix-1-Erkennung basiert auf der momentanen Leistung. Fuer eine sichere
-  Dreiphasenerkennung muss waehrend der Erkennung mehr als 7500 W anliegen.
+- Phasenzahl bleibt laenger auf `0`: Waehrend der Erkennungsphase muessen
+  Ladestation und Fahrzeug den angeforderten Maximalstrom tatsaechlich
+  freigeben. Bei Pico muss fuer eine sichere Dreiphasenerkennung waehrend der
+  Erkennung mehr als 7500 W anliegen; go-e kann zusaetzlich anhand der
+  einzelnen Phasenstroeme erkennen.
 - Manager-Vorgabe wird abgewiesen: aktive Zuordnung im Manager sowie
   `LeistungsangebotDiagnose` und die Betriebsart kontrollieren.
 
@@ -270,9 +298,10 @@ URL, HTTP-Methode, Authentisierung und Steueraufrufe ohne reale Hardware
 geprueft.
 
 Der Symcon-Funktionstest verwendet den internen `Testmodus` mit simulierten
-API-Antworten. Er prueft alle drei Geraetevarianten, Fahrzeug- und
-Phasenerkennung, die Leistungsangebote in PV und Peak sowie die Umschaltung
-ueber den `Solarladen`-Button.
+API-Antworten. Er prueft alle drei Geraetevarianten, die Maximalstrom-Probe
+beim Anstecken, stabile Phasen waehrend einer Ladepause, die Schaltsperren,
+Fahrzeugstrom-Erkennung, die Leistungsangebote in PV und Peak sowie die
+Umschaltung ueber den `Solarladen`-Button.
 
 PHP-Syntax, Struktur- und Unit-Tests des gesamten Repositorys: