嵌入式 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
/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 工具后,可直接编译并读取生成的二进制设备树:

bash
dtc -I dts -O dtb -o board-demo.dtb board-demo.dts
fdtget -t s board-demo.dtb /i2c@1000/sensor@48 compatible

预期输出:

text
vendor,temp-sensor

没有输出并不一定是驱动问题:如果 dtc 已经报错,应先修复语法、标签引用或 cell 数量;如果 DTB 能生成但 fdtget 找不到路径,则要检查节点层级或名称是否与预期一致。

把示例迁回真实板级文件

真实内核树中应先找到目标板的 .dts 与所包含的 SoC .dtsi,确认 I2C 控制器标签、GPIO 控制器标签和 binding 要求,再把板外设挂到正确节点。compatible 必须与驱动或 binding 文档一致,reg、interrupts 和供电属性也要来自原理图与芯片手册,而不是照抄别的开发板。

设备树的检查顺序可以固定为:先确认父总线和地址,再确认驱动匹配字符串,再核对中断、时钟、电源等跨节点资源。只要这几类关系都能从原理图逐项对应到节点和属性,板级硬件描述就具备了可维护、可验证的基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用设备树描述板级硬件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通