3. DMA驱动核心数据结构：struct dma_device、struct dma_chan、struct dma_async_tx_descriptor详解

在Linux DMA引擎（dmaengine）框架中，驱动开发的核心是理解并正确使用三个关键数据结构：struct dma_device（DMA控制器抽象）、struct dma_chan（DMA通道抽象）和struct dma_async_tx_descriptor（传输描述符）。它们构成了从硬件控制器到上层用户请求的完整抽象链。

3.1 struct dma_device：DMA控制器的软件抽象

struct dma_device 代表一个物理DMA控制器（如PL330、Intel IOAT、TI EDMA等）。它注册到内核的dmaengine核心，并暴露控制器能力与操作函数集。

3.2 struct dma_chan：通道资源与状态管理

struct dma_chan 是DMA通道的运行时抽象。每个物理DMA通道对应一个 dma_chan 实例，它连接了控制器、传输描述符队列和上层使用者。

struct dma_chan {
    struct dma_device *device;      // 所属DMA控制器
    dma_cookie_t cookie;            // 当前传输的cookie（用于状态查询）
    struct list_head global_node;   // 全局通道链表节点
    struct list_head free_node;     // 空闲通道链表节点
    struct list_head devices_node;  // 控制器内通道链表节点
    struct dma_chan_dev *dev;       // 字符设备，用于用户空间访问
    int chan_id;                    // 通道ID（在控制器内唯一）
    struct dma_slave_config slave_config; // 外设配置（地址、宽度、流控）
    void *private;                  // 驱动私有数据（硬件寄存器基址等）
};

3.3 struct dma_async_tx_descriptor：传输任务的完整描述

这是每次DMA传输请求的“任务单”。它描述了源地址、目的地址、传输长度、回调函数以及依赖关系。dmaengine框架通过它实现异步传输和链式操作。

struct dma_async_tx_descriptor {
    dma_cookie_t cookie;                    // 传输cookie
    enum dma_ctrl_flags flags;              // 控制标志（DMA_PREP_INTERRUPT等）
    dma_addr_t src;                         // 源物理地址（MEMCPY模式）
    dma_addr_t dst;                         // 目的物理地址（MEMCPY模式）
    size_t len;                             // 传输字节数
    struct dma_async_tx_descriptor *next;   // 链式传输中的下一个描述符
    struct dma_chan *chan;                  // 所属通道
    dma_async_tx_callback callback;         // 传输完成回调函数
    void *callback_param;                   // 回调参数
    struct list_head tx_list;               // 用于挂载到通道的提交队列
    enum dma_status status;                 // 传输状态
};

3.4 三者关系与数据流

下图展示了从控制器注册到一次DMA传输完成的完整数据流与结构体关系：

3.5 驱动开发中的典型操作序列

1. 注册阶段： 填充 dma_device 的 cap_mask 和所有 device_* 回调，调用 dma_async_device_register()。
2. 通道分配： 核心调用 device_alloc_chan_resources，驱动分配硬件描述符池并初始化 chan->private。
3. 传输准备： 上层调用 device_prep_slave_sg，驱动分配 dma_async_tx_descriptor，填充源/目的地址、长度、回调函数。
4. 提交与触发： 调用 dmaengine_submit() 将描述符加入通道队列，再调用 device_issue_pending 触发硬件启动。
5. 完成处理： 硬件产生中断，驱动在中断处理中调用 dma_cookie_complete() 标记完成，并执行描述符中的 callback。

3.6 三个结构体的协作总结