firmwareloop 0.0.13__tar.gz → 0.1.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.0.13
+Version: 0.1.0
 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.0.13)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.0)
 ├── .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.0.13）
+## 能力验证状态（v0.1.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -368,6 +368,7 @@ claude mcp remove --scope user agentic-hil
 | VISA 仪器（simulator） | Simulator Validated -> Real Hardware Validated 待仪器 |
 | 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 |
 
 ---
 

{firmwareloop-0.0.13 → firmwareloop-0.1.0}/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.0.13)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.0)
 ├── .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.0.13）
+## 能力验证状态（v0.1.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -340,6 +340,7 @@ claude mcp remove --scope user agentic-hil
 | VISA 仪器（simulator） | Simulator Validated -> Real Hardware Validated 待仪器 |
 | 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 |
 
 ---
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.0.13
+Version: 0.1.0
 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.0.13)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.1.0)
 ├── .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.0.13）
+## 能力验证状态（v0.1.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -368,6 +368,7 @@ claude mcp remove --scope user agentic-hil
 | VISA 仪器（simulator） | Simulator Validated -> Real Hardware Validated 待仪器 |
 | 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 |
 
 ---
 

{firmwareloop-0.0.13 → firmwareloop-0.1.0}/firmwareloop.egg-info/SOURCES.txt

@@ -18,12 +18,16 @@ tools/fw_mcp_server.py
 tools/instrument_cli.py
 tools/logic_capture.ps1
 tools/logic_decode.ps1
+tools/ndtdbg_bridge.ps1
+tools/ndtdbg_cli.py
 tools/reset.ps1
 tools/setup-agent-mcp.ps1
+tools/sigrok_csv_to_fwloop.py
 tools/test-backends.ps1
 tools/test.ps1
 tools/common/build-backends.psm1
 tools/common/fw.psm1
 tools/common/uart_probe.py
 tools/lib/__init__.py
-tools/lib/instruments.py
+tools/lib/instruments.py
+tools/lib/ndtdbg.py

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

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

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

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

{firmwareloop-0.0.13 → firmwareloop-0.1.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.0.13).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.1.0).
 
 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
@@ -14,6 +14,8 @@ Tools provided:
   - fw_run_hil_test: Hardware-in-the-loop pytest suite (test.ps1)
   - fw_acceptance_scenario: End-to-end acceptance scenario (acceptance-scenario.ps1)
   - 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_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/)
@@ -240,6 +242,36 @@ def handle_fw_measure(args: Dict[str, Any]) -> Dict[str, Any]:
     return res
 
 
+def handle_fw_ndtdbg_status(args: Dict[str, Any]) -> Dict[str, Any]:
+    cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+    cmd = [PYTHON_EXE, cli_script, "status"]
+    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"])])
+    res = run_process(cmd, timeout=60)
+    if res.get("data"):
+        return res["data"]
+    return res
+
+
+def handle_fw_ndtdbg_measure(args: Dict[str, Any]) -> Dict[str, Any]:
+    cli_script = os.path.join(REPO_ROOT, "tools", "ndtdbg_cli.py")
+    duration = int(args.get("duration_seconds", 2))
+    cmd = [PYTHON_EXE, cli_script, "poll", "--duration-ms", str(duration * 1000),
+           "--interval-ms", str(args.get("interval_ms", 10))]
+    if args.get("full_output"):
+        cmd.append("--full")
+    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"])])
+    res = run_process(cmd, timeout=60 + duration)
+    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"]
@@ -253,11 +285,11 @@ def handle_fw_logic_capture(args: Dict[str, Any]) -> Dict[str, Any]:
 
     duration_ms = args.get("duration_ms")
     if duration_ms:
-        cmd.extend(["-DurationMs", str(duration_ms)])
+        cmd.extend(["-DurationSec", str(float(duration_ms) / 1000.0)])
 
     output_file = args.get("output_file")
     if output_file:
-        cmd.extend(["-OutputFile", output_file])
+        cmd.extend(["-OutDir", output_file])
 
     res = run_process(cmd, timeout=30)
     if res.get("data"):
@@ -1023,6 +1055,57 @@ TOOLS_REGISTRY = {
         },
         "handler": handle_fw_measure,
     },
