Linux 设备树 (DTS) 指南
有时候需要配置设备树来调整板子功能,比如 UART/SPI 引脚复用的调整、I2C 设备的使能等。这篇教程会告诉你如何在 SDK 中寻找到 Firefly-R3572A 对应的设备树文件以及有关修改的注意事项。
找到设备树
首先需要学习如何编译 Linux 固件,之后你应该可以理解,所有的编译配置信息记录在 SDK/device/rockchip/.chips/rk3572/ 下的众多 defconfig 文件里。
假设需要编译 Firefly-R3572A 支持 Debian 的固件,那么对应的配置文件为:firefly_rk3572_r3572a_debian_defconfig。
前往 SDK/device/rockchip/.chips/rk3572 下寻找 firefly_rk3572_r3572a_debian_defconfig 并打开,可以很直观看到对应的 dts:
# Kernel dts
export RK_KERNEL_DTS=rk3572-firefly-r3572aRK_KERNEL_DTS 属性就记录着对应的 dts 文件名称,此处是不带后缀的,所以完整的 dts 名称为 rk3572-firefly-r3572a.dts。
有些配置文件可能没有 RK_KERNEL_DTS 属性,原因是它 source 了其他文件,其实设备树信息是记录在了被 source 的文件中,沿着包含关系查找即可。
知道设备树名称后,就可以前往 SDK/kernel-6.12/arch/arm64/boot/dts/rockchip/ 下找到该设备树。
修改设备树
打开 SDK/kernel-6.12/arch/arm64/boot/dts/rockchip/rk3572-firefly-r3572a.dts 后你可能发现,这个文件基本是空的,如何修改?
// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
/*
* Copyright (c) 2026 Rockchip Electronics Co., Ltd.
*
*/
/dts-v1/;
#include "rk3572-firefly-r3572a.dtsi"
/ {
model = "Firefly R3572A";
compatible = "rockchip,rk3572-firefly-r3572a", "rockchip,rk3572";
};原因是该文件 include 了 rk3572-firefly-r3572a.dtsi,注意后缀为 dtsi,再次打开这个文件就可以看到设备树节点。同样的,该文件也会 include 其他文件。
所以设备树是多个 dts/dtsi 文件共同组成的,并不是单个文件:
设备树基本关系为:
上层 <-----------------------------------> 底层
A.dts include B.dtsi include C.dtsi ... N.dtsi- 如果在 A.dts 里面找不到某个节点,那么就可能在 B.dtsi 中,或者在 C.dtsi 中...根据包含关系总能找到。
- 上层的配置会覆盖底层的配置,例如 C.dtsi 中将 uart0 关闭,但 A.dts 中配置为开启,那么 A.dts 中的配置会生效,uart0 开启。
- 一个 dtsi 可能被多个文件 include,修改会导致多个板型同步修改,所以修改前请明确包含关系。
以太网、PCIE、UART 等各功能的配置指南一般可以在 SDK/docs/ 下的文档中找到。修改设备树需要基本的 kernel 知识、设备树语法,并且你需要明确的知道你在干什么。修改不当会导致功能不正常,甚至无法开机。

