fix(ladestation): Regeluebergaenge stabilisieren

LadestationStandAlone/module.php

@@ -23,17 +23,18 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
     private const STATUS_AKTIV = 102;
     private const STATUS_KONFIGURATION_UNGUELTIG = 201;
     private const STATUS_KOMMUNIKATIONSFEHLER = 202;
+    private const REGELUEBERGANG_TIMEOUT_MS = 2000;
+    private const PHASENERKENNUNGSSTROM = 6;
 
     /** @var list<string> */
     private const DIAGNOSE_VARIABLEN = [
-        'Istleistung',
         'Leistungsquelle',
-        'Sollleistung',
         'SollwertGueltig',
         'Verfuegbar',
         'AenderungMoeglich',
         'Stoerung',
         'Stoertext',
+        'Fahrzeugstatus',
         'FahrzeugMaximalstrom',
         'LetzterGeraetebefehl',
         'LeistungsangebotDiagnose',
@@ -67,7 +68,6 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
 
         $this->RegisterVariableBoolean('FahrzeugVerbunden', 'Fahrzeug verbunden', '~Switch', 100);
         $this->RegisterVariableBoolean('FahrzeugGeladen', 'Fahrzeug geladen', '~Switch', 110);
-        $this->RegisterVariableInteger('Fahrzeugstatus', 'Fahrzeugstatus', '', 120);
         $this->RegisterVariableFloat('Ladestrom', 'Ladestrom', '', 130);
         $this->RegisterVariableInteger('Phasenzahl', 'Phasenzahl', '', 140);
 
@@ -103,6 +103,7 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
         $this->RegisterAttributeInteger('ErkannterMaximalstrom', 32);
         $this->RegisterAttributeInteger('FahrzeugstromKandidat', 0);
         $this->RegisterAttributeInteger('FahrzeugstromKandidatSeit', 0);
+        $this->RegisterAttributeBoolean('RegeluebergangAktiv', false);
 
         $this->RegisterTimer(
             'Statuszyklus',
@@ -124,6 +125,11 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
             0,
             "IPS_RequestAction(\$_IPS['TARGET'], 'VorgabeTimeout', false);"
         );
+        $this->RegisterTimer(
+            'RegeluebergangTimeout',
+            0,
+            "IPS_RequestAction(\$_IPS['TARGET'], 'RegeluebergangTimeout', false);"
+        );
     }
 
     public function ApplyChanges(): void
@@ -154,6 +160,7 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
             $this->ReadPropertyInteger('MaximalerLadestrom')
         );
         $this->setzeFahrzeugstromKandidatZurueck();
