九号V30C改60V铅酸电量虚标排查与BFG库仑计安全校准实战
本文记录了一台二手九号 V30C 电动车在加装第 5 块铅酸电池升级为 60V 体系后,彻底根治电量显示虚标(底层 44% vs 官方 App 30%)、逆向车机 BFG 库仑计协议与固件放电查找表(LUT)的硬核排障全过程。文章拆解了利用 GitHub Actions 云端流水线零配置直出 Debug APK 规避本地交叉编译污染的技巧,深入逆向分析了九号车机中 DIS 仪表盘与 BFG 库仑计的双独立通信机制,从底层固件逻辑证实了为什么 60V 体系下强刷 20Ah 必定失败,并确立了“物理 20Ah 电池标定 18Ah Profile”兼顾 Peukert 放电折减与防深放电安全余量的工程实操方案。
一、 现状拓扑与电量虚标痛点
收来的一台二手九号 V30C,原车出厂为 48V 12Ah 铅酸配置。前车主为了提升极速与续航,在座桶内硬件串联加装了第 5 块电池,组成 60V 20Ah 铅酸电池组,并附带了一个做工粗糙的“三无”充电器。
实车上路后,电量计量出现了极其割裂的异常现象:
- 电量虚标与分歧:车机底层通讯读取到的剩余电量为 44%,但九号官方 App 界面却显示仅剩 30%,仪表盘电量格数跳跃剧烈,骑行时完全无法预估剩余安全里程;
- 电压基准未校准:原车中控依然运行在 48V 欠压与满电电压判定逻辑下,未同步适配 60V 铅酸电池的放电截止电压;
- 随车充电器隐患:附带的充电器无品牌背标与三段式充放电控制芯片,整车电气系统存在严重的安全与过放盲区。
[硬件改装: 5 块串联铅酸 (标称 60V 20Ah)]
│ (总线输出)
▼
┌──────────────────────────────┐
│ 九号车机总线架构 (Dual-Bus) │
└──────┬────────────────┬──────┘
│ │
▼ ▼
[DIS 仪表显示链路] [BFG 库仑计链路]
寄存器: DIS 0x92 Profile 寄存器: 0x00
(当前回读: 0x02/60V) (当前状态: 曲线未匹配/虚标 44%)
为什么传统排障方案屡屡变砖与碰壁?
- 本地 Android 构建门槛过高:社区通用的开源校准工具 Ninebot-BFG-Calibration 依赖 JDK 21、Android SDK 以及特定的 NDK 构建链。在个人工作机上配置整套交叉编译链极其臃肿,且国内网络环境下拉取 Gradle 依赖极易频繁报
502 Bad Gateway。 - 盲刷参数引发仪表变砖:部分车友在未经协议分析的情况下,混淆了“仪表盘(DIS)参数”与“电池计量计(BFG)参数”。在非白名单固件版本的仪表上强行刷写
DIS 0x92寄存器,极易造成仪表盘通讯总线死锁甚至硬件变砖。 - 死磕标称 20Ah 导致死循环:很多车友执着于将容量寄存器改为物理电池标称的 20Ah,反复点击写入反复提示失败,误以为是蓝牙通讯握手异常或电池组严重老化。
二、 核心解法与底层协议逆向
为了在不污染本地环境的前提下安全、精准地完成参数注入,整体方案分为三个技术层级推进:
[GitHub Actions Runner] ──> 零配置云端纯净构建 ──> Debug APK 产物
│
▼ 物理近场按键协商临时 Key
[安卓机与车机建立安全调试信道]
│
▼ 逆向固件 Profile LUT 规避盲刷
[锁定 60V 18Ah 安全配置]
1. CI/CD 云端纯净构建
放弃本地配置 Android Studio 与 Gradle 依赖,直接利用 GitHub Actions 预置的 Ubuntu Runner 镜像进行打包。云端原生预置了完整的 Android SDK 环境与高速外网连接,只需一个极简 Workflow 即可分钟级产出纯净 APK。
2. 物理近场按键协商临时 Session Key
无需 Root 手机或逆向九号官方 App 的本地 SQLite 数据库提取车辆私钥。该工具利用了九号车把物理按键(点火/刹把长按组合)在近场广播中的特征码,直接协商生成临时的 Session Key,安全接入车机 BLE 调试通道。
3. 反编译分析:DIS 与 BFG 的系统解耦
反编译逆向 BfgProfileCatalog 与 CommunicationModeResolver 的通信协议实现后,确认九号系统底层采用了 DIS(仪表盘显示) 与 BFG(电池计量芯片/库仑计) 双独立模块架构:
- DIS 模块:仅负责仪表端点阵/数码管界面的图元映射与档位回显,由独立仪表 MCU 驱动;
- BFG 模块:位于主控板核心,内置硬件库仑计积分算法与放电曲线查找表(Look-Up Table, LUT)。
4. 固件 LUT 逆向:为什么必须标定 18Ah?
在逆向解析中控固件(5.11.1)与计量固件(1.7.8)的 Profile 定义表时,发现了强刷 20Ah 必定报错的根本原因:
| 标定电压档位 | Profile 索引 (Hex) | 固件实装容量 | 固件白名单支持状态 |
|---|---|---|---|
| 60V | Index 0 (0x01) | 20Ah | ❌ 未实装 LUT 曲线(芯片直接丢弃) |
| 60V | Index 2 / 15 (0x21 / 0xF1) | 18Ah | ✅ 正式实装放电曲线(出厂推荐) |
| 60V | Index 5 (0x51) | 26Ah | ✅ 正式实装放电曲线 |
九号官方在 60V 铅酸固件体系内,底层根本就没有为 20Ah 分配放电曲线映射!当手机端向寄存器 0x00 强推 0x01 时,车机校验逻辑判定参数非法直接丢弃写指令,连续 3 次校验回读依然是旧值,前台便报出“写入失败”。
NOTEPeukert 效应与安全余量:铅酸电池在电动车大电流(0.8C ~ 1.2C 放电)工况下,存在显著的 Peukert 容量折减。标称 20Ah 的铅酸电池实际有效释放容量通常就在 17Ah ~ 18.5Ah 之间。 采用 “物理 20Ah 电池 + 车机标定 18Ah Profile”,不仅能让剩余电量百分比线性下降、彻底消灭“前 80% 电量极虚、后 20% 瞬间断电”的跳电现象,更在表显 0% 时天然给整车留出了 10% ~ 15% 的防深放电安全余量,有效保护铅酸电池免于极板硫化。
三、 实战配置与操作时序
1. 编写云端极简构建流水线 (.github/workflows/build-apk.yml)
在 Fork 出的仓库中创建 Actions 工作流,直接复用 GitHub Runner 预置的 /usr/local/lib/android/sdk:
name: Build Debug APK
on: [push, workflow_dispatch]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout Code
uses: actions/checkout@v4
- name: Set up JDK 21
uses: actions/setup-java@v5
with:
distribution: 'temurin'
java-version: '21'
- name: Grant Execute Permission
run: chmod +x gradlew
- name: Build with Gradle
# 直接复用 GitHub Runner 预置 Android SDK 环境,杜绝三方 Action 冲突
run: ./gradlew assembleDebug --stacktrace --no-daemon
- name: Upload APK Artifact
uses: actions/upload-artifact@v4
with:
name: BFGCalibration-debug-apk
path: app/build/outputs/apk/debug/*.apk
2. 规避国内代理 502 的依赖仓库调优 (settings.gradle)
移除易触发 502 Bad Gateway 的镜像前置规则,锁定官方直连源:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google() // 优先直连官方源
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
3. 车机底层生效参数基准表
下载 APK 安装至安卓机后,执行近场握手配对。严格按照下表核验与写入:
| 模块 / 寄存器 | 目标寄存器地址 | 目标值 (Hex) | 操作模式 | 关键说明 |
|---|---|---|---|---|
| 仪表电压寄存器 (DIS) | 0x92 | 0x02 | 只读核验 | 对应 60V 档位。若已为 0x02,严禁再次写入 |
| BFG 库仑计 Profile | 0x00 | 0x21 或 0xF1 | 执行写入 | 低 4 位 0x01 代表 60V,高 4 位 0x2/0xF 代表 18Ah 曲线 |
写入完成后断开车机蓝牙,整车下电静置 10 秒后重新开机,电量曲线即可完成收敛重置。
四、 踩坑复盘与五大防御性细节
在整个逆向与标定过程中,排查出的异常与防御规避策略汇总如下:
| 序号 | 故障 / 异常现象 | 根因分析 | 防御性规避措施 |
|---|---|---|---|
| 1 | CI 报 Process completed with exit code 1 | 额外引入了三方 setup-android Action,与 Runner 预置的环境变量冲突 | 精简构建步骤:删去多余的 setup-android,直接执行 ./gradlew assembleDebug。 |
| 2 | 手机端 BLE 扫描/连接频繁超时或中断 | 主力机(iPhone)后台的九号 App 持续独占并争抢车机 BLE 广播通道 | 彻底阻断干扰源:调试前在 iOS 设置中彻底关闭蓝牙(仅控制中心点亮灰色仍有后台残留)。 |
| 3 | 写入 20Ah 有回读,但最终提示“写入失败” | 手机发送了写 Profile 0x01(20Ah)指令,但中控 5.11.1 / 计量 1.7.8 固件白名单无 20Ah 曲线,芯片丢弃指令,连续 3 次回读仍为原值 0x21 | 严禁强行重试。车机硬件拒绝非合法 Profile,保持 60V 18Ah 即为系统支持的最高稳定状态。 |
| 4 | 仪表盘写入按钮不可用 / 拦截弹窗 | 源码 DashboardWritePolicy 白名单仅限仪表 2.5.9;实车固件为 3.2.8 | 防御性拦截生效:绝不绕过白名单。实测仪表已识别 60V,强写 DIS 0x92 极易变砖。 |
| 5 | 替换三无充电器安全选型 | 商家配劣质充电器无浮充控制;九号原装 60V 多为带 CAN 通信的锂电充电器 | 选购时必看背标**“铅酸蓄电池专用”**(三段式恒流-恒压-浮充,截止电压 ~69V,4A 匹配 20Ah 为黄金 0.2C)。 |
WARNING关于仪表盘防砖警告: 只要在 App 首页看到仪表电压档位已经正确识别为
60V(即DIS 0x92值为0x02),就绝对不要尝试使用任何修改版工具强行解锁“写入仪表”按钮。九号高版本仪表固件(如3.2.8)在接收到非预期的 DIS 写入帧时,有极大概率触发 Bootloader 校验保护而彻底锁死通信总线。
五、 总结
在嵌入式与智能硬件的逆向改造中,很多看似诡异的通信失败或硬件故障,往往不是硬件老化,而是触碰了固件底层的防御逻辑。通过 CI/CD 构建出纯净的调试工具,结合协议反编译看清 DIS 与 BFG 的边界,不仅彻底根治了电量虚标,更在 60V 体系下为老旧铅酸电池建立起了科学的安全余量。