固件 A16：风扇闭环接进任务体 + NTC / TACH 真实采样（已上板）
- ntc.{h,c}（宿主机可测）：分压端 mV → Ω → NCP18XH103F03RB 的 R-T 表插值；
开路 / 短路 / 表外一律「读不到」（t_thermal 因此满速）
- thermal_esp.{h,c}（仅 IDF）：ADC1 oneshot + 曲线校准读两路 NTC；两个 PCNT 单元数 TACH 边沿
- app_main：task_thermal 任务体、t_thermal_init 放在上电恢复之前、status 带热管理快照
- test_ntc.c 4 例；全工程 429 例全绿；版本 0.1.0-a16
- 板 B：两路 NTC 38.2 / 34.0 °C；风扇两路 rpm 0 报停转（拉满电流不涨，疑未插风扇，待确认）
Co-Authored-By: Claude Opus 5.5 <[email protected]>
这个提交包含在：
zhou yang
+21
-37
@@ -1,49 +1,33 @@
|
||||
# 交接
|
||||
更新：2026-09-27 完成 **A15**（启动顺序 + 降级矩阵，需求 §10.9 / §10.10）
|
||||
更新：2026-09-27 完成 **A16**（风扇闭环接进任务体 + NTC / TACH 的真实采样）。**A1~A16 全部完成 ⇒ M1 的固件部分齐了**
|
||||
|
||||
## 一句话现状
|
||||
启动序列从 `app_main.c`（只进 IDF、一行测不到）拆进 `main/bringup.{h,c}`，宿主机 `test_bringup.c` **24 例**逐个「拔掉」器件对 §10.10 逐行。
|
||||
**24 个 ctest、425 个用例全绿**，`idf.py build` 通过（**0xE2C60，分区剩 11%**）。板 B（COM5）已烧 **0.1.0-a15**。
|
||||
`t_thermal` 的判据在 R-6 就写好测过了；A16 补的是它两个回调的真实来源（NTC 走 ADC1、TACH 走 PCNT）和任务体。
|
||||
**25 个 ctest、429 个用例全绿**，`idf.py build` 通过（**0xE9920，分区只剩 9%**）。板 B（COM5）已烧 **0.1.0-a16**。
|
||||
|
||||
## 下一步
|
||||
- **A16**：风扇闭环接进 `t_thermal` 任务体（app_main.c 的 `task_thermal` 还是空壳；`cmd_env.thermal` 仍是 NULL）。
|
||||
- 服务器：`rack/backend/prrack/protocol.py` 已加事件 17，已部署（HOST=10.5.5.13，26 例过）。
|
||||
- 待核：CH224A 读到 5000 mA（100 W），而 PROGRESS 早上记的是 20V/3A —— 换了充电器，还是 0x50 的理解有误？
|
||||
- ⚠️ **风扇待你确认**：板 B 上两路都报 `rpm 0` + 停转；拉到 100 % 时输入电流**没有上升**（130 → 110 mA，属波动）
|
||||
⇒ 多半是**风扇没插 / 没转**，而不是 TACH 没数到。插上风扇后看 `status.fan.rpm`；若在转却仍是 0，查 Q9/Q10 与 PCNT。
|
||||
- 风扇闭环四个阈值 + 占空比下限 + PPR 都是「待上板实测」（t_thermal.h），手机上架跑满载之后再定。
|
||||
- **分区只剩 9%**：C2（OTA 双分区）前必须重排分区表（模组 16 MB，sdkconfig 只按 8 MB 用）。
|
||||
- 仍欠（A15 留下的）：I²C 总线挂死恢复（HAL 层）；PD 上限的降载动作（§8.3）；CH224A 读到 100 W 与早上记的 20V/3A 不一致，待核。
|
||||
|
||||
## 本次新增/修改的文件
|
||||
- `main/bringup.{h,c}` **新** — 两段：`bringup_devices()`（§10.9 第 1~4 步 + 降级）、`bringup_power_restore(want)`（第 5~6 步）
|
||||
- `main/app_main.c` — 启动段换成两段调用；**`t_safety` 在两段之间 spawn**（上电时巡检已在看）；
|
||||
`evlog_init_ex(esp_reset_reason())` 挪到最前；NVS 键 `phonerail/rail_want` 存「意图」；`hub_reset_pulse_once()` 搬进 bringup.c
|
||||
- `main/cmd.h` / `cmd_exec.c` — `cmd_env_t` 加 `intent` 回调，只有 `power` 命令真的生效时调
|
||||
- `main/evlog.{h,c}` — `evlog_init_ex(boot_arg)`；新事件 **`LOG_EV_PG_TIMEOUT = 17`**
|
||||
- `main/rail.{h,c}` — `rail_volt_init_one(addr)`；`rail_volt_init()` 一片失败**不再放弃另一片**
|
||||
- sim：`sim_gpio_rise_us()`、`sim_gpio_set_hook()`；`sim_gpio_drive()` 可在配置前调、跨 config 保持（刀片把 PRSNT# 短到地与固件何时配脚无关）
|
||||
- `test/test_bringup.c` **新**（24 例）；`test_cmd.c` +1（意图）；`test_evlog.c` 冻结号 +17；版本 `0.1.0-a15`
|
||||
- `main/ntc.{h,c}` **新**（宿主机可测）— mV → Ω → 查 Murata NCP18XH103F03RB 的 R-T 表（−40~125 °C、5 °C 一格、格内线性插值）；
|
||||
贴 +3V3 / 贴地 / 表外一律「读不到」（⇒ t_thermal 满速）
|
||||
- `main/thermal_esp.{h,c}` **新**（只进 IDF）— ADC1 oneshot + 曲线拟合校准（8 次平均，引脚反查通道）；两个 PCNT 单元数 TACH 上升沿（累计计数、1 µs 毛刺滤波）
|
||||
- `main/app_main.c` — `task_thermal` 任务体（每 10 s 打一行温度 / mV / 占空比 / 转速）；`thermal_esp_init()` + `t_thermal_init()` 放在**上电恢复之前**；`cmd_env.thermal = &s_therm`
|
||||
- `main/CMakeLists.txt` REQUIRES 加 `esp_adc esp_driver_pcnt`；`host/CMakeLists.txt` 加 `ntc.c`
|
||||
- `test/test_ntc.c` **新**（4 例：表点、⭐方向「越热电压越低」、⭐开路/短路不是温度、比例式）；版本 `0.1.0-a16`
|
||||
|
||||
## §10.10 各行落在哪
|
||||
| 行 | 行为 | 用例 |
|
||||
|---|---|---|
|
||||
| 刀片 INA226 无应答 | 照常上电、`blind`、I2C_LOST(rail, 0x40) | `test_row_rail_ina_missing_keeps_power` |
|
||||
| DAC 无应答 | 不关输出、另一片照样初始化、影子回 3.90 | `test_row_dac_missing_…` |
|
||||
| PCA9555 无应答 | 照常上电，PG 改按 INA226 电压；两样都看不见 = 开着报 unverified | `test_row_pca_*`（3 例） |
|
||||
| mux 选不中 | 脉冲一次 MUX_RST#，仍不通 ⇒ 一路不开、MUX_LOST，不碰主干 | `test_row_mux_*`（2 例） |
|
||||
| PRSNT# 高 | 不发一个总线字节、不上电；想开的才记 SLOT_EMPTY | `test_row_empty_slot_*`（2 例） |
|
||||
| CH224A 读不到 / 偏低 | 按 60 W / 按读到的，PD_LIMIT 事件 | `test_row_pd_*` + 通道 5 兜底 |
|
||||
| 看门狗复位 | BOOT.arg = 复位原因 | `test_row_watchdog_reset_is_recorded_in_boot` |
|
||||
| **I²C 总线挂死** | ⛔ **没做**（9 个时钟恢复在 HAL 层） | — |
|
||||
|
||||
注错验证过：删掉 `ina226_set_reversed(0x43)` ⇒ 第一条红；错开改成 1 ms ⇒ 两条红。
|
||||
|
||||
## 上板实测（板 B，五槽空）
|
||||
## 上板实测（板 B，五槽空，风扇状态未知）
|
||||
```
|
||||
status: "fw":"0.1.0-a15","in":{"mv":12034,"ua":98500} ← 输入电流第一次是真值（以前 Calibration 没写，恒 0）
|
||||
events: [27, 51, 0, 1(BOOT), 11(ESP_RST_USB), …] [28, 155, 0, 16(PD_LIMIT), 0, 1000(=100 W), 5000 mA]
|
||||
status: "temp":[38249,34027] 分压端 1266 / 1384 mV ← 两路 NTC 读数合理（NTC1 在电感区更热）
|
||||
"fan":{"duty":300,"en":true,"rpm":[0,0],"stall":[true,true]}
|
||||
events: [31, 14318, 0, 11(FAN_STALL), 0] [32, …, 11, 1] ← 启动宽限 5 s + 一个窗口之后各报一次，不刷屏
|
||||
```
|
||||
没有 I2C_LOST ⇒ 两片 DAC / 输入侧 INA226 / CH224A 都在主干应答。复位原因是 USB ⇒ 没碰 HUB_RST#，COM5 没掉。
|
||||
**上电复位路径（Hub 脉冲、DAC NVM 核对）和有刀片时的逐路上电还没在实物上走过**——要等刀片 + 手机上架。
|
||||
|
||||
## 踩到的坑（只写会再犯的）
|
||||
- ⛔ **mux 死了主干也够不着**：`i2cbus_xact(TRUNK)` 先写 mux「全关」，失败就不跑回调。别以为「DAC 在主干上就不受 mux 影响」。
|
||||
- sim 里同一地址在主干和某通道各挂一个，主干那颗 `present=false` 时仍会先被匹配 ⇒ NAK。测「只在通道 5」要主干上干脆不挂。
|
||||
- 设定电压**不持久化**：热重启后五路回到 3.90 V（bringup 把 DAC 重写成安全值）。上位机要的话重下。
|
||||
- `python` 在这台机器的 Git Bash 里是 Windows Store 占位程序，会挂住；一律用 `/c/Python314/python`。
|
||||
- 比例式 NTC 的电源误差估算：+3V3 偏 1 % 在 25 °C 附近是 **~0.6 °C**（中点处电阻误差是电源误差的 2 倍、NTC 每度 ~4 %），不是 0.3 °C。
|
||||
- PowerShell 5.1 的 `Set-Content -Encoding utf8` 会写 BOM —— 改 `phonerail.h` 这种文件用 sed，别用它。
|
||||
- `python` 在 Git Bash 里是 Windows Store 占位程序，会挂住；一律用 `/c/Python314/python`。
|
||||
|
||||
在新工单中引用
屏蔽一个用户