firmwareloop 0.6.2__tar.gz → 0.7.1__tar.gz

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.6.2
+Version: 0.7.1
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -18,7 +18,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyvisa>=1.14.0
-Requires-Dist: pyvisa-py>=0.7.0
+Requires-Dist: pyvisa-py>=0.7.1
 Requires-Dist: pyserial>=3.5
 Requires-Dist: pytest>=8.0.0
 Requires-Dist: pyocd>=0.36.0
@@ -148,7 +148,8 @@ fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
 - `fw_ndtdbg_measure` — 数据轮询采集
 - `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg` — 任意寄存器读写（写需 `write_allowed` + `confirm` 双门控）
 - `fw_ndtdbg_capture_seq` — 寄存器序列 + Saleae 波形同窗口取证
-- `fw_ndtdbg_flash` — .bin/.nfw 整片擦写烧录（双门控，默认拒绝）
+- `fw_ndtdbg_flash` — .bin/.nfw 整片擦写烧录（双门控，默认拒绝；擦除后判 boot、校验失败整片重写）
+- `fw_ndtdbg_power_cycle` — 只做目标断电复位（不做 I2C 事务、不需双门控；设备静默时的第一步，也是抓开机日志的触发端）
 
 **前置要求：**
 
@@ -382,7 +383,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.6.2)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.7.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -392,7 +393,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.6.2）
+## 能力验证状态（v0.7.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -400,7 +401,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
-| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（55 例单测: 含残留 serve 自动清理 / close 进程回收 / UTF-8 线路 / 失败落 JSONL）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |
@@ -414,7 +415,9 @@ 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） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass, ~22s；双闸门 Fail-Closed） |
+| NdtBox 目标断电复位（fw_ndtdbg_power_cycle, 仅 io10 断电复位, 无写闸门） | Implemented（单测覆盖时序/探针缺失指引）-> Real Hardware Validated 待 NdtBox |
+| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass；双闸门 Fail-Closed）+ v0.7.1 **差分 boot 判据**（真机实测: 擦除后读 0x0000 = 00 00 00 00, 旧"全 FF"判据在该 ROM 上永久误判 → 已改为"仅同一条非平凡应答才熔断", 并提供 `boot_judge: off` 关闭开关） |
+| 抓开机日志（fw_serial_capture + power_cycle_off_ms, 窗口内断电复位） | Implemented（simulator 验证窗口与复位串联）-> Real Hardware Validated 待 NdtBox + DUT |
 
 ---
 
@@ -427,6 +430,10 @@ claude mcp remove --scope user agentic-hil
 | 写操作 `PERMISSION_DENIED` | 全局 `lab.yaml` 的 `ndtdbg.write_allowed` 为 `false` → 临时改 `true` 并重启 Agent（测试完建议改回 `false`） |
 | sigrok 报 `Failed to receive reply to EP1 command 0x7d` | Saleae 驱动不是 libusb-win32 → 用 Zadig 重装；或设备被 Logic 软件占用（先退出） |
 | `fw_logic_decode` 空帧 | 抓取窗口内无总线事务 → 改用 `fw_ndtdbg_capture_seq`（抓取与寄存器序列同窗口进行），不要串行先抓后写 |
+| 烧录报 `BOOT_NOT_ENTERED`（擦除魔数前后 0x0000 读回**完全相同**的非平凡数据） | 差分判据认定应答者仍是运行态 App（擦除被忽略）→ 仅对目标板断电重启（勿动 BOX）后重试；反复出现时确认 `off_ms`（默认 500ms，独立看门狗芯片需真 POR）与 io10 供电复位接线。若你确认目标 ROM 的 0x0000 语义特殊，用 `boot_judge: off`（lab.yaml/CLI `--boot-judge off`/MCP `boot_judge`）关闭判据，让逐窗校验做唯一判据 |
+| `fw_ndtdbg_flash` 报 `TARGET_MISMATCH: 烧录校验失败 @0x....` | 校验是**权威判据**（不是探测启发式）。信封带 `stage_timings`/`probe_before_hex`/`probe_hex`/`boot_evidence`/`first_mismatch_*`：`boot_evidence=erase_effective` 说明擦除生效 → 看失配偏移是否恒定（恒定=页写未落地）；`inconclusive` 说明探测无区分度（擦除后读回全 00/全 FF）→ 需人工确认是否真进了 boot；整片重写次数由 `rewrite_times` 控制（默认 3） |
+| 串口 `SERIAL_PORT_ERROR: ... PermissionError(13)` | 端口被 GUI 上位机独占（NDT Debug Tool / STDataCollection.exe、串口助手）→ 关闭占用方后 `fw_serial_open`；残留会话用 `fw_serial_close`（已自动等待/强杀进程，端口释放可验证） |
+| `fw_serial_status` 的 `error_class` 为 `UART_BUSY` | 会话未打开或已被占用 → 先 `fw_serial_open`；残留会话 `fw_serial_close` 清理 |
 
 完整速查表与手工部署细节见 [`Fwloop_setup_pack/README.md`](Fwloop_setup_pack/README.md)。
 

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/README.md

