feat: Energiediagramm adaptieren
Tests / test (push) Successful in 51s

This commit is contained in:
dh
2026-09-27 08:48:59 +00:00
parent 75650c0621
commit db704dd011
16 changed files with 1576 additions and 30 deletions
+49 -19
View File
@@ -1,29 +1,59 @@
# Energiediagramm
> Status: Diskussionsentwurf. Übernimmt `Energy_Pie` ohne EMS-Abhängigkeit.
> Status: Implementiert fuer IP-Symcon 8.0+.
Der Zeitraum wird einstellbar. Öffnen beziehungsweise Aufklappen aktualisiert
dieselbe Darstellung wie die bestehende Aktualisieren-Aktion.
## Variablen
Keine klassischen Pflichtvariablen. Energiewerte und Auswahl erscheinen in der
individuellen Darstellung; Zeitraum und Datum bleiben intern gespeichert.
Das Modul adaptiert `Energy_Pie` als unabhaengiges Enelix-Utils-Modul. Es
wertet fortlaufende Energiezaehler aus dem IP-Symcon-Archiv aus und zeigt die
Energiebilanz sowie Eigenverbrauchsquote und Autarkiegrad in einer individuellen
HTML-SDK-Darstellung.
## Properties
| Ident | Typ | Standard / Beschreibung |
| --- | --- | --- |
| `ProduktionZaehlerID` | Integer | `0`; alt `VarProduction`. |
| `VerbrauchZaehlerID` | Integer | `0`; alt `VarConsumption`. |
| `EinspeisungZaehlerID` | Integer | `0`; alt `VarFeedIn`. |
| `NetzbezugZaehlerID` | Integer | `0`; alt `VarGrid`. |
| `Zaehlerfaktor` | Float | `1`; auf kWh normieren. |
| `Standardzeitraum` | String/Auswahl | `Tag`; Tag, Woche, Monat, Jahr oder Gesamt. |
| `Aktualisierungsintervall` | Integer | `60` s. |
| `ProduktionZaehlerID` | Integer | Pflichtquelle fuer produzierte Energie |
| `EinspeisungZaehlerID` | Integer | Pflichtquelle fuer eingespeiste Energie |
| `NetzbezugZaehlerID` | Integer | Pflichtquelle fuer bezogene Energie |
| `VerbrauchZaehlerID` | Integer | Optionale direkte Hausverbrauchsquelle |
| `Zaehlerfaktor` | Float | `1.0`; gemeinsamer Faktor auf kWh |
| `Standardzeitraum` | String | `day`; Tag, Woche, Monat, Jahr oder Gesamt |
| `Aktualisierungsintervall` | Integer | `60 s`; 10 bis 3600 Sekunden |
| `FarbeEigenverbrauch` | String | Farbe der Eigenverbrauchsquote |
| `FarbeAutarkie` | String | Farbe des Autarkiegrads |
| `Debug` | Boolean | Zusaetzliche Diagnoseausgaben |
## Verhalten und offene Punkte
## Zeitraeume und Bedienung
- Nutzt Energiezähler und Symcon-Archivdaten.
- Fehlende Historie darf nicht als echter Nullverbrauch dargestellt werden.
- Aktualisierung beim Öffnen in den verfügbaren Symcon-Visualisierungen testen.
Die Visualisierung bietet Tag, Woche, Monat, Jahr, Gesamt und Datumsbereich.
Der freie Datumsbereich umfasst Start- und Enddatum jeweils vollstaendig. Fuer
die Kalenderzeitraeume kann vor- und zuruecknavigiert oder direkt zum aktuellen
Zeitraum gesprungen werden. Zukuenftige Datumswerte werden nicht akzeptiert.
## Darstellung
Kachel und vergroesserte Ansicht enthalten bereits beim ersten HTML-Aufbau
einen vollstaendigen Datenstand. Ein nachgelagertes Refresh aktualisiert die
Werte; beim erneuten Sichtbarwerden wird ebenfalls aktualisiert. Das
Diagrammraster zeigt bei ausreichender Breite zwei Kreisdiagramme nebeneinander
und bei geringer Breite automatisch untereinander.
## Daten und Fehlerverhalten
Die drei Pflichtzaehler muessen numerisch und im Archiv vorhanden sein. Der
Hausverbrauch wird aus einer optionalen direkten Quelle gelesen oder aus
Produktion minus Einspeisung plus Netzbezug berechnet. Bei fehlendem Archiv
oder fehlenden Werten zeigt die Darstellung einen Diagnosehinweis statt einer
leeren Flaeche.
## Adaption aus Enelix 1
| Bereich | Behandlung |
| --- | --- |
| Archivierte Produktions-, Einspeise- und Netzbezugszaehler | angepasst uebernommen |
| Tag, Woche, Monat, Jahr und Gesamt | uebernommen |
| Frei waehlbarer Datumsbereich | neu implementiert |
| Standardzeitraum in der Konfiguration | neu implementiert |
| Farben der Kreisdiagramme | neu konfigurierbar |
| Vergroesserte Ansicht | mit eingebetteten Initialdaten stabilisiert |
| Starres Zwei-Spalten-Layout | durch responsives Raster ersetzt |
| Erzwungener Sprung auf Heute beim Laden | verworfen |
+3 -3
View File
@@ -1,14 +1,14 @@
# Modulübersicht Enelix Utils
> Status: Verbrauchskostenreport und Shelly Modul sind implementiert. Die
> übrigen Module sind als Diskussionsentwürfe dokumentiert.
> Status: Verbrauchskostenreport, Energiediagramm und Shelly Modul sind
> implementiert. Die übrigen Module sind als Diskussionsentwürfe dokumentiert.
| Modul | Herkunft | EMS-Abhängigkeit |
| --- | --- | --- |
| [Verbrauchskostenreport](Verbrauchskostenreport/README.md) | Kosten- und Verbrauchsauswertung | Keine |
| [Virtuelle Batterie](Virtuelle-Batterie/README.md) | Bat_EV_SDL_V4 | Optionaler Vertrag, keine Code-Abhängigkeit |
| [CC100 Hardware](CC100-Hardware/README.md) | CC100_HW | Keine |
| [Energiediagramm](Energiediagramm/README.md) | Energy_Pie | Keine |
| [Energiediagramm](Energiediagramm/README.md) | Energy_Pie (implementiert) | Keine |
| [VGT-Schnittstelle](VGT-Schnittstelle/README.md) | MQTTPVSDL + MQTTBatterySDL | Optional konfigurierbar |
| [Shelly Modul](Shelly-Modul/README.md) | Shelly_Parser_MQTT | Keine |