[{"data":1,"prerenderedAt":390},["ShallowReactive",2],{"guide-en-jk-bms-export-import-settings":3,"guides-en":332},{"id":4,"title":5,"body":6,"date":310,"description":311,"extension":312,"keywords":313,"meta":321,"navigation":322,"path":323,"related":324,"seo":328,"stem":329,"updated":330,"__hash__":331},"guides_en\u002Fguides\u002Fjk-bms-export-import-settings.md","Export and Import JK BMS Settings: The .jkcfg File Guide",{"type":7,"value":8,"toc":292},"minimark",[9,29,34,37,54,57,67,71,74,89,94,97,101,104,107,111,140,148,152,161,168,171,175,189,196,200,231,235,249,253,258,266,270,277,281,284],[10,11,12,13,17,18,23,24,28],"p",{},"You can export and import JK BMS settings with the export and import functions in the JK BMS phone app. Export writes a small ",[14,15,16],"code",{},".jkcfg"," file with your whole configuration. Import sends it back to the BMS. Keep that file as a backup, and edit it only with a tool that fixes the checksums, such as the ",[19,20,22],"a",{"href":21},"\u002F","JK Preset Studio editor",". If you only want to change settings, you can skip the file entirely and ",[19,25,27],{"href":26},"\u002Fguides\u002Fjk-bms-bluetooth-browser","write them over Bluetooth from the browser",".",[30,31,33],"h2",{"id":32},"what-the-jkcfg-file-is","What the .jkcfg file is",[10,35,36],{},"The file is exactly 600 bytes. It holds two 300-byte frames, the same frames the BMS sends over Bluetooth.",[38,39,40,48],"ul",{},[41,42,43,47],"li",{},[44,45,46],"strong",{},"Frame 0"," holds the settings: voltages, currents, balance, delays, temperatures.",[41,49,50,53],{},[44,51,52],{},"Frame 1"," holds device information: model, hardware and software version, serial number, device name and the passcode fields.",[10,55,56],{},"The last byte of each frame is a checksum. It is the sum of the previous 299 bytes, cut to one byte. If the checksum does not match the data, the file is damaged.",[10,58,59,60,66],{},"The layout comes from the open-source ",[19,61,65],{"href":62,"rel":63},"https:\u002F\u002Fgithub.com\u002Fsyssi\u002Fesphome-jk-bms",[64],"nofollow","syssi\u002Fesphome-jk-bms"," project, which documents the JK02_32S protocol. The example file in the JK Preset Studio repository was exported from a JK-PB2A16S20P on firmware 19.26.",[30,68,70],{"id":69},"export-and-import-jk-bms-settings-back-up-first","Export and import JK BMS settings: back up first",[10,72,73],{},"The app's own menu names can differ between versions, so treat these steps as a guide.",[75,76,77,80,83,86],"ol",{},[41,78,79],{},"Connect to the BMS in the JK BMS app.",[41,81,82],{},"Open the settings screen and look for Export and Import entries.",[41,84,85],{},"Choose Export and save the file.",[41,87,88],{},"Copy it somewhere safe, such as cloud storage or your computer.",[10,90,91,92,28],{},"Where the file is saved depends on your phone and the app version. Watch for a save or share dialog that lets you pick the location. If you cannot find the file, search the phone for ",[14,93,16],{},[10,95,96],{},"Back up before every firmware update and before every big settings change.",[30,98,100],{"id":99},"why-you-should-not-edit-it-by-hand","Why you should not edit it by hand",[10,102,103],{},"A hex editor lets you change any byte, but a file with a wrong checksum is damaged and can be rejected. You would also have to know each field's offset, size and scale. Voltages are stored as integers, for example 3450 for 3.45 V. One wrong byte can turn a limit into nonsense.",[10,105,106],{},"The file is binary. A text editor will show garbage and will damage it if you save.",[30,108,110],{"id":109},"edit-it-safely-in-the-browser","Edit it safely in the browser",[75,112,113,123,126,129,137],{},[41,114,115,116,119,120,122],{},"Open the ",[19,117,118],{"href":21},"editor"," and drop your ",[14,121,16],{}," file on it. Nothing is uploaded. All work happens in your browser.",[41,124,125],{},"Change the values you need. Every parameter has help text and a recommended range.",[41,127,128],{},"Read the warnings. The editor checks values against the rules the JK firmware enforces on import, such as OVPR below SOC-100% voltage below RCV.",[41,130,131,132,136],{},"Optionally start from a ",[19,133,135],{"href":134},"\u002Fpresets","ready preset"," for your chemistry and wear level, then adjust.",[41,138,139],{},"Download the result.",[10,141,142,143,147],{},"The editor patches only the fields you changed onto a copy of your original bytes. Unknown and reserved bytes survive. It then recomputes both checksums. See the ",[19,144,146],{"href":145},"\u002Fparameters","parameter reference"," for every field.",[30,149,151],{"id":150},"or-skip-the-file-write-over-bluetooth","Or skip the file: write over Bluetooth",[10,153,154,155,157,158,160],{},"In Chrome or Edge on a computer or an Android phone, the ",[19,156,118],{"href":21}," can connect to the BMS directly. Close the JK app, press Connect BMS and pick your BMS. The editor reads the same two frames that make up a ",[14,159,16],{}," file, so everything above works the same way.",[10,162,163,164,167],{},"When you press Write to BMS, the editor writes one setting at a time, in an order the firmware accepts, and reads the BMS back after every step. There are no step files to import and no guessing which value failed. Settings your model does not have are detected right after connecting and skipped. The ",[19,165,166],{"href":26},"Bluetooth guide"," walks through it.",[10,169,170],{},"The file is still the right tool for backups, for Firefox, Safari and iPhone, and for preparing settings before the pack is built.",[30,172,174],{"id":173},"import-the-file-back","Import the file back",[75,176,177,180,183,186],{},[41,178,179],{},"Copy the edited file to your phone.",[41,181,182],{},"Connect to the BMS in the app.",[41,184,185],{},"In the settings screen, choose Import and pick the file.",[41,187,188],{},"Check the values in the app after it finishes.",[10,190,191,192,28],{},"The app writes settings one by one, and the firmware checks each one against what the BMS holds at that moment. A file with valid final values can still fail in the middle. That is why the editor may give you several numbered step files. Import them in order, or write over Bluetooth, where the editor handles the order for you. If you see \"This parameter does not apply to the connected device. (Sending failure)\", read the ",[19,193,195],{"href":194},"\u002Fguides\u002Fjk-bms-sending-failure","Sending failure guide",[30,197,199],{"id":198},"use-cases","Use cases",[38,201,202,208,214,220],{},[41,203,204,207],{},[44,205,206],{},"Clone to a second pack."," Export from the first BMS and import into the second, or open the file and write it to the second BMS over Bluetooth. Check the cell count and model first.",[41,209,210,213],{},[44,211,212],{},"Known-good backup."," Keep a file from a working setup before a firmware update.",[41,215,216,219],{},[44,217,218],{},"Share settings."," Send the file to another builder. Remove the passcodes first (see the FAQ).",[41,221,222,225,226,230],{},[44,223,224],{},"Start from good values."," See the ",[19,227,229],{"href":228},"\u002Fguides\u002Fjk-bms-lifepo4-settings","LiFePO4 settings guide"," for typical ranges.",[30,232,234],{"id":233},"common-mistakes","Common mistakes",[38,236,237,240,243,246],{},[41,238,239],{},"Importing a file on a pack with a different cell count.",[41,241,242],{},"Importing the final file in one go when the editor gave several steps.",[41,244,245],{},"Editing bytes by hand and breaking a checksum.",[41,247,248],{},"Forgetting that the file contains your passcodes.",[30,250,252],{"id":251},"faq","FAQ",[254,255,257],"h3",{"id":256},"can-i-edit-the-file-in-a-text-editor","Can I edit the file in a text editor?",[10,259,260,261,265],{},"No. It is a 600-byte binary file, so a text editor will corrupt it. Use a hex editor only if you can also fix both checksums, or use the browser editor, which does it for you. See also ",[19,262,264],{"href":263},"\u002Fguides\u002Fjk-bms-parameters-explained","JK BMS parameters explained"," for what each field does.",[254,267,269],{"id":268},"does-the-file-contain-my-password","Does the file contain my password?",[10,271,272,273,28],{},"Yes, it can. The device info frame has fields for the device passcode and the setup passcode, each up to 16 characters. Treat the file as private and clear those fields before sharing. More in the ",[19,274,276],{"href":275},"\u002Fguides\u002Fjk-bms-password","password guide",[254,278,280],{"id":279},"will-a-file-from-another-model-import","Will a file from another model import?",[10,282,283],{},"Not reliably. The firmware rejects values that do not apply to the connected device, so differences in cell count, current rating or firmware version can cause failures. Some models also lack whole functions: a JK-B2A8S20P on firmware 19.25 has no float voltage, heating or CAN settings. Over Bluetooth the editor finds those gaps right after connecting and skips them. The file format was verified on a JK-PB2A16S20P with firmware 19.26.",[10,285,286,291],{},[19,287,288,289],{"href":21},"Connect your BMS or open your ",[14,290,16],{}," in the editor to check the values before anything is written.",{"title":293,"searchDepth":294,"depth":294,"links":295},"",3,[296,298,299,300,301,302,303,304,305],{"id":32,"depth":297,"text":33},2,{"id":69,"depth":297,"text":70},{"id":99,"depth":297,"text":100},{"id":109,"depth":297,"text":110},{"id":150,"depth":297,"text":151},{"id":173,"depth":297,"text":174},{"id":198,"depth":297,"text":199},{"id":233,"depth":297,"text":234},{"id":251,"depth":297,"text":252,"children":306},[307,308,309],{"id":256,"depth":294,"text":257},{"id":268,"depth":294,"text":269},{"id":279,"depth":294,"text":280},"2026-10-02","How to export and import JK BMS settings with the app, what the .jkcfg file contains, why hand edits break it, and how to edit it safely in your browser.","md",[314,315,316,317,318,319,320],"export and import jk bms settings","jk bms backup settings","jk bms save configuration","jkcfg file","jk bms import settings","jk bms config file","jk bms settings file",{},true,"\u002Fguides\u002Fjk-bms-export-import-settings",[325,326,327],"jk-bms-sending-failure","jk-bms-lifepo4-settings","jk-bms-password",{"title":5,"description":311},"guides\u002Fjk-bms-export-import-settings","2026-10-04","rfBa5E3VVX4HkR5kf8CXT0rQGj4ENxfe9e3BGhVT0gA",[333,337,341,345,349,350,353,357,361,365,368,371,375,378,382,386],{"path":26,"title":334,"description":335,"date":330,"updated":336},"Change JK BMS Settings over Bluetooth in Your Browser","Connect to a JK BMS from Chrome or Edge, read every setting, apply a preset and write it back in a safe order with read-back checks. No JK app needed.",null,{"path":338,"title":339,"description":340,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-balance-settings","JK BMS Balance Settings: Start Voltage, Trigger, Current","JK BMS balance settings explained: start balance voltage, balance trigger voltage, max balance current and the Balancer switch, for LFP, NMC and LTO.",{"path":342,"title":343,"description":344,"date":310,"updated":336},"\u002Fguides\u002Fjk-bms-cell-overcharge-protection-tripping","JK BMS Cell Over Charge Protection Keeps Tripping: Causes and Fix","JK BMS cell over charge protection tripping and releasing every minute? See why a charger set too high causes it, how to tell it from a weak cell, and how to fix it.",{"path":346,"title":347,"description":348,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-detail-log","How to export and read the JK-BMS Detail Log","What the JK-BMS Detail Log contains, how to export it from the app, how to read its events and what the log analysis page tells you about trips and faults.",{"path":323,"title":5,"description":311,"date":310,"updated":330},{"path":228,"title":351,"description":352,"date":310,"updated":330},"JK BMS Settings for LiFePO4: 8S and 16S, 280Ah and 314Ah","JK BMS settings for LiFePO4 packs: per-cell voltage, balance, current and temperature values for 8S and 16S with 280Ah and 314Ah cells, in three wear levels.",{"path":354,"title":355,"description":356,"date":310,"updated":336},"\u002Fguides\u002Fjk-bms-log-messages-explained","JK BMS Log Messages Explained: Boot, Time calibration, Protections","What each JK BMS log message means: Boot, Time calibration, APP open charge, protection trips and releases, Discharge On Failed and Unknown Log Code [0].",{"path":358,"title":359,"description":360,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-nmc-lto-settings","JK BMS Settings for NMC and LTO: Safe Per-Cell Values","JK BMS settings for NMC and LTO packs: per-cell OVP, UVP, balance, temperature and C-rate values in three wear levels, plus how the editor detects chemistry.",{"path":362,"title":363,"description":364,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-ocp-scp-settings","JK BMS Overcurrent Protection Settings: OCP and SCP Guide","JK BMS overcurrent protection settings explained: charge and discharge OCP limits, delays, recovery times and SCP, with ranges and sizing for inverters.",{"path":263,"title":366,"description":367,"date":310,"updated":330},"JK BMS Parameters Explained: Every Setting by Group","JK BMS parameters explained in one glossary: cell OVP, OVPR, UVP, UVPR, balance, SOC, RCV and RFV, current and temperature limits, with typical LFP ranges.",{"path":275,"title":369,"description":370,"date":310,"updated":330},"JK BMS Password: Default Codes, Change and Reset Guide","Your JK BMS password is really two codes: Bluetooth and settings. See factory defaults, how to change them, what to try if one fails, and what to do if lost.",{"path":372,"title":373,"description":374,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-reboots-power-events","JK BMS Reboots and Charge MOS Off: Reading Power Events in the Log","JK BMS reboots or the charge MOS switched off by itself? Learn to read Boot rows and MOS state in the Detail Log and tell expected restarts from real faults.",{"path":194,"title":376,"description":377,"date":310,"updated":330},"JK BMS Sending failure: Causes and Step-by-Step Fix","JK BMS Sending failure on import? See why the firmware rejects settings (voltage chains, write order, SCP delay) and how to fix it step by step.",{"path":379,"title":380,"description":381,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-soc-calibration","JK BMS SOC Calibration: Fix SOC Drift, Jumps and Reset","JK BMS SOC calibration explained: why SOC drifts or jumps, what the SOC-100% voltage and SOC-0% voltage do, and how to set them and recalibrate the pack.",{"path":383,"title":384,"description":385,"date":310,"updated":336},"\u002Fguides\u002Fjk-bms-weak-cell-log","Find a Weak Cell with the JK BMS Log: Trips, Spread and Balance","Find a weak cell in the JK BMS Detail Log: which cell trips first, how wide the spread is at the trip, and whether it is balance drift or a bad cell.",{"path":387,"title":388,"description":389,"date":310,"updated":330},"\u002Fguides\u002Fjk-bms-wire-resistance","JK BMS Wire Resistance: Fix Abnormal Balance Wire Alarm","JK BMS wire resistance explained: what the abnormal resistance of the balance wire warning means, normal values, common causes and how to fix a bad lead.",1791151315620]