4. UART DMA设备树配置：dmas与dma-names属性详解、DMA通道与UART端口绑定、中断号配置

在全志T113平台上，要使UART驱动工作在DMA模式，设备树（Device Tree）的配置是核心环节。错误的配置将导致DMA传输失败、数据错乱甚至系统崩溃。本节将深入解析dmas、dma-names属性的语法规则，阐明DMA通道与UART端口的绑定逻辑，并说明中断号的配置要点。

4.1 dmas属性详解：DMA通道描述符

dmas属性是一个phandle数组，用于描述UART外设所连接的DMA控制器及通道参数。其标准格式如下：

dmas = <dma_controller_phandle dma_channel_id dma_request_id>,
       <dma_controller_phandle dma_channel_id dma_request_id>;

每个三元组代表一个DMA通道的描述：

以UART0为例，正确的dmas配置如下：

&uart0 {
    pinctrl-names = "default";
    pinctrl-0 = <&uart0_pins>;
    status = "okay";

    dmas = <&dma 2 14>,   /* RX通道：使用DMA通道2，请求线14 */
           <&dma 3 15>;   /* TX通道：使用DMA通道3，请求线15 */
    dma-names = "rx", "tx";
};

4.2 dma-names属性详解：通道语义映射

dma-names属性是一个字符串列表，为dmas中的每个通道赋予语义名称。驱动代码通过名称来获取对应的DMA通道资源，而不是依赖数组索引。这种设计提高了代码的可读性和可维护性。

dma-names = "rx", "tx";

名称与dmas数组中的顺序一一对应：

4.3 DMA通道与UART端口绑定机制

DMA通道与UART端口的绑定分为静态绑定和动态分配两种模式。T113的DMA控制器支持动态分配，但设备树配置通常采用静态指定以确保确定性。

绑定流程如下：

1. 设备树解析阶段：内核解析dmas属性，获取DMA控制器phandle、通道ID和请求线ID。
2. DMA引擎注册：DMA控制器驱动向内核注册DMA通道池。
3. 通道请求：UART驱动调用dma_request_slave_channel()，根据dma-names请求通道。
4. 请求线映射：DMA引擎根据请求线ID配置硬件路由，将UART的FIFO事件连接到指定的DMA通道。
5. 通道确认：UART驱动获得dma_chan结构体指针，完成绑定。

4.4 中断号配置

即使UART工作在DMA模式，中断配置仍然必不可少。DMA模式下的中断分为两类：

UART节点的中断配置示例：

&uart0 {
    interrupt-parent = <&gic>;       /* 中断控制器：GIC */
    interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>;
    /* GIC_SPI: 共享外设中断类型
       32: UART0的中断号（T113硬件分配）
       IRQ_TYPE_LEVEL_HIGH: 高电平触发 */
};

4.5 完整配置示例与验证

以下是一个完整的UART0 DMA模式设备树配置：

&uart0 {
    pinctrl-names = "default";
    pinctrl-0 = <&uart0_pins>;
    status = "okay";

    /* DMA配置 */
    dmas = <&dma 2 14>,   /* RX: DMA通道2, 请求线14 */
           <&dma 3 15>;   /* TX: DMA通道3, 请求线15 */
    dma-names = "rx", "tx";

    /* 中断配置 */
    interrupt-parent = <&gic>;
    interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>;

    /* 可选：DMA缓冲区大小配置 */
    dma-rx-buffer-size = <4096>;
    dma-tx-buffer-size = <4096>;
};

配置完成后，可以通过以下方式验证DMA是否生效：

1. 查看内核启动日志：搜索"uart0: DMA mode enabled"或类似信息。
2. 检查DMA通道状态：cat /sys/kernel/debug/dmaengine/channels查看通道分配情况。
3. 性能测试：使用dd或自定义程序进行大数据量收发，对比CPU占用率。

4.6 常见配置错误与排查