固件 0.1.0-c3：计划内重启不断电（OTA / 回滚锁住 EFUSE_EN，新固件接管；SR-6 改写）

- warm_esp.{h,c}：warm_restart() 记下开着的路（RTC_NOINIT，魔数 + 掩码 + 反码）→ gpio_hold 锁五根 EN → 重启；
  目标镜像没有能力标记（第 288 字节 PRCAPS1，.rodata_custom_desc）就不锁 —— 老固件写不动锁住的 EN。
  warm_take()：软件复位 + 标记对得上才接管，一次性；再读 EN 真电平核对
- bringup：adopt 掩码；rail_en_init_keep() 接管的路写高、五根一律放开 hold（崩溃时旧锁可能还在）；
  刀片不在 / mux 失联的接管路立刻关（SLOT_EMPTY arg 1）；第二段已开着的路不重开、不等 PG
- pca9555_init_keep()：方向寄存器是本固件写的才留 VBUS（掉过电的片子锁存器是 0xFF），键 / EDL 清零
- HAL：hal_gpio_hold()；ESP 输出脚配 INPUT_OUTPUT（读得到真电平）；sim 给 hold 建模
- 事件 LOG_EV_OTA arg 7 = 接管；兜底定时器回滚故意不走接管
- 顶层 CMake：phonerail.h 进 CMAKE_CONFIGURE_DEPENDS（否则镜像头版本停在旧值）；-u g_phonerail_caps 防 gc
- test_bringup 加 6 例（接管 / 非计划复位全关 / 空槽 / mux 失联 / PCA 掉过电 / hold 冻结），全工程 448 例全绿
- rack：固件库识别能力标记，推送对话框按「支持 / 不支持重启不断电」给不同提示（已部署）
- 需求文档：SR-6 改为「非计划复位全关」+ 计划内重启例外；§10.9 新增「重启不断电」
- 板 B：台架镜像（空槽强制 CH1 在位，未提交）开 CH1 → OTA 带重启 → 事件 18/7 mv=1，CH1 一直开着；
  现跑 0.1.0-c3。未测：示波器看重启期间 EN / 输出毛刺（要插刀片）

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

rack/backend/prrack/firmware.py

@@ -29,6 +29,10 @@ SHA_RE = re.compile(r"^[0-9a-f]{64}$")
 # esp_app_desc_t 紧跟在镜像头（24 B）+ 第一个段头（8 B）之后
 _DESC = 32
 _DESC_MAGIC = 0xABCD5432
+# 能力标记（firmware/main/warm_esp.c 的 g_phonerail_caps，.rodata_custom_desc）紧跟 esp_app_desc_t（256 B）
+_CAPS = _DESC + 256
+_CAPS_TAG = b"PRCAPS1\0"
+CAP_WARM = 1  # 认「重启不断电」的接管：推它并立刻重启，手机不断电
 
 class FwError(ValueError):
     """镜像不能收 / 推送请求不对（中文说明）。"""
@@ -55,6 +59,8 @@ def parse_image(data: bytes) -> dict:
     }
     if info["project"] != PROJECT:
         raise FwError("这是「%s」的固件，不是 %s" % (info["project"], PROJECT))
+    caps = struct.unpack_from("<I", data, _CAPS + 8)[0] if data[_CAPS:_CAPS + 8] == _CAPS_TAG else 0
+    info["warm"] = bool(caps & CAP_WARM)
     return info
 
 
@@ -95,7 +101,15 @@ class FwStore:
             return None
         d = dict(rows[0])
         d["url"] = self.url_for(sha)
-        d["present"] = os.path.isfile(os.path.join(self.dir, self.name_for(sha)))
+        path = os.path.join(self.dir, self.name_for(sha))
+        d["present"] = os.path.isfile(path)
+        d["warm"] = False  # 从文件现读，不进库（不用改表）
+        if d["present"]:
+            try:
+                with open(path, "rb") as f:
+                    d["warm"] = parse_image(f.read(_CAPS + 12) + b"\0" * 256)["warm"]
+            except (OSError, FwError):
+                pass
         return d
 
     def list(self) -> List[dict]:

rack/backend/prrack/protocol.py

@@ -39,7 +39,8 @@ EVENT_TYPES: Dict[int, Tuple[str, str]] = {
 }
 
 # LOG_EV_OTA 的 arg（firmware/main/ota.h 的 ota_ev_t）与失败原因（ota_err_t，失败那条的 mV 列）。⚠️ 冻结。
-OTA_EV_NAMES = {1: "开始下载", 2: "已就绪", 3: "失败", 4: "新固件自证健康", 5: "回滚", 6: "为换固件重启"}
+OTA_EV_NAMES = {1: "开始下载", 2: "已就绪", 3: "失败", 4: "新固件自证健康", 5: "回滚", 6: "为换固件重启",
+                7: "计划内重启：接管、没断电"}
 OTA_ERR_NAMES = {1: "下载失败", 2: "大小不对", 3: "哈希不对", 4: "写 flash 失败", 5: "镜像校验不过",
                  6: "切启动分区失败", 7: "没有备用槽 / 新固件未自证"}
 

rack/backend/tests/test_firmware.py

@@ -22,12 +22,15 @@ B = "b81f3fc9c8bc"
 BASE = "http://home.example:7765/fw"
 
 
-def image(version="0.1.0-c2", project="phonerail", size=4096, salt=b"") -> bytes:
+def image(version="0.1.0-c2", project="phonerail", size=4096, salt=b"", warm=False) -> bytes:
     """最小的「像 ESP app 镜像」：镜像头 24 B + 段头 8 B + esp_app_desc_t。"""
     hdr = bytes([0xE9, 3, 2, 0x4F]) + b"\0" * 20 + b"\0" * 8
     desc = struct.pack("<II8s", 0xABCD5432, 0, b"\0" * 8)
     desc += version.encode().ljust(32, b"\0") + project.encode().ljust(32, b"\0")
     desc += b"13:31:32".ljust(16, b"\0") + b"Sep 27 2026".ljust(16, b"\0") + b"v5.4".ljust(32, b"\0")
+    desc = desc.ljust(256, b"\0")
+    if warm:
+        desc += b"PRCAPS1\0" + struct.pack("<I", 1)
     body = hdr + desc + salt
     return body + b"\xAA" * (size - len(body))
 
@@ -37,7 +40,8 @@ def image(version="0.1.0-c2", project="phonerail", size=4096, salt=b"") -> bytes
 def test_parse_image_reads_the_app_descriptor():
     info = parse_image(image())
     assert info == {"version": "0.1.0-c2", "project": "phonerail", "built": "Sep 27 2026 13:31:32",
-                    "idf": "v5.4"}
+                    "idf": "v5.4", "warm": False}
+    assert parse_image(image(warm=True))["warm"] is True
 
 
 @pytest.mark.parametrize("data, word", [
@@ -132,8 +136,8 @@ def wait_for(fn, t=2.0):
 
 def test_upload_and_list(env):
     c, hub, sim = env
-    r = upload(c, image())
-    assert r.status_code == 200 and r.json()["version"] == "0.1.0-c2"
+    r = upload(c, image(warm=True))
+    assert r.status_code == 200 and r.json()["version"] == "0.1.0-c2" and r.json()["warm"] is True
     assert r.json()["uploaded_by"] == "zhouyang"
     lst = c.get("/api/firmware").json()
     assert lst["slot"] == SLOT_BYTES and [x["sha256"] for x in lst["items"]] == [r.json()["sha256"]]