SAX Power Adapter – Tester gesucht (v1.0.0)

TobStar

Hallo zusammen,

nach einigen Wochen Entwicklung möchte ich heute die erste öffentliche Version meines SAX Power Adapters für ioBroker vorstellen.

Der Adapter befindet sich aktuell in der Version 1.0.0 und ich würde mich freuen, wenn ihn einige von euch testen könnten.

Aktueller Funktionsumfang

automatische Erkennung aller SAX Power Systeme
Live-Daten
historische Statistiken
aggregierte Werte über mehrere Geräte
moderne React-Adminoberfläche
optionale Modbus-Steuerung

Der Adapter wurde bereits unter Linux, Windows und macOS getestet und läuft erfolgreich mit Node.js 20, 22 und 24.

Besonders interessant

Da ich selbst nur einen Speicher besitze, würde ich mich besonders über Rückmeldungen von Anwendern freuen, die

mehrere SAX Power Speicher
mehrere Standorte
oder mehrere Wechselrichter

betreiben.

Gerade die Aggregation mehrerer Geräte konnte ich nur anhand der API und der vorhandenen Dokumentation entwickeln und würde diese gerne unter realen Bedingungen validieren.

Feedback

Mich interessieren insbesondere

Fehler
Verbesserungsvorschläge
fehlende Werte
Performance
Wünsche für zukünftige Versionen

Screenshots und Logauszüge helfen natürlich ebenfalls sehr.

Projekt

GitHub:

https://github.com/GodHunter/ioBroker.sax-power

npm:

https://www.npmjs.com/package/iobroker.sax-power

Vielen Dank an alle Tester! 😊

mcm1957

DANKE für deine Arbeit

Hab mal für eine etsten Check den Tepochecker vorbei geschickt. Fall was unklat ist bitte melden - vorzugsweise in unseren Telgramm / Discord channels. In ites auf www.iobroker.dev.

@homoran
Da der Adapter naturgemäss noch nicht im Repository ist bitte in "... nicjt im offiziellen Repository" verschieben. DANKE

TobStar

ioBroker.sax-power 1.2.0 – Batteriezyklen, Gesundheitsstatus und neue Admin-Oberfläche

Hallo zusammen,

seit der ersten Veröffentlichung des SAX-Power-Adapters sind mehrere Aktualisierungen erschienen. Mit Version 1.2.0 ist nun wieder eine größere funktionale Erweiterung hinzugekommen.

Inzwischen ist außerdem Version 1.2.1 verfügbar. Dabei handelt es sich ausschließlich um eine Wartungsversion mit aktualisierten Projekt-, Repository- und Paketinformationen. Die nachfolgend beschriebenen Funktionen entsprechen daher auch dem aktuellen Stand von Version 1.2.1.

Verbesserungen seit der ersten Veröffentlichung

Die Versionen 1.0.1, 1.1.0, 1.1.1 und 1.1.2 konzentrierten sich überwiegend auf Wartung, Kompatibilität und Fehlerbehebungen.

Dabei wurden unter anderem:

die Kompatibilität mit Node.js 22 und aktuellen ioBroker-Anforderungen verbessert,
Installationen direkt aus GitHub zuverlässiger gemacht,
Build-, Paket- und Repository-Konfigurationen bereinigt,
Passwortschutz und Timeout-Behandlung korrigiert,
Fehlermeldungen bei Cloud-, Netzwerk- und Anmeldeproblemen verständlicher gestaltet,
Projekt-, Kontakt- und Spendeninformationen berichtigt.

Die grundlegende Arbeitsweise des Adapters wurde durch diese Versionen nicht verändert.

Batterieinformationen und äquivalente Vollzyklen

Für jeden automatisch über die SAX-Power-Cloud erkannten Speicher kann nun das verwendete Batteriemodell ausgewählt werden.

Aktuell werden folgende Modelle unterstützt:

Modell	Nennkapazität	Nutzbare Kapazität
SAX Power Home 5,8 kWh	5,76 kWh	5,20 kWh
SAX Power Home Plus 7,7 kWh	7,68 kWh	7,00 kWh

Die SAX-Power-Cloud liefert derzeit keine ausreichend zuverlässige Modellkennung. Der Adapter erkennt deshalb die vorhandenen Speicher und deren Seriennummern automatisch, überlässt die Zuordnung des passenden Modells aber bewusst dem Anwender.

Ohne Modellzuordnung werden kapazitätsabhängige Werte nicht berechnet. Der Adapter versucht also nicht, ein Modell zu erraten.

Anhand der jeweiligen Nennkapazität und der von SAX bereitgestellten historischen Energiewerte berechnet der Adapter äquivalente Vollzyklen für:

