USB 枚举验证:标准请求全覆盖、描述符树一致性与错误注入超时处理
更新时间:2026-10-04。USB 设备控制器(Device Controller)的验证里,枚举(Enumeration)是绕不开的第一座山头——主机从设备插入到分配地址、读到完整描述符树、最终 SetConfiguration 点亮功能,整条流程走不完,后面所有批量传输、中断传输的功能验证都是空中楼阁。麻烦的是,枚举阶段几乎每个字节都有规范约束:标准请求(Standard Request)有 17 个,描述符(Descriptor)有树状层级,状态机有 Attached / Powered / Default / Address / Configured 五个迁移节点,任何一个环节出错,真机上的表现就是「设备管理器里一个黄色叹号」,调试信息为零。站内的 USB Chirp 握手验证 讲了物理层高速协商那一段怎么验,Chirp 成功后设备进入全速或高速默认态,紧接着就是本文的主角——控制端点 EP0 上的枚举流程。这一篇把 USB 枚举验证拆成三块:标准请求怎么做到全覆盖、描述符树怎么做一致性检查、错误注入与超时恢复怎么注入才有效,最后给一份能直接抄进回归 checklist 的清单。
本文要回答的问题
- USB 枚举的完整流程里,哪些环节是验证必须盯住的功能点?
- 17 个标准请求怎么组织覆盖,才能做到「每个请求 × 每个状态 × 合法非法参数」不漏项?
- 描述符树的验证难点在哪,字段级一致性检查应该自动化到什么程度?
- 错误描述符注入(长度错、类型错、校验错)怎么设计,DUT 的期望行为是什么?
- 控制传输超时、SETUP 包丢包这类异常路径,验证环境怎么模拟、怎么判定通过?
一、枚举流程的验证分解:把「主机视角的流程」翻译成「DUT 视角的功能点」
先回顾枚举的主线流程。设备插入后主机的动作是固定的:复位总线 → 设备进入 Default 状态、以地址 0 响应 → 主机发 GET_DESCRIPTOR(Device,只读前 8 字节拿 bMaxPacketSize0)→ 再次复位 → SET_ADDRESS 分配地址 → 设备迁入 Address 状态 → 主机按新地址读完整设备描述符、配置描述符(含接口、端点描述符整块读回)→ 可选读字符串描述符 → SET_CONFIGURATION → 设备进入 Configured 状态,功能生效。整条链路在 USB 2.0 规范第 9 章有严格定义,验证的任务是把这条「主机视角的流程」翻译成「DUT 视角的可检查功能点」。
翻译过来是四类功能点。第一类,请求解码:DUT 收到 SETUP 包后能不能正确解析 bmRequestType、bRequest、wValue、wIndex、wLength 五个字段,并分发到正确的处理分支。第二类,描述符数据通路:设备描述符、配置描述符、字符串描述符存在 ROM 或 RAM 里,DUT 能不能按 wLength 截断返回、能不能处理「只读 8 字节」这种短读。第三类,状态机迁移:SET_ADDRESS 的状态迁移发生在 Status Stage 完成之后而不是 Data Stage 之后,这是全 USB 规范里最容易写错的一句;SET_CONFIGURATION 之后端点 FIFO 要重新初始化。第四类,异常处理:不支持的请求要 STALL,描述符长度对不上要按规范截断,主机撤走(无 ACK、无后续 token)要能在超时后恢复 EP0 到可接受下一个 SETUP 的状态。

