3. 设备树基础回顾：设备树语法、节点与属性、reg属性、interrupts属性、compatible属性

设备树（Device Tree）是一种描述硬件资源的数据结构，它通过节点（node）和属性（property）的层级关系，将非可枚举的硬件细节传递给操作系统内核。在嵌入式 Linux 中，设备树是 DMA 控制器及其通道配置的载体，也是 DMA Engine 驱动与硬件交互的桥梁。本节将系统回顾设备树的核心语法与关键属性，为后续 DMA 控制器节点编写与驱动解析打下基础。

3.1 设备树基本语法与节点结构

设备树源文件（.dts）采用树形结构，每个硬件设备对应一个节点，节点内包含描述设备特征的属性。节点从根节点 / 开始，通过路径唯一标识。

[label:] node-name[@unit-address] {
    [property = value;]
    [child-node {
        ...
    }];
};

• label：可选标签，用于在其它节点中引用（如 &dma0）。
• node-name：节点名称，通常为通用设备类型（如 dma-controller）。
• unit-address：设备在总线上的地址，与 reg 属性第一项对应。
• 属性：键值对，值可以是字符串、整数、数组、二进制数据或 phandle（指向其它节点的指针）。

3.2 核心属性详解

3.2.1 compatible 属性

compatible 是设备树中最关键的属性，用于将设备节点与内核驱动进行匹配。其值为字符串列表，按优先级从高到低排列，格式为 "厂商,设备型号"。

// 设备树节点
dma: dma-controller@1e000 {
    compatible = "ti,am335x-edma", "ti,edma3";
    reg = <0x1e000 0x1000>;
    interrupts = <0 12 4>;
};

// 内核驱动匹配表
static const struct of_device_id edma_of_match[] = {
    { .compatible = "ti,am335x-edma", .data = &edma_data },
    { .compatible = "ti,edma3",       .data = &edma3_data },
    { /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, edma_of_match);

3.2.2 reg 属性

reg 属性描述设备在总线上的地址空间，由一组或多组 <地址 长度> 对组成。对于 DMA 控制器，通常描述寄存器基地址和映射范围。

• 地址：物理地址，位数由父节点的 #address-cells 决定。
• 长度：地址空间大小，位数由父节点的 #size-cells 决定。
• 多组 reg：当设备有多个不连续的地址块时，可依次列出。

3.2.3 interrupts 属性

interrupts 属性描述设备的中断请求线，其格式由父节点或 interrupt-parent 指定的中断控制器决定。通常包含中断号、中断触发类型等字段。

// 中断控制器定义
intc: interrupt-controller@48200000 {
    compatible = "ti,am33xx-intc";
    interrupt-controller;
    #interrupt-cells = <3>;  // 中断域：中断类型、中断号、触发类型
};

// 使用中断的设备节点
dma: dma-controller@1e000 {
    interrupt-parent = <&intc>;  // 引用中断控制器
    interrupts = <0 12 4>;       // 0=SPI, 12=中断号, 4=高电平触发
};

3.3 设备树在 DMA 驱动中的角色

设备树为 DMA Engine 驱动提供了硬件拓扑描述，驱动通过 OF（Open Firmware）API 解析节点，获取寄存器地址、中断号、通道数量、传输类型等关键参数。

3.4 常见设备树属性速查表