JK Preset Studio

JK BMS 设置导出与导入：.jkcfg 文件完全指南

JK BMS 手机 app 自带导出和导入功能。导出会生成一个很小的 .jkcfg 文件，里面是你的全部配置；导入则把它发回 BMS。这个文件可以作为备份保存，但如果要修改，只能用能自动修正校验和的工具，比如 JK Preset Studio 编辑器。如果你只是想修改设置，完全可以跳过文件，在浏览器中通过蓝牙写入。

.jkcfg 文件是什么

文件大小正好 600 字节，由两个 300 字节的数据帧组成，和 BMS 通过蓝牙发送的数据帧完全相同。

  • 帧 0 存放设置：电压、电流、均衡、延时、温度。
  • 帧 1 存放设备信息：型号、硬件和软件版本、序列号、设备名称以及密码字段。

每帧最后一个字节是校验和，等于前 299 个字节之和取低 8 位。校验和与数据对不上，就说明文件已损坏。

文件结构来自开源项目 syssi/esphome-jk-bms，该项目记录了 JK02_32S 协议。JK Preset Studio 仓库中的示例文件导出自一块固件为 19.26 的 JK-PB2A16S20P。

导出与导入 JK BMS 设置：先备份

不同版本 app 的菜单名称可能不一样，下面的步骤仅作参考。

  1. 在 JK BMS app 中连接 BMS。
  2. 打开设置页面，找到导出（Export）和导入（Import）选项。
  3. 选择导出并保存文件。
  4. 把文件复制到安全的地方，比如网盘或电脑。

文件保存在哪里取决于你的手机和 app 版本。留意弹出的保存或分享对话框，在那里选择保存位置。如果找不到文件，就在手机里搜索 .jkcfg。

每次升级固件之前、每次大幅修改设置之前，都先备份一次。

为什么不要手动编辑

十六进制编辑器可以改任何一个字节，但校验和错误的文件就是坏文件，导入时可能被拒绝。你还得知道每个字段的偏移量、长度和缩放系数。电压是以整数存储的，比如 3.45 V 存为 3450。改错一个字节，某个保护值就可能变得毫无意义。

这是二进制文件。用文本编辑器打开只会看到乱码，一旦保存就会把文件弄坏。

在浏览器中安全编辑

  1. 打开编辑器，把 .jkcfg 文件拖进去。文件不会上传，所有处理都在你的浏览器里完成。
  2. 修改需要调整的数值。每个参数都有说明和推荐范围。
  3. 查看警告。编辑器会按照 JK 固件导入时的规则检查数值，例如 OVPR 必须低于 SOC-100% 电压，SOC-100% 电压必须低于 RCV。
  4. 也可以先根据电芯类型和期望的寿命选择一个现成预设，再做微调。
  5. 下载结果文件。

编辑器只把你改动过的字段写入原始字节的副本，未知字节和保留字节原样保留，然后重新计算两个校验和。所有字段的说明见参数参考。

或者跳过文件：通过蓝牙写入

在电脑或 Android 手机的 Chrome 或 Edge 中，编辑器可以直接连接 BMS。关闭 JK app，点击“连接 BMS”并选择你的 BMS。编辑器读取的正是组成 .jkcfg 文件的那两个帧，所以上面介绍的一切照样适用。

点击“写入 BMS”后，编辑器会按固件接受的顺序逐项写入设置，并在每一步之后回读 BMS。不需要导入分步文件，也不用猜是哪个数值失败了。你的型号不具备的设置会在连接后立即被识别并跳过。蓝牙指南介绍了完整流程。

文件仍然适合用于备份、在 Firefox、Safari 和 iPhone 上使用，以及在电池组组装之前准备设置。

把文件导入回 BMS

  1. 把编辑后的文件复制到手机上。
  2. 在 app 中连接 BMS。
  3. 在设置页面选择导入，选中该文件。
  4. 导入完成后在 app 里核对各项数值。

app 是逐项写入设置的，固件会拿每一项和 BMS 当前保存的值做比较。所以即使最终数值全部合法，导入到一半也可能失败。这就是编辑器有时会给你几个带编号的分步文件的原因，请按顺序依次导入，或者通过蓝牙写入，由编辑器替你处理顺序。如果看到 "This parameter does not apply to the connected device. (Sending failure)"（该参数不适用于当前设备，发送失败），请阅读 Sending failure 指南。

使用场景

  • 复制到第二个电池组。 从第一块 BMS 导出，再导入第二块，或者打开文件通过蓝牙写入第二块 BMS。先确认电芯数量和型号一致。
  • 保留一份确认可用的备份。 升级固件前，把正常工作时的配置文件存好。
  • 分享设置。 把文件发给其他 DIY 玩家。发送前先清除密码（见常见问题）。
  • 从合理的数值起步。 常用范围见 LiFePO4 设置指南。

常见错误

  • 把文件导入到电芯数量不同的电池组。
  • 编辑器给出了多个步骤，却一次性导入最终文件。
  • 手动改字节，导致校验和错误。
  • 忘了文件里包含你的密码。

常见问题

可以用文本编辑器修改这个文件吗？

不可以。它是 600 字节的二进制文件，文本编辑器会把它损坏。只有在你能同时修正两个校验和时才用十六进制编辑器，或者直接用浏览器编辑器，它会自动处理。各字段的作用可参考 JK BMS 参数详解。

文件里有我的密码吗？

可能有。设备信息帧里有设备密码和设置密码两个字段，每个最多 16 个字符。请把文件当作私密文件对待，分享前清空这些字段。详见密码指南。

其他型号导出的文件能导入吗？

不一定能成功。固件会拒绝不适用于当前设备的数值，电芯数量、额定电流或固件版本不同都可能导致失败。有些型号还缺少整项功能：固件 19.25 的 JK-B2A8S20P 没有浮充电压、加热和 CAN 设置。通过蓝牙连接时，编辑器会在连接后立即找出这些缺项并跳过。本文件格式已在固件 19.26 的 JK-PB2A16S20P 上验证。

连接你的 BMS 或打开你的 .jkcfg，在写入任何内容之前先在编辑器中检查数值。

相关指南

全部指南