DRM PRIME跨设备DMA-BUF共享驱动开发 - 第1节

1.1 DMA-BUF 是什么

DMA-BUF（Direct Memory Access Buffer）是 Linux 内核提供的一种跨设备、跨驱动共享 DMA 缓冲区的框架。它允许不同设备驱动程序之间高效地共享物理内存，而无需进行多余的数据拷贝。DMA-BUF 的核心思想是将一块物理内存抽象为一个缓冲区对象，并通过文件描述符（fd）在进程间或驱动间传递。

1.1.1 核心数据结构

1.1.2 生命周期流程

1. 分配：导出驱动分配物理内存（如通过 dma_alloc_coherent 或 GEM 对象）。
2. 导出：调用 dma_buf_export() 创建 struct dma_buf 并获取文件描述符。
3. 传递：通过文件描述符将缓冲区句柄传递给导入驱动或用户空间。
4. 导入：导入驱动调用 dma_buf_get() 获取 struct dma_buf 指针。
5. 绑定：调用 dma_buf_attach() 将设备与缓冲区绑定。
6. 映射：调用 dma_buf_map_attachment() 获取 sg_table 进行 DMA 操作。
7. 解绑与释放：操作完成后依次调用 dma_buf_unmap_attachment()、dma_buf_detach()、dma_buf_put()。

1.2 为什么需要 DMA-BUF

在嵌入式图形系统中，多个硬件设备（GPU、显示控制器、视频编解码器、相机 ISP）需要频繁访问同一块帧缓冲或图像数据。传统方案存在以下痛点：

• 数据拷贝开销：设备间通过 CPU 拷贝数据，消耗带宽和功耗，降低实时性。
• 内存碎片化：每个驱动独立分配内存，无法复用，导致内存浪费。
• 缓存一致性问题：不同设备对缓存一致性要求不同，缺乏统一管理机制。
• 缺少标准化接口：各厂商自行实现私有共享方案，代码不可移植。

1.2.1 传统方案 vs DMA-BUF 方案

1.3 DMA-BUF 在图形栈中的角色

在 Linux 图形栈中，DMA-BUF 是连接 DRM/KMS、GPU、V4L2、ALSA 等子系统的关键纽带。它实现了从图像生成到显示输出的全链路零拷贝。

1.3.1 图形栈分层架构

1.3.2 典型应用场景

• GPU 渲染 → 显示输出：GPU 渲染完成后，将 GEM 对象导出为 DMA-BUF，直接传递给 DRM/KMS 的 framebuffer，无需拷贝。
• 视频解码 → 显示：V4L2 解码器输出帧导出为 DMA-BUF，KMS 直接扫描显示，实现零拷贝视频播放。
• 相机预览 → 编码：ISP 输出帧通过 DMA-BUF 同时传递给显示控制器和视频编码器，实现预览与录制并行。
• GPU 合成 → 编码：合成后的帧通过 DMA-BUF 传递给硬件编码器，用于屏幕录制或直播推流。

1.3.3 与 DRM 子系统的关系

在 DRM 框架中，DMA-BUF 通过 drm_prime 模块与 GEM（Graphics Execution Manager）深度集成：

1.3.4 实际代码示例

以下是一个简化的 DRM 驱动导出 GEM 对象为 DMA-BUF 的核心流程：

// 导出端：将 GEM 对象导出为 DMA-BUF
struct dma_buf *my_gem_prime_export(struct drm_gem_object *obj, int flags)
{
    struct dma_buf_export_info exp_info = {
        .exp_name = KBUILD_MODNAME,
        .owner = THIS_MODULE,
        .ops = &my_dma_buf_ops,   // 自定义 dma_buf_ops
        .size = obj->size,
        .flags = flags,
        .priv = obj,              // 私有数据指向 GEM 对象
    };
    return dma_buf_export(&exp_info);
}

// 导入端：从 DMA-BUF 创建 GEM 对象
struct drm_gem_object *my_gem_prime_import(struct drm_device *dev,
                                           struct dma_buf *dma_buf)
{
    struct dma_buf_attachment *attach;
    struct sg_table *sgt;
    struct drm_gem_object *obj;

    attach = dma_buf_attach(dma_buf, dev->dev);
    if (IS_ERR(attach))
        return ERR_CAST(attach);

    sgt = dma_buf_map_attachment(attach, DMA_BIDIRECTIONAL);
    if (IS_ERR(sgt)) {
        dma_buf_detach(dma_buf, attach);
        return ERR_CAST(sgt);
    }

    // 将 sg_table 转换为驱动私有的 GEM 对象
    obj = my_gem_create_from_sgt(dev, sgt);

    dma_buf_unmap_attachment(attach, sgt, DMA_BIDIRECTIONAL);
    dma_buf_detach(dma_buf, attach);
    dma_buf_put(dma_buf);

    return obj;
}