[{"data":1,"prerenderedAt":381},["ShallowReactive",2],{"guide-zh-jk-bms-export-import-settings":3,"guides-zh":323},{"id":4,"title":5,"body":6,"date":302,"description":303,"extension":304,"keywords":305,"meta":312,"navigation":313,"path":314,"related":315,"seo":319,"stem":320,"updated":321,"__hash__":322},"guides_zh\u002Fguides\u002Fjk-bms-export-import-settings.md","JK BMS 设置导出与导入：.jkcfg 文件完全指南",{"type":7,"value":8,"toc":284},"minimark",[9,29,34,37,54,57,67,71,74,89,94,97,100,103,106,109,138,145,149,158,165,168,172,186,193,196,226,229,243,246,251,258,262,269,273,276],[10,11,12,13,17,18,23,24,28],"p",{},"JK BMS 手机 app 自带导出和导入功能。导出会生成一个很小的 ",[14,15,16],"code",{},".jkcfg"," 文件，里面是你的全部配置；导入则把它发回 BMS。这个文件可以作为备份保存，但如果要修改，只能用能自动修正校验和的工具，比如 ",[19,20,22],"a",{"href":21},"\u002F","JK Preset Studio 编辑器","。如果你只是想修改设置，完全可以跳过文件，",[19,25,27],{"href":26},"\u002Fguides\u002Fjk-bms-bluetooth-browser","在浏览器中通过蓝牙写入","。",[30,31,33],"h2",{"id":32},"jkcfg-文件是什么",".jkcfg 文件是什么",[10,35,36],{},"文件大小正好 600 字节，由两个 300 字节的数据帧组成，和 BMS 通过蓝牙发送的数据帧完全相同。",[38,39,40,48],"ul",{},[41,42,43,47],"li",{},[44,45,46],"strong",{},"帧 0"," 存放设置：电压、电流、均衡、延时、温度。",[41,49,50,53],{},[44,51,52],{},"帧 1"," 存放设备信息：型号、硬件和软件版本、序列号、设备名称以及密码字段。",[10,55,56],{},"每帧最后一个字节是校验和，等于前 299 个字节之和取低 8 位。校验和与数据对不上，就说明文件已损坏。",[10,58,59,60,66],{},"文件结构来自开源项目 ",[19,61,65],{"href":62,"rel":63},"https:\u002F\u002Fgithub.com\u002Fsyssi\u002Fesphome-jk-bms",[64],"nofollow","syssi\u002Fesphome-jk-bms","，该项目记录了 JK02_32S 协议。JK Preset Studio 仓库中的示例文件导出自一块固件为 19.26 的 JK-PB2A16S20P。",[30,68,70],{"id":69},"导出与导入-jk-bms-设置先备份","导出与导入 JK BMS 设置：先备份",[10,72,73],{},"不同版本 app 的菜单名称可能不一样，下面的步骤仅作参考。",[75,76,77,80,83,86],"ol",{},[41,78,79],{},"在 JK BMS app 中连接 BMS。",[41,81,82],{},"打开设置页面，找到导出（Export）和导入（Import）选项。",[41,84,85],{},"选择导出并保存文件。",[41,87,88],{},"把文件复制到安全的地方，比如网盘或电脑。",[10,90,91,92,28],{},"文件保存在哪里取决于你的手机和 app 版本。留意弹出的保存或分享对话框，在那里选择保存位置。如果找不到文件，就在手机里搜索 ",[14,93,16],{},[10,95,96],{},"每次升级固件之前、每次大幅修改设置之前，都先备份一次。",[30,98,99],{"id":99},"为什么不要手动编辑",[10,101,102],{},"十六进制编辑器可以改任何一个字节，但校验和错误的文件就是坏文件，导入时可能被拒绝。你还得知道每个字段的偏移量、长度和缩放系数。电压是以整数存储的，比如 3.45 V 存为 3450。改错一个字节，某个保护值就可能变得毫无意义。",[10,104,105],{},"这是二进制文件。用文本编辑器打开只会看到乱码，一旦保存就会把文件弄坏。",[30,107,108],{"id":108},"在浏览器中安全编辑",[75,110,111,121,124,127,135],{},[41,112,113,114,117,118,120],{},"打开",[19,115,116],{"href":21},"编辑器","，把 ",[14,119,16],{}," 文件拖进去。文件不会上传，所有处理都在你的浏览器里完成。",[41,122,123],{},"修改需要调整的数值。每个参数都有说明和推荐范围。",[41,125,126],{},"查看警告。编辑器会按照 JK 固件导入时的规则检查数值，例如 OVPR 必须低于 SOC-100% 电压，SOC-100% 电压必须低于 RCV。",[41,128,129,130,134],{},"也可以先根据电芯类型和期望的寿命选择一个",[19,131,133],{"href":132},"\u002Fpresets","现成预设","，再做微调。",[41,136,137],{},"下载结果文件。",[10,139,140,141,28],{},"编辑器只把你改动过的字段写入原始字节的副本，未知字节和保留字节原样保留，然后重新计算两个校验和。所有字段的说明见",[19,142,144],{"href":143},"\u002Fparameters","参数参考",[30,146,148],{"id":147},"或者跳过文件通过蓝牙写入","或者跳过文件：通过蓝牙写入",[10,150,151,152,154,155,157],{},"在电脑或 Android 手机的 Chrome 或 Edge 中，",[19,153,116],{"href":21},"可以直接连接 BMS。关闭 JK app，点击“连接 BMS”并选择你的 BMS。编辑器读取的正是组成 ",[14,156,16],{}," 文件的那两个帧，所以上面介绍的一切照样适用。",[10,159,160,161,164],{},"点击“写入 BMS”后，编辑器会按固件接受的顺序逐项写入设置，并在每一步之后回读 BMS。不需要导入分步文件，也不用猜是哪个数值失败了。你的型号不具备的设置会在连接后立即被识别并跳过。",[19,162,163],{"href":26},"蓝牙指南","介绍了完整流程。",[10,166,167],{},"文件仍然适合用于备份、在 Firefox、Safari 和 iPhone 上使用，以及在电池组组装之前准备设置。",[30,169,171],{"id":170},"把文件导入回-bms","把文件导入回 BMS",[75,173,174,177,180,183],{},[41,175,176],{},"把编辑后的文件复制到手机上。",[41,178,179],{},"在 app 中连接 BMS。",[41,181,182],{},"在设置页面选择导入，选中该文件。",[41,184,185],{},"导入完成后在 app 里核对各项数值。",[10,187,188,189,28],{},"app 是逐项写入设置的，固件会拿每一项和 BMS 当前保存的值做比较。所以即使最终数值全部合法，导入到一半也可能失败。这就是编辑器有时会给你几个带编号的分步文件的原因，请按顺序依次导入，或者通过蓝牙写入，由编辑器替你处理顺序。如果看到 \"This parameter does not apply to the connected device. (Sending failure)\"（该参数不适用于当前设备，发送失败），请阅读 ",[19,190,192],{"href":191},"\u002Fguides\u002Fjk-bms-sending-failure","Sending failure 指南",[30,194,195],{"id":195},"使用场景",[38,197,198,204,210,216],{},[41,199,200,203],{},[44,201,202],{},"复制到第二个电池组。"," 从第一块 BMS 导出，再导入第二块，或者打开文件通过蓝牙写入第二块 BMS。先确认电芯数量和型号一致。",[41,205,206,209],{},[44,207,208],{},"保留一份确认可用的备份。"," 升级固件前，把正常工作时的配置文件存好。",[41,211,212,215],{},[44,213,214],{},"分享设置。"," 把文件发给其他 DIY 玩家。发送前先清除密码（见常见问题）。",[41,217,218,221,222,28],{},[44,219,220],{},"从合理的数值起步。"," 常用范围见 ",[19,223,225],{"href":224},"\u002Fguides\u002Fjk-bms-lifepo4-settings","LiFePO4 设置指南",[30,227,228],{"id":228},"常见错误",[38,230,231,234,237,240],{},[41,232,233],{},"把文件导入到电芯数量不同的电池组。",[41,235,236],{},"编辑器给出了多个步骤，却一次性导入最终文件。",[41,238,239],{},"手动改字节，导致校验和错误。",[41,241,242],{},"忘了文件里包含你的密码。",[30,244,245],{"id":245},"常见问题",[247,248,250],"h3",{"id":249},"可以用文本编辑器修改这个文件吗","可以用文本编辑器修改这个文件吗？",[10,252,253,254,28],{},"不可以。它是 600 字节的二进制文件，文本编辑器会把它损坏。只有在你能同时修正两个校验和时才用十六进制编辑器，或者直接用浏览器编辑器，它会自动处理。各字段的作用可参考 ",[19,255,257],{"href":256},"\u002Fguides\u002Fjk-bms-parameters-explained","JK BMS 参数详解",[247,259,261],{"id":260},"文件里有我的密码吗","文件里有我的密码吗？",[10,263,264,265,28],{},"可能有。设备信息帧里有设备密码和设置密码两个字段，每个最多 16 个字符。请把文件当作私密文件对待，分享前清空这些字段。详见",[19,266,268],{"href":267},"\u002Fguides\u002Fjk-bms-password","密码指南",[247,270,272],{"id":271},"其他型号导出的文件能导入吗","其他型号导出的文件能导入吗？",[10,274,275],{},"不一定能成功。固件会拒绝不适用于当前设备的数值，电芯数量、额定电流或固件版本不同都可能导致失败。有些型号还缺少整项功能：固件 19.25 的 JK-B2A8S20P 没有浮充电压、加热和 CAN 设置。通过蓝牙连接时，编辑器会在连接后立即找出这些缺项并跳过。本文件格式已在固件 19.26 的 JK-PB2A16S20P 上验证。",[10,277,278,283],{},[19,279,280,281],{"href":21},"连接你的 BMS 或打开你的 ",[14,282,16],{},"，在写入任何内容之前先在编辑器中检查数值。",{"title":285,"searchDepth":286,"depth":286,"links":287},"",3,[288,290,291,292,293,294,295,296,297],{"id":32,"depth":289,"text":33},2,{"id":69,"depth":289,"text":70},{"id":99,"depth":289,"text":99},{"id":108,"depth":289,"text":108},{"id":147,"depth":289,"text":148},{"id":170,"depth":289,"text":171},{"id":195,"depth":289,"text":195},{"id":228,"depth":289,"text":228},{"id":245,"depth":289,"text":245,"children":298},[299,300,301],{"id":249,"depth":286,"text":250},{"id":260,"depth":286,"text":261},{"id":271,"depth":286,"text":272},"2026-10-02","如何用 JK BMS app 导出和导入保护板设置，.jkcfg 文件里有什么，为什么手动改会损坏，以及如何在浏览器里安全编辑。","md",[306,307,308,309,310,311],"jk bms 导出设置","jk bms 导入设置","jk bms 参数备份","jkcfg 文件","jk bms 配置文件","极空 保护板 参数导入",{},true,"\u002Fguides\u002Fjk-bms-export-import-settings",[316,317,318],"jk-bms-sending-failure","jk-bms-lifepo4-settings","jk-bms-password",{"title":5,"description":303},"guides\u002Fjk-bms-export-import-settings","2026-10-04","axOX7H7izNyDA4MW4GP5ddo477pPfM7dJmXB42LJG-8",[324,328,332,336,340,341,344,348,352,356,359,362,366,369,373,377],{"path":26,"title":325,"description":326,"date":321,"updated":327},"在浏览器中通过蓝牙修改 JK BMS 设置","在 Chrome 或 Edge 中连接 JK BMS，读取全部设置，应用预设，再按安全顺序写回并逐项回读校验。无需 JK app。",null,{"path":329,"title":330,"description":331,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-balance-settings","JK BMS 均衡设置：均衡启动电压、触发压差和均衡电流","详解 JK BMS 均衡设置：均衡启动电压、均衡触发压差、最大均衡电流和均衡开关，适用于磷酸铁锂、三元和钛酸锂。",{"path":333,"title":334,"description":335,"date":302,"updated":327},"\u002Fguides\u002Fjk-bms-cell-overcharge-protection-tripping","JK BMS 单体过充保护反复触发：原因与解决方法","JK BMS 单体过充保护每分钟触发又解除？了解充电器设得过高为何导致这种情况、如何与弱单体区分，以及怎样解决。",{"path":337,"title":338,"description":339,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-detail-log","如何导出并读懂 JK-BMS 详细日志（Detail Log）","JK-BMS 详细日志包含什么、如何从 app 导出、如何读懂其中的事件，以及日志分析页能告诉你哪些保护动作和故障信息。",{"path":314,"title":5,"description":303,"date":302,"updated":321},{"path":224,"title":342,"description":343,"date":302,"updated":321},"磷酸铁锂 JK BMS 参数设置：8S、16S，280Ah 与 314Ah 电芯","磷酸铁锂电池组的 JK BMS 参数设置：8S 和 16S、280Ah 与 314Ah 电芯的单体电压、均衡、电流和温度推荐值，分三种损耗等级。",{"path":345,"title":346,"description":347,"date":302,"updated":327},"\u002Fguides\u002Fjk-bms-log-messages-explained","JK BMS 日志消息详解：Boot、Time calibration、保护","每条 JK BMS 日志消息的含义：Boot、Time calibration、APP open charge、保护触发与解除，以及 Discharge On Failed。",{"path":349,"title":350,"description":351,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-nmc-lto-settings","JK BMS 三元锂与钛酸锂设置：安全的单体参数","JK BMS 三元锂 NMC 与钛酸锂 LTO 电池组设置：单体过压、欠压、均衡、温度和倍率的三档数值，以及编辑器如何识别电芯类型。",{"path":353,"title":354,"description":355,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-ocp-scp-settings","JK BMS 过流保护设置：OCP 与 SCP 参数指南","详解 JK BMS 过流保护设置：充放电 OCP 电流上限、延时、恢复时间与短路保护 SCP，附推荐范围和逆变器选型方法。",{"path":256,"title":357,"description":358,"date":302,"updated":321},"JK BMS 参数详解：按分组逐项讲解每个设置","一篇看懂 JK BMS 参数：单体 OVP、OVPR、UVP、UVPR、均衡、SOC、RCV 与 RFV、电流和温度保护，附磷酸铁锂常用范围。",{"path":267,"title":360,"description":361,"date":302,"updated":321},"JK BMS 密码：默认密码、修改与重置指南","JK BMS 的密码其实有两个：蓝牙连接密码和设置密码。本文介绍出厂默认值、修改方法、密码无效时的排查，以及忘记密码怎么办。",{"path":363,"title":364,"description":365,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-reboots-power-events","JK BMS 重启与充电 MOS 关闭：在日志中读懂电源事件","JK BMS 重启，或充电 MOS 自己关闭？学会读懂详细日志中的 Boot 行和 MOS 状态，分清正常重启与真正的故障。",{"path":191,"title":367,"description":368,"date":302,"updated":321},"JK BMS 发送失败（Sending failure）：原因与逐步解决方法","JK BMS 导入设置时提示发送失败？了解固件拒绝参数的原因（电压顺序链、写入顺序、短路延时），并按步骤解决。",{"path":370,"title":371,"description":372,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-soc-calibration","JK BMS SOC 校准：解决电量漂移、跳变和复位问题","JK BMS SOC 校准详解：SOC 为什么会漂移或跳变，SOC-100% 电压和 SOC-0% 电压的作用，以及如何设置并重新校准电池组。",{"path":374,"title":375,"description":376,"date":302,"updated":327},"\u002Fguides\u002Fjk-bms-weak-cell-log","用 JK BMS 日志找出弱单体：触发、压差与均衡","在 JK BMS 详细日志中找出弱单体：哪节单体先触发、触发时压差有多大，以及这是均衡漂移还是单体已损坏。",{"path":378,"title":379,"description":380,"date":302,"updated":321},"\u002Fguides\u002Fjk-bms-wire-resistance","JK BMS 线阻：均衡线阻异常报警的排查与修复","JK BMS 线阻详解：均衡线阻异常报警的含义、正常数值范围、常见原因，以及如何修好一根有问题的均衡线。",1791151319631]