firmwareloop 0.5.0__tar.gz → 0.6.1__tar.gz

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.5.0
+Version: 0.6.1
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -59,6 +59,7 @@ FirmwareLoop 为 AI Agent 暴露了开箱即用的 MCP 工具，涵盖 5 大核
 |---|---|---|
 | **构建与体检** | `fw_doctor` <br> `fw_build` | 环境诊断；编译固件并提取诊断日志。 |
 | **硬件与探针** | `fw_scan_hardware` <br> `fw_flash` <br> `fw_reset` | 扫描探针与串口；烧录固件、复位芯片。 |
+| **串口助手** | `fw_serial_status` <br> `fw_serial_open` <br> `fw_serial_send` <br> `fw_serial_read` <br> `fw_serial_parse` <br> `fw_serial_capture` <br> `fw_serial_close` | 长驻会话串口收发（HEX/ASCII）；发送序列（delay/loop）；帧解析；窗口采集 CSV。 |
 | **总线与协议** | `fw_logic_capture` <br> `fw_logic_decode` | 逻辑分析仪抓取并解码 I2C / SPI / UART。 |
 | **测试与测量** | `fw_run_hil_test` <br> `fw_measure` <br> `fw_acceptance_scenario` | 运行 HIL 自动化测试；读取示波器 / 程控电源测量值。 |
 | **工程与脚手架** | `fw_init_project` <br> `fw_configure_lab` <br> `fw_get_evidence` | 生成多 Agent 指南；修改台架配置；提取审计证据。 |
@@ -381,7 +382,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.5.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.6.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +392,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.5.0）
+## 能力验证状态（v0.6.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -399,6 +400,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/README.md

@@ -31,6 +31,7 @@ FirmwareLoop 为 AI Agent 暴露了开箱即用的 MCP 工具，涵盖 5 大核
 |---|---|---|
 | **构建与体检** | `fw_doctor` <br> `fw_build` | 环境诊断；编译固件并提取诊断日志。 |
 | **硬件与探针** | `fw_scan_hardware` <br> `fw_flash` <br> `fw_reset` | 扫描探针与串口；烧录固件、复位芯片。 |
+| **串口助手** | `fw_serial_status` <br> `fw_serial_open` <br> `fw_serial_send` <br> `fw_serial_read` <br> `fw_serial_parse` <br> `fw_serial_capture` <br> `fw_serial_close` | 长驻会话串口收发（HEX/ASCII）；发送序列（delay/loop）；帧解析；窗口采集 CSV。 |
 | **总线与协议** | `fw_logic_capture` <br> `fw_logic_decode` | 逻辑分析仪抓取并解码 I2C / SPI / UART。 |
 | **测试与测量** | `fw_run_hil_test` <br> `fw_measure` <br> `fw_acceptance_scenario` | 运行 HIL 自动化测试；读取示波器 / 程控电源测量值。 |
 | **工程与脚手架** | `fw_init_project` <br> `fw_configure_lab` <br> `fw_get_evidence` | 生成多 Agent 指南；修改台架配置；提取审计证据。 |
@@ -353,7 +354,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.5.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.6.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -363,7 +364,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.5.0）
+## 能力验证状态（v0.6.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -371,6 +372,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.5.0
+Version: 0.6.1
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -59,6 +59,7 @@ FirmwareLoop 为 AI Agent 暴露了开箱即用的 MCP 工具，涵盖 5 大核
 |---|---|---|
 | **构建与体检** | `fw_doctor` <br> `fw_build` | 环境诊断；编译固件并提取诊断日志。 |
 | **硬件与探针** | `fw_scan_hardware` <br> `fw_flash` <br> `fw_reset` | 扫描探针与串口；烧录固件、复位芯片。 |
