Energiediagramm#

Status: Implementiert fuer IP-Symcon 8.0+.

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#

Zeitraeume und Bedienung#

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#

Die HTML-SDK-Kachel enthaelt 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.

Die drei Hintergrundfarben werden in der Instanzkonfiguration unter Hintergrundfarben gewaehlt. Die Schriftfarbe und das Farbschema der nativen Bedienelemente werden aus der Grundfarbe abgeleitet. Gleiche Werte fuer alle drei Farben ergeben einen einfarbigen Hintergrund. Diagrammfarben und Energieberechnung bleiben davon unabhaengig.

Migration: Die Farbauswahlen sind an Integer-Eigenschaften mit dem Suffix RGB gebunden. Symcon 8 interpretiert String-Eigenschaften im Farbfeld nicht korrekt und koennte dadurch beim Speichern auch unveraenderte Farben ueberschreiben. Bestehende Hex-Strings und dezimale Farbstrings werden beim Anwenden der Konfiguration automatisch uebernommen. Die alten String-Eigenschaften bleiben fuer Skripte erhalten und werden bidirektional synchronisiert. Werden beide Darstellungen derselben Farbe gleichzeitig geaendert, hat die numerische Farbauswahl Vorrang. Nicht geaenderte Farben und andere Einstellungen bleiben erhalten. Neue Instanzen verwenden die bisherigen Standardfarben. Bereits durch den alten Formularfehler gespeicherte schwarze Farben werden nicht durch erratene Werte ersetzt. Ungueltige Farbwerte werden als ungueltige Konfiguration behandelt; die Visualisierung verwendet fuer die betroffene Farbe den sicheren Standard. Es werden keine Zaehler, Archivdaten oder sonstigen Symcon-Objekte veraendert.

In IP-Symcon 8.x kann der vom Client angebotene Vergroesserungsdialog leer bleiben; dort die normale Kachel verwenden. Der zusaetzliche HTML-SDK- Vollbildmodus wird vom Modul erst ab Kernelversion 9.0 aktiviert.

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.

Gesamtbilanz inklusive Speicher/SDL#

Gesamtbilanz=true berechnet den bilanziellen Gesamtverbrauch aus max(0, Produktion + Netzbezug - Einspeisung). Die drei Quellen muessen dieselbe Anlage und denselben Zeitraum abdecken. Physische Netzzaehler enthalten Speicher-/SDL-Fluesse bereits. Separate Lade- oder Entladezaehler werden nicht zusaetzlich auf Netzbezug oder Einspeisung addiert; Produktion bleibt die konfigurierte Produktionsquelle, keine aus Speicherentladung erfundene PV-Energie.

Der optionale Hauszaehler bleibt gespeichert, wird in diesem Modus aber weder gelesen noch validiert. Auch EnergieanteileBerechenbar=false aus einer frueheren SDL-Sperre blockiert die Gesamtbilanz nicht. Ohne Gesamtbilanz gelten beide Einstellungen wieder unveraendert.

Die Anzeige nennt den Wert Gesamtverbrauch und kennzeichnet beide Quoten als bilanziell. Eigenverbrauch ist min(Produktion, max(0, Gesamtverbrauch - Netzbezug)); die Quoten teilen ihn durch Produktion bzw. Gesamtverbrauch. Bei Nenner 0 gilt 0 %. Das ist keine Herkunftszuordnung und kein Nachweis fuer reinen PV-Eigenverbrauch oder physische Hausautarkie. Dieser Netto-Bilanzwert ist nicht der Bruttoverbrauch aller Verbraucher: Entladung vorher gespeicherter Energie senkt ihn. Uebersteigt die Einspeisung Produktion plus Netzbezug, werden Gesamtverbrauch und Quoten auf 0 begrenzt; der negative Saldo und seine Hoehe werden ausdruecklich als Hinweis angezeigt.

