4. USB 设备枚举过程：描述符解析

USB 设备枚举是主机（Host）识别并配置新接入 USB 设备的完整流程。在枚举过程中，主机通过控制传输（Control Transfer）逐级获取设备的描述符（Descriptor），从而了解设备的类型、能力、供电需求以及端点（Endpoint）配置。对于驱动开发者而言，理解枚举过程是正确解析设备拓扑、匹配驱动以及配置 URB（USB Request Block）回调的基础。

4.1 枚举流程概览

当 USB 设备插入端口后，主机控制器检测到电平变化，触发以下标准枚举步骤：

1. 设备连接与复位：主机检测到设备插入，向端口发送复位信号（Reset），设备地址恢复为默认地址 0。
2. 获取设备描述符（前 8 字节）：主机通过默认地址 0 发送 GET_DESCRIPTOR 请求，获取设备描述符的前 8 字节，以确定端点 0 的最大包长度（bMaxPacketSize0）。
3. 再次复位：主机根据获取到的最大包长度重新配置端口，并再次复位设备。
4. 设置地址：主机发送 SET_ADDRESS 请求，为设备分配一个唯一的地址（1~127）。
5. 获取完整设备描述符：主机使用新地址再次获取完整的设备描述符（18 字节）。
6. 获取配置描述符：主机发送 GET_DESCRIPTOR 请求获取配置描述符（9 字节），随后获取完整的配置描述符集合（包括接口描述符和端点描述符）。
7. 选择配置：主机发送 SET_CONFIGURATION 请求，激活设备的某个配置（通常为第一个配置）。

4.2 设备描述符（Device Descriptor）

设备描述符是 USB 设备的第一级描述符，描述了设备的整体信息。主机在枚举初期首先获取该描述符。其结构由 struct usb_device_descriptor 定义（include/uapi/linux/usb/ch9.h）。

4.3 配置描述符（Configuration Descriptor）

配置描述符描述设备的供电模式、接口数量以及整体功耗。一个设备可以有多个配置（Configuration），但同一时刻只能激活一个。配置描述符的结构由 struct usb_config_descriptor 定义。

4.4 接口描述符（Interface Descriptor）

接口描述符描述一个功能接口（Interface），一个配置可以包含多个接口。接口是驱动绑定的基本单位——一个 USB 驱动通常绑定到一个接口上。接口描述符由 struct usb_interface_descriptor 定义。

4.5 端点描述符（Endpoint Descriptor）

端点描述符是驱动开发者最关注的描述符，它定义了除默认端点（端点 0）之外的所有端点的属性。对于中断端点（Interrupt Endpoint）的 URB 回调配置，端点描述符中的 bInterval 字段直接决定了 URB 的轮询间隔。端点描述符由 struct usb_endpoint_descriptor 定义。

4.6 内核中描述符的解析与使用

在 Linux 内核中，USB 核心在枚举完成后，会将解析好的描述符信息存储在 struct usb_device 和 struct usb_interface 结构体中。驱动开发者可以通过以下方式访问这些信息：

// 在 probe() 函数中获取接口和端点信息
static int my_driver_probe(struct usb_interface *intf,
                           const struct usb_device_id *id)
{
    struct usb_device *udev = interface_to_usbdev(intf);
    struct usb_host_interface *altsetting = intf->cur_altsetting;
    struct usb_endpoint_descriptor *ep_desc;
    int i;

    // 打印设备描述符信息
    dev_info(&intf->dev, "VID: 0x%04x, PID: 0x%04x\n",
             udev->descriptor.idVendor,
             udev->descriptor.idProduct);

    // 遍历当前备用设置中的所有端点
    for (i = 0; i < altsetting->desc.bNumEndpoints; i++) {
        ep_desc = &altsetting->endpoint[i].desc;

        // 检查是否为中断端点
        if (usb_endpoint_is_int_in(ep_desc)) {
            dev_info(&intf->dev,
                     "发现中断 IN 端点: 地址=0x%02x, 最大包长=%d, 间隔=%d\n",
                     ep_desc->bEndpointAddress,
                     le16_to_cpu(ep_desc->wMaxPacketSize),
                     ep_desc->bInterval);

            // 保存端点信息供后续 URB 初始化使用
            // ...
        }
    }

    return 0;
}

4.7 枚举过程中的常见问题与调试

4.8 本章小结