+| **串口助手** | `fw_serial_status` <br> `fw_serial_open` <br> `fw_serial_send` <br> `fw_serial_read` <br> `fw_serial_parse` <br> `fw_serial_capture` <br> `fw_serial_close` | 长驻会话串口收发（HEX/ASCII）；发送序列（delay/loop）；帧解析；窗口采集 CSV。 |
 | **总线与协议** | `fw_logic_capture` <br> `fw_logic_decode` | 逻辑分析仪抓取并解码 I2C / SPI / UART。 |
 | **测试与测量** | `fw_run_hil_test` <br> `fw_measure` <br> `fw_acceptance_scenario` | 运行 HIL 自动化测试；读取示波器 / 程控电源测量值。 |
 | **工程与脚手架** | `fw_init_project` <br> `fw_configure_lab` <br> `fw_get_evidence` | 生成多 Agent 指南；修改台架配置；提取审计证据。 |
@@ -381,7 +382,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.5.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.6.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +392,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.5.0）
+## 能力验证状态（v0.6.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -399,6 +400,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（48 例单测）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
 | 一键终端更新（fwloop update） | Implemented + Auto-updater Validated |

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/firmwareloop.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ tools/logic_decode.ps1
 tools/ndtdbg_bridge.ps1
 tools/ndtdbg_cli.py
 tools/reset.ps1
+tools/serial_cli.py
 tools/setup-agent-mcp.ps1
 tools/sigrok_csv_to_fwloop.py
 tools/test-backends.ps1
@@ -30,4 +31,5 @@ tools/common/fw.psm1
 tools/common/uart_probe.py
 tools/lib/__init__.py
 tools/lib/instruments.py
-tools/lib/ndtdbg.py
+tools/lib/ndtdbg.py
+tools/lib/serial_assistant.py

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/pyproject.toml

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

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/tools/__init__.py

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

{firmwareloop-0.5.0 → firmwareloop-0.6.1}/tools/doctor.ps1

@@ -129,28 +129,110 @@ Add-FwCheck 'pyvisa' {
 }
 
 # COM ports present (UART candidates) - informational, never hardcoded.
