USB Sniffer · Beta

USB Sniffer 移植 USB Sniffer Lite,在板端采集并解码 USB Full Speed,然后缓存传给前端查看。只支持 FS 12 Mbit/s,不是 High Speed 480 Mbit/s 分析仪,也不直接充当 USB 主机发出业务请求。
连接与开始捕获
- 停止所选引脚上的 I2C/SPI/JTAG/逻辑分析等功能。
- 选择相邻 D+/D− 引脚组,以当前页面为准,例如 GPIO8/9。
- 旁路连接被测 D+、D− 与 GND,不要将 VBUS 接入采样 GPIO。
- 被测总线仍由原 USB 主机供电和通信;点击开始捕获。
- 需要观察枚举时,先开始捕获,再重新插入/复位被测设备。
GPIO8/9 只是可选示例,并非所有固件进入页面的默认选项。当前采集占用 PIO1,接线和旁路负载会影响信号,发生 CRC/丢包时需一起排查。
工具栏参数
| 控件 | 效果 |
|---|---|
| D+ / D− | 选择采集引脚组;顺序不可接反 |
| 保留行数 | 2000/5000/10000/20000/50000/100000 |
| 事务 / 数据包 | 组合显示或查看单包 |
| 隐藏 SOF | 只显示并保留最近的非 SOF 记录 |
| 自动滚动 | 跟随最新记录;关闭可回看 |
| 协议字段 | 收起/展开字段信息,不改变总线内容 |
| 导出 | 将当前可见记录保存为 JSON |
| 清空 | 清除前端记录,不代替停止采集 |
| 停止 | 结束本次捕获并释放采集资源 |
保留行数是前端记录数,不会把板端 DMA 缓冲从 32 KiB 变成十万包容量。隐藏 SOF 时另行保留有效记录,避免每毫秒的 SOF 挤走其他通信。
数据包视图:从 PID 读起
| 类型 | 如何理解 |
|---|---|
| SOF | 主机发送帧编号,用于 USB 帧时序组织 |
| SETUP / OUT / IN | Token,指出事务类型、设备地址和端点 |
| DATA0 / DATA1 | 数据包,包含有效载荷和 CRC |
| ACK / NAK / STALL | 握手与流控结果;NAK 可是正常“暂未就绪” |
| SE0 | 两线低状态标记,不独立证明一次有效复位 |
| GAP / SESSION | 丢包或采集会话边界,不能当作业务包 |
点击包查看字段及原始字节;不同 PID 使用不同配色。CRC、异常计数与丢包应一起看,不能只看一行颜色。
箭头与 IN 的方向
↑ 表示设备→主机,↓ 表示主机→设备。IN Token 本身是主机发出的请求,要求设备随后发送 DATA;不是看到 IN 就说明该包由设备发出。SETUP 和 OUT Token 也来自主机。
DATA 和 ACK 的方向取决于事务阶段;孤立包可能没有足够上下文确定方向,此时不能凭空补出箭头。
事务视图:Token → Data → Handshake
一条事务将相关 Token、DATA 和握手组合成摘要,可展开逐包查看地址、端点、长度、CRC 和原始内容。例如:
SETUP → DATA0(8 字节请求)→ ACK
IN → DATA1(返回数据) → ACK
OUT → DATA1(状态阶段) → ACK这只是一个控制传输可能包含的阶段示意,单条事务不等于整个控制传输。设备 NAK、重试、跨帧等待或缺失包都会影响组合。
“未见握手”可能是采集不完整,也可能对应本就没有握手的同步传输;“不完整”不自动等于目标设备协议错误。没有抓到开头时,解码器也无法恢复未捕获的上下文。
缓冲、时间与 SE0
板上使用 DMA 环形缓冲并在板端解码。超过处理能力时可能报告丢包或停止。GAP 前后不视为连续完整事务。
记录时间包含板端解码与 DMA 排队影响,不能用来测量精确 USB 线上时序。要测 EOP、复位脉宽或电气边沿,应使用适当的测量设备;SE0 记录不替代电气复位判定。空接引脚或噪声也可能产生 SE0,应先接真实总线再分析业务。
用户 C 程序与 USB Sniffer 共用保留 RAM,加载/运行 C 程序、驻留回调与 USB 采集互斥。先停止当前功能,并确认资源确实释放。
导出与排查
导出 JSON 包含格式标识 picox-usb-lite-v2、视图/筛选配置、丢包统计及当前可见 rows。它不是完整 USB pcap 文件;保留范围外或被当前视图隐藏的数据不会因为导出重新出现。
| 问题 | 优先检查 |
|---|---|
| 引脚正在使用 | 停止共用 GPIO/PIO 的功能,检查 C 程序和回调 |
| 空接仍有 SE0 | 不当作真实 USB 事务,核对接线和输入电平 |
| 大量 CRC / GAP | D+/D− 顺序、地线、旁路负载、链路/处理负载 |
| 没看到设备枚举 | 是否在设备插入/复位前开始捕获 |
| 列表没最新记录 | 自动滚动是否关闭,或已停止捕获 |
此页当前没有独立的问号帮助;本说明按实际控件和页底提示整理。SDK 原始流 可用于自行保存和分析,解码/事务展示与固件版本需匹配。