firmwareloop 0.2.2__tar.gz → 0.4.0__tar.gz

{firmwareloop-0.2.2 → firmwareloop-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.2.2
+Version: 0.4.0
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -381,7 +381,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.2.2)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.4.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +391,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.2.2）
+## 能力验证状态（v0.4.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.2.2 → firmwareloop-0.4.0}/README.md

@@ -353,7 +353,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.2.2)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.4.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -363,7 +363,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.2.2）
+## 能力验证状态（v0.4.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.2.2 → firmwareloop-0.4.0}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.2.2
+Version: 0.4.0
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -381,7 +381,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.2.2)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.4.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +391,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.2.2）
+## 能力验证状态（v0.4.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.2.2 → firmwareloop-0.4.0}/pyproject.toml

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

{firmwareloop-0.2.2 → firmwareloop-0.4.0}/tools/__init__.py

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

{firmwareloop-0.2.2 → firmwareloop-0.4.0}/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.2.2).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.4.0).
 
 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
@@ -360,6 +360,8 @@ def handle_fw_ndtdbg_stream(args: Dict[str, Any]) -> Dict[str, Any]:
         cmd.extend(["--fail-threshold", str(int(args["fail_threshold"]))])
     if args.get("require_target"):
         cmd.append("--require-target")
+    if args.get("pre_write"):
+        cmd.extend(["--pre-write", *[str(p) for p in args["pre_write"]]])
     _ndtdbg_reg_args(args, cmd)
     return _ndtdbg_run(cmd, timeout=int(duration_s) + 120)
 
@@ -1387,7 +1389,7 @@ TOOLS_REGISTRY = {
         "handler": handle_fw_ndtdbg_flash,
     },
     "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. Read-only. Writes CSV with timestamps; returns JSON summary (frames, FF_GAP/IO_FAIL counts, interval stats). For capturing sensor/debug data streams (e.g. PT488 0xEE 4-channel data). Typical combo: write_reg(0xBE=01, confirm) to start debug_mode, then stream(0xEE).",
+        "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. Read-only. Writes CSV with timestamps; returns JSON summary (frames, FF_GAP/IO_FAIL counts, interval stats, io_overhead). Supports two protocol profiles: continuous (pure-read polling) and request-response (pre_write command written before every frame, e.g. PT488 0x10/0x14 channels). Per-frame IO overhead is reported separately in io_overhead_avg_ms.",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -1437,6 +1439,11 @@ TOOLS_REGISTRY = {
                     "description": "Probe reg 0x10 before capture; abort with TARGET_MISMATCH when the chip does not answer.",
                     "default": False,
                 },
+                "pre_write": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Request-response protocol profile: commands 'addr:data' written before EVERY frame (e.g. ['0xEC:10']) so request-response channels refresh each read. Omit for continuous (pure-read) streams. Defaults from lab.yaml ndtdbg.stream.pre_write when omitted.",
+                },
                 "dll_dir": {"type": "string", "description": "NdtDebugTool lib dir; default from lab.yaml ndtdbg.dll_dir"},
                 "slave_addr": {"type": "string", "description": "IIC slave address, e.g. 0xA0; default from lab.yaml"},
             },
@@ -1619,7 +1626,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.2.2"
+                    "version": "0.4.0"
                 }
             }
         }