上图是枚举阶段 DUT 状态机的主干。五个状态里验证权重最大的是 Default 到 Address 这一跳:规范明确要求设备在 SET_ADDRESS 的 Status Stage(零长度 IN 事务)成功返回 ACK 之后才切换到新地址,早一拍切,Status Stage 就用新地址响应了,主机还在往地址 0 发,握手直接失败;晚一拍切,主机接下来按新地址发 GET_DESCRIPTOR 又没人应。这个「迁移时机」必须用 SVA 断言钉死,光靠定向测试跑一次是盖不住的——定向测试只跑对你写的那一种时序,断言才能覆盖「所有拍的排列」。
二、标准请求覆盖:请求 × 状态 × 参数的三维矩阵
USB 2.0 规范定义了 17 个标准请求,从 GET_STATUS、CLEAR_FEATURE 到 SET_DESCRIPTOR、SYNCH_FRAME。验证环境(通常是 UVM 的 USB Host VIP 或自研 BFM)发这些请求不难,难的是回答「我覆盖全了吗」。经验上一个可签核的覆盖模型是三维矩阵:请求类型 × 设备状态 × 参数合法性。
请求类型维度,17 个请求一个不能少,其中 GET_DESCRIPTOR 还要按描述符类型(Device=1、Configuration=2、String=3、Interface=4、Endpoint=5、Device_Qualifier=6、Other_Speed_Configuration=7)展开成子 bin。设备状态维度,同一个请求在不同状态下期望行为不同:SET_ADDRESS 只在 Default 和 Address 状态合法,在 Configured 状态应当 STALL;GET_DESCRIPTOR 在 Default、Address、Configured 三个状态都必须正常工作。参数合法性维度,每个请求至少要打「合法值 / 保留位非零 / wLength 与实际不符 / 索引越界」四类参数 bin。三维相乘,一个最小可用的覆盖矩阵也在 200 bin 以上;偷懒只测「合法请求 × Default 状态」这一格,回归全绿,出片后客诉不断——因为真实主机会在你想不到的状态下发你没想到的请求,Windows、Linux、macOS 的 USB 栈行为细节差异很大。
| 标准请求 | 合法状态 | 关键参数 bin | 期望异常行为 |
|---|---|---|---|
| GET_STATUS | Default(自地址 0)/ Address / Configured | 接收方 = 设备/接口/端点 | 越界 wIndex 返 STALL |
| CLEAR_FEATURE | Address / Configured | ENDPOINT_HALT、DEVICE_REMOTE_WAKEUP | 不支持的 feature 返 STALL |
| SET_FEATURE | Address / Configured | 同上,外加 TEST_MODE | Test Mode 选择子非法返 STALL |
| SET_ADDRESS | Default / Address | 地址 0、1-127、>127 | Configured 状态收到返 STALL |
| GET_DESCRIPTOR | Default / Address / Configured | 7 种类型 × 全读/短读/越界读 | 类型不支持返 STALL |
| SET_CONFIGURATION | Address / Configured | 0、合法配置值、越界值 | 越界配置值返 STALL |
| GET_CONFIGURATION | Address / Configured | 无参数 | Address 状态应返回 0 |
| GET_INTERFACE / SET_INTERFACE | Configured | 接口号与备选设置号 | 越界接口号返 STALL |
上表挑了 8 个高频请求列出覆盖要点,其余 9 个(SET_DESCRIPTOR、SYNCH_FRAME 等)按同一模式展开。注意表里「期望异常行为」这一列——非法请求的期望行为不是「无所谓」,规范写得很清楚是 STALL 握手,你的 scoreboard 必须能区分「DUT 正确 STALL」和「DUT 挂死没响应」,这两者在波形上都表现为「没有 Data Stage」,分不清就会漏报。