+    "fw_ndtdbg_status": {
+        "description": "Probe NdtBox (USB->IIC debug box, ChipSea Fxx) status: device open, firmware version, module connectivity. Fail-closed (PROBE_NOT_FOUND / TARGET_MISMATCH) when hardware absent or no IIC response.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "dll_dir": {
+                    "type": "string",
+                    "description": "NdtDebugTool lib directory containing USBIOX.DLL; default from lab.yaml ndtdbg.dll_dir",
+                },
+                "slave_addr": {
+                    "type": "string",
+                    "description": "IIC slave address (e.g. 0xA0); default from lab.yaml ndtdbg.slave_addr",
+                },
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_ndtdbg_status,
+    },
+    "fw_ndtdbg_measure": {
+        "description": "Poll NdtBox IIC debug data stream (ChipSea Fxx) for N seconds: frame count, checksum errors, channel samples. Read-only; firmware upgrade is a separate future capability.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "duration_seconds": {
+                    "type": "integer",
+                    "description": "Poll duration in seconds",
+                    "default": 2,
+                },
+                "interval_ms": {
+                    "type": "integer",
+                    "description": "Sampling interval in milliseconds",
+                    "default": 10,
+                },
+                "full_output": {
+                    "type": "boolean",
+                    "description": "Return every frame (may be large); default keeps a frame sample plus totals",
+                    "default": False,
+                },
+                "dll_dir": {
+                    "type": "string",
+                    "description": "NdtDebugTool lib directory containing USBIOX.DLL; default from lab.yaml ndtdbg.dll_dir",
+                },
+                "slave_addr": {
+                    "type": "string",
+                    "description": "IIC slave address (e.g. 0xA0); default from lab.yaml ndtdbg.slave_addr",
+                },
+            },
+            "additionalProperties": False,
+        },
+        "handler": handle_fw_ndtdbg_measure,
+    },
     "fw_logic_capture": {
         "description": "Capture digital protocol waveforms (I2C, SPI, UART) via Saleae / sigrok or deterministic simulator.",
         "inputSchema": {
@@ -1160,7 +1243,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.0.13"
+                    "version": "0.1.0"
                 }
             }
         }
@@ -1252,7 +1335,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.0.13)")
+    print("  FirmwareLoop Auto-Updater (v0.1.0)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1395,7 +1478,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.0.13)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.1.0)")
     print("============================================================")
     print("")
 
@@ -1500,7 +1583,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.0.13)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.1.0)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -1521,7 +1604,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.0.13)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.1.0)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -1552,7 +1635,7 @@ def main() -> None:
         elif cmd in ["setup", "register"]:
             sys.exit(handle_cli_setup())
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.0.13")
+            print("FirmwareLoop v0.1.0")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

firmwareloop-0.1.0/tools/lib/ndtdbg.py