Beispiel: 155.35 kWh Produktion, 21.55 kWh Netzbezug und 12.90 kWh Einspeisung ergeben 164.00 kWh Gesamtverbrauch, 91.7 % bilanzielle Eigenverbrauchsquote und 86.9 % bilanziellen Autarkiegrad. Ein Hauszaehler von 165.11 kWh wird nicht mit den anderen Messgrenzen vermischt.

Migration und Rueckwechsel#

Zuerst Utils aktualisieren, danach den aktualisierten EMS-Manager anwenden. Dieser aktiviert Gesamtbilanz an seinem Energy Pie unabhaengig von SDL. Bei eigenstaendigen Instanzen bleibt der bisherige Modus Standard. Farben, Quellen-IDs und Archivdaten bleiben erhalten; keine Zaehler zuruecksetzen. Alte Zeitraeume werden aus den vorhandenen drei Zaehlern neu ausgewertet. Fehlende Pflichtquellen oder Archivwerte ergeben keine vorgetaeuschten 0-%-Werte. Ein manueller Rueckwechsel an einem vom Manager verwalteten Pie wird beim naechsten Anwenden des Managers wieder auf Gesamtbilanz synchronisiert.

Adaption aus Enelix 1#

Nicht bestimmbare Energieanteile#

Bei false bleiben die verfügbaren Energiezähler und ihre Summen sichtbar, während die nicht bestimmbaren Anteile ausdrücklich als unbekannt erscheinen. Unbekannt ist weder 0 % noch 100 %. Dies ist beispielsweise bei einem Netzbezug notwendig, der zusätzlich einen getrennten SDL-Speicher versorgt, während die Hausenergie diesen Zweig bereits ausschliesst. Utils trifft keine EMS-spezifische Bilanzentscheidung; ein übergeordneter Manager kann die Property passend setzen.

Beispiel: Netzbezug 20 kWh und separat gemessener Hausverbrauch 10 kWh erlauben bei weiteren Speicherflüssen keine eindeutige Haus-Autarkiequote. Nicht mit max(0, ...) einen scheinbar gültigen Prozentwert erzwingen.

Der Stand 5b6125d erhält die vorbereitete Energy-Pie-Gestaltung und macht unbestimmbare Anteile sichtbar. Vorherige Korrekturen betreffen Symcon-8- Farbwerte, Kopfabstand, Vollbild und lesbare Zeitraum-/Datumsauswahl. Seit 2ce95e7 sind Grundfarbe, beide Akzente und beide Diagrammfarben konfigurierbar. Die dunkle Energy-Pie-Darstellung ist nur der Standard; ältere Aussagen zur erzwungenen Dunkeldarstellung oder vollständigen Übernahme des Kachelthemas beschreiben nicht den neuesten Stand.

Beispiel: Farbänderung und Migration#

Für einen einfarbigen Hintergrund in den drei nativen Hintergrund-Farbfeldern denselben Wert auswählen und die Konfiguration anwenden. Das beeinflusst weder die Diagrammfarben noch Zähler oder Archivdaten. Vorherige Werte für einen Rückwechsel notieren; ein Zählerreset ist dafür nicht erforderlich.

Für bestehende Skripte gilt: Wird nur FarbeHintergrund geändert, wird dessen gültiger Stringwert beim Anwenden nach FarbeHintergrundRGB übertragen. Werden beide Repräsentationen gleichzeitig unterschiedlich geändert, gewinnt die Integer-Property. Bei einem ungewollt schwarzen Altwert die gewünschte Farbe gezielt wieder wählen; die Migration rekonstruiert keine verlorene Farbhistorie.

Das Modul legt keine fest registrierten Mess- oder Bedienvariablen unter der Instanz an. Es liest die konfigurierten Zähler und bedient die HTML-SDK-Ansicht. Die Zähler-IDs sind Anlagenwerte, keine mitgelieferten Beispiel-IDs.