3. Linux DMA 子系统架构：dmaengine 框架概述

在嵌入式 Linux 系统中，DMA（Direct Memory Access）控制器是连接内存与外设、外设与外设之间高速数据搬运的核心硬件。为了统一管理不同厂商、不同型号的 DMA 控制器，内核提供了 dmaengine 子系统框架。本章将深入剖析 dmaengine 的架构设计、核心数据结构、通道模型以及引擎注册流程，帮助读者建立从驱动开发视角理解 DMA 子系统的完整知识体系。

3.1 dmaengine 框架整体架构

dmaengine 框架位于内核 drivers/dma/ 目录下，采用三层分层结构：

• 底层：DMA 控制器驱动 —— 实现具体硬件（如 PL330、EDMA、SDMA）的初始化、通道管理、描述符处理。
• 中间层：dmaengine 核心 —— 提供统一的注册、注销、通道申请、描述符提交等基础设施。
• 上层：DMA 引擎用户 —— 包括 ALSA、MMC、SPI、UART 等子系统，通过 dma_request_channel() 等 API 使用 DMA 服务。

3.2 dma_device 结构体：DMA 控制器的抽象

每个 DMA 控制器在 dmaengine 框架中对应一个 struct dma_device 实例。该结构体定义在 include/linux/dmaengine.h 中，是 DMA 控制器驱动的核心描述符。它包含了控制器的能力、操作函数指针、通道列表等关键信息。

3.3 dma_chan 通道模型：数据传输的载体

struct dma_chan 是 dmaengine 框架中代表一个 DMA 通道的核心结构体。每个物理 DMA 通道对应一个 dma_chan 实例。通道模型的设计遵循“申请-配置-使用-释放”的生命周期管理。

3.3.1 dma_chan 结构体关键字段

3.3.2 通道状态机

一个 DMA 通道在其生命周期中会经历以下状态：

1. 空闲（IDLE） —— 通道未被任何客户端使用，等待分配。
2. 已分配（ALLOCATED） —— 通过 dma_request_channel() 成功申请，但尚未配置传输参数。
3. 已配置（CONFIGURED） —— 调用 dmaengine_slave_config() 设置了源/目的地址、宽度、突发大小等参数。
4. 传输中（IN_PROGRESS） —— 描述符已提交并下发到硬件，DMA 正在搬运数据。
5. 已完成（COMPLETED） —— 传输完成，等待回调通知或轮询查询。

3.4 DMA 引擎注册流程

将一个新的 DMA 控制器驱动注册到 dmaengine 框架中，需要遵循以下标准流程。该流程通常在驱动的 probe() 函数中完成。

3.4.1 注册步骤

1. 分配并初始化 dma_device —— 使用 kzalloc 分配 struct dma_device，并填充 dev、cap_mask 等字段。
2. 初始化通道链表 —— 调用 INIT_LIST_HEAD(&dma_dev->channels)。
3. 创建并初始化每个 dma_chan —— 为每个物理通道分配 struct dma_chan，设置 device 指针和 chan_id，并添加到 channels 链表。
4. 设置能力位图 —— 通过 dma_cap_set() 宏设置控制器支持的能力（如 DMA_SLAVE、DMA_MEMCPY）。
5. 实现并赋值操作函数指针 —— 包括 device_alloc_chan_resources、device_prep_slave_sg、device_issue_pending 等。
6. 调用 dma_async_device_register() —— 将填充好的 dma_device 注册到内核 dmaengine 核心。
7. 错误处理与清理 —— 如果注册失败，释放已分配的资源。

3.4.2 注册代码模板

static int my_dma_probe(struct platform_device *pdev)
{
    struct dma_device *dma_dev;
    struct my_dma_chan *my_chan;
    int ret, i;

    // 1. 分配 dma_device
    dma_dev = kzalloc(sizeof(*dma_dev), GFP_KERNEL);
    if (!dma_dev)
        return -ENOMEM;

    // 2. 初始化通道链表
    INIT_LIST_HEAD(&dma_dev->channels);

    // 3. 创建并添加通道
    for (i = 0; i < NR_CHANNELS; i++) {
        my_chan = kzalloc(sizeof(*my_chan), GFP_KERNEL);
        if (!my_chan) {
            ret = -ENOMEM;
            goto err_chan;
        }
        my_chan->chan.device = dma_dev;
        my_chan->chan.chan_id = i;
        // 将通道加入链表
        list_add_tail(&my_chan->chan.device_node, &dma_dev->channels);
    }

    // 4. 设置能力位图
    dma_cap_set(DMA_SLAVE, dma_dev->cap_mask);
    dma_cap_set(DMA_CYCLIC, dma_dev->cap_mask);

    // 5. 实现操作函数
    dma_dev->device_alloc_chan_resources = my_alloc_chan_resources;
    dma_dev->device_free_chan_resources  = my_free_chan_resources;
    dma_dev->device_prep_slave_sg        = my_prep_slave_sg;
    dma_dev->device_issue_pending        = my_issue_pending;
    dma_dev->device_tx_status            = my_tx_status;
    dma_dev->dev                         = &pdev->dev;

    // 6. 注册到 dmaengine 核心
    ret = dma_async_device_register(dma_dev);
    if (ret) {
        dev_err(&pdev->dev, "Failed to register DMA engine\n");
        goto err_reg;
    }

    platform_set_drvdata(pdev, dma_dev);
    dev_info(&pdev->dev, "DMA engine registered successfully\n");
    return 0;

err_reg:
err_chan:
    // 清理已分配的通道和 dma_device
    // ... (省略具体清理代码)
    kfree(dma_dev);
    return ret;
}

3.5 关键数据结构关系总结

为了帮助读者建立整体认知，下表总结了 dma_device、dma_chan 和 dma_async_tx_descriptor 三者之间的关系：