三步上手ESPHome JK-BMS 完整新手指南【免费下载链接】esphome-jk-bmsESPHome component to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE项目地址: https://gitcode.com/gh_mirrors/es/esphome-jk-bms用 esphome-jk-bms 这个项目把极空 JK-BMS 锂电池保护板接进 Home Assistant 只需要几行配置通过 UART-TTL 串口或 BLE 蓝牙读取每节电芯电压、电流、温度和全部保护参数还能远程开关充放电、控制主动均衡。无论你手里是拆机电芯拼的电池组还是带 BLE 的主动均衡器它都能变成你智能家居面板上的实时数据。一键定位仓库关键文件 这一节帮你搞清楚克隆下来这么多文件到底该先看哪几个。你真正会碰到的只有 4 处其余都是开发用的esphome-jk-bms/ ├── esp32-ble-example.yaml # BLE 蓝牙接入示例你主要改它 ├── esp32-example.yaml # UART-TTL 串口接入示例 ├── esp32-ble-scanner.yaml # BLE 扫描器用来找 BMS 的 MAC 地址 ├── components/ # ESPHome 组件源码jk_bms、jk_bms_ble 等 └── docs/ # 协议文档、抓包记录两个 example yaml 是官方proof of concept不用自己从零写复制后改几处就能烧录。三行命令跑通最小配置 这一节带你从零到固件上板全程不超过 3 条命令。先装 ESPHome、克隆仓库pip3 install esphome git clone https://gitcode.com/gh_mirrors/es/esphome-jk-bms cd esphome-jk-bms然后新建secrets.yaml填 6 项Wi-Fi、MQTT 服务器以及 BMS 的蓝牙 MAC 地址。MAC 不知道把esp32-ble-scanner.yaml先烧进一块 ESP32日志里会打印出所有 JK 设备的名和 MAC。wifi_ssid: MY_WIFI_SSID wifi_password: MY_WIFI_PASSWORD mqtt_host: MY_MQTT_HOST mqtt_username: MY_MQTT_USERNAME mqtt_password: MY_MQTT_PASSWORD bms0_mac_address: C8:47:8C:E1:E2:AA最后一条命令编译、烧录、看日志一气呵成esphome run esp32-ble-example.yaml如果你的 ESP 是插到 BMS 标注为RS485的 4 针串口口上实际是 UART-TTL则改用esp32-example.yaml它默认用 GPIO16/GPIO17。配置项速查表 这一节帮你回答这一行到底管什么改配置时对照即可。配置项作用示例值 / 说明protocol_versionBLE 协议版本跟硬件版本走硬件 6.x–10.x 用JK02_24S11.x 及以上用JK02_32S3.0 及以下老款用JK04external_components指定从哪拉取本组件示例里已写好一般不用动ble_client.mac_addressBLE 连接目标取secrets.yaml里的bms0_mac_addressthrottleBLE 轮询节流蓝牙示例5s别调太小BLE 带宽有限jk_bms.update_interval串口轮询周期UART-TTL 示例5suart.baud_rate串口波特率仅 UART-TTL固定115200建议接硬件 UARTapi/mqtt数据上报二选一用 Home Assistant 就留api注释掉mqtt反之亦然避坑指南与延伸阅读 ⚠️这一节帮你跳过别人已经踩过的坑。协议版本选错 烧完没数据。这是最高频问题拿不准就打开极空 App 看硬件版本号对照速查表选protocol_version。ESP32 上全量传感器可能死机重启官方已知问题属于栈溢出。解决办法是减少 sensor 数量或加大栈尺寸。电池类型传感器永远显示Ternary Lithium这是 BMS 固件的怪癖不是你配置错了直接忽略即可。想再深一层协议细节、蓝牙抓包帧都在docs/目录里组件的解析实现可以对照components/jk_bms_ble蓝牙和components/jk_bms串口两个目录读。下一步先烧扫描器确认可搜到你的 BMS把 MAC 填进secrets.yaml再烧正式示例固件。【免费下载链接】esphome-jk-bmsESPHome component to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE项目地址: https://gitcode.com/gh_mirrors/es/esphome-jk-bms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 三步上手：ESPHome JK-BMS 完整新手指南
三步上手ESPHome JK-BMS 完整新手指南【免费下载链接】esphome-jk-bmsESPHome component to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE项目地址: https://gitcode.com/gh_mirrors/es/esphome-jk-bms用 esphome-jk-bms 这个项目把极空 JK-BMS 锂电池保护板接进 Home Assistant 只需要几行配置通过 UART-TTL 串口或 BLE 蓝牙读取每节电芯电压、电流、温度和全部保护参数还能远程开关充放电、控制主动均衡。无论你手里是拆机电芯拼的电池组还是带 BLE 的主动均衡器它都能变成你智能家居面板上的实时数据。一键定位仓库关键文件 这一节帮你搞清楚克隆下来这么多文件到底该先看哪几个。你真正会碰到的只有 4 处其余都是开发用的esphome-jk-bms/ ├── esp32-ble-example.yaml # BLE 蓝牙接入示例你主要改它 ├── esp32-example.yaml # UART-TTL 串口接入示例 ├── esp32-ble-scanner.yaml # BLE 扫描器用来找 BMS 的 MAC 地址 ├── components/ # ESPHome 组件源码jk_bms、jk_bms_ble 等 └── docs/ # 协议文档、抓包记录两个 example yaml 是官方proof of concept不用自己从零写复制后改几处就能烧录。三行命令跑通最小配置 这一节带你从零到固件上板全程不超过 3 条命令。先装 ESPHome、克隆仓库pip3 install esphome git clone https://gitcode.com/gh_mirrors/es/esphome-jk-bms cd esphome-jk-bms然后新建secrets.yaml填 6 项Wi-Fi、MQTT 服务器以及 BMS 的蓝牙 MAC 地址。MAC 不知道把esp32-ble-scanner.yaml先烧进一块 ESP32日志里会打印出所有 JK 设备的名和 MAC。wifi_ssid: MY_WIFI_SSID wifi_password: MY_WIFI_PASSWORD mqtt_host: MY_MQTT_HOST mqtt_username: MY_MQTT_USERNAME mqtt_password: MY_MQTT_PASSWORD bms0_mac_address: C8:47:8C:E1:E2:AA最后一条命令编译、烧录、看日志一气呵成esphome run esp32-ble-example.yaml如果你的 ESP 是插到 BMS 标注为RS485的 4 针串口口上实际是 UART-TTL则改用esp32-example.yaml它默认用 GPIO16/GPIO17。配置项速查表 这一节帮你回答这一行到底管什么改配置时对照即可。配置项作用示例值 / 说明protocol_versionBLE 协议版本跟硬件版本走硬件 6.x–10.x 用JK02_24S11.x 及以上用JK02_32S3.0 及以下老款用JK04external_components指定从哪拉取本组件示例里已写好一般不用动ble_client.mac_addressBLE 连接目标取secrets.yaml里的bms0_mac_addressthrottleBLE 轮询节流蓝牙示例5s别调太小BLE 带宽有限jk_bms.update_interval串口轮询周期UART-TTL 示例5suart.baud_rate串口波特率仅 UART-TTL固定115200建议接硬件 UARTapi/mqtt数据上报二选一用 Home Assistant 就留api注释掉mqtt反之亦然避坑指南与延伸阅读 ⚠️这一节帮你跳过别人已经踩过的坑。协议版本选错 烧完没数据。这是最高频问题拿不准就打开极空 App 看硬件版本号对照速查表选protocol_version。ESP32 上全量传感器可能死机重启官方已知问题属于栈溢出。解决办法是减少 sensor 数量或加大栈尺寸。电池类型传感器永远显示Ternary Lithium这是 BMS 固件的怪癖不是你配置错了直接忽略即可。想再深一层协议细节、蓝牙抓包帧都在docs/目录里组件的解析实现可以对照components/jk_bms_ble蓝牙和components/jk_bms串口两个目录读。下一步先烧扫描器确认可搜到你的 BMS把 MAC 填进secrets.yaml再烧正式示例固件。【免费下载链接】esphome-jk-bmsESPHome component to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE项目地址: https://gitcode.com/gh_mirrors/es/esphome-jk-bms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考