firmwareloop 0.1.1__tar.gz → 0.1.3__tar.gz

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/PKG-INFO

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

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/README.md

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

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/firmwareloop.egg-info/PKG-INFO

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

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/pyproject.toml

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

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/tools/__init__.py

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

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/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.1).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.1.3).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
 Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, Cursor) via the Model Context
@@ -18,6 +18,7 @@ Tools provided:
   - fw_ndtdbg_measure: NdtBox pressure-sensor data stream polling over IIC (ndtdbg_cli.py)
   - fw_ndtdbg_read_reg: NdtBox IIC register read (ndtdbg_cli.py)
   - fw_ndtdbg_write_reg: NdtBox IIC register write, double-gated (ndtdbg_cli.py)
+  - fw_ndtdbg_capture_seq: NdtBox register sequence + concurrent I2C capture for waveform evidence (ndtdbg_cli.py)
   - fw_logic_capture: Logic analyzer protocol capture (logic_capture.ps1)
   - fw_logic_decode: Logic analyzer protocol decoding & assertion (logic_decode.ps1)
   - fw_get_evidence: Read structured audit run evidence (artifacts/runs/)
@@ -305,6 +306,71 @@ def handle_fw_ndtdbg_write_reg(args: Dict[str, Any]) -> Dict[str, Any]:
     return res
 
 
+def handle_fw_ndtdbg_capture_seq(args: Dict[str, Any]) -> Dict[str, Any]:
+    """单次调用内并发: 逻辑分析仪抓取与 NdtBox 寄存器序列同时进行。
+
+    MCP 工具调用不可并行, 串行调用无法让抓取窗口覆盖物理事务; 此工具在
+    handler 内以线程并发二者, 返回 capture 路径供 fw_logic_decode 消费。
+    """
+    import threading
+
+    cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+    cap_script = os.path.join(REPO_ROOT, "tools", "logic_capture.ps1")
+    duration_ms = int(args.get("duration_ms", 8000))
+    writes = args.get("writes", [{"reg": "0xBE", "data": "01"}, {"reg": "0x01", "data": "BE 42"}])
+    poll_reg = args.get("poll_reg", "0x01")
+    poll_attempts = int(args.get("poll_attempts", 5))
+    readback_reg = args.get("readback_reg", "0xBE")
+
+    cap_out: Dict[str, Any] = {}
+
+    def do_capture() -> None:
+        cap_cmd = [PWSH_EXE, "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass",
+                   "-File", cap_script, "-Protocol", "i2c", "-Backend", "sigrok",
+                   "-DurationSec", str(duration_ms / 1000.0), "-Json"]
+        cap_out.update(run_process(cap_cmd, timeout=duration_ms / 1000.0 + 120))
+
+    th = threading.Thread(target=do_capture)
+    th.start()
+
+    seq: Dict[str, Any] = {"writes": []}
+    try:
+        for w in writes:
+            write_cmd = [PYTHON_EXE, cli_script, "write-reg", "--addr", str(w.get("reg")),
+                         "--data", str(w.get("data")), "--confirm"]
+            _ndtdbg_reg_args(args, write_cmd)
+            res = run_process(write_cmd, timeout=60)
+            seq["writes"].append({"reg": w.get("reg"), "data": w.get("data"),
+                                  "ok": bool(res.get("success")), "result": res if not res.get("success") else res.get("data")})
+        if poll_reg:
+            for attempt in range(poll_attempts + 1):
+                read_cmd = [PYTHON_EXE, cli_script, "read-reg", "--addr", str(poll_reg), "--len", "2"]
+                _ndtdbg_reg_args(args, read_cmd)
+                res = run_process(read_cmd, timeout=60)
+                val = (res.get("data") or {}).get("data", {}).get("hex", "")
+                seq["poll"] = {"reg": poll_reg, "attempts": attempt + 1, "hex": val,
+                               "cleared": val == "00 00"}
+                if val == "00 00" or attempt >= poll_attempts:
+                    break
+                import time
+                time.sleep(0.1)
+        if readback_reg:
+            read_cmd = [PYTHON_EXE, cli_script, "read-reg", "--addr", str(readback_reg), "--len", "1"]
+            _ndtdbg_reg_args(args, read_cmd)
+            res = run_process(read_cmd, timeout=60)
+            seq["readback"] = {"reg": readback_reg,
+                               "hex": (res.get("data") or {}).get("data", {}).get("hex", "")}
+    finally:
+        th.join(timeout=duration_ms / 1000.0 + 180)
+
+    cap = cap_out.get("data") or cap_out
+    capture_path = None
+    if cap and isinstance(cap, dict):
+        capture_path = cap.get("capture")
+    return {"ok": bool(capture_path), "action": "capture-seq",
+            "sequence": seq, "capture": cap, "capture_path": capture_path}
+
+
 def handle_fw_logic_capture(args: Dict[str, Any]) -> Dict[str, Any]:
     script = os.path.join(REPO_ROOT, "tools", "logic_capture.ps1")
     cmd = [PWSH_EXE, "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", script, "-Json"]
@@ -1199,6 +1265,37 @@ TOOLS_REGISTRY = {
         },
         "handler": handle_fw_ndtdbg_write_reg,
     },
