JK Preset Studio

在浏览器中通过蓝牙修改 JK BMS 设置

你可以直接在浏览器里通过蓝牙修改 JK BMS 设置，不需要 JK app，也不需要导出文件。在 Chrome 或 Edge 中打开 JK Preset Studio 编辑器，点击“连接 BMS”并选择你的 BMS。编辑器会读取全部设置，让你借助预设和校验进行修改，然后逐项写回，每一步之后都会回读 BMS。

需要准备什么

  • 支持 Web Bluetooth 的浏览器。 Windows、macOS、ChromeOS 或 Android 上的 Chrome 或 Edge。Firefox、Safari 以及 iPhone 和 iPad 上的所有浏览器都不支持。在这些环境中，请改用 .jkcfg 文件流程。
  • 关闭 JK app。 BMS 同一时间只接受一个蓝牙连接。如果 app 或其他监控设备（例如运行 esphome 的 ESP32）已经连上，BMS 就不会出现在列表里，或者连接会断开。
  • 使用 JK02 协议的 JK BMS。 我们测试过 JK-PB2A16S20P（固件 19.26）和 JK-B2A8S20P（固件 19.25）。其他固件为 19 版的 JK 保护板使用相同的协议。
  • 距离。 离 BMS 保持在几米之内。金属电池柜会大大缩短有效距离。

连接并读取设置

  1. 打开首页，点击“连接 BMS”。
  2. 浏览器会列出附近的设备。JK 保护板通常以序列号或以 JK 开头的名称广播。选择你的设备。
  3. 编辑器从 BMS 读取两个数据帧：一个包含全部设置，一个包含设备信息。BMS 发送设置时会响一声。
  4. 编辑器打开后会显示你的数值，以及型号、硬件和固件版本。

这两个帧正是 JK app 保存在 .jkcfg 文件里的内容。你随时可以把它们下载成文件，在修改任何东西之前，这是一份很好的备份。

你的型号具备哪些设置

并非每块 JK BMS 都具备全部功能。设置帧总是包含所有字段，即使保护板没有对应的功能：一块没有加热功能的 8S B2A 保护板仍然会报告加热启动温度。所以连接后，编辑器会立即直接询问 BMS。它把每个可选设置的当前值写回去，数值不会有任何变化，而 BMS 会逐项应答：已接受，或者“该型号没有此项设置”。

BMS 不具备的设置会标为“此 BMS 无此项”。它们仍然可见，但不能编辑，预设不会改动它们，也不会对它们做校验。在我们的 JK-B2A8S20P 上，这包括浮充电压（RFV）、浮充模式、加热、预充、PCL 模块、端口切换以及 CAN 和 UART2 协议。结果按该 BMS 保存在你的浏览器中，下次连接时立即生效。

编辑并应用预设

每个参数都有简短说明、适合你电芯类型的推荐范围以及资料来源链接。你可以：

  • 修改单个数值，例如 OVP 或均衡启动电压；
  • 为 LiFePO4、NMC 或 LTO 应用一个现成预设，再做微调；
  • 在参数参考中查看每个字段的作用。

编辑器会在你输入时检查相关数值，例如 OVPR 必须低于 SOC-100% 电压，而 SOC-100% 电压必须低于 RCV。错误会阻止写入，警告只作提示。

写入并校验

点击“写入 BMS”。在发送任何内容之前，对话框会先显示计划：分几步、每一步写哪些设置，以及哪些已编辑的设置会被跳过。请先下载对话框里提供的备份。

固件会拿每个写入的数值和 BMS 当时保存的值做比较，所以同一组最终数值按一种顺序会失败，换一种顺序就能通过。编辑器把你的修改拆分成无论按什么顺序都安全的步骤。每一步之后，它都会回读 BMS 并逐项比较。

BMS 会用结果代码应答每一次写入。如果某个数值因与其他设置冲突而被拒绝，写入会立即停止，编辑器会显示失败的设置以及 BMS 当前保存的值。如果发现某项设置你的型号并不具备，它会被跳过并列出来。没有任何失败会被悄悄忽略。

我们在真实硬件上发现了一个细节：读取后立即发送的写入可能被丢弃，而且没有任何应答。因此编辑器在每次读取后都会稍等片刻，如果没有收到应答，会重发一次。

什么时候文件仍然更合适

  • 你的浏览器或手机不支持 Web Bluetooth。
  • 你需要长期备份，或想同时保存多套配置。
  • 你要在电池组组装之前准备设置，或者把设置发给别人。

这些情况请参考导出与导入指南。如果导入时出现 "Sending failure"，请阅读 Sending failure 指南。

常见错误

  • JK app 没有关闭，导致 BMS 一直不出现在列表里。
  • 没有备份就写入。请先下载当前设置。
  • 以为每个型号的每项设置都能修改。请留意“此 BMS 无此项”标记。
  • 写入了其他电芯类型的数值。请从 LiFePO4 设置指南 或对应的预设开始。

常见问题

通过蓝牙写入需要 BMS 密码吗？

在我们的测试中，BMS 不需要密码就接受了写入；密码是由 JK app 自己检查的。有一份关于较旧 V15 固件的报告称，修改设置密码后写入就不再生效，所以结果可能因设备而异。

安全吗？

编辑器只写入你修改过的内容，按安全顺序进行，并在之后检查每个数值。错误的数值仍然可能损坏电芯，所以请将它们与电芯规格书进行对比，并保留好备份。

会有数据离开我的电脑吗？

不会。浏览器直接与 BMS 通讯，设置永远不会被上传。

BMS 为什么会响？

BMS 在被请求读取设置时会响一声。编辑器在连接时读取一次，每个写入步骤之后再读取一次。

连接你的 BMS，一分钟内就能看到当前设置。

相关指南

全部指南