4. USB 描述符体系

USB 描述符（Descriptor）是 USB 设备向主机报告自身属性、能力与配置信息的数据结构。主机通过标准设备请求（如 GET_DESCRIPTOR）逐层获取这些描述符，从而完成设备枚举与驱动匹配。描述符体系采用严格的层级结构，从设备级到功能级逐级细化。

4.1 描述符层级结构总览

USB 描述符体系呈树形结构：一个设备只有一个设备描述符，设备描述符中指定了配置描述符的数量；每个配置描述符下包含一个或多个接口描述符；每个接口描述符下包含零个或多个端点描述符。此外，字符串描述符为其他描述符中的索引字段提供可读文本。

4.2 设备描述符 (Device Descriptor)

设备描述符是 USB 设备的第一级描述符，位于描述符树的根节点。主机通过 GET_DESCRIPTOR 请求获取设备描述符时，wValue 高字节为 0x01，低字节为 0x00。

4.3 配置描述符 (Configuration Descriptor)

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

4.4 接口描述符 (Interface Descriptor)

接口描述符描述一个功能单元（如键盘、音频流、大容量存储）。一个配置可以包含多个接口，接口可以设置备用设置（Alternate Setting），用于在运行时切换接口参数（如改变带宽）。

4.5 端点描述符 (Endpoint Descriptor)

端点描述符描述除端点 0 以外的每个端点的属性，包括传输方向、传输类型和最大包大小。端点 0 是默认控制端点，其属性由设备描述符中的 bMaxPacketSize0 定义。

4.6 字符串描述符 (String Descriptor)

字符串描述符提供人类可读的 Unicode 文本，如厂商名称、产品名称和序列号。字符串描述符通过索引号被其他描述符引用。索引 0 是特殊的字符串描述符，它返回设备支持的语言 ID 列表（LANGID）。

4.7 其他描述符

4.7.1 BOS 描述符 (Binary Object Store)

BOS 描述符是 USB 3.0 引入的扩展描述符，用于描述设备对 USB 3.0 及更高版本特性的支持情况。它位于设备描述符之后，通过 GET_DESCRIPTOR 请求（类型 0x0F）获取。

BOS 描述符后跟随一个或多个设备能力描述符 (Device Capability Descriptor)，用于声明 USB 3.0 的特定能力，如：

• USB 2.0 扩展能力：支持 LPM（链路电源管理）
• SuperSpeed 能力：支持 USB 3.0 高速操作
• 容器 ID 能力：提供唯一的设备标识符
• 平台能力：用于微软等厂商的扩展属性（如 WinUSB）

4.7.2 SuperSpeed 端点伴侣描述符 (SS Endpoint Companion Descriptor)

SuperSpeed 端点伴侣描述符是 USB 3.0 为 SuperSpeed 端点增加的额外描述符，紧跟在对应的端点描述符之后。它提供 SuperSpeed 模式下的额外端点属性。

4.8 描述符获取流程与实战代码

主机在枚举过程中按以下顺序获取描述符：

1. 获取设备描述符（前 8 字节，用于确定 bMaxPacketSize0）
2. 复位设备，使用新的 bMaxPacketSize0 重新获取完整设备描述符
3. 获取配置描述符（前 9 字节，用于确定 wTotalLength）
4. 获取完整配置描述符集（包括接口和端点描述符）
5. 如果存在字符串索引，获取字符串描述符
6. 对于 USB 3.0 设备，获取 BOS 描述符

以下是一个简化的 Linux 内核代码片段，展示如何从 usb_device 结构中遍历描述符：

#include <linux/usb.h>

static void print_device_descriptors(struct usb_device *udev)
{
    struct usb_device_descriptor *desc = &udev->descriptor;
    struct usb_host_config *config;
    struct usb_interface *iface;
    struct usb_host_interface *altsetting;
    struct usb_endpoint_descriptor *ep;
    int i, j, k;

    dev_info(&udev->dev, "Device: VID=0x%04x PID=0x%04x\n",
             le16_to_cpu(desc->idVendor),
             le16_to_cpu(desc->idProduct));

    for (i = 0; i < udev->descriptor.bNumConfigurations; i++) {
        config = udev->config + i;
        dev_info(&udev->dev, "  Config %d: %d interfaces\n",
                 i, config->desc.bNumInterfaces);

        for (j = 0; j < config->desc.bNumInterfaces; j++) {
            iface = config->interface[j];
            for (k = 0; k < iface->num_altsetting; k++) {
                altsetting = iface->altsetting + k;
                dev_info(&udev->dev,
                    "    Interface %d.%d: Class=0x%02x\n",
                    altsetting->desc.bInterfaceNumber,
                    altsetting->desc.bAlternateSetting,
                    altsetting->desc.bInterfaceClass);

                for (ep = altsetting->endpoint;
                     ep != altsetting->endpoint +
                          altsetting->desc.bNumEndpoints;
                     ep++) {
                    dev_info(&udev->dev,
                        "      Endpoint 0x%02x: MaxPkt=%d\n",
                        ep->desc.bEndpointAddress,
                        le16_to_cpu(ep->desc.wMaxPacketSize));
                }
            }
        }
    }
}

4.9 描述符体系总结

下表总结了各类描述符的核心属性与用途：