3. USB 描述符体系：结构与关系

USB 描述符是设备向 Host 报告自身能力与配置的标准化数据结构。Host 在枚举过程中通过标准请求（GET_DESCRIPTOR）逐层获取这些描述符，从而构建出完整的设备逻辑模型。理解描述符的层级关系与字段含义，是移植适配不同 Host 驱动的基础。

3.1 描述符层级总览

每个 USB 设备有且仅有一个设备描述符，至少包含一个配置描述符；每个配置描述符下可包含多个接口描述符；每个接口描述符下可包含多个端点描述符。字符串描述符通过索引被其他描述符引用。

3.2 设备描述符 (Device Descriptor)

设备描述符是 USB 设备的“身份证”，位于描述符树的根节点。Host 通过默认控制端点（端点 0）发送 GET_DESCRIPTOR 请求，索引为 0x01，获取该描述符。其长度为固定的 18 字节。

3.3 配置描述符 (Configuration Descriptor)

配置描述符描述设备的电源管理属性和接口总数。其头部为 9 字节固定长度，但 wTotalLength 字段指示了包括其自身、所有接口描述符和端点描述符在内的总长度。Host 通常分两步获取：先读 9 字节头部，再根据 wTotalLength 读取完整配置描述符集合。

3.4 接口描述符 (Interface Descriptor)

接口描述符代表设备的一个功能单元。一个配置下可以有多个接口（复合设备），每个接口可以包含多个端点（除端点 0 外）。接口描述符长度为 9 字节。

3.5 端点描述符 (Endpoint Descriptor)

端点描述符定义数据传输的端点属性。除默认控制端点（端点 0）外，每个端点都需要一个描述符。其长度为 7 字节。

3.6 字符串描述符 (String Descriptor)

字符串描述符提供可读的 Unicode 文本，如厂商名、产品名、序列号。其他描述符通过索引字段（如 iManufacturer）引用字符串描述符。字符串描述符的索引 0 是特殊的语言 ID 描述符，用于获取设备支持的语言列表。

3.7 描述符关系总结

下表总结了五种标准描述符的关键关系与枚举顺序：

3.8 描述符代码示例

以下是一个典型的 USB 设备描述符和配置描述符的 C 语言结构体定义与初始化示例：

// 设备描述符结构体 (18 字节)
typedef struct {
    uint8_t  bLength;            // 0x12
    uint8_t  bDescriptorType;    // 0x01
    uint16_t bcdUSB;             // 0x0200 (USB 2.0)
    uint8_t  bDeviceClass;       // 0x00
    uint8_t  bDeviceSubClass;    // 0x00
    uint8_t  bDeviceProtocol;    // 0x00
    uint8_t  bMaxPacketSize0;    // 0x40 (64 字节)
    uint16_t idVendor;           // 0x1234
    uint16_t idProduct;          // 0x5678
    uint16_t bcdDevice;          // 0x0100
    uint8_t  iManufacturer;      // 1 (字符串索引)
    uint8_t  iProduct;           // 2
    uint8_t  iSerialNumber;      // 3
    uint8_t  bNumConfigurations; // 1
} __attribute__((packed)) usb_device_descriptor_t;

// 配置描述符头部结构体 (9 字节)
typedef struct {
    uint8_t  bLength;            // 0x09
    uint8_t  bDescriptorType;    // 0x02
    uint16_t wTotalLength;       // 总长度
    uint8_t  bNumInterfaces;     // 1
    uint8_t  bConfigurationValue;// 1
    uint8_t  iConfiguration;     // 0 (无字符串)
    uint8_t  bmAttributes;       // 0x80 (总线供电)
    uint8_t  bMaxPower;          // 50 (100mA)
} __attribute__((packed)) usb_config_descriptor_t;

// 初始化示例
const usb_device_descriptor_t device_desc = {
    .bLength = 0x12,
    .bDescriptorType = 0x01,
    .bcdUSB = 0x0200,
    .bDeviceClass = 0x00,
    .bDeviceSubClass = 0x00,
    .bDeviceProtocol = 0x00,
    .bMaxPacketSize0 = 0x40,
    .idVendor = 0x1234,
    .idProduct = 0x5678,
    .bcdDevice = 0x0100,
    .iManufacturer = 1,
    .iProduct = 2,
    .iSerialNumber = 3,
    .bNumConfigurations = 1
};