heute,
die aktuelle Woche,
den aktuellen Monat,
das aktuelle Jahr,
den gesamten in der SAX-Power-Cloud verfügbaren Zeitraum.

Die Berechnung erfolgt nach folgender Formel:

Vollzyklen =
(geladene Energie + entladene Energie)
÷ (2 × nominale Batteriekapazität)

Zusätzlich wird der von SAX direkt gemeldete Gesamtzykluszähler separat angezeigt. Dadurch bleiben der interne SAX-Zähler und die vom Adapter aus den historischen Energiewerten berechneten Vollzyklen transparent voneinander getrennt.

Abweichungen zwischen beiden Werten können beispielsweise durch Rundungen, fehlende Cloud-Historie, AC-Wandlungsverluste oder nicht dokumentierte interne Berechnungsregeln von SAX entstehen.

Anlagen mit mehreren Speichern

Auch Installationen mit mehreren SAX-Power-Speichern werden berücksichtigt.

Die Zyklen der einzelnen Speicher werden dabei nicht einfach addiert. Stattdessen berechnet der Adapter einen kapazitätsgewichteten Wert aus dem gesamten Energiedurchsatz und der gesamten installierten Nennkapazität:

Vollzyklen der Anlage =
Summe aus geladener und entladener Energie aller Speicher
÷ (2 × gesamte Nennkapazität aller Speicher)

Damit beschreibt der zusammengefasste Wert die äquivalenten Vollzyklen der gesamten Speicheranlage.

Voraussetzung ist, dass jedem erkannten Speicher ein Modell zugeordnet wurde. Fehlt eine Zuordnung, bleibt der zusammengefasste kapazitätsabhängige Wert zunächst leer.

Geschätzte Batteriegesundheit

Version 1.2.0 enthält außerdem eine transparente Schätzung der Batteriegesundheit.

Die SAX-Power-Cloud stellt keinen dokumentierten State-of-Health-Wert des Batteriemanagementsystems bereit. Der Adapter bezeichnet seinen Wert deshalb ausdrücklich als geschätzte Batteriegesundheit und nicht als BMS-SoH.

Die Schätzung basiert auf geeigneten realen Entladevorgängen. Dabei wird die vom Adapter aus der gemeldeten Batterieleistung ermittelte entladene Energie mit der anhand des SOC-Verlaufs erwarteten nutzbaren Energie verglichen.

Ein Entladevorgang wird unter anderem nur dann berücksichtigt, wenn:

sich der Speicher tatsächlich entlädt,
der Verlauf mindestens 40 SOC-Prozentpunkte umfasst,
die Messabstände nicht größer als 15 Minuten sind,
keine unplausiblen SOC-Sprünge auftreten,
eine ausreichende Batterieleistung gemessen wird,
das Ergebnis innerhalb festgelegter Plausibilitätsgrenzen liegt.

Kurze, unterbrochene oder unplausible Verläufe werden verworfen. Ladevorgänge werden zwar für die Fortschrittsanzeige erkannt, aber nicht zur Kapazitätsschätzung verwendet, da Ladeverluste das Ergebnis verfälschen würden.

Nach fünf gültigen Entladevorgängen veröffentlicht der Adapter den Median der letzten fünf Einzelwerte. Der Median reduziert den Einfluss einzelner ungewöhnlich hoher oder niedriger Messungen.

Bis genügend geeignete Messungen vorliegen, bleibt der eigentliche Prozentwert leer. Gleichzeitig zeigt der Adapter nachvollziehbar den aktuellen Status an, beispielsweise:

Datenbasis wird aufgebaut,
noch nicht genügend geeignete Messungen,
Schätzung verfügbar.

Zusätzlich werden unter anderem angezeigt:

gültige Messläufe,
benötigte Messläufe,
verworfene Messläufe,
Fortschritt des aktuell beobachteten Verlaufs,
Beginn der Datensammlung,
Zeitpunkt der letzten Auswertung.

Der Fortschritt wird dauerhaft in ioBroker gespeichert. Die Sammlung beginnt nach einem Neustart des Adapters deshalb nicht wieder von vorn.

Wichtig: Die Gesundheitsbewertung wird aus den laufend erfassten Live-Werten gebildet. Bereits vorhandene historische Cloud-Daten können dafür nicht nachträglich verwendet werden, da sie nicht die notwendige zeitliche Auflösung besitzen.

Die Schätzung ist keine Labormessung und kein Nachweis für einen Garantieanspruch. Unter anderem können Temperatur, SOC-Auflösung, Messintervalle, Eigenverbrauch und Wandlungsverluste das Ergebnis beeinflussen. Sie soll vielmehr als nachvollziehbarer langfristiger Indikator dienen.

Überarbeitete Admin-Oberfläche

