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

Linux内核的DMA引擎（dmaengine）子系统为设备驱动开发者提供了一套统一的、与硬件无关的DMA传输控制接口。它屏蔽了不同SoC厂商（如TI、NXP、Xilinx、Intel）DMA控制器的寄存器级差异，使得上层驱动（如音频、网络、存储）可以以标准化的方式发起和完成DMA传输。

2.1 dma_device 结构体：DMA控制器的能力描述

dma_device 是DMA引擎驱动的核心注册结构体，每个DMA控制器实例对应一个 dma_device。它向dmaengine核心层声明该控制器支持哪些传输类型、通道数量、对齐要求以及硬件能力。

2.2 dma_chan 结构体：传输通道的抽象

dma_chan 代表一个具体的DMA通道。客户端驱动通过 dma_request_channel() 获取一个可用通道，之后所有传输操作都通过该通道进行。

struct dma_chan {
    struct dma_device *device;      /* 所属的DMA控制器 */
    dma_cookie_t cookie;            /* 当前传输的cookie标识 */
    struct list_head global_node;   /* 全局通道链表节点 */
    struct list_head device_node;   /* 所属dma_device的通道链表节点 */
    void *private;                  /* 客户端驱动的私有数据指针 */
    int chan_id;                    /* 通道ID，用于调试和标识 */
    struct dma_chan_dev *dev;       /* 通道对应的字符设备，用于sysfs */
};

通道的生命周期管理遵循以下流程：

1. 请求通道： 客户端调用 dma_request_channel(mask, filter_fn, filter_param)，核心层遍历所有注册的 dma_device，调用过滤函数匹配通道。
2. 配置通道： 通过 dmaengine_slave_config() 设置源/目的地址、数据宽度、突发长度等参数。
3. 使用通道： 准备描述符、提交、触发传输。
4. 释放通道： 传输完成后调用 dma_release_channel() 归还通道。

2.3 dma_async_tx_descriptor 结构体：传输事务的描述

每次DMA传输操作都被抽象为一个 dma_async_tx_descriptor 结构体。它描述了“从哪里传到哪里、传多少、传完后做什么”。客户端驱动通过 device_prep_* 系列回调获取描述符，然后提交并触发执行。

struct dma_async_tx_descriptor {
    dma_cookie_t cookie;                /* 传输的cookie，用于跟踪状态 */
    enum dma_ctrl_flags flags;          /* 控制标志：DMA_PREP_INTERRUPT等 */
    struct dma_chan *chan;              /* 所属通道 */
    dma_async_tx_callback callback;     /* 传输完成回调函数 */
    void *callback_param;               /* 回调参数 */
    struct list_head tx_list;           /* 用于链式传输的链表节点 */
    struct dmaengine_unmap_data *unmap; /* 用于DMA一致性映射管理 */
    /* 引擎驱动私有数据区域 */
};

2.4 三个结构体的协作关系

在典型的DMA传输流程中，三个结构体协同工作：