这张图把三维矩阵的关系画清楚了:三维不是三选一,是相乘。工程落地时建议在 covergroup 里用 cross 直接表达,再用 illegal_bins 把「Configured 状态收到 SET_ADDRESS 必须 STALL」这类组合显式标出来——这类 bin 命中不代表功能正确,只代表「异常路径被执行到了」,正确性由 scoreboard 里的期望响应检查保证。覆盖率与功能检查分离,是 SVA 断言实践 里反复强调的原则,在枚举验证里同样适用。
三、描述符树一致性:字段级检查必须自动化
描述符是设备的「自述文件」,主机完全靠它认识设备。设备描述符 18 字节、配置描述符 9 字节打头、后面级联接口描述符和端点描述符,字符串描述符按索引引用。验证描述符树有三个层次,难度递增。
第一层,单描述符字段合法性。bLength 是否等于实际长度、bDescriptorType 是否正确、bcdUSB 与设备宣称的速度是否匹配、idVendor/idProduct 是否为分配值、bMaxPacketSize0 对高速设备必须是 64。这一层用定向测试加 scoreboard 比对参考模型(reference model)里的描述符镜像即可,没什么技术含量,但漏掉任何一个字段,认证测试(USB-IF Compliance)就会挂。
第二层,树级结构一致性。配置描述符里的 wTotalLength 必须等于「配置 + 所有接口 + 所有端点描述符」的总字节数,少算一字节主机就会截断读、设备后续端点全部失效;bNumInterfaces 必须等于实际级联的接口描述符个数;字符串描述符的索引引用必须存在——接口描述符里 iInterface = 3,那索引 3 的字符串描述符就必须能读出来。这类错误的阴险之处在于:单看每个描述符都对,拼起来是棵断树。必须有一个「描述符树遍历器」做整体校验:从设备描述符出发,按 bNumConfigurations 遍历每个配置,按 wTotalLength 切分,逐级验证个数、长度、索引引用闭环。
第三层,请求响应与描述符内容的一致性。GET_DESCRIPTOR 请求 wLength = 8 时,DUT 返回的必须是描述符前 8 字节加正确截断的传输,且 bLength 字段仍然报告完整的 18——不能因为只发了 8 字节就把 bLength 改成 8(真实项目里见过这种「动态生成描述符」的实现,Windows 直接不识盘)。还有 Device_Qualifier 描述符:高速设备必须提供,且其中的 bMaxPacketSize0 要与设备描述符一致;主机用 GET_DESCRIPTOR(Device_Qualifier) 探测全速能力,DUT 在高速态下对 Other_Speed_Configuration 的响应要与全速配置描述符一致。这层检查必须写进 scoreboard 的端到端比对,手工 review 波形是查不过来的。

上图是描述符树的层级与关键一致性字段。验证环境里建议把这棵树建成 reference model 的对象图,scoreboard 每收到一次 GET_DESCRIPTOR 响应,就到对象图里查「这个偏移、这个长度应该返回什么字节」,逐字节比对。对象图还能反向服务激励生成:随机改 wLength 做短读测试时,期望值直接从对象图切片得出,不用手算。
四、错误注入与超时:异常路径才是真战场
正向流程跑通只是起点。枚举验证的价值大头在异常路径,因为真机现场全是异常:线缆接触不良导致 CRC 错、主机栈的怪癖时序、挂起到一半被唤醒。异常路径验证分两大类。
错误描述符注入。思路是让 DUT 的描述符源(ROM/RAM/Flash 模型)返回被污染的数据,验证 DUT 与整体系统的行为。三类典型污染:长度错(bLength 写成 0 或大于实际缓冲)、类型错(bDescriptorType 写成规范未定义值)、内容错(wTotalLength 与实际级联长度不符)。这里要先明确责任边界:如果描述符存储在 DUT 内部 ROM,污染它等于测「ROM 内容错时 DUT 怎么办」——规范没要求 DUT 自查描述符,期望行为通常是「原样发给主机,由主机拒绝」,那这条测试的通过判据就是「DUT 不挂死、EP0 后续仍可接受 SETUP」,而不是「DUT 报错」。如果描述符来自外部 Flash,DUT 带 ECC 或校验,那判据才是「校验失败上报告警」。判据写错,测试就会误报一大片,先把期望行为与设计规格书对齐再注入。
控制传输超时与中断。USB 规范给控制传输的 Data Stage 定了 5 秒上限,但 DUT 侧更常见的考察点是:SETUP 收到后主机迟迟不发后续 token(主机栈崩了或被更高优先级事务抢占),DUT 的 EP0 状态机要在下一个 SETUP 到来时无条件复位——规范明确规定「新的 SETUP 包到达即终止当前控制传输」,这是绝对的优先级。验证手法:BFM 发完 SETUP 后静默,随机延迟几个微帧再发新 SETUP,检查 DUT 是否正确放弃旧传输、响应新传输。这个用例几乎每个 USB IP 都踩过坑——状态机设计者想当然地以为「传输总会走完」,结果 EP0 卡死在等待 Data Stage 的状态,设备在主机眼里永久无响应,只能重新插拔。

