firmwareloop 0.1.7__tar.gz → 0.1.8__tar.gz

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.1.7
+Version: 0.1.8
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -363,7 +363,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.7)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.8)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -373,7 +373,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.1.7）
+## 能力验证状态（v0.1.8）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -394,7 +394,7 @@ claude mcp remove --scope user agentic-hil
 | Safety Policy（limits.yaml） | Implemented（simulator 校验）-> 外置权威配置 |
 | 自动修复闭环（M6 载体） | Simulator Validated -> Real Hardware Validated 待 DUT |
 | NdtBox 数据采集/调试（fw_ndtdbg_status / fw_ndtdbg_measure, ChipSea Fxx IIC） | Implemented（无硬件 Fail-Closed 已验证）-> Real Hardware Validated 待 NdtBox |
-| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Implemented（时序对齐原厂 UpdateFW, 双闸门 Fail-Closed 已验证）-> Real Hardware 待烧录验收 |
+| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass, ~22s；双闸门 Fail-Closed） |
 
 ---
 

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/README.md

@@ -335,7 +335,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.7)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.8)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -345,7 +345,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.1.7）
+## 能力验证状态（v0.1.8）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -366,7 +366,7 @@ claude mcp remove --scope user agentic-hil
 | Safety Policy（limits.yaml） | Implemented（simulator 校验）-> 外置权威配置 |
 | 自动修复闭环（M6 载体） | Simulator Validated -> Real Hardware Validated 待 DUT |
 | NdtBox 数据采集/调试（fw_ndtdbg_status / fw_ndtdbg_measure, ChipSea Fxx IIC） | Implemented（无硬件 Fail-Closed 已验证）-> Real Hardware Validated 待 NdtBox |
-| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Implemented（时序对齐原厂 UpdateFW, 双闸门 Fail-Closed 已验证）-> Real Hardware 待烧录验收 |
+| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass, ~22s；双闸门 Fail-Closed） |
 
 ---
 

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.1.7
+Version: 0.1.8
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -363,7 +363,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.7)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.8)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -373,7 +373,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.1.7）
+## 能力验证状态（v0.1.8）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -394,7 +394,7 @@ claude mcp remove --scope user agentic-hil
 | Safety Policy（limits.yaml） | Implemented（simulator 校验）-> 外置权威配置 |
 | 自动修复闭环（M6 载体） | Simulator Validated -> Real Hardware Validated 待 DUT |
 | NdtBox 数据采集/调试（fw_ndtdbg_status / fw_ndtdbg_measure, ChipSea Fxx IIC） | Implemented（无硬件 Fail-Closed 已验证）-> Real Hardware Validated 待 NdtBox |
-| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Implemented（时序对齐原厂 UpdateFW, 双闸门 Fail-Closed 已验证）-> Real Hardware 待烧录验收 |
+| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass, ~22s；双闸门 Fail-Closed） |
 
 ---
 

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "firmwareloop"
-version = "0.1.7"
+version = "0.1.8"
 description = "AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)"
 readme = "README.md"
 authors = [

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/tools/__init__.py

@@ -2,4 +2,4 @@
 FirmwareLoop - AI Agent Firmware Development and Lab Automation Platform.
 """
 
-__version__ = "0.1.7"
+__version__ = "0.1.8"

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/tools/fw_mcp_server.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.1.7).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.1.8).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
 Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, Cursor) via the Model Context
@@ -1487,7 +1487,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.1.7"
+                    "version": "0.1.8"
                 }
             }
         }
@@ -1579,7 +1579,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.1.7)")
+    print("  FirmwareLoop Auto-Updater (v0.1.8)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1849,7 +1849,7 @@ def set_ndtdbg_dlldir(dll_path: str) -> str:
 def handle_cli_setup() -> int:
     """Handle `firmwareloop setup` command: simultaneously configure Antigravity CLI, Claude Code CLI, Qoder IDE, and CodeBuddy IDE."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.7)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.8)")
     print("============================================================")
     print("")
 
@@ -1974,7 +1974,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.7)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.8)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -1995,7 +1995,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.7)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.8)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -2035,7 +2035,7 @@ def main() -> None:
                 sys.exit(2)
             sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.1.7")
