2. 开发环境搭建

Linux 驱动开发不是“打开编辑器写 C 文件”这么简单，它是一条从宿主机到目标板的完整工具链。宿主机负责编辑、编译、调试；目标板负责运行内核与驱动；QEMU 则在没有真实硬件时提供可重复的验证环境。本节把这条链路拆成五个可操作的环节：Ubuntu 基础环境、交叉编译工具链、QEMU 虚拟平台、开发板环境配置、内核源码获取与版本管理。

一、核心原理：为什么需要“宿主机—工具链—目标机”三段式

驱动代码最终要编译成目标 CPU 架构的机器码，而你的 PC 通常是 x86_64。直接在 PC 上编译出的 .ko 无法在 ARM 开发板上加载，因此必须使用交叉编译工具链。工具链中的 gcc、ld、objcopy 等程序运行在 x86_64 上，但生成的是 ARM/AArch64 指令。内核模块还必须与目标内核的版本、配置、符号表严格匹配，否则会出现 “version magic” 或 “unknown symbol” 错误。

QEMU 的价值在于：它模拟目标 CPU 和部分外设，可以加载你编译的内核与 rootfs，快速验证驱动是否 probe 成功。真实开发板则用于验证时序、中断、DMA 等 QEMU 难以完全模拟的行为。两者配合，能显著降低“每次都要烧写板子”的时间成本。

二、方法流程：五步搭建可复现环境

1. 安装 Ubuntu 基础包。推荐 Ubuntu 20.04 LTS 或 22.04 LTS，避免使用滚动发行版导致工具链版本漂移。安装后执行：

   sudo apt update
   sudo apt install -y build-essential git vim minicom \
       libncurses-dev bison flex libssl-dev bc \
       qemu-system-arm qemu-system-aarch64 gcc-arm-linux-gnueabihf

2. 验证交叉编译工具链。安装后确认前缀与版本：

   arm-linux-gnueabihf-gcc -v
   # 输出中应看到 Target: arm-linux-gnueabihf
   # gcc version 9.x 或 11.x

   若使用厂商 SDK，通常会把工具链放在 /opt/toolchain/ 下，需要手动加入 PATH：

   export PATH=$PATH:/opt/toolchain/gcc-arm-10.3/bin
   export CROSS_COMPILE=arm-linux-gnueabihf-
   export ARCH=arm

3. 准备 QEMU 虚拟平台。以 vexpress-a9 为例，启动命令如下：

   qemu-system-arm -M vexpress-a9 -m 512M \
     -kernel arch/arm/boot/zImage \
     -dtb arch/arm/boot/dts/vexpress-v2p-ca9.dtb \
     -append "root=/dev/mmcblk0 rw console=ttyAMA0" \
     -sd rootfs.ext4 -nographic

4. 配置开发板环境。通过串口连接板子，进入 U-Boot 后设置启动参数：

   setenv ipaddr 192.168.1.100
   setenv serverip 192.168.1.10
   setenv bootargs 'root=/dev/nfs rw nfsroot=192.168.1.10:/nfsroot ip=192.168.1.100 console=ttyS0,115200'
   setenv bootcmd 'tftp 0x80008000 zImage; tftp 0x82000000 vexpress.dtb; bootz 0x80008000 - 0x82000000'
   saveenv

5. 获取内核源码。优先使用开发板厂商提供的 BSP 内核，其次使用 kernel.org 主线：

   git clone --depth=1 -b linux-5.10.y \
       https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
   cd linux
   make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- vexpress_defconfig
   make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig
   make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j$(nproc) zImage modules dtbs

三、案例场景：从零编译一个 hello 驱动并在 QEMU 中加载

假设内核源码位于 ~/linux-5.10，编写一个最小模块：

// hello.c
#include <linux/module.h>
#include <linux/init.h>

static int __init hello_init(void)
{
    pr_info("hello driver: init\n");
    return 0;
}

static void __exit hello_exit(void)
{
    pr_info("hello driver: exit\n");
}

module_init(hello_init);
module_exit(hello_exit);
MODULE_LICENSE("GPL");

对应的 Makefile 必须指向已编译的内核目录：

obj-m += hello.o
KERNELDIR := /home/user/linux-5.10
PWD := $(shell pwd)

all:
    make -C $(KERNELDIR) M=$(PWD) modules
clean:
    make -C $(KERNELDIR) M=$(PWD) clean

编译后得到 hello.ko，通过 NFS 或 scp 拷贝到 QEMU 文件系统，执行 insmod hello.ko，再用 dmesg | tail 查看打印。若出现 “invalid module format”，说明内核版本或配置不匹配；若出现 “unknown symbol”，说明依赖模块未加载或符号未导出。

四、误区与复盘：环境搭建中最容易踩的坑