Enelix Utils#

Unabhaengige Zusatzmodule fuer IP-Symcon. Dieses Repository ist nicht vom Enelix EMS abhaengig; auch die Utils-Module werden untereinander nicht gekoppelt.

Status#

Dokumentationsabgleich: 8. Oktober 2026. Funktionsstände vor dieser reinen Dokumentationsänderung:

Stable enthält die nachfolgend beschriebenen Module noch nicht. Die Kanalbezeichnung allein ist keine Freigabe einer Funktion. Referenzen immer aus dem zum installierten Code passenden Branch lesen.

Version 0.1 Build 1 ist die erste Beta fuer kontrollierte Anlagen- und Feldtests. Verbrauchskostenreport, Virtuelle Batterie, CC100 Hardware, Energiediagramm, VGT-Schnittstelle und Shelly Modul sind als installierbare IP-Symcon-Module enthalten. Produktiver Einsatz setzt eine anlagenspezifische Pruefung und Sicherung voraus.

Module#

• Verbrauchskostenreport (implementiert)
• Virtuelle Batterie (implementiert)
• CC100 Hardware (implementiert)
• Energiediagramm (implementiert)
• VGT-Schnittstelle (implementiert)
• Shelly Modul (implementiert)

Die vollständigen Tabellen mit Properties, Variablen, Verhalten und offenen Punkten stehen in der Modulübersicht.

Prognose, Lizenzierung und Störüberwachung sind keine Module dieses Repositories. Die Utils-Module bleiben auch untereinander unabhängig.

Release-Hinweise#

Die Aenderungen der ersten Beta stehen im Changelog.

Neuere Korrekturen dokumentieren zusätzlich nicht bestimmbare Energieanteile im Energiediagramm, den Erhalt der Energy-Pie-Gestaltung und korrigierte Bibliotheksmetadaten. Die fünf Farben des Energiediagramms sind mit nativen Integer-Farbfeldern konfigurierbar; alte Stringfarben werden synchronisiert. Bereits fehlerhaft gespeicherte Farben werden nicht erraten. Bei EnergieanteileBerechenbar=false bleiben Zähler sichtbar, während Autarkie und Eigenverbrauch nicht als erfundene Prozentwerte erscheinen. Die vollständigen Variablen der virtuellen Batterie und VGT- Schnittstelle sowie dynamische CC100-/Shelly-Datenpunkte stehen in den Modulreferenzen.

Die Portal-Dokumentation zeigt ihren Quellkanal und ihre Commitstände. Sie ist kein automatisches Modulupdate. Für SDL-Anzeigen den passenden Utils-Stand vor EMS installieren.

Bekannte Grenzen sind weiterhin die separat erforderliche Geräte-/Feldabnahme, modellierte statt unabhängig gemessene EV-/SDL-Teilströme bei gegenläufigen Aufträgen und ausschliesslich Symcon-abhängige Software-Timeouts. CC100- Hardwarepfade/Firmware und Shelly-Gen2/3/4-Geräte müssen zur Installation passen; Shelly Gen1 ist nicht implementiert. Fehlende Archivdaten erzeugen keine belastbare Energiebilanz. Die jeweiligen Module beschreiben Diagnose und Inbetriebnahme; es gibt keinen aus der Dokumentationsprüfung abgeleiteten pauschalen Fehlerfreiheits- oder Produktionsnachweis.

Voraussetzungen#

• IP-Symcon ab Version 8.0
• Netzwerkzugriff der IP-Symcon-Installation auf das Gitea-Repository
• PHP ab Version 8.0 fuer die Entwicklungstests

Installation in IP-Symcon#

Das Repository wird über die IP-Symcon-Modulverwaltung installiert:

1. In der Verwaltung Module öffnen und ein neues Modul hinzufügen.
2. Als Repository-URL https://git.belevo.ch/ENELIX/Enelix-Utils.git eintragen.
3. Den zur Umgebung passenden Branch auswählen.
4. Prüfen, dass Enelix Utils ohne Warnsymbol angezeigt wird und URL sowie Branch in der Modulübersicht sichtbar sind.

Zugangsdaten werden außerhalb des Repositories in der Laufzeitumgebung konfiguriert. Tokens oder Passwörter gehören weder in die Repository-URL noch in Konfigurationsdateien oder Logs.

Für Entwicklung und Integrationstests ist develop zu verwenden. Das Repository darf nicht manuell nach data/modules/Enelix-Utils kopiert werden, da IP-Symcon sonst URL, Branch und Aktualisierungsstatus nicht verwalten kann.

Aktualisierung und Prüfung#

Aktualisierungen werden ausschließlich über die IP-Symcon-Modulverwaltung bezogen. Nach einem Branchwechsel oder Update müssen alle implementierten Module geladen sein:

• CC100 Hardware
• Energiediagramm
• Shelly Modul
• VGT-Schnittstelle
• Verbrauchskostenreport
• Virtuelle Batterie

Ein korrekter Zustand zeigt die Repository-URL, den ausgewählten Branch und kein Warnsymbol bei Enelix Utils.

Fehlerbehebung#

Wenn URL und Branch fehlen oder ein Warnsymbol erscheint, wurde die Bibliothek möglicherweise nur als Ordner kopiert. In diesem Fall vor Änderungen bestehende Modulinstanzen und Konfigurationen sichern. Anschließend die fehlerhafte Bibliothek über die Modulverwaltung entfernen und mit der oben genannten URL neu installieren. Das manuelle Löschen des Modulordners ist kein regulärer Installations- oder Aktualisierungsweg.

Entwicklung und Tests#

composer install
composer check
python3 tests/check_documentation.py

Neue oder geaenderte Funktionen werden zusammen mit ihren PHPUnit-Tests eingecheckt. Jedes Modul besitzt zusätzlich einen eigenständigen Laufzeittest für IP-Symcon 8.x. Einzel-, Änderungs- und Gesamtläufe sowie Cleanup und Berichte sind im Testleitfaden beschrieben. Die CI-Pruefung muss vor der Uebernahme in einen Freigabebranch erfolgreich sein.