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

嵌入式Linux驱动开发与普通PC端开发的核心区别在于交叉编译——在性能强大的宿主机（x86）上编译出目标板（ARM/RISC-V等）可执行的二进制模块。本章从零搭建完整开发环境，涵盖工具链安装、内核源码树准备以及模块编译Makefile的规范写法。

1.1 交叉编译工具链安装

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

安装后建议将工具链路径永久写入 ~/.bashrc：

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

1.2 内核源码树配置

驱动模块编译必须依赖内核源码树（Kernel Source Tree），即已配置并编译过的内核源码目录。源码树提供头文件、Kbuild框架和模块符号信息。

标准配置流程：

1. 获取内核源码：从 kernel.org 或芯片厂商仓库下载，版本需与目标板运行内核一致。
2. 解压并进入目录：tar xvf linux-5.10.tar.xz && cd linux-5.10
3. 加载默认配置：make ARCH=arm defconfig 或使用厂商提供的 xxx_defconfig。
4. 编译内核（可选）：make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j4。若仅编译模块，可只执行 make modules_prepare 生成 Module.symvers 等必要文件。

1.3 模块编译Makefile编写

Linux内核模块的编译依赖Kbuild系统，Makefile需遵循特定模板。以下为标准单文件模块Makefile：

# Makefile for a simple kernel module
obj-m := hello_drv.o

# 指定内核源码树路径（根据实际环境修改）
KDIR := /home/user/linux-5.10

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

all:
    $(MAKE) -C $(KDIR) M=$(PWD) modules

clean:
    $(MAKE) -C $(KDIR) M=$(PWD) clean

多文件模块时，使用 模块名-objs 语法：

obj-m := my_driver.o
my_driver-objs := main.o helper.o gpio_ops.o

关键变量说明：

1.4 开发环境整体架构

下图展示了宿主机与目标板之间的交叉编译与部署关系：

1.5 常见问题与避坑指南

• 内核版本不匹配：目标板运行内核版本必须与源码树版本一致，否则模块加载时会出现 Invalid module format 错误。
• 符号缺失：若模块依赖内核导出符号，需确保 Module.symvers 文件存在且包含对应符号。
• 架构未设置：编译前务必确认 ARCH 和 CROSS_COMPILE 已正确导出，否则会使用宿主机gcc编译，生成x86架构的无效模块。
• 权限问题：目标板加载模块需要root权限，使用 insmod 或 modprobe 前先 su 或加 sudo。