Symcon_Belevo_Energiemanagement_testing/Bat_EV_SDL/module.php

<?php

class Bat_EV_SDL extends IPSModule
{
    public function Create()
    {
        parent::Create();

        $this->RegisterPropertyString("Batteries", "[]");
        $this->RegisterPropertyInteger("SDL_Leistung", 0);     // W
        $this->RegisterPropertyInteger("UpdateInterval", 5);   // Minuten

        $this->RegisterVariableBoolean("State", "Aktiv", "~Switch", 1);
        $this->EnableAction("State");

        $this->RegisterVariableFloat("SDL_Pos", "SDL Fensterposition (%)", "", 10);
        $this->RegisterVariableFloat("SoC_EV",  "EV Fenster-Füllstand (%)", "", 11);

        $this->RegisterVariableFloat("P_SDL_max", "SDL max (W)", "", 20);
        $this->RegisterVariableFloat("P_SDL_laden", "P SDL laden max (W)", "", 21);
        $this->RegisterVariableFloat("P_SDL_entladen", "P SDL entladen max (W)", "", 22);

        $this->RegisterVariableFloat("P_EV_max", "EV max (W)", "", 30);
        $this->RegisterVariableFloat("P_EV_laden", "P EV laden max (W)", "", 31);
        $this->RegisterVariableFloat("P_EV_entladen", "P EV entladen max (W)", "", 32);

        $this->RegisterVariableString("CalcJSON", "Berechnung (JSON)", "", 99);

        $this->RegisterTimer("UpdateTimer", 0, 'GEF_Update($_IPS["TARGET"]);');
    }

    public function ApplyChanges()
    {
        parent::ApplyChanges();

        $intervalMin = (int)$this->ReadPropertyInteger("UpdateInterval");
        $this->SetTimerInterval("UpdateTimer", ($intervalMin > 0) ? $intervalMin * 60 * 1000 : 0);

        $this->Update();
    }

    public function RequestAction($Ident, $Value)
    {
        if ($Ident === "State") {
            SetValue($this->GetIDForIdent("State"), (bool)$Value);
            if ((bool)$Value) $this->Update();
            return;
        }
        throw new Exception("Invalid Ident: " . $Ident);
    }