+    "fw_ndtdbg_capture_seq": {
+        "description": "One-call protocol evidence: concurrently runs a NdtBox register write sequence (default 0xBE=01, 0x01=BE 42, poll 0x01, readback 0xBE) and a 3s Saleae/sigrok I2C capture, returning the capture path for fw_logic_decode.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "duration_ms": {
+                    "type": "integer",
+                    "description": "Logic capture duration in milliseconds",
+                    "default": 3000,
+                },
+                "writes": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "reg": {"type": "string"},
+                            "data": {"type": "string"},
+                        },
+                    },
+                    "description": "Register write sequence (default 0xBE=01, 0x01=BE 42)",
+                },
+                "poll_reg": {"type": "string", "description": "Poll register until 00 00 (default 0x01)"},
+                "poll_attempts": {"type": "integer", "description": "Max poll attempts", "default": 5},
+                "readback_reg": {"type": "string", "description": "Read-back verification register (default 0xBE)"},
+                "dll_dir": {"type": "string", "description": "NdtDebugTool lib directory; default from lab.yaml"},
+                "slave_addr": {"type": "string", "description": "IIC slave address (e.g. 0xA0)"},
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_ndtdbg_capture_seq,
+    },
     "fw_logic_capture": {
         "description": "Capture digital protocol waveforms (I2C, SPI, UART) via Saleae / sigrok or deterministic simulator.",
         "inputSchema": {
@@ -1336,7 +1433,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.1.1"
+                    "version": "0.1.3"
                 }
             }
         }
@@ -1428,7 +1525,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.1)")
+    print("  FirmwareLoop Auto-Updater (v0.1.3)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1526,7 +1623,16 @@ def upsert_qoder_mcp_json(mcp_path: str, servers: Optional[Dict[str, Any]] = Non
     mcp_servers = data.get("mcpServers")
     if not isinstance(mcp_servers, dict):
         mcp_servers = {}
-    mcp_servers.update(payload)
+    # Merge per-entry (not whole-key replace): keep existing per-server extras
+    # like "env" (e.g. FW_LAB_CONFIG) that this payload does not define.
+    for name, entry in payload.items():
+        old = mcp_servers.get(name)
+        if isinstance(old, dict) and isinstance(entry, dict):
+            merged = dict(old)
+            merged.update(entry)
+            mcp_servers[name] = merged
+        else:
+            mcp_servers[name] = entry
     data["mcpServers"] = mcp_servers
     parent = os.path.dirname(mcp_path)
     if parent:
@@ -1571,7 +1677,7 @@ def configure_qoder_user_mcp(user_home: str) -> List[Dict[str, Any]]:
 def handle_cli_setup() -> int:
     """Handle `firmwareloop setup` command: simultaneously configure Antigravity CLI, Claude Code CLI, and Qoder IDE."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.1)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.3)")
     print("============================================================")
     print("")
 
@@ -1676,7 +1782,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.1)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.3)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -1697,7 +1803,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.1)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.3)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -1728,7 +1834,7 @@ def main() -> None:
         elif cmd in ["setup", "register"]:
             sys.exit(handle_cli_setup())
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.1.1")
+            print("FirmwareLoop v0.1.3")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/tools/logic_decode.ps1

@@ -22,6 +22,7 @@ param(
     [string]$CaptureFile,             # direct path to the raw CSV
     [ValidateSet('spi', 'uart', 'i2c')]
     [string]$Protocol,                # override protocol (else read from metadata)
+    [int]$FrequencyHz = 0,            # clock frequency hint (Hz); reserved for future decode validation
     [string]$Expect,                  # expected decoded value (hex string or text)
     [ValidateSet('hex', 'text')]
     [string]$ExpectKind = 'hex',

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/tools/ndtdbg_bridge.ps1

@@ -68,7 +68,7 @@ function Parse-Hex([string]$s) {
         try { $bytes[[int]($i / 2)] = [Convert]::ToByte($clean.Substring($i, 2), 16) }
         catch { Fail "CONFIG_ERROR" "Data 含非法十六进制字符" $clean.Substring($i, 2) }
     }
-    return $bytes
+    return ,$bytes   # PS 函数返回会展开单元素数组, 一元数组符保护类型
 }
 
 function Open-Device([int]$iIndex) {
@@ -103,10 +103,12 @@ function Read-Reg([uint32]$h, [int]$addr, [int]$reg, [int]$len) {
     return $rb
 }
 
-function Write-Reg([uint32]$h, [int]$addr, [int]$reg, [byte[]]$data) {
-    $wb = New-Object byte[] (2 + $data.Length)
+function Write-Reg([uint32]$h, [int]$addr, [int]$reg, $data) {
+    # 无类型约束 + 函数内强转: 兼容标量/单元素数组/byte[] 各种传参形态 (PS5.1 会展开单元素数组)
+    $bytes = [byte[]]@($data)
+    $wb = New-Object byte[] (2 + $bytes.Length)
     for ($i = 0; $i -lt $wb.Length; $i++) {
-        if ($i -eq 0) { $wb[0] = $addr } elseif ($i -eq 1) { $wb[1] = $reg } else { $wb[$i] = $data[$i - 2] }
+        if ($i -eq 0) { $wb[0] = $addr } elseif ($i -eq 1) { $wb[1] = $reg } else { $wb[$i] = $bytes[$i - 2] }
     }
     if (-not (Invoke-WriteRead $h $wb (New-Object byte[] 0))) { Fail "TARGET_MISMATCH" ("IIC 写无应答 addr=0x{0:X2} reg=0x{1:X2}" -f $addr, $reg) ("{0:X2}/{1:X2}" -f $addr, $reg) }
 }

{firmwareloop-0.1.1 → firmwareloop-0.1.3}/tools/setup-agent-mcp.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.1.1).
+    Dual-Tier MCP setup and registration helper (v0.1.3).
     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.1)" -ForegroundColor Green
+    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.1.3)" -ForegroundColor Green
     Write-Host "============================================================" -ForegroundColor Cyan
     Write-Host ""
     Write-Host "[1] Google Antigravity / Gemini CLI:" -ForegroundColor Yellow