3. USB描述符解析：设备描述符、配置描述符、接口描述符、端点描述符

USB描述符（Descriptor）是USB设备向主机报告自身能力与属性的结构化数据块。主机通过标准设备请求（如GET_DESCRIPTOR）逐层获取这些信息，从而构建完整的设备拓扑与功能视图。在驱动开发中，正确解析描述符是配置URB、选择端点、确定传输类型的先决条件。

3.1 描述符层级结构总览

标准USB描述符遵循固定的层级关系，主机通过设备地址和描述符类型字段逐级请求。下图展示了完整的描述符树形结构：

3.2 设备描述符（Device Descriptor）

设备描述符是USB设备的“身份证”，位于描述符层级的最顶层。主机在枚举阶段通过默认控制端点（端点0）获取该描述符，长度为18字节。其关键字段如下：

3.3 配置描述符（Configuration Descriptor）

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

3.4 接口描述符（Interface Descriptor）

接口描述符是驱动开发中最常关注的描述符，它定义了设备的一个功能单元。一个配置可以包含多个接口（如音频设备包含音频控制和音频流两个接口），每个接口可以有多个备用设置（Alternate Setting）。接口描述符长度为9字节：

3.5 端点描述符（Endpoint Descriptor）

端点描述符是驱动配置URB的直接依据，它定义了数据传输的方向、传输类型、最大包大小和轮询间隔。每个非0端点都有一个对应的端点描述符，长度为7字节：

端点地址编码规则：

• 位7（方向位）：0表示OUT（主机到设备），1表示IN（设备到主机）
• 位3-0（端点号）：取值范围0x00~0x0F（端点0为控制端点，双向）
• 示例：0x81表示端点1 IN，0x02表示端点2 OUT

传输类型编码（bmAttributes位1-0）：

• 00：控制传输（Control）——仅端点0使用
• 01：等时传输（Isochronous）——实时数据，无重传
• 10：批量传输（Bulk）——大块数据，保证交付
• 11：中断传输（Interrupt）——小数据量，定期轮询

3.6 描述符解析实战：从原始字节到驱动结构

以下代码演示如何在Linux驱动中解析端点描述符，提取批量传输端点的关键参数：

#include <linux/usb.h>

/* 解析端点描述符，配置批量传输URB */
static int configure_bulk_ep(struct usb_device *udev,
                             struct usb_endpoint_descriptor *ep_desc,
                             struct urb *urb)
{
    int ret;
    unsigned int ep_addr;
    unsigned int ep_type;
    unsigned int max_pkt;

    /* 步骤1：读取端点地址 */
    ep_addr = ep_desc->bEndpointAddress;
    
    /* 步骤2：读取传输类型 */
    ep_type = ep_desc->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;
    
    /* 步骤3：检查是否为批量端点 */
    if (ep_type != USB_ENDPOINT_XFER_BULK) {
        dev_err(&udev->dev, "端点不是批量传输类型\n");
        return -EINVAL;
    }
    
    /* 步骤4：读取最大包大小 */
    max_pkt = le16_to_cpu(ep_desc->wMaxPacketSize);
    
    /* 步骤5：配置URB */
    usb_fill_bulk_urb(urb, udev,
                      usb_rcvbulkpipe(udev, ep_addr) |  /* IN端点 */
                      usb_sndbulkpipe(udev, ep_addr),   /* OUT端点 */
                      NULL, 0, bulk_complete, NULL);
    
    urb->transfer_buffer_length = max_pkt;  /* 设置传输长度 */
    
    dev_info(&udev->dev,
             "批量端点配置成功：地址=0x%02x, 最大包=%u字节\n",
             ep_addr, max_pkt);
    
    return 0;
}

3.7 描述符解析流程SVG图

下图展示了主机从获取设备描述符到配置端点的完整解析流程，以及驱动在其中的介入点：

3.8 描述符解析常见问题与避坑

• 描述符长度校验：解析前必须检查bLength字段是否与预期一致，防止设备返回畸形描述符导致内核崩溃。
• 字节序问题：wMaxPacketSize和wTotalLength为小端序（Little-Endian），在x86平台上需使用le16_to_cpu()转换。
• 备用设置切换：切换备用设置后，端点描述符可能发生变化（如wMaxPacketSize改变），驱动必须重新解析。
• 端点0的特殊性：端点0没有对应的端点描述符，其最大包大小在设备描述符的bMaxPacketSize0字段中定义。
• 复合设备解析：复合设备的每个接口可能属于不同的类，驱动需根据bInterfaceClass匹配对应的驱动程序。