@@ -120,7 +120,8 @@ fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
 - `fw_ndtdbg_measure` — 数据轮询采集
 - `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg` — 任意寄存器读写（写需 `write_allowed` + `confirm` 双门控）
 - `fw_ndtdbg_capture_seq` — 寄存器序列 + Saleae 波形同窗口取证
-- `fw_ndtdbg_flash` — .bin/.nfw 整片擦写烧录（双门控，默认拒绝）
+- `fw_ndtdbg_flash` — .bin/.nfw 整片擦写烧录（双门控，默认拒绝；擦除后判 boot、校验失败整片重写）
+- `fw_ndtdbg_power_cycle` — 只做目标断电复位（不做 I2C 事务、不需双门控；设备静默时的第一步，也是抓开机日志的触发端）
 
 **前置要求：**
 
@@ -354,7 +355,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.6.2)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.7.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -364,7 +365,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.6.2）
+## 能力验证状态（v0.7.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -372,7 +373,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
-| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（55 例单测: 含残留 serve 自动清理 / close 进程回收 / UTF-8 线路 / 失败落 JSONL）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |
@@ -386,7 +387,9 @@ 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） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass, ~22s；双闸门 Fail-Closed） |
+| NdtBox 目标断电复位（fw_ndtdbg_power_cycle, 仅 io10 断电复位, 无写闸门） | Implemented（单测覆盖时序/探针缺失指引）-> Real Hardware Validated 待 NdtBox |
+| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass；双闸门 Fail-Closed）+ v0.7.1 **差分 boot 判据**（真机实测: 擦除后读 0x0000 = 00 00 00 00, 旧"全 FF"判据在该 ROM 上永久误判 → 已改为"仅同一条非平凡应答才熔断", 并提供 `boot_judge: off` 关闭开关） |
+| 抓开机日志（fw_serial_capture + power_cycle_off_ms, 窗口内断电复位） | Implemented（simulator 验证窗口与复位串联）-> Real Hardware Validated 待 NdtBox + DUT |
 
 ---
 
@@ -399,6 +402,10 @@ claude mcp remove --scope user agentic-hil
 | 写操作 `PERMISSION_DENIED` | 全局 `lab.yaml` 的 `ndtdbg.write_allowed` 为 `false` → 临时改 `true` 并重启 Agent（测试完建议改回 `false`） |
 | sigrok 报 `Failed to receive reply to EP1 command 0x7d` | Saleae 驱动不是 libusb-win32 → 用 Zadig 重装；或设备被 Logic 软件占用（先退出） |
 | `fw_logic_decode` 空帧 | 抓取窗口内无总线事务 → 改用 `fw_ndtdbg_capture_seq`（抓取与寄存器序列同窗口进行），不要串行先抓后写 |
