📚 课程目录第2章开发环境搭建

2、开发环境搭建：安装Linux虚拟机或双系统、配置内核源码树、安装交叉编译工具链、使用QEMU模拟硬件平台

Linux驱动开发与普通应用程序开发最大的区别在于：驱动代码无法直接在宿主机（Host）上独立运行，它必须与特定版本的内核源码树（Kernel Source Tree）绑定，并最终运行在目标硬件平台（Target）上。因此，搭建一套高效、可复现的开发环境，是整个驱动学习路径的基石。本章将围绕“宿主系统准备—内核源码配置—交叉编译链安装—QEMU模拟验证”四条主线展开，帮助你从零构建一套完整的驱动开发闭环。

2.1 宿主系统准备：虚拟机与双系统的选型与安装

核心原理

Linux驱动模块（.ko文件）本质上是内核的一部分，它依赖内核提供的符号（如printk、kmalloc）和数据结构。因此，驱动开发首先需要一个完整的Linux环境来编译内核和模块。虚拟机（VM）与双系统（Dual Boot）是两种主流方案：虚拟机通过Hypervisor（如VMware、VirtualBox）在宿主机操作系统之上虚拟出完整硬件，隔离性好、切换方便；双系统则直接让Linux独占物理硬件，性能损耗小，适合需要大量编译或使用特定硬件设备（如USB调试器、JTAG）的场景。

判断方法或操作流程

对比维度	虚拟机方案	双系统方案
安装难度	低，无需分区	中，需处理引导项
性能损耗	约5%-15%	接近原生
硬件访问	USB可穿透，PCIe设备受限	完全访问
适合场景	学习、纯软件模拟	嵌入式开发、硬件调试
磁盘占用	动态增长，约20-40GB	固定分区，建议60GB+

推荐初学者使用虚拟机（VMware Workstation Player免费版），分配4核CPU、8GB内存、80GB磁盘。安装Ubuntu 22.04 LTS时，勾选“安装第三方软件”以获取无线网卡驱动。安装完成后执行sudo apt update && sudo apt upgrade，并安装基础工具：build-essential、git、vim、net-tools。

经验提醒：虚拟机网络建议选择“桥接模式”（Bridged），这样QEMU模拟的目标机可以直接与宿主机通信，方便后续通过NFS或TFTP传输内核镜像和驱动模块。

案例拆解：虚拟机磁盘扩容

某学员在编译内核时遇到No space left on device错误。检查发现VMware虚拟磁盘初始分配20GB，已用95%。处理步骤：

关闭虚拟机，在VMware设置中扩展磁盘至80GB。
启动系统，使用gparted工具调整分区大小：sudo apt install gparted，将sda1扩展至满。
执行df -h确认空间释放。

复盘：虚拟磁盘应从一开始就分配足够空间，避免后期扩容带来的分区调整风险。

2.2 配置内核源码树：版本选择与编译准备

核心原理

驱动模块必须与运行中的内核版本严格匹配。内核源码树（Kernel Source Tree）是编译模块的“头文件库”和“符号表来源”。Module.symvers文件记录了内核导出的符号（函数、变量），编译模块时链接器会检查这些符号是否存在。因此，配置源码树的核心任务是：生成与目标内核完全一致的.config和Module.symvers。

操作流程

# 1. 下载内核源码（以6.6.1为例）
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.1.tar.xz
tar -xf linux-6.6.1.tar.xz -C /home/dev/kernel/
cd /home/dev/kernel/linux-6.6.1

# 2. 配置内核（使用当前运行内核的配置作为基础）
cp /boot/config-$(uname -r) .config
make menuconfig  # 图形化界面，直接Exit保存

# 3. 准备模块编译环境
make modules_prepare  # 生成 Module.symvers 和 include/generated/autoconf.h

# 4. 可选：编译内核（若需运行自定义内核）
make -j$(nproc) Image dtbs

风险提示：不要使用make oldconfig直接覆盖配置，因为新内核可能引入新的配置项。建议先cp现有配置，再通过menuconfig手动确认新增项。

常见误区

误区1：认为编译模块必须完整编译内核。实际上make modules_prepare即可满足大多数模块编译需求。
误区2：忽略uname -r版本匹配。如果目标板运行的是5.15内核，而源码树是6.6，模块加载时会报version magic错误。
误区3：修改.config后不重新执行make modules_prepare，导致符号表过期。

2.3 安装交叉编译工具链：从宿主机到目标机的桥梁

核心原理

