1. Linux 设备树 (DTS) 指南
有时候需要配置设备树来调整板子功能，比如 CAN 接口时钟的修改等。这篇教程会告诉你如何在 SDK 中寻找到板子对应的设备树文件以及有关修改的注意事项。
1.1. 找到设备树
首先需要学习如何编译 Linux SDK，之后你应该可以理解，所有的编译配置信息记录在 SDK/device/rockchip/rk3506/ 下的众多 defconfig 文件里。
格式为：firefly_芯片_板型(-配件)_系统_defconfig
假设我需要编译 ROC-RK3506B-CC 的 eMMC Buildroot 固件，则配置文件为 firefly_rk3506_roc-rk3506b-cc-emmc_buildroot_defconfig
前往 SDK/device/rockhip/rk3506 下打开 firefly_rk3506_roc-rk3506b-cc-emmc_buildroot_defconfig，可以很直观看到对应的 dts:
#include "firefly.config"
RK_WIFIBT=n
RK_ROOTFS_TYPE="ext4"
RK_ROOTFS_EXT4=y
RK_PRODUCT_MODEL="ROC-RK3506B-CC"
RK_EXTRA_PARTITION_1_FSTYPE="ext4"
RK_EXTRA_PARTITION_2_FSTYPE="ext4"
RK_PARAMETER="parameter-buildroot-emmc-fit.txt"
RK_RECOVERY=y
RK_MISC_RECOVERY=y
RK_RECOVERY_RAMDISK="rk3506-recovery-arm-ext4.cpio.gz"
RK_KERNEL_DTS_NAME 属性就记录着对应的 dts 文件名称，在包含的 firefly.config 文件有定义。此处是不带后缀的，所以完整的 dts 名称为 rk3506b-firefly-roc-rk3506b-cc.dts
有些 defconfig 文件可能没有 RK_KERNEL_DTS_NAME 属性，原因是 defconfig 支持 include，可能 RK_KERNEL_DTS_NAME 在 include 的文件中已经配置过了，所以此处不用再配置。
知道设备树名称后，就可以前往 SDK/kernel/arch/arm/boot/dts/ 下找到该设备树。
1.2. 修改设备树
这次我们使用 rk3506b-firefly-roc-rk3506b-cc.dts 举例：
打开 SDK/kernel/arch/arm/boot/dts/rk3506b-firefly-roc-rk3506b-cc.dts 后你可能发现，这个文件基本是空的，如何修改？
// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
/*
* Copyright (c) 2024 Rockchip Electronics Co., Ltd.
*/
/dts-v1/;
#define N_LED 1
#define N_ES8390 1
#define N_RTC 1
#define N_WATCH_DOG 1
#define N_PCA9555 1
#define RECOVERY_KEY 1
#define EMMC_OR_SDCARD 1 /* 1 = EMMC, 0 = SDCARD */
#define WIFI_BT 1
#define GMAC0 1
#define GMAC1 1
#define CAN0 0
#define CAN1 0
#include "rk3506.dtsi"
#include "rk3506b-firefly-roc-rk3506b-cc.dtsi"
#include "rk3506b-firefly-roc-rk3506b-cc-mipi101-BSD1218-A101KL68.dtsi"
/ {
model = "Firefly ROC-RK3506B-CC Linux(MIPI)";
compatible = "rockchip,rk3506b-firefly-roc-rk3506b-cc", "rockchip,rk3506";
};
原因是该文件 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 知识、设备树语法，并且你需要明确的知道你在干什么。修改不当会导致功能不正常，甚至无法开机。
1.3. 编译烧录
修改完成后回到 SDK 根目录，使用 build.sh 进行配置与编译：
# 选择配置文件
./build.sh firefly_rk3506_roc-rk3506b-cc-emmc_buildroot_defconfig
# 编译内核
./build.sh kernel
编译的结果会在 SDK/kernel 下，是一个镜像 zboot.img
烧录方法：
- 根据固件烧录中烧写 kernel 分区的方法烧录 zboot.img