2. Linux USB驱动框架：USB核心、HCD、UDC、Gadget框架简介

Linux USB子系统采用分层、模块化的架构设计，将主机侧与设备侧的驱动逻辑解耦。理解这一框架是进行USB控制器驱动开发、设备树绑定以及PHY初始化的前提。本章从全局视角剖析USB核心、主机控制器驱动（HCD）、设备控制器驱动（UDC）以及Gadget框架的职责与协作关系。

2.1 USB子系统整体分层架构

Linux USB驱动栈从顶层到底层可划分为四个主要层次，每一层都通过标准的内核API与相邻层交互。下图展示了主机侧与设备侧完整的软件栈结构。

2.2 USB核心层（USB Core）

USB核心层位于drivers/usb/core/目录下，是USB子系统的中枢神经系统。它负责以下关键职责：

• 总线管理： 维护usb_bus_type总线，管理usb_device与usb_driver的匹配与绑定。
• 设备枚举： 实现完整的USB 2.0/3.0枚举流程，包括获取设备描述符、配置描述符、分配地址。
• URB处理： 提供usb_submit_urb()、usb_kill_urb()等API，管理USB请求块的生命周期。
• 标准请求： 封装控制传输的标准设备请求（GetDescriptor、SetConfiguration等）。
• sysfs接口： 在/sys/bus/usb/下暴露设备拓扑与属性信息。

2.3 HCD（Host Controller Driver）框架

HCD是主机控制器驱动的标准抽象层，位于drivers/usb/host/目录。它向下直接操作USB主机控制器寄存器，向上通过usb_hcd结构体向核心层注册。Linux支持四种主流主机控制器标准：

• xHCI (eXtensible Host Controller Interface)： USB 3.0/3.1/3.2标准，兼容USB 2.0/1.1，当前主流方案。
• EHCI (Enhanced Host Controller Interface)： USB 2.0高速标准，通常与OHCI/UHCI配合使用。
• OHCI (Open Host Controller Interface)： USB 1.1标准，主要用于嵌入式平台。
• UHCI (Universal Host Controller Interface)： USB 1.1标准，Intel主导，软件复杂度高于OHCI。

2.4 UDC（USB Device Controller）框架

UDC是设备侧的核心驱动框架，位于drivers/usb/gadget/udc/目录。它负责管理USB设备控制器硬件，使嵌入式设备能够作为USB外设（如虚拟串口、U盘、以太网卡）与主机通信。UDC框架的核心抽象包括：

• struct usb_gadget： 代表一个USB设备控制器实例，包含端点列表、速度能力、电源管理状态。
• struct usb_gadget_ops： 控制器操作函数集，包括udc_start()、udc_stop()、pullup()、vbus_session()等。
• struct usb_ep： 抽象一个USB端点，提供queue()、dequeue()、enable()、disable()等操作。
• struct usb_request： 对应主机侧的URB，描述一次端点数据传输请求。

2.5 Gadget框架与Composite设备

Gadget框架是设备侧USB功能驱动的实现层，位于drivers/usb/gadget/目录。它允许开发者将多个USB功能（Function）组合成一个复合设备（Composite Device）。Gadget框架分为三个层次：

典型的Gadget驱动初始化流程如下：

// 1. 定义USB设备描述符
static struct usb_device_descriptor device_desc = {
    .bLength = sizeof(device_desc),
    .bDescriptorType = USB_DT_DEVICE,
    .bcdUSB = cpu_to_le16(0x0200),
    .bDeviceClass = 0,
    .idVendor = cpu_to_le16(0x1d6b),  // Linux Foundation
    .idProduct = cpu_to_le16(0x0104),
};

// 2. 定义Composite绑定结构
static struct usb_composite_driver my_gadget_driver = {
    .name = "g_mygadget",
    .dev = &device_desc,
    .strings = dev_strings,
    .bind = my_bind,
    .unbind = my_unbind,
};

// 3. 注册Composite驱动
static int __init my_init(void)
{
    return usb_composite_probe(&my_gadget_driver);
}
module_init(my_init);

2.6 主机侧与设备侧的数据流对比

理解数据在USB栈中的流动方向是驱动开发的基础。下表对比了主机侧（HCD）与设备侧（UDC/Gadget）的数据路径差异：

2.7 设备树中的USB控制器绑定

设备树是嵌入式Linux平台描述USB控制器硬件拓扑的标准方式。一个典型的USB控制器设备树节点包含以下关键属性：

&usb1 {
    compatible = "snps,dwc3";
    reg = <0x0 0x31000000 0x0 0x10000>;
    interrupts = <GIC_SPI 93 IRQ_TYPE_LEVEL_HIGH>;
    dr_mode = "otg";               // 工作模式：host/peripheral/otg
    phy-names = "usb2-phy", "usb3-phy";
    phys = <&usb2_phy>, <&usb3_phy>;
    maximum-speed = "super-speed";  // 限制最高速率
    snps,dis_u2_susphy_quirk;      // 关闭USB2.0挂起PHY
    snps,dis_u3_susphy_quirk;      // 关闭USB3.0挂起PHY
    status = "okay";
};