4. USB 描述符体系：结构与字段解析

USB 描述符（Descriptor）是设备向主机报告自身能力与配置信息的标准数据结构。主机在枚举过程中通过一系列标准请求（Get Descriptor）读取这些描述符，从而构建完整的设备模型。描述符采用层级嵌套的树形结构，从最顶层的设备描述符逐级向下，直至最底层的端点描述符。

4.1 设备描述符（Device Descriptor）

设备描述符是 USB 描述符体系的根节点，位于描述符链表的头部。主机通过 Get_Descriptor(DEVICE) 请求获取，长度为 18 字节，固定偏移。

4.2 配置描述符（Configuration Descriptor）

配置描述符描述设备的供电模式、最大电流消耗以及包含的接口数量。一个设备可以有多个配置，但同一时刻只能激活一个。配置描述符长度为 9 字节。

4.3 接口描述符（Interface Descriptor）

接口描述符定义设备的一个功能接口，每个接口可以包含一个或多个端点（端点 0 除外）。接口描述符长度为 9 字节。复合设备（如 USB 摄像头 + 麦克风）会包含多个接口描述符。

4.4 端点描述符（Endpoint Descriptor）

端点描述符定义数据传输的端点属性，包括传输方向、传输类型和最大包大小。除端点 0 外，每个非控制端点都必须有对应的端点描述符。端点描述符长度为 7 字节。

4.5 字符串描述符（String Descriptor）

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

4.6 描述符间的依赖关系与校验

在 USB 枚举过程中，描述符的解析顺序和依赖关系至关重要。以下表格总结了各描述符之间的关键关联：

4.7 描述符解析的代码示例

以下是一个简化的 Host 端描述符解析函数，展示如何从原始数据流中提取设备描述符字段：

/* 设备描述符解析示例 */
typedef struct {
    uint8_t  bLength;
    uint8_t  bDescriptorType;
    uint16_t bcdUSB;
    uint8_t  bDeviceClass;
    uint8_t  bDeviceSubClass;
    uint8_t  bDeviceProtocol;
    uint8_t  bMaxPacketSize0;
    uint16_t idVendor;
    uint16_t idProduct;
    uint16_t bcdDevice;
    uint8_t  iManufacturer;
    uint8_t  iProduct;
    uint8_t  iSerialNumber;
    uint8_t  bNumConfigurations;
} usb_device_descriptor_t;

int usb_parse_device_descriptor(const uint8_t *buf, uint16_t len,
                                usb_device_descriptor_t *desc) {
    if (len < 18) {
        return -1;  /* 数据长度不足 */
    }
    if (buf[0] != 18 || buf[1] != 0x01) {
        return -2;  /* 长度或类型错误 */
    }

    desc->bLength          = buf[0];
    desc->bDescriptorType  = buf[1];
    desc->bcdUSB           = (buf[3] << 8) | buf[2];
    desc->bDeviceClass     = buf[4];
    desc->bDeviceSubClass  = buf[5];
    desc->bDeviceProtocol  = buf[6];
    desc->bMaxPacketSize0  = buf[7];
    desc->idVendor         = (buf[9] << 8) | buf[8];
    desc->idProduct        = (buf[11] << 8) | buf[10];
    desc->bcdDevice        = (buf[13] << 8) | buf[12];
    desc->iManufacturer    = buf[14];
    desc->iProduct         = buf[15];
    desc->iSerialNumber    = buf[16];
    desc->bNumConfigurations = buf[17];

    return 0;  /* 解析成功 */
}

4.8 描述符体系总结

USB 描述符体系是枚举过程的核心数据模型，理解其层级结构和字段含义是进行 Host 驱动移植的基础。以下要点需要重点掌握：

• 层级关系：设备 → 配置 → 接口 → 端点，逐级嵌套，不可跨越。
• 长度固定：设备描述符 18 字节、配置描述符 9 字节、接口描述符 9 字节、端点描述符 7 字节，字符串描述符长度可变。
• 类型码：每个描述符的第二个字节（bDescriptorType）标识类型，Host 驱动据此区分描述符种类。
• 索引字段：iManufacturer、iProduct、iSerialNumber 等索引字段指向字符串描述符，0 表示该字符串不存在。
• 校验优先：在解析每个描述符之前，必须先校验 bLength 和 bDescriptorType，防止解析越界或类型不匹配。