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

嵌入式 Linux 驱动开发与普通 PC 开发最大的区别在于交叉编译。目标板（ARM、RISC-V 等）资源有限，无法运行完整的编译工具链，因此需要在性能强劲的宿主机（x86_64）上编译出目标架构的二进制模块，再部署到目标板运行。本章将完整搭建这一基础环境。

1.1 交叉编译工具链安装

交叉编译工具链（Cross-Compilation Toolchain）包含针对目标架构的编译器、链接器、库和头文件。常见获取方式有两种：

以 Ubuntu 宿主机 + ARM Cortex-A7 目标板为例，安装 Linaro 工具链：

# 下载并解压到 /opt
wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz
sudo tar -xf gcc-linaro-*.tar.xz -C /opt

# 添加至 PATH
export PATH=/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATH

# 验证安装
arm-linux-gnueabihf-gcc --version

1.2 内核源码树配置

驱动模块必须依赖完整的内核源码树（Kernel Source Tree）进行编译。源码树需要预先配置，生成 .config 和 Module.symvers 等关键文件。

配置流程分为三步：

1. 获取内核源码：从 kernel.org 或芯片厂商 BSP 获取，版本必须与目标板运行内核一致。
2. 生成默认配置：使用目标板厂商提供的 defconfig，或从目标板 /proc/config.gz 导出。
3. 编译内核与模块：先编译完整内核，再编译模块，确保 Module.symvers 生成。

# 以 i.MX6ULL EVK 为例
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-
make imx_v7_defconfig
make -j4 zImage modules
make modules_install INSTALL_MOD_PATH=./modules_install

1.3 模块编译与加载基础

驱动模块的编译依赖内核源码树提供的 Kbuild 系统。开发者只需编写 Makefile，指定模块名和源文件，Kbuild 会自动处理交叉编译参数。

一个最简单的驱动模块 Makefile 模板：

# Makefile — 外部模块编译
obj-m := hello_drv.o
hello_drv-objs := hello.o

KERNEL_DIR ?= /home/user/linux-imx
CROSS_COMPILE ?= arm-linux-gnueabihf-

all:
	make -C $(KERNEL_DIR) M=$(PWD) ARCH=arm CROSS_COMPILE=$(CROSS_COMPILE) modules

clean:
	make -C $(KERNEL_DIR) M=$(PWD) ARCH=arm clean

编译后生成 hello_drv.ko，部署到目标板后使用以下命令管理：

1.4 环境搭建全流程 SVG 图

下图展示了从宿主机到目标板的完整环境搭建链路，以及模块编译、部署、加载的流程关系：

1.5 常见问题与避坑

• 模块加载报错 Invalid module format：内核版本或 vermagic 不一致。用 modinfo 对比模块与内核的 vermagic 字符串。
• Unknown symbol 错误：模块引用了未导出的内核符号，或 Module.symvers 未正确生成。重新编译内核并确认 EXPORT_SYMBOL。
• insmod 后无任何输出：检查 printk 日志级别，使用 dmesg -n 8 提升控制台显示级别。
• 模块卸载时系统崩溃：exit 函数中释放了仍在使用的资源，或未正确注销 input 设备。