第 1 章:创建自己的 RK3576 板级 DTS 与 defconfig
本章完成后,你会拥有一个独立的 RK3576_industrial 实验板级配置。它不改动原厂 Industry EVB DTS,也不改动 SoC 公共文件;后续所有 CAN、RS485 和 DSMC 实验都只进入这个新配置。
1. 为什么必须创建新配置
直接修改 rk3576-industry-evb-v10.dts 会让你无法区分“原厂基线”与“自己的试验”,也会让回归和提交变困难。正确做法是新增一个板级目标,例如 rk3576-industrial-lab-v10,其初始行为等价于 Industry EVB,差异集中在一个新 .dtsi 文件中。
目录关系如下:
rk3576.dtsi SoC:不可修改
└─ rk3576-industry-evb.dtsi 原厂板级公共描述:不修改
└─ rk3576-industrial-lab.dtsi 你的实验覆盖层:唯一常改文件
└─ rk3576-industrial-lab-v10.dts 你的最终板级目标
2. 创建四个文件改动
以下内容是本机 RK3576 SDK 的可用起点。创建前先在实验分支工作;不要覆盖任何现有的未提交文件。
2.1 新板级 DTS
文件:kernel-6.1/arch/arm64/boot/dts/rockchip/rk3576-industrial-lab-v10.dts
// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
/dts-v1/;
#include "rk3576.dtsi"
#include "rk3576-industry-evb.dtsi"
#include "rk3576-industrial-lab.dtsi"
#include "rk3576-industry-evb-cam-dcphy0.dtsi"
#include "rk3576-linux.dtsi"
/ {
model = "Rockchip RK3576 INDUSTRIAL LAB V10 Board";
compatible = "rockchip,rk3576-industrial-lab-v10",
"rockchip,rk3576-industry-evb-v10",
"rockchip,rk3576";
};
第一个 compatible 标识你的板;第二个表示它与 Industry EVB V10 兼容;第三个用于 SoC 级匹配。不要把它误改为 CAN 或 DSMC 驱动的 compatible,外设节点已有自己的匹配字符串。
2.2 新实验覆盖层
文件:kernel-6.1/arch/arm64/boot/dts/rockchip/rk3576-industrial-lab.dtsi
// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
&can0 {
assigned-clocks = <&cru CLK_CAN0>;
assigned-clock-rates = <200000000>;
pinctrl-names = "default";
pinctrl-0 = <&can0m0_pins>;
status = "okay";
};
&can1 {
assigned-clocks = <&cru CLK_CAN1>;
assigned-clock-rates = <200000000>;
pinctrl-names = "default";
pinctrl-0 = <&can1m1_pins>;
status = "okay";
};
&uart1 {
pinctrl-names = "default";
pinctrl-0 = <&uart1m0_xfer &uart1m0_rtsn>;
linux,rs485-enabled-at-boot-time;
status = "okay";
};
/* Do not enable until lab hardware is verified. */
&dsmc {
status = "disabled";
};
这不是“无意义重复”。它明确了实验起点、继承关系和允许修改的位置。以后新增 CAN 收发器使能 GPIO、改变 UART1 方向控制或启用 DSMC,都只改这里。
2.3 注册 DTB
文件:kernel-6.1/arch/arm64/boot/dts/rockchip/Makefile。在现有 Industry EVB 条目旁增加:
dtb-$(CONFIG_ARCH_ROCKCHIP) += rk3576-industrial-lab-v10.dtb
如果不加此项,DTS 即使语法正确也可能不会被标准 DTB 构建流程产出。
2.4 新 SDK defconfig
文件:device/rockchip/.chips/rk3576/rockchip_rk3576_industrial_lab_v10_defconfig
# RK3576 industrial-bus laboratory target
# RK_WIFIBT is not set
RK_UBOOT_SPL=y
RK_KERNEL_DTS_NAME="rk3576-industrial-lab-v10"
最关键的是 RK_KERNEL_DTS_NAME:它必须与 DTS 文件名去掉 .dts 后完全一致。此文件是 SDK 选择板级 DTB 的入口,不是 Linux 内核 defconfig;内核 Kconfig 在内核源码树中另有位置。
3. 不应改动的文件
不要修改 rk3576.dtsi、rk3576-pinctrl.dtsi、时钟/reset 定义和芯片级 controller 节点。它们是所有 RK3576 板共享的资源描述。若板级需求没有对应 pin group 或属性,先证明问题,再在设计评审中决定是否需要芯片级支持;不要把实验改动直接塞进去。
4. 构建前的静态检查
在 SDK 根目录确认你的文件和名称:
rg -n 'rk3576-industrial-lab-v10' \
kernel-6.1/arch/arm64/boot/dts/rockchip/Makefile \
device/rockchip/.chips/rk3576
git -C kernel-6.1 diff --check
git -C device/rockchip diff --check
预期:Makefile、DTS 文件名和 RK_KERNEL_DTS_NAME 三处字符串一致,diff --check 无输出。首次构建应复用团队现有 RK3576 SDK 构建入口;不同 SDK 版本的顶层构建命令可能不同,不能凭教程猜一个命令后直接刷机。
5. 运行时验证
刷入已经获准的实验板后,先确认运行 DTB 的 model:
tr -d '\0' </proc/device-tree/model; echo
dmesg | grep -i -E 'rk3576|can|uart|dsmc'
预期第一条显示 Rockchip RK3576 INDUSTRIAL LAB V10 Board。如果仍显示原 Industry EVB,优先检查 SDK 是否实际选中了新 defconfig 和正确 DTB,而不是开始修改 CAN 驱动。