rk3568主线Linux内核(linux-6.4.2)设备树适配与驱动调试实战

1. 从零开始：为什么需要自己动手适配主线内核？

如果你手头有一块像鲁班猫LubanCat2N这样的rk3568开发板，并且已经玩腻了官方提供的SDK内核，想尝尝鲜，体验一下Linux内核社区最新的特性和优化，那么自己动手移植主线Linux内核（比如linux-6.4.2）就是一个非常棒的选择。我刚开始接触这块板子的时候，也觉得这事儿挺高大上，是不是得从零开始写驱动、改架构代码？后来折腾下来才发现，其实远没有想象中那么复杂。

对于rk3568这类主流芯片，Rockchip的工程师们已经做了大量的上游化工作，把SoC的核心支持，比如CPU、内存控制器、各种内部总线（I2C、SPI、MMC）等基础驱动，都提交到了Linux内核主线。这意味着，内核源码树里已经包含了rk3568的“骨架”。我们这些“周边玩家”要做的，其实就是根据自己手里这块具体板卡的硬件差异，去“添肉”——也就是编写或修改**设备树（Device Tree）**文件。

设备树你可以把它理解成一份给内核的“硬件配置清单”。内核启动时，会读取这份清单，知道“哦，我这块板子上有一个PCIe接口连着RTL8125BG网卡，还有一个HDMI接口连着某个显示器”，然后才会去加载对应的驱动。如果你的清单写错了，或者驱动加载的顺序不对，硬件自然就无法工作。所以，整个移植和调试的核心，就是搞定这份清单，并确保驱动能正确加载。这个过程虽然会遇到坑，但解决问题的成就感也是满满的。接下来，我就结合自己的实战经验，带你一步步走通。

2. 环境搭建与内核源码获取

工欲善其事，必先利其器。在开始修改代码之前，我们需要一个合适的编译环境。因为rk3568是ARM64（aarch64）架构，而我们的开发主机通常是x86_64，所以必须使用交叉编译工具链。

2.1 获取并配置交叉编译工具链

我推荐使用ARM官方发布的GNU工具链，稳定且兼容性好。直接去ARM官网下载即可。这里我选择的是 aarch64-none-linux-gnu 这个版本，它专门针对运行Linux的64位ARM系统。

# 下载工具链（假设在用户主目录下操作）
wget https://developer.arm.com/-/media/Files/downloads/gnu-a/12.2.rel1/binrel/arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz

# 解压到 /opt 目录（需要sudo权限）
sudo tar -xf arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt

# 将工具链路径添加到当前shell的环境变量中
export PATH=/opt/arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu/bin:$PATH

为了以后方便，最好把最后这行 export 命令添加到你的 ~/.bashrc 文件末尾。完成后，可以验证一下工具链是否安装成功：

aarch64-none-linux-gnu-gcc --version

如果能看到编译器的版本信息，就说明工具链准备就绪了。

2.2 下载并解压Linux内核源码

接下来获取主线内核源码。国内可以从镜像站下载，速度会快很多。我们选择 linux-6.4.2 这个版本。

wget https://mirrors.edge.kernel.org/pub/linux/kernel/v6.x/linux-6.4.2.tar.xz
tar -xf linux-6.4.2.tar.xz
cd linux-6.4.2

现在，你就进入了Linux内核浩瀚的源码世界。别慌，我们只需要关注与rk3568和我们的板子相关的部分。

3. 设备树（DTS）适配：为你的板卡定制硬件清单

这是整个移植工作的核心。设备树文件（.dts 或 .dtsi）描述了硬件的拓扑结构和资源分配。对于rk3568，相关的设备树文件都放在 arch/arm64/boot/dts/rockchip/ 目