firmwareloop 0.1.4__tar.gz → 0.1.5__tar.gz

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.1.4
+Version: 0.1.5
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -119,6 +119,27 @@ uv tool install agentic-hil
 
 ---
 
+### 可选：接入 NdtBox 调试盒（公司内部 USB→IIC 调试工具）
+
+如需用 Agent 直接操作 NdtBox（固件寄存器读写 / 数据采集 / 逻辑分析仪协议验证），安装后执行一次：
+
+```bash
+# 1) 全局注册各 AI Agent（Antigravity / Claude Code / Qoder），并生成机器级配置模板
+fwloop setup
+
+# 2) 指向你的 NdtDebugTool 分发包【根目录】——命令自动定位其 lib/（含 USBIOX.DLL）并写入配置
+fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
+```
+
+> 完成以上两步后，Agent 侧即可直接调用 NdtBox 相关工具：
+> `fw_ndtdbg_status`（版本/连通性/模组通断）、`fw_ndtdbg_measure`（数据轮询采集）、
+> `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg`（任意寄存器读写，写需 `write_allowed` + `confirm` 双门控）、
+> `fw_ndtdbg_capture_seq`（寄存器序列 + Saleae 波形同窗口取证）。
+> 前置硬件要求：NdtBox 已装 CH341 驱动；如需 Saleae 波形证据，另装 sigrok-cli 并配置
+> `libusb-win32` 驱动（详见 `docs/` 交付说明）。测试时请退出 STDataCollection.exe 上位机（USB 独占）。
+
+---
+
 ### 第二步：全局注册到各大 AI Agent
 
 按你日常使用的 Agent 执行对应的注册命令（全电脑仅需配置一次）：
@@ -338,7 +359,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.4)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.5)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -348,7 +369,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.1.4）
+## 能力验证状态（v0.1.5）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/README.md

@@ -91,6 +91,27 @@ uv tool install agentic-hil
 
 ---
 
+### 可选：接入 NdtBox 调试盒（公司内部 USB→IIC 调试工具）
+
+如需用 Agent 直接操作 NdtBox（固件寄存器读写 / 数据采集 / 逻辑分析仪协议验证），安装后执行一次：
+
+```bash
+# 1) 全局注册各 AI Agent（Antigravity / Claude Code / Qoder），并生成机器级配置模板
+fwloop setup
+
+# 2) 指向你的 NdtDebugTool 分发包【根目录】——命令自动定位其 lib/（含 USBIOX.DLL）并写入配置
+fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
+```
+
+> 完成以上两步后，Agent 侧即可直接调用 NdtBox 相关工具：
+> `fw_ndtdbg_status`（版本/连通性/模组通断）、`fw_ndtdbg_measure`（数据轮询采集）、
+> `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg`（任意寄存器读写，写需 `write_allowed` + `confirm` 双门控）、
+> `fw_ndtdbg_capture_seq`（寄存器序列 + Saleae 波形同窗口取证）。
+> 前置硬件要求：NdtBox 已装 CH341 驱动；如需 Saleae 波形证据，另装 sigrok-cli 并配置
+> `libusb-win32` 驱动（详见 `docs/` 交付说明）。测试时请退出 STDataCollection.exe 上位机（USB 独占）。
+
+---
+
 ### 第二步：全局注册到各大 AI Agent
 
 按你日常使用的 Agent 执行对应的注册命令（全电脑仅需配置一次）：
@@ -310,7 +331,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.4)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.5)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -320,7 +341,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.1.4）
+## 能力验证状态（v0.1.5）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.1.4
+Version: 0.1.5
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -119,6 +119,27 @@ uv tool install agentic-hil
 
 ---
 
