JK-BMS Detail Log exportieren und lesen

Das JK-BMS Detail Log ist eine lange Liste von Ereignissen, jedes mit einer Momentaufnahme des Akkus. Es zeigt, wann das BMS das Laden oder Entladen abgeschaltet hat, welche Zelle der Auslöser war und wie hoch Spannung, Strom und Temperatur dabei waren. Exportiere es als Textdatei aus der JK app und lies es von Hand oder öffne es in der Log-Analyse. Sie ordnet Abschaltungen und Freigaben einander zu und zeigt auf die wahrscheinliche Ursache.

Was das Detail Log ist

Die App exportiert es als Datei mit einem Namen wie detaillogs-20261001171819.txt, wobei Datum und Uhrzeit des Exports im Namen stehen. Trotz der Endung ist es eine CSV-Datei. Die erste Zeile enthält die Spaltennamen, jede weitere Zeile ist ein Ereignis.

Eine Ereigniszeile enthält die Zeit, die Meldung (zum Beispiel "Cell 01 over charge protection"), den Zustand von Lade-MOS, Entlade-MOS, Balancer und Heizung, die Nummern der höchsten und der niedrigsten Zelle, deren Spannungen, die Pack-Spannung, den Strom, die Rest- und die volle Kapazität, die Temperaturen und den Heizstrom.

Ältere Firmware führt eine kurze Ereignisliste mit etwa 50 Einträgen, die überschrieben wird, und PC-Monitorprogramme zeichnen eigene Daten auf. Das Detail Log ist dagegen eine eigene, längere Aufzeichnung, die das BMS selbst schreibt. Sie deckt Tage oder Wochen ab, ohne dass etwas angeschlossen sein muss.

Aus der App exportieren

1. Verbinde dich in der JK app per Bluetooth mit dem BMS.
2. Öffne den Geräte-Bildschirm und suche den Bereich für Logs. Die Menünamen unterscheiden sich je nach App-Version leicht.
3. Wähle das Detail Log und exportiere es. Die App speichert eine .txt-Datei.
4. Schicke die Datei an deinen Computer oder öffne sie auf dem Handy. Dafür muss das BMS nicht verbunden bleiben.

Die Spalten lesen

Ein paar Details führen leicht in die Irre.

• Zellnummern im Meldungstext beginnen bei 1, "Cell 01" ist also die erste Zelle. Die Spalten für maximale und minimale Zelle beginnen bei 0, du musst also 1 addieren, um sie zu vergleichen. Beides stimmt nicht immer überein: Die Momentaufnahme kann dem Ereignis hinterherhinken, daher ist die in der Meldung genannte Zelle nicht immer die, die die Spalte in diesem Moment zeigt. Im Beispiel zeigen Zeilen mit "Cell 01" nur in 366 von 1083 Zeilen eine 0 in der Spalte der maximalen Zelle, andere Zeilen zeigen Zellen bis 7.
• Boot-Zeilen enthalten Nullen in den Spalten für Spannung und Strom. Das BMS hatte beim Schreiben noch nichts gemessen.
• Zeilen zur Zeitkalibrierung erscheinen, wenn sich die App verbindet und die Uhr stellt. Sie markieren deine eigenen Sitzungen und sind kein Fehler.
• Zeilen mit einem Datum vor 2021, meist 2020-01-01, bedeuten, dass die Uhr noch nicht gestellt war. Es sind echte Ereignisse mit unbekannter Zeit, deshalb lässt die Analyse sie bei Zeitpunkten und Dauern weg.
• Spannungen mit nur einer Nachkommastelle, die in manchen alten Exporten vorkommen, sind zu grob, um eine Zellabweichung zu beurteilen.
• Die Analyse akzeptiert Dateien bis 10 MB und verwirft doppelte Zeilen, die innerhalb von 2 Sekunden voneinander liegen.

Meldungsgruppen

Die Meldungen lassen sich in wenige Gruppen einteilen.

• Schutzabschaltungen und Freigaben: Überspannung, Unterspannung, Überstrom beim Laden und Entladen, Kurzschluss, Über- und Untertemperatur beim Laden und Entladen sowie MOS-Übertemperatur. Zu jeder Abschaltung gehört normalerweise eine passende Freigabezeile.
• Aktionen von Nutzer und App: die Ein/Aus-Taste, ein Notschalter, die App schaltet das BMS aus.
• Fernschalter: App, RS485 oder CAN schalten Laden oder Entladen ein oder aus.
• Ein- und Ausschaltereignisse: Boot, Herunterfahren und Standby.
• Fehler: ungewöhnliche Zustände wie eine falsche Zellenzahl, ein Coprozessor-Fehler oder ein MOS-Defekt. Das sind keine gewöhnlichen Schutzfunktionen und sie verdienen Aufmerksamkeit.

