3. USB设备枚举过程：从复位到配置描述符的完整状态机

USB设备枚举是主机（Host）发现并初始化一个新接入设备的过程。整个过程由主机控制器驱动（HCD）和USB核心（USB Core）协同完成，涉及一系列标准USB请求（Setup包）和设备的状态迁移。理解枚举状态机是诊断“设备无法识别”、“驱动加载失败”等故障的基础。

3.1 枚举的8个关键阶段

从物理连接建立到设备可供驱动使用，枚举过程可分解为以下8个阶段。每个阶段对应设备的一个USB标准状态。

3.2 枚举状态机与信号波形

下面这张SVG图展示了枚举过程中主机与设备之间的状态迁移，以及D+/D-差分信号线上的关键波形特征。

3.3 描述符获取的详细流程

描述符获取是枚举中最复杂的部分，涉及多次控制传输。主机通过GET_DESCRIPTOR请求逐级读取设备信息。下面以标准USB 2.0设备为例，展示描述符的层级结构。

3.4 控制传输与Setup包结构

枚举过程中的所有标准请求都通过控制传输（Control Transfer）完成。控制传输包含三个阶段：Setup阶段、Data阶段（可选）、Status阶段。Setup包是主机发送的8字节请求，其结构如下：

3.5 枚举失败常见原因与内核日志

当枚举过程出现故障时，Linux内核会通过dmesg输出关键错误信息。下表总结了常见故障点及其对应的内核日志特征。

3.6 枚举状态机代码实现片段

在Linux内核中，枚举过程的核心实现在 drivers/usb/core/hub.c 的 hub_port_connect_change() 函数中。下面展示地址分配阶段的简化代码逻辑：

/* drivers/usb/core/hub.c - 地址分配阶段简化逻辑 */
static int hub_set_address(struct usb_device *udev, int devnum)
{
    int retval;
    struct usb_ctrlrequest req;

    /* 构造SET_ADDRESS请求 */
    req.bRequestType = USB_DIR_OUT | USB_RECIP_DEVICE;
    req.bRequest = USB_REQ_SET_ADDRESS;
    req.wValue = cpu_to_le16(devnum);
    req.wIndex = 0;
    req.wLength = 0;

    /* 发送控制传输 */
    retval = usb_control_msg(udev, usb_sndctrlpipe(udev, 0),
                             req.bRequest, req.bRequestType,
                             req.wValue, req.wIndex, NULL, 0,
                             USB_CTRL_SET_TIMEOUT);
    if (retval < 0) {
        dev_err(&udev->dev, "device not accepting address %d, error %d\n",
                devnum, retval);
        return retval;
    }

    /* 等待设备完成地址切换（USB规范要求2ms延迟） */
    msleep(2);

    /* 更新设备地址 */
    udev->devnum = devnum;
    return 0;
}

3.7 枚举故障排查清单

当遇到枚举失败问题时，建议按以下清单逐项排查：

1. 检查物理连接：测量D+/D-对地电阻，正常应为1.5kΩ（设备端上拉）或15kΩ（主机端下拉）。
2. 验证复位信号：用示波器捕获SE0信号，确认持续时间≥10ms且无毛刺。
3. 分析Setup包：使用USB分析仪或usbmon捕获枚举阶段的控制传输，检查请求码和参数是否正确。
4. 校验描述符：使用 lsusb -v 查看设备描述符内容，确认bLength、bDescriptorType、bMaxPacketSize0等字段合法。
5. 检查电源：测量VBUS电压，确保在4.75V~5.25V范围内，且设备上电后电压跌落不超过330mV。
6. 查看内核日志：执行 dmesg | grep -i usb 定位错误信息，根据错误码判断故障类型。