2. 开发环境搭建：交叉编译工具链配置、Linux内核源码获取与编译、QEMU模拟器与真实硬件调试环境准备

嵌入式显示驱动开发与纯x86桌面环境存在显著差异。目标板（ARM/RISC-V）资源受限，无法直接运行完整的编译工具链与调试器。因此，交叉编译与模拟/硬件调试环境的搭建是进入DRM/KMS实战的第一道门槛。本章将分三部分完成环境构建：交叉工具链配置、内核源码获取与编译、QEMU模拟器与真实硬件调试环境准备。

2.1 交叉编译工具链配置

交叉编译工具链包含编译器、汇编器、链接器以及目标架构的C库头文件。推荐使用官方预编译工具链，避免从源码构建的复杂性。

2.1.1 工具链选择与下载

2.1.2 安装与配置环境变量

以下以 ARM GNU Toolchain 12.2 为例，解压并设置永久环境变量：

# 下载并解压（假设已下载到 ~/tools 目录）
cd ~/tools
wget https://developer.arm.com/-/media/Files/downloads/gnu/12.2.rel1/binrel/arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz
tar -xf arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz

# 添加至 PATH（建议写入 ~/.bashrc 或 ~/.zshrc）
export PATH=$HOME/tools/arm-gnu-toolchain-12.2.rel1-x86_64-aarch64-none-linux-gnu/bin:$PATH

# 验证安装
aarch64-none-linux-gnu-gcc --version
# 输出应包含 "aarch64-none-linux-gnu-gcc (Arm GNU Toolchain 12.2.rel1)"

2.1.3 交叉编译工具链核心组件

2.2 Linux内核源码获取与编译

DRM/KMS驱动以内核模块或内建方式存在，因此必须掌握内核源码管理、配置与交叉编译流程。

2.2.1 获取内核源码

推荐使用LTS版本内核进行学习，稳定且文档丰富。本课程以 v6.6.x 为例。

# 方法一：从 kernel.org 下载 tarball（推荐，避免 git 历史占用空间）
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.30.tar.xz
tar -xf linux-6.6.30.tar.xz
cd linux-6.6.30

# 方法二：git 克隆（适合需要查看历史提交或打补丁的场景）
git clone --depth=1 -b v6.6.30 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
cd linux

2.2.2 内核配置与交叉编译

配置内核时，需要指定目标架构和交叉编译器前缀。以下为 ARM64 的典型配置流程：

# 设置环境变量（每次编译前执行，或写入脚本）
export ARCH=arm64
export CROSS_COMPILE=aarch64-none-linux-gnu-

# 生成默认配置（基于 ARM64 的 defconfig）
make defconfig

# 手动调整配置（推荐启用 DRM 相关选项）
make menuconfig
# 进入 Device Drivers → Graphics support
# 确保以下选项为 y 或 m：
#   CONFIG_DRM=y
#   CONFIG_DRM_KMS_HELPER=y
#   CONFIG_DRM_VIRTIO_GPU=y  (QEMU 虚拟 GPU)
#   CONFIG_DRM_V3D=y         (树莓派 VC4/BCM2711)
#   CONFIG_DRM_PANEL_SIMPLE=y
#   CONFIG_I2C=y
#   CONFIG_I2C_CHARDEV=y

# 编译内核（使用 -jN 并行编译，N 为 CPU 核心数）
make -j$(nproc) Image.gz dtbs modules

# 编译产物位于：
#   arch/arm64/boot/Image.gz   — 内核镜像
#   arch/arm64/boot/dts/       — 设备树文件 (.dtb)

2.2.3 编译流程可视化

2.3 QEMU模拟器与真实硬件调试环境准备

调试环境分为纯模拟和真实硬件两个层次。QEMU 提供快速原型验证能力，真实硬件则用于最终功能与性能测试。

2.3.1 QEMU 模拟器环境搭建

QEMU 支持多种 ARM 开发板模拟，本课程使用 virt 平台（通用虚拟平台）配合 virtio-gpu 进行 DRM 驱动调试。

# 安装 QEMU（主机侧）
sudo apt install qemu-system-arm qemu-utils

# 创建根文件系统（使用 Buildroot 或直接下载现成镜像）
# 以下使用 Ubuntu 基础根文件系统示例：
wget https://cdimage.ubuntu.com/ubuntu-base/releases/22.04/release/ubuntu-base-22.04-base-arm64.tar.gz
mkdir rootfs
sudo tar -xf ubuntu-base-22.04-base-arm64.tar.gz -C rootfs

# 启动 QEMU（关键参数说明）
qemu-system-aarch64 \
  -machine virt,gic-version=3 \
  -cpu cortex-a72 \
  -smp 4 \
  -m 2G \
  -kernel arch/arm64/boot/Image.gz \
  -dtb arch/arm64/boot/dts/arm/virt.dtb \
  -drive file=rootfs.img,format=raw,if=none,id=hd0 \
  -device virtio-blk-device,drive=hd0 \
  -device virtio-gpu-pci \
  -device virtio-net-device,netdev=net0 \
  -netdev user,id=net0,hostfwd=tcp::2222-:22 \
  -append "root=/dev/vda console=ttyAMA0" \
  -nographic

2.3.2 真实硬件调试环境（以树莓派4B为例）

树莓派4B（BCM2711）是学习 DRM/KMS 的绝佳平台，其 VC4 驱动是主线内核中维护最活跃的 DRM 驱动之一。

2.3.3 部署内核到树莓派

# 编译树莓派专用内核（在主机上交叉编译）
export ARCH=arm64
export CROSS_COMPILE=aarch64-none-linux-gnu-
make bcm2711_defconfig
make -j$(nproc) Image.gz modules dtbs

# 将 SD 卡挂载到主机（假设挂载点为 /mnt/sd）
# 复制内核镜像
cp arch/arm64/boot/Image.gz /mnt/sd/boot/kernel8.img
# 复制设备树
cp arch/arm64/boot/dts/broadcom/bcm2711-rpi-4-b.dtb /mnt/sd/boot/
# 复制设备树覆盖文件（用于 I2C/DSI 配置）
cp arch/arm64/boot/dts/overlays/*.dtbo /mnt/sd/boot/overlays/

# 安装内核模块
make INSTALL_MOD_PATH=/mnt/sd modules_install

# 卸载 SD 卡，插入树莓派启动

2.3.4 调试环境架构总览

2.4 环境验证清单

完成上述步骤后，执行以下快速验证，确保环境可用：

1. 交叉编译验证： 编写一个简单的 hello.c，使用 aarch64-none-linux-gnu-gcc -o hello hello.c 编译，通过 file hello 确认输出为 ELF 64-bit LSB executable, ARM aarch64。
2. 内核编译验证： 检查 arch/arm64/boot/Image.gz 是否存在且大小合理（通常 10MB+）。
3. QEMU 启动验证： 执行 QEMU 启动命令，观察内核日志是否正常输出，登录后执行 cat /sys/class/drm/card0/status 查看 DRM 设备状态。
4. 真实硬件启动验证： 树莓派上电后，通过 UART 串口观察内核日志，确认 DRM 驱动初始化成功，HDMI 有显示输出。