USB Trace 采集分析

USB trace 采集 / 解码 / 分析工具链（vcdlog）的 VS Code 图形界面。在 VS Code 侧边栏提供完整的 VCD/LOG 采集面板，底层复用纯 Python 的 vcdlog.py / tracevcd.py / vcdcheck 工具链。

前置要求

• Python 3.8+，且 python 在 PATH 中（或在本扩展设置里指定 usbtrace.pythonPath）。
• 采集仅支持 Windows：通过 usbprint.sys 接口枚举目标板；解码 / 分析 / 自测跨平台可用。
• 波形查看请另装 VCD 波形查看插件（或 GTKWave）。

功能

• VCD 采集 / 停止：采集并同步解码为标准 VCD（支持未上电等待、断连自动重连、定时停止 / task 信号触发停止）。
• LOG 采集 / 停止：从 interface 0 读取 HCI/debug 日志，实时滚动显示并写入 .log 文件。
• 分析：对最新 VCD 跑波形分析（.analysis.txt）+ 断言分析（.report.json）。
• 打开 VCD / LOG：在 VS Code 中打开最新产物。
• 配置保存在工作区 .vscode/vcdlog.json，与命令行工具共用。

使用

1. 打开侧边栏「USB Trace」图标（或命令面板运行 USB Trace: 打开工具面板）。
2. 填写 bin 文件（文件命名参照）、系统时钟频率、VID/PID/版本、信号参考文件、分析规则文件等。
3. 点「VCD采集」开始，「VCD停止」结束；点「打开 VCD」查看波形；点「分析」产出断言报告。
4. 命令面板还提供 USB Trace: 自测（不接硬件） 与 USB Trace: 设备信息。

配置

其余参数（mhz / vid / pid / version / def / spec / out_dir / 停止方式 / 覆盖-添加模式等）保存在工作区 .vscode/vcdlog.json，面板上的「保存配置」或任意采集/分析操作都会写入该文件。

构建（开发）

npm install
npm run compile        # tsc 编译 + 复制 Python 脚本/静态资源到 resources/
npm run package        # 产出 usbtrace-x.x.x.vsix（当前为 usbtrace-0.1.1.vsix）

本地安装：code --install-extension usbtrace-0.1.1.vsix。