Mit den Export- und Importfunktionen der JK BMS Handy-App kannst du die Einstellungen deines JK BMS sichern und zurückspielen. Der Export schreibt eine kleine .jkcfg-Datei mit deiner kompletten Konfiguration. Der Import schickt sie zurück an das BMS. Bewahre diese Datei als Backup auf und bearbeite sie nur mit einem Werkzeug, das die Prüfsummen korrigiert, zum Beispiel mit dem JK Preset Studio Editor. Willst du nur Einstellungen ändern, kannst du die Datei ganz weglassen und sie per Bluetooth aus dem Browser schreiben.

Was die .jkcfg-Datei ist

Die Datei ist genau 600 Byte groß. Sie enthält zwei Frames zu je 300 Byte, also dieselben Frames, die das BMS über Bluetooth sendet.

Frame 0 enthält die Einstellungen: Spannungen, Ströme, Balancing, Verzögerungen, Temperaturen.
Frame 1 enthält die Geräteinformationen: Modell, Hardware- und Softwareversion, Seriennummer, Gerätename und die Passwortfelder.

Das letzte Byte jedes Frames ist eine Prüfsumme. Sie ist die Summe der vorherigen 299 Bytes, gekürzt auf ein Byte. Passt die Prüfsumme nicht zu den Daten, ist die Datei beschädigt.

Der Aufbau stammt aus dem Open-Source-Projekt syssi/esphome-jk-bms, das das JK02_32S-Protokoll dokumentiert. Die Beispieldatei im JK Preset Studio Repository wurde von einem JK-PB2A16S20P mit Firmware 19.26 exportiert.

JK BMS Einstellungen exportieren und importieren: zuerst sichern

Die Menünamen der App können sich zwischen Versionen unterscheiden, nimm die Schritte also als Orientierung.

Verbinde dich in der JK BMS App mit dem BMS.
Öffne den Einstellungsbildschirm und suche die Einträge Export und Import.
Wähle Export und speichere die Datei.
Kopiere sie an einen sicheren Ort, etwa in einen Cloud-Speicher oder auf deinen Computer.

Wo die Datei landet, hängt von deinem Handy und der App-Version ab. Achte auf einen Speichern- oder Teilen-Dialog, in dem du den Ort auswählen kannst. Findest du die Datei nicht, durchsuche das Handy nach .jkcfg.

Mach vor jedem Firmware-Update und vor jeder größeren Änderung der Einstellungen ein Backup.

Warum du sie nicht von Hand bearbeiten solltest

Mit einem Hex-Editor kannst du jedes Byte ändern, aber eine Datei mit falscher Prüfsumme ist beschädigt und kann abgelehnt werden. Außerdem müsstest du Offset, Größe und Skalierung jedes Felds kennen. Spannungen werden als Ganzzahlen gespeichert, zum Beispiel 3450 für 3,45 V. Ein einziges falsches Byte kann aus einem Grenzwert Unsinn machen.

Die Datei ist binär. Ein Texteditor zeigt nur Zeichensalat an und beschädigt sie beim Speichern.

Sicher im Browser bearbeiten

Öffne den Editor und zieh deine .jkcfg-Datei hinein. Es wird nichts hochgeladen, alles passiert in deinem Browser.
Ändere die Werte, die du brauchst. Jeder Parameter hat einen Hilfetext und einen empfohlenen Bereich.
Lies die Warnungen. Der Editor prüft die Werte gegen die Regeln, die die JK Firmware beim Import durchsetzt, etwa OVPR unter der SOC-100%-Spannung und diese unter RCV.
Optional startest du mit einem fertigen Preset für deine Zellchemie und Schonstufe und passt es dann an.
Lade das Ergebnis herunter.

Der Editor überträgt nur die geänderten Felder auf eine Kopie deiner Originalbytes. Unbekannte und reservierte Bytes bleiben erhalten. Danach berechnet er beide Prüfsummen neu. Alle Felder findest du in der Parameterübersicht.

Oder ohne Datei: per Bluetooth schreiben

In Chrome oder Edge auf einem Computer oder Android-Handy kann sich der Editor direkt mit dem BMS verbinden. Schließe die JK App, drücke BMS verbinden und wähle dein BMS. Der Editor liest dieselben zwei Frames, aus denen eine .jkcfg-Datei besteht, alles oben Beschriebene funktioniert also genauso.