+            print("FirmwareLoop v0.1.8")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/tools/lib/ndtdbg.py

@@ -217,6 +217,64 @@ class NdtBoxIo:
         data = self._bridge("raw", WriteHex=write.hex(), ReadLen=read_len)
         return bytes.fromhex(data["hex"].replace(" ", "")) if read_len > 0 else None
 
+    def _bridge_pipe(self, action: str, payload_text: str, timeout_ms: int | None) -> dict:
+        """把 JSON 文本经 stdin 送入桥的批量 action, 单进程执行。
+
+        #progress 进度行由桥写 stdout (非 JSON), 本方法转发到本进程 stderr。
+        末行为 JSON: {ok:false,...} -> 转 NdtBoxError (Fail-Closed); 成功返回 data。
+        """
+        import sys
+        args = [PS32, "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass",
+                "-File", self.bridge_ps1, "-Action", action,
+                "-DllDir", self.dll_dir, "-SlaveAddr", str(self.slave_addr),
+                "-Speed", str(self.speed)]
+        to = self.timeout_ms if timeout_ms is None else timeout_ms
+        try:
+            proc = subprocess.run(args, input=payload_text.encode("utf-8"), capture_output=True,
+                                  timeout=to / 1000.0, check=False)
+        except subprocess.TimeoutExpired:
+            raise NdtBoxError("INSTRUMENT_TIMEOUT", f"桥 {action} 执行超时 >{to}ms", None)
+        out = (proc.stdout or b"").decode("utf-8", errors="replace")
+        lines = [ln for ln in out.splitlines() if ln]
+        for ln in lines[:-1]:
+            if ln.startswith("#progress"):
+                print(ln, file=sys.stderr, flush=True)
+        if not lines:
+            tail = (proc.stderr or b"").decode("utf-8", errors="replace").strip()[-400:]
+            raise NdtBoxError("UNKNOWN_ERROR", f"桥 {action} 无输出 (exit={proc.returncode})", tail or None)
+        try:
+            result = json.loads(lines[-1])
+        except json.JSONDecodeError as exc:
+            raise NdtBoxError("UNKNOWN_ERROR", f"桥 {action} 输出非 JSON", out[-400:]) from exc
+        if not result.get("ok"):
+            raise NdtBoxError(result.get("error_class", "UNKNOWN_ERROR"),
+                              result.get("error", f"桥 {action} 返回失败"),
+                              result.get("detail"))
+        return result.get("data", {})
+
+    def run_ops(self, ops: list[dict], timeout_ms: int | None = None) -> dict:
+        """在单个 32 位 PS 进程内顺序执行 ops——批量路径避免逐帧 spawn 进程开销。
+
+        ops item: {"op":"sleep","ms":N} | {"op":"w","hex":"<帧 hex>"} |
+                  {"op":"r","hex":"<2B 地址 hex>","len":N}
+        桥自动为 w/r 前置从机地址; r 的读回按序进入返回 read_hexes (无空格 hex, 每窗一条)。
+        """
+        if not ops:
+            raise NdtBoxError("CONFIG_ERROR", "run_ops 空序列", None)
+        return self._bridge_pipe("run", json.dumps(ops, separators=(",", ":")), timeout_ms)
+
+    def flash_exec(self, plan: dict, timeout_ms: int | None = None) -> dict:
+        """单进程完整固件烧录 (bridge "flash"), 复刻原厂 GUI 进程模型:
+        usb2io(IO10) 断电复位进 boot + USBIOX IIC 全序列在**同一进程同一会话**内连续执行,
+        消除跨进程的"断电->擦除"间隔。校验 (逐窗 vs expect_hex) 在桥内完成, 失败即
+        {ok:false, TARGET_MISMATCH} -> 本方法转 NdtBoxError (Fail-Closed)。
+
+        plan: {"off_ms":200,"erase_ms":2000,"page_gap_ms":30,"read_gap_ms":10,
+               "writes":["<2B 地址+128B 数据帧 hex>",...],
+               "windows":[{"off":0,"expect_hex":"<256B hex>"},...]}
+        """
+        return self._bridge_pipe("flash", json.dumps(plan, separators=(",", ":")), timeout_ms)
+
     def vbrt_reset(self, off_ms: int = 200) -> dict:
         """模组断电 off_ms 后恢复上电 (usb2io.dll IO10)——复位进入 IIC boot (IOoperation.VBRTOFF)。"""
         return self._bridge("vbrt", OffMs=off_ms)