    public function Update()
    {
        if (!GetValue($this->GetIDForIdent("State"))) return;

        $batteries = json_decode($this->ReadPropertyString("Batteries"), true);
        if (!is_array($batteries) || count($batteries) === 0) return;

        $sdlPowerW = max(0, (int)$this->ReadPropertyInteger("SDL_Leistung"));
        $reserveH = 0.5;
        $eps = 0.0001;

        // Summe Max-Leistungen
        $sumBatPowerW = 0;
        foreach ($batteries as $b) {
            $p = (int)($b["powerbat"] ?? 0);
            if ($p > 0) $sumBatPowerW += $p;
        }
        if ($sumBatPowerW <= 0) return;
        if ($sdlPowerW > $sumBatPowerW) $sdlPowerW = $sumBatPowerW;

        // Summen Leistung
        $P_SDL_max = 0.0; $P_EV_max = 0.0;
        $P_SDL_laden = 0.0; $P_SDL_entladen = 0.0;
        $P_EV_laden = 0.0; $P_EV_entladen = 0.0;

        // EV-Füllstand (gewichtet über FensterkWh)
        $sumEV = 0.0; $sumEVcap = 0.0;

        // SDL_Pos (gewichtet über pSDL!)
        $sumPos_pSDL = 0.0; $sum_pSDL = 0.0;

        $calc = [];

        foreach ($batteries as $b) {

            $typ  = (string)($b["typ"] ?? "");
            $pBat = (int)($b["powerbat"] ?? 0);
            $cap  = (float)($b["capazity"] ?? 0);
            if ($pBat <= 0 || $cap <= 0) continue;

            $socPct = $this->ReadSocPercent((int)($b["soc"] ?? 0));
            $E = $cap * $socPct / 100.0;

            // SDL-Leistungsanteil
            $pSDL = min(($sdlPowerW * $pBat) / $sumBatPowerW, (float)$pBat);
            if ($pSDL < 0) $pSDL = 0.0;
            $pEV = max(0.0, $pBat - $pSDL);

            $P_SDL_max += $pSDL;
            $P_EV_max  += $pEV;

            // Reserveenergie 30min
            $Ereq = ($pSDL * $reserveH) / 1000.0;

            // Fenster
            $Emin = $Ereq;
            $Emax = $cap - $Ereq;
            $range = $Emax - $Emin;
            $EVcap = max(0.0, $range);

            // SDL möglich?
            $canSDLdis = ($E + $eps) >= $Emin;
            $canSDLch  = (($cap - $E) + $eps) >= $Ereq;

            if ($canSDLdis) $P_SDL_entladen += $pSDL;
            if ($canSDLch)  $P_SDL_laden    += $pSDL;

            // EV möglich?
            if ($E > $Emin + $eps) $P_EV_entladen += $pEV;
            if ($E < $Emax - $eps) $P_EV_laden    += $pEV;

            // EV-Füllstand
            $EV = 0.0;
            $EVpct = 0.0;
            if ($EVcap > $eps) {
                $EV = max(0.0, min($E - $Emin, $EVcap));
                $sumEV += $EV;
                $sumEVcap += $EVcap;
                $EVpct = ($EV / $EVcap) * 100.0;
            }

            // SDL Fensterposition (0..100) und gewichtete Summe über pSDL
            $posPct = 0.0;
            if ($range > $eps) {
                $pos = ($E - $Emin) / $range;   // 0..1
                $pos = max(0.0, min(1.0, $pos));
                $posPct = $pos * 100.0;
            }

            if ($pSDL > $eps) {
                $sumPos_pSDL += $posPct * $pSDL;
                $sum_pSDL    += $pSDL;
            }

            $calc[] = [
                "typ" => $typ,
                "soc_pct" => round($socPct, 2),
                "E_kWh" => round($E, 3),
                "cap_kWh" => round($cap, 3),

                "pSDL_W" => round($pSDL, 0),
                "pEV_W" => round($pEV, 0),

                "Ereq_kWh" => round($Ereq, 3),
                "Emin_kWh" => round($Emin, 3),
                "Emax_kWh" => round($Emax, 3),
                "EVcap_kWh" => round($EVcap, 3),

                "SDL_pos_pct" => round($posPct, 2),
                "EV_fill_pct" => round($EVpct, 2),

                "canSDLcharge" => $canSDLch,
                "canSDLdischarge" => $canSDLdis
            ];
        }

        $SDL_Pos = ($sum_pSDL > $eps) ? ($sumPos_pSDL / $sum_pSDL) : 0.0;
        $SoC_EV  = ($sumEVcap > $eps) ? (($sumEV / $sumEVcap) * 100.0) : 0.0;

        SetValue($this->GetIDForIdent("SDL_Pos"), round($SDL_Pos, 2));
        SetValue($this->GetIDForIdent("SoC_EV"),  round($SoC_EV, 2));

        SetValue($this->GetIDForIdent("P_SDL_max"), round($P_SDL_max, 0));
        SetValue($this->GetIDForIdent("P_SDL_laden"), round($P_SDL_laden, 0));
        SetValue($this->GetIDForIdent("P_SDL_entladen"), round($P_SDL_entladen, 0));

        SetValue($this->GetIDForIdent("P_EV_max"), round($P_EV_max, 0));
        SetValue($this->GetIDForIdent("P_EV_laden"), round($P_EV_laden, 0));
        SetValue($this->GetIDForIdent("P_EV_entladen"), round($P_EV_entladen, 0));

        SetValue($this->GetIDForIdent("CalcJSON"), json_encode($calc, JSON_PRETTY_PRINT));
    }

    private function ReadSocPercent(int $varId): float
    {
        if ($varId <= 0 || !IPS_VariableExists($varId)) return 0.0;
        $v = GetValue($varId);
        if (!is_numeric($v)) return 0.0;

        $f = (float)$v;
        if ($f >= 0.0 && $f <= 1.0) $f *= 100.0;
        return max(0.0, min(100.0, $f));
    }
}