上面的时序是「SETUP 打断」用例的标准形态。判定通过的硬指标有两条:一是新 SETUP 之后 DUT 的状态机回到可正常响应的初态(用断言检查内部状态信号,别只看接口波形),二是后续新传输能完整走完 Status Stage。第二条尤其重要——见过 DUT 复位了状态机但忘了清数据指针,新传输的 Data Stage 发的是旧描述符的残留字节,波形上「传输成功」,内容上全错。这种 bug 只有 scoreboard 的内容级比对能抓到。
异常路径还有一批零散的但必须在清单里的项:总线复位发生在控制传输中途(DUT 必须立即放弃传输回 Default 态)、挂起(Suspend)在枚举中间发生、GET_DESCRIPTOR 的 Data Stage 中途主机发 NAK 直到超时上限。这些都可以复用「打断」的套路:构造进行到一半的传输,注入异常事件,检查 DUT 的恢复行为。一套健壮的枚举验证环境,异常用例数量通常超过正向用例。
五、落地 checklist:把枚举验证钉进回归
把前面四节落成一份可以直接抄进验证计划的 checklist。第一组,状态机:五状态迁移全覆盖(用 FSM 覆盖率),SET_ADDRESS 迁移时机有断言钉死在 Status Stage 之后,Configured 状态收 SET_ADDRESS 返 STALL 有定向用例。第二组,请求覆盖:17 个标准请求 × 三状态 × 参数四维的 covergroup 进回归,illegal_bins 显式标注异常组合,覆盖率目标 100%。第三组,描述符:单字段比对、树级一致性遍历器、请求响应字节级比对三层全自动化,描述符镜像进 reference model,改描述符不需要改测试代码。第四组,异常:SETUP 打断、中途复位、中途挂起、超时恢复、错误描述符注入五类用例齐全,每类有明确的通过判据且与规格书对齐。第五组,回归纪律:枚举用例集标记为「每日回归必跑」,任何 EP0 相关 RTL 改动触发全量枚举回归——枚举是设备的门面,回归投入在这里的性价比远高于任何后段功能。
这一篇在知识体系里的位置
本篇是 chip-design/verification 目录下 USB 设备验证线的一篇 S 层深文,主关键词 USB 枚举验证。向上承接 USB Chirp 握手验证——Chirp 完成速度协商、设备进入默认态之后,枚举流程立刻开始,两篇合起来覆盖「从插入到点亮」的完整链路。方法论上,本文的三维覆盖矩阵与 覆盖率驱动测试分诊 的分诊思路一脉相承:先把覆盖模型建对,再谈覆盖率数字;SETUP 打断用例里「状态级断言加内容级 scoreboard 双保险」的做法,是 SVA 断言实践 原则在协议验证里的具体落地。横向可迁移性也强:把「标准请求」换成「标准命令集」,同样的「请求 × 状态 × 参数」矩阵可以套到 PCIe 配置空间访问、eMMC 初始化命令序列等任何「主机按规范驱动设备」的验证场景上。
总结
USB 枚举验证的核心是把「主机视角的枚举流程」翻译成 DUT 的四类可检查功能点——请求解码、描述符数据通路、状态机迁移时机、异常恢复,用「17 个标准请求 × 设备状态 × 参数合法性」的三维覆盖矩阵保证正向不漏项,用「单字段比对加树级遍历器加字节级端到端比对」三层自动化钉住描述符树一致性,再用 SETUP 打断、中途复位、超时恢复、错误描述符注入这批异常用例守住真机现场一定会遇到的野路子场景;最关键的判据永远记住两条——SET_ADDRESS 的地址迁移发生在 Status Stage 之后,新 SETUP 到达无条件终止旧控制传输,这两条写进断言,枚举验证的八成就稳了。