Linux 设备树 (DTS) 指南
有时候需要配置设备树来调整板子功能，比如 CAN 接口时钟的修改等。这篇教程会告诉你如何在 SDK 中寻找到板子对应的设备树文件以及有关修改的注意事项。
找到设备树
首先需要学习如何编译 Linux SDK，之后你应该可以理解，所有的编译配置信息记录在 SDK/device/rockchip/rv1126b/ 下的众多 defconfig 文件里。
格式为：firefly_芯片_板型(-配件)_系统_defconfig
假设我需要编译 AIO-1126BJD4 的 Debian 固件，则配置文件为 firefly_rv1126b_aio-1126bjd4_debian_defconfig
前往 SDK/device/rockhip/rv1126b 下打开 firefly_rv1126b_aio-1126bjd4_debian_defconfig，可以很直观看到对应的 dts:
#include "firefly.config"
RK_UBOOT_INI="RV1126BMINIALL.ini"
RK_UBOOT_SPL=y
RK_KERNEL_DTS_NAME="rv1126b-firefly-aio-1126bjd4"
RK_KERNEL_CFG="rockchip_linux_defconfig"
RK_MISC_RECOVERY=y
RK_RECOVERY_RAMDISK="common-recovery-arm64.cpio.gz"
RK_BOOT_FIT_ITS_NAME="bootramdisk.its"
RK_RAMDISK_IMG="kernel/ramdisk-64.img"
RK_PRODUCT_MODEL="AIO-1126BJD4V0"
RK_PARAMETER="parameter-debian-fit.txt"
PREBUILT_ROOTFS_IMG="prebuilt_rootfs/rv1126b_debian_rootfs.img"RK_KERNEL_DTS_NAME 属性就记录着对应的 dts 文件名称，此处是不带后缀的，所以完整的 dts 名称为 rv1126b-firefly-aio-1126bjd4.dts
有些 defconfig 文件可能没有 RK_KERNEL_DTS_NAME 属性，原因是 defconfig 支持 include，可能 RK_KERNEL_DTS_NAME 在 include 的文件中已经配置过了，所以此处不用再配置。
知道设备树名称后，就可以前往 SDK/kernel/arch/arm64/boot/dts/rockchip/ 下找到该设备树。
修改设备树
这次我们使用 rv1126b-firefly-aio-1126bjd4.dts 举例：
打开 SDK/kernel/arch/arm64/boot/dts/rockchip/rv1126b-firefly-aio-1126bjd4.dts 后你可能发现，这个文件基本是空的，如何修改？
// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
/*
* Copyright (c) 2020 Rockchip Electronics Co., Ltd.
*/
#define FF_SDCARD
#define FF_GMAC
#define FF_WIFI_BT
#define FF_LEDS
#define FF_ES8390
#define FF_MIC
#define FF_USB20_HOST0
#define FF_4G_MODULE
#define FF_RTC
#define FF_CAN_0
#define FF_CAN_1
#define FF_CAM_CSI0_8MS1M
#define FF_CAM_CSI1_8MS1M
#define FF_CAM_CSI0_IMX415
#define FF_CAM_CSI1_IMX415
#define FF_CAM_CSI0_IMX586
#define FF_CAM_CSI1_IMX586
#define FF_DSI_V3
#define FF_I2C3
#define FF_I2C5
#define FF_RS485_1
#define FF_RS485_2
#define FF_RS232_1
#define FF_RS232_2
#define FF_UART5
#define FF_OUTPUT
#include "rv1126b-firefly-aio-1126bjd4.dtsi"
#ifdef FF_CAM_CSI0_8MS1M
#include "rv1126b-firefly-aio-1126bjd4-csi0-8ms1m.dtsi"
#endif
#ifdef FF_CAM_CSI1_8MS1M
#include "rv1126b-firefly-aio-1126bjd4-csi1-8ms1m.dtsi"
#endif
#ifdef FF_CAM_CSI0_IMX415
#include "rv1126b-firefly-aio-1126bjd4-csi0-imx415.dtsi"
#endif
#ifdef FF_CAM_CSI1_IMX415
#include "rv1126b-firefly-aio-1126bjd4-csi1-imx415.dtsi"
#endif
#ifdef FF_CAM_CSI0_IMX586
#include "rv1126b-firefly-aio-1126bjd4-csi0-imx586.dtsi"
#endif
#ifdef FF_CAM_CSI1_IMX586
#include "rv1126b-firefly-aio-1126bjd4-csi1-imx586.dtsi"
#endif
#ifdef FF_DSI_V3
#include "rv1126b-firefly-aio-1126bjd4-mipi101-BSD1218-A101KL68.dtsi"
#endif
/ {
model = "Firefly AIO-1126BJD4 mipi101-BSD1218-A101KL68 Board";
compatible = "firefly,aio-1126bjd4", "rockchip,rv1126b";
};原因是该文件 include 了其他几个设备树文件，注意后缀为 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，修改会导致多个板型同步修改，所以修改前请明确包含关系。
以太网、UART 等各功能的配置指南一般可以在 SDK/docs/ 下的文档中找到。修改设备树需要基本的 kernel 知识、设备树语法，并且你需要明确的知道你在干什么。修改不当会导致功能不正常，甚至无法开机。
编译烧录
修改完成后回到 SDK 根目录，使用 build.sh 进行配置与编译：
# 选择配置文件
./build.sh firefly_rv1126b_aio-1126bjd4_debian_defconfig
# 编译内核
./build.sh kernel编译的结果会在 SDK/kernel 下，是一个镜像 boot.img
烧录方法：
- 根据固件烧录中烧写 kernel 分区的方法烧录 boot.img