4. 中断上下文与V4L2缓冲区管理：中断中获取视频帧、videobuf2框架与中断交互、DMA描述符链与中断完成回调

在多核嵌入式系统中，V4L2驱动的中断处理不仅仅是响应硬件事件，更核心的任务是在极短的中断上下文中完成视频帧的获取、缓冲区状态切换以及DMA传输的交接。本章深入剖析中断上下文与V4L2缓冲区管理框架（videobuf2）的交互机制，重点讲解如何在中断中安全地获取视频帧、管理DMA描述符链，并通过中断完成回调高效地将数据交付给用户空间。

4.1 中断上下文中的视频帧获取策略

视频帧的获取通常发生在硬件VSYNC或DMA传输完成中断中。在中断上下文（Interrupt Context）中，代码不能睡眠、不能调用可能导致调度的函数（如 mutex_lock、copy_to_user），因此帧获取必须采用原子操作或推迟到软中断/工作队列中执行。

4.1.1 中断中帧获取的典型流程

  1. 读取硬件状态寄存器：确认帧同步信号（Frame Start/End）或DMA完成标志。
  2. 获取当前活跃的缓冲区索引：从硬件寄存器或驱动维护的环形指针中读取当前写入的缓冲区ID。
  3. 记录时间戳与帧序号：使用 ktime_get_real() 或硬件时间戳寄存器，在中断中立即捕获。
  4. 切换缓冲区所有权：将硬件正在写入的缓冲区标记为“已完成”，并通知videobuf2框架。
  5. 触发DMA描述符链的下一步：如果使用链式DMA，更新下一个描述符的地址。
关键约束： 中断中禁止调用 vb2_buffer_done() 的同步变体（如 VB2_BUF_STATE_DONE 且带 wait_queue 唤醒），必须使用原子操作或推迟到tasklet/workqueue中执行。通常做法是在中断中仅做最小记录，通过 tasklet_schedule() 或 INIT_WORK 将缓冲区处理推迟到软中断上下文。

4.1.2 帧获取的原子操作与数据一致性

在多核系统中，中断可能在不同CPU核心上触发，且与DMA引擎、应用程序存在数据竞争。必须使用 dma_rmb()、smp_wmb() 等内存屏障确保描述符更新和缓冲区状态变更的顺序可见性。

操作 内存屏障要求 说明
读取DMA完成标志 dma_rmb() 确保DMA写入内存的数据在读取标志之前已全局可见
更新缓冲区状态 smp_wmb() 确保状态更新在唤醒消费者之前对其他核心可见
修改描述符链指针 wmb() 保证描述符内容写入后，硬件读取指针时看到最新值
最佳实践： 在中断处理函数顶部调用 dma_rmb()，在退出前调用 smp_wmb()，形成对称的内存屏障对，确保帧数据与元数据的一致性。

4.2 videobuf2框架与中断交互机制

videobuf2（vb2）是V4L2驱动中管理视频缓冲区的标准框架。中断处理函数与vb2的交互主要通过以下三个核心接口完成：

  • vb2_buffer_done()：通知vb2框架一个缓冲区已经填充完成，可被用户空间读取。
  • vb2_plane_vaddr() / vb2_plane_dma_addr()：在中断中获取缓冲区的虚拟地址或DMA物理地址（通常已在队列准备阶段映射好）。
  • vb2_start_streaming() / vb2_stop_streaming()：流控制回调，通常在进程上下文调用，但中断中可通过标志位触发停止请求。

4.2.1 中断中调用vb2接口的注意事项

vb2接口 中断上下文安全性 替代方案
vb2_buffer_done() 不安全（可能睡眠） 使用 VB2_BUF_STATE_DONE 并推迟到tasklet
vb2_plane_dma_addr() 安全（仅查表） 直接使用预存的dma_addr_t数组
vb2_queue_error() 不安全 设置原子标志，在workqueue中调用
vb2_is_streaming() 安全（读原子变量） 直接使用
常见错误： 在中断中直接调用 vb2_buffer_done() 并传入 VB2_BUF_STATE_DONE，如果vb2内部尝试唤醒等待队列（如 poll() 等待），会导致在中断上下文中调用 wake_up()，可能触发调度器，造成内核崩溃。正确的做法是使用 VB2_BUF_STATE_DONE 但通过 tasklet 或 workqueue 间接调用。

