DMA性能分析 Linux驱动高吞吐传输调试与优化 - 第4节

4.1 DMA 通道的申请与释放：dma_request_channel / dma_release_channel

在 Linux DMA 引擎框架中，DMA 通道（channel）是执行数据传输的核心抽象。驱动必须首先向 DMA 引擎申请一个可用通道，才能发起传输。本节详细解析通道的申请与释放 API，以及背后的资源管理机制。

4.1.1 dma_request_channel：通道申请

dma_request_channel 用于从指定的 DMA 控制器（DMA controller）中获取一个满足特定能力的通道。其原型如下：

struct dma_chan *dma_request_channel(dma_cap_mask_t mask,
                                     dma_filter_fn filter_fn,
                                     void *filter_param);

典型调用流程：

1. 使用 dma_cap_mask_t 声明并初始化能力掩码。
2. 调用 dma_cap_set 设置所需能力位。
3. 调用 dma_request_channel 获取通道。
4. 检查返回值是否为 NULL（申请失败）。

4.1.2 dma_release_channel：通道释放

当驱动不再使用 DMA 通道时，必须调用 dma_release_channel 将其归还给系统，以便其他驱动复用。

void dma_release_channel(struct dma_chan *chan);

使用注意事项：

• 必须在所有未完成的 DMA 传输完成或终止后调用。
• 释放后，通道描述符指针变为悬空，不可再使用。
• 通常在驱动的 remove 回调或错误处理路径中调用。

4.1.3 通道生命周期 SVG 图

下图展示了从申请到释放的完整通道生命周期，以及各阶段的关键操作：

4.2 一致性 DMA 内存分配：dma_alloc_coherent

在 DMA 传输中，CPU 和设备需要共享内存缓冲区。dma_alloc_coherent 分配一段一致性（coherent）内存，保证 CPU 和设备看到的缓存一致性，无需手动维护缓存同步。

4.2.1 函数原型与参数

void *dma_alloc_coherent(struct device *dev, size_t size,
                         dma_addr_t *dma_handle, gfp_t flag);

返回值： 内核虚拟地址（CPU 访问），失败返回 NULL。

4.2.2 使用场景与限制

• 适用场景： 控制结构、描述符环、小数据块传输（如 USB 控制传输）。
• 性能特点： 分配时已保证一致性，读写无额外开销，但分配/释放成本较高。
• 大小限制： 通常用于分配较小缓冲区（几 KB 到几 MB），大块分配可能失败。

4.2.3 释放函数：dma_free_coherent

void dma_free_coherent(struct device *dev, size_t size,
                       void *cpu_addr, dma_addr_t dma_handle);

必须使用与分配时完全相同的 size、cpu_addr 和 dma_handle 进行释放。

4.2.4 一致性内存分配流程 SVG 图

4.3 DMA 内存池：dma_pool

当驱动需要频繁分配和释放大量固定大小的一致性 DMA 缓冲区时，直接使用 dma_alloc_coherent 会产生较高的开销。dma_pool 提供了一种预分配 + 复用的机制，显著提升小对象分配效率。

4.3.1 核心 API

4.3.2 dma_pool_create 参数详解

struct dma_pool *dma_pool_create(const char *name,
                                 struct device *dev,
                                 size_t size,
                                 size_t align,
                                 size_t boundary);

4.3.3 使用示例

struct dma_pool *pool;
void *cpu_addr;
dma_addr_t dma_addr;

// 创建对象大小为 64 字节、16 字节对齐、无边界限制的池
pool = dma_pool_create("my_dma_pool", dev, 64, 16, 0);
if (!pool) {
    dev_err(dev, "Failed to create DMA pool\n");
    return -ENOMEM;
}

// 从池中分配一个对象
cpu_addr = dma_pool_alloc(pool, GFP_KERNEL, &dma_addr);
if (!cpu_addr) {
    dev_err(dev, "Failed to allocate from DMA pool\n");
    dma_pool_destroy(pool);
    return -ENOMEM;
}

// ... 使用缓冲区 ...

// 释放对象回池
dma_pool_free(pool, cpu_addr, dma_addr);

// 销毁池
dma_pool_destroy(pool);

4.3.4 性能对比：dma_alloc_coherent vs dma_pool

4.3.5 DMA 内存池架构 SVG 图

4.4 本章小结

• dma_request_channel / dma_release_channel：管理 DMA 通道的生命周期，是驱动与 DMA 引擎交互的入口。
• dma_alloc_coherent / dma_free_coherent：分配一致性 DMA 内存，保证 CPU 和设备缓存一致性，适用于控制结构和小数据块。
• dma_pool：通过预分配和对象复用机制，大幅提升固定大小 DMA 缓冲区的分配效率，是高吞吐驱动中的关键优化手段。