当前位置：首页 > news >正文

嵌入式Linux驱动开发指南 —— 设备树语法与编译工具 —— 读懂这张“藏宝图“（3）

news 2026/6/14 16:32:17

接前一篇文章：嵌入式Linux驱动开发指南 —— 设备树语法与编译工具 —— 读懂这张“藏宝图“（2）

标准属性：那些你一定会用到的

Linux内核定义了一些标准属性，驱动程序会对它们有特定的预期处理。

compatible：驱动匹配的灵魂

这是最重要的属性，没有之一。格式为"manufacturer,model"，它是驱动和硬件绑定的“红娘”：

compatible = "fsl,imx6ul-evk-wm8960", "fsl,imx-audio-wm8960";

内核会拿着这个字符串去驱动的of_match_table里匹配：

static const struct of_device_id imx_wm8960_dt_ids[] = { { .compatible = "fsl,imx-audio-wm8960", }, { /* sentinel */ } };

只要有一个能对上，驱动就会被触发。

status：设备的生死开关

"okay"：设备可操作，内核加载驱动。
"disabled"：设备禁用，内核忽略它。
"fail"/"fail-sss"：设备有严重错误。

移植时最常改的属性。很多外设在.dtsi里默认disabled，我们在.dts里改成okay来激活。

reg：地址与长度

描述设备寄存器地址范围，格式由父节点的#address-cells和#size-cells决定：

uart1: serial@02020000 { compatible = "fsl,imx6ul-uart", "fsl,imx6q-uart", "fsl,imx21-uart"; reg = <0x02020000 0x4000>; };

#address-cells和#size-cells：地址的度量衡

这两个属性出现在父节点里，指导子节点如何写reg：

#address-cells：地址字段占多少个 32 位整数。
#size-cells：长度字段占多少个 32 位整数。

spi4 { #address-cells = <1>; #size-cells = <0>; // 没有长度字段 gpio_spi@0 { reg = <0>; // 只有一个地址 }; };

再看：

aips-bus@02200000 { #address-cells = <1>; #size-cells = <1>; dcp@02280000 { reg = <0x02280000 0x4000>; // 地址 + 长度 }; };

ranges：地址翻译

ranges是一个翻译函数：ranges = <child-bus-address parent-bus-address length>。

空ranges意味着子地址和父地址一一对应，不需要翻译，这在SoC内部总线中很常见：

soc { ranges; };

如果不为空，比如ranges = <0x0 0xe0000000 0x00100000>，则子总线地址0x4600会被翻译为0xe0004600。大部分普通开发板移植不需要关心这个。

语法糖：让代码更简洁

include机制

#include <dt-bindings/input/input.h> #include "imx6ull.dtsi"

DTC不仅能include.dtsi，连.h文件也支持。约定上：.h放宏定义（把“魔术数字”变成可读常量），.dtsi放节点定义。

/delete-node/：删除节点

/delete-node/ &sim2;

把不需要的节点彻底删除，而不是让它以disabled状态存在。

节点追加与覆盖

&i2c1 { status = "okay"; // 覆盖原来的 "disabled" clock-frequency = <100000>; // 新增属性 };

如果原节点已有该属性则覆盖，没有则新增。不用修改原始文件，就能完全定制设备树行为。

实战示例：一个完整的设备树文件

下面是一个用于Alpha开发板的LED驱动设备树文件：

/dts-v1/; #include "imx6ull.dtsi" #include "imx6ull-aes.dtsi" / { model = "Awesome Embedded Studio IMX6ULL Example Driver"; compatible = "fsl,imx6ull-14x14-evk", "fsl,imx6ull"; imx_aes_led { #address-cells = <1>; #size-cells = <1>; compatible = "atkalpha-led"; status = "okay"; reg = < 0X020C406C 0X04 /* CCM_CCGR1_BASE */ 0X020E0068 0X04 /* SW_MUX_GPIO1_IO03_BASE */ 0X020E02F4 0X04 /* SW_PAD_GPIO1_IO03_BASE */ 0X0209C000 0X04 /* GPIO1_DR_BASE */ 0X0209C004 0X04 >; /* GPIO1_GDIR_BASE */ }; };

逐行解析：