固件 0.1.14~0.1.16-c5：Hub 按需启停（hubctl）、开机长按统一 5 s

Co-Authored-By: Claude Opus 5.5 <[email protected]>

firmware/HANDOFF.md

@@ -1,5 +1,38 @@
 # 交接
-更新：2026-09-28 23:20　固件 **0.1.13-c5**（断电自动退出刷机模式）；板 B 经 OTA 推上；rack 已部署
+更新：2026-09-30　固件 **0.1.16-c5**（开机键统一 5 s）；板 B 经 OTA 推上；rack 已部署
+
+## 0.1.15 / 0.1.16：开机长按 3 s 试验失败，所有开机操作统一 5 s（2026-09-30）
+- 0.1.15 把 `ACT_KEY_MS_ON` 5000 → 3000：板 B 第 2 路 `power_cycle` 三轮全是「按住 330~390 mA、松手掉回 0」⇒ `no-boot`（事件 19）；
+  同一台手工 `key pwr 5000` 一次开起来（松手后稳在 ~250 mA）。⇒ 小米8 开机键 2 s、3 s 都不够，**别再往下调**。
+- 0.1.16 改回 5000；rack 单路「更多 → 开机」原来发的是 `ms:2000`（多半从来就开不了机），改成 5000、文案「长按电源 5 秒」。
+- 上板：第 3 路 `power_cycle` → hr-boot 5 s → 松键后 ~210 mA 平台 → `res ok`。
+
+## 0.1.14：Hub 按需启停（2026-09-29，用户定「方案一：GPIO8 按住复位」）
+- 起因：五路 VBUS 全关时，上行连着电脑 Hub 仍是活动态（第 6 口的 ESP32 USB 让电脑挂不起它），约多耗 1 W。
+- **推翻 R2 D13 代价 2 / R-11「运行期不许动 `HUB_RST#`」**，理由与退路见 `刀片式方案规划-R2.md` §8.2a、`main/hubctl.h` 文件头。
+- 新模块 `hubctl.{h,c}`：执行器任务每拍 `hubctl_tick()`（空闲时 ≤100 ms 一拍）。开的理由（按优先级）
+  `mode` 常开 > `vbus` 任一路 VBUS > `flash` 刷机模式 > `act` 执行器忙 > `hold` 保持窗口 > `link` MQTT 断满 60 s；
+  都没有时再给 `idle` 10 分钟（`HUB_IDLE_MS`），从最后一次「需要」算起 —— 启动、`UP_VBUS_DET` 上升沿、USB 上来一条命令都算。
+  关 = GPIO8 配输出拉低；开 = 配成输入靠 R716 拉高，**从不驱高**。
+- **命令 15 `hub`**（两条链路都收，会动东西 ⇒ 必须带 seq）：
+  `{"cmd":"hub","mode":"auto"|"on"}` 改模式（NVS 键 `hub_mode`，默认 auto）；
+  `{"cmd":"hub","min":30}` 保持 1~240 分钟；`{"cmd":"hub","min":0}` 取消保持并结束 idle 窗口（没别的理由下一拍就关，量功耗用）。
+  两个键可同时给。回应带 `"hub":{...}`。
+- status 新增 `"hub":{"on":true,"mode":"auto","why":"vbus","hold":秒,"idle":秒}`（满配 1140 / 1536 字节）。
+- **事件 22 `LOG_EV_HUB`**（rail 0）：arg 0 = 关、1 = 开、0x10|模式 = 改模式；bus_mv = 开的理由（`hub_why_t`，冻结：
+  0 off / 1 mode / 2 vbus / 3 flash / 4 act / 5 hold / 6 link / 7 idle）。
+- `bringup.c` 的上电脉冲不变（仍只在 POWERON）；脉冲后 `hubctl_init()` 把脚放成输入。
+- 测试：新增 `test_hubctl`（9 例：启动窗口、理由优先级、断网 60 s、电脑插上 / USB 命令刷新、保持与 min=0、
+  时钟回绕不复活、引脚从不写 1 且每次翻转只记一条、模式存盘、NVS 垃圾值回 auto），`test_cmd` +1（hub 命令）、
+  `test_evlog` / 冻结编号同步；**27 ctest 全绿**；IDF 构建通过（0xf5960，余 68%）。
+- ✅ **板 B 实测（2026-09-29，0.1.14-c5，三路手机开着、VBUS 全关、上行插着电脑）**：Hub 开 / 关交替各 60 s，
+  看「底板损耗 = 输入 − 三路主板合计」（手机电流 ±100 mA 的抖动会淹没输入电流）：开 **1.77 W**，关 0.69 / 0.72 / 0.80 W ⇒
+  **Hub 空转 ≈ 1.03 W**（12 V 输入电流 377 → 288 mA）。原始数据 `10.5.5.13:/root/phonerail-src/bench-hub-20260929.jsonl`，
+  脚本 `bench-hub.sh` 同目录。`hub min:0` 下一拍就关、`hub min:3` 立刻开（why = hold），事件 22 各记一条。
+- ✅ **rack**：白名单放行 `hub`（mode auto/on、min 0~240）；事件 22 命名（唤醒理由 / 休眠 / 模式改为…，mV 列置空）；
+  单板页「Hub」一行：状态 + 按需 / 常开 + 「唤醒 30 分」+「马上休眠」；模拟板同步。pytest 50 例，已部署。
+- ⏳ **没验证**：上行电脑不是本机也不是服务器，电脑那一侧 Hub 消失 / 重现、手机 VBUS 开后 adb 1~2 s 回来，都还没亲眼看过。
+- ⚠️ 现在起板 B 没人用 USB 满 10 分钟 COM 口就消失 —— 要 USB 烧录 / 看日志，先在 rack 点「唤醒 30 分」（或 MQTT 发 `hub min`）。
 
 ## 0.1.13：这一路断了电 ⇒ 刷机模式一并退出（2026-09-28）
 - 起因：第 2 槽刀片带电拔走后，刷机模式还挂了约 48 分钟、占着「最多 2 路」的名额。`check_present` / SR-5 / 刀片不应答 /