3. Linux USB子系统架构：USB核心层、HCD与设备驱动层的分层模型

Linux USB子系统采用经典的分层架构设计，将复杂的USB通信过程抽象为三个独立的层次：USB核心层（usbcore）、主机控制器驱动层（HCD）和设备驱动层。这种分层模型使得驱动开发者只需关注与自己相关的层次，而无需理解底层硬件细节或上层协议。

3.1 三层架构总览

下图展示了Linux USB子系统的完整分层模型，以及数据流在层间的传递路径：

3.2 各层职责详解

3.2.1 USB核心层（usbcore）

USB核心层是Linux USB子系统的基石，编译后生成 usbcore.ko 模块。它负责以下关键功能：

3.2.2 主机控制器驱动层（HCD）

HCD直接与硬件寄存器交互，是唯一与物理主机控制器通信的层次。Linux支持四种主流HCD标准：

HCD通过 struct hc_driver 结构体向USB核心层注册，该结构体包含以下关键回调：

struct hc_driver {
    const char *description;          /* 驱动描述 */
    const char *product_desc;         /* 产品描述 */
    size_t   hcd_priv_size;           /* 私有数据大小 */

    /* 初始化与关闭 */
    int  (*reset)   (struct usb_hcd *hcd);
    int  (*start)   (struct usb_hcd *hcd);
    void (*stop)    (struct usb_hcd *hcd);

    /* URB操作 */
    int  (*urb_enqueue) (struct usb_hcd *hcd,
                         struct urb *urb, gfp_t mem_flags);
    int  (*urb_dequeue) (struct usb_hcd *hcd,
                         struct urb *urb, int status);

    /* 中断处理 */
    irqreturn_t (*irq) (struct usb_hcd *hcd);

    /* 端点管理 */
    int  (*alloc_dev)  (struct usb_device *udev);
    void (*free_dev)   (struct usb_device *udev);

    /* 电源管理 */
    int  (*hub_suspend) (struct usb_hcd *hcd);
    int  (*hub_resume)  (struct usb_hcd *hcd);
};

3.2.3 设备驱动层

设备驱动层是开发者最常接触的层次。它通过USB核心层提供的API与设备通信，无需关心底层主机控制器类型。设备驱动分为两类：

• 类驱动（Class Driver）：内核已实现的通用驱动，如HID（人机交互设备）、Mass Storage（大容量存储）、CDC（通信设备类）、Audio、Video等。大多数常见设备可直接使用类驱动。
• 专用驱动（Vendor-Specific Driver）：针对特定厂商和产品的自定义驱动，需要开发者实现 usb_driver 结构体中的 probe() 和 disconnect() 回调。

设备驱动的核心数据结构：

struct usb_driver {
    const char *name;                    /* 驱动名称 */
    int  (*probe)   (struct usb_interface *intf,
                     const struct usb_device_id *id);
    void (*disconnect) (struct usb_interface *intf);

    /* 可选回调 */
    int  (*suspend) (struct usb_interface *intf, pm_message_t message);
    int  (*resume)  (struct usb_interface *intf);

    /* 设备ID表 */
    const struct usb_device_id *id_table;

    /* 支持多接口设备 */
    int  (*pre_reset)  (struct usb_interface *intf);
    int  (*post_reset) (struct usb_interface *intf);

    struct usbdrv_wrap drvwrap;
};

3.3 分层数据流：URB的完整生命周期

理解URB（USB Request Block）在分层模型中的流转过程，是掌握USB驱动开发的关键。下图展示了从设备驱动提交URB到硬件完成传输的完整路径：

3.4 分层模型中的关键数据结构关系

各层之间的数据传递通过一系列内核数据结构完成。下表总结了核心数据结构及其所属层次：

3.5 分层模型的优势与故障排查启示

理解分层模型对USB驱动故障排查至关重要。不同层次的故障表现出不同的症状：

• HCD层故障：系统无法检测到USB设备，dmesg显示“hub 1-0:1.0: unable to enumerate USB device”，或主机控制器寄存器访问超时。排查方向：检查PCI设备枚举、ACPI电源状态、中断号冲突。
• 核心层故障：设备枚举失败，描述符解析错误，URB提交返回 -ENODEV 或 -ESHUTDOWN。排查方向：检查USB核心模块是否加载、设备地址分配是否耗尽、配置描述符是否合法。
• 设备驱动层故障：probe函数未被调用，或URB完成回调未执行，数据传输超时。排查方向：检查 id_table 匹配、接口绑定条件、URB标志设置是否正确。

分层模型还带来了以下工程优势：

1. 可移植性：设备驱动无需修改即可运行在不同主机控制器上（OHCI/UHCI/EHCI/xHCI）。
2. 模块化：各层可以独立加载/卸载，usbcore.ko 是基础模块，HCD驱动和设备驱动作为插件。
3. 调试隔离：故障可以快速定位到具体层次，减少排查范围。
4. 复用性：类驱动（如usb-storage、usbhid）可被数千种设备复用，无需重复开发。