+| 烧录报 `BOOT_NOT_ENTERED`（擦除魔数前后 0x0000 读回**完全相同**的非平凡数据） | 差分判据认定应答者仍是运行态 App（擦除被忽略）→ 仅对目标板断电重启（勿动 BOX）后重试；反复出现时确认 `off_ms`（默认 500ms，独立看门狗芯片需真 POR）与 io10 供电复位接线。若你确认目标 ROM 的 0x0000 语义特殊，用 `boot_judge: off`（lab.yaml/CLI `--boot-judge off`/MCP `boot_judge`）关闭判据，让逐窗校验做唯一判据 |
+| `fw_ndtdbg_flash` 报 `TARGET_MISMATCH: 烧录校验失败 @0x....` | 校验是**权威判据**（不是探测启发式）。信封带 `stage_timings`/`probe_before_hex`/`probe_hex`/`boot_evidence`/`first_mismatch_*`：`boot_evidence=erase_effective` 说明擦除生效 → 看失配偏移是否恒定（恒定=页写未落地）；`inconclusive` 说明探测无区分度（擦除后读回全 00/全 FF）→ 需人工确认是否真进了 boot；整片重写次数由 `rewrite_times` 控制（默认 3） |
+| 串口 `SERIAL_PORT_ERROR: ... PermissionError(13)` | 端口被 GUI 上位机独占（NDT Debug Tool / STDataCollection.exe、串口助手）→ 关闭占用方后 `fw_serial_open`；残留会话用 `fw_serial_close`（已自动等待/强杀进程，端口释放可验证） |
+| `fw_serial_status` 的 `error_class` 为 `UART_BUSY` | 会话未打开或已被占用 → 先 `fw_serial_open`；残留会话 `fw_serial_close` 清理 |
 
 完整速查表与手工部署细节见 [`Fwloop_setup_pack/README.md`](Fwloop_setup_pack/README.md)。
 

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.6.2
+Version: 0.7.1
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -18,7 +18,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyvisa>=1.14.0
-Requires-Dist: pyvisa-py>=0.7.0
+Requires-Dist: pyvisa-py>=0.7.1
 Requires-Dist: pyserial>=3.5
 Requires-Dist: pytest>=8.0.0
 Requires-Dist: pyocd>=0.36.0
@@ -148,7 +148,8 @@ fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
 - `fw_ndtdbg_measure` — 数据轮询采集
 - `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg` — 任意寄存器读写（写需 `write_allowed` + `confirm` 双门控）
 - `fw_ndtdbg_capture_seq` — 寄存器序列 + Saleae 波形同窗口取证
-- `fw_ndtdbg_flash` — .bin/.nfw 整片擦写烧录（双门控，默认拒绝）
+- `fw_ndtdbg_flash` — .bin/.nfw 整片擦写烧录（双门控，默认拒绝；擦除后判 boot、校验失败整片重写）
+- `fw_ndtdbg_power_cycle` — 只做目标断电复位（不做 I2C 事务、不需双门控；设备静默时的第一步，也是抓开机日志的触发端）
 
 **前置要求：**
 
@@ -382,7 +383,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.6.2)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.7.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -392,7 +393,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.6.2）
+## 能力验证状态（v0.7.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -400,7 +401,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
-| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（55 例单测: 含残留 serve 自动清理 / close 进程回收 / UTF-8 线路 / 失败落 JSONL）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |
@@ -414,7 +415,9 @@ 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） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass, ~22s；双闸门 Fail-Closed） |
+| NdtBox 目标断电复位（fw_ndtdbg_power_cycle, 仅 io10 断电复位, 无写闸门） | Implemented（单测覆盖时序/探针缺失指引）-> Real Hardware Validated 待 NdtBox |
+| NdtBox IIC 固件烧录（fw_ndtdbg_flash, .bin/.nfw 整片擦写, 芯海 Fxx） | Real Hardware Validated（84.87.1.1 / 84.87.1.2 真机整片擦写 verify pass；双闸门 Fail-Closed）+ v0.7.1 **差分 boot 判据**（真机实测: 擦除后读 0x0000 = 00 00 00 00, 旧"全 FF"判据在该 ROM 上永久误判 → 已改为"仅同一条非平凡应答才熔断", 并提供 `boot_judge: off` 关闭开关） |
+| 抓开机日志（fw_serial_capture + power_cycle_off_ms, 窗口内断电复位） | Implemented（simulator 验证窗口与复位串联）-> Real Hardware Validated 待 NdtBox + DUT |
 
 ---
 
@@ -427,6 +430,10 @@ claude mcp remove --scope user agentic-hil
 | 写操作 `PERMISSION_DENIED` | 全局 `lab.yaml` 的 `ndtdbg.write_allowed` 为 `false` → 临时改 `true` 并重启 Agent（测试完建议改回 `false`） |
 | sigrok 报 `Failed to receive reply to EP1 command 0x7d` | Saleae 驱动不是 libusb-win32 → 用 Zadig 重装；或设备被 Logic 软件占用（先退出） |
 | `fw_logic_decode` 空帧 | 抓取窗口内无总线事务 → 改用 `fw_ndtdbg_capture_seq`（抓取与寄存器序列同窗口进行），不要串行先抓后写 |
