4、设备树DMA绑定：dmas与dma-names属性解析、DMA通道与中断关联、DMA引擎节点配置

设备树（Device Tree）是嵌入式Linux系统中描述硬件拓扑的核心手段。对于DMA控制器及其外设客户端，设备树通过标准化的绑定属性将DMA通道、中断信号和传输配置暴露给内核驱动。本章深入解析dmas、dma-names属性，梳理DMA通道与中断的关联逻辑，并给出DMA引擎节点的完整配置范例。

4.1 dmas与dma-names属性解析

在设备树中，任何需要DMA服务的外设节点（如UART、SPI、I2S）都必须通过dmas属性声明其使用的DMA通道，并通过dma-names属性为每个通道赋予语义名称。这两个属性共同构成了外设与DMA控制器之间的“软连接”。

以下是一个典型的UART设备节点DMA绑定示例：

uart0: serial@10000000 {
    compatible = "vendor,uart-ip";
    reg = <0x10000000 0x1000>;
    interrupts = <0 33 4>;
    dmas = <&dma0 2>, <&dma0 3>;
    dma-names = "rx", "tx";
    dma-coherent;
    status = "okay";
};

上述代码中：

• &dma0 2：表示使用dma0控制器的通道2，用于接收（rx）。
• &dma0 3：表示使用dma0控制器的通道3，用于发送（tx）。
• dma-coherent：可选属性，声明外设与CPU之间DMA操作是缓存一致的，避免驱动额外执行缓存刷新操作。

4.2 DMA通道与中断关联

DMA传输的完成、错误或半传输事件通常通过中断通知CPU。在设备树中，DMA通道与中断的关联有两种常见模式：

在外设中断模式下，DMA传输完成后，DMA控制器通过硬件握手信号通知外设，外设再向中断控制器提交中断。此时设备树中只有外设节点包含interrupts属性，DMA控制器节点通常不暴露通道中断。

在DMA控制器中断模式下，每个DMA通道在DMA控制器内部有独立的中断线。设备树中DMA控制器节点会定义interrupts属性，每个中断对应一个通道或一组通道。外设节点通过dmas引用通道时，中断关联由DMA引擎驱动在内部建立。

以下SVG图展示了两种中断关联模式的拓扑对比：

4.3 DMA引擎节点配置

DMA引擎节点（DMA控制器本身）的设备树配置决定了通道数量、中断映射、时钟和复位控制等底层参数。一个完整的DMA控制器节点通常包含以下关键属性：

以下是一个完整的DMA引擎节点配置示例：

dma0: dma-controller@20000000 {
    compatible = "vendor,dma-engine";
    reg = <0x20000000 0x1000>;
    interrupts = <0 0 4>, <0 1 4>, <0 2 4>, <0 3 4>;
    interrupt-names = "ch0", "ch1", "ch2", "ch3";
    #dma-cells = <1>;
    dma-channels = <4>;
    clocks = <&clk_dma>;
    resets = <&rst_dma>;
    dma-coherent;
    status = "okay";
};

配置要点说明：

• #dma-cells = <1>：表示外设在dmas属性中引用此控制器时，phandle后只需1个参数（通道号）。如果DMA控制器需要更多参数（如请求线、优先级），则#dma-cells值相应增加。
• interrupt-names：为每个中断指定名称，便于驱动通过platform_get_irq_byname()获取特定通道的中断号。
• dma-channels：声明硬件通道数量，驱动据此初始化通道描述符数组。

以下SVG图展示了DMA引擎节点与外设节点之间的绑定关系：