学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--01-Create-Your-Board-Config

01_Learning · 第 12 / 23 篇

第 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 驱动。

01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--00-Start-Here下一篇RK3576-Industrial-Bus-Driver-Course--02-Device-Tree-Deep-Dive