Linux设备树（Device Tree）原理与实践

引言：设备树的起源与价值

在嵌入式Linux开发中，硬件描述一直是一个关键问题。传统方式需要在驱动代码中硬编码硬件信息（如寄存器地址、中断号等），导致驱动代码与硬件高度耦合。2011年后，Linux内核引入**设备树（Device Tree）**机制，将硬件描述与驱动代码解耦，彻底改变了嵌入式开发模式。

设备树的价值体现在三个方面：

1. 消除冗余代码：同一驱动可适配不同硬件平台
2. 提高可维护性：硬件变更只需修改设备树，无需重新编译内核
3. 标准化硬件描述：统一的DSL（Domain-Specific Language）描述硬件

一、设备树基础概念

1.1 核心文件类型

文件类型	说明	示例
.dts	设备树源文件（主文件）	exynos4412.dts
.dtsi	设备树头文件（被包含文件）	common.dtsi
.dtb	编译后的二进制设备树文件	exynos4412.dtb

编译过程：dts -> dtb（通过dtc工具）

1.2 设备树逻辑结构

设备树采用树形结构描述硬件：

/ (根节点)
├── cpu@0
├── memory@80000000
├── i2c@13860000
│   ├── touchscreen@38
│   └── eeprom@50
└── gpio@11000000

节点命名规范：

[label:] node-name[@unit-address]

• label：可选别名，简化访问路径
• node-name：设备类型（如i2c、gpio）
• unit-address：设备寄存器首地址

二、设备树语法详解

2.1 节点定义

c

Copy

// 基础结构
node-name {
    [properties];
    [child-nodes];
};

// 带标签示例
i2c1: i2c@13860000 {
    compatible = "samsung,s3c2440-i2c";
    reg = <0x13860000 0x100>;
    interrupts = <7>;
};

2.2 属性定义

属性值的四种类型：

c

Copy

// 32位数值数组
clock-frequency = <0x00000001 0x00000002>;

// 字符串
compatible = "samsung,exynos4412";

// 字节数组
local-mac-address = [00 0a 2d a6 7a e2];

// 混合类型（不推荐）
mixed-property = "string", [0x01 0x02], <0x03>;

2.3 特殊节点解析

根节点

c

Copy

/ {
    #address-cells = <1>;  // 子节点地址用1个32位数表示
    #size-cells = <1>;     // 子节点大小用1个32位数表示
    model = "FS4412 Board";
    compatible = "samsung,fs4412";
};

/memory节点

c

Copy

memory@80000000 {
    device_type = "memory";
    reg = <0x80000000 0x40000000>; // 起始地址0x80000000，大小1GB
};

/chosen节点

c

Copy

chosen {
    bootargs = "console=ttySAC2,115200 root=/dev/nfs nfsroot=192.168.1.1:/nfsroot";
};

三、关键属性深度解析

3.1 compatible属性

c

Copy

compatible = "厂商前缀,设备型号", "通用兼容型号";

驱动匹配流程：

1. 优先匹配"厂商前缀,设备型号"
2. 若无匹配，尝试"通用兼容型号"

3.2 reg属性

c

Copy

reg = <起始地址1 长度1 [起始地址2 长度2]...>;

父节点的#address-cells和#size-cells决定reg格式：

c

Copy

soc {
    #address-cells = <1>;
    #size-cells = <1>;
    
    serial@13800000 {
        reg = <0x13800000 0x100>; // 地址0x13800000，长度0x100
    };
};

3.3 中断描述

中断控制器节点：

c

Copy

intc: interrupt-controller@10490000 {
    #interrupt-cells = <2>;  // 每个中断需要2个cell
    interrupt-controller;
};

设备节点：

c

Copy

key@11400000 {
    interrupts = <1 4>; // 中断号1，触发方式4（高电平）
    interrupt-parent = <&intc>; 
};

3.4 GPIO描述

GPIO控制器：

c

Copy

gpio: gpio@11000000 {
    #gpio-cells = <2>;  // 引脚编号 + 标志位
    gpio-controller;
};

使用示例：

c

Copy

leds {
    led1-gpio = <&gpio 3 0>; // GPIO3引脚，低电平有效
};

四、设备树与驱动交互

4.1 OF核心API

函数	作用
of_find_node_by_path()	通过路径查找节点
of_get_property()	获取属性值
of_get_named_gpio()	解析GPIO编号
irq_of_parse_and_map()	解析中断号
of_property_read_u32()	读取32位属性值

4.2 LED驱动实例

设备树节点：

c

Copy

leds {
    compatible = "fs4412,leds";
    led1 = <&gpx2 7 0>;
    led2 = <&gpx1 0 0>;
};

驱动代码片段：

c

Copy

static int led_probe(struct platform_device *pdev)
{
    struct device_node *np = pdev->dev.of_node;
    
    led1_gpio = of_get_named_gpio(np, "led1", 0);
    gpio_request(led1_gpio, "LED1");
    gpio_direction_output(led1_gpio, 0);
    
    return 0;
}

五、进阶应用技巧

5.1 设备树覆盖（Overlay）

动态修改设备树：

bash

Copy

# 应用覆盖
fdtoverlay -i base.dtb -o new.dtb overlay.dtbo

# 查看覆盖
fdtdump new.dtb

5.2 调试技巧

查看解析后的设备树：

bash

Copy

# 内核启动参数添加
bootargs += "devicetree=debug"

# 查看/sys/firmware/devicetree
ls /sys/firmware/devicetree/base

5.3 设备树与ACPI对比

特性	设备树	ACPI
适用场景	嵌入式系统	x86/UEFI系统
描述方式	静态描述	动态表+AML代码
硬件支持	简单设备	复杂电源管理
调试难度	较低	较高

六、常见问题解答

Q1：为什么我的设备树修改后不生效？

• 检查dtb是否成功编译并部署到正确位置
• 确认内核配置开启CONFIG_OF
• 使用of_dump工具验证节点是否存在

Q2：如何解决设备树版本兼容问题？

• 保持dtc工具版本与内核版本一致
• 使用-@选项保留公共符号
• 通过compatible属性实现向后兼容

Q3：多个设备树文件如何管理？

• 采用dtsi分片管理公共配置
• 使用Makefile条件编译
• 利用版本控制系统管理变更

结语：设备树的未来展望

随着RISC-V架构的兴起和设备树在U-Boot中的深度应用，设备树正在成为嵌入式开发的通用语言。未来发展趋势包括：

1. 动态设备树：运行时动态修改硬件配置
2. 安全增强：设备树数字签名验证
3. AI辅助生成：机器学习自动生成优化设备树

掌握设备树技术，将使开发者能更高效地进行跨平台开发，构建更灵活的嵌入式系统。建议读者通过实践项目加深理解，例如从零构建一个支持设备树的ARM Linux系统。