3、开发环境搭建：交叉编译工具链、QEMU模拟环境、目标板调试环境配置

说实话，嵌入式GPU驱动开发最让人头疼的，往往不是代码本身，而是环境搭不起来。我见过太多新手，花了两周时间还在跟交叉编译链较劲。这一章，我就把这几年的经验梳理出来，帮你少走弯路。

3.1 交叉编译工具链：你的代码翻译官

为什么需要交叉编译？你想想看，你的开发机是x86架构，但目标板是ARM或RISC-V。你不能直接在x86上编译出ARM能跑的程序吗？当然能，但需要一套特殊的工具链——交叉编译工具链。

我个人习惯用Linaro提供的GCC工具链，稳定且社区活跃。以ARM64为例，安装命令如下：

# 下载并解压
wget https://releases.linaro.org/components/toolchain/binaries/latest-7/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
tar -xf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz

# 设置环境变量
export PATH=$PATH:/path/to/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin
export CROSS_COMPILE=aarch64-linux-gnu-
export ARCH=arm64
小提示： 我建议把环境变量写到 ~/.bashrc 里，省得每次开终端都要重新设。另外，记得检查一下工具链版本，太老的版本可能不支持新的GPU特性。

验证工具链是否正常工作：

aarch64-linux-gnu-gcc --version
# 输出类似：aarch64-linux-gnu-gcc (Linaro GCC 7.5-2019.12) 7.5.0

嗯，这里要注意：交叉编译出来的程序，不能在开发机上直接运行。你得把它放到目标板上，或者用QEMU模拟。

3.2 QEMU模拟环境：没有硬件也能调试

做驱动开发，最怕的就是硬件还没到，代码写好了没法测。QEMU就是你的救星。它能模拟出完整的ARM64开发板，包括CPU、内存、外设，甚至GPU（部分支持）。

安装QEMU：

sudo apt-get install qemu-system-arm qemu-efi-aarch64

然后，你需要一个内核镜像和根文件系统。我一般用Buildroot来生成，省事：

# 下载Buildroot
git clone https://git.buildroot.net/buildroot
cd buildroot

# 配置目标架构
make qemu_aarch64_virt_defconfig

# 编译（第一次会比较慢）
make -j$(nproc)

编译完成后，在 output/images 目录下会生成：

  • Image：内核镜像
  • rootfs.ext4：根文件系统
  • start-qemu.sh：启动脚本

启动QEMU：

./output/images/start-qemu.sh
避坑指南： 我曾经在QEMU上调试GPU驱动，发现画面死活不显示。折腾了两天，最后发现是QEMU的显示后端没配好。记得加上 -display gtk 或者 -vnc :0 参数。

QEMU启动后，你会看到一个终端。这就是你的虚拟开发板。你可以用scp把交叉编译好的驱动模块传进去：

scp my_gpu_driver.ko root@192.168.1.100:/root/

3.3 目标板调试环境配置：真刀真枪干

模拟环境再方便，最终还是要上真板子。我常用的调试方式有三种：

调试方式 适用场景 优点 缺点
串口终端 内核启动、早期调试 简单可靠，不需要网络 速度慢，只能看文本
网络SSH 日常开发、文件传输 速度快，支持多终端 需要网络配置
JTAG/SWD 硬件调试、寄存器级调试 可以单步执行、查看内存 需要调试器硬件

我个人最常用的是串口+SSH组合。串口用来监控内核启动日志，SSH用来做日常操作。

配置串口终端：

# 安装minicom
sudo apt-get install minicom

# 配置串口参数（以USB转串口为例）
minicom -s
# 设置 Serial Device: /dev/ttyUSB0
# 设置 Bps/Par/Bits: 115200 8N1

配置网络（通过USB网卡或WiFi）：

# 在目标板上
ifconfig eth0 192.168.1.100 netmask 255.255.255.0
route add default gw 192.168.1.1

# 测试连通性
ping 192.168.1.1
注意： 目标板的IP地址不要跟开发机冲突。我建议用静态IP，省得每次都要查DHCP分配的地址。

3.4 调试GPU驱动的特殊准备

GPU驱动调试跟普通驱动不太一样。你需要额外准备：

  • DRM/KMS测试工具：modetest、kmscube，用来验证显示输出
  • GPU性能分析工具：如perf、ftrace，用来分析驱动性能瓶颈
  • 用户态驱动库：如libdrm、mesa，用来配合内核态驱动

安装这些工具：

# 在Buildroot中配置
make menuconfig
# 选择 Target packages -> Graphic libraries and applications -> libdrm
# 选择 Target packages -> Graphic libraries and applications -> kmscube

编译后，这些工具会出现在根文件系统中。启动QEMU或目标板后，直接运行：

# 测试显示输出
modetest -M vc4

# 运行GPU测试程序
kmscube
小技巧： 如果你看到屏幕上有旋转的立方体，说明GPU驱动基本正常。我第一次在QEMU上看到这个立方体时，激动得差点跳起来。

3.5 常见问题与解决方案

环境搭建过程中，你可能会遇到这些问题：

  1. 交叉编译链找不到：检查PATH环境变量，确认路径正确
  2. QEMU启动卡住：检查内核配置，确认开启了VirtIO支持
  3. 目标板无法启动：检查串口连接，确认波特率设置正确
  4. GPU驱动加载失败：查看dmesg日志，确认硬件资源是否冲突

我曾经遇到一个特别坑的问题：QEMU上GPU驱动加载成功，但画面全是花屏。查了两天，最后发现是显示内存对齐问题。嗯，这种问题往往最隐蔽，也最考验耐心。

好了，环境搭建就讲到这里。下一章，我们会正式开始写第一个GPU驱动——一个简单的framebuffer驱动。到时候，这些环境就派上用场了。

← 上一章 📖 返回目录 下一章 →