企业官网建设流程全解析

《从"能跑"到"吃透"：一个 STM32+RT-Thread BMS 项目的深度复盘》

一名嵌入式学习者对一个五串锂电池管理系统的完整复盘实录：从画出数据流架构图，到逐文件读穿五个线程，再到亲手加固并发与看门狗、把硬件原理图和软件代码对上号。

复盘目标：

• 用数据流视角建立系统全景：不是"有哪些模块"，而是"谁生产数据、谁消费、多久一次、坏了怎么办"
• 逐文件读穿五个业务线程 + HAL + 驱动，每个"为什么这样写"都能答到第三层追问
• 动手加固三项：跨上下文共享标志的 volatile、读写配对的临界区快照、多线程心跳看门狗
• 把软件行为一路追到硬件电路：寄存器 → 引脚 → MOS 栅极 → 主回路通断
• 沉淀一套可复用的复盘方法论：画图立全景 → 数据流定优先级 → 参与者定锁强度 → 故障速度定保护路径 → 面视准备

复盘内容：

第 1 阶段：全景（先当测绘员）

1. 摸清技术栈：STM32F103C8T6（Cortex-M3@72MHz / 64KB Flash / 20KB RAM）+ RT-Thread Nano + TI BQ76920 AFE，五串三元锂
2. 画出架构图：BQ76920 采样 → 驱动层 → HAL → monitor 线程 → 全局共享数据 → analysis/protect/energy 三路消费 → MOS 控制 / LED / 串口输出；ALERT 硬件中断旁路直达保护回调
3. 盘点线程：monitor(19) / protect(20) / analysis(21) / energy(22) / info(25)，外加 main(10) 当看门狗裁判

第 2 阶段：逐文件深读（当侦探）

4. monitor：250ms 周期 + 三种采样分频 + 电流事件驱动（ALERT→CC 就绪）+ 系统模式状态机（四态，电流 ±20mA 驱动）
5. protect：软件五故障（充电过流+四类温度）轮询、九宫格报警位图、滞回解除、时间型 vs 数值型解除的分工
6. analysis：SOC 双算法闭环——安时积分跑动态 + OCV 查表静置校锚点 + 端点钉扎 + 温度校分母
7. energy：充放电四道门调度 + 均衡三态生命周期（30s 干活 / 5s 冷却 / 位图筛选、相邻互斥）
8. 驱动层：软件 I2C（开漏+delay 手搓时序）、CRC-8 模二除法校验、关中断总线锁、ALERT 中断分发回调表

第 3 阶段：动手加固（当外科医生）

9. volatile 补齐四处：中断/软定时器与线程共享的标志（电流采样标志、报警位、均衡标志）
10. 临界区读写配对：写侧 HAL 提交加 rt_enter_critical（排序过滤全在锁外，锁内只做纯拷贝 ~1µs）；读侧四线程周期快照（static 私有副本，不占栈）
11. 报警位清零竞态修复：关中断做读-改-写，防中断新置的位被线程旧值覆盖
12. IWDG 裸寄存器实现（0x5555 解锁→配 64 分频→2500 重载→0xAAAA 启动，4s 超时）+ 三线程心跳健康检查：全员有新心跳才喂狗，main 自己挂了就没人喂——自监督闭环
13. Keil 编译实测：0 Error 0 Warning；Code+RO+RW=46.1KB（Flash 72.7%），RW+ZI=13.4KB（RAM 67%）——顺手实测证明了 OTA 双分区放不下

第 4 阶段：软硬件对号（当翻译官）

14. 电源树：16~21V → MP9486A buck 5V → 1117 LDO 3.3V，“先粗降后精降”
15. 主回路：PACK+↔BAT+ 直连，负极串"双 MOS 背靠背 + 机械开关 + 5mΩ 采样电阻"的低边开关结构；体二极管方向决定每只管只管一个方向
16. CHG/DSG 引脚 → 三极管驱动级 → MOS 栅极：软件写寄存器如何四级放大成物理断路
17. 电流采样：5mΩ 上 2A 只有 10mV → 差分进 BQ 内部 ADC → 欧姆定律除法得安培，补码的正负号就是充放方向

第 5 阶段：面试选手

18. 整理面试手册：高频题标准答案、芯片科普、三层追问防御、改进方向清单
19. 简历项目条目：核心技术/问题攻坚/项目成果三段式，全部来自真实修复

复盘心得（比代码本身更值钱的部分）

1. 读代码先画数据流图，不是先看模块清单

