Arduino-jk-bms

  • 语言HTML
  • 默认分支main
  • 大小362 KB
  • 更新2025年12月29日
在 GitHub 打开
avatarpeff74
32
82
Apache License 2.0

项目介绍

peff74/Arduino-jk-bms 是一个托管在 GitHub 上的开源项目，主要使用 HTML 编写，采用 Apache License 2.0 许可证，目前获得 32 个 Star、8 次 Fork。

仓库全名
peff74/Arduino-jk-bms
开源许可证
Apache License 2.0
Star 数
32
Fork 数
8
未关闭 Issue
2

README 摘要

Arduino script with NimBLE to monitor JK-BMS This project is a modified version of syssi/esphome-jk-bms, rewritten for Arduino using NimBLE. Usefull for v11 / v15 BMS and also for v19 but there seem to be differences depending on which ESP32 you use. Features Real-time Monitoring: All data that are also available via the app Cell voltages, resistances, temperatures, battery voltage, current, state of charge and more…

完整内容见 GitHub 原始 README 或本页 。

常见问题

Arduino-jk-bms 用什么语言开发？

主要使用 HTML 编写，采用 Apache License 2.0 许可证，目前有 32 个 Star。

Arduino-jk-bms 可以免费商用吗？

仓库采用 Apache License 2.0 许可证，可免费使用与修改，商业使用请遵守许可证条款（例如保留版权声明与许可声明）。

如何获取 Arduino-jk-bms 的源码？

可以直接克隆仓库：git clone https://github.com/peff74/Arduino-jk-bms.git，默认分支为 main；安装与运行步骤见仓库 README。

Arduino-jk-bms 最近还在维护吗？

仓库最近一次更新为 2025年12月29日，当前有 2 个未关闭 Issue；Star 数为 32，可作为社区活跃度的参考。

本页面展示项目元数据与原始 README，GitRead 中文社区 编辑团队负责选题收录。

相关仓库

ossu/computer-science avatar
computer-scienceossu
1 天前
211.0k
25.3k
17

通往免费计算机科学自学教育之路！

awesome-listcomputer-sciencecourses+1
HTML
1.8 MB
2
详情
ripienaar/free-for-dev avatar
free-for-devripienaar
1 天前
142.2k
15.3k
15

一份提供免费套餐、对 devops 和 infradev 有吸引力的 SaaS、PaaS 和 IaaS 服务列表

free-for-developersawesome-list
HTML
11.0 MB
0
详情
PKUFlyingPig/cs-self-learning avatar
cs-self-learningPKUFlyingPig
9月17日
76.7k
8.0k
167

计算机自学指南

HTML
70.4 MB
0
详情
eternity4719/HowToLiveBetter avatar
HowToLiveBettereternity4719
2 天前
74.3k
6.5k
13

高性价比人生指南: 长寿防病、急救、省钱理财、法律红线、失业与工伤、医保社保、恋爱婚育、怀孕育儿、创业与做平台合规、出国与技能。每条写明成本、收益、证据等级和原始出处，只引期刊论文与官方文件。

HTML
22.3 MB
0
详情
shanraisshan/claude-code-best-practice avatar
claude-code-best-practiceshanraisshan
6 小时前
68.8k
6.9k
43

从氛围编程到智能体工程——实践让 Claude 臻于完美

agentic-aiagentic-codingagentic-engineering+17
HTML
75.8 MB
0
详情
cathrynlavery/diagram-design avatar
diagram-designcathrynlavery
1 天前
65.8k
4.4k
54

面向 Claude Code、Codex、GitHub Copilot、Cursor、Factory Droid、Qoder 和 Pi 的编辑级图表设计。45 种图表类型。自包含 HTML + SVG。无阴影。拒绝 Mermaid 式粗糙产物。

agent-skillsclaude-codecodex+5
HTML
36.7 MB
0
详情
docker/awesome-compose avatar
awesome-composedocker
1 周前
46.7k
8.3k
440

精选 Docker Compose 示例

awesomeawesome-listdocker-compose
HTML
11.5 MB
0
详情
tabler/tabler avatar
tablertabler
2 天前
42.0k
4.4k
100

Tabler 是基于 Bootstrap 构建的免费开源 HTML 仪表盘 UI 套件

admin-dashboardadminpanelboilerplate-template+17
HTML
384.0 MB
0
详情

关于

Arduino script to monitor and control a Jikong Battery Management System JK-BMS via BLE

描述取自 GitHub 官方 API，中文内容由 GitRead 中文社区 编辑团队整理。

简要分析

