3. 高速设备驱动模型：Linux USB gadget与host驱动框架，URB生命周期与数据结构

在高速USB设备驱动开发中，理解Host端与Gadget（Device）端的驱动框架差异，以及核心数据单元URB（USB Request Block）的完整生命周期，是进行性能调优的基础。本章将深入剖析这两大框架的架构层次，并详细拆解URB从创建到完成的全过程。

3.1 Linux USB Host驱动框架

Host端驱动采用经典的分层架构，自底向上分为三层：控制器驱动层（HCD）、核心层（USB Core）以及设备驱动层。这种分层设计实现了硬件无关性与驱动可复用性。

3.2 Linux USB Gadget驱动框架

Gadget端（设备端）框架与Host端对称但方向相反。它同样采用分层设计，使得嵌入式设备可以模拟多种USB外设（如虚拟串口、网卡、大容量存储）。

3.3 URB（USB Request Block）数据结构

URB是Host端驱动中用于描述一次USB传输的核心数据结构。它封装了传输类型、目标端点、数据缓冲区、回调函数等所有必要信息。

struct urb {
    /* 私有字段：由HCD内部使用 */
    struct list_head urb_list;      // 链表节点，用于挂入待处理队列
    struct usb_device *dev;         // 目标USB设备
    unsigned int pipe;              // 管道信息（编码了端点号、方向、类型）
    int status;                     // 传输状态（0成功，负数为错误码）

    /* 传输控制字段 */
    unsigned int transfer_flags;    // 传输标志（如 URB_NO_TRANSFER_DMA_MAP）
    void *transfer_buffer;          // 数据缓冲区指针（CPU虚拟地址）
    dma_addr_t transfer_dma;        // 数据缓冲区DMA地址（若使用DMA）
    int transfer_buffer_length;     // 缓冲区长度
    int actual_length;              // 实际传输的数据长度

    /* 端点与回调 */
    int endpoint;                   // 目标端点号
    void (*complete)(struct urb *); // 传输完成回调函数
    void *context;                  // 回调上下文参数

    /* 等时传输专用 */
    int number_of_packets;          // 等时传输的帧包数量
    struct usb_iso_packet_descriptor iso_frame_desc[0]; // 等时帧描述符数组
};

3.4 URB生命周期详解

URB从创建到销毁经历一系列明确的状态转换。理解这一生命周期对于编写健壮且高性能的驱动至关重要。

3.5 URB生命周期各阶段详解

1. 创建阶段：调用 usb_alloc_urb(int iso_packets, gfp_t mem_flags) 分配URB结构体。对于等时传输，需指定 iso_packets 数量。内存标志推荐使用 GFP_KERNEL（非中断上下文）或 GFP_ATOMIC（中断上下文）。
2. 初始化阶段：使用辅助函数填充URB字段，如 usb_fill_bulk_urb()、usb_fill_int_urb()、usb_fill_control_urb()。需指定回调函数 complete 和上下文 context。
3. 提交阶段：调用 usb_submit_urb(struct urb *urb, gfp_t mem_flags) 将URB提交给USB Core。此函数不可在中断上下文使用 GFP_KERNEL。
4. 排队等待：URB被加入HCD的调度队列。对于高速批量端点，HCD会将其加入异步调度列表；对于中断/等时端点，则加入周期性调度列表。
5. 硬件处理：HCD将URB转换为硬件事务（Transaction），通过DMA或PIO方式与设备交换数据。此阶段URB状态为 -EINPROGRESS。
6. 完成阶段：硬件处理完成后，HCD调用URB的 complete 回调。回调中应检查 urb->status 和 urb->actual_length。注意：回调在软中断上下文中执行，不能睡眠。
7. 释放阶段：调用 usb_free_urb(struct urb *urb) 释放URB内存。通常在完成回调中或驱动卸载时执行。

3.6 Host与Gadget框架对比