1. Linux 驱动开发环境搭建

在开始编写字符设备驱动之前，必须搭建一套完整的交叉编译与内核模块开发环境。本章节将依次讲解交叉编译工具链的安装、内核源码树的配置以及模块编译 Makefile 的编写规范，为后续的中断处理与 ioctl 接口实现打下坚实基础。

1.1 交叉编译工具链安装

交叉编译工具链允许我们在 x86 主机上编译出 ARM 架构可执行的二进制文件。推荐使用 Linaro 提供的预编译工具链，稳定且社区支持广泛。

1.1.1 下载与解压

# 创建工作目录
mkdir -p ~/arm_toolchain && cd ~/arm_toolchain

# 下载 Linaro GCC 7.5.0 ARM 硬浮点工具链
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

# 解压
tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz

# 查看工具链内容
ls gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin/

1.1.2 环境变量配置

将工具链路径加入 PATH，并设置交叉编译前缀变量，方便后续 Makefile 引用。

# 编辑 ~/.bashrc 或 ~/.zshrc，追加以下内容
export PATH=$PATH:~/arm_toolchain/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin
export CROSS_COMPILE=arm-linux-gnueabihf-
export ARCH=arm

# 使配置生效
source ~/.bashrc

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

1.1.3 工具链组件说明

1.2 内核源码树配置

驱动模块的编译必须依赖内核源码树（Kernel Source Tree）提供的头文件、Makefile 规则和编译脚本。我们使用官方 LTS 内核并配置为 ARM 架构。

1.2.1 获取内核源码

# 下载 Linux 5.10 LTS 内核
cd ~
wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.10.210.tar.xz
tar -xvf linux-5.10.210.tar.xz
cd linux-5.10.210

1.2.2 配置内核

使用默认的 ARM 多平台配置（multi_v7_defconfig），该配置支持大多数 ARMv7 开发板。

# 设置架构与交叉编译器
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-

# 加载默认配置
make multi_v7_defconfig

# 可选：使用 menuconfig 进行微调（如开启调试符号）
make menuconfig

1.2.3 编译内核（可选但推荐）

编译一次内核可生成必要的 Module.symvers 和 include/generated/ 下的自动头文件，确保模块编译时符号解析正确。

# 编译内核（使用 4 核加速，根据主机 CPU 调整）
make -j4 zImage

# 编译设备树
make -j4 dtbs

# 编译模块（可选，用于验证）
make -j4 modules

1.2.4 内核源码树结构速览

1.3 模块编译 Makefile 编写

内核模块的编译使用内核提供的 kbuild 系统。我们只需编写一个简洁的 Makefile，通过 make -C 指向内核源码树即可完成交叉编译。

1.3.1 基础 Makefile 模板

# Makefile —— 字符设备驱动模块编译
# 目标：编译 mychardev.ko

# 模块名称（不带 .ko 后缀）
obj-m := mychardev.o

# 若模块由多个源文件组成，使用如下格式：
# mychardev-objs := file1.o file2.o

# 内核源码树路径（根据实际位置修改）
KDIR := ~/linux-5.10.210

# 当前目录
PWD := $(shell pwd)

# 默认目标：编译模块
all:
	$(MAKE) -C $(KDIR) M=$(PWD) ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules

# 清理目标
clean:
	$(MAKE) -C $(KDIR) M=$(PWD) ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- clean

# 安装模块到临时目录（可选）
install:
	$(MAKE) -C $(KDIR) M=$(PWD) ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules_install INSTALL_MOD_PATH=./modules_install

1.3.2 Makefile 关键变量解析

1.3.3 编译与验证

# 进入驱动源码目录
cd ~/driver_project

# 编译模块
make

# 预期输出示例：
# make -C ~/linux-5.10.210 M=/home/user/driver_project ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules
#   CC [M]  mychardev.o
#   MODPOST mychardev.mod.c
#   CC [M]  mychardev.mod.o
#   LD [M]  mychardev.ko

# 查看生成的模块信息
arm-linux-gnueabihf-objdump -h mychardev.ko | head -20
arm-linux-gnueabihf-modinfo mychardev.ko

1.3.4 多文件模块 Makefile 示例

当驱动由多个源文件组成时，使用 <模块名>-objs 语法指定目标文件列表。

# Makefile —— 多文件模块示例
obj-m := mychardev.o
mychardev-objs := main.o ioctl.o interrupt.o

KDIR := ~/linux-5.10.210
PWD := $(shell pwd)

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

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

1.4 环境验证与测试

完成上述步骤后，编写一个最简单的“空模块”来验证整个工具链是否正常工作。

1.4.1 最小驱动源码

// test_dummy.c
#include <linux/module.h>
#include <linux/kernel.h>

static int __init dummy_init(void)
{
    pr_info("Dummy module loaded\n");
    return 0;
}

static void __exit dummy_exit(void)
{
    pr_info("Dummy module unloaded\n");
}

module_init(dummy_init);
module_exit(dummy_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Driver Expert");
MODULE_DESCRIPTION("A minimal dummy module for environment verification");

1.4.2 编译与检查

# 编译
make

# 检查模块架构
file test_dummy.ko
# 输出应包含：ELF 32-bit LSB relocatable, ARM, version 1 (ARM)

# 查看模块符号
arm-linux-gnueabihf-nm test_dummy.ko | grep -E "init|exit"

1.5 本章小结

• 交叉编译工具链：使用 Linaro GCC 7.5 ARM 硬浮点版本，配置 PATH、CROSS_COMPILE 和 ARCH 环境变量。
• 内核源码树：下载 Linux 5.10 LTS，执行 multi_v7_defconfig 并至少编译一次内核以生成依赖文件。
• Makefile 编写：利用 kbuild 系统，通过 obj-m 指定模块，KDIR 指向内核源码树，ARCH 和 CROSS_COMPILE 确保交叉编译。
• 验证方法：编译最小驱动并用 file、nm 确认架构与符号正确。