+### 可选：接入 NdtBox 调试盒（公司内部 USB→IIC 调试工具）
+
+如需用 Agent 直接操作 NdtBox（固件寄存器读写 / 数据采集 / 逻辑分析仪协议验证），安装后执行一次：
+
+```bash
+# 1) 全局注册各 AI Agent（Antigravity / Claude Code / Qoder），并生成机器级配置模板
+fwloop setup
+
+# 2) 指向你的 NdtDebugTool 分发包【根目录】——命令自动定位其 lib/（含 USBIOX.DLL）并写入配置
+fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
+```
+
+> 完成以上两步后，Agent 侧即可直接调用 NdtBox 相关工具：
+> `fw_ndtdbg_status`（版本/连通性/模组通断）、`fw_ndtdbg_measure`（数据轮询采集）、
+> `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg`（任意寄存器读写，写需 `write_allowed` + `confirm` 双门控）、
+> `fw_ndtdbg_capture_seq`（寄存器序列 + Saleae 波形同窗口取证）。
+> 前置硬件要求：NdtBox 已装 CH341 驱动；如需 Saleae 波形证据，另装 sigrok-cli 并配置
+> `libusb-win32` 驱动（详见 `docs/` 交付说明）。测试时请退出 STDataCollection.exe 上位机（USB 独占）。
+
+---
+
 ### 第二步：全局注册到各大 AI Agent
 
 按你日常使用的 Agent 执行对应的注册命令（全电脑仅需配置一次）：
@@ -338,7 +359,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.4)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.5)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -348,7 +369,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.1.4）
+## 能力验证状态（v0.1.5）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/pyproject.toml

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

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/tools/__init__.py

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

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/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.4).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.1.5).
 
 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
@@ -1433,7 +1433,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.1.4"
+                    "version": "0.1.5"
                 }
             }
         }
@@ -1525,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.4)")
+    print("  FirmwareLoop Auto-Updater (v0.1.5)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1674,10 +1674,95 @@ def configure_qoder_user_mcp(user_home: str) -> List[Dict[str, Any]]:
     return results
 
 
+def resolve_ndtdebugtool_lib(tool_root: str) -> str:
+    """Resolve the NdtDebugTool lib directory (must contain USBIOX.DLL)."""
+    if not tool_root or not os.path.isdir(tool_root):
+        raise ValueError(f"NdtDebugTool 根目录不存在: {tool_root}")
+    lib_cand = os.path.join(tool_root, "lib")
+    if not os.path.isdir(lib_cand):
+        raise ValueError(f"NdtDebugTool 目录缺少 lib 子目录: {tool_root}")
+    dll_file = os.path.join(lib_cand, "USBIOX.DLL")
+    if not os.path.isfile(dll_file):
+        raise ValueError(f"lib 目录不含 USBIOX.DLL: {lib_cand}")
+    return lib_cand
+
+
+def handle_cli_ndtdebugtool(tool_root: str) -> int:
+    """Handle `firmwareloop ndtdebugtool <NdtDebugTool 根目录>`: resolve its lib/ and
+    write ndtdbg.dll_dir into the global %APPDATA%\\FirmwareLoop\\lab.yaml."""
+    try:
+        lib_dir = resolve_ndtdebugtool_lib(tool_root)
+    except ValueError as exc:
+        print(f"  {exc}")
+        return 1
+    path = set_ndtdbg_dlldir(lib_dir)
+    print(f"  NdtBox dtbg 目录  : {tool_root}")
+    print(f"  ndtdbg.dll_dir -> {lib_dir}")
+    print(f"  已写入: {path}")
+    print("  全局安装的 fwloop 工具将自动读取此配置; 无需再配 FW_LAB_CONFIG")
+    return 0
+
+
+def global_lab_path() -> str:
+    appdata = os.environ.get("APPDATA", "")
+    return os.path.join(appdata, "FirmwareLoop", "lab.yaml") if appdata else ""
+
+
+GLOBAL_LAB_TEMPLATE = """# FirmwareLoop 机器级全局配置 (由 fwloop setup 生成, %APPDATA%\\FirmwareLoop\\lab.yaml)
+# 供全局安装的 fwloop 工具读取; 与工程目录 lab/lab.yaml 相互独立。
+# 修改后重启 Qoder/Agent 内 MCP 服务生效。
+
+ndtdbg:
+  # NdtDebugTool 分发包的 lib 目录 (含 USBIOX.DLL); 可用: fwloop dlldir "C:/path/to/NdtDebugTool/lib"
+  dll_dir: ""
+  chip_type: 0            # 0=芯海Fxx 1=ST 2=Maxim 3=AW 4=芯海M68 (本期仅 0)
+  slave_addr: "0xA0"
+  iic_speed: 1            # 0=20kHz 1=100kHz
+  timeout_ms: 60000
+  write_allowed: false    # write-reg 需 CLI --confirm 双确认; 保持 false 即永不写
+"""
+
+
+def ensure_global_lab_yaml() -> str:
+    """Create the machine-level lab.yaml on first `fwloop setup`; idempotent (never overwrite)."""
+    path = global_lab_path()
+    if path and not os.path.exists(path):
+        os.makedirs(os.path.dirname(path), exist_ok=True)
+        with open(path, "w", encoding="utf-8") as f:
+            f.write(GLOBAL_LAB_TEMPLATE)
+    return path
+
+
+def set_ndtdbg_dlldir(dll_path: str) -> str:
+    """Merge ndtdbg.dll_dir into the global lab.yaml (create template if missing)."""
+    path = ensure_global_lab_yaml()
+    data: Dict[str, Any] = {}
+    try:
+        if os.path.exists(path):
+            with open(path, "r", encoding="utf-8-sig") as f:
+                loaded = yaml.safe_load(f) if yaml is not None else json.load(f)
+            if isinstance(loaded, dict):
+                data = loaded
+    except Exception:
+        data = {}
+    ndtdbg = data.get("ndtdbg")
+    if not isinstance(ndtdbg, dict):
+        ndtdbg = {}
+    ndtdbg["dll_dir"] = dll_path
+    data["ndtdbg"] = ndtdbg
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    with open(path, "w", encoding="utf-8") as f:
+        if yaml is not None:
+            f.write(yaml.safe_dump(data, allow_unicode=True, sort_keys=False))
+        else:
+            f.write(json.dumps(data, ensure_ascii=False, indent=2) + "\n")
+    return path
+
+
 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.4)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.5)")
     print("============================================================")
     print("")
 
