3. USB描述符体系

USB 描述符（Descriptor）是 USB 设备向主机报告自身属性、能力和资源分配的核心数据结构。主机通过标准设备请求（如 GET_DESCRIPTOR）逐层获取这些描述符，从而完成枚举过程。描述符体系采用严格的层级结构，每一层都包含指向下一层的指针或长度字段。

3.1 描述符层级结构总览

USB 描述符体系呈树形结构，从设备描述符开始，逐级向下展开。主机在枚举过程中，首先获取设备描述符（18 字节），然后根据其中的 bNumConfigurations 字段获取配置描述符及其附属的所有描述符。

3.2 设备描述符（Device Descriptor）

设备描述符是 USB 设备的第一份“身份证”，长度为固定的 18 字节。主机在枚举的第一步（地址分配后）即发送 GET_DESCRIPTOR 请求获取设备描述符。

3.3 配置描述符（Configuration Descriptor）

配置描述符描述设备的电源管理属性和接口总数。一个设备可以有多个配置（如低功耗模式和高性能模式），但同一时刻只能有一个配置被激活。配置描述符长度为 9 字节。

3.4 接口描述符（Interface Descriptor）

接口描述符描述一个功能单元（如 HID 键盘、UVC 摄像头、音频麦克风）。一个配置可以包含多个接口，接口可以包含备用设置（Alternate Setting）。接口描述符长度为 9 字节。

3.5 端点描述符（Endpoint Descriptor）

端点描述符是描述符体系中最底层的传输实体，定义数据传输的通道属性。每个非零端点都必须有对应的端点描述符。端点描述符长度为 7 字节（USB 2.0 标准），USB 3.0 扩展为 9 字节。

3.6 字符串描述符（String Descriptor）

字符串描述符提供人类可读的文本信息（如厂商名、产品名、序列号），是可选描述符。字符串描述符使用 Unicode UTF-16LE 编码。索引 0 是特殊的语言 ID 描述符，用于声明设备支持的语言。

3.7 描述符获取流程与常见错误

主机在枚举过程中按固定顺序获取描述符。理解这个顺序对于定位枚举失败至关重要。

3.8 描述符调试实战：使用 usbmon 捕获原始描述符

在 Linux 环境下，usbmon 是分析描述符传输最直接的工具。以下示例展示如何捕获并解析设备描述符的原始数据。

# 加载 usbmon 模块
sudo modprobe usbmon

# 查看可用的 USB 总线
ls /sys/kernel/debug/usb/usbmon/

# 捕获总线 2 上的所有 URB（需要 root 权限）
sudo cat /sys/kernel/debug/usb/usbmon/2u > usb_trace.log

# 在另一个终端插入 USB 设备，然后 Ctrl+C 停止捕获
# 查看捕获到的 GET_DESCRIPTOR 请求
grep "GET_DESCRIPTOR" usb_trace.log | head -5

# 典型输出示例（设备描述符请求）：
# ffff8880a1b3c000 0 2:1:0 1280 S Ci:2:0000:0 0 18 = 12010002 00000040 12340987 01020102 01
# 解析：
# 12 = bLength (18)
# 01 = bDescriptorType (DEVICE)
# 0002 = bcdUSB (USB 2.0)
# 00 = bDeviceClass
# 00 = bDeviceSubClass
# 00 = bDeviceProtocol
# 40 = bMaxPacketSize0 (64)
# 1234 = idVendor
# 0987 = idProduct
# 0102 = bcdDevice
# 01 = iManufacturer
# 02 = iProduct
# 01 = bNumConfigurations

3.9 描述符体系总结

USB 描述符体系是枚举过程的“通信协议”，每一层描述符都承载着主机驱动所需的设备信息。在调试 URB 超时和枚举失败时，建议按以下顺序检查描述符：

• 第一步：使用 lsusb -v 或 usbmon 确认设备描述符的 bMaxPacketSize0 是否正确。
• 第二步：检查配置描述符的 wTotalLength 是否等于所有子描述符长度之和。
• 第三步：核对接口描述符的 bNumEndpoints 是否与实际端点数量一致。
• 第四步：验证端点描述符的 wMaxPacketSize 和 bInterval 是否在硬件规格范围内。
• 第五步：确认字符串描述符索引有效，且长度字段正确。