Files
Symcon_Belevo_Energiemanage…/Batterie/module.php
T

513 lines
21 KiB
PHP

<?php
class Batterie extends IPSModule
{
public function Create()
{
parent::Create();
// Batterie spezifische Eigenschaften
$this->RegisterPropertyInteger("MaxBatterieleistung", 0);
$this->RegisterPropertyInteger("Batteriespannung", 50);
$this->RegisterPropertyInteger("AufdasNachladen", 0);
$this->RegisterPropertyInteger("MinimumEntladen", 0);
$this->RegisterPropertyInteger("Batterieladezustand", 0);
$this->RegisterPropertyInteger("Batteriemanagement", 1);
$this->RegisterPropertyInteger("Batterietyp", 1);
$this->RegisterPropertyInteger("MaxNachladen", 0);
$this->RegisterPropertyInteger("Netzbezug", 0);
$this->RegisterPropertyInteger("AktuelleBatterieleistung", 0); // Initialisierung mit 0
$this->RegisterPropertyInteger("Interval", 2); // Recheninterval
$this->RegisterVariableInteger("Batteriemanagement_Variabel", "Batteriemanagement_Variabel", "", 0);
$this->RegisterVariableInteger("Laden_Entladen", "Laden_Entladen", "", 3);
$this->RegisterVariableBoolean("Hysterese", "Hysterese", "", false);
// Variabeln für Kommunkation mit Manager
$this->RegisterVariableInteger("Aktuelle_Leistung", "Aktuelle zugeteilte Leistung", "", 0);
$this->RegisterVariableString("PowerSteps", "Leistungsschritte");
$this->RegisterVariableBoolean("Idle", "Idle", "", 0);
$this->RegisterVariableInteger("Sperre_Prio", "Priorität Peakshaving");
$this->RegisterVariableInteger("PV_Prio", "Priorität PV");
$this->RegisterVariableInteger("Power", "Leistung Batterie");
$this->RegisterVariableBoolean("Is_Peak_Shaving", "Peakshavingmodus");
$this->RegisterVariableInteger("Leistung_Delta", "Leistung Delta", "", 0);
$this->RegisterVariableFloat("Bezogene_Energie", "Bezogene Energie", "", 0);
// Hilfsvariabeln für Idle zustand
$this->RegisterPropertyInteger("IdleCounterMax", 2);
$this->RegisterVariableInteger("IdleCounter", "IdleCounter", "", 0);
$this->SetValue("IdleCounter", 0);
// Initialisiere Idle
$this->RegisterTimer("Timer_Do_UserCalc_Battery", $this->ReadPropertyInteger("Interval") * 1000, "IPS_RequestAction(" . $this->InstanceID . ', "Do_UserCalc", "");');
}
public function ApplyChanges()
{
parent::ApplyChanges();
$batterieManagement = $this->ReadPropertyInteger("Batteriemanagement");
$this->SetValue("Batteriemanagement_Variabel", $batterieManagement);
$this->SetTimerInterval("Timer_Do_UserCalc_Battery", $this->ReadPropertyInteger("Interval") * 1000);
$batterietyp = $this->ReadPropertyInteger("Batterietyp");
// Batterietypabhängige Variabeln Initialisieren
switch ($batterietyp)
{
case 0: // Herstellerunabhängig
$this->MaintainVariable("Goodwe_EntLadeleistung", "Goodwe_EntLadeleistung", VARIABLETYPE_FLOAT, "", 10, false);
$this->MaintainVariable("Ladeleistung", "Ladeleistung", VARIABLETYPE_FLOAT, "", 11, false);
$this->MaintainVariable("Entladeleistung", "Entladeleistung", VARIABLETYPE_FLOAT, "", 13, false);
break;
case 1: // Goodwe
$this->MaintainVariable("Goodwe_EntLadeleistung", "Goodwe_EntLadeleistung", VARIABLETYPE_FLOAT, "", 10, true);
$this->MaintainVariable("Ladeleistung", "Ladeleistung", VARIABLETYPE_FLOAT, "", 11, false);
$this->MaintainVariable("Entladeleistung", "Entladeleistung", VARIABLETYPE_FLOAT, "", 13, false);
break;
case 2: // Solaredge
$this->MaintainVariable("Goodwe_EntLadeleistung", "Goodwe_EntLadeleistung", VARIABLETYPE_FLOAT, "", 10, false);
$this->MaintainVariable("Ladeleistung", "Ladeleistung", VARIABLETYPE_FLOAT, "", 11, true);
$this->MaintainVariable("Entladeleistung", "Entladeleistung", VARIABLETYPE_FLOAT, "", 13, true);
break;
case 3: // SiG Energy
$this->MaintainVariable("Goodwe_EntLadeleistung", "Goodwe_EntLadeleistung", VARIABLETYPE_FLOAT, "", 10, false);
$this->MaintainVariable("Ladeleistung", "Ladeleistung", VARIABLETYPE_FLOAT, "", 11, true);
$this->MaintainVariable("Entladeleistung", "Entladeleistung", VARIABLETYPE_FLOAT, "", 13, true);
break;
default:
// Default, werden alle ausgeschaltet
$this->MaintainVariable("Goodwe_EntLadeleistung", "Goodwe_EntLadeleistung", VARIABLETYPE_FLOAT, "", 10, false);
$this->MaintainVariable("Ladeleistung", "Ladeleistung", VARIABLETYPE_FLOAT, "", 11, false);
$this->MaintainVariable("Entladeleistung", "Entladeleistung", VARIABLETYPE_FLOAT, "", 13, false);
break;
}
//
$maxBatVar = $this->ReadPropertyInteger("MaxBatterieleistung");
$maxNachVar = $this->ReadPropertyInteger("MaxNachladen");
if ($maxBatVar > 0)
{
$this->RegisterMessage($maxBatVar, VM_UPDATE);
}
if ($maxNachVar > 0)
{
$this->RegisterMessage($maxNachVar, VM_UPDATE);
}
}
public function RequestAction($Ident, $Value)
{
switch ($Ident)
{
case "SetAktuelle_Leistung":
$this->SetValue("Power", (int)$Value);
break;
case "GetCurrentData":
$this->SetValue("Is_Peak_Shaving", (bool)$Value);
break;
case "Do_UserCalc":
$this->SetAktuelle_Leistung($this->GetValue("Power"));
$this->GetCurrentData($this->GetValue("Is_Peak_Shaving"));
break;
default:
break;
}
}
// Nach aufruf bei anpassung Batteriewerte, sofort Getcurrentdata aufrufen.
public function MessageSink($TimeStamp, $SenderID, $Message, $Data)
{
if ($Message !== VM_UPDATE)
{
return;
}
$maxBatVar = $this->ReadPropertyInteger("MaxBatterieleistung");
$maxNachVar = $this->ReadPropertyInteger("MaxNachladen");
if ($SenderID === $maxBatVar || $SenderID === $maxNachVar)
{
// PowerSteps sofort neu berechnen (mit aktuellem Peak-Status)
$this->GetCurrentData($this->GetValue("Is_Peak_Shaving"));
}
}
// Aktuelle Leistung setzen lassen, der Manager vorgibt
public function SetAktuelle_Leistung(int $power)
{
$batterietyp = $this->ReadPropertyInteger("Batterietyp");
$batterieManagement = $this->ReadPropertyInteger("Batteriemanagement");
//Fallunterscheidung, soll Enelix überhaupt steuern?
// Wechselrichter steuert
// Goodwe, Solaredge WR Modus
if ($batterieManagement == 1 && ($batterietyp == 1 || $batterietyp == 2))
{
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Batteriemanagement_Variabel", 1);
return;
//Sig Energy, Herstellerunabhänig im WR Modus
}
elseif ($batterieManagement == 1 && ($batterietyp == 0 || $batterietyp == 3))
{
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Batteriemanagement_Variabel", 0);
return;
// Enelix Steuert
// Sig Energy Symcon Modus
}
elseif ($batterieManagement == 2 && ($batterietyp == 0 || $batterietyp == 3))
{
$this->SetValue("Batteriemanagement_Variabel", 1);
//Solaredge Symcon Modus
}
elseif ($batterieManagement == 2 && $batterietyp == 2)
{
$this->SetValue("Batteriemanagement_Variabel", 4);
}
// Variabeln entsprechend gewältem Batterietyp setzen
$batterietyp = $this->ReadPropertyInteger("Batterietyp");
if ($batterietyp == 0)
{
//Herstellerunabhängig
if ($this->GetValue("Is_Peak_Shaving") == true)
{
if ($power >= 0)
{
$this->SetValue("Ladeleistung", $power);
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Laden_Entladen", 0);
}
else
{
$this->SetValue("Entladeleistung", abs($power));
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Laden_Entladen", 1);
}
}
else
{
if ($power >= 0)
{
$this->SetValue("Ladeleistung", $power);
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Laden_Entladen", 0);
}
else
{
$this->SetValue("Entladeleistung", abs($power));
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Laden_Entladen", 1);
}
}
}
elseif ($batterietyp == 1)
{
//Goodwe
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Ladeleistung", 0);
if ($this->GetValue("Is_Peak_Shaving") == true)
{
if ($power >= 0)
{
$this->SetValue("Goodwe_EntLadeleistung", abs($power));
$this->SetValue("Laden_Entladen", 11);
}
else
{
$this->SetValue("Goodwe_EntLadeleistung", abs($power));
$this->SetValue("Laden_Entladen", 12);
}
}
else
{
if ($power >= 0)
{
$this->SetValue("Goodwe_EntLadeleistung", abs($power));
$this->SetValue("Laden_Entladen", 11);
}
else
{
$this->SetValue("Goodwe_EntLadeleistung", abs($power));
$this->SetValue("Laden_Entladen", 12);
}
}
}
elseif ($batterietyp == 2)
{
//Solaredge
if ($this->GetValue("Is_Peak_Shaving") == true)
{
if ($power >= 0)
{
$this->SetValue("Ladeleistung", $power);
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Laden_Entladen", 3);
}
else
{
$this->SetValue("Entladeleistung", abs($power));
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Laden_Entladen", 4);
}
}
else
{
if ($power >= 0)
{
$this->SetValue("Ladeleistung", $power);
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Laden_Entladen", 3);
}
else
{
$this->SetValue("Entladeleistung", abs($power));
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Laden_Entladen", 4);
}
}
}
elseif ($batterietyp == 3)
{
//Sig Energy
if ($this->GetValue("Is_Peak_Shaving") == true)
{
if ($power >= 0)
{
$this->SetValue("Ladeleistung", $power / 1000);
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Laden_Entladen", 3);
}
else
{
$this->SetValue("Entladeleistung", abs($power) / 1000);
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Laden_Entladen", 6);
}
}
else
{
if ($power >= 0)
{
$this->SetValue("Ladeleistung", $power / 1000);
$this->SetValue("Entladeleistung", 0);
$this->SetValue("Laden_Entladen", 3);
}
else
{
$this->SetValue("Entladeleistung", abs($power) / 1000);
$this->SetValue("Ladeleistung", 0);
$this->SetValue("Laden_Entladen", 6);
}
}
}
// Prüfe auf Änderung der Leistung im Vergleich zur letzten Einstellung
$lastPower = GetValue($this->GetIDForIdent("Aktuelle_Leistung"));
if ($power != $lastPower)
{
$this->SetValue("Idle", false);
$this->SetValue("IdleCounter", $this->ReadPropertyInteger("IdleCounterMax"));
}
// Setze die neue aktuelle Leistung
$this->SetValue("Aktuelle_Leistung", $power);
$this->SetValue("Bezogene_Energie", $this->GetValue("Bezogene_Energie") + $this->GetValue("Aktuelle_Leistung") * ($this->ReadPropertyInteger("Interval") / 3600));
// IdleCounter verarbeiten
$this->ProcessIdleCounter();
}
public function GetCurrentData(bool $Peak)
{
// Aktuelle Daten ausarbeiten und Berechnen
$array_powersteps = $this->GeneratePowerSteps();
$aufdasnachladen = $this->ReadPropertyInteger("AufdasNachladen");
$minimumentladen = $this->ReadPropertyInteger("MinimumEntladen");
$maxleistung = GetValue($this->ReadPropertyInteger("MaxBatterieleistung")); //Ladeleistung
$maxentladeleistung = GetValue($this->ReadPropertyInteger("MaxNachladen")); //Entladeleistung
$dummy_array = [];
$batterieladezustand = GetValue($this->ReadPropertyInteger("Batterieladezustand"));
$filtered_powersteps_entladen = [];
if ($this->ReadPropertyInteger("Batteriemanagement") == 1)
{
$dummy_array[] = 0;
return $this->SetValue("PowerSteps", json_encode($dummy_array));
}
$netzbezug = GetValue($this->ReadPropertyInteger("Netzbezug"));
$bat_leistung = GetValue($this->ReadPropertyInteger("AktuelleBatterieleistung"));
if ($Peak && $netzbezug > 0)
{
$netzbezug = - min($netzbezug, $maxentladeleistung) + $bat_leistung;
}
if ($batterieladezustand > 5 + $aufdasnachladen)
{
$this->SetValue("Hysterese", false);
}
elseif ($batterieladezustand <= $aufdasnachladen)
{
$this->SetValue("Hysterese", true);
}
$hyst = $this->GetValue("Hysterese");
if ($Peak)
{
if ($batterieladezustand > $aufdasnachladen && $hyst == false)
{
$dummy_array[] = $netzbezug;
$this->SetValue("PowerSteps", json_encode($dummy_array));
}
elseif ($batterieladezustand > $aufdasnachladen && $hyst == true)
{
$filtered_powersteps = array_filter($array_powersteps, function ($value)
{
return $value <= 0;
});
$filtered_powersteps_laden = array_values($filtered_powersteps);
$this->SetValue("PowerSteps", json_encode($filtered_powersteps_laden));
}
elseif ($batterieladezustand > $minimumentladen)
{
$this->SetValue("PowerSteps", json_encode($array_powersteps));
}
else
{
$filtered_powersteps = array_filter($array_powersteps, function ($value)
{
return $value >= 0;
});
$filtered_powersteps_laden = array_values($filtered_powersteps);
$this->SetValue("PowerSteps", json_encode($filtered_powersteps_laden));
}
}
else
{
if ($batterieladezustand > 99)
{
$filtered_powersteps = array_filter($array_powersteps, function ($value)
{
return $value <= 0;
});
$filtered_powersteps_laden = array_values($filtered_powersteps);
$this->SetValue("PowerSteps", json_encode($filtered_powersteps_laden));
}
elseif ($batterieladezustand > $aufdasnachladen && $hyst == false)
{
$this->SetValue("PowerSteps", json_encode($array_powersteps));
}
elseif ($batterieladezustand >= $aufdasnachladen && $hyst == true)
{
$filtered_powersteps = array_filter($array_powersteps, function ($value)
{
return $value >= 0;
});
$filtered_powersteps_laden = array_values($filtered_powersteps);
$this->SetValue("PowerSteps", json_encode($filtered_powersteps_laden));
}
elseif ($batterieladezustand < $aufdasnachladen)
{
//$dummy_array[] = GetValue($this->ReadPropertyInteger("MaxNachladen"));
$dummy_array[] = GetValue($this->ReadPropertyInteger("MaxBatterieleistung"));
$this->SetValue("PowerSteps", json_encode($dummy_array));
}
}
}
// Ab hier Hilfsfunktionen
private function GeneratePowerSteps()
{
// Hilfsfunktion um die Möglichen Powersteps zu generieren
$maxleistung_raw = GetValue($this->ReadPropertyInteger("MaxBatterieleistung"));
$nachladen_raw = GetValue($this->ReadPropertyInteger("MaxNachladen"));
$stepSize = 250; // Grobe Schrittgröße
$stepSizeSmall = 50; // Feine Schrittgröße
// Grenzen auf 50er abrunden (floor)
$maxleistung = (int)(floor($maxleistung_raw / $stepSizeSmall) * $stepSizeSmall);
$minleistung = (int)(-floor($nachladen_raw / $stepSizeSmall) * $stepSizeSmall); // negativ!
// Sicherheitscheck: falls Werte komisch sind
if ($maxleistung < 0)
{
$maxleistung = 0;
}
if ($minleistung > 0)
{
$minleistung = 0;
}
// Grundarray: von min bis max in 250er Schritten
$neg = $minleistung < 0 ? range($minleistung, 0, $stepSize) : [0];
$pos = range(0, $maxleistung, $stepSize);
$array_powersteps = array_values(array_unique(array_merge($neg, $pos)));
sort($array_powersteps, SORT_NUMERIC);
// Zusätzlichen Wert auf 50er abrunden
$closestValue = (int)(floor($additionalValue / $stepSizeSmall) * $stepSizeSmall);
// Clamp in den Bereich
if ($closestValue < $minleistung)
{
$closestValue = $minleistung;
}
if ($closestValue > $maxleistung)
{
$closestValue = $maxleistung;
}
// Prüfen ob der Wert im Array existiert (bei 250er Raster oft NICHT)
$index = array_search($closestValue, $array_powersteps, true);
// Wenn nicht vorhanden: an der richtigen Stelle einsortieren
if ($index === false)
{
$index = 0;
$count = count($array_powersteps);
while ($index < $count && $array_powersteps[$index] < $closestValue)
{
$index++;
}
}
// Feine Werte um closestValue herum (±4 * 50)
$newValues = [];
for ($i = - 4;$i <= 4;$i++)
{
$v = $closestValue + $i * $stepSizeSmall;
if ($v >= $minleistung && $v <= $maxleistung)
{
$newValues[] = $v;
}
}
// Duplikate vermeiden (falls schon Werte vorhanden sind)
$newValues = array_values(array_unique($newValues));
// Wenn closestValue exakt im Grundarray war: diesen einen ersetzen
// sonst: feinwerte einfach an der Einfügestelle einfügen
if (array_search($closestValue, $array_powersteps, true) !== false)
{
$existingIndex = array_search($closestValue, $array_powersteps, true);
array_splice($array_powersteps, $existingIndex, 1, $newValues);
}
else
{
array_splice($array_powersteps, $index, 0, $newValues);
}
// Am Ende sortieren
$array_powersteps = array_values(array_unique($array_powersteps));
sort($array_powersteps, SORT_NUMERIC);
return $array_powersteps;
}
private function CheckIdle($power)
{
// Hilfsfunktion zum Prüfen ob die Batterie schon wieder Leistung verändern kann
$lastpower = GetValue("Aktuelle_Leistung");
if ($lastpower != GetValue("Aktuelle_Leistung"))
{
$this->SetValue("Idle", false);
$this->SetValue("IdleCounter", $this->ReadPropertyInteger("IdleCounterMax"));
}
// IdleCounter auslesen und verarbeiten
$idleCounter = $this->GetValue("IdleCounter");
if ($idleCounter > 0)
{
$this->SetValue("Idle", false);
$this->SetValue("IdleCounter", $idleCounter - 1);
}
else
{
$this->SetValue("Idle", true);
}
}
private function ProcessIdleCounter()
{
// IdleCounter auslesen und verarbeiten
$idleCounter = $this->GetValue("IdleCounter");
if ($idleCounter > 0)
{
$this->SetValue("Idle", false);
$this->SetValue("IdleCounter", $idleCounter - 1);
}
else
{
$this->SetValue("Idle", true);
}
}
}
?>