4.2.2 中断与vb2的典型交互序列

/* 中断处理函数（上半部） */
static irqreturn_t sensor_isr(int irq, void *dev_id)
{
    struct sensor_dev *sdev = dev_id;
    struct vb2_buffer *vb;
    int buf_idx;

    /* 1. 读取硬件状态，确认帧完成 */
    u32 status = readl(sdev->regs + REG_STATUS);
    if (!(status & STATUS_FRAME_DONE))
        return IRQ_NONE;

    /* 2. 获取当前完成的缓冲区索引（硬件维护的环形指针） */
    buf_idx = readl(sdev->regs + REG_CUR_BUF) & 0x3;

    /* 3. 获取vb2缓冲区对象（已在队列准备时关联） */
    vb = sdev->bufs[buf_idx];

    /* 4. 记录时间戳（原子操作） */
    vb->timestamp = ktime_get_real();

    /* 5. 设置缓冲区状态为完成，但推迟到tasklet中调用vb2_buffer_done */
    sdev->pending_buf = vb;
    tasklet_schedule(&sdev->done_tasklet);

    /* 6. 更新DMA描述符链到下一个缓冲区 */
    update_dma_chain(sdev, (buf_idx + 1) & 0x3);

    return IRQ_HANDLED;
}

/* tasklet处理函数（下半部） */
static void sensor_done_tasklet(unsigned long data)
{
    struct sensor_dev *sdev = (struct sensor_dev *)data;

    if (sdev->pending_buf) {
        vb2_buffer_done(sdev->pending_buf, VB2_BUF_STATE_DONE);
        sdev->pending_buf = NULL;
    }
}

4.3 DMA描述符链与中断完成回调

高性能V4L2驱动通常使用DMA描述符链（Descriptor Chain）来实现连续帧采集，无需CPU在每帧之间重新配置DMA。中断完成回调（Completion Callback）是DMA引擎通知驱动传输结束的机制。

4.3.1 DMA描述符链的结构

描述符链是一个单向或双向链表，每个描述符包含：源地址、目的地址、传输长度、控制标志以及指向下一个描述符的指针。硬件自动遍历链直到遇到链尾标志。

DMA描述符链结构（环形缓冲池） 描述符 0 src: 0x1000_0000 dst: buf0 DMA addr next: &desc1 描述符 1 src: 0x1000_0000 dst: buf1 DMA addr next: &desc2 描述符 2 src: 0x1000_0000 dst: buf2 DMA addr next: &desc3 描述符 3 src: 0x1000_0000 dst: buf3 DMA addr next: &desc0 (环) 说明： 描述符链形成环形缓冲池，DMA硬件自动遍历。中断完成回调触发时，驱动只需更新当前完成的描述符索引， 并将对应的vb2缓冲区标记为完成。链尾标志（next=0）用于停止流，环形模式用于连续采集。

4.3.2 中断完成回调的注册与处理

在使用Linux DMA引擎（如dmaengine）时，中断完成回调通过 dma_async_tx_descriptor 的 callback 字段注册。该回调在DMA传输完成中断中被调用，但同样处于中断上下文。

/* DMA描述符回调函数（在中断上下文中执行） */
static void dma_callback(void *param)
{
    struct sensor_dev *sdev = (struct sensor_dev *)param;
    struct vb2_buffer *vb;

    /* 获取当前完成的缓冲区（由描述符链上下文传递） */
    vb = sdev->active_vb;

    /* 记录硬件时间戳（如果DMA控制器支持） */
    vb->timestamp = ktime_get_real();

    /* 将缓冲区加入完成队列，由tasklet处理vb2_buffer_done */
    spin_lock(&sdev->done_lock);
    list_add_tail(&vb->done_entry, &sdev->done_list);
    spin_unlock(&sdev->done_lock);

    tasklet_schedule(&sdev->done_tasklet);

    /* 准备下一个描述符（预取） */
    prepare_next_descriptor(sdev);
}

