4. 中断URB的生命周期：URB的分配、填充、提交、完成回调与取消机制

中断URB（USB Request Block）是USB中断端点通信的核心载体，其生命周期管理直接决定了实时性表现。一个中断URB从创建到销毁，依次经历分配、填充、提交、完成回调与取消五个关键阶段。本章将深入剖析每个阶段的操作细节、内核接口及实时性优化要点。

4.1 中断URB的分配

URB的分配发生在驱动初始化或打开设备时，内核提供专用的内存分配接口。中断URB通常使用usb_alloc_urb()函数，该函数从URB缓存池中分配内存，避免频繁的kmalloc开销。

struct urb *usb_alloc_urb(int iso_packets, gfp_t mem_flags);

4.2 中断URB的填充

分配完成后，驱动需要填充URB的各个字段，指定传输方向、目标端点、数据缓冲区、回调函数等。中断URB的填充通过usb_fill_int_urb()辅助函数完成。

void usb_fill_int_urb(struct urb *urb,
                      struct usb_device *dev,
                      unsigned int pipe,
                      void *transfer_buffer,
                      int buffer_length,
                      usb_complete_t complete_fn,
                      void *context,
                      int interval);

4.3 中断URB的提交

填充完成后，驱动调用usb_submit_urb()将URB提交给USB核心层。该函数将URB加入HCD（主机控制器驱动）的调度队列，等待硬件处理。

int usb_submit_urb(struct urb *urb, gfp_t mem_flags);

提交后的URB状态转换如下：

• 提交前：URB处于URB_FREE状态
• 提交成功：状态变为URB_SUBMITTED，进入HCD调度队列
• 提交失败：返回负错误码（如-ENOMEM、-EINVAL），URB状态不变

4.4 中断URB的完成回调

当USB硬件完成数据传输后，HCD通过中断通知内核，内核在中断上下文中调用URB的完成回调函数。回调函数是驱动处理输入数据的入口，也是重新提交URB的时机。

static void intr_urb_complete(struct urb *urb)
{
    struct my_device *dev = urb->context;
    int ret;

    /* 检查URB状态 */
    if (urb->status == 0) {
        /* 成功：处理接收数据 */
        process_input_data(dev, urb->transfer_buffer,
                          urb->actual_length);
    } else if (urb->status == -ECONNRESET ||
               urb->status == -ENOENT ||
               urb->status == -ESHUTDOWN) {
        /* 被取消或设备断开，停止重新提交 */
        return;
    } else {
        /* 其他错误，尝试重新提交 */
        dev_err(&dev->intf->dev, "URB error %d\n", urb->status);
    }

    /* 重新提交URB以接收下一个中断 */
    ret = usb_submit_urb(urb, GFP_ATOMIC);
    if (ret)
        dev_err(&dev->intf->dev, "resubmit failed %d\n", ret);
}

4.5 中断URB的取消机制

在设备断开、驱动卸载或需要重置端点时，驱动必须取消正在进行的URB。内核提供两种取消接口，适用于不同场景。

4.5.1 usb_kill_urb() — 同步取消

void usb_kill_urb(struct urb *urb);

• 行为：等待URB完全停止后才返回，确保URB不再被使用
• 适用场景：驱动卸载、设备断开等确定性场景
• 注意事项：不能在中断上下文调用，可能导致死锁

4.5.2 usb_unlink_urb() — 异步取消

int usb_unlink_urb(struct urb *urb);

• 行为：发起取消请求后立即返回，不等待URB停止
• 适用场景：中断上下文、需要快速响应的场景
• 返回值：0表示取消请求已提交，-EINPROGRESS表示URB正在处理

4.6 中断URB生命周期全景

将上述五个阶段串联起来，形成中断URB的完整生命周期。理解这个闭环是编写稳定、实时中断驱动的基石。