-# Prefer Agentic HIL's enumeration (hardware-aware) when installed, else WMI.
+# P2-1: agentic-hil 优先, 兜底改用 pyserial comports (SetupAPI, 覆盖 CH341/CP210x/
+# FTDI 等 USB 适配器; Win32_SerialPort 在 Windows 上常漏报 USB CDC/厂商适配器,
+# 实战漏掉真实 DUT 口 COM3 (USB-SERIAL CH341) 导致 agent 误开蓝牙虚拟口)。
+# 输出带 description 并对蓝牙/虚拟口打标记排序 (真实口在前, 防 agent 首选错口)。
 Add-FwCheck 'com_ports' {
     $comPorts = @()
+    $portDetails = @()
+    $source = 'none'
     $ahil = if ($venvBin) { Join-Path $venvBin 'agentic-hil.exe' } else { $null }
     if ($ahil -and (Test-Path -LiteralPath $ahil)) {
         try {
             $raw = & $ahil com-ports 2>$null | Out-String
             $parsed = $raw | ConvertFrom-Json -ErrorAction SilentlyContinue
             if ($parsed -and $parsed.ports) {
-                $comPorts = @($parsed.ports | ForEach-Object { $_.device } | Where-Object { $_ })
+                $portDetails = @($parsed.ports | ForEach-Object {
+                    [pscustomobject]@{ device = [string]$_.device; description = [string]$_.description }
+                } | Where-Object { $_.device })
+                $comPorts = @($portDetails | ForEach-Object { $_.device })
+                $source = 'agentic-hil'
+            }
+        } catch { }
+    }
+    if ($comPorts.Count -eq 0 -and $python) {
+        try {
+            $pyCode = "import json; from serial.tools.list_ports import comports; print(json.dumps([{'device': p.device, 'description': (p.description or '')} for p in comports()]))"
+            $raw = & $python -c $pyCode 2>$null | Out-String
+            $parsed = $raw | ConvertFrom-Json -ErrorAction SilentlyContinue
+            if ($parsed) {
+                $portDetails = @($parsed | ForEach-Object {
+                    [pscustomobject]@{ device = [string]$_.device; description = [string]$_.description }
+                } | Where-Object { $_.device })
+                $comPorts = @($portDetails | ForEach-Object { $_.device })
+                $source = 'pyserial'
             }
         } catch { }
     }
     if ($comPorts.Count -eq 0) {
         try {
             $comPorts = @((Get-CimInstance Win32_SerialPort -ErrorAction SilentlyContinue | Select-Object -ExpandProperty DeviceID))
+            $source = 'wmi'
         } catch { }
     }
+    # 虚拟/蓝牙口标记 + 真实口优先排序
+    $isVirtual = { param($d) $d -match '(?i)bluetooth|蓝牙|virtual|modem|debug port' }
+    $real = @($portDetails | Where-Object { -not (& $isVirtual $_.description) })
+    $virt = @($portDetails | Where-Object { & $isVirtual $_.description })
+    $ordered = @(@($real | ForEach-Object { $_.device }) + @($virt | ForEach-Object { $_.device }))
+    if ($ordered.Count -gt 0) { $comPorts = $ordered }
+    [pscustomobject]@{
+        status        = if ($comPorts.Count -gt 0) { 'ok' } else { 'none' }
+        source        = $source
+        ports         = $comPorts
+        port_details  = @($portDetails)
+        virtual_ports = @($virt | ForEach-Object { $_.device })
+        note          = '排序: 真实串口在前; 蓝牙/虚拟口仅供参考 (无法访问 DUT)'
+    }
+}
+
+# P1-4: lab.yaml 配置链透明度——枚举全局/项目两层 ndtdbg 段存在性与
+# write_allowed 状态; 任何层 write_allowed: true 输出 WARNING
+# (global 层常驻 true 属危险默认; 项目层 false 不代表安全——合并链会回退全局层)。
+Add-FwCheck 'lab_yaml' {
+    if (-not $python) {
+        return [pscustomobject]@{ status = 'missing'; detail = 'no python' }
+    }
+    $pyCode = @'
+import json, os
+try:
+    import yaml
+except ImportError:
+    yaml = None
+def sec(p):
+    try:
+        with open(p, encoding="utf-8") as fh:
+            d = (yaml.safe_load(fh) if yaml else json.load(fh)) or {}
+    except Exception:
+        return {"parse_error": True}
+    s = d.get("ndtdbg") if isinstance(d, dict) else None
+    return s if isinstance(s, dict) else {}
+out = []
+ad = os.environ.get("APPDATA")
+if ad:
+    p = os.path.join(ad, "FirmwareLoop", "lab.yaml")
+    n = sec(p)
+    out.append({"layer": "global", "path": p, "exists": os.path.isfile(p),
+                "ndtdbg": bool(n), "write_allowed": n.get("write_allowed")})
+pp = os.path.join(os.getcwd(), "lab", "lab.yaml")
+n2 = sec(pp)
+out.append({"layer": "project", "path": pp, "exists": os.path.isfile(pp),
+            "ndtdbg": bool(n2), "write_allowed": n2.get("write_allowed")})
+print(json.dumps(out))
+'@
+    $raw = & $python -c $pyCode 2>$null | Out-String
+    $layers = @($raw | ConvertFrom-Json -ErrorAction SilentlyContinue)
+    $warned = @($layers | Where-Object { $_.write_allowed -eq $true })
     [pscustomobject]@{
-        status = if ($comPorts.Count -gt 0) { 'ok' } else { 'none' }
-        source = if ($ahil -and (Test-Path -LiteralPath $ahil)) { 'agentic-hil' } else { 'wmi' }
-        ports  = $comPorts
+        status = if ($warned.Count -gt 0) { 'warn' } else { 'ok' }
+        detail = if ($warned.Count -gt 0) {
+            ($warned | ForEach-Object {
+                $tip = if ($_.layer -eq 'global') { '常驻 true 属危险默认 (会话级临时态, 用完即关)' } else { '项目层开启须用完即关' }
+                "$($_.layer) 层 write_allowed=true ($tip)"
+            }) -join '; '
+        } else { '任何层均未开启 write_allowed (写保护生效)' }
+        layers = @($layers)
     }
 }