+| 烧录报 `BOOT_NOT_ENTERED`（擦除魔数前后 0x0000 读回**完全相同**的非平凡数据） | 差分判据认定应答者仍是运行态 App（擦除被忽略）→ 仅对目标板断电重启（勿动 BOX）后重试；反复出现时确认 `off_ms`（默认 500ms，独立看门狗芯片需真 POR）与 io10 供电复位接线。若你确认目标 ROM 的 0x0000 语义特殊，用 `boot_judge: off`（lab.yaml/CLI `--boot-judge off`/MCP `boot_judge`）关闭判据，让逐窗校验做唯一判据 |
+| `fw_ndtdbg_flash` 报 `TARGET_MISMATCH: 烧录校验失败 @0x....` | 校验是**权威判据**（不是探测启发式）。信封带 `stage_timings`/`probe_before_hex`/`probe_hex`/`boot_evidence`/`first_mismatch_*`：`boot_evidence=erase_effective` 说明擦除生效 → 看失配偏移是否恒定（恒定=页写未落地）；`inconclusive` 说明探测无区分度（擦除后读回全 00/全 FF）→ 需人工确认是否真进了 boot；整片重写次数由 `rewrite_times` 控制（默认 3） |
+| 串口 `SERIAL_PORT_ERROR: ... PermissionError(13)` | 端口被 GUI 上位机独占（NDT Debug Tool / STDataCollection.exe、串口助手）→ 关闭占用方后 `fw_serial_open`；残留会话用 `fw_serial_close`（已自动等待/强杀进程，端口释放可验证） |
+| `fw_serial_status` 的 `error_class` 为 `UART_BUSY` | 会话未打开或已被占用 → 先 `fw_serial_open`；残留会话 `fw_serial_close` 清理 |
 
 完整速查表与手工部署细节见 [`Fwloop_setup_pack/README.md`](Fwloop_setup_pack/README.md)。
 

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/firmwareloop.egg-info/requires.txt

@@ -1,5 +1,5 @@
 pyvisa>=1.14.0
-pyvisa-py>=0.7.0
+pyvisa-py>=0.7.1
 pyserial>=3.5
 pytest>=8.0.0
 pyocd>=0.36.0

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "firmwareloop"
-version = "0.6.2"
+version = "0.7.1"
 description = "AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)"
 readme = "README.md"
 authors = [
@@ -14,7 +14,7 @@ license = { text = "MIT" }
 requires-python = ">=3.10"
 dependencies = [
     "pyvisa>=1.14.0",
-    "pyvisa-py>=0.7.0",
+    "pyvisa-py>=0.7.1",
     "pyserial>=3.5",
     "pytest>=8.0.0",
     "pyocd>=0.36.0",

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/tools/__init__.py

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

{firmwareloop-0.6.2 → firmwareloop-0.7.1}/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.6.2).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.7.1).
 
 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
@@ -21,6 +21,7 @@ Tools provided:
   - fw_ndtdbg_capture_seq: NdtBox register sequence + concurrent I2C capture for waveform evidence (ndtdbg_cli.py)
   - fw_ndtdbg_stream_start/status/stop: job mode for long stream captures (immediate job_id, CSV-tail polling, graceful stop)
   - fw_ndtdbg_flash: NdtBox IIC firmware flash (.bin/.nfw, full-chip erase, double-gated) (ndtdbg_cli.py)
+  - fw_ndtdbg_power_cycle: NdtBox target power-cycle only (no I2C transaction, no write gate; boot-log trigger) (ndtdbg_cli.py)
   - fw_ndtdbg_stream: NdtBox high-rate register stream capture to CSV via one long-lived USB session (read-only) (ndtdbg_cli.py)
   - fw_serial_status: Serial assistant session probe (serve liveness, port, RX/TX counters, log path) (serial_cli.py)
   - fw_serial_open: Serial assistant - open (or reuse) the persistent COM session (HEX/ASCII duplex, session log) (serial_cli.py)
