1. 课程导论：DMA-BUF 与 PRIME 概念、为什么需要跨设备共享内存、DRM 与 V4L2 生态概述
1.1 为什么需要跨设备共享内存？
在嵌入式多媒体系统中，数据流通常需要经过多个硬件单元：摄像头传感器 → ISP（图像信号处理器） → GPU（图形处理器） → 显示控制器。传统方案中，每个硬件单元各自分配独立的内存缓冲区，数据通过 CPU 逐帧拷贝从一个设备传递到下一个设备。这种“拷贝传递”模式存在三大瓶颈：
- 带宽浪费：以 1080p@60fps 的 YUV420 帧为例，每帧约 3 MB，每秒拷贝 180 MB 数据，消耗大量系统总线带宽。
- 延迟增加：每次拷贝引入至少 2 次 DMA 传输延迟（读+写），导致端到端延迟从微秒级恶化到毫秒级。
- 功耗上升：频繁的内存拷贝使 CPU 和内存控制器处于高负载状态，对电池供电的嵌入式设备极不友好。
核心诉求：让 V4L2 摄像头采集的帧缓冲区，能被 DRM/KMS 显示引擎或 GPU 直接访问，实现“零拷贝”流水线。
1.2 DMA-BUF 与 PRIME 概念
DMA-BUF 是 Linux 内核提供的一种 跨设备、跨驱动、跨子系统 的共享内存机制。它允许一个设备驱动导出（export）其分配的物理内存缓冲区，生成一个全局的文件描述符（fd），其他设备驱动可以导入（import）这个 fd，获得对同一块物理内存的访问权。
PRIME 是 DRM 子系统对 DMA-BUF 的封装实现，提供标准化的 ioctl 接口：DRM_IOCTL_PRIME_HANDLE_TO_FD 和 DRM_IOCTL_PRIME_FD_TO_HANDLE。
| 概念 | 角色 | 关键操作 |
|---|---|---|
| DMA-BUF | 内核级共享内存抽象层 | dma_buf_export() / dma_buf_attach() / dma_buf_map_attachment() |
| PRIME | DRM 子系统的 DMA-BUF 封装 | DRM_IOCTL_PRIME_HANDLE_TO_FD / DRM_IOCTL_PRIME_FD_TO_HANDLE |
| Exporter（导出者） | 分配物理内存并生成 fd 的一方 | 提供 struct dma_buf_ops 回调 |
| Importer（导入者） | 通过 fd 获取内存访问权的一方 | 调用 dma_buf_get() + dma_buf_map_attachment() |
关键理解：DMA-BUF 本身不分配内存，它只是一个“包装器”，包装由 exporter 驱动管理的物理内存。exporter 负责内存的分配和生命周期管理，importer 只获得访问权。
1.3 DRM 与 V4L2 生态概述
1.3.1 DRM (Direct Rendering Manager) 生态
DRM 是 Linux 内核中负责图形显示和 GPU 管理的子系统。其核心组件包括：
- KMS (Kernel Mode Setting)：管理显示控制器、CRTC、Encoder、Connector、Plane 等显示管线资源。
- GEM (Graphics Execution Manager)：提供图形缓冲区分配和管理框架，是 PRIME 的基础。
- PRIME：在 GEM 之上实现跨设备缓冲区共享，是 DRM 与 V4L2 互操作的桥梁。
1.3.2 V4L2 (Video for Linux 2) 生态
V4L2 是 Linux 内核中负责视频采集、输出和处理的子系统。其核心组件包括：
- Video Capture：从摄像头、HDMI 采集卡等设备获取视频帧。
- Video Output：向显示设备或编码器输出视频帧。
- M2M (Memory-to-Memory)：编解码器、图像处理加速器等设备的数据处理。
- V4L2 Buffer I/O 模型：支持 MMAP、USERPTR、DMABUF 三种缓冲区访问模式。
| 特性 | DRM 子系统 | V4L2 子系统 |
|---|---|---|
| 主要用途 | 图形显示、GPU 渲染 | 视频采集、编解码、输出 |
| 缓冲区管理 | GEM + PRIME | V4L2 Buffer (MMAP/USERPTR/DMABUF) |
| 共享机制 | PRIME (DMA-BUF 封装) | V4L2 DMABUF I/O 模式 |
| 用户空间接口 | /dev/dri/card0 + libdrm |
/dev/video0 + libv4l2 |
| 典型设备 | GPU、Display Controller | Camera、ISP、Codec |
1.4 零拷贝流水线：从摄像头到屏幕
通过 DMA-BUF PRIME 机制，典型的嵌入式相机预览流水线可以简化为：
- V4L2 采集：摄像头驱动分配物理内存，采集帧数据写入缓冲区。
- 导出 DMA-BUF：V4L2 驱动通过
VIDIOC_EXPBUFioctl 导出缓冲区，返回一个 DMA-BUF fd。 - 传递 fd：用户空间将 fd 传递给 DRM 显示应用（如 Weston、KWin）。
- 导入 DRM：DRM 驱动通过
DRM_IOCTL_PRIME_FD_TO_HANDLE导入 fd，获得 GEM handle。 - 直接显示：将 GEM handle 绑定到 KMS Plane，显示控制器直接从同一块物理内存读取数据送显。
注意事项：跨设备共享内存时，必须考虑缓存一致性（Cache Coherency）问题。ARM 架构下通常需要调用
dma_buf_begin_cpu_access() / dma_buf_end_cpu_access() 或使用 IOMMU 进行地址映射同步。
1.5 本课程学习路径
本课程将从实战角度出发，带领学员完成以下关键环节：
| 章节 | 核心内容 | 实战目标 |
|---|---|---|
| 第 1 章 | DMA-BUF / PRIME 概念与生态 | 理解跨设备共享内存的必要性 |
| 第 2-5 章 | V4L2 DMABUF 导出流程 | 编写 V4L2 exporter 驱动 |
| 第 6-10 章 | DRM PRIME 导入流程 | 编写 DRM importer 驱动 |
| 第 11-15 章 | 用户空间应用集成 | GStreamer / libdrm 实战 |
| 第 16-20 章 | 性能优化与调试 | 延迟分析、缓存同步、IOMMU 配置 |
| 第 21-30 章 | 综合项目实战 | 零拷贝相机预览流水线 |
预备知识：建议学员具备 Linux 内核驱动开发基础、熟悉字符设备驱动模型、了解 V4L2 和 DRM 的基本 ioctl 操作。本课程将提供完整的实验环境搭建指南。