📚 课程目录第1章 Linux驱动开发环境搭建

1. Linux驱动开发环境搭建：交叉编译工具链配置、内核源码树构建、模块编译与加载基础

说实话，驱动开发的第一步往往最劝退人。我见过不少新手，代码写得挺溜，结果卡在环境搭建上好几天。其实说白了，嵌入式Linux驱动开发环境就三块：交叉编译工具链、内核源码树、模块编译与加载。咱们一个一个来拆。

1.1 交叉编译工具链配置

为什么需要交叉编译？你想想看，你的开发机是x86架构，目标板是ARM（或者RISC-V、MIPS），x86上编译出来的二进制ARM根本跑不了。所以我们需要一套能在x86上运行、但生成ARM指令的工具链——这就是交叉编译工具链。

核心概念：交叉编译工具链 = 编译器 + 链接器 + 库 + 头文件，统一前缀如 arm-linux-gnueabihf-。

1.1.1 获取工具链的三种方式

方式	来源	适用场景	我踩过的坑
芯片厂商SDK	NXP、TI、Rockchip等官方包	量产项目，最稳妥	版本捆绑死，升级内核可能不兼容
Linaro预编译包	`gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf`	快速原型验证	glibc版本与目标rootfs不匹配
Buildroot/Yocto自编译	源码构建	定制化需求	第一次编译要几个小时，别问我怎么知道的

1.1.2 环境变量配置

我个人习惯把工具链路径加到 ~/.bashrc 里，一劳永逸：

export CROSS_COMPILE=arm-linux-gnueabihf-
export ARCH=arm
export PATH=$PATH:/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin

验证是否配置成功：

$ arm-linux-gnueabihf-gcc --version
arm-linux-gnueabihf-gcc (Linaro GCC 7.5-2019.12) 7.5.0

我曾经遇到过 arm-linux-gnueabihf-gcc: command not found，折腾半天发现是64位系统没装32位兼容库。Ubuntu上执行 sudo apt install lib32z1 lib32ncurses5 即可解决。

1.2 内核源码树构建

驱动模块本质上是内核的一部分，编译时必须依赖内核源码树。说白了，你需要一份完整的内核源码，并且至少完成一次配置和编译，生成 Module.symvers 和 include/generated/ 等文件。

1.2.1 获取内核源码

我建议直接从官方仓库拉取：

$ git clone --depth=1 git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
$ cd linux
$ git checkout v5.10.100  # 选一个长期支持版本

如果你用的是芯片厂商的BSP，那就用他们提供的源码树。嗯，这里要注意：不要混用不同版本的内核头文件，否则编译出来的模块加载时会报 version magic 不匹配。

1.2.2 配置与编译内核

配置内核有两种常见方式：

使用厂商默认配置：make ARCH=arm xxx_defconfig
从当前系统拷贝：make ARCH=arm menuconfig 手动调整

我个人习惯先用默认配置，再微调：

$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- imx_v7_defconfig
$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j4 zImage modules

这一步会生成 vmlinux、zImage 以及 Module.symvers。后者是驱动模块编译时必需的符号表。

小技巧：如果只是编译外部模块，不需要完整编译内核。但至少需要执行 make scripts 和 make modules_prepare。我在项目中经常用这个来节省时间。

1.3 模块编译与加载基础

环境搭好了，咱们写一个最简单的驱动模块试试手。

1.3.1 编写一个Hello模块

创建一个 hello.c：

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

static int __init hello_init(void)
{
    printk(KERN_INFO "Hello, Embedded Linux Driver!\n");
    return 0;
}

static void __exit hello_exit(void)
{
    printk(KERN_INFO "Goodbye, Embedded Linux Driver!\n");
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("A simple Hello World module");

1.3.2 编写Makefile

这是关键。很多新手在这里翻车。Makefile必须利用内核的构建系统：

obj-m := hello.o

KDIR := /home/user/linux-5.10.100
CROSS := arm-linux-gnueabihf-

all:
    $(MAKE) -C $(KDIR) M=$(PWD) ARCH=arm CROSS_COMPILE=$(CROSS) modules

clean:
    $(MAKE) -C $(KDIR) M=$(PWD) ARCH=arm CROSS_COMPILE=$(CROSS) clean

注意：KDIR 指向的是内核源码树根目录，不是 /lib/modules/$(uname -r)/build。后者是宿主机内核头文件，不能用于交叉编译。我曾经在这上面浪费了半天。

1.3.3 编译与加载

执行 make，生成 hello.ko。把它拷贝到目标板上：

$ scp hello.ko root@192.168.1.100:/root/
$ ssh root@192.168.1.100
# insmod hello.ko
# dmesg | tail
[ 1234.5678] Hello, Embedded Linux Driver!
# rmmod hello
# dmesg | tail
[ 1235.6789] Goodbye, Embedded Linux Driver!

看到这两行打印，说明你的环境搭建成功了。

1.4 知识体系总览

下面这张图把本章的核心逻辑串起来了：

1.5 避坑指南汇总

工具链与内核版本不匹配：我曾经用Linaro 7.5编译5.15内核，结果模块加载时直接panic。后来换成芯片厂商推荐的gcc 9.2才稳定。
忘记执行 make modules_prepare：编译模块时提示找不到 include/generated/autoconf.h。跑一遍 make modules_prepare 就好。
目标板内核与源码树不一致：insmod 时报 version magic '5.10.100 SMP preempt mod_unload ARMv7' should be '5.10.100+ SMP preempt mod_unload ARMv7'。这是因为源码树有本地改动，用 make localmodconfig 重新生成配置即可。
权限问题：insmod 需要root权限。我习惯在目标板上用 su 或者 sudo 执行。

我的建议：第一次搭建环境时，用一块成熟的开发板（比如i.MX6ULL或STM32MP157），配合厂商提供的SDK。等流程跑通了，再切换到自己的板子上。这样能快速区分是环境问题还是硬件问题。

好了，环境搭建这部分就到这里。记住：工具链、内核树、Makefile，这三样东西配齐了，驱动开发的大门就打开了。后面咱们再聊具体的驱动框架和休眠唤醒调试。