@@ -290,60 +348,43 @@ class ChipSeaFxx:
 
     def flash_bin(self, file_path: str, erase_ms: int = 2000,
                   progress=None) -> dict:
-        """经 NdtBox IIC 烧录 .bin/.nfw 固件到芯海 Fxx。
+        """经 NdtBox IIC 烧录 .bin/.nfw 固件到芯海 Fxx (单进程 flash action)。
 
-        时序逐行对齐 ChipSea.cs UpdateFW:
-          LoadFile -> VBRTOFF(200) 断电复位进 boot -> 100ms -> 擦除魔数 -> erase_ms ->
-          逐 128B 页写(30ms 间隔) -> 200ms -> 逐 256B 窗回读校验(10ms 间隔) ->
-          完成魔数 "PASs" -> VBRTOFF(200) 复位加载新固件。
+        时序逐行对齐 ChipSea.cs UpdateFW, 进程模型对齐原厂 STDataCollection GUI:
+          VBRTOFF(200) 断电复位进 boot -> 100ms -> 擦除魔数 -> erase_ms ->
+          逐 128B 页写(30ms) -> 200ms -> 逐 256B 窗回读校验(10ms, 桥内逐窗比对) ->
+          完成魔数 "PASs" -> VBRTOFF(200) 复位加载。
+        整条序列在**一个 32 位 PS 进程**内连续执行 (usb2io + USBIOX 句柄同持),
+        消除跨进程"断电->擦除"间隔, ~15s 量级。帧组装在本层 (可单测),
+        校验失败由桥 {ok:false, TARGET_MISMATCH} -> flash_exec 抛 NdtBoxError (Fail-Closed)。
 
