嵌入式 Linux 与 RTOS / 系统课时
用设备树描述板级硬件
用设备树描述板级硬件
设备树的任务是把原理图里的“谁挂在哪条总线、地址是多少、用哪个中断和电源”转换成内核可解析的数据结构。本课从 DTS/DTSI 分层入手,用一个 I2C 传感器把 node、compatible、reg、interrupts 与 phandle 串成完整描述。
学习目标
- 能区分 DTS 与 DTSI 的职责,并理解节点继承与板级覆盖方式。
- 能把总线地址、中断、电源等原理图资源映射为设备树属性。
- 能编译并验证一个最小设备树,判断关键节点是否进入 DTB。
从原理图映射到节点
设备树是层级结构。父节点通常代表总线或控制器,子节点代表挂在该总线上的设备。节点名常写成 name@unit-address;对于 I2C 设备,unit-address 一般就是从设备地址,因此地址 0x48 的传感器可命名为 sensor@48。
compatible 是驱动匹配的核心字符串,通常按“厂商,型号”组织;reg 描述地址,但编码方式由父节点的 #address-cells 与 #size-cells 决定。I2C 总线常使用一个地址单元、零个长度单元,因此子节点 reg = <0x48>; 表示 I2C 地址,不是 CPU 物理地址。
DTS 与 DTSI 如何分工
DTS 通常描述一块具体板卡,DTSI 用来复用 SoC、芯片系列或多块板共同的硬件定义。常见做法是:SoC 的 .dtsi 先声明 I2C、GPIO、UART 等控制器及其寄存器资源,板级 .dts 再启用需要的控制器,并补上外接器件。
这样分层后,SoC 寄存器地址不需要在每块板重复维护,板级文件只表达“这块板实际焊了什么、接到哪里”。修改板级连接时,也不会污染同系列其他产品共享的 .dtsi。
用属性表达资源关系
下面给出一个可直接用 dtc 编译的最小示例。它不是某款真实 SoC 的设备树,而是专门用于观察地址、中断和 phandle 的结构:
/dts-v1/;
/ {
compatible = "demo,board";
#address-cells = <1>;
#size-cells = <1>;
vcc_3v3: regulator-3v3 {
compatible = "regulator-fixed";
regulator-name = "vcc_3v3";
regulator-min-microvolt = <3300000>;
regulator-max-microvolt = <3300000>;
};
gpio1: interrupt-controller@3000 {
compatible = "demo,gpio";
reg = <0x3000 0x100>;
interrupt-controller;
#address-cells = <0>;
#interrupt-cells = <2>;
};
i2c2: i2c@1000 {
compatible = "demo,i2c";
reg = <0x1000 0x100>;
#address-cells = <1>;
#size-cells = <0>;
sensor@48 {
compatible = "vendor,temp-sensor";
reg = <0x48>;
interrupt-parent = <&gpio1>;
interrupts = <5 4>;
vdd-supply = <&vcc_3v3>;
};
};
};这里的 &gpio1 和 &vcc_3v3 都是对带标签节点的 phandle 引用。编译 DTB 时,工具会把这些符号关系编码成节点之间的引用。interrupts = <5 4> 的每个单元含义由中断控制器的 binding 决定;示例只表示两个单元,不能把第二个数字机械理解成所有平台通用的触发类型。

编译并验证 DTB
把示例保存为 board-demo.dts。安装包含 dtc 与 fdtget 的 Device Tree Compiler 工具后,可直接编译并读取生成的二进制设备树:
dtc -I dts -O dtb -o board-demo.dtb board-demo.dts
fdtget -t s board-demo.dtb /i2c@1000/sensor@48 compatible预期输出:
vendor,temp-sensor没有输出并不一定是驱动问题:如果 dtc 已经报错,应先修复语法、标签引用或 cell 数量;如果 DTB 能生成但 fdtget 找不到路径,则要检查节点层级或名称是否与预期一致。
把示例迁回真实板级文件
真实内核树中应先找到目标板的 .dts 与所包含的 SoC .dtsi,确认 I2C 控制器标签、GPIO 控制器标签和 binding 要求,再把板外设挂到正确节点。compatible 必须与驱动或 binding 文档一致,reg、interrupts 和供电属性也要来自原理图与芯片手册,而不是照抄别的开发板。
设备树的检查顺序可以固定为:先确认父总线和地址,再确认驱动匹配字符串,再核对中断、时钟、电源等跨节点资源。只要这几类关系都能从原理图逐项对应到节点和属性,板级硬件描述就具备了可维护、可验证的基础。