2. Linux USB 子系统架构：USB Core、HCD、Gadget 驱动栈、UDC 硬件抽象层

在深入分析 USB Gadget 性能瓶颈之前，必须首先理解 Linux USB 子系统的分层架构。该架构将复杂的 USB 通信抽象为四个主要层次：USB Core（核心层）、HCD（主机控制器驱动）、Gadget 驱动栈（设备端功能驱动）以及 UDC 硬件抽象层（设备控制器驱动）。每一层都承担着特定的职责，同时也可能成为性能瓶颈的来源。

2.1 USB Core：协议中枢与调度中心

USB Core 是 Linux USB 子系统的核心模块，位于 drivers/usb/core/ 目录下。它不直接操作硬件，而是提供一套统一的框架，用于管理 USB 总线、设备、接口、端点以及数据传输请求（URB）。

2.2 HCD：主机控制器驱动

HCD（Host Controller Driver）是主机侧硬件与 USB Core 之间的桥梁。Linux 支持多种主机控制器标准，每种标准对应不同的 HCD 实现：

• EHCI（Enhanced Host Controller Interface）：USB 2.0 高速模式，drivers/usb/host/ehci-hcd.c。
• OHCI（Open Host Controller Interface）：USB 1.1 全速/低速模式，drivers/usb/host/ohci-hcd.c。
• UHCI（Universal Host Controller Interface）：Intel 标准的 USB 1.1 实现，drivers/usb/host/uhci-hcd.c。
• xHCI（eXtensible Host Controller Interface）：USB 3.0/3.1/4.0 通用驱动，drivers/usb/host/xhci-hcd.c。

HCD 的核心数据结构是 struct usb_hcd，它封装了硬件寄存器操作、中断处理、DMA 映射以及根集线器模拟。性能调优时，需要关注 HCD 的以下参数：

# 查看当前 HCD 类型与参数
cat /sys/kernel/debug/usb/devices
cat /sys/module/ehci_hcd/parameters/ignore_oc
cat /sys/module/xhci_hcd/parameters/quirks

# 调整 URB 队列深度（部分 HCD 支持）
echo 128 > /sys/module/usbcore/parameters/urb_quantum

2.3 Gadget 驱动栈：设备端功能实现

Gadget 驱动栈运行在设备侧，使 Linux 设备能够模拟 USB 外设（如以太网卡、串口、U盘、摄像头）。它位于 drivers/usb/gadget/ 目录下，由三层组成：

1. Gadget 功能驱动：实现具体协议，如 g_ether.ko（Ethernet Control Model）、g_serial.ko（ACM 串口）、g_mass_storage.ko（大容量存储）。
2. Gadget API 层：提供 usb_gadget_driver 注册接口，管理配置（Configuration）和接口（Interface）的绑定。
3. UDC 绑定层：通过 usb_add_gadget_udc() 将 Gadget 驱动与具体的 UDC 硬件驱动关联。

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

static struct usb_gadget_driver g_ether_driver = {
    .function_name  = "g_ether",
    .max_speed      = USB_SPEED_HIGH,
    .bind           = eth_bind,
    .unbind         = eth_unbind,
    .setup          = eth_setup,
    .disconnect     = eth_disconnect,
    .suspend        = eth_suspend,
    .resume         = eth_resume,
};

static int __init init(void) {
    return usb_gadget_probe_driver(&g_ether_driver);
}
module_init(init);

2.4 UDC 硬件抽象层

UDC（USB Device Controller）硬件抽象层是设备侧的最底层驱动，直接操作 USB 设备控制器寄存器。Linux 内核为多种 SoC 集成的 UDC IP 提供了驱动：

UDC 驱动通过 struct usb_gadget_ops 向 Gadget API 层暴露硬件操作：

static const struct usb_gadget_ops dwc3_gadget_ops = {
    .get_frame        = dwc3_gadget_get_frame,
    .wakeup           = dwc3_gadget_wakeup,
    .set_selfpowered  = dwc3_gadget_set_selfpowered,
    .pullup           = dwc3_gadget_pullup,
    .udc_start        = dwc3_gadget_start,
    .udc_stop         = dwc3_gadget_stop,
    .udc_set_speed    = dwc3_gadget_set_speed,
};

2.5 各层之间的数据流与性能关键路径

理解数据在四层之间的流动路径，是定位性能瓶颈的基础。以 Gadget 发送数据为例，数据流经过以下阶段：

1. 用户空间：应用程序通过 write() 或 send() 将数据写入 Gadget 功能驱动的字符设备节点（如 /dev/ttyGS0）。
2. Gadget 功能驱动：将数据封装为 USB 请求块（struct usb_request），并提交到 Gadget API 层。
3. Gadget API 层：调用 usb_ep_queue() 将请求加入端点队列，触发 UDC 驱动的 queue 回调。
4. UDC 硬件抽象层：配置 DMA 描述符，启动硬件传输。传输完成后触发中断，UDC 驱动调用请求的完成回调。
5. 中断返回路径：完成回调逐层向上传递，最终唤醒等待的用户进程。