Energie · PV · Open Source
Zeus Charge Control: PV-Batterie intelligent laden mit dynamischen Strompreisen
Preisfenster erkennen, Ladepläne automatisieren, RSOC & Status im Blick – ein Open-Source-Projekt für PV-Speicher mit Sonnen API v2.
Zeus Charge Control – dynamische Strompreise und Ladeplanung für PV-Speicher im Blick.
Dynamische Stromtarife können richtig interessant sein – aber nur, wenn Verbrauch und Speicher auch in die günstigen Zeitfenster gelegt werden. Genau hier setzt Zeus Charge Control an: Die Anwendung erstellt Ladepläne für PV-Batteriespeicher auf Basis von Marktpreisen, dem aktuellen Batteriestand und optionalen Wetterdaten.
Das Ziel ist simpel: günstig laden, teure Netzphasen vermeiden und jederzeit nachvollziehen können, was die Anwendung gerade plant. Kein „Magie-Button“, sondern konfigurierbare Regeln, transparente Entscheidungen und eine Weboberfläche für Monitoring und Kontrolle.
⚠️ Wichtig vorweg
Zeus Charge Control unterstützt aktuell ausschließlich PV-Batteriespeicher mit Sonnen API v2.
Das Projekt stammt nicht von der Sonnen GmbH, ist kein offizielles Sonnen-Produkt und steht in keinem Affiliate-, Partner- oder Geschäftsverhältnis zur Sonnen GmbH.
Was ist Zeus Charge Control?
Zeus Charge Control ist eine Java-/Spring-Boot-Anwendung zur intelligenten Ladeplanung eines PV-Batteriespeichers. Sie nutzt dynamische Strompreise, den aktuellen Batteriestatus und optional Wetterdaten, um geeignete Ladefenster zu finden.
Die wichtigsten Funktionen
- Monitoring: Anzeige von RSOC, Batteriestatus und Ladeplanung im Web-UI
- Preislogik: Erkennung günstiger Zeitfenster anhand dynamischer Strompreise
- Schwellwerte: Laden nur bis zu einem konfigurierten Maximalpreis
- Nachtfenster: gezielte Planung in frei definierbaren Zeiträumen
- Wetter optional: Open-Meteo kann zur Einschätzung erwarteter PV-Erträge genutzt werden
- Fehlertoleranz: API-Ausfälle werden protokolliert, die Anwendung bleibt stabil
- Web-UI: moderne Oberfläche für Status, Steuerung und Transparenz
Praktisch bedeutet das: Die Anwendung prüft regelmäßig Preis- und Zustandsdaten, bewertet den aktuellen Ladezustand deiner Batterie und plant daraus Ladefenster. Ziel ist nicht maximale Automatisierung um jeden Preis, sondern eine nachvollziehbare und konfigurierbare Unterstützung für den Alltag mit PV-Speicher und dynamischem Stromtarif.
Für wen lohnt sich das?
Zeus Charge Control richtet sich an Nutzerinnen und Nutzer, die einen kompatiblen PV-Batteriespeicher besitzen und dynamische Strompreise aktiv nutzen möchten.
Interessant ist das besonders, wenn du:
- einen dynamischen Stromtarif nutzt, etwa mit stark schwankenden Preisen
- deinen Speicher gezielt in günstigen Zeitfenstern laden möchtest
- teure Netzstromphasen möglichst vermeiden willst
- mehr Transparenz willst als nur „Automatik an / Automatik aus“
- bereit bist, Schwellenwerte, Zeitfenster und Batteriedaten sauber zu konfigurieren
⚠️ Unterstützte Systeme
Aktuell werden ausschließlich PV-Batteriespeicher mit Sonnen API v2 unterstützt.
Andere Speicher, Wechselrichter oder proprietäre Systeme werden nicht automatisch unterstützt.
Status & Verantwortung des Betreibers
⚠️ Produktiver Einsatz ist möglich – aber eigenverantwortlich
Zeus Charge Control kann produktiv eingesetzt werden. Die Verantwortung für Konfiguration, Betrieb, Monitoring und Bewertung der automatisierten Ladeentscheidungen liegt jedoch vollständig beim Betreiber der Installation – also bei dir, wenn du die Anwendung einrichtest, betreibst oder nutzt.
Das ist wichtig, weil die Anwendung aktiv in Ladeentscheidungen eingreifen kann. Falsche Parameter, unvollständige Marktdaten, API-Probleme oder eine unpassende Batteriekonfiguration können dazu führen, dass Ladeentscheidungen wirtschaftlich oder technisch nicht wie erwartet ausfallen.
Kurz gesagt: Zeus Charge Control ist ein Werkzeug. Es ersetzt keine fachliche Prüfung deiner Anlage, keine sorgfältige Konfiguration und kein eigenes Monitoring. Wenn du Zeus Charge Control nutzt, bist du selbst dafür verantwortlich, ob die Einstellungen zu deiner Anlage, deinem Tarif und deinem gewünschten Verhalten passen.
Web-UI & Visualisierungen
Die Anwendung bringt eine Weboberfläche mit, über die Status, erkannte Preisfenster, Ladeplanung und Batteriewerte sichtbar werden. Damit bleibt nachvollziehbar, warum die Anwendung bestimmte Ladefenster bevorzugt.
/charging-statusHier siehst du unter anderem den Batteriestatus, den RSOC, Preisübersichten, erkannte günstige Zeitfenster und geplante Ladeperioden. Je nach Modus können zusätzliche Steuerelemente für manuelle Eingriffe oder Statuskontrolle sichtbar sein.
Steuerelemente & Dashboard
So arbeitet die Lade-Logik
Die Ladeplanung basiert auf einer Kombination aus Batteriestatus, Preisfenstern und konfigurierbaren Regeln. Dadurch bleibt das Verhalten nachvollziehbar und kann an den eigenen Haushalt angepasst werden.
Das Grundprinzip
- Batteriestand prüfen: Der aktuelle RSOC wird ausgelesen.
- Zielwert vergleichen: Ist der Ziel-Ladezustand bereits erreicht, wird nicht weiter geladen.
- Preise laden: Marktdaten werden z. B. über aWATTar oder Tibber eingelesen.
- Günstige Zeitfenster erkennen: Die Anwendung sucht passende Zeiträume innerhalb deiner Vorgaben.
- Regeln anwenden: Preisgrenzen, Flexibilität, Nachtfenster und Batterielimits werden berücksichtigt.
- Ladeplan erstellen: Die geplanten Ladezeiten werden im Web-UI sichtbar gemacht.
Was bedeutet RSOC?
RSOC steht für Relative State of Charge. Gemeint ist der aktuelle Ladezustand der Batterie in Prozent. Ein RSOC von 50 % bedeutet also: Die Batterie ist ungefähr zur Hälfte geladen. Ein RSOC von 90 % bedeutet: Die Batterie ist fast voll und aktives Nachladen ist je nach Konfiguration nicht mehr nötig.
Typisches Szenario
- Der RSOC liegt unter deinem Zielwert, zum Beispiel unter 90 %.
- Für die nächsten Stunden wird wenig PV-Ertrag erwartet.
- Im Nachtfenster gibt es sehr günstige Strompreise.
- Zeus Charge Control plant ein oder mehrere Ladefenster innerhalb des erlaubten Zeitraums.
Setup: Build & Start
📦 Open Source aus dem Quellcode
Zeus Charge Control wird als Open-Source-Projekt bereitgestellt. Du baust und startest die Anwendung lokal aus dem Quellcode.
Voraussetzungen
- Java 21
- Maven 3.9+
- Netzwerkzugriff auf den kompatiblen PV-Batteriespeicher
- korrekt konfigurierte Zugangsdaten für die Sonnen API v2
Build
mvn clean verifyStart während der Entwicklung
mvn spring-boot:runStart als JAR
java -jar target/zeus-power-control-3.0-RELEASE.jarNach dem Start erreichst du das Web-UI typischerweise hier:
http://localhost:8080/charging-statusAuch beim technischen Betrieb gilt: Wenn du die Anwendung auf einem Server, Mini-PC oder anderen System dauerhaft laufen lässt, bist du als Betreiber für die Umgebung, Updates, Verfügbarkeit, Logs und Kontrolle der Ladeentscheidungen verantwortlich.
Konfiguration: wichtigste Parameter
Die Anwendung wird über Konfigurationsdateien und/oder Umgebungsvariablen eingerichtet. Entscheidend ist, dass die Werte zur realen Anlage passen.
Beispiel für zentrale Batterieparameter
battery.url=${BATTERY_URL:}
battery.authToken=${BATTERY_AUTH_TOKEN:}
battery.inverter.max.watts=${BATTERY_INVERTER_MAX_WATTS:4600}
battery.max.capacity.wh=${BATTERY_MAX_CAPACITY_WH:10000}Was bedeuten diese Werte?
- battery.url: Adresse deiner Batterie bzw. API-Schnittstelle im Netzwerk.
- battery.authToken: Token für den Zugriff auf die Batterie-API.
- battery.inverter.max.watts: maximale Lade-/Wechselrichterleistung in Watt.
- battery.max.capacity.wh: nutzbare bzw. konfigurierte Batteriekapazität in Wattstunden.
⚠️ Keine Beispielwerte blind übernehmen
Die genannten Werte sind Beispiele. Sie müssen zu deiner konkreten Batterie, deinem Wechselrichter und deiner Installation passen. Falsche Werte können zu unpassenden Ladeentscheidungen führen. Als Betreiber bist du dafür verantwortlich, diese Angaben vor dem Einsatz zu prüfen und sinnvoll zu setzen.
An die eigene Batterie anpassen
Dieser Punkt ist besonders wichtig: Zeus Charge Control kann nur dann sinnvoll planen, wenn die Batteriedaten korrekt konfiguriert sind.
Warum ist das so wichtig?
- Die Anwendung muss wissen, wie groß dein Speicher tatsächlich ist.
- Die maximale Ladeleistung muss zur Anlage passen.
- Der aktuelle RSOC muss zuverlässig ausgelesen werden können.
- Die API-Verbindung muss stabil erreichbar sein.
Wenn zum Beispiel eine falsche Batteriekapazität eingetragen ist, kann die Ladeplanung zu optimistisch oder zu vorsichtig ausfallen. Auch eine falsch gesetzte maximale Ladeleistung kann dazu führen, dass geplante Zeitfenster in der Praxis nicht ausreichen.
Die Anpassung an deine reale Batterie ist daher kein optionaler Feinschliff, sondern eine Grundvoraussetzung für sinnvollen Betrieb. Wenn du Zeus Charge Control einsetzt, bist du als Betreiber dafür verantwortlich, dass Kapazität, Ladeleistung, API-Zugriff und Zielwerte zur tatsächlichen Anlage passen.
Troubleshooting & typische Stolperfallen
Die häufigsten Ursachen für Probleme
- Batterie nicht erreichbar: Netzwerk, Firewall, VPN oder falsche IP-Adresse prüfen.
- Token oder URL falsch: Authentifizierungsfehler erscheinen in den Logs.
- Preisdaten fehlen: Provider-Timeouts oder API-Probleme können einzelne Läufe beeinflussen.
- Zeitzone oder Nachtfenster unpassend: Die Planung wirkt dann zeitlich „verschoben“.
- Batteriekapazität falsch gesetzt: Ladefenster passen nicht zur realen Anlage.
- Maximale Ladeleistung falsch gesetzt: Die Anwendung plant mit unrealistischen Ladezeiten.
Die Anwendung ist so gedacht, dass einzelne API-Ausfälle nicht sofort alles lahmlegen. Trotzdem gilt: Automatisierte Ladeentscheidungen sollten gerade am Anfang regelmäßig geprüft werden.
Als Betreiber bist du dafür verantwortlich, Logs, Verhalten und Ladeentscheidungen zu kontrollieren – besonders nach Updates, Konfigurationsänderungen oder Änderungen an Tarif, Speicher oder Netzwerk.
FAQ
Ist Zeus Charge Control ein offizielles Sonnen-Produkt?
Nein. Zeus Charge Control ist ein unabhängiges Open-Source-Projekt und steht in keiner Verbindung zur Sonnen GmbH.
Welche Batteriespeicher werden unterstützt?
Aktuell ausschließlich PV-Batteriespeicher mit Sonnen API v2.
Kann ich das dauerhaft auf einem Server laufen lassen?
Technisch ja. Die Verantwortung für sicheren und sinnvollen Betrieb liegt beim Betreiber der Installation – also bei dir, wenn du Zeus Charge Control nutzt. Dazu gehören korrekte Konfiguration, Monitoring und regelmäßige Prüfung der Ladeentscheidungen.
Was wird automatisch entfernt oder beendet?
Die Anwendung kann geplante oder aktive Ladezustände beenden bzw. nicht weiter fortsetzen, wenn der konfigurierte Ziel-RSOC erreicht ist oder Regeln nicht mehr erfüllt sind. Gemeint ist also nicht das Löschen von Daten, sondern das automatische Beenden oder Verwerfen nicht mehr sinnvoller Ladeentscheidungen.
Was ist RSOC?
RSOC bedeutet Relative State of Charge und beschreibt den aktuellen Ladezustand der Batterie in Prozent.
Welche Preisquellen werden genutzt?
Je nach Konfiguration können Marktpreise beispielsweise über aWATTar oder Tibber genutzt werden. Zusätzlich können optionale Wetterdaten über Open-Meteo eingebunden werden.
Was passiert, wenn die Batterie offline ist?
Die Anwendung protokolliert den Fehler und versucht es beim nächsten Lauf erneut. Trotzdem solltest du als Betreiber prüfen, warum die Batterie nicht erreichbar ist und ob dadurch Ladeentscheidungen beeinflusst wurden.
Disclaimer & Haftungsausschluss
⚠️ Keine Rechtsberatung
Dieser Abschnitt ist ein allgemeiner Hinweistext und keine Rechtsberatung. Für eine verbindliche rechtliche Prüfung sollte eine entsprechend qualifizierte Stelle hinzugezogen werden.
Keine Verbindung zur Sonnen GmbH
Zeus Charge Control ist ein unabhängiges Open-Source-Projekt. Es steht in keiner Verbindung zur Sonnen GmbH.
- Die Software wurde nicht von der Sonnen GmbH entwickelt.
- Die Software wird nicht von der Sonnen GmbH bereitgestellt.
- Die Software wird nicht von der Sonnen GmbH unterstützt.
- Es besteht kein offizielles Produkt-, Partner-, Affiliate- oder Geschäftsverhältnis.
Alle Marken-, Produkt- und Firmennamen sind Eigentum der jeweiligen Rechteinhaber. Die Nennung dient ausschließlich der technischen Einordnung kompatibler Schnittstellen.
Nutzung auf eigene Verantwortung
Die Nutzung dieser Software erfolgt auf eigene Verantwortung. Der Betreiber der Installation – also du als Nutzerin oder Nutzer der Anwendung – ist selbst verantwortlich für Konfiguration, Betrieb, Überwachung und Bewertung der automatisierten Ladeentscheidungen.
Automatisierte Steuerungen können zu unerwartetem Verhalten führen, insbesondere bei fehlerhaften Einstellungen, unvollständigen Marktdaten, API-Ausfällen, Kommunikationsproblemen oder falsch hinterlegten Batteriewerten.
Keine Gewährleistung
Die Software wird ohne Gewährleistung bereitgestellt. Es wird insbesondere keine Gewähr übernommen für:
- Richtigkeit, Vollständigkeit oder Aktualität von Marktdaten
- Verfügbarkeit externer APIs oder Dienste
- fehlerfreie Funktion der Software
- wirtschaftliche Vorteile oder Einsparungen
- Eignung für einen bestimmten technischen oder wirtschaftlichen Zweck
Haftungsausschluss
Soweit gesetzlich zulässig, ist eine Haftung für Schäden ausgeschlossen, die durch Nutzung, Fehlkonfiguration, Fehlinterpretation von Daten oder automatisierte Ladeentscheidungen entstehen. Dies gilt insbesondere für materielle, immaterielle, technische oder wirtschaftliche Schäden.
Eine Haftung bei Vorsatz oder grober Fahrlässigkeit bleibt unberührt.
Kein Einsatz in sicherheitskritischen Bereichen
Zeus Charge Control ist nicht für sicherheitskritische Anwendungen vorgesehen. Der Einsatz erfolgt ausschließlich in Eigenverantwortung des Betreibers.
Projektlinks
- GitHub Source Code: https://github.com/gzeuner/zeus-charge-control
- Lizenz: Apache License 2.0
Weitere Informationen
- Maven & pom.xml erklärt: https://tiny-tool.de/maven-und-die-pom-xml/
Image licensed by Ingram Image/adpic