Skip to content

USB Sniffer · Beta ​

USB 事务视图示意,示例数据

USB Sniffer 移植 USB Sniffer Lite,在板端采集并解码 USB Full Speed,然后缓存传给前端查看。只支持 FS 12 Mbit/s,不是 High Speed 480 Mbit/s 分析仪,也不直接充当 USB 主机发出业务请求。

连接与开始捕获 ​

  1. 停止所选引脚上的 I2C/SPI/JTAG/逻辑分析等功能。
  2. 选择相邻 D+/D− 引脚组,以当前页面为准,例如 GPIO8/9。
  3. 旁路连接被测 D+、D− 与 GND,不要将 VBUS 接入采样 GPIO。
  4. 被测总线仍由原 USB 主机供电和通信;点击开始捕获。
  5. 需要观察枚举时,先开始捕获,再重新插入/复位被测设备。

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 / INToken,指出事务类型、设备地址和端点
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 和原始内容。例如:

text
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 / GAPD+/D− 顺序、地线、旁路负载、链路/处理负载
没看到设备枚举是否在设备插入/复位前开始捕获
列表没最新记录自动滚动是否关闭,或已停止捕获

此页当前没有独立的问号帮助;本说明按实际控件和页底提示整理。SDK 原始流 可用于自行保存和分析,解码/事务展示与固件版本需匹配。