[{"data":1,"prerenderedAt":333},["ShallowReactive",2],{"guide-en-jk-bms-bluetooth-browser":3,"guides-en":273},{"id":4,"title":5,"body":6,"date":253,"description":254,"extension":255,"keywords":256,"meta":262,"navigation":263,"path":264,"related":265,"seo":269,"stem":270,"updated":271,"__hash__":272},"guides_en\u002Fguides\u002Fjk-bms-bluetooth-browser.md","Change JK BMS Settings over Bluetooth in Your Browser",{"type":7,"value":8,"toc":235},"minimark",[9,19,24,58,62,81,89,93,96,99,103,106,127,130,134,137,140,143,146,150,161,173,177,196,200,205,208,212,215,219,222,226,229],[10,11,12,13,18],"p",{},"You can change JK BMS settings over Bluetooth straight from a browser, without the JK app and without exporting a file. Open the ",[14,15,17],"a",{"href":16},"\u002F","JK Preset Studio editor"," in Chrome or Edge, press Connect BMS and pick your BMS. The editor reads every setting, lets you change it with presets and checks, and writes the result back one setting at a time, reading the BMS back after each step.",[20,21,23],"h2",{"id":22},"what-you-need","What you need",[25,26,27,40,46,52],"ul",{},[28,29,30,34,35,39],"li",{},[31,32,33],"strong",{},"A browser with Web Bluetooth."," Chrome or Edge on Windows, macOS, ChromeOS or Android. Firefox, Safari and every browser on iPhone and iPad do not have it. On those, use the ",[14,36,38],{"href":37},"\u002Fguides\u002Fjk-bms-export-import-settings",".jkcfg file workflow"," instead.",[28,41,42,45],{},[31,43,44],{},"The JK app closed."," The BMS accepts one Bluetooth connection at a time. If the app or another monitor (an ESP32 with esphome, for example) is connected, the BMS does not show up or drops the link.",[28,47,48,51],{},[31,49,50],{},"A JK BMS with the JK02 protocol."," We tested a JK-PB2A16S20P (firmware 19.26) and a JK-B2A8S20P (firmware 19.25). Other JK boards with firmware 19 use the same protocol.",[28,53,54,57],{},[31,55,56],{},"Range."," Stay within a few metres of the BMS. A metal battery cabinet shortens the range a lot.",[20,59,61],{"id":60},"connect-and-read-the-settings","Connect and read the settings",[63,64,65,72,75,78],"ol",{},[28,66,67,68,71],{},"Open the ",[14,69,70],{"href":16},"home page"," and press Connect BMS.",[28,73,74],{},"The browser shows a list of nearby devices. JK boards usually advertise their serial number or a name starting with JK. Pick yours.",[28,76,77],{},"The editor reads two frames from the BMS: one with all settings and one with device information. The BMS beeps once when it sends the settings.",[28,79,80],{},"The editor opens with your values, the model, hardware and firmware version.",[10,82,83,84,88],{},"These two frames are exactly what the JK app saves in a ",[85,86,87],"code",{},".jkcfg"," file. You can download them as a file at any time, which makes a good backup before you change anything.",[20,90,92],{"id":91},"which-settings-your-model-has","Which settings your model has",[10,94,95],{},"Not every JK BMS has every function. The settings frame always contains all fields, even for features the board lacks: an 8S B2A board without heating still reports a heating start temperature. So right after connecting, the editor asks the BMS directly. It writes the current value of each optional setting back, which changes nothing, and the BMS answers for every one: accepted, or \"this model has no such setting\".",[10,97,98],{},"Settings the BMS lacks are marked Not on this BMS. They stay visible but cannot be edited, presets leave them alone and they are not validated. On our JK-B2A8S20P this covered float voltage (RFV), charging float mode, heating, precharge, the PCL module, the port switch and the CAN and UART2 protocols. The result is stored in your browser for that BMS, so the next connection is instant.",[20,100,102],{"id":101},"edit-and-apply-a-preset","Edit and apply a preset",[10,104,105],{},"Every parameter has a short explanation, a recommended range for your cell chemistry and a link to sources. You can:",[25,107,108,111,119],{},[28,109,110],{},"change single values, for example OVP or the balance start voltage;",[28,112,113,114,118],{},"apply a ",[14,115,117],{"href":116},"\u002Fpresets","ready preset"," for LiFePO4, NMC or LTO and then adjust it;",[28,120,121,122,126],{},"check the ",[14,123,125],{"href":124},"\u002Fparameters","parameter reference"," for what each field does.",[10,128,129],{},"The editor checks dependent values as you type, for example that OVPR stays below SOC-100% voltage and that stays below RCV. Errors block writing; warnings only inform you.",[20,131,133],{"id":132},"write-and-verify","Write and verify",[10,135,136],{},"Press Write to BMS. The dialog shows the plan before anything is sent: how many steps, which settings in each step, and which edited settings are skipped. Download the backup offered there first.",[10,138,139],{},"The firmware checks every written value against what the BMS holds at that moment, so the same final values can fail in one order and pass in another. The editor splits your changes into steps that are safe in any order. After each step it reads the BMS back and compares every value.",[10,141,142],{},"The BMS answers each write with a result code. If it refuses a value because it clashes with another setting, writing stops at once and the editor shows which setting failed and what the BMS holds now. If a setting turns out to be missing on your model, it is skipped and listed. Nothing fails silently.",[10,144,145],{},"One detail we found on real hardware: a write sent the instant after a read can be dropped without any answer. The editor waits briefly after every read and resends a write once if no answer comes.",[20,147,149],{"id":148},"when-a-file-is-still-better","When a file is still better",[25,151,152,155,158],{},[28,153,154],{},"Your browser or phone has no Web Bluetooth.",[28,156,157],{},"You want a long-term backup or to keep several configurations side by side.",[28,159,160],{},"You prepare settings before the pack is assembled, or send them to someone else.",[10,162,163,164,167,168,172],{},"The ",[14,165,166],{"href":37},"export and import guide"," covers that workflow. If an import fails with \"Sending failure\", see the ",[14,169,171],{"href":170},"\u002Fguides\u002Fjk-bms-sending-failure","Sending failure guide",".",[20,174,176],{"id":175},"common-mistakes","Common mistakes",[25,178,179,182,185,188],{},[28,180,181],{},"Leaving the JK app open, so the BMS never appears in the list.",[28,183,184],{},"Writing without a backup. Download the current settings first.",[28,186,187],{},"Expecting every setting to change on every model. Check the Not on this BMS marks.",[28,189,190,191,195],{},"Writing values for another chemistry. Start from the ",[14,192,194],{"href":193},"\u002Fguides\u002Fjk-bms-lifepo4-settings","LiFePO4 settings guide"," or the right preset.",[20,197,199],{"id":198},"faq","FAQ",[201,202,204],"h3",{"id":203},"do-i-need-the-bms-password-to-write-over-bluetooth","Do I need the BMS password to write over Bluetooth?",[10,206,207],{},"In our tests the BMS accepted writes without a passcode; the JK app checks the password itself. One report on an older V15 firmware says writes stopped working after the settings password was changed, so results may vary.",[201,209,211],{"id":210},"is-it-safe","Is it safe?",[10,213,214],{},"The editor writes only what you changed, in a safe order, and checks every value afterwards. Wrong values can still damage cells, so compare them with your cell datasheet and keep the backup.",[201,216,218],{"id":217},"does-anything-leave-my-computer","Does anything leave my computer?",[10,220,221],{},"No. The browser talks to the BMS directly. Settings are never uploaded.",[201,223,225],{"id":224},"why-does-the-bms-beep","Why does the BMS beep?",[10,227,228],{},"The BMS beeps when it is asked for its settings. The editor asks once on connect and once after each write step.",[10,230,231,234],{},[14,232,233],{"href":16},"Connect your BMS"," and see your current settings in a minute.",{"title":236,"searchDepth":237,"depth":237,"links":238},"",3,[239,241,242,243,244,245,246,247],{"id":22,"depth":240,"text":23},2,{"id":60,"depth":240,"text":61},{"id":91,"depth":240,"text":92},{"id":101,"depth":240,"text":102},{"id":132,"depth":240,"text":133},{"id":148,"depth":240,"text":149},{"id":175,"depth":240,"text":176},{"id":198,"depth":240,"text":199,"children":248},[249,250,251,252],{"id":203,"depth":237,"text":204},{"id":210,"depth":237,"text":211},{"id":217,"depth":237,"text":218},{"id":224,"depth":237,"text":225},"2026-10-04","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.","md",[257,258,259,260,261],"jk bms bluetooth","change jk bms settings without app","jk bms web bluetooth","jk bms settings on pc","jk bms write settings",{},true,"\u002Fguides\u002Fjk-bms-bluetooth-browser",[266,267,268],"jk-bms-export-import-settings","jk-bms-sending-failure","jk-bms-lifepo4-settings",{"title":5,"description":254},"guides\u002Fjk-bms-bluetooth-browser",null,"A-euDX6PF45mw3pa-hD0QA-1kCmZ4JvJPBzEBSoTDRY",[274,275,280,284,288,291,294,298,302,306,310,314,318,321,325,329],{"path":264,"title":5,"description":254,"date":253,"updated":271},{"path":276,"title":277,"description":278,"date":279,"updated":253},"\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.","2026-10-02",{"path":281,"title":282,"description":283,"date":279,"updated":271},"\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":285,"title":286,"description":287,"date":279,"updated":253},"\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":37,"title":289,"description":290,"date":279,"updated":253},"Export and Import JK BMS Settings: The .jkcfg File Guide","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.",{"path":193,"title":292,"description":293,"date":279,"updated":253},"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":295,"title":296,"description":297,"date":279,"updated":271},"\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":299,"title":300,"description":301,"date":279,"updated":253},"\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":303,"title":304,"description":305,"date":279,"updated":253},"\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":307,"title":308,"description":309,"date":279,"updated":253},"\u002Fguides\u002Fjk-bms-parameters-explained","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":311,"title":312,"description":313,"date":279,"updated":253},"\u002Fguides\u002Fjk-bms-password","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":315,"title":316,"description":317,"date":279,"updated":253},"\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":170,"title":319,"description":320,"date":279,"updated":253},"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":322,"title":323,"description":324,"date":279,"updated":253},"\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":326,"title":327,"description":328,"date":279,"updated":271},"\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":330,"title":331,"description":332,"date":279,"updated":253},"\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.",1791151314585]