@@ -1754,7 +1761,7 @@ def _settle_stashed_entrypoints(stashed) -> None:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.2.2)")
+    print("  FirmwareLoop Auto-Updater (v0.4.0)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1823,6 +1830,100 @@ def handle_cli_update() -> int:
             return res.returncode
 
 
+def handle_cli_selftest(target: str = "ndtdbg") -> int:
+    """`fwloop selftest ndtdbg`: 按 BACKLOG 验收标准自动回归 (需硬件在环)。
+
+    流程: status 分层探测 -> stream 冒烟 (100ms x 10s, 帧守恒/性能线/gaps 断言) ->
+    写读回环 (write_allowed 双门内, 未授权 SKIP) -> 结构化汇总。任一 FAIL 则 exit 1。
+    """
+    if target != "ndtdbg":
+        print(f"[-] Unknown selftest target: {target} (supported: ndtdbg)")
+        return 2
+    print("============================================================")
+    print("  FirmwareLoop Self-Test: ndtdbg (BACKLOG 验收标准)")
+    print("============================================================")
+    results: list = []
+
+    def run_cli(*args, timeout=120):
+        cli = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+        try:
+            proc = subprocess.run([sys.executable, cli, *args], capture_output=True,
+                                  text=True, encoding="utf-8", errors="replace", timeout=timeout)
+        except subprocess.TimeoutExpired:
+            return -1, {"ok": False, "error_class": "INSTRUMENT_TIMEOUT",
+                        "error": f"子命令超时 >{timeout}s (疑似 USB 会话被残留进程占用或设备挂死)"}
+        body = None
+        for line in reversed((proc.stdout or "").strip().splitlines()):
+            line = line.strip()
+            if line.startswith("{"):
+                try:
+                    body = json.loads(line)
+                    break
+                except Exception:
+                    continue
+        return proc.returncode, body
+
+    def report(name, status, detail=""):
+        results.append((name, status, detail))
+
+    # 1. status 分层探测
+    print("\n[1/4] status 探测 (Box / IIC bus / target chip) ...")
+    rc, body = run_cli("status", timeout=30)
+    if rc == 0 and body and body.get("ok"):
+        data = body.get("data") or {}
+        report("status", "PASS", data.get("summary", ""))
+    else:
+        report("status", "FAIL", (body or {}).get("error_class", f"exit {rc}"))
+
+    # 2. stream 冒烟 (100ms x 10s)
+    print("[2/4] stream 冒烟 (100ms x 10s, int16 解码) ...")
+    rc, body = run_cli("stream", "--regs", "0xEE:8:ch", "--interval-ms", "100",
+                       "--duration-s", "10", "--decode", "int16le", timeout=60)
+    stream_data = (body or {}).get("data") if isinstance(body, dict) else None
+    if rc == 0 and stream_data:
+        total = stream_data.get("frames_total", 0)
+        conserved = (stream_data.get("frames_ok", 0) + stream_data.get("frames_ff_gap", 0)
+                     + stream_data.get("frames_io_fail", 0)) == total
+        avg = stream_data.get("interval_actual_avg_ms")
+        report("stream.frames_conserved", "PASS" if conserved else "FAIL",
+               f"total={total} (ok={stream_data.get('frames_ok')}, "
+               f"ff_gap={stream_data.get('frames_ff_gap')}, io_fail={stream_data.get('frames_io_fail')})")
+        report("stream.interval_perf", "PASS" if (avg is not None and avg <= 110) else "FAIL",
+               f"avg={avg}ms (target 100ms, 验收线 <=110ms)")
+        report("stream.io_overhead", "PASS" if stream_data.get("io_overhead_avg_ms") is not None else "FAIL",
+               f"io_overhead_avg_ms={stream_data.get('io_overhead_avg_ms')}")
+        report("stream.gaps", "PASS", f"gaps_n={stream_data.get('gaps_n', 0)} (仅 >2x target 计数)")
+    else:
+        report("stream", "FAIL", (body or {}).get("error_class", f"exit {rc}"))
+
+    # 3. 写读回环 (write_allowed 双门内; 未授权 SKIP, 不算 FAIL)
+    print("[3/4] 写读回环 (0xBE debug_mode, 需 lab.yaml write_allowed) ...")
+    rc, body = run_cli("write-reg", "--addr", "0xBE", "--data", "01", "--confirm")
+    if rc == 0 and body and body.get("ok"):
+        report("write.readback", "PASS", "0xBE=01 写入成功 (debug_mode 开启)")
+        run_cli("write-reg", "--addr", "0xBE", "--data", "00", "--confirm")
+        report("write.restore", "PASS", "0xBE=00 已恢复")
+    else:
+        err_class = (body or {}).get("error_class", f"exit {rc}")
+        if err_class == "PERMISSION_DENIED":
+            report("write.readback", "SKIP", "write_allowed 未开启 (双门保护), 跳过写回环")
+        else:
+            report("write.readback", "FAIL", err_class)
+
+    # 4. 汇总
+    print("\n============================================================")
+    for name, status, detail in results:
+        print(f"  [{status}] {name}" + (f" — {detail}" if detail else ""))
+    failed = [r for r in results if r[1] == "FAIL"]
+    skipped = [r for r in results if r[1] == "SKIP"]
+    overall = "FAIL" if failed else "PASS"
+    print("============================================================")
+    print(f"  Self-Test Result: {overall}  "
+          f"({len(results) - len(failed) - len(skipped)} pass, {len(failed)} fail, {len(skipped)} skip)")
+    print("============================================================")
+    return 1 if failed else 0
+
+
 def handle_cli_doctor() -> int:
     """Handle `firmwareloop doctor` command."""
     print("[*] Running FirmwareLoop environment diagnostics...")
@@ -2029,7 +2130,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.2.2)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.4.0)")
     print("============================================================")
     print("")
 
@@ -2154,7 +2255,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.2.2)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.4.0)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -2175,7 +2276,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.2.2)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.4.0)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -2184,6 +2285,7 @@ Commands:
   init              Initialize multi-agent rules (AGENTS.md, CLAUDE.md, GEMINI.md) & lab.yaml in current project
   update            Check and update FirmwareLoop to the latest version
   doctor            Run environment & toolchain diagnostics
+  selftest [target] Hardware self-test regression (default: ndtdbg; BACKLOG acceptance)
   setup             Register AI Agent MCP globally & generate machine-level config (%APPDATA%\\FirmwareLoop\\lab.yaml)
   ndtdebugtool DIR  Configure NdtBox: point to the NdtDebugTool folder root (auto-resolves its lib/)
   dlldir DIR        Alias of ndtdebugtool (legacy name, pass the lib/ directory directly)
@@ -2205,6 +2307,8 @@ def main() -> None:
             sys.exit(handle_cli_update())
         elif cmd in ["doctor", "check"]:
             sys.exit(handle_cli_doctor())
+        elif cmd == "selftest":
+            sys.exit(handle_cli_selftest(args[1] if len(args) > 1 else "ndtdbg"))
         elif cmd in ["setup", "register"]:
             sys.exit(handle_cli_setup())
         elif cmd in ["ndtdebugtool", "dlldir"]:
@@ -2215,7 +2319,7 @@ def main() -> None:
                 sys.exit(2)
             sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.2.2")
+            print("FirmwareLoop v0.4.0")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()