puffer modul

Puffer/README.md

@@ -0,0 +1,67 @@
+# Manager_1
+Beschreibung des Moduls.
+
+### Inhaltsverzeichnis
+
+1. [Funktionsumfang](#1-funktionsumfang)
+2. [Voraussetzungen](#2-voraussetzungen)
+3. [Software-Installation](#3-software-installation)
+4. [Einrichten der Instanzen in IP-Symcon](#4-einrichten-der-instanzen-in-ip-symcon)
+5. [Statusvariablen und Profile](#5-statusvariablen-und-profile)
+6. [WebFront](#6-webfront)
+7. [PHP-Befehlsreferenz](#7-php-befehlsreferenz)
+
+### 1. Funktionsumfang
+
+*
+
+### 2. Voraussetzungen
+
+- IP-Symcon ab Version 7.1
+
+### 3. Software-Installation
+
+* Über den Module Store das 'Manager_1'-Modul installieren.
+* Alternativ über das Module Control folgende URL hinzufügen
+
+### 4. Einrichten der Instanzen in IP-Symcon
+
+ Unter 'Instanz hinzufügen' kann das 'Manager_1'-Modul mithilfe des Schnellfilters gefunden werden.  
+	- Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzufügen)
+
+__Konfigurationsseite__:
+
+Name     | Beschreibung
+-------- | ------------------
+         |
+         |
+
+### 5. Statusvariablen und Profile
+
+Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.
+
+#### Statusvariablen
+
+Name   | Typ     | Beschreibung
+------ | ------- | ------------
+       |         |
+       |         |
+
+#### Profile
+
+Name   | Typ
+------ | -------
+       |
+       |
+
+### 6. WebFront
+
+Die Funktionalität, die das Modul im WebFront bietet.
+
+### 7. PHP-Befehlsreferenz
+
+`boolean GEF_BeispielFunktion(integer $InstanzID);`
+Erklärung der Funktion.
+
+Beispiel:
+`GEF_BeispielFunktion(12345);`

Puffer/form.json

@@ -0,0 +1,93 @@
+{
+    "elements": [
+        {
+            "type": "Label",
+            "caption": "Konfiguration der nötigen Schaltkontakte und Nennleistungen"
+        },
+        {
+            "type":"Select",
+            "name":"Boilertemperatur_glätten",
+            "caption":"Boilertemperatur glätten",
+            "options":[
+               {
+                  "caption":"Ja",
+                  "value":true
+               },
+               {
+                  "caption":"Nein",
+                  "value":false
+               }
+            ]
+         },
+         {
+            "type": "NumberSpinner",
+            "name": "ZeitKonstante",
+            "caption": "Zeit Konstante",
+            "suffix": ""
+        },        
+        {
+            "type": "NumberSpinner",
+            "name": "Interval",
+            "caption": "Intervall Neuberechnung der Werte Erst für spätere Versionen, aktuell auf 5 lassen!",
+            "suffix": "Sekunden"
+        },
+        {
+            "type": "NumberSpinner",
+            "name": "IdleCounterMax",
+            "caption": "Zyklen zwischen zwei Leistungsänderungen (Multipliziert sich mit Interval)",
+            "suffix": ""
+        },
+        {
+            "type": "NumberSpinner",
+            "name": "PufferLeistung",
+            "caption": "Puffer Leistung",
+            "suffix": "Watt"
+        },
+        {
+            "type": "Label",
+            "caption": "Endpunkte der Pufferfunktion bestimmen: VT = f(AT)"
+        },
+        {
+            "type": "NumberSpinner",
+            "name": "MaxVT_Temp",
+            "caption": "Max Temperatur VT",
+            "suffix": "°C"
+        },
+        {
+            "type": "NumberSpinner",
+            "name": "MinVT_Temp",
+            "caption": "MIn Temperatur VT",
+            "suffix": "°C"
+        },
+        {
+            "type": "NumberSpinner",
+            "name": "MaxAT_Temp",
+            "caption": "Max Temperatur AT",
+            "suffix": "°C"
+        },
+        {
+            "type": "NumberSpinner",
+            "name": "MinAT_Temp",
+            "caption": "Min Temperatur AT",
+            "suffix": "°C"
+        },
+        {
+            "type": "SelectVariable",
+            "name": "Boilerfuehler_PT1",
+            "caption": "Variable für Boilerfühler PT1",
+            "test": true
+        },  
+        {
+            "type": "SelectVariable",
+            "name": "Heizkontakt_Puffer",
+            "caption": "Heizkontakt Volllast",
+            "test": true
+        },  
+        {
+            "type": "SelectVariable",
+            "name": "Aussentemp",
+            "caption": "Aussentemperatur",
+            "suffix": "°C"
+        }
+    ]
+}

Puffer/module.json

@@ -0,0 +1,12 @@
+{
+    "id": "{92E18FE8-489C-87A7-766B-2F06B7BD95E5}",
+    "name": "Puffer",
+    "type": 3,
+    "vendor": "Belevo AG",
+    "aliases": [],
+    "parentRequirements": [],
+    "childRequirements": [],
+    "implemented": [],
+    "prefix": "GEF",
+    "url": ""
+}

Puffer/module.php

@@ -0,0 +1,225 @@
+<?php
+
+class Puffer extends IPSModule
+{
+    public function Create()
+    {
+        parent::Create();
+
+        // Boiler spezifische Properties
+        
+        $this->RegisterPropertyInteger("PufferLeistung", 6000);
+        $this->RegisterPropertyInteger("ZeitKonstante", 120);
+        $this->RegisterPropertyInteger("Boilerfuehler_PT1", 0);
+        $this->RegisterPropertyInteger("Heizkontakt_Puffer", 0);
+        $this->RegisterPropertyInteger("Aussentemp", 20);
+        $this->RegisterPropertyInteger("MinVT_Temp", 20);
+        $this->RegisterPropertyInteger("MaxVT_Temp", 80);
+        $this->RegisterPropertyInteger("MaxAT_Temp", 0);
+        $this->RegisterPropertyInteger("MinAT_Temp", 20);
+        $this->RegisterPropertyBoolean("Boilertemperatur_glätten", false);
+        $this->RegisterPropertyString("Zeitplan", "");
+        $this->RegisterPropertyInteger("Interval", 5); // Recheninterval
+        
+        // Puffer spezifische Variablen
+        $this->RegisterVariableInteger("Steigung","Steigung","",0);
+        $this->RegisterVariableInteger("Maximaltemperatur","Maximaltemperatur","",60);
+        $this->RegisterVariableInteger("Boilertemperatur", "Boilertemperatur", "", 0);
+
+        // Variabeln für Kommunkation mit Manager
+        $this->RegisterVariableInteger("Sperre_Prio", "Sperre_Prio");
+        $this->RegisterVariableInteger("PV_Prio", "PV_Prio");
+        $this->RegisterVariableBoolean("Idle", "Idle", "", 0);
+        $this->RegisterVariableInteger("Aktuelle_Leistung", "Aktuelle_Leistung", "", 0);
+        $this->RegisterVariableFloat("Bezogene_Energie", "Bezogene_Energie", "", 0);
+        $this->RegisterVariableString("PowerSteps", "PowerSteps");
+        $this->RegisterVariableInteger("Power", "Power", '', 0);
+        $this->RegisterVariableBoolean("Is_Peak_Shaving", "Is_Peak_Shaving", "", true);
+        $this->RegisterVariableInteger("Leistung_Delta", "Leistung_Delta", "", 0);
+
+        // Hilfsvariabeln für Idle zustand
+        $this->RegisterPropertyInteger("IdleCounterMax", 2);
+        $this->RegisterVariableInteger("IdleCounter", "IdleCounter", "", 0);
+        $this->SetValue("IdleCounter", 0);
+
+        // Initialisiere Idle
+        $this->SetValue("Idle", true);
+        $this->RegisterTimer("Timer_Do_UserCalc_Boiler",$this->ReadPropertyInteger("Interval")*1000,"IPS_RequestAction(" .$this->InstanceID .', "Do_UserCalc", "");');
+
+    }
+
+    public function ApplyChanges()
+    {
+        parent::ApplyChanges();
+        $this->SetTimerInterval("Timer_Do_UserCalc_Boiler",$this->ReadPropertyInteger("Interval")*1000); 
+
+        $minVT = $this->ReadPropertyInteger("MinVT_Temp");  // z.B. 20
+        $maxVT = $this->ReadPropertyInteger("MaxVT_Temp");  // z.B. 80
+        $maxAT = $this->ReadPropertyInteger("MaxAT_Temp");  // z.B. 0
+        $minAT = $this->ReadPropertyInteger("MinAT_Temp");  // z.B. 20
+
+        $m = ($minVT - $maxVT) / ($minAT - $maxAT);
+        $this->SetValue("Steigung", $m);
+    }
+
+    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:
+                throw new Exception("Invalid Ident");
+        }
+    }
+
+    // Methode zum Setzen des aktuellen Stromverbrauchs
+    public function SetAktuelle_Leistung(int $power)
+    {
+        // Schalte Kontakt Teillast und Vollast entsprechend der Power-Einstellung
+        if ($power == $this->ReadPropertyInteger("PufferLeistung")) {
+            SetValue($this->ReadPropertyInteger("Heizkontakt_Puffer"), true);
+        } else {
+            SetValue($this->ReadPropertyInteger("Heizkontakt_Puffer"), false);
+        }
+
+        // Prüfe auf Änderung der Power 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();
+    }
+
+    // Methode zum Abrufen der aktuellen Daten
+    public function GetCurrentData(bool $Peak)
+    {
+        
+        $boilertemperatur_glätten = $this->ReadPropertyBoolean("Boilertemperatur_glätten");
+
+        if ($boilertemperatur_glätten) {
+            // Wenn Glättung aktiviert ist, führe das Glätten durch
+            $boilerFuehlerPT1ID = $this->ReadPropertyInteger("Boilerfuehler_PT1");
+        
+            if (IPS_VariableExists($boilerFuehlerPT1ID)) {
+                $boilerPT1 = GetValue($boilerFuehlerPT1ID);
+            } else {
+                $boilerPT1 = 0.0; // Standardwert
+            }
+        
+            $boilerTempID = $this->GetIDForIdent("Boilertemperatur");
+            if (IPS_VariableExists($boilerTempID)) {
+                $boilerTemp = $this->GetValue("Boilertemperatur");
+            } else {
+                $boilerTemp = 0.0; // Standardwert
+            }
+        
+            // PT
+            $time_constant= $this->ReadPropertyInteger("ZeitKonstante");
+            $delta_t = 5; // Zeitdifferenz zwischen den Messungen (30 Sekunden)
+            $alpha = $delta_t / ($time_constant + $delta_t);
+            $newBoilerTemp = $boilerTemp + $alpha * ($boilerPT1 - $boilerTemp);
+            $this->SetValue("Boilertemperatur", $newBoilerTemp);
+        } else {
+            // Wenn Glättung nicht aktiviert ist, setze die Boilertemperatur direkt auf den Wert des Boilerfühlers
+            $boilerFuehlerPT1ID = $this->ReadPropertyInteger("Boilerfuehler_PT1");
+        
+            if (IPS_VariableExists($boilerFuehlerPT1ID)) {
+                $boilerPT1 = GetValue($boilerFuehlerPT1ID);
+            } else {
+                $boilerPT1 = 0.0; // Standardwert
+            }
+            // Setze Boilertemperatur direkt auf den Wert des Boilerfühlers
+            $this->SetValue("Boilertemperatur", $boilerPT1);
+        }
+        
+        // VT anhand AT berechnen
+        $at = $this->ReadPropertyInteger("Aussentemp");
+        $m = $this->GetValue("Steigung");
+        $minVT = $this->ReadPropertyInteger("MinVT_Temp");  // z.B. 20
+        $maxVT = $this->ReadPropertyInteger("MaxVT_Temp");  // z.B. 80
+        $maxAT = $this->ReadPropertyInteger("MaxAT_Temp");  // z.B. 0
+        $minAT = $this->ReadPropertyInteger("MinAT_Temp");  // z.B. 20
+        if ($at < $minAT){
+            $VT = $maxVT;
+        } elseif ($at > $maxAT){
+            $VT = $minVT;
+        } else {
+            $VT = $m * ($at - $maxAT) + $maxVT;
+        }
+        $this->SetValue("Maximaltemperatur", $VT );
+
+
+        $boilerTemp = $this->GetValue("Boilertemperatur");
+        $pufferLeistung = $this->ReadPropertyInteger("PufferLeistung");
+
+
+
+        if ($Peak) {
+            $this->SetValue( "PowerSteps", json_encode([0]) );
+        } else {
+            if ($boilerTemp < $VT) {
+                $this->SetValue("PowerSteps", json_encode([$pufferLeistung]));    
+            } else {
+                $this->SetValue("PowerSteps", json_encode([0]));
+            }
+        }
+    }
+
+    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);
+        }
+    }
+
+    private function CheckIdle($power)
+    {
+        $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);
+        }
+    }
+
+
+}
+
+?>