4. GPIO驱动开发环境搭建：交叉编译工具链、内核源码树、模块编译Makefile

4.3 模块编译Makefile

GPIO驱动模块的编译依赖内核源码树的Kbuild系统。一个标准的外置模块Makefile只需寥寥数行，但必须正确设置变量。

4.3.1 最小化Makefile模板

# Makefile - GPIO驱动模块编译
# 使用方式：make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-

# 模块名称（最终生成gpio_led.ko）
obj-m := gpio_led.o

# 若模块由多个源文件组成，使用模块名-y
# gpio_led-y := gpio_led_main.o gpio_led_utils.o

# 内核源码树路径（根据实际位置修改）
KDIR := /home/user/kernel/linux-stm32mp-5.10.10-stm32mp-r1

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

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

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

install:
	$(MAKE) -C $(KDIR) M=$(PWD) modules_install
	depmod -a

4.3.2 Makefile关键变量解析

4.3.3 编译与加载流程

1. 编译模块：在模块源码目录执行make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-
2. 检查产物：生成gpio_led.ko、gpio_led.mod.c、Module.symvers（模块级）
3. 验证模块信息：arm-linux-gnueabihf-objdump -d gpio_led.ko | head -20 确认是ARM指令
4. 传输至目标板：通过scp/NFS/USB复制.ko文件
5. 目标板加载：insmod gpio_led.ko 或 modprobe gpio_led

4.4 环境验证：编译一个空壳GPIO模块

为验证整个工具链和Makefile是否正常工作，我们编译一个最简单的GPIO驱动框架（仅包含模块初始化和退出函数）：

// gpio_led.c - 空壳GPIO驱动，用于验证编译环境
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/gpio.h>

static int __init gpio_led_init(void)
{
    pr_info("GPIO LED driver initialized\n");
    return 0;
}

static void __exit gpio_led_exit(void)
{
    pr_info("GPIO LED driver exited\n");
}

module_init(gpio_led_init);
module_exit(gpio_led_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Embedded Linux Course");
MODULE_DESCRIPTION("GPIO LED driver - environment test");

将上述文件与Makefile置于同一目录，执行编译命令。若终端输出类似：

make[1]: Entering directory '/home/user/kernel/linux-stm32mp-5.10.10-stm32mp-r1'
  CC [M]  /home/user/gpio_driver/gpio_led.o
  MODPOST /home/user/gpio_driver/Module.symvers
  CC [M]  /home/user/gpio_driver/gpio_led.mod.o
  LD [M]  /home/user/gpio_driver/gpio_led.ko
make[1]: Leaving directory '/home/user/kernel/linux-stm32mp-5.10.10-stm32mp-r1'

则环境搭建成功，可以进入下一章的实际GPIO输出驱动开发。

4.5 本章小结