交叉编译（Cross Compilation）是指在x86架构的宿主机上，编译生成ARM架构（或其他架构）可执行代码的过程。工具链包含编译器（gcc）、汇编器（as）、链接器（ld）以及对应的C库（glibc）。对于驱动开发，我们主要使用aarch64-linux-gnu-gcc（64位ARM）或arm-linux-gnueabihf-gcc（32位ARM）。

安装与配置

# 下载Linaro工具链（以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-*.tar.xz -C /opt/

# 设置环境变量（写入 ~/.bashrc）
export PATH=/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin:$PATH
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-

# 验证
aarch64-linux-gnu-gcc --version

案例拆解：编译第一个驱动模块

编写一个最简单的hello.c驱动，使用交叉编译链编译：

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

static int __init hello_init(void) {
    printk(KERN_INFO "Hello, Linux driver!\n");
    return 0;
}
static void __exit hello_exit(void) {
    printk(KERN_INFO "Goodbye, Linux driver!\n");
}
module_init(hello_init);
module_exit(hello_exit);
MODULE_LICENSE("GPL");

// Makefile
obj-m := hello.o
KDIR := /home/dev/kernel/linux-6.6.1
all:
    make -C $(KDIR) M=$(PWD) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- modules
clean:
    make -C $(KDIR) M=$(PWD) ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- clean

执行make后生成hello.ko。使用file hello.ko查看，确认是ARM架构的ELF文件。

  关键参数说明：ARCH=arm64告诉内核源码树使用arm64架构的配置；CROSS_COMPILE指定编译器前缀。两者缺一不可，否则会调用宿主机的gcc编译出x86模块。

2.4 使用QEMU模拟硬件平台：验证驱动的“虚拟战场”

核心原理

QEMU（Quick Emulator）是一个纯软件模拟器，可以模拟完整的ARM开发板（如virt、vexpress-a9）。对于驱动开发者，QEMU的价值在于：无需真实硬件即可验证模块的加载/卸载逻辑、调试内存访问错误、测试中断处理流程。它通过-kernel参数加载内核镜像，-initrd加载根文件系统，-append传递内核启动参数。

操作流程

# 1. 安装QEMU
sudo apt install qemu-system-arm qemu-user-static

# 2. 准备根文件系统（使用BusyBox制作最小rootfs）
mkdir -p rootfs/{bin,sbin,etc,proc,sys,dev,lib}
wget https://busybox.net/downloads/binaries/1.35.0-x86_64-linux-musl/busybox
chmod +x busybox && cp busybox rootfs/bin/
# 创建关键设备节点
sudo mknod -m 666 rootfs/dev/console c 5 1
sudo mknod -m 666 rootfs/dev/null c 1 3

# 3. 启动QEMU（virt平台，ARM64）
qemu-system-aarch64 -M virt -cpu cortex-a57 -smp 2 -m 1G \
  -kernel /home/dev/kernel/linux-6.6.1/arch/arm64/boot/Image \
  -initrd rootfs.img \
  -append "console=ttyAMA0 root=/dev/ram rdinit=/bin/sh" \
  -nographic

案例拆解：加载驱动并验证

在QEMU启动的shell中，通过NFS或共享目录将hello.ko传入：

# 宿主机上启动NFS服务
sudo apt install nfs-kernel-server
echo "/home/dev/nfs *(rw,sync,no_root_squash)" | sudo tee -a /etc/exports
sudo exportfs -ra

# QEMU启动参数增加：-netdev user,id=net0 -device virtio-net-device,netdev=net0
# 在QEMU shell中挂载NFS
mount -t nfs -o nolock 10.0.2.2:/home/dev/nfs /mnt
insmod /mnt/hello.ko
dmesg | tail -5  # 应看到 "Hello, Linux driver!"

排障要点：如果insmod报Invalid module format，检查模块的vermagic是否与内核一致。使用modinfo hello.ko查看vermagic，对比uname -r。若不一致，重新执行make modules_prepare并重编模块。

常见误区与总结

误区1：QEMU模拟的virt平台没有真实的中断控制器，不适合调试依赖特定硬件中断的驱动。此时应选择-M vexpress-a9或使用Device Tree描述自定义外设。
误区2：忽略-cpu参数，导致内核编译时使用错误的CPU特性（如未启用NEON指令集）。
误区3：根文件系统缺少/dev节点，导致insmod后无法创建设备文件。建议在rootfs中预置mdev或udev。

总结：本章搭建的环境是后续所有驱动实验的基础。虚拟机提供稳定的编译环境，内核源码树保证模块与内核的兼容性，交叉编译链生成目标架构代码，QEMU则充当低成本的硬件验证平台。建议读者按照“先编译内核模块，再通过QEMU加载验证”的顺序，完成至少三次完整的“编写—编译—加载—卸载”循环，以熟悉整个工具链的运作机制。