@@ -331,35 +332,43 @@ def handle_fw_ndtdbg_write_reg(args: Dict[str, Any]) -> Dict[str, Any]:
 def handle_fw_ndtdbg_flash(args: Dict[str, Any]) -> Dict[str, Any]:
     """Erase + flash a .bin/.nfw image onto the NdtBox target chip (ChipSea Fxx) over IIC.
 
-    P1-1: retry 参数 (默认 1) —— 命中 "TARGET_MISMATCH @0x0000" (未进 boot 的特征
-    签名: 校验读到旧向量表) 自动重试; BOOT_NOT_ENTERED 不重试 (需人工断电, 直接给指引)。
+    P1-3 (0.7.1): 去掉按签名重试 —— "TARGET_MISMATCH @0x0000" 正是"根本没进 boot"的
+    特征签名 (旧 boot 判据假阳的同一条错误路径), 盲目重试只会重复同一失败路径。
+    整片重写 (<= rewrite_times) 现由 flash_exec 内部完成, 结果带 rewrite_count;
+    BOOT_NOT_ENTERED 直接返回指引 (需断电重启, 重试无意义)。
     """
     cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
     cmd = [PYTHON_EXE, cli_script, "flash-bin", "--file", str(args.get("file_path")),
            "--erase-ms", str(int(args.get("erase_ms", 2000)))]
+    if args.get("off_ms") is not None:
+        cmd.extend(["--off-ms", str(int(args["off_ms"]))])
+    if args.get("rewrite_times") is not None:
+        cmd.extend(["--rewrite-times", str(max(0, int(args["rewrite_times"])))])
+    if args.get("boot_judge"):
+        cmd.extend(["--boot-judge", str(args["boot_judge"])])
     if args.get("confirm"):
         cmd.append("--confirm")
     _ndtdbg_reg_args(args, cmd)
     timeout_s = min(max(int(args.get("timeout_seconds", 300)), 30), 900)
-    retry = max(0, int(args.get("retry", 1)))
-    result: Dict[str, Any] = {}
-    for attempt in range(retry + 1):
-        result = _ndtdbg_run(cmd, timeout_s)
-        data = result.get("data") if isinstance(result.get("data"), dict) else None
-        if not data:
-            return result   # 无 CLI JSON body: 原样返回 (兼容 mock/异常输出)
-        if data.get("ok"):
-            if attempt:
-                data["retry_count"] = attempt
-            return data
-        err_text = f"{data.get('error', '')} {data.get('detail', '')}"
-        err_cls = data.get("error_class")
-        if err_cls == "BOOT_NOT_ENTERED":
-            return data   # 需人工断电重启, 重试无意义
-        if err_cls == "TARGET_MISMATCH" and "@0x0000" in err_text and attempt < retry:
-            continue   # 未进 boot 特征签名: 自动重试
-        return data
-    return result
+    result = _ndtdbg_run(cmd, timeout_s)
+    data = result.get("data") if isinstance(result.get("data"), dict) else None
+    return data if data else result   # 无 CLI JSON body: 原样返回 (兼容 mock/异常输出)
+
+
+def handle_fw_ndtdbg_power_cycle(args: Dict[str, Any]) -> Dict[str, Any]:
+    """P0-2: 只做一次断电复位 (usb2io IO10 off -> on), 不做任何 I2C 事务。
+
+    设备静默时最安全的第一步 (读风险等级: 不需要 lab.yaml write_allowed), 也是
+    "复位 + 抓开机日志" 的触发端 —— 与 fw_serial_open/capture 配合使用。
+    返回 {off_ms, powered_on, io_ms}。
+    """
+    cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+    cmd = [PYTHON_EXE, cli_script, "power-cycle"]
+    if args.get("off_ms") is not None:
+        cmd.extend(["--off-ms", str(int(args["off_ms"]))])
+    _ndtdbg_reg_args(args, cmd)
+    res = _ndtdbg_run(cmd, 60)
+    return res.get("data") or res
 
 
 def _stream_cli_cmd(args: Dict[str, Any], out_path: str, duration_cap: float) -> Optional[list]:
@@ -1378,13 +1387,22 @@ def handle_fw_serial_parse(args: Dict[str, Any]) -> Dict[str, Any]:
 
 
 def handle_fw_serial_capture(args: Dict[str, Any]) -> Dict[str, Any]:
+    """P2-4: 可选 power_cycle_off_ms —— 开机打印只在复位瞬间出现, 必须先开端口再复位。
+
+    实现: capture 窗口在后台线程先行打开 (~200ms), 窗口内触发一次断电复位
+    (ndtdbg power-cycle), 于是复位瞬间及其后的启动日志都落在 CSV 里。
+    """
     duration_ms = int(args.get("duration_ms", 3000))