/* 描述符提交示例 */
static void submit_dma_chain(struct sensor_dev *sdev)
{
    struct dma_async_tx_descriptor *tx;
    int i;

    for (i = 0; i < NUM_BUFS; i++) {
        tx = dmaengine_prep_slave_sg(sdev->dma_chan,
                                     sdev->sg_table[i].sgl,
                                     sdev->sg_table[i].nents,
                                     DMA_DEV_TO_MEM,
                                     DMA_PREP_INTERRUPT | DMA_CTRL_ACK);
        tx->callback = dma_callback;
        tx->callback_param = sdev;

        /* 链接描述符形成链 */
        if (i == 0)
            sdev->txd_head = tx;
        else
            sdev->txd_prev->tx_submit(sdev->txd_prev);

        sdev->txd_prev = tx;
    }

    /* 提交整个链 */
    dmaengine_submit(sdev->txd_head);
    dma_async_issue_pending(sdev->dma_chan);
}

4.3.3 中断完成回调与负载均衡

在多核系统中，DMA中断可能被路由到任意CPU核心。为了均衡负载，驱动应避免在中断回调中执行重操作，而是将缓冲区处理分散到不同核心的tasklet或workqueue中。

策略 实现方式 适用场景
Per-CPU tasklet 为每个CPU核创建一个tasklet，中断中根据当前CPU选择对应的tasklet 高帧率、多核均匀中断分布
工作队列绑定 使用 alloc_workqueue() 创建WQ，并绑定到指定CPU或使用 WQ_UNBOUND 需要进程上下文操作（如copy_to_user）
中断亲和性设置 通过 /proc/irq/<irq>/smp_affinity 将中断固定到特定CPU 减少缓存抖动，适合确定性延迟场景
性能调优建议： 对于4K@60fps视频流，建议将DMA中断绑定到与运行应用程序相同的CPU簇（如big核心），并将tasklet绑定到同一个核心，以减少跨核缓存失效和锁竞争。使用 irq_set_affinity_hint() 在驱动初始化时设置亲和性。

4.4 中断上下文与缓冲区管理的综合架构

下图展示了中断上下文、DMA描述符链、videobuf2框架以及用户空间之间的完整数据流与交互关系。

中断上下文与V4L2缓冲区管理综合架构 摄像头传感器 VSYNC / 数据流 DMA请求 DMA控制器 描述符链遍历 传输完成中断 中断处理函数 获取帧/记录时间戳 调度tasklet Tasklet / Workqueue 调用vb2_buffer_done 唤醒用户空间 videobuf2框架 缓冲区队列管理 状态机切换 用户空间应用 poll() / DQBUF 帧数据处理 关键数据流说明： 1. 传感器产生VSYNC，触发DMA从传感器读取一行数据到描述符指定的缓冲区。 2. DMA完成一帧传输后，产生中断，中断处理函数记录时间戳并调度tasklet。 3. Tasklet调用vb2_buffer_done()，将缓冲区状态切换为DONE，并唤醒等待的poll()。 4. 用户空间通过DQBUF获取已完成帧，处理完后通过QBUF将缓冲区重新入队。 5. 驱动在QBUF中更新DMA描述符的目的地址，形成连续的环形采集。

4.5 中断上下文缓冲区管理的避坑指南

常见陷阱与解决方案：
  • 陷阱1：在中断中调用vb2_buffer_done() — 导致内核调度器在中断上下文中运行。解决方案：使用tasklet或workqueue推迟调用。
  • 陷阱2：DMA描述符链未使用内存屏障 — 导致硬件读到过时的描述符指针。解决方案：在更新描述符后添加 wmb() 或 dma_wmb()。
  • 陷阱3：中断中访问vb2缓冲区时未加锁 — 多核同时访问同一缓冲区导致状态混乱。解决方案：使用 spin_lock_irqsave() 保护共享的缓冲区列表。
  • 陷阱4：忽略中断亲和性设置 — 中断在不同核心间迁移，导致缓存频繁失效。解决方案：在probe函数中设置 irq_set_affinity_hint()。

4.6 本章小结

中断上下文中的V4L2缓冲区管理是驱动性能的核心。通过将帧获取操作分解为中断上半部（记录时间戳、调度下半部）和下半部（调用vb2接口），可以确保系统在高压视频流下保持实时响应。DMA描述符链与中断完成回调的配合，实现了零CPU干预的连续帧采集，而多核负载均衡策略则进一步提升了系统的可扩展性。掌握这些技术，是编写生产级V4L2驱动的必备技能。

← 上一章 📖 返回目录 下一章 →