firmwareloop 0.1.0__tar.gz → 0.1.2__tar.gz

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.1.0
+Version: 0.1.2
 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.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.2)
 ├── .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.0）
+## 能力验证状态（v0.1.2）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/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.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.2)
 ├── .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.0）
+## 能力验证状态（v0.1.2）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.1.0
+Version: 0.1.2
 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.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.2)
 ├── .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.0）
+## 能力验证状态（v0.1.2）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/pyproject.toml

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

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/tools/__init__.py

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

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/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.0).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.1.2).
 
 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
@@ -16,6 +16,8 @@ Tools provided:
   - fw_measure: Controlled PyVISA/SCPI instrument measurement (instrument_cli.py)
   - fw_ndtdbg_status: NdtBox (USB->IIC) connectivity & firmware version probe (ndtdbg_cli.py)
   - 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_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/)
@@ -272,6 +274,37 @@ def handle_fw_ndtdbg_measure(args: Dict[str, Any]) -> Dict[str, Any]:
     return res
 
 
+def _ndtdbg_reg_args(args: Dict[str, Any], cmd: List[str]) -> None:
+    if args.get("dll_dir"):
+        cmd.extend(["--dll-dir", args["dll_dir"]])
+    if args.get("slave_addr"):
+        cmd.extend(["--slave-addr", str(args["slave_addr"])])
+
+
+def handle_fw_ndtdbg_read_reg(args: Dict[str, Any]) -> Dict[str, Any]:
+    cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+    cmd = [PYTHON_EXE, cli_script, "read-reg", "--addr", str(args.get("reg", "0x10")),
+           "--len", str(args.get("len", 1))]
+    _ndtdbg_reg_args(args, cmd)
+    res = run_process(cmd, timeout=60)
+    if res.get("data"):
+        return res["data"]
+    return res
+
+
+def handle_fw_ndtdbg_write_reg(args: Dict[str, Any]) -> Dict[str, Any]:
+    cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+    cmd = [PYTHON_EXE, cli_script, "write-reg", "--addr", str(args.get("reg")),
+           "--data", str(args.get("data", ""))]
+    if args.get("confirm"):
+        cmd.append("--confirm")
+    _ndtdbg_reg_args(args, cmd)
+    res = run_process(cmd, timeout=60)
+    if res.get("data"):
+        return res["data"]
+    return res
+
+
 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"]
@@ -1106,6 +1139,66 @@ TOOLS_REGISTRY = {
         },
         "handler": handle_fw_ndtdbg_measure,
     },
+    "fw_ndtdbg_read_reg": {
+        "description": "Read IIC register bytes from the NdtBox target chip (ChipSea Fxx). Read-only, hardware-agnostic register access.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "reg": {
+                    "type": "string",
+                    "description": "Register address (0x prefix or decimal), e.g. 0xBE",
+                    "default": "0x10",
+                },
+                "len": {
+                    "type": "integer",
+                    "description": "Bytes to read (1..256)",
+                    "default": 1,
+                },
+                "dll_dir": {
+                    "type": "string",
+                    "description": "NdtDebugTool lib directory; default from lab.yaml ndtdbg.dll_dir",
+                },
+                "slave_addr": {
+                    "type": "string",
+                    "description": "IIC slave address (e.g. 0xA0)",
+                },
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_ndtdbg_read_reg,
+    },
+    "fw_ndtdbg_write_reg": {
+        "description": "Write bytes to an IIC register of the NdtBox target chip (ChipSea Fxx). Defended: requires lab.yaml ndtdbg.write_allowed: true AND the confirm: true argument; otherwise returns PERMISSION_DENIED.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "reg": {
+                    "type": "string",
+                    "description": "Register address (0x prefix or decimal), e.g. 0xBE",
+                },
+                "data": {
+                    "type": "string",
+                    "description": "Hex payload, e.g. 01 or BE 42",
+                },
+                "confirm": {
+                    "type": "boolean",
+                    "description": "Acknowledge the write intent (double-gated with lab.yaml write_allowed)",
+                    "default": False,
+                },
+                "dll_dir": {
+                    "type": "string",
+                    "description": "NdtDebugTool lib directory; default from lab.yaml ndtdbg.dll_dir",
+                },
+                "slave_addr": {
+                    "type": "string",
+                    "description": "IIC slave address (e.g. 0xA0)",
+                },
+            },
+            "required": ["reg", "data"],
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_ndtdbg_write_reg,
+    },
     "fw_logic_capture": {
         "description": "Capture digital protocol waveforms (I2C, SPI, UART) via Saleae / sigrok or deterministic simulator.",
         "inputSchema": {
@@ -1243,7 +1336,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.1.0"
+                    "version": "0.1.2"
                 }
             }
         }
@@ -1335,7 +1428,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.0)")
+    print("  FirmwareLoop Auto-Updater (v0.1.2)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1433,7 +1526,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:
@@ -1478,7 +1580,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.0)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.2)")
     print("============================================================")
     print("")
 
@@ -1583,7 +1685,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.0)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.2)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -1604,7 +1706,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.0)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.2)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -1635,7 +1737,7 @@ def main() -> None:
         elif cmd in ["setup", "register"]:
             sys.exit(handle_cli_setup())
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.1.0")
+            print("FirmwareLoop v0.1.2")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.1.0 → firmwareloop-0.1.2}/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.0 → firmwareloop-0.1.2}/tools/setup-agent-mcp.ps1

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