1. 设备树基础：DTS 语法与关键属性详解

设备树（Device Tree，DT）是描述硬件拓扑与资源分配的一种树形数据结构，在 Linux 内核中用于将平台设备信息从 Bootloader 传递给内核，替代了传统的 board-*.c 硬编码方式。对于 DRM/GPU 驱动移植而言，设备树节点是驱动与硬件之间的“契约”——GPU 的寄存器基址、中断号、时钟、复位、电源域等信息全部通过设备树节点描述。

1.1 DTS 文件结构与基本语法

设备树源文件（.dts）采用树形缩进结构，每个节点以 节点名@地址 的形式定义，节点内包含属性和子节点。一个典型的 DTS 文件结构如下：

/dts-v1/;

/ {
    model = "My GPU Development Board";
    compatible = "vendor,board-rev1", "vendor,board";

    chosen {
        bootargs = "console=ttyS0,115200";
    };

    cpus {
        #address-cells = <1>;
        #size-cells = <0>;
        cpu@0 {
            compatible = "arm,cortex-a72";
            reg = <0x0>;
        };
    };

    memory@80000000 {
        device_type = "memory";
        reg = <0x80000000 0x40000000>;  /* 1GB RAM */
    };

    gpu: gpu@fbc00000 {
        compatible = "vendor,awesome-gpu", "simple-bus";
        reg = <0xfbc00000 0x10000>;
        interrupts = <0 42 4>;
        clocks = <&clkc 15>, <&clkc 16>;
        clock-names = "core", "mem";
        resets = <&rstc 7>;
        status = "okay";
    };
};

1.2 关键属性详解

设备树属性是节点携带的键值对，驱动通过解析这些属性获取硬件资源。下表列出 GPU 节点最常用的属性：

1.3 compatible 属性与驱动匹配机制

compatible 是设备树中最关键的属性，它建立了硬件节点与内核驱动之间的桥梁。内核在启动时遍历设备树，对每个节点的 compatible 值与驱动注册的 of_device_id 表进行匹配。

匹配优先级：列表中的第一个字符串优先级最高，后续字符串作为兼容降级。例如：

compatible = "vendor,awesome-gpu-v2", "vendor,awesome-gpu", "simple-bus";

内核会优先尝试匹配 "vendor,awesome-gpu-v2"，若没有驱动支持，则尝试 "vendor,awesome-gpu"，最后尝试 "simple-bus"。

1.4 reg 属性与地址空间描述

reg 属性描述设备占用的地址范围，格式为 <基址1 长度1 基址2 长度2 ...>。对于 GPU 节点，通常只有一个地址段（寄存器空间），但部分 GPU 可能包含多个独立地址区域（如控制寄存器 + 显存窗口）。

地址和长度的位数由父节点的 #address-cells 和 #size-cells 决定：

驱动中通过 platform_get_resource(pdev, IORESOURCE_MEM, 0) 获取第一个 reg 段对应的内存资源。

1.5 interrupts 属性与中断描述

GPU 通常需要处理多种中断：渲染完成、页面翻转（VBlank）、错误异常等。interrupts 属性描述设备使用的中断线，其格式由中断控制器的 #interrupt-cells 决定。

ARM GIC（Generic Interrupt Controller）的典型格式为 <中断类型 中断号 触发方式>：

示例：interrupts = <0 42 4>; 表示 SPI 类型、中断号 42、高电平触发。

1.6 时钟与复位属性

现代 GPU 通常需要多个时钟源（核心时钟、存储器时钟、总线时钟）和复位信号。设备树通过 clocks 和 resets 属性引用时钟/复位控制器中的特定输出。

gpu: gpu@fbc00000 {
    compatible = "vendor,awesome-gpu";
    reg = <0xfbc00000 0x10000>;
    interrupts = <0 42 4>;

    /* 时钟：clkc 是时钟控制器节点标签，15 和 16 是时钟输出索引 */
    clocks = <&clkc 15>, <&clkc 16>, <&clkc 17>;
    clock-names = "core", "mem", "bus";

    /* 复位：rstc 是复位控制器节点标签，7 是复位输出索引 */
    resets = <&rstc 7>;
    reset-names = "gpu";

    /* 电源域：引用 power-controller 节点 */
    power-domains = <&pd_gpu>;

    status = "okay";
};

驱动中通过 devm_clk_get(dev, "core") 获取名为 "core" 的时钟，通过 devm_reset_control_get(dev, "gpu") 获取复位控制句柄。

1.7 设备树层级关系与 GPU 节点定位

下面的 SVG 图展示了一个典型 SoC 中 GPU 节点在设备树中的位置，以及它与时钟控制器、中断控制器、复位控制器、内存控制器之间的关系。

1.8 设备树包含与覆盖机制

实际项目中，设备树通常拆分为多个文件，通过 #include 和 /include/ 组合：

• .dtsi：SoC 级描述文件，包含 CPU、中断控制器、时钟控制器、GPU 等所有内部外设的默认节点。
• .dts：板级描述文件，#include 对应的 .dtsi，然后通过 &gpu 引用节点并覆盖属性（如修改 status、调整时钟频率）。

/* soc.dtsi - SoC 级定义 */
/ {
    gpu: gpu@fbc00000 {
        compatible = "vendor,awesome-gpu";
        reg = <0xfbc00000 0x10000>;
        interrupts = <0 42 4>;
        clocks = <&clkc 15>, <&clkc 16>;
        clock-names = "core", "mem";
        resets = <&rstc 7>;
        status = "disabled";  /* 默认禁用 */
    };
};

/* board.dts - 板级定义 */
#include "soc.dtsi"

&gpu {
    status = "okay";  /* 板级使能 GPU */
    /* 可在此处添加板级特有的属性，如 operating-points */
};

1.9 本章小结

设备树是 GPU 驱动移植的“第一道关卡”——一个错误的 reg 地址会导致内核崩溃，遗漏 interrupts 会使 VBlank 中断无法触发，缺失 clocks 则 GPU 核心无法上电。掌握 DTS 语法与关键属性，是后续编写 GPU 驱动 probe 函数、实现 DRM 框架对接的必备前提。