固件 0.1.5~0.1.13-c5：刷机模式、多组 WiFi、热插拔初始化、总线锁误判、硬重启断 VBUS
- 0.1.5/0.1.6：刷机模式（flash_mode，最多 2 路，60 分钟可加钟）——窗口内顶高按 4450 mV 绝对值判、不断 VBUS - 0.1.7/0.1.8：反灌断 VBUS 阈值放宽到 -300 mA（adb reboot bootloader 过渡实测 -208 mA） - 0.1.9：WiFi 最多存 4 组，连不上轮换；NVS v1 自动迁移并双写（OTA 回滚仍能上网） - 0.1.10：热插拔进来的刀片重新初始化 PCA9555 + INA226（否则 VBUS 常开、电流恒读 0） - 0.1.11：i2cbus 嵌套检测改看本任务持锁（原全局标志让 key 随机回 busy、vbus 随机回 io） - 0.1.12：硬重启先断 VBUS，开机校验通过 60 s 后再接回（否则假重启 / 误判没开机 / 进关机充电） - 0.1.13：这一路被安全判据断电时一并退出刷机模式（事件 21 arg 254） 26 ctest 全绿；新增用例均先在旧代码上确认变红。板 B 已 OTA 到 0.1.13-c5 并实测。 Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
这个提交包含在：
zhou yang
+89
-1
@@ -1,5 +1,93 @@
|
||||
# 交接
|
||||
更新：2026-09-28 固件 **0.1.4-c5**（整片刀片不应答 ⇒ 关路）；板 B 经 OTA 推上
|
||||
更新：2026-09-28 23:20 固件 **0.1.13-c5**（断电自动退出刷机模式）；板 B 经 OTA 推上；rack 已部署
|
||||
|
||||
## 0.1.13：这一路断了电 ⇒ 刷机模式一并退出（2026-09-28）
|
||||
- 起因：第 2 槽刀片带电拔走后，刷机模式还挂了约 48 分钟、占着「最多 2 路」的名额。`check_present` / SR-5 / 刀片不应答 /
|
||||
mux 失联全断都是 t_safety 直接关 eFuse，不经过 `power` 命令，而只有 `power off` 会顺带退刷机模式。
|
||||
- 修：`cmd_chgmode_tick()`（执行器任务，chgmode 的唯一写者）每拍看一遍：刷机模式开着 + eFuse 关着 + 执行器不忙 ⇒
|
||||
退出，记事件 21 arg = **254 `CHG_EV_DROPPED`**。执行器忙（硬重启 HR_OFF 那几秒 eFuse 本来就关）不算。
|
||||
- ⚠️ 254 带 0x80 位：rack `api.py` 事件命名里「断电自动退出」必须排在「加钟」前面判（已改 + 测试）。
|
||||
- 测试：`test_cmd` +1（硬重启中不退 / 关电后下一拍退、只记一次、名额让出）；反向验证：去掉判断 ⇒ 红。26 ctest 全绿；rack 48 例全绿并已部署。
|
||||
- ⏳ 真板未专门验证（需要带电拔一次开着刷机模式的刀片）。
|
||||
|
||||
## 0.1.11 / 0.1.12：命令随机 busy / io；硬重启带着 VBUS（2026-09-28 刷机时发现）
|
||||
- **总线锁误判（0.1.11）**：`i2cbus_xact()` 拿锁前查全局 `s_in_xact` 防嵌套 —— 别的任务在事务里时它也是 true。
|
||||
执行器撞上巡检那 ~2.3 ms（每 20 ms，≈12%）就被判成「嵌套」立刻回 STATE ⇒ `key` 随机回 **busy**、`vbus` 随机回 **io**
|
||||
（反过来巡检撞上执行器也会白跑一圈）。改成 `hal_lock_held(HAL_LOCK_I2C)`（**本任务**持锁才算嵌套）。
|
||||
真板：第 3 路连开关 VBUS 40 次，0 失败。测试 `test_i2cbus` +1（另一任务持锁 ⇒ TIMEOUT 而不是 STATE；旧代码红）。
|
||||
- **硬重启先断 VBUS（0.1.11）+ 延后接回（0.1.12）**：VBUS 通着做 `power_cycle` 的三个后果现场全见过 ——
|
||||
手机靠 USB 撑着没断电（假重启）；直供电流 ≈0 ⇒ 开机校验判「没开起来」再按两下；断电那刻带着 USB ⇒ 进关机充电，一拔 USB 就关机。
|
||||
现在 `t_actuator_hard_reset()` 先断 VBUS，**开机校验通过后再等 `ACT_HR_VBUS_BACK_MS` = 60 s** 才接回
|
||||
（0.1.11 是校验一过就接回 ⇒ 手机还在 bootloader、关充电补丁没生效 ⇒ 13 s 顶高 4394 mV、SW-8 断 VBUS）。
|
||||
等待期间执行器空闲；`vbus` / `power` 命令、再次硬重启、EDL、abort、这一路被关电 ⇒ 作废。没开起来 / 出错 ⇒ 不接回。
|
||||
真板：第 3 路 VBUS 通 → 硬重启：hr-off 时 vb=false、14 s 校验通过、72 s 接回，无顶高事件。
|
||||
测试 `test_t_actuator` +3（先断后接回、没开机不接回 / abort 不接回 / 本来没通不打开、等待期间被取消的三种）。26 ctest 全绿。
|
||||
- ~~没修的：第 2 槽刀片被拔走时刷机模式不退出~~ ⇒ 0.1.13 已修。
|
||||
|
||||
## 0.1.10：热插拔进来的刀片重新初始化（2026-09-28）
|
||||
- 现象（板 B，新主板 + 没刷补丁）：刀片**带电插**进槽 ⇒ C67（VBUS）= 5 V，换 U5 也一样；`vb:false`。
|
||||
没刷补丁的手机被充到 4.4 V ⇒ SR-5 过压关路（反复 7 次）。**插好再给底板上电就正常**。
|
||||
- 根因：`slot_init()` / `ina226_init()` 只在开机 bringup 做。热插拔时 PCA9555 上电复位不干净（SDA/SCL 经上拉寄生供电），
|
||||
`VBUS_EN` 被配成输出高、影子却是 off ⇒ SW-8 不武装；INA226 CALIB = 0 ⇒ **电流恒读 0**（第 2 路那段数据正是整 0）。
|
||||
- 修：`t_safety` 认 `PRSNT#` 下降沿，在位连续 `T_SAFETY_INSERT_N` = 5 圈（100 ms）后在本路锁内 `slot_init_locked()` + `ina226_init()`；
|
||||
失败隔 5 圈重试；拔走作废；开机在位的不重做。status `safety.inits` = 成功次数。
|
||||
- 测试 +2（`test_t_safety`：乱寄存器插入 ⇒ 第 5 圈恢复、VBUS 断、键全松、CALIB 写回、只做一次；NAK 重试 + 插一半拔走不碰空槽）；
|
||||
反向验证：不置 need_init ⇒ 两例红。26 ctest 全绿。
|
||||
- ✅ 真板验证（用户现场）：带电插刀片后 C67 = 0 V、`safety.inits` 0 → 1。
|
||||
|
||||
## 0.1.9：多组 WiFi（2026-09-28，用户要求）
|
||||
- 起因：板 B 只存一组 WiFi（CANBOX-5G），热点一关就离线；而改配置只收 USB。
|
||||
- `netcfg_t.wifi[NETCFG_WIFI_N=4]`。`wifi` 命令 = **同名改口令、否则追加**（回 `"n":组数`；满了 `state`）；
|
||||
`{"cmd":"wifi","ssid":"X","del":true}` 删（没有这组回 `range`）。仍然只收 USB。
|
||||
- `net` 回应：`ssid` / `pass_set` = 正在连的那一组（`net_status_t.wifi_idx`），新增 `"ssids":[…]` 整张表。
|
||||
- 轮换（mlink_esp.c）：没连上 ⇒ 换下一组；连上过又掉 ⇒ 先重试同一组；退避按「轮完一圈」算（`attempt / n`）。
|
||||
改配置时正连着的那一组没被删、口令没变、broker 没变 ⇒ **WiFi / MQTT 都不断**（加备用热点不掉线）。
|
||||
- NVS：新键 `net2`（ver 2）；读不到就读旧键 `net`（ver 1）迁移。**写时两个键都写**，`net` 放表里第一组 ——
|
||||
OTA 回滚到 ≤0.1.8 仍连得上网。
|
||||
- 测试 +3（`test_net` 10 → 13 例：加 / 改同名、删 + 满表、NVS 空位压实）；26 ctest 全绿。
|
||||
- 真板：烧录后 `ssids:["CANBOX-5G"]`（迁移成功）→ 加 `AAAAAABBBCCC`（用户给的名字，周围扫不到）→
|
||||
加 `AAABBBCCC`（本机扫到的实际热点，同口令）⇒ 连上 10.5.5.58、MQTT up、服务器显示在线。
|
||||
- ⚠️ USB esptool 烧录 = 非计划重启 ⇒ 五路全断（第 1 路手机掉电）。第一次连接报 `ClearCommError`，COM5 重新枚举后重试即成。
|
||||
|
||||
## 0.1.7 / 0.1.8：反灌断 VBUS 阈值 −50 → −150 → −300 mA（2026-09-28，用户要求）
|
||||
- 起因：刷机时重启过渡的瞬间反灌误断 VBUS，fastboot 断连。0.1.6 下实测 −59 mA；0.1.7（−150 mA）下 `adb reboot bootloader` 实测 **−208.5 mA** 仍断。
|
||||
- `T_SAFETY_REV_UA` = −300000；判据本身（一圈就断、不做确认窗口、不碰 eFuse、刷机模式不豁免）不变。
|
||||
- 测试：注入 −60 → −310 mA，「小电流不算反灌」−40 → −250 mA；26 ctest 全绿。0.1.8 下 `adb reboot bootloader` 过渡没再断 USB。
|
||||
|
||||
## 0.1.6：刷机模式默认 30 → 60 分钟 + 加钟（2026-09-28，用户要求）
|
||||
- `CHG_MODE_DEFAULT_MIN` = 60。
|
||||
- 加钟：`{"cmd":"flash_mode","rail":1,"add":30}`（1~120，与 on / min 互斥）—— `chgmode_extend()` 只给**开着的**窗口加
|
||||
（没开 / 宽限期里回 `state`：那是重新开，不是加钟），加完剩余截断到 120 分钟；回 `"left":秒`。
|
||||
事件 21 arg = `CHG_EV_EXTEND`（0x80）| 分钟。rack：「更多 → 刷机模式加钟 30 分钟」（只在开着时出现）。
|
||||
- 测试 +2（`test_cmd` 加钟全路径、`test_t_safety_rules` 截断与宽限期拒绝），rack 48 例。真板：没开加钟被拒 / 开 3600 / 加钟后 5399 / 关。
|
||||
|
||||
## 0.1.5：刷机模式（2026-09-28，用户定「做，最多同时 2 路」）
|
||||
- **起因**：fastboot / bootloader 阶段内核补丁还没起来，手机充电器把直供节点顶到浮充 ~4.4 V（板 B 实测 4395 mV），
|
||||
SW-8 立刻断 VBUS ⇒ fastboot 刷到一半断连。历史 5 次顶高全是只断 VBUS、**0 次**关路。
|
||||
- **依据**：每路 eFuse TPS25940A 自带反向阻断（V(IN)−V(OUT) < −9.3 mV 断开），顶高时能量进不了 Buck / 12V 母线；
|
||||
板 B 五次顶高实测电流 0 ~ −0.5 mA。
|
||||
- **新模块 `chgmode.{h,c}`**：每路一个截止时刻。**只有执行器任务写**（命令 + `cmd_chgmode_tick()` 到期清理），
|
||||
巡检只读；tick 必须清标志，否则 32 位毫秒时钟 ~24.8 天后过期窗口会「复活」。
|
||||
- **判据（`t_safety.c judge_locked`）**：窗口内「顶高断 VBUS」与 SR-5 过压都按绝对值 `CHG_MODE_MAX_MV` = 4450 判；
|
||||
窗口后 1 s 宽限期里 SW-8 回到按设定值（立刻断 VBUS），SR-5 仍按绝对值（节点往回落的几 ms 不许误关路）。
|
||||
反灌（< −50 mA）与欠压判据**不变**。
|
||||
- **命令 14 `flash_mode`**：`{"rail":1,"on":true,"min":60}`（默认 60、1~120 分钟；0.1.6 由 30 改 60），回 `"left":秒`；
|
||||
**最多同时 2 路**（第 3 路回 `state`）；关着电不许开（`state`）；`power` 关电时一并退出。status 每路多 `"chg":秒`。
|
||||
- **事件 21 `LOG_EV_CHG_MODE`**：arg = 分钟（开）/ 0（手动关）/ 255（到期）。
|
||||
- rack：白名单 + 事件名 + 单板页「更多 → 刷机模式（1 小时）」（带确认），状态标签显示剩余分钟；模拟板同步。
|
||||
- 测试：`test_t_safety_rules` +10（绝对上限、反灌 / 欠压不变、按路、到期断 VBUS 不关路、宽限期后恢复、2 路上限、时钟回绕），
|
||||
`test_cmd` +3；26 ctest 全绿；rack 46 例。反向验证：去掉窗口内豁免 → 4 例红；tick 不清标志 → 回绕用例红。
|
||||
- ✅ **台架实测（2026-09-28，板 B 第 1 路，0.1.6-c5）**，原始数据 `10.5.5.13:/root/phonerail-src/bench-flashmode-20260928.tsv`：
|
||||
· 开模式 + VBUS 通 → `adb reboot bootloader`，6 s 进 fastboot，**fastboot 下确实在充电**：节点 3864~4395 mV 锯齿
|
||||
（充到浮充即停、手机耗下来再充，周期 3~4 s），**VBUS 全程没断**、fastboot 一直在线（`getvar` 正常）；
|
||||
· 该路电流 −1.0 ~ +1.5 mA（eFuse 反向阻断干净），12V 母线 12.029~12.031 V 不动，输入电流 160 → 230 mA（+0.8 W，5V 负担很小）；
|
||||
· **FLT 在反向阻断期间一直为 true**（与 RCB 同进同退，节点跌到 3864 仍为 true = 要 +100 mV 才重新导通），
|
||||
固件对 FLT 只上报不动作 ⇒ 无事件。是 TPS25940A 的 RCB 指示，不是故障。rack 已改：chg>0 时这一路显示蓝色「刷机模式 · 充电中」、FLT 标签变中性「反向阻断」（模式外 FLT 仍标红）；
|
||||
· 对照：充电中关模式 → 当圈 PUSHED_UP 断 VBUS（读数 4034 mV），**不关路**（宽限期），Buck 立刻接手 3917 mV / 240 mA；FLT 同时消失；
|
||||
· 重开模式 + VBUS → 2 s 回 fastboot。`fastboot getvar unlocked: yes`（BL 确已解锁）；
|
||||
· ⚠️ **`fastboot reboot` 回 MIUI 的开机过程中出现 −59 mA 反灌 ⇒ SW-8 断 VBUS**（事件 290）。机理：开机大负载时 Buck 在连续导通，
|
||||
节点只比设定高几 mV、没到 eFuse 的 −9.3 mV 阻断门限，充电器灌进来的电被 Buck 反向吸收。12V 母线没动（12.029~12.031）。
|
||||
**反灌判据保留是对的**；实际影响只是「重启过渡时 USB 可能被断，进系统后再开 VBUS」。
|
||||
|
||||
## 0.1.4：整片刀片不应答 ⇒ 关这一路（2026-09-28，用户拍板）
|
||||
- `t_safety` 每路锁内：eFuse 开着、本路 INA226 **和** PCA9555 同时 NAK，连续 `T_SAFETY_BLADE_MUTE_N` = 10 圈（200 ms）
|
||||
|
||||
在新工单中引用
屏蔽一个用户