dh/Symcon_Belevo_Energiemanagement_testing
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

no message

Browse Source
This commit is contained in:
Michael Haas
2026-06-10 15:17:27 +02:00
parent 6c614f5ab7
commit 90991fd23b
1 changed files with 108 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Heizung_x_Stufig/README.md
+108 -42
View File
@@ -1,67 +1,133 @@
# Manager_1
Beschreibung des Moduls.
# Enelix-Verbrauchermodul Heizung x-stufig
### Inhaltsverzeichnis
Dieses Modul integriert mehrstufige Heizungen als steuerbare Verbraucher in das Belevo Energiemanagement-System (Enelix). Es berechnet dynamisch verfügbare Leistungsstufen, kommuniziert mit dem übergeordneten Manager und schaltet die hinterlegten Heizstufen anhand von Temperatur, PV-Überschuss und Peak-Shaving-Anforderungen.
---
## 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)
3. [Installation](#3-installation)
4. [Instanz anlegen & Konfiguration](#4-instanz-anlegen--konfiguration)
5. [Statusvariablen & Profile](#5-statusvariablen--profile)
6. [WebFront / Bedienung](#6-webfront--bedienung)
7. [Mapping auf Code-Komponenten](#7-mapping-auf-code-komponenten)
8. [Zukünftige Erweiterungen](#8-zukünftige-erweiterungen)
### 1. Funktionsumfang
---
*
## 1. Funktionsumfang
### 2. Voraussetzungen
* **Zyklische Steuerung:** In konfigurierbaren Intervallen (`Interval`) berechnet das Modul die aktuell verfügbaren Leistungsschritte und aktualisiert den Status.
* **Mehrstufige Heizungssteuerung:** Beliebig viele Leistungsstufen können mit Leistung und zugehörigem Schaltkontakt definiert werden.
* **PowerSteps-Generierung:** Das Modul meldet dem Enelix-Manager ein Array an möglichen Leistungsschritten (`PowerSteps`), basierend auf Temperatur, Betriebsmodus und den konfigurierten Heizstufen.
* **Peak-Shaving vs. PV-Überschuss:** Automatische Anpassung der angebotenen `PowerSteps` basierend auf dem vom Manager vorgegebenen Modus (`Is_Peak_Shaving`). Im Peak-Shaving-Modus wird nur die Mindesttemperatur sichergestellt, im PV-Modus wird zusätzlicher Überschuss zur Wärmeerzeugung genutzt.
* **Temperaturüberwachung:** Berücksichtigung von Mindesttemperatur (`Mindesttemperatur`), Maximaltemperatur (`Maximaltemperatur`) und Hysterese zur Vermeidung unnötiger Schaltvorgänge.
* **Temperaturglättung:** Optional kann die gemessene Temperatur über eine PT1-Filterung geglättet werden um Temperatursprünge und Messrauschen zu reduzieren.
* **Idle-Schutz:** Nach einer Leistungsänderung kann eine konfigurierbare Sperrzeit (`IdleCounterMax`) berücksichtigt werden bevor weitere Leistungsänderungen erfolgen.
- IP-Symcon ab Version 7.1
---
### 3. Software-Installation
## 2. Voraussetzungen
* Über den Module Store das 'Manager_1'-Modul installieren.
* Alternativ über das Module Control folgende URL hinzufügen
* IP-Symcon **≥ 8.0**
* Modul-URL: `https://git.belevo.ch/dh/enelix.git`
* Vorhandener und eingerichteter Enelix Manager.
* Temperaturfühler als Variable in IP-Symcon.
* Schaltbare Kontakte mit aktivierter Aktion für die einzelnen Heizstufen.
### 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)
## 3. Installation
__Konfigurationsseite__:
1. In IP-Symcon **Module Control** öffnen.
2. **Hinzufügen → Git-Repository**.
3. URL eingeben und **Installieren**.
4. IP-Symcon neu starten.
Name | Beschreibung
-------- | ------------------
|
|
---
### 5. Statusvariablen und Profile
## 4. Instanz anlegen & Konfiguration
Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.
### 4.1 Instanz anlegen
#### Statusvariablen
* Rechtsklick **Instanzen** → **Instanz hinzufügen**
* Filter: **Belevo**
* Auswahl: **Heizung x-stufig**
Name | Typ | Beschreibung
------ | ------- | ------------
| |
| |
### 4.2 Properties
#### Profile
| Name | Typ | Beschreibung |
| ------------------------------ | -------------- | ---------------------------------------------------------------- |
| **Heizungstemperatur_glätten** | Select | Aktiviert die PT1-Glättung der gemessenen Temperatur. |
| **ZeitKonstante** | NumberSpinner | Zeitkonstante des PT1-Filters in Sekunden. |
| **Interval** | NumberSpinner | Berechnungsintervall in Sekunden. |
| **IdleCounterMax** | NumberSpinner | Anzahl der Intervall-Zyklen zwischen zwei Leistungsänderungen. |
| **Hysterese** | NumberSpinner | Temperatur-Hysterese in °C. |
| **LeistungsStufen** | List | Liste der verfügbaren Heizstufen mit Leistung und Schaltkontakt. |
| **Heizungsfuehler** | SelectVariable | Variable mit der aktuellen Temperatur. |
Name | Typ
------ | -------
|
|
---
### 6. WebFront
## 5. Statusvariablen & Profile
Die Funktionalität, die das Modul im WebFront bietet.
| Ident | Typ | Beschreibung |
| ---------------------- | ------- | ------------------------------------------------------------------------------ |
| **PowerSteps** | String | JSON-Array der dem Manager angebotenen Leistungsschritte. |
| **Aktuelle_Leistung** | Integer | Die aktuell geschaltete Heizleistung. |
| **Power** | Integer | Die aktuell vom Manager zugewiesene Soll-Leistung. |
| **Idle** | Boolean | Status der Sperrzeit (`true` = bereit für neue Werte, `false` = gesperrt). |
| **Bezogene_Energie** | Float | Rechnerisch aufsummierte Energie (Leistung × Zeit). |
| **PV_Prio** | Integer | Priorität des Verbrauchers für PV-Optimierung, Tiefe Nummer = Hohe Priorität |
| **Sperre_Prio** | Integer | Priorität des Verbrauchers für Peak-Optimierung, Tiefe Nummer = Hohe Priorität |
| **Is_Peak_Shaving** | Boolean | Vom Manager übermittelter aktueller Betriebsmodus. |
| **Heizungstemperatur** | Float | Aktuelle Heiztemperatur (roh oder geglättet). |
| **Mindesttemperatur** | Integer | Untere Temperaturgrenze. |
| **Maximaltemperatur** | Integer | Obere Temperaturgrenze. |
| **Disable** | Boolean | Freigabe des Verbrauchers. |
| **IdleCounter** | Integer | Interner Zähler für die Sperrzeit. |
| **Leistung_Delta** | Integer | Interne Variable für Leistungsdifferenzen. |
### 7. PHP-Befehlsreferenz
---
## 6. WebFront / Bedienung
Die Temperaturgrenzen sowie die Prioritäten werden über folgende Variablen eingestellt:
`Mindesttemperatur` - Temperatur unter welcher die Heizung zwingend freigegeben wird.
`Maximaltemperatur` - Temperatur bis zu welcher PV-Überschüsse zur Wärmeerzeugung genutzt werden dürfen.
`Disable` - Freigabe des Verbrauchers.
`PV_Prio` - Priorität des Verbrauchers für PV-Optimierung, Tiefe Nummer = Hohe Priorität.
`Sperre_Prio` - Priorität des Verbrauchers für Peak-Optimierung, Tiefe Nummer = Hohe Priorität.
`PowerSteps` - Dem Manager angebotene mögliche Leistungsstufen.
`Aktuelle_Leistung` - Tatsächlich geschaltete Leistung.
`Heizungstemperatur` - Aktuelle Temperatur des Speichers oder Boilers.
---
## 7. Mapping auf Code-Komponenten
| Komponente | Funktion im Code (`module.php`) |
| -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Timer-Registrierung** | `ApplyChanges()` setzt `Timer_Do_UserCalc_Heizung` basierend auf `Interval`. |
| **Leistungsstufen laden** | `LadeUndSortiereLeistungen()` liest und sortiert die konfigurierten Leistungsstufen. |
| **PowerSteps Generierung** | `GetCurrentData($Peak)` erstellt die verfügbaren Leistungsstufen abhängig von Temperatur und Betriebsmodus. |
| **Temperaturglättung** | `GetCurrentData($Peak)` berechnet optional die PT1-gefilterte Temperatur. |
| **Aktive Stufenerkennung** | `IstEineStufeAktiv()` prüft ob aktuell mindestens eine Heizstufe aktiv ist. |
| **Leistungszuteilung** | `SetAktuelle_Leistung($power)` schaltet den zugehörigen Schaltkontakt der angeforderten Leistung. |
| **Kontaktzuordnung** | `GetKontaktIDZuLeistung($leistung)` ermittelt den passenden Schaltkontakt einer Leistungsstufe. |
| **Idle-Logik** | `ProcessIdleCounter()` verwaltet die Sperrzeit zwischen Leistungsänderungen. |
---
## 8. Zukünftige Erweiterungen
`boolean GEF_BeispielFunktion(integer $InstanzID);`
Erklärung der Funktion.
Beispiel:
`GEF_BeispielFunktion(12345);`