3. dmaengine API详解（上）：通道申请与释放流程

在DMA驱动开发中，通道（Channel）是数据传输的核心抽象。dmaengine框架提供了标准化的API用于通道的申请、配置与释放。本章聚焦于dma_request_channel、dma_release_channel和dma_get_slave_channel三个关键接口，深入剖析其内部机制与使用规范。

3.1 核心API速览

下表列出了本章涉及的三个核心API及其功能定位：

3.2 dma_request_channel：通用通道申请

dma_request_channel 是dmaengine框架中最常用的通道申请接口。它允许调用者通过掩码（mask）和过滤函数（filter_fn）来精确选择所需的DMA通道。

3.2.1 函数原型

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

3.2.2 参数详解

3.2.3 典型使用示例

#include <linux/dmaengine.h>

dma_cap_mask_t mask;
struct dma_chan *chan;

/* 初始化掩码并设置DMA_SLAVE能力 */
dma_cap_zero(mask);
dma_cap_set(DMA_SLAVE, mask);

/* 申请通道：过滤函数为NULL表示接受任意匹配掩码的通道 */
chan = dma_request_channel(&mask, NULL, NULL);
if (IS_ERR_OR_NULL(chan)) {
    pr_err("Failed to request DMA channel\n");
    return -ENODEV;
}

/* 使用通道... */

/* 释放通道 */
dma_release_channel(chan);

3.3 dma_release_channel：通道释放

通道使用完毕后，必须调用 dma_release_channel 归还资源。该函数会执行以下操作：

• 检查通道是否正在使用中（如有未完成的传输，会打印警告）
• 将通道状态标记为可用
• 将通道归还到DMA控制器的空闲通道池
• 减少通道的引用计数

3.3.1 函数原型

void dma_release_channel(struct dma_chan *chan);

3.4 dma_get_slave_channel：从设备专用通道获取

dma_get_slave_channel 与 dma_request_channel 不同，它用于获取一个已经预绑定到特定从设备的通道。该API通常在DMA控制器驱动的 device_alloc_chan_resources 回调内部使用，或者由已经通过其他方式获得通道引用的代码调用。

3.4.1 函数原型

struct dma_chan *dma_get_slave_channel(struct dma_chan *chan);

3.4.2 使用场景

• DMA控制器驱动内部：在 of_dma_simple_xlate 等翻译函数中，根据设备树解析出的通道索引获取对应的通道
• 通道复用：当多个子系统共享同一个物理DMA通道时，通过该API增加引用计数

3.4.3 与 dma_request_channel 的对比

3.5 通道申请与释放完整流程

下图展示了从设备驱动申请DMA通道到最终释放的完整生命周期：

3.6 通道生命周期管理最佳实践

1. 申请时机：在设备 probe() 函数中申请通道，在 remove() 中释放
2. 错误处理：始终检查 dma_request_channel 的返回值，使用 IS_ERR_OR_NULL() 宏
3. 过滤函数：对于多通道DMA控制器，务必提供过滤函数以绑定正确的硬件通道
4. 引用计数：使用 dma_get_slave_channel 时，记得配对调用 dma_release_channel
5. 调试接口：通过 /sys/kernel/debug/dmaengine/channels 查看当前通道分配状态

3.7 常见问题与避坑指南