热度分
53
价值分
21
活跃状态
活跃
arduinoblebluetoothbmsesp32esp32-c3-super-minijikong-bmsjkjk-bmsjkbmsnimble
GitHub

语言占比

C++
CSS
HTML

贡献者

peff74peff74

README

Arduino script with NimBLE to monitor JK-BMS

This project is a modified version of syssi/esphome-jk-bms, rewritten for Arduino using NimBLE. Usefull for v11 / v15 BMS and also for v19 but there seem to be differences depending on which ESP32 you use.

Features

  • Real-time Monitoring:

    • All data that are also available via the app

    • Cell voltages, resistances, temperatures, battery voltage, current, state of charge and more

    • BMS settings and status flags.

  • Control:

    • Turn Charging, Discharging, and Balancing ON/OFF for each BMS.

    • I plan to add more.

  • System Information:

    • Uptime

    • Free heap memory

    • Sketch information

  • Multi-BMS Support:

    • Monitor and control multiple BMS devices simultaneously.

  • Web Interface:

    • Simple but not pretty web interface with all data and some switches.

    • A small file manager is included to handle web server files

    • Automatic refresh

Installation

  • Get startet:

    • copy index.html + style.css + jk-bms.ino local

  • Open the Project in Arduino IDE:

    • Open the jk-bms.ino file in the Arduino IDE.

  • Install Required Libraries:

    • Install the libraries NimBLEDevice + ArduinoJson

    • All others are included in the IDE by default

  • Edit settings:

    • WiFi SSID / Password + MAC from the BMS

  • Upload the Sketch:

    • Connect your ESP32 to your computer.

    • Select the correct board and port in the Arduino IDE.

    • Upload the sketch to the ESP32.

  • Access the Web Interface:

    • After the upload, the ESP32 will connect to your Wi-Fi and the IP will be displayed in the serial monitor.

    • Open a web browser and navigate to the IP address of the ESP32.

    • A small error message appears that no Index.html was found

    • Follow the link or use http://IP/fs to upload index.html + style.css to the ESP32

Examples

  • Serial interface
📁 Click to show 
rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:1
load:0x3fff0030,len:4916
load:0x40078000,len:16436
load:0x40080400,len:4
ho 8 tail 4 room 4
load:0x40080404,len:3524
entry 0x400805b8
..
WiFi connected
IP address: 
192.168.0.102
LittleFS Mounted Successfully
Initializing NimBLE Client...
Starting scan...
BLE Device found: Name: , Address: 27:74:79:c1:9a:a6, manufacturer data: 0600010f200283b89eafdb644a971466f6f372ef262acdf0eb0c92be0f
BLE Device found: Name: JK_BD4A20S4P, Address: 20:22:08:25:26:8b, manufacturer data: 4a4b0001, serviceUUID: 0xffe0
Found target device: 20:22:08:25:26:8b
Attempting to connect to 20:22:08:25:26:8b...
New client created.
Connected to 20:22:08:25:26:8b
Connected to: 20:22:08:25:26:8b RSSI: -41
Subscribed to notifications for 0xffe1
Writing register: address=0x97, value=0x00000000, length=0
Frame to be sent: AA 55 90 EB 97 00 00 00 00 00 00 00 00 00 00 00 00 00 00 11 
Notification received...
Handling notification...
Start of data frame detected.
Notification received...
Handling notification...
Continuing data frame...
New data available for parsing.
Device info frame detected.
Processing device info...
Raw data received:
55 AA EB 90 03 77 4A 4B 5F 42 44 34 41 32 30 53 
34 50 00 00 00 00 31 31 2E 58 57 00 00 00 31 31 
2E 32 35 00 00 00 90 C4 05 00 3A 00 00 00 4A 4B 
5F 42 44 34 41 32 30 53 34 50 00 00 00 00 31 32 
33 34 00 00 00 00 00 00 00 00 00 00 00 00 32 34 
30 39 32 37 00 00 32 30 38 32 33 32 31 34 33 39 
00 30 30 30 30 00 49 6E 70 75 74 20 55 73 65 72 
64 61 74 61 00 00 31 32 33 34 00 00 00 00 00 00 
00 00 00 00 00 00 49 6E 70 75 74 20 55 73 65 72 
64 61 74 61 00 00 7C F8 FF FF 1F 0D 00 00 00 00 
00 00 90 0F 00 00 00 00 C0 D8 03 00 00 00 00 01 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FE 
0F 00 00 00 00 00 00 00 00 00 00 53 
  Vendor ID: JK_BD4A20S4P
  Hardware version: 11.XW
  Software version: 11.25
  Uptime: 378000 s
  Power on count: 58
  Device name: JK_BD4A20S4P
  Device passcode: 1234
  Manufacturing date: 240927
  Serial number: 2082321439
  Passcode: 0000
  User data: Input Userdata
  Setup passcode: 1234