+    power_cycle = args.get("power_cycle_off_ms")
     cmd = [PYTHON_EXE, SERIAL_CLI, "capture", "--duration-ms", str(duration_ms)]
     if args.get("out"):
         cmd.extend(["--out", str(args["out"])])
+    if power_cycle is not None:
+        cmd.extend(["--power-cycle-off-ms", str(int(power_cycle))])
     if args.get("lab_config"):
         cmd.extend(["--lab-config", str(args["lab_config"])])
-    res = _serial_run(cmd, duration_ms // 1000 + 60)
+    # 断电复位 = 额外一次 32 位桥进程往返 (秒级), 计入超时预算
+    res = _serial_run(cmd, duration_ms // 1000 + 60 + (30 if power_cycle is not None else 0))
     return res.get("data") or res
 
 
@@ -1754,7 +1772,7 @@ TOOLS_REGISTRY = {
         "handler": handle_fw_ndtdbg_write_reg,
     },
     "fw_ndtdbg_flash": {
-        "description": "Erase and flash a .bin/.nfw firmware image onto the NdtBox target chip (ChipSea Fxx) over IIC via NdtDebugTool (power-cycle reset into boot -> erase magic AA 55 A5 5A -> 128B page writes -> 256B read-back verify -> finish 'PASs'). DESTRUCTIVE full-chip erase: requires lab.yaml ndtdbg.write_allowed: true AND confirm: true, otherwise PERMISSION_DENIED.",
+        "description": "Erase and flash a .bin/.nfw firmware image onto the NdtBox target chip (ChipSea Fxx) over IIC via NdtDebugTool (power-cycle reset into boot -> erase magic AA 55 A5 5A -> differential BOOT JUDGEMENT: 0x0000 is sampled once BEFORE the power cycle and once AFTER the erase; only an identical NON-TRIVIAL reading (the same App answering before and after a command only the boot ROM executes) raises BOOT_NOT_ENTERED - all-00/all-FF/no-ACK are inconclusive and proceed, because a real ROM may answer 0x0000 with 00 00 00 00 after erase -> 128B page writes -> 256B read-back verify = the authoritative criterion, whole-chip rewrite on mismatch -> finish 'PASs'). DESTRUCTIVE full-chip erase: requires lab.yaml ndtdbg.write_allowed: true AND confirm: true, otherwise PERMISSION_DENIED.",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -1777,10 +1795,18 @@ TOOLS_REGISTRY = {
                     "description": "CLI process timeout; budget ~30s per 64KB image (page writes paced at 30ms)",
                     "default": 300,
                 },
-                "retry": {
+                "off_ms": {
                     "type": "integer",
-                    "description": "Auto-retries on TARGET_MISMATCH @0x0000 signature (target did not enter boot; verify read old vector table). BOOT_NOT_ENTERED never retries (manual power-cycle required). Result carries retry_count when a retry succeeded",
-                    "default": 1,
+                    "description": "Power-off duration of the reset-into-boot power cycle, in ms. Default from lab.yaml ndtdbg.flash.off_ms, else 500 (200ms may only sag the rail - independent-watchdog chips such as CSA37F72 IWDG_S need a real POR)",
+                },
+                "rewrite_times": {
+                    "type": "integer",
+                    "description": "Whole-chip rewrite budget when read-back verify mismatches (aligned with ChipSea.cs REWRITE_TIMES). Default 3; 0 disables rewriting. The result carries rewrite_count/attempts, and a failed flash reports stage_timings/probe_before_hex/probe_hex/boot_evidence/first_mismatch_* for post-mortem",
+                },
+                "boot_judge": {
+                    "type": "string",
+                    "enum": ["diff", "off"],
+                    "description": "Boot-probe criterion. 'diff' (default): compare 0x0000 before the power cycle vs after the erase, and raise BOOT_NOT_ENTERED only when both reads are identical NON-TRIVIAL data (proof the same running App answered the erase magic). 'off': only record probe evidence (probe_before_hex/probe_hex/boot_evidence) and never block - the 256B read-back verify stays the sole criterion, i.e. exactly the bridge/GUI behaviour. Use 'off' if a target ROM reports an unexpected 0x0000 signature",
                 },
                 "dll_dir": {
                     "type": "string",
@@ -1799,6 +1825,29 @@ TOOLS_REGISTRY = {
         },
         "handler": handle_fw_ndtdbg_flash,
     },
+    "fw_ndtdbg_power_cycle": {
+        "description": "Power-cycle the NdtBox target through the reset rail (usb2io IO10 off -> on, default 500ms) WITHOUT any I2C transaction. Read-risk level: lab.yaml ndtdbg.write_allowed is NOT required. Use it as the first step when the target is silent, and as the trigger for capturing boot-time UART logs (fw_serial_open + fw_serial_capture). Returns {off_ms, powered_on, io_ms}.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "off_ms": {
+                    "type": "integer",
+                    "description": "Power-off duration in ms; default from lab.yaml ndtdbg.flash.off_ms, else 500. Independent-watchdog chips (e.g. CSA37F72 IWDG_S) only clear on a real POR/BOR/pin reset",
+                    "default": 500,
+                },
+                "dll_dir": {
+                    "type": "string",
+                    "description": "NdtDebugTool lib directory containing USBIOX.DLL and usb2io.dll; default from lab.yaml ndtdbg.dll_dir",
+                },
+                "slave_addr": {
+                    "type": "string",
+                    "description": "IIC slave address (unused by power-cycle; accepted for tool-family symmetry)",
+                },
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_ndtdbg_power_cycle,
+    },
     "fw_ndtdbg_stream": {
         "description": "Stream-read a set of IIC registers from the NdtBox target chip (ChipSea Fxx) at a fixed interval via one long-lived USB session. Writes CSV with timestamps; returns JSON summary (frames, FF_GAP/IO_FAIL/HANG counts, interval stats, io_overhead, write stats). Protocol profiles: continuous (pure-read), request-response (pre_write), stress (interleave_writes, needs confirm). NOTE: server-side timeout = duration_s + 120s; for durations beyond ~90s the MCP client may time out first - use shorter windows or the job pattern.",
         "inputSchema": {
@@ -2193,7 +2242,7 @@ TOOLS_REGISTRY = {
         "handler": handle_fw_serial_parse,
     },
     "fw_serial_capture": {
-        "description": "Serial assistant: synchronous window capture - record the RX stream for duration_ms into a timestamped CSV (t_rel_ms, dir, hex, printable) for offline analysis/plotting (real-time-curve equivalent; plotting happens in your tools/Agent from the CSV). duration_ms <= 90000; long background captures (job mode) are a planned follow-up.",
+        "description": "Serial assistant: synchronous window capture - record the RX stream for duration_ms into a timestamped CSV (t_rel_ms, dir, hex, printable) for offline analysis/plotting (real-time-curve equivalent; plotting happens in your tools/Agent from the CSV). Pass power_cycle_off_ms to fire an NdtBox power-cycle inside the window and capture boot-time prints (port is opened first). duration_ms <= 90000; long background captures (job mode) are a planned follow-up.",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -2202,6 +2251,10 @@ TOOLS_REGISTRY = {
                     "description": "Capture window length in ms (1..90000)",
                     "default": 3000,
                 },
+                "power_cycle_off_ms": {
+                    "type": "integer",
+                    "description": "When set, power-cycle the NdtBox target inside the capture window (off for N ms, default 500 behaviour when the value is omitted) so boot-time prints land in the CSV. The COM port is opened first, then the reset fires ~200ms into the window. Requires the NdtBox reset rail (usb2io IO10); no write_allowed needed",
+                },
                 "out": {"type": "string", "description": "CSV output path (defaults to a temp-dir file)"},
                 "lab_config": {"type": "string", "description": "Explicit lab.yaml path override"},
             },
@@ -2254,7 +2307,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.6.2"
+                    "version": "0.7.1"
                 }
             }
         }
@@ -2389,7 +2442,7 @@ def _settle_stashed_entrypoints(stashed) -> None:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.6.2)")
+    print("  FirmwareLoop Auto-Updater (v0.7.1)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -2820,7 +2873,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.6.2)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.7.1)")
     print("============================================================")
     print("")
 
@@ -2945,7 +2998,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init(chip: Optional[str] = None, upgrade: bool = False) -> int:
     """Handle `firmwareloop init [target_chip]` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.6.2)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.7.1)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -2978,7 +3031,7 @@ def handle_cli_init(chip: Optional[str] = None, upgrade: bool = False) -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.6.2)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.7.1)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -3024,7 +3077,7 @@ def main() -> None:
                 sys.exit(2)
             sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.6.2")
+            print("FirmwareLoop v0.7.1")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()