[{"data":1,"prerenderedAt":331},["ShallowReactive",2],{"guide-en-jk-bms-detail-log":3,"guides-en":276},{"id":4,"title":5,"body":6,"date":255,"description":256,"extension":257,"keywords":258,"meta":265,"navigation":266,"path":267,"related":268,"seo":272,"stem":273,"updated":274,"__hash__":275},"guides_en\u002Fguides\u002Fjk-bms-detail-log.md","How to export and read the JK-BMS Detail Log",{"type":7,"value":8,"toc":243},"minimark",[9,19,24,32,35,38,42,62,66,69,90,94,97,114,117,121,124,127,130,134,137,149,165,171,177,187,197,208,212,221],[10,11,12,13,18],"p",{},"The JK-BMS Detail Log is a long list of events, each with a snapshot of the pack at that moment. It tells you when the BMS cut off charging or discharging, which cell caused it, and what the voltage, current and temperature were. Export it from the JK app as a text file, then read it by hand or open it in the ",[14,15,17],"a",{"href":16},"\u002Flogs","log analysis page",", which pairs trips with releases and points at the likely cause.",[20,21,23],"h2",{"id":22},"what-the-detail-log-is","What the Detail Log is",[10,25,26,27,31],{},"The app exports it as a file named like ",[28,29,30],"code",{},"detaillogs-20261001171819.txt",", with the export date and time in the name. Despite the extension it is a CSV. The first row holds the column names and every other row is one event.",[10,33,34],{},"An event row has the time, the message (for example \"Cell 01 over charge protection\"), the state of the charge MOS, discharge MOS, balancer and heater, the numbers of the highest and lowest cell, their voltages, the pack voltage, the current, the remaining and full capacity, the temperatures and the heater current.",[10,36,37],{},"Older firmware keeps a short event list of about 50 entries that rolls over, and PC monitor programs record their own data. The Detail Log is a separate, longer record written by the BMS itself, so it covers days or weeks without anything connected.",[20,39,41],{"id":40},"exporting-it-from-the-app","Exporting it from the app",[43,44,45,49,52,59],"ol",{},[46,47,48],"li",{},"Connect to the BMS in the JK app over Bluetooth.",[46,50,51],{},"Open the device screen and find the logs section. Menu names differ a little between app versions.",[46,53,54,55,58],{},"Choose the Detail Log and export it. The app saves a ",[28,56,57],{},".txt"," file.",[46,60,61],{},"Send the file to your computer or open it on the phone. Nothing here needs the BMS to stay connected.",[20,63,65],{"id":64},"reading-the-columns","Reading the columns",[10,67,68],{},"A few details are easy to get wrong.",[70,71,72,75,78,81,84,87],"ul",{},[46,73,74],{},"Cell numbers in the message text start at 1, so \"Cell 01\" is the first cell. The max and min cell columns start at 0, so add 1 to compare them. The two do not always agree: the snapshot can lag the event, so the cell named in the message is not always the one the column shows at that moment. In the example, rows that say \"Cell 01\" show 0 in the max-cell column on only 366 of 1083 rows, and other rows show cells up to 7.",[46,76,77],{},"Boot rows carry zeros in the voltage and current columns. The BMS had not measured anything yet when it wrote them.",[46,79,80],{},"Time calibration rows appear when the app connects and sets the clock. They mark your own sessions, not a fault.",[46,82,83],{},"Rows dated before 2021, usually 2020-01-01, mean the clock was not set yet. They are real events with an unknown time, so the analysis leaves them out of timing and durations.",[46,85,86],{},"Voltages with only one decimal place, found in some old exports, are too coarse to judge a cell spread.",[46,88,89],{},"The analysis page accepts files up to 10 MB and drops duplicate rows that fall within 2 seconds of each other.",[20,91,93],{"id":92},"message-families","Message families",[10,95,96],{},"The messages fall into a few groups.",[70,98,99,102,105,108,111],{},[46,100,101],{},"Protection trips and releases: over-voltage, under-voltage, charge and discharge over-current, short circuit, charge and discharge over-temperature or under-temperature, and MOS over-temperature. Each trip normally has a matching release row.",[46,103,104],{},"User and app actions: the power button, an emergency switch, the app turning the BMS off.",[46,106,107],{},"Remote switches: the app, RS485 or CAN turning charging or discharging on or off.",[46,109,110],{},"Power events: Boot, shutdown and sleep.",[46,112,113],{},"Faults: abnormal states such as a wrong cell count, a coprocessor error or a MOS failure. These are not ordinary protections and deserve attention.",[10,115,116],{},"Over-voltage and under-voltage trips name the cell. That is the most useful detail in the whole file.",[20,118,120],{"id":119},"protection-episodes","Protection episodes",[10,122,123],{},"One trip and its release make an episode. The time between them is how long the protection held. The time from the release to the next trip of the same kind is the re-arm time.",[10,125,126],{},"Episodes explain why one problem can produce a thousand rows. If a charger keeps pushing a cell over the limit, the BMS trips, releases after a pause, and trips again. Each loop adds two rows. It is one problem repeating.",[10,128,129],{},"A Boot row closes any open episode, because the BMS lost its state. A trip with no release before the end of the file stays open.",[20,131,133],{"id":132},"common-diagnoses","Common diagnoses",[10,135,136],{},"These are the patterns the analysis page looks for, with the numbers it uses.",[10,138,139,143,144,148],{},[140,141,142],"strong",{},"Charger above the cell limit (charger voltage too high)."," The example log has 1090 over-voltage trips, 1083 of them on cell 01, with a spread between the highest and lowest cell mostly under 10 mV. That means the cells are in balance and the charger holds the pack too high; ",[14,145,147],{"href":146},"\u002Fguides\u002Fjk-bms-cell-overcharge-protection-tripping","why cell overcharge protection keeps tripping"," has the figures and the fix.",[10,150,151,154,155,159,160,164],{},[140,152,153],{},"Weak cell on top."," If at least 80% of the trips name one cell and the spread is 50 mV or more, that cell is the problem. Check the spread first, since the named cell alone can mislead. Review the ",[14,156,158],{"href":157},"\u002Fguides\u002Fjk-bms-balance-settings","balance settings"," and check the cell and its wiring. For the pattern in the data, see ",[14,161,163],{"href":162},"\u002Fguides\u002Fjk-bms-weak-cell-log","finding a weak cell in the log",".",[10,166,167,170],{},[140,168,169],{},"Under-voltage."," The same split applies at the bottom. One cell far below the rest points to a weak cell. A tight spread points to an empty pack, often an inverter cut-off set too low. Compare Cell UVP and SOC-0% voltage with where the inverter stops.",[10,172,173,176],{},[140,174,175],{},"Cycling."," Ten or more over-voltage trips with a median re-arm under 60 s is reported as cycling. Cell OVP recovery and Cell RCV are the fields to look at.",[10,178,179,182,183,164],{},[140,180,181],{},"Temperature and short circuit."," Temperature trips show the peak value reached. A MOS temperature of 70 °C or more without a trip is flagged as a warning. Any short circuit trip is critical. Check the load, the wiring and the delay setting described in ",[14,184,186],{"href":185},"\u002Fguides\u002Fjk-bms-ocp-scp-settings","overcurrent and short circuit settings",[10,188,189,192,193,164],{},[140,190,191],{},"Unexpected reboots."," A Boot row that does not follow a power-off or shutdown row within 60 s counts as unexpected. The example has 7 boots, 2 of them unexpected, because the other five follow a \"Button to turn it off\" row. Check the power supply and the wiring to the BMS, and see ",[14,194,196],{"href":195},"\u002Fguides\u002Fjk-bms-reboots-power-events","reading reboots and power events",[10,198,199,202,203,207],{},[140,200,201],{},"Capacity changes."," If full capacity changes in the log, for example from 200 Ah to 334 Ah, someone edited the capacity setting. See ",[14,204,206],{"href":205},"\u002Fguides\u002Fjk-bms-soc-calibration","SOC calibration"," for how the BMS tracks remaining capacity.",[20,209,211],{"id":210},"analyse-your-log-in-the-browser","Analyse your log in the browser",[10,213,214,215,217,218,220],{},"Open the ",[14,216,17],{"href":16}," and drop in the ",[28,219,57],{}," file. It is read in your browser and never uploaded. You get the episodes, the per-cell trip counts and the findings above.",[10,222,223,224,227,228,232,233,237,238,242],{},"You can also attach a ",[28,225,226],{},".jkcfg"," export of the same BMS. The page then draws your thresholds as lines on the charts and cross-checks the log against them: trip voltage against Cell OVP, cell count, capacity, the charger setpoint against cells × Cell RCV, peak current near the overcurrent limits, and MOS temperature near the MOS limit. Fix what it finds in the ",[14,229,231],{"href":230},"\u002F","editor",", ideally by writing the changes ",[14,234,236],{"href":235},"\u002Fguides\u002Fjk-bms-bluetooth-browser","over Bluetooth",", and see ",[14,239,241],{"href":240},"\u002Fguides\u002Fjk-bms-sending-failure","JK BMS sending failure"," if the BMS rejects an imported file.",{"title":244,"searchDepth":245,"depth":245,"links":246},"",3,[247,249,250,251,252,253,254],{"id":22,"depth":248,"text":23},2,{"id":40,"depth":248,"text":41},{"id":64,"depth":248,"text":65},{"id":92,"depth":248,"text":93},{"id":119,"depth":248,"text":120},{"id":132,"depth":248,"text":133},{"id":210,"depth":248,"text":211},"2026-10-02","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.","md",[259,260,261,262,263,264],"jk-bms detail log","jk bms log export","cell overcharge protection","bms event log","jk-bms troubleshooting","charger voltage too high",{},true,"\u002Fguides\u002Fjk-bms-detail-log",[269,270,271],"jk-bms-balance-settings","jk-bms-soc-calibration","jk-bms-cell-overcharge-protection-tripping",{"title":5,"description":256},"guides\u002Fjk-bms-detail-log","2026-10-04","zgAGM-APLeTnKzi9tJg8dmnAJPAt6WD4r1OA9uaonOA",[277,281,284,287,288,292,296,300,304,307,311,315,318,321,324,327],{"path":235,"title":278,"description":279,"date":274,"updated":280},"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":157,"title":282,"description":283,"date":255,"updated":274},"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":146,"title":285,"description":286,"date":255,"updated":280},"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":267,"title":5,"description":256,"date":255,"updated":274},{"path":289,"title":290,"description":291,"date":255,"updated":274},"\u002Fguides\u002Fjk-bms-export-import-settings","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":293,"title":294,"description":295,"date":255,"updated":274},"\u002Fguides\u002Fjk-bms-lifepo4-settings","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":297,"title":298,"description":299,"date":255,"updated":280},"\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":301,"title":302,"description":303,"date":255,"updated":274},"\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":185,"title":305,"description":306,"date":255,"updated":274},"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":308,"title":309,"description":310,"date":255,"updated":274},"\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":312,"title":313,"description":314,"date":255,"updated":274},"\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":195,"title":316,"description":317,"date":255,"updated":274},"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":240,"title":319,"description":320,"date":255,"updated":274},"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":205,"title":322,"description":323,"date":255,"updated":274},"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":162,"title":325,"description":326,"date":255,"updated":280},"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":328,"title":329,"description":330,"date":255,"updated":274},"\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.",1791151315607]