+        $this->beendeRegeluebergang();
 
         try {
             $this->pruefeKonfiguration();
@@ -176,18 +183,37 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
     {
         switch ($ident) {
             case 'Aktiv':
-                $this->SetValue('Aktiv', (bool) $wert);
-                if (!(bool) $wert) {
+                $aktiv = (bool) $wert;
+                $this->SetValue('Aktiv', $aktiv);
+                if ($aktiv) {
+                    $this->starteRegeluebergang();
+                } else {
+                    $this->beendeRegeluebergang();
                     $this->setzeZustand('SollwertGueltig', false);
                 }
                 $this->aktualisiere(true);
                 return;
 
             case 'Ladefreigabe':
+                $ladefreigabe = (bool) $wert;
+                $this->WriteAttributeBoolean('ZustandLadefreigabe', $ladefreigabe);
+                $this->setzeSichtbareVariable('Ladefreigabe', $ladefreigabe);
+                if ($ladefreigabe) {
+                    $this->starteRegeluebergang();
+                } else {
+                    $this->beendeRegeluebergang();
+                    $this->setzeZustand('SollwertGueltig', false);
+                }
+                $this->aktualisiere(true);
+                return;
+
             case 'Solarladen':
-                $this->WriteAttributeBoolean('Zustand' . $ident, (bool) $wert);
-                $this->setzeSichtbareVariable($ident, (bool) $wert);
-                $this->setzeZustand('SollwertGueltig', false);
+                $solarladen = (bool) $wert;
+                if ($solarladen !== $this->ReadAttributeBoolean('ZustandSolarladen')) {
+                    $this->starteRegeluebergang();
+                }
+                $this->WriteAttributeBoolean('ZustandSolarladen', $solarladen);
+                $this->setzeSichtbareVariable('Solarladen', $solarladen);
                 $this->aktualisiere(true);
                 return;
 
@@ -201,6 +227,11 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
                 $this->aktualisiere(true);
                 return;
 
+            case 'RegeluebergangTimeout':
+                $this->beendeRegeluebergang();
+                $this->aktualisiere(true);
+                return;
+
             case 'Melden':
                 if ((bool) $wert) {
                     $this->SetTimerInterval('RueckmeldungVerzoegert', 0);
@@ -238,7 +269,7 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
         }
 
         $this->WriteAttributeString('Betriebsart', $daten['Betriebsart']);
-        $this->aktualisiere(false, false);
+        $this->aktualisiere(false, false, false);
         $sollleistung = $daten['Sollleistung_W'];
         if ($sollleistung === null) {
             if ((bool) $this->leseZustand('SollwertGueltig')
@@ -256,6 +287,7 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
             );
         }
 
+        $this->beendeRegeluebergang();
         $this->WriteAttributeInteger('LetzteManagerID', $managerID);
         $this->WriteAttributeInteger('LetzteVorgabeZeit', time());
         $this->setzeZustand('Sollleistung', $sollleistung);
@@ -265,7 +297,11 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
         $this->SetTimerInterval('RueckmeldungVerzoegert', 100);
     }
 
-    private function aktualisiere(bool $meldungPlanen, bool $statusLesen = true): void
+    private function aktualisiere(
+        bool $meldungPlanen,
+        bool $statusLesen = true,
+        bool $steuerungAusfuehren = true
+    ): void
     {
         try {
             if ($statusLesen) {
@@ -346,12 +382,17 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
             $this->setzeZustand('AenderungMoeglich', $verfuegbar && count($angebot) > 1);
 
             $sollleistung = $this->bestimmeWirksameSollleistung($angebot);
-            if (!($aktiv
+            $phasenerkennungAktiv = $aktiv
                 && $ladefreigabe
                 && $verbunden
                 && !$geladen
-                && $phasenzahl === LadestationRegler::PHASEN_UNBEKANNT
-            )) {
+                && $phasenzahl === LadestationRegler::PHASEN_UNBEKANNT;
+            $regeluebergangAktiv = $aktiv
+                && $ladefreigabe
+                && $verbunden
+                && !$geladen
+                && $this->ReadAttributeBoolean('RegeluebergangAktiv');
+            if ($steuerungAusfuehren && !$phasenerkennungAktiv && !$regeluebergangAktiv) {
                 $this->setzeLadestrom($sollleistung);
             }
             $this->setzeStoerung('');
@@ -413,17 +454,16 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
             ) {
                 $erkennungSeit = $this->ReadAttributeInteger('PhasenerkennungSeit');
                 if ($erkennungSeit <= 0) {
-                    $this->sendeLadestromAnGeraet(
-                        $this->ReadPropertyInteger('MaximalerLadestrom')
-                    );
+                    $this->sendeLadestromAnGeraet(self::PHASENERKENNUNGSSTROM);
                     $erkennungSeit = time();
                     $this->WriteAttributeInteger('PhasenerkennungSeit', $erkennungSeit);
                 } elseif ((time() - $erkennungSeit)
                     >= $this->ReadPropertyInteger('Phasenerkennungszeit')
                 ) {
-                    $bekanntePhasenzahl = $rohstatus['Istleistung_W'] > 7500.0
-                        ? LadestationRegler::PHASEN_DREI
-                        : LadestationRegler::PHASEN_EIN;
+                    $bekanntePhasenzahl = LadestationRegler::erkennePhasenzahlAusLeistung(
+                        (float) $rohstatus['Istleistung_W'],
+                        $this->ReadAttributeInteger('LetzterGesetzterStrom')
+                    );
                     $this->WriteAttributeInteger('PhasenerkennungSeit', 0);
                 }
             } else {
@@ -819,6 +859,23 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
         return is_array($zuordnung) ? $zuordnung : [];
     }
 
+    private function starteRegeluebergang(): void
+    {
+        if ($this->zugeordneteManagerIDs() === []) {
+            $this->beendeRegeluebergang();
+            return;
+        }
+
+        $this->WriteAttributeBoolean('RegeluebergangAktiv', true);
+        $this->SetTimerInterval('RegeluebergangTimeout', self::REGELUEBERGANG_TIMEOUT_MS);
+    }
+
+    private function beendeRegeluebergang(): void
+    {
+        $this->WriteAttributeBoolean('RegeluebergangAktiv', false);
+        $this->SetTimerInterval('RegeluebergangTimeout', 0);
+    }
+
     private function pruefeKonfiguration(): void
     {
         foreach (['PrioritaetPV', 'PrioritaetPeak'] as $property) {
@@ -882,27 +939,16 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
 
     private function aktualisiereVariablen(): void
     {
-        if ($this->ReadPropertyBoolean('EinstellungenInVisu')) {
-            $this->RegisterVariableBoolean('Ladefreigabe', 'Ladefreigabe', '~Switch', 150);
-            $this->RegisterVariableBoolean('Solarladen', 'Solarladen', '~Switch', 160);
-            $this->EnableAction('Ladefreigabe');
-            $this->EnableAction('Solarladen');
-            $this->SetValue('Ladefreigabe', $this->ReadAttributeBoolean('ZustandLadefreigabe'));
-            $this->SetValue('Solarladen', $this->ReadAttributeBoolean('ZustandSolarladen'));
-        } else {
-            $this->entferneVariable('Ladefreigabe');
-            $this->entferneVariable('Solarladen');
-        }
-
         if ($this->ReadPropertyBoolean('DiagnosevariablenAnzeigen')) {
             $this->registriereVerbraucherDiagnose();
-            $this->RegisterVariableString('LetzterGeraetebefehl', 'Letzter Geraetebefehl', '', 200);
-            $this->RegisterVariableString('LeistungsangebotDiagnose', 'Leistungsangebot', '', 210);
+            $this->RegisterVariableInteger('Fahrzeugstatus', 'Fahrzeugstatus', '', 200);
+            $this->RegisterVariableString('LetzterGeraetebefehl', 'Letzter Geraetebefehl', '', 210);
+            $this->RegisterVariableString('LeistungsangebotDiagnose', 'Leistungsangebot', '', 220);
             $this->RegisterVariableInteger(
                 'FahrzeugMaximalstrom',
                 'Erkannter Fahrzeug-Maximalstrom',
                 '',
-                220
+                230
             );
             $this->SetValue(
                 'FahrzeugMaximalstrom',
@@ -926,6 +972,24 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
                 $this->entferneVariable($ident);
             }
         }
+
+        if ($this->ReadPropertyBoolean('EinstellungenInVisu')) {
+            $this->RegisterVariableBoolean('Ladefreigabe', 'Ladefreigabe', '~Switch', 150);
+            $this->RegisterVariableBoolean('Solarladen', 'Solarladen', '~Switch', 160);
+            $this->RegisterVariableFloat('Istleistung', 'Istleistung', '', 170);
+            $this->RegisterVariableInteger('Sollleistung', 'Sollleistung', '', 180);
+            $this->EnableAction('Ladefreigabe');
+            $this->EnableAction('Solarladen');
+            $this->SetValue('Ladefreigabe', $this->ReadAttributeBoolean('ZustandLadefreigabe'));
+            $this->SetValue('Solarladen', $this->ReadAttributeBoolean('ZustandSolarladen'));
+            $this->SetValue('Istleistung', $this->ReadAttributeFloat('ZustandIstleistung'));
+            $this->SetValue('Sollleistung', $this->ReadAttributeInteger('ZustandSollleistung'));
+        } else {
+            $this->entferneVariable('Ladefreigabe');
+            $this->entferneVariable('Solarladen');
+            $this->entferneVariable('Istleistung');
+            $this->entferneVariable('Sollleistung');
+        }
     }
 
     private function entferneVariable(string $ident): void
@@ -1033,7 +1097,13 @@ class LadestationStandAlone extends IPSModule implements VerbraucherSchnittstell
 
     private function deaktiviereTimer(): void
     {
-        foreach (['Statuszyklus', 'Meldezyklus', 'RueckmeldungVerzoegert', 'VorgabeTimeout'] as $timer) {
+        foreach ([
+            'Statuszyklus',
+            'Meldezyklus',
+            'RueckmeldungVerzoegert',
+            'VorgabeTimeout',
+            'RegeluebergangTimeout',
+        ] as $timer) {
             $this->SetTimerInterval($timer, 0);
         }
     }