2. 开发环境搭建

嵌入式Linux驱动开发，尤其是显示子系统这样与硬件紧密相关的模块，其开发环境搭建的成败直接决定了后续调试的效率。本章将手把手搭建一套完整的RK3399显示驱动开发环境，涵盖交叉编译工具链、内核源码、SDK配置以及网络启动环境，确保你能够快速进入“修改-编译-运行-验证”的高效循环。

2.1 交叉编译工具链安装

RK3399是ARMv8-A架构的SoC，而我们的开发主机通常是x86_64架构。因此，必须使用交叉编译工具链，在x86主机上编译出能在ARM目标板上运行的二进制代码。

2.1.1 工具链选择

Rockchip官方推荐使用基于GCC的交叉编译工具链，主要有以下两种选择：

2.1.2 安装步骤

1. 下载工具链：从Rockchip官方资源或Linaro官网获取 gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz。
2. 解压到指定目录：通常放置在 /opt/toolchains/ 下，便于管理。
3. 配置环境变量：将工具链的 bin 目录添加到 PATH 中。

# 解压
sudo mkdir -p /opt/toolchains
sudo tar -xvf gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt/toolchains/

# 配置环境变量（建议写入 ~/.bashrc 或 /etc/profile）
export PATH=/opt/toolchains/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin:$PATH
export ARCH=arm64
export CROSS_COMPILE=aarch64-none-linux-gnu-

# 验证安装
aarch64-none-linux-gnu-gcc --version

2.2 Linux内核源码获取

FrameBuffer驱动是内核的一部分。我们需要获取与RK3399平台匹配的Linux内核源码，并切换到正确的分支。

2.2.1 源码仓库与分支

Rockchip官方维护了一个基于LTS内核的SDK仓库，推荐使用 linux-5.10.y 分支，该分支对RK3399的显示驱动支持非常完善。

# 克隆内核源码（以RK官方仓库为例）
git clone https://github.com/rockchip-linux/kernel.git -b linux-5.10.y --depth 1 rk3399-kernel
cd rk3399-kernel

2.2.2 内核目录结构概览

理解内核源码的目录结构，有助于我们快速定位显示驱动相关的代码。

2.3 RK3399 SDK配置

SDK配置的核心是生成正确的 .config 文件，它决定了内核中哪些功能被编译、哪些驱动被加载。

2.3.1 使用默认配置

RK3399 SDK提供了多个默认配置文件，位于 arch/arm64/configs/ 目录下。对于显示驱动开发，我们通常使用 rockchip_linux_defconfig。

# 加载RK3399 Linux默认配置
make rockchip_linux_defconfig

# 使用菜单界面进行微调（可选）
make menuconfig

2.3.2 关键配置项检查

在 menuconfig 中，必须确保以下与FrameBuffer相关的选项被正确配置：

2.4 TFTP/NFS网络启动环境搭建

在驱动开发过程中，频繁插拔SD卡或烧写eMMC会严重拖慢开发节奏。通过网络启动（TFTP加载内核，NFS挂载根文件系统）可以实现“编译-重启-验证”的秒级迭代。

2.4.1 网络启动架构

2.4.2 开发主机配置步骤

1. 安装并配置TFTP服务器：用于提供内核镜像和设备树文件。
2. 安装并配置NFS服务器：用于提供根文件系统。
3. 准备根文件系统：可以使用Buildroot或Debian/Ubuntu base构建。

# === TFTP 配置 ===
sudo apt install tftpd-hpa
sudo mkdir -p /srv/tftp
sudo chmod 777 /srv/tftp
# 编辑 /etc/default/tftpd-hpa，确保 TFTP_DIRECTORY="/srv/tftp"

# === NFS 配置 ===
sudo apt install nfs-kernel-server
sudo mkdir -p /srv/nfs/rootfs
# 编辑 /etc/exports，添加以下行：
# /srv/nfs/rootfs *(rw,sync,no_subtree_check,no_root_squash)
sudo exportfs -a
sudo systemctl restart nfs-kernel-server

# === 放置启动文件 ===
# 将编译好的内核镜像复制到TFTP目录
cp arch/arm64/boot/Image /srv/tftp/
cp arch/arm64/boot/dts/rockchip/rk3399-evb.dtb /srv/tftp/
# 将根文件系统解压到NFS目录
sudo tar -xvf ubuntu-base-rootfs.tar.gz -C /srv/nfs/rootfs/

2.4.3 U-Boot启动参数设置

在目标板的U-Boot命令行中，设置以下环境变量以实现网络启动：

# 设置网络参数
setenv ipaddr 192.168.1.200
setenv serverip 192.168.1.100
setenv gatewayip 192.168.1.1
setenv netmask 255.255.255.0

# 设置TFTP和NFS启动参数
setenv bootargs 'console=ttyS2,1500000 root=/dev/nfs nfsroot=192.168.1.100:/srv/nfs/rootfs,v3,tcp rw ip=192.168.1.200:192.168.1.100:192.168.1.1:255.255.255.0::eth0:off'

# 设置启动命令
setenv bootcmd 'tftp 0x02000000 Image; tftp 0x01f00000 rk3399-evb.dtb; booti 0x02000000 - 0x01f00000'

# 保存并启动
saveenv
boot

2.5 环境验证

完成以上所有步骤后，进行一个简单的验证：编译内核并尝试网络启动。

# 编译内核
make Image -j$(nproc)
make dtbs

# 将新编译的内核和设备树复制到TFTP目录
cp arch/arm64/boot/Image /srv/tftp/
cp arch/arm64/boot/dts/rockchip/rk3399-evb.dtb /srv/tftp/

# 重启目标板，观察串口输出
# 如果看到类似以下信息，说明环境搭建成功：
# [    0.000000] Booting Linux on physical CPU 0x0000000000 [0x410fd034]
# [    0.000000] Linux version 5.10.160 ...
# [    2.345678] VFS: Mounted root (nfs filesystem) on device 0:14.
# [    2.456789] Freeing unused kernel memory: 1024K
# [    2.567890] Run /sbin/init as init process