Wenn du Ins BMS schreiben drückst, schreibt der Editor eine Einstellung nach der anderen in einer Reihenfolge, die die Firmware akzeptiert, und liest das BMS nach jedem Schritt zurück. Es gibt keine Schrittdateien zu importieren und kein Rätselraten, welcher Wert gescheitert ist. Einstellungen, die dein Modell nicht hat, werden direkt nach dem Verbinden erkannt und übersprungen. Der Bluetooth-Ratgeber führt dich durch den Ablauf.

Für Backups, für Firefox, Safari und das iPhone und zum Vorbereiten von Einstellungen, bevor das Akkupack gebaut ist, bleibt die Datei das richtige Werkzeug.

Die Datei wieder importieren

Kopiere die bearbeitete Datei auf dein Handy.
Verbinde dich in der App mit dem BMS.
Wähle im Einstellungsbildschirm Import und dann die Datei.
Kontrolliere die Werte in der App, wenn der Vorgang fertig ist.

Die App schreibt die Einstellungen einzeln, und die Firmware prüft jede gegen die Werte, die das BMS in diesem Moment gespeichert hat. Eine Datei mit gültigen Endwerten kann deshalb mittendrin scheitern. Aus diesem Grund gibt dir der Editor eventuell mehrere nummerierte Schrittdateien. Importiere sie der Reihe nach oder schreibe per Bluetooth, dann kümmert sich der Editor um die Reihenfolge. Erscheint "This parameter does not apply to the connected device. (Sending failure)", lies den Ratgeber zum Sending failure.

Anwendungsfälle

Auf ein zweites Akkupack klonen. Exportiere vom ersten BMS und importiere ins zweite, oder öffne die Datei und schreibe sie per Bluetooth ins zweite BMS. Prüfe vorher Zellenanzahl und Modell.
Bewährtes Backup. Bewahre vor einem Firmware-Update eine Datei von einem funktionierenden Setup auf.
Einstellungen teilen. Schick die Datei an einen anderen Bastler. Entferne vorher die Passwörter (siehe FAQ).
Mit guten Werten starten. Typische Bereiche findest du im Ratgeber zu LiFePO4-Einstellungen.

Häufige Fehler

Eine Datei auf ein Akkupack mit anderer Zellenanzahl importieren.
Die finale Datei in einem Rutsch importieren, obwohl der Editor mehrere Schritte ausgegeben hat.
Bytes von Hand bearbeiten und dabei eine Prüfsumme zerstören.
Vergessen, dass die Datei deine Passwörter enthält.

FAQ

Kann ich die Datei in einem Texteditor bearbeiten?

Nein. Es ist eine binäre Datei mit 600 Byte, ein Texteditor macht sie kaputt. Nimm einen Hex-Editor nur, wenn du auch beide Prüfsummen korrigieren kannst, oder nutze den Browser-Editor, der das für dich erledigt. Was jedes Feld bewirkt, steht in JK BMS Parameter erklärt.

Enthält die Datei mein Passwort?

Ja, das kann sie. Der Frame mit den Geräteinformationen hat Felder für das Gerätepasswort und das Einstellungspasswort, jeweils bis zu 16 Zeichen. Behandle die Datei als privat und leere diese Felder vor dem Teilen. Mehr dazu im Ratgeber zum Passwort.

Lässt sich eine Datei von einem anderen Modell importieren?

Nicht zuverlässig. Die Firmware lehnt Werte ab, die nicht zum verbundenen Gerät passen, daher können Unterschiede bei Zellenanzahl, Nennstrom oder Firmware-Version zu Fehlern führen. Manchen Modellen fehlen außerdem ganze Funktionen: Ein JK-B2A8S20P mit Firmware 19.25 hat keine Einstellungen für Float-Spannung, Heizung oder CAN. Per Bluetooth findet der Editor diese Lücken direkt nach dem Verbinden und überspringt sie. Das Dateiformat wurde an einem JK-PB2A16S20P mit Firmware 19.26 geprüft.

Verbinde dein BMS oder öffne deine .jkcfg im Editor, um die Werte zu prüfen, bevor etwas geschrieben wird.

JK BMS Einstellungen exportieren und importieren: die .jkcfg-Datei