泰山派3M-RK3576-Linux内核驱动教程-Linux驱动基础-设备树-设备树文件结构

03. 设备树文件结构

一、设备树的典型文件类型

二、目录结构和分层

设备树源文件通常位于内核源码目录下（以 泰山派3M 为例）：

arch/
└── arm64/
    └── boot/
        └── dts/
            └── rockchip/
                ├── rk3576.dtsi
                ├── tspi-3m-rk3576.dts
                |── rk3576-pinctrl.dtsi
                ├── rockchip-pinconf.dtsi
                └── ...（其它.dtsi/.dts/外设公共dtsi等）

• 每个SoC（芯片）有自己的xxx.dtsi，比如rk3576.dtsi，描述SoC所有片上资源（CPU、片内外设等）
• 每个主板/方案/项目有自己的xxx.dts，比如tspi-3m-rk3576.dts，描述板级信息（电源、外部传感器、引脚复用等），一般包含自己的SoC dtsi文件

三、include 层次结构图

把具体的主板dts作为入口，系统会层层递归包含所有共用资源。

• 主板dts 作为顶层，#include 片上SoC、外设、各种通用模块的dtsi
• 每个dtsi 还可继续#include更底层的通用资源

四、经典dts/dtsi关系

tspi-3m-rk3576.dts头部这样写：

#include "rk3576.dtsi"
#include "rk3576-rk806.dtsi"

• 其中rk3576.dtsi定义所有SoC资源，
• rk3576-rk806.dtsi定义板级电源芯片809相关的资源
• 其它都可以通过 include 串起来。

五、总结

• 主板.dts 是总入口：最终要被编译为 dtb，并传递给内核
• dtsi 文件保证资源可重用：不同主板可共用同一 SoC、同一外设的dtsi模板
• 所有#included都被递归合并到最终dtb中

六、常用文件分工总结表

说明：

• .dts为主控板/项目主入口，所有 include 的都在这汇合。
• .dtsi为可复用的片内/外设/接口/模块资源，根据平台、功能选择 include。
• 这样拆分让不同硬件和定制需求可以批量适配、修改、共享和维护！
• 注释掉/解除注释某些 include，即可开关板载特定硬件，定制灵活性高。