Notification received...
Handling notification...
Writing register: address=0x96, value=0x00000000, length=0
Frame to be sent: AA 55 90 EB 96 00 00 00 00 00 00 00 00 00 00 00 00 00 00 10 
20:22:08:25:26:8b connected successfully
Notification received...
Handling notification...
Start of data frame detected.
Notification received...
Handling notification...
Continuing data frame...
New data available for parsing.
BMS Settings frame detected.
Processing BMS settings...
Cell voltage undervoltage protection: 2.82V
Cell voltage undervoltage recovery: 2.85V
Cell voltage overvoltage protection: 4.20V
Cell voltage overvoltage recovery: 4.18V
Balance trigger voltage: 0.01V
Power off voltage: 2.80V
Max charge current: 25.00A
Charge overcurrent protection delay: 30.00s
Charge overcurrent protection recovery time: 60.00s
Max discharge current: 40.00A
Discharge overcurrent protection delay: 300.00s
Discharge overcurrent protection recovery time: 60.00s
Short circuit protection recovery time: 60.00s
Max balance current: 0.40A
Charge overtemperature protection: 70.00C
Charge overtemperature protection recovery: 60.00C
Discharge overtemperature protection: 70.00C
Discharge overtemperature protection recovery: 60.00C
Charge undertemperature protection: -20.00C
Charge undertemperature protection recovery: -10.00C
Power tube overtemperature protection: 100.00C
Power tube overtemperature protection recovery: 80.00C
Cell count: 9
Total battery capacity: 40.00Ah
Short circuit protection delay: 1500.00us
Balance starting voltage: 3.00V
Notification received...
Handling notification...
Notification received...
Handling notification...
Start of data frame detected.
Notification received...
Handling notification...
Continuing data frame...
New data available for parsing.
Cell data frame detected.
Parsing data...

--- Data from 20:22:08:25:26:8b ---
Cell Voltages:
  Cell 01: 3.695 V
  Cell 02: 3.696 V
  Cell 03: 3.696 V
  Cell 04: 3.698 V
  Cell 05: 3.697 V
  Cell 06: 3.701 V
  Cell 07: 3.700 V
  Cell 08: 3.700 V
  Cell 09: 3.696 V
  Cell 10: 0.000 V
  Cell 11: 0.000 V
  Cell 12: 0.000 V
  Cell 13: 0.000 V
  Cell 14: 0.000 V
  Cell 15: 0.000 V
  Cell 16: 0.000 V
wire Resist:
  Cell 01: 0.321 Ohm
  Cell 02: 0.326 Ohm
  Cell 03: 0.332 Ohm
  Cell 04: 0.325 Ohm
  Cell 05: 0.310 Ohm
  Cell 06: 0.314 Ohm
  Cell 07: 0.314 Ohm
  Cell 08: 0.312 Ohm
  Cell 09: 0.313 Ohm
  Cell 10: 0.000 Ohm
  Cell 11: 0.000 Ohm
  Cell 12: 0.000 Ohm
  Cell 13: 0.000 Ohm
  Cell 14: 0.000 Ohm
  Cell 15: 0.000 Ohm
  Cell 16: 0.000 Ohm
Average Cell Voltage: 3.70V
Delta Cell Voltage: 0.01V
Balance Curr: 0.00A
Battery Voltage: 33.28V
Battery Power: 0.00W
Charge Current: 0.00A
Charge: 77%
Capacity Remain: 30.81Ah
Nominal Capacity: 40.00Ah
Cycle Count: 0.00
Cycle Capacity: 0.05Ah
Temperature T1: 22.0C
Temperature T2: 22.9C
Temperature MOS: 28.1C
Uptime: 4d 9h 4m
Charge: 1
Discharge: 1
Balance: 0
Balancing Action: 0
Notification received...
Handling notification...
Ignoring notification. Remaining: 9
Notification received...
Handling notification...
Ignoring notification. Remaining: 8
Notification received...
Handling notification...
Ignoring notification. Remaining: 7
Notification received...
Handling notification...
Ignoring notification. Remaining: 6
Notification received...
Handling notification...
Ignoring notification. Remaining: 5
Notification received...
Handling notification...
Ignoring notification. Remaining: 4
Notification received...
Handling notification...
Ignoring notification. Remaining: 3
Notification received...
Handling notification...
  • Web interface

Exampel

Disclaimer

This is an experimental project. Use it at your own risk.

Credits

Based on the work of syssi.

Badge

评论

暂无评论