架构图上最值钱的一根线是"monitor → 共享数据 → 三个消费者"——它一画出来，优先级设计、临界区位置、看门狗名单全部自动浮现。架构不是"有哪些模块"，是"数据怎么流动、控制怎么回流"。先当测绘员再当侦探，读代码不会迷路。

2. 线程优先级按数据流排，不按名字分量排

protect 管安全却排第二，monitor 采样反而最高——因为生产者优先于消费者（数据源卡住全员变瞎），真正快的故障走 BQ 硬件+EXTI 中断（天然高于一切线程），而且 monitor 在上能让 protect 同拍拿到最新鲜的数据。优先级匹配的是数据流结构，不是模块名字的分量。

3. 锁的强度要刚好罩住所有参与者：多重一分是浪费，轻一分是漏洞

临界区三档金字塔：关中断挡一切、挂起调度器只挡线程、互斥锁让竞争者睡觉。选档只看一件事——谁可能插队：结构体快照的参与者全是线程→挂调度器；I2C 总线有中断调用方→必须关中断（驱动注释里躺着从 mutex 换关中断的血泪进化史）。我项目三档用了前两档、mutex 闲置，恰好说明没有为锁而锁。

4. 中断记事，线程说话

中断里只做"置标志"（alert）这一件事（0.1µs），读 I2C、打日志全部下放线程处理——项目里电流采样回调就是现成范本，而均衡定时器回调里做 I2C+打印正是反面教材。打印一行 1.7ms，是合格中断预算的一千倍；中断睡觉等于堵死调度，"中断不能调会睡眠的 API"是两个 RTOS 共同的红线。

5. 保护的快慢分层是物理决定的，不是设计偏好

短路毫秒烧管（180A 时 MOS 上 324W）→ 必须 BQ 硬件比较器微秒级直切；温度分钟级危险 → 软件 200ms 轮询绰绰有余。故障的破坏速度决定保护的响应路径——硬件快故障硬件数秒表，软件慢故障软件数，泾渭分明。配套的两条纪律：解除用滞回防临界抖动，恢复尊重全局意愿不顶用户。

6. 看门狗的语义设计：喂狗资格 = 你想证明的事

最高优先级裸喂狗证明不了任何事（其他任务全死它照喂），中断喂狗更糟（任务全死中断照响）。正确姿势：最高优先级喂狗者 + 心跳门控——main 每秒点名三个安全线程，全员有新心跳才喂；main 自己没有心跳，它死了就没人喂。裁判倒下，法院照样判刑。名单还有讲究：analysis 因 5 秒 OCV 静置等待被排除、info 因打印阻塞不该触发断电——故障隔离，辅助功能失明不传染核心功能。

7. 凡是行为有记忆的，都是状态机——区别只在于写没写成状态机的样子

显式的只有一个（系统模式四态机），但均衡生命周期是散装在标志变量和时刻戳里的三态机，报警位图是九个并联的微型双态机。会数显式状态机算入门，能认出隐式的才算读懂——而且把隐式的重构成显式的（一个 enum + 一张图），是"代码能跑"到"代码能维护"的分水岭。

8. 已知债务主动交代，是最便宜的加分项

复盘挖出的每一颗雷（中断里的 I2C、无 SOH、OCV 表无温度分段、传感器失效即豁免、隐式的 -10~0℃ 温度区间缝隙）都不藏——面试时"我复盘出几个自己不满意的点"比被面试官挖出来强十倍。知道哪里没做、为什么现在敢不做、什么时候必须做，比"全都做了"更能证明工程判断力。

9. 软硬件必须对上号，否则两边都是玄学

软件写 SYS_CTRL2 寄存器 → BQ 的 CHG 引脚 → 三极管驱动级 → MOS 栅极 → 主回路物理断路，这条四级链路讲得出来，"软件动作怎么变成物理断路"就不再是黑盒；反过来，5mΩ 上的 10mV 怎么变成代码里的 BatteryCurrent（差分+ADC+欧姆定律+补码定方向）讲得出来，数据源头也不再是玄学。嵌入式工程师的核心竞争力，就是能把这两条链一口气讲穿。

结语：方法论全链路

画图立全景 → 数据流定优先级 → 参与者定锁强度 → 故障速度定保护路径 → 心跳定看门狗语义 → 认出隐式状态机 → 面视准备

芯片会换、项目会换、RTOS 会换，但这套"怎么把一个别人的项目变成自己的能力"的复盘链路，是跟着职业生涯走的长期资产。