-        progress(phase, done, total) 在 write/verify 阶段回调。
-        校验不匹配抛 TARGET_MISMATCH (Fail-Closed, 不伪造成功)。
+        progress(phase, done, total) 在 verify 阶段末回调 (逐帧 #progress 由桥转发到 stderr)。
         """
         import time
-
         fw_type, fw = load_firmware(file_path)
         started = time.monotonic()
-        pages = [fw[i:i + FLASH_WRITE_PAGE] for i in range(0, len(fw), FLASH_WRITE_PAGE)]
+        pages = list(range(0, len(fw), FLASH_WRITE_PAGE))
         windows = list(range(0, len(fw), FLASH_READ_WINDOW))
-
-        self._io.vbrt_reset(200)
-        time.sleep(BOOT_READY_MS / 1000.0)
-        self._io.raw_write_read(b"\x00\x00" + ERASE_MAGIC, 0)
-        time.sleep(0.010)
-        time.sleep(erase_ms / 1000.0)
-
-        for i, page in enumerate(pages):
-            self._io.raw_write_read(build_page_write_frame(i * FLASH_WRITE_PAGE, page), 0)
-            time.sleep(PAGE_WRITE_GAP_MS / 1000.0)
-            if progress:
-                progress("write", i + 1, len(pages))
-
-        time.sleep(0.200)
-        for i, off in enumerate(windows):
-            expect = expected_read_window(fw, off)
-            got = self._io.raw_write_read(off.to_bytes(2, "big"), FLASH_READ_WINDOW)
-            if got != expect:
-                diff = next(k for k in range(FLASH_READ_WINDOW) if got[k] != expect[k])
-                raise NdtBoxError(
-                    "TARGET_MISMATCH",
-                    f"烧录校验失败 @0x{off + diff:04X}",
-                    f"expect={expect[diff:diff + 8].hex()} got={got[diff:diff + 8].hex()}")
-            time.sleep(PAGE_READ_GAP_MS / 1000.0)
-            if progress:
-                progress("verify", i + 1, len(windows))
-
-        self._io.raw_write_read(b"\x00\x00" + FINISH_MAGIC, 0)
-        time.sleep(0.010)
-        self._io.vbrt_reset(200)
-
+        plan = {
+            "off_ms": 200,
+            "erase_ms": int(erase_ms),
+            "page_gap_ms": PAGE_WRITE_GAP_MS,
+            "read_gap_ms": PAGE_READ_GAP_MS,
+            "writes": [build_page_write_frame(off, fw[off:off + FLASH_WRITE_PAGE]).hex()
+                       for off in pages],
+            "windows": [{"off": off, "expect_hex": expected_read_window(fw, off).hex()}
+                        for off in windows],
+        }
+        res = self._io.flash_exec(plan)
+        if progress:
+            progress("verify", len(windows), len(windows))
         return {
             "file": file_path,
             "file_type": fw_type,
             "fw_len": len(fw),
             "pages_written": len(pages),
             "read_windows": len(windows),
-            "erase_ms": erase_ms,
-            "verify": "pass",
+            "erase_ms": int(erase_ms),
+            "verify": res.get("verify", "pass"),
             "duration_ms": int((time.monotonic() - started) * 1000),
         }

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/tools/ndtdbg_bridge.ps1

@@ -4,7 +4,7 @@
 # 输出: stdout 单行 JSON {ok, action, data} 或 {ok:false, error_class, error, detail}。
 param(
     [Parameter(Mandatory = $true)]
-    [ValidateSet("open", "read", "write", "version", "connect", "poll", "close", "raw", "vbrt")]
+    [ValidateSet("open", "read", "write", "version", "connect", "poll", "close", "raw", "vbrt", "run", "flash")]
     [string]$Action,
 
     [string]$DllDir,
@@ -245,13 +245,18 @@ try {
         }
         "raw" {
             # 对齐 ChipSea.cs 的多字节地址事务: 写 [slave, wBuf...] 再读 ReadLen 字节 (IIC.WriteRead 语义)
+            # 注意: $wb 不含从机地址, 必须前置 $SlaveAddr 为事务首字节 (USBIO_StreamI2C 以 wBuffer[0] 为从机地址)。
+            # 历史上曾遗漏该前置, 导致首字节(页地址)被当作从机地址, 事务从未到达芯片, 校验读回全 FF。
             $wb = Parse-Hex $WriteHex
             if ($wb.Count -eq 0) { Fail "CONFIG_ERROR" "raw 需要 -WriteHex (不含从机地址的写事务字节)" $null }
             if (($wb.Count + 1) -gt 256) { Fail "CONFIG_ERROR" "raw 写事务过长 (含从机地址须 <=256)" $wb.Count }
             if ($ReadLen -lt 0 -or $ReadLen -gt 256) { Fail "CONFIG_ERROR" "raw -ReadLen 越界 (0..256)" $ReadLen }
+            $tx = New-Object byte[] ($wb.Count + 1)
+            $tx[0] = [byte]$SlaveAddr
+            [Array]::Copy($wb, 0, $tx, 1, $wb.Count)
             $h = Open-Device 0
             $rb = New-Object byte[] $ReadLen
-            if (-not (Invoke-WriteRead $h $wb $rb)) { Fail "TARGET_MISMATCH" ("IIC raw 事务无应答 (w={0}B r={1}B)" -f $wb.Count, $ReadLen) (($wb | ForEach-Object { $_.ToString("X2") }) -join " ") }
+            if (-not (Invoke-WriteRead $h $tx $rb)) { Fail "TARGET_MISMATCH" ("IIC raw 事务无应答 (w={0}B r={1}B)" -f $tx.Count, $ReadLen) (($tx | ForEach-Object { $_.ToString("X2") }) -join " ") }
             [STDataCollection.Icb]::USBIO_CloseDevice([uint32]0) | Out-Null
             $dataOut = @{ written = $wb.Count; read = $ReadLen }
             if ($ReadLen -gt 0) { $dataOut.hex = (($rb | ForEach-Object { $_.ToString("X2") }) -join " ") }
@@ -271,6 +276,170 @@ try {
             Write-Output (@{ ok = $true; action = "vbrt"; data = @{ off_ms = $OffMs; powered_on = $true } } | ConvertTo-Json -Compress -Depth 4)
             exit 0
         }
+        "run" {
+            # 批量执行 ops (stdin JSON 数组), 单进程内完成——避免烧录等高频路径逐帧 spawn 32 位 PS 的进程开销。
+            # ops item: {"op":"sleep","ms":N} | {"op":"w","hex":"..."} | {"op":"r","hex":"<addr>","len":N}
+            # w/r 均前置 $SlaveAddr (同 raw); r 的读回按序收集进 read_hexes (无空格 hex)。
+            # 进度行以 "#progress " 前缀写 stdout (非 JSON, Python 侧转发到 stderr), 最终结果为末行 JSON。
+            $opsJson = [Console]::In.ReadToEnd()
+            $ops = $opsJson | ConvertFrom-Json
+            if (-not $ops) { Fail "CONFIG_ERROR" "run 需要 stdin 传入 ops JSON 数组" $null }
+            $h = Open-Device 0
+            $readBacks = New-Object System.Collections.ArrayList
+            $wTotal = 0; $rTotal = 0
+            foreach ($op in $ops) { if ($op.op -eq "w") { $wTotal++ } elseif ($op.op -eq "r") { $rTotal++ } }
+            $wIdx = 0; $rIdx = 0
+            foreach ($op in $ops) {
+                if ($op.op -eq "sleep") {
+                    Start-Sleep -Milliseconds ([int]$op.ms)
+                    continue
+                }
+                if ($op.op -eq "w") {
+                    $wb = Parse-Hex ([string]$op.hex)
+                    if ($wb.Count -eq 0) { Fail "CONFIG_ERROR" "run 写帧为空 (w #$($wIdx + 1))" $null }
+                    if (($wb.Count + 1) -gt 256) { Fail "CONFIG_ERROR" "run 写帧过长 (w #$($wIdx + 1))" $wb.Count }
+                    $tx = New-Object byte[] ($wb.Count + 1)
+                    $tx[0] = [byte]$SlaveAddr
+                    [Array]::Copy($wb, 0, $tx, 1, $wb.Count)
+                    if (-not (Invoke-WriteRead $h $tx (New-Object byte[] 0))) {
+                        Fail "TARGET_MISMATCH" ("IIC run 写无应答 (w {0}/{1})" -f ($wIdx + 1), $wTotal) (($tx | ForEach-Object { $_.ToString("X2") }) -join " ")
+                    }
+                    $wIdx++
+                    Write-Output ("#progress write {0}/{1}" -f $wIdx, $wTotal)
+                    continue
+                }
+                if ($op.op -eq "r") {
+                    $ab = Parse-Hex ([string]$op.hex)
+                    $len = [int]$op.len
+                    if ($ab.Count -eq 0) { Fail "CONFIG_ERROR" "run 读地址为空 (r #$($rIdx + 1))" $null }
+                    if ($len -lt 1 -or $len -gt 256) { Fail "CONFIG_ERROR" "run 读长度越界 (r #$($rIdx + 1))" $len }
+                    $tx = New-Object byte[] ($ab.Count + 1)
+                    $tx[0] = [byte]$SlaveAddr
+                    [Array]::Copy($ab, 0, $tx, 1, $ab.Count)
+                    $rb = New-Object byte[] $len
+                    if (-not (Invoke-WriteRead $h $tx $rb)) {
+                        Fail "TARGET_MISMATCH" ("IIC run 读无应答 (r {0}/{1})" -f ($rIdx + 1), $rTotal) (($tx | ForEach-Object { $_.ToString("X2") }) -join " ")
+                    }
+                    [void]$readBacks.Add((($rb | ForEach-Object { $_.ToString("X2") }) -join ""))
+                    $rIdx++
+                    Write-Output ("#progress read {0}/{1}" -f $rIdx, $rTotal)
+                    continue
+                }
+                Fail "CONFIG_ERROR" ("run 未知 op: {0}" -f $op.op) $null
+            }
+            [STDataCollection.Icb]::USBIO_CloseDevice([uint32]0) | Out-Null
+            Write-Output (@{ ok = $true; action = "run"; data = @{ writes = $wIdx; reads = $rIdx; read_hexes = @($readBacks) } } | ConvertTo-Json -Compress -Depth 5)
+            exit 0
+        }
+        "flash" {
+            # 单进程完整固件烧录 (UpdateFW 语义, 复刻 STDataCollection GUI 进程模型):
+            #   usb2io(IO10) 断电复位进 boot -> 100ms -> 擦除魔数 -> erase_ms ->
+            #   stdin 页写帧(128B/页, page_gap) -> 200ms -> stdin 期望窗(256B) 逐窗比对 ->
+            #   完成魔数 -> usb2io 断电复位加载。
+            # usb2io 与 USBIOX 句柄在本进程内同时持有且全程连续——GUI 常驻进程模型,
+            # 消除跨进程的"断电->擦除"间隔 (须落在 app 升级服务的等待窗口内)。
+            # stdin JSON: {"off_ms":200,"erase_ms":2000,"page_gap_ms":30,"read_gap_ms":10,
+            #              "writes":["<帧 hex: 2B 大端地址+128B 数据>",...],
+            #              "windows":[{"off":0,"expect_hex":"<256B hex>"},...]}
+            $planJson = [Console]::In.ReadToEnd()
+            $plan = $planJson | ConvertFrom-Json
+            if (-not $plan) { Fail "CONFIG_ERROR" "flash 需要 stdin 传入 plan JSON" $null }
+            $offMs = [int]$plan.off_ms
+            $eraseMs = [int]$plan.erase_ms
+            $pageGap = [int]$plan.page_gap_ms
+            $readGap = [int]$plan.read_gap_ms
+            $h = Open-Device 0
+            $u = [STDataCollection.U2io]::USB2IO_Open(1)
+            if ([int]$u -eq -1) {
+                [STDataCollection.Icb]::USBIO_CloseDevice([uint32]0) | Out-Null
+                Fail "PROBE_NOT_FOUND" "USB2IO 打开失败 (设备 1); 确认 DllDir 含 usb2io.dll 且 NdtBox 已连接" $null
+            }
+            $wTotal = 0; $rTotal = 0
+            try {
+                # --- 断电复位进 boot (IOoperation.VBRTOFF) ---
+                [STDataCollection.U2io]::USB2IO_SetIoCfg($u, 10, 3) | Out-Null
+                [STDataCollection.U2io]::USB2IO_SetIoOut($u, 10, 1) | Out-Null
+                Start-Sleep -Milliseconds $offMs
+                [STDataCollection.U2io]::USB2IO_SetIoOut($u, 10, 0) | Out-Null
+                Start-Sleep -Milliseconds 50
+                Start-Sleep -Milliseconds 100   # boot ready (UpdateFW Thread.Sleep(100))
+
+                # --- 整片擦除 (EreaseChipCmd) ---
+                $magic = [byte[]](0xAA, 0x55, 0xA5, 0x5A)
+                $eb = New-Object byte[] 7
+                $eb[0] = [byte]$SlaveAddr
+                $eb[1] = 0; $eb[2] = 0
+                [Array]::Copy($magic, 0, $eb, 3, 4)
+                if (-not (Invoke-WriteRead $h $eb (New-Object byte[] 0))) {
+                    Fail "TARGET_MISMATCH" "擦除命令无应答 (StreamI2C=false)" (($eb | ForEach-Object { $_.ToString("X2") }) -join " ")
+                }
+                Start-Sleep -Milliseconds $eraseMs
+
+                # --- 逐页写 (WriteFw) ---
+                $writes = @($plan.writes)
+                $wTotal = $writes.Count
+                for ($wi = 0; $wi -lt $wTotal; $wi++) {
+                    $wb = Parse-Hex ([string]$writes[$wi])
+                    if (($wb.Count + 1) -gt 256) { Fail "CONFIG_ERROR" "flash 页写帧过长 (页 $wi)" $wb.Count }
+                    $tx = New-Object byte[] ($wb.Count + 1)
+                    $tx[0] = [byte]$SlaveAddr
+                    [Array]::Copy($wb, 0, $tx, 1, $wb.Count)
+                    if (-not (Invoke-WriteRead $h $tx (New-Object byte[] 0))) {
+                        Fail "TARGET_MISMATCH" ("页写无应答 (write {0}/{1})" -f ($wi + 1), $wTotal) (($tx | ForEach-Object { $_.ToString("X2") }) -join " ")
+                    }
+                    if ($pageGap -gt 0) { Start-Sleep -Milliseconds $pageGap }
+                    Write-Output ("#progress write {0}/{1}" -f ($wi + 1), $wTotal)
+                }
+                Start-Sleep -Milliseconds 200   # WriteFw 后至校验前 (Thread.Sleep(200))
+
+                # --- 逐窗回读校验 (ReadFwAndCheck) ---
+                $windows = @($plan.windows)
+                $rTotal = $windows.Count
+                for ($ri = 0; $ri -lt $rTotal; $ri++) {
+                    $op = $windows[$ri]
+                    $off = [int]$op.off
+                    $rb = New-Object byte[] 256
+                    $tx = New-Object byte[] 3
+                    $tx[0] = [byte]$SlaveAddr
+                    $tx[1] = [byte](($off -shr 8) -band 0xFF)
+                    $tx[2] = [byte]($off -band 0xFF)
+                    if (-not (Invoke-WriteRead $h $tx $rb)) {
+                        Fail "TARGET_MISMATCH" ("回读无应答 (read {0}/{1} @0x{2:X4})" -f ($ri + 1), $rTotal, $off) $null
+                    }
+                    $gotHex = (($rb | ForEach-Object { $_.ToString("X2") }) -join "").ToLower()
+                    $expHex = [string]$op.expect_hex
+                    if ($gotHex -cne $expHex) {
+                        $k = 0
+                        while ($k -lt $gotHex.Length -and $gotHex.Substring($k, 2) -eq $expHex.Substring($k, 2)) { $k += 2 }
+                        Fail "TARGET_MISMATCH" ("烧录校验失败 @0x{0:X4}" -f ($off + ($k / 2))) ("expect={0} got={1}" -f $expHex.Substring($k, 16), $gotHex.Substring($k, 16))
+                    }
+                    if ($readGap -gt 0) { Start-Sleep -Milliseconds $readGap }
+                    Write-Output ("#progress read {0}/{1}" -f ($ri + 1), $rTotal)
+                }
+
+                # --- 完成魔数 (UpgradeFinishCmd "PASs") ---
+                $fmagic = [byte[]](0x50, 0x41, 0x53, 0x73)
+                $fb = New-Object byte[] 7
+                $fb[0] = [byte]$SlaveAddr
+                $fb[1] = 0; $fb[2] = 0
+                [Array]::Copy($fmagic, 0, $fb, 3, 4)
+                if (-not (Invoke-WriteRead $h $fb (New-Object byte[] 0))) {
+                    Fail "TARGET_MISMATCH" "完成魔数无应答 (StreamI2C=false)" (($fb | ForEach-Object { $_.ToString("X2") }) -join " ")
+                }
+                Start-Sleep -Milliseconds 10
+
+                # --- 结束断电复位加载新固件 ---
+                [STDataCollection.U2io]::USB2IO_SetIoOut($u, 10, 1) | Out-Null
+                Start-Sleep -Milliseconds $offMs
+                [STDataCollection.U2io]::USB2IO_SetIoOut($u, 10, 0) | Out-Null
+                Start-Sleep -Milliseconds 50
+            } finally {
+                [STDataCollection.U2io]::USB2IO_Close($u) | Out-Null
+                [STDataCollection.Icb]::USBIO_CloseDevice([uint32]0) | Out-Null
+            }
+            Write-Output (@{ ok = $true; action = "flash"; data = @{ verify = "pass"; pages_written = $wTotal; read_windows = $rTotal } } | ConvertTo-Json -Compress -Depth 4)
+            exit 0
+        }
     }
 } catch {
     Fail "UNKNOWN_ERROR" "bridge 异常: $($_.Exception.Message)" $_.ScriptStackTrace

{firmwareloop-0.1.7 → firmwareloop-0.1.8}/tools/setup-agent-mcp.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.1.7).
+    Dual-Tier MCP setup and registration helper (v0.1.8).
     Inspects installed AI coding agents (Qoder, Claude Code, Antigravity, Cursor)
     and configures global MCP / skills or prints exact registration commands.
 
@@ -242,7 +242,7 @@ if ($Json) {
     Write-FwJson ([pscustomobject]$report)
 } else {
     Write-Host "============================================================" -ForegroundColor Cyan
-    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.1.7)" -ForegroundColor Green
+    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.1.8)" -ForegroundColor Green
     Write-Host "============================================================" -ForegroundColor Cyan
     Write-Host ""
     Write-Host "[1] Google Antigravity / Gemini CLI:" -ForegroundColor Yellow