Meldungen zu Über- und Unterspannung nennen die Zelle. Das ist die nützlichste Angabe in der ganzen Datei.

Schutz-Episoden

Eine Abschaltung und ihre Freigabe bilden eine Episode. Die Zeit dazwischen ist die Dauer, die der Schutz gehalten hat. Die Zeit von der Freigabe bis zur nächsten Abschaltung derselben Art ist die Zeit bis zur nächsten Abschaltung.

Episoden erklären, warum ein einziges Problem tausend Zeilen erzeugen kann. Drückt ein Ladegerät eine Zelle immer wieder über die Grenze, schaltet das BMS ab, gibt nach einer Pause frei und schaltet erneut ab. Jede Runde fügt zwei Zeilen hinzu. Es ist ein Problem, das sich wiederholt.

Eine Boot-Zeile beendet jede offene Episode, weil das BMS seinen Zustand verloren hat. Eine Abschaltung ohne Freigabe bis zum Dateiende bleibt offen.

Häufige Diagnosen

Das sind die Muster, nach denen die Analyse sucht, mit den Zahlen, die sie verwendet.

Ladegerät über der Zellgrenze (Ladespannung zu hoch). Das Beispiel-Log hat 1090 Überspannungs-Abschaltungen, davon 1083 an Zelle 01, mit einer Abweichung zwischen höchster und niedrigster Zelle meist unter 10 mV. Das heißt, die Zellen sind im Gleichgewicht und das Ladegerät hält den Akku zu hoch; warum der Zellüberladeschutz ständig auslöst nennt die Zahlen und die Lösung.

Schwache Zelle oben. Nennen mindestens 80 % der Abschaltungen dieselbe Zelle und die Abweichung beträgt 50 mV oder mehr, ist diese Zelle das Problem. Prüfe zuerst die Abweichung, denn die genannte Zelle allein kann in die Irre führen. Sieh dir die Balancing-Einstellungen an und kontrolliere die Zelle und ihre Verkabelung. Das Muster in den Daten zeigt schwache Zelle im Log finden.

Unterspannung. Dieselbe Unterscheidung gilt unten. Eine Zelle weit unter den anderen deutet auf eine schwache Zelle. Eine geringe Abweichung deutet auf einen leeren Akku, oft wegen einer zu niedrig eingestellten Abschaltung des Wechselrichters. Vergleiche Cell UVP und SOC-0% voltage mit der Spannung, bei der der Wechselrichter stoppt.

Zyklisches Schalten. Zehn oder mehr Überspannungs-Abschaltungen, deren Median der Zeit bis zur nächsten Abschaltung unter 60 s liegt, werden als zyklisches Schalten gemeldet. Cell OVP recovery und Cell RCV sind die Felder, die du prüfen solltest.

Temperatur und Kurzschluss. Temperatur-Abschaltungen zeigen den erreichten Spitzenwert. Eine MOS-Temperatur ab 70 °C ohne Abschaltung wird als Warnung markiert. Jede Kurzschluss-Abschaltung ist kritisch. Prüfe die Last, die Verkabelung und die Verzögerungseinstellung, die in Überstrom und Kurzschluss beschrieben ist.

Unerwartete Neustarts. Eine Boot-Zeile, der nicht innerhalb von 60 s eine Ausschalt- oder Herunterfahr-Zeile vorausgeht, gilt als unerwartet. Das Beispiel hat 7 Boots, davon 2 unerwartete, weil die anderen fünf auf eine Zeile "Button to turn it off" folgen. Prüfe die Stromversorgung und die Verkabelung des BMS und siehe Neustarts und Ein-/Ausschaltereignisse im Log.

Kapazitätsänderungen. Ändert sich die volle Kapazität im Log, zum Beispiel von 200 Ah auf 334 Ah, hat jemand die Kapazitätseinstellung bearbeitet. Wie das BMS die Restkapazität verfolgt, steht in SOC-Kalibrierung.

Dein Log im Browser analysieren

Öffne die Log-Analyse und ziehe die .txt-Datei hinein. Sie wird in deinem Browser gelesen und nie hochgeladen. Du erhältst die Episoden, die Abschaltungen pro Zelle und die oben beschriebenen Befunde.

Du kannst auch einen .jkcfg-Export desselben BMS anhängen. Die Seite zeichnet dann deine Schwellenwerte als Linien in die Diagramme und gleicht das Log mit ihnen ab: Abschaltspannung gegen Cell OVP, Zellenzahl, Kapazität, die Ladegerät-Sollspannung gegen Zellen × Cell RCV, Spitzenstrom nahe den Überstromgrenzen und MOS-Temperatur nahe der MOS-Grenze. Korrigiere, was sie findet, im Editor, am besten indem du die Änderungen per Bluetooth schreibst, und lies JK BMS Sending failure, falls das BMS eine importierte Datei ablehnt.