@@ -0,0 +1,222 @@
+"""NdtBox (USB->IIC) 协议层: 芯海 Fxx 芯片的 IIC 寄存器帧与校验。
+
+底层 IO 通过 32 位 PowerShell 桥 (tools/ndtdbg_bridge.ps1) 完成——USBIOX.DLL 为 x86-32,
+项目 venv 为 64 位 Python, 无法 ctypes 直调; 桥由 SysWOW64 powershell.exe (32 位) 执行,
+故本模块只做纯协议逻辑与桥返回解析, 全部平台无关、可单测。
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import sys
+
+# 32 位 Windows PowerShell 5.1 (x86), 与 x86 DLL 位宽匹配
+PS32 = r"C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe"
+
+_REWRITE_TIMES = 3  # 对齐 ChipSea.cs REWRITE_TIMES
+
+
+class NdtBoxError(Exception):
+    """携带项目错误类别白名单之一的异常 (Fail-Closed, 不伪造成功)。"""
+
+    def __init__(self, error_class: str, message: str, detail: str | None = None):
+        super().__init__(message)
+        self.error_class = error_class
+        self.message = message
+        self.detail = detail
+
+    def to_dict(self) -> dict:
+        d = {"ok": False, "error_class": self.error_class, "error": self.message}
+        if self.detail:
+            d["detail"] = self.detail
+        return d
+
+
+# ---------------------------------------------------------------------------
+# 纯函数 (协议帧与校验, 平台无关, 直接对应反编译源码)
+# ---------------------------------------------------------------------------
+
+def checksum_two_bytes(buf: bytes) -> int:
+    """CheckSumTwoBytes: 前 length/2 个 LE int16 之和取负 (无符号 16 位)。"""
+    total = 0
+    for i in range(0, len(buf) - (len(buf) % 2), 2):
+        total += int.from_bytes(buf[i:i + 2], "little")
+    return (-total) & 0xFFFF
+
+
+def build_frame(slave_addr: int, payload: bytes) -> bytes:
+    """IIC 事务帧: [slave_addr] + payload (对应 ChipSea.cs WriteReg/ReadReg 的 array[0]=addr)。"""
+    return bytes([slave_addr & 0xFF]) + payload
+
+
+def parse_getdata(data: bytes) -> list[int] | None:
+    """解析 0xEE 数据帧: 末 2 字节负和校验, 返回 LE int16 通道数组 (C# (short) 有符号); 校验失败返回 None。"""
+    if len(data) < 4 or len(data) % 2 != 0:
+        return None
+    expected = int.from_bytes(data[-2:], "little")
+    if expected != checksum_two_bytes(data[:-2]):
+        return None
+    channels = []
+    for i in range(len(data[:-2]) // 2):
+        raw = int.from_bytes(data[i * 2:i * 2 + 2], "little")
+        channels.append(raw - 0x10000 if raw >= 0x8000 else raw)
+    return channels
+
+
+def parse_version(data: bytes) -> str:
+    """0x10 固件版本: 4 字节 -> v%d.%d.%d.%d (ChipSea.cs ReadFwVersion)。"""
+    if len(data) < 4:
+        raise NdtBoxError("TARGET_MISMATCH", "固件版本响应不足 4 字节", f"len={len(data)}")
+    return "v{}.{}.{}.{}".format(*data[:4])
+
+
+def parse_module_connect(data: bytes) -> int:
+    """0x29 模组通断: 低 16 位 LE (ChipSea.cs ReadModuleConnect)。"""
+    if len(data) < 2:
+        raise NdtBoxError("TARGET_MISMATCH", "模组通断响应不足 2 字节", f"len={len(data)}")
+    return int.from_bytes(data[:2], "little")
+
+
+def strip_nfw(file_bytes: bytes, header_len: int = 256) -> bytes:
+    """.nfw 固件: 去 256 字节文件头 (ChipSea.cs LoadFile)。"""
+    if len(file_bytes) <= header_len:
+        raise NdtBoxError("CONFIG_ERROR", ".nfw 文件不足去头长度", f"len={len(file_bytes)}")
+    return file_bytes[header_len:]
+
+
+def pad_bin_128(file_bytes: bytes) -> bytes:
+    """.bin 固件: 128 字节对齐, 尾部 0xFF 填充 (ChipSea.cs LoadFile)。"""
+    pad = (128 - len(file_bytes) % 128) % 128
+    return file_bytes + b"\xFF" * pad
+
+
+# ---------------------------------------------------------------------------
+# 桥调用层
+# ---------------------------------------------------------------------------
+
+class NdtBoxIo:
+    """通过 32 位 PowerShell 桥访问 NdtBox 的 IIC 通道 (芯片无关原语)。"""
+
+    def __init__(self, dll_dir: str, slave_addr: int = 0xA0, speed: int = 1,
+                 bridge_ps1: str | None = None, timeout_ms: int = 60000):
+        self.dll_dir = dll_dir
+        self.slave_addr = slave_addr & 0xFF
+        self.speed = speed
+        self.timeout_ms = timeout_ms
+        if bridge_ps1 is None:
+            bridge_ps1 = os.path.join(os.path.dirname(__file__), "..", "ndtdbg_bridge.ps1")
+        self.bridge_ps1 = os.path.abspath(bridge_ps1)
+
+    def _bridge(self, action: str, **params) -> dict:
+        if not os.path.exists(PS32):
+            raise NdtBoxError("CONFIG_ERROR", f"32 位 PowerShell 不存在: {PS32}")
+        if not os.path.exists(self.bridge_ps1):
+            raise NdtBoxError("CONFIG_ERROR", f"桥脚本不存在: {self.bridge_ps1}")
+        args = [PS32, "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass",
+                "-File", self.bridge_ps1, "-Action", action,
+                "-DllDir", self.dll_dir, "-SlaveAddr", str(self.slave_addr),
+                "-Speed", str(self.speed)]
+        for k, v in params.items():
+            args.append(f"-{k}")
+            args.append(str(v))
+        try:
+            proc = subprocess.run(args, capture_output=True, timeout=self.timeout_ms / 1000.0,
+                                  check=False)
+        except subprocess.TimeoutExpired:
+            raise NdtBoxError("INSTRUMENT_TIMEOUT", f"桥调用超时 >{self.timeout_ms}ms", action)
+        out = (proc.stdout or b"").decode("utf-8", errors="replace").strip()
+        if not out:
+            tail = (proc.stderr or b"").decode("utf-8", errors="replace").strip()[-400:]
+            raise NdtBoxError("UNKNOWN_ERROR", f"桥无输出 (exit={proc.returncode})", tail or None)
+        try:
+            payload = json.loads(out.splitlines()[-1])
+        except json.JSONDecodeError as exc:
+            raise NdtBoxError("UNKNOWN_ERROR", "桥输出非 JSON", out[-400:]) from exc
+        if not payload.get("ok"):
+            raise NdtBoxError(payload.get("error_class", "UNKNOWN_ERROR"),
+                              payload.get("error", "桥返回失败"),
+                              payload.get("detail"))
+        return payload.get("data", {})
+
+    # -- 芯片无关原语 (对齐 IIC.cs / I2CProxy.cs) --
+
+    def ping(self) -> dict:
+        return self._bridge("open")
+
+    def read_reg(self, reg: int, length: int) -> bytes:
+        if length < 1 or length > 256:
+            raise NdtBoxError("CONFIG_ERROR", "读取长度越界 (1..256)", str(length))
+        data = self._bridge("read", RegAddr=reg, Len=length)
+        return bytes.fromhex(data["hex"].replace(" ", ""))
+
+    def write_reg(self, reg: int, data: bytes) -> None:
+        if len(data) > 128:
+            raise NdtBoxError("CONFIG_ERROR", "写入数据过长 (<=128)", str(len(data)))
+        self._bridge("write", RegAddr=reg, Data=data.hex())
+
+    def close(self) -> dict:
+        return self._bridge("close")
+
+
+class ChipSeaFxx:
+    """芯海 Fxx (0xA0) 协议: 对齐 STDataCollection.IICModule/ChipSea.cs。"""
+
+    def __init__(self, io: NdtBoxIo, listener_log=None):
+        self._io = io
+        self._log = listener_log
+
+    def _logline(self, msg: str) -> None:
+        if self._log:
+            self._log.append(msg)
+
+    def _read_reg_retry(self, reg: int, length: int, min_ms_retry: int = 100) -> bytes:
+        last = None
+        for attempt in range(_REWRITE_TIMES + 1):
+            try:
+                last = self._io.read_reg(reg, length)
+                if any(b != 0 for b in last):
+                    return last
+            except NdtBoxError:
+                raise
+            import time
+            time.sleep(min_ms_retry / 1000.0)
+        raise NdtBoxError("TARGET_MISMATCH",
+                          f"读寄存器 0x{reg:02X} 超时/全 0 (重试{_REWRITE_TIMES}次)", None)
+
+    def read_fw_version(self) -> str:
+        data = self._read_reg_retry(0x10, 4)
+        return parse_version(data)
+
+    def read_module_connect(self) -> int:
+        data = self._io.read_reg(0x29, 4)
+        return parse_module_connect(data)
+
+    def read_afe_gain(self) -> bytes:
+        return self._io.read_reg(0x16, 2)
+
+    def read_adc_uv_coef(self) -> int:
+        data = self._io.read_reg(0x1B, 3)
+        return int.from_bytes(data, "little")
+
+    def read_dac_mv_coef(self) -> int:
+        data = self._io.read_reg(0x1C, 2)
+        return int.from_bytes(data, "little")
+
+    def read_offset(self, ch_num: int) -> list[int]:
+        data = self._io.read_reg(0x17, ch_num * 2)
+        return [int.from_bytes(data[i * 2:i * 2 + 2], "little") for i in range(ch_num)]
+
+    # -- 调试数据流 (对齐 ReadModuleConnectDynamic + GetData) --
+
+    def poll(self, duration_ms: int, interval_ms: int = 10, ready_timeout_ms: int = 2000) -> dict:
+        """连续轮询一帧或多帧, 返回 {frame_count, checksum_errors, ready_timeouts, frames}。
+
+        frames: [{"t": epoch_ms, "ch": [int16...]}, ...]——由桥在单个 32 位进程内完成循环,
+        避免每帧一次进程开销 (GUI 原 100Hz 采样)。
+        """
+        if duration_ms <= 0:
+            raise NdtBoxError("CONFIG_ERROR", "poll 时长必须 > 0", str(duration_ms))
+        return self._io._bridge("poll", DurationMs=int(duration_ms), IntervalMs=int(interval_ms),
+                                ReadyTimeoutMs=int(ready_timeout_ms))

{firmwareloop-0.0.13 → firmwareloop-0.1.0}/tools/logic_capture.ps1

@@ -221,24 +221,33 @@ if ($Backend -eq 'simulator') {
 
 # ---- sigrok backend ------------------------------------------------------------
 else {
-    $rawFile = Join-Path $OutDir 'capture.sr'
+    # sigrok CSV 无时间列且表头为通道名 -> 经 sigrok_csv_to_fwloop.py 转成
+    # fwloop 解码器格式 (time_s,D0..D7), 使 capture->decode 全链闭关
+    $rawFile = Join-Path $OutDir 'capture.csv'
+    $rawSigrok = Join-Path $OutDir 'sigrok-raw.csv'
     $probeArgs = @(
-        "--driver=auto",
         "--config", "samplerate=$SampleRateHz",
         "--channels", "0-7",
-        "--output-format", "binary",
-        "--output-file", $rawFile,
-        "--time", "$([int]([math]::Ceiling($DurationSec * 1000)))ms",
-        "$Protocol"
+        "--output-format", "csv",
+        "--output-file", $rawSigrok,
+        "--time", "$([int]([math]::Ceiling($DurationSec * 1000)))ms"
     )
     $res = Invoke-FwProcess -FilePath $sigrok -Arguments $probeArgs -WorkingDirectory $repoRoot -TimeoutMs 120000
     if ($res.timed_out) {
-        Exit-WithError -Class 'LOGIC_CAPTURE_ERROR' -Message 'sigrok-cli capture timed out.' -Detail $rawFile
+        Exit-WithError -Class 'LOGIC_CAPTURE_ERROR' -Message 'sigrok-cli capture timed out.' -Detail $rawSigrok
     }
-    if ($res.exit_code -ne 0 -or -not (Test-Path -LiteralPath $rawFile)) {
+    if ($res.exit_code -ne 0 -or -not (Test-Path -LiteralPath $rawSigrok)) {
         Exit-WithError -Class 'LOGIC_CAPTURE_ERROR' -Message 'sigrok-cli capture failed.' -Detail ($res.stdout + $res.stderr)
     }
+    $convScript = Join-Path $repoRoot 'tools\sigrok_csv_to_fwloop.py'
+    $py = Resolve-FwPython
+    $convRes = Invoke-FwProcess -FilePath $py -Arguments @($convScript, $rawSigrok, $rawFile, $SampleRateHz) `
+        -WorkingDirectory $repoRoot -TimeoutMs 120000
+    if ($convRes.exit_code -ne 0 -or -not (Test-Path -LiteralPath $rawFile)) {
+        Exit-WithError -Class 'LOGIC_CAPTURE_ERROR' -Message 'sigrok CSV conversion failed.' -Detail ($convRes.stdout + $convRes.stderr)
+    }
     $meta.files += (Resolve-Path -LiteralPath $rawFile).Path
+    $meta.files += (Resolve-Path -LiteralPath $rawSigrok).Path
 }
 
 $metaFile = Join-Path $OutDir 'capture.json'