Die Administrationsoberfläche wurde neu strukturiert und besteht jetzt aus den Bereichen:

Anmeldung,
Einstellungen,
Status & Statistik,
Support & Info.

Speicher werden ausschließlich anhand der SAX-Cloud-Daten erkannt und können nicht versehentlich manuell angelegt oder umbenannt werden. Für jeden erkannten Speicher muss lediglich das passende Batteriemodell ausgewählt werden.

Im Statusbereich werden für jeden Speicher unter anderem angezeigt:

Modell und Kapazität,
der von SAX gemeldete Zykluszähler,
die berechneten äquivalenten Vollzyklen,
der aktuelle Status der Gesundheitsermittlung,
gültige und verworfene Messläufe,
der Fortschritt eines aktuell erfassten Lade- oder Entladeverlaufs.

Zusätzlich zeigt die Oberfläche zusammengefasste Werte für die gesamte Anlage an.

Das Admin-Dashboard liest dabei ausschließlich vorhandene ioBroker-States aus und erzeugt keine zusätzlichen Cloud-Abfragen.

Überarbeitete Objektstruktur

Die Objektstruktur unterscheidet jetzt klar zwischen Werten einzelner Geräte und zusammengefassten Anlagenwerten:

devices.<Seriennummer>.* = Werte eines einzelnen Speichers
summary.*                 = Zusammengefasste Batterie- und Statistikwerte
live.*                    = Zusammengefasste aktuelle Live-Werte

Ein vereinfachtes Beispiel:

sax-power.0
├── info
├── live
├── devices
│   └── <Seriennummer>
│       ├── info
│       ├── live
│       ├── battery
│       │   ├── model
│       │   ├── nominalCapacity
│       │   ├── usableCapacity
│       │   ├── cycles
│       │   └── health
│       └── statistics
└── summary
    ├── battery
    └── statistics

Bestehende veraltete Root- und Statistikobjekte aus älteren Entwicklungsständen werden beim Start automatisch bereinigt.

Kennwort bleibt bei Einstellungsänderungen erhalten

Ebenfalls behoben wurde ein Fehler, durch den das SAX-Cloud-Kennwort nach Änderungen anderer Einstellungen erneut eingegeben werden musste.

Das verschlüsselt gespeicherte Kennwort bleibt nun beispielsweise auch dann erhalten, wenn lediglich:

das Abfrageintervall geändert,
ein Batteriemodell zugeordnet,
oder eine andere unabhängige Einstellung gespeichert wird.

Installation

Der Adapter ist derzeit über npm und direkt über GitHub verfügbar.

Für eine Installation über die ioBroker-Experteneinstellungen kann folgende GitHub-Adresse verwendet werden:

https://github.com/GodHunter/ioBroker.sax-power

Repository und ausführliche Dokumentation:

https://github.com/GodHunter/ioBroker.sax-power

Fehler und Funktionswünsche können hier gemeldet werden:

https://github.com/GodHunter/ioBroker.sax-power/issues

Der Adapter befindet sich aktuell noch nicht im offiziellen ioBroker-Repository. Die Aufnahme wird vorbereitet.

Tester weiterhin gesucht

Der Adapter greift auf eine nicht offiziell dokumentierte SAX-Power-Cloudschnittstelle zurück. Unterschiedliche Anlagenkonfigurationen und längere reale Messzeiträume sind deshalb für die weitere Qualitätssicherung besonders wertvoll.

Ich freue mich weiterhin über Tester – insbesondere mit:

einem SAX Power Home Plus 7,7 kWh,
mehreren Speichern innerhalb einer Anlage,
längerer verfügbarer Cloud-Historie,
bereits ausreichend langen Entladevorgängen für die Gesundheitsschätzung,
ungewöhnlichen oder bislang nicht berücksichtigten Anlagenkonfigurationen.

Bitte meldet insbesondere:

unplausible Zyklenwerte,
größere Abweichungen zum von SAX gemeldeten Zähler,
Probleme bei der Geräte- oder Modellerkennung,
auffällig viele verworfene Gesundheitsmessungen,
unplausible Werte der geschätzten Batteriegesundheit,
Darstellungs- oder Bedienungsprobleme in der Admin-Oberfläche.

Hilfreich sind dabei:

die verwendete Adapterversion,
das ausgewählte Speichermodell,
eine anonymisierte Objektstruktur,
relevante Logeinträge,
eine kurze Beschreibung der Anlagenkonfiguration.

Bitte achtet darauf, Passwörter, Tokens, E-Mail-Adressen und vollständige Seriennummern vor dem Veröffentlichen zu entfernen oder unkenntlich zu machen.

Vielen Dank an alle, die den Adapter bereits testen und mit Rückmeldungen bei der Weiterentwicklung helfen!

Community Forum

NEWS