@@ -1773,6 +1858,14 @@ def handle_cli_setup() -> int:
     print(f"\n[4] Global Skills:")
     print(f"    - Synchronized: [OK] {skills_synced} skills (firmwareloop, fwloop-adapter) to Antigravity & Claude Code")
 
+    # 5. Machine-level global lab.yaml (ndtdbg config for the globally installed tool)
+    global_cfg = ensure_global_lab_yaml()
+    if global_cfg:
+        exists = "  [已存在, 未覆盖]" if os.path.isfile(global_cfg) else "  [已创建]"
+        print("\n[5] NdtBox 全局配置:")
+        print(f"    - {global_cfg}{exists}")
+        print("    - 若未配置, 请运行: fwloop ndtdebugtool \"<NdtDebugTool 根目录>\"")
+
     print("\n============================================================")
     print(f"[+] All AI Coding Agents ({', '.join(configured_agents)}) are globally configured and ready!")
     print("============================================================")
@@ -1782,7 +1875,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.4)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.5)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -1803,7 +1896,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.4)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.5)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -1833,8 +1926,15 @@ def main() -> None:
             sys.exit(handle_cli_doctor())
         elif cmd in ["setup", "register"]:
             sys.exit(handle_cli_setup())
+        elif cmd in ["ndtdebugtool", "dlldir"]:
+            if len(args) < 2:
+                print("usage: fwloop ndtdebugtool <NdtDebugTool 根目录>")
+                print("example: fwloop ndtdebugtool \"C:/Users/you/NdtDebugTool-v1.0.19\"")
+                print("(自动定位其 lib/ 并写入全局配置; 兼容旧名 fwloop dlldir <lib 目录>)")
+                sys.exit(2)
+            sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.1.4")
+            print("FirmwareLoop v0.1.5")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/tools/ndtdbg_cli.py

@@ -46,7 +46,13 @@ def ok(action: str, data: dict, log: str = None) -> None:
 # --------------------------------------------------------------------------- config
 
 def load_config(explicit: str | None) -> dict:
-    for cand in (explicit, os.environ.get("FW_LAB_CONFIG"), DEFAULT_CONFIG, FALLBACK_CONFIG):
+    cands = [explicit, os.environ.get("FW_LAB_CONFIG")]
+    # 机器级全局配置 (fwloop setup 生成, fwloop dlldir 写值)
+    appdata = os.environ.get("APPDATA")
+    if appdata:
+        cands.append(os.path.join(appdata, "FirmwareLoop", "lab.yaml"))
+    cands += [DEFAULT_CONFIG, FALLBACK_CONFIG]
+    for cand in cands:
         if cand and os.path.isfile(cand):
             try:
                 with open(cand, encoding="utf-8") as fh:

{firmwareloop-0.1.4 → firmwareloop-0.1.5}/tools/setup-agent-mcp.ps1

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