4. Linux 内核模块开发环境搭建

在嵌入式系统开发中，内核模块是扩展内核功能的首选方式，无需重新编译整个内核即可动态加载和卸载。本章将系统讲解如何搭建完整的内核模块开发环境，包括内核源码树获取、Makefile 编写、模块加载/卸载操作以及使用 printk 进行调试。

4.1 内核源码树下载与配置

内核模块的编译必须依赖对应版本的内核源码树（Kernel Source Tree），源码树提供了编译模块所需的头文件、Makefile 规则和 Kconfig 配置。

4.1.1 获取内核源码的三种方式

方式	命令/操作	适用场景
包管理器安装	apt-get install linux-source-$(uname -r)	快速开发，与当前运行内核版本匹配
内核官网下载	wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.x.tar.xz	定制内核版本，交叉编译
Git 克隆	git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git	跟踪主线开发，获取最新特性

4.1.2 解压与配置源码树

下载源码后，需要解压并执行配置步骤，生成编译模块所需的 .config 文件和 Module.symvers 符号表。

# 解压源码
tar -xvf linux-6.1.tar.xz -C /usr/src/
cd /usr/src/linux-6.1

# 使用当前运行内核的配置
zcat /proc/config.gz > .config

# 或从 /boot 目录复制
cp /boot/config-$(uname -r) .config

# 准备模块编译环境
make olddefconfig
make modules_prepare

4.2 编译内核模块的 Makefile 编写

内核模块的 Makefile 与普通用户态程序的 Makefile 有本质区别，它必须使用内核构建系统（Kbuild）提供的规则。

4.2.1 标准 Makefile 模板

# Makefile - 内核模块编译模板

# 模块名称
obj-m := inode_demo.o

# 如果模块由多个源文件组成
# inode_demo-objs := main.o helper.o

# 当前路径
PWD := $(shell pwd)

# 内核源码树路径（根据实际环境修改）
KDIR := /lib/modules/$(shell uname -r)/build

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

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

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

# 调试选项：开启额外打印
CFLAGS_inode_demo.o := -DDEBUG

4.2.2 Makefile 关键变量解析

变量	含义	示例值
obj-m	需要编译为模块的目标文件	obj-m := hello.o
obj-y	需要编译进内核的目标文件	obj-y := core.o
KDIR	内核源码树构建目录	/lib/modules/6.1.0/build
M=$(PWD)	指定模块源码所在目录	M=/home/user/module
CFLAGS_xxx.o	单个文件的编译标志	CFLAGS_hello.o := -DDEBUG

4.2.3 多文件模块的 Makefile 示例

# 多文件模块：inode_demo 由 main.c 和 helper.c 组成
obj-m := inode_demo.o
inode_demo-objs := main.o helper.o

KDIR := /lib/modules/$(shell uname -r)/build
PWD := $(shell pwd)

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

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

4.3 模块加载与卸载操作

Linux 提供了一组用户态工具来管理内核模块的生命周期，最常用的是 insmod、rmmod 和 modprobe。

4.3.1 模块操作命令对比

命令	功能	依赖处理	常用选项
insmod	加载指定模块文件	不自动解决依赖	insmod ./hello.ko
rmmod	卸载指定模块	不检查依赖	rmmod hello
modprobe	智能加载/卸载	自动解决依赖	modprobe -r hello
lsmod	列出已加载模块	—	lsmod | grep hello

4.3.2 模块加载与卸载流程

# 1. 编译模块
make

# 2. 查看模块信息（可选）
modinfo ./inode_demo.ko

# 3. 加载模块
sudo insmod ./inode_demo.ko

# 4. 验证加载
lsmod | grep inode_demo
cat /proc/modules | grep inode_demo

# 5. 卸载模块
sudo rmmod inode_demo

# 6. 使用 modprobe 加载（需要先安装到标准路径）
sudo make install
sudo modprobe inode_demo
sudo modprobe -r inode_demo

4.4 printk 调试技术

printk 是内核模块最常用的调试手段，它可以将日志信息输出到内核环形缓冲区（kernel ring buffer），通过 dmesg 查看。

4.4.1 printk 日志级别

宏定义	级别值	含义	终端显示
KERN_EMERG	0	紧急事件，系统不可用	通常显示
KERN_ALERT	1	必须立即处理	通常显示
KERN_CRIT	2	严重错误	通常显示
KERN_ERR	3	错误条件	通常显示
KERN_WARNING	4	警告	可能显示
KERN_NOTICE	5	正常但重要	可能显示
KERN_INFO	6	信息性消息	默认不显示
KERN_DEBUG	7	调试信息	默认不显示

4.4.2 模块代码中的 printk 使用示例

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

static int __init inode_demo_init(void)
{
    printk(KERN_INFO "inode_demo: module loaded\n");
    printk(KERN_DEBUG "inode_demo: debug info, pid=%d\n", current->pid);
    printk(KERN_ERR "inode_demo: this is an error example\n");
    return 0;
}

static void __exit inode_demo_exit(void)
{
    printk(KERN_INFO "inode_demo: module unloaded\n");
}

module_init(inode_demo_init);
module_exit(inode_demo_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Embedded Expert");
MODULE_DESCRIPTION("Inode allocation demo module");

4.4.3 查看 printk 输出

# 查看所有内核日志
dmesg

# 实时监控内核日志（类似 tail -f）
dmesg -w

# 只查看模块相关日志
dmesg | grep inode_demo

# 清除内核日志缓冲区
sudo dmesg -c

# 设置控制台日志级别（显示所有级别）
echo 8 > /proc/sys/kernel/printk

4.5 完整开发流程 SVG 架构图

下图展示了从源码获取到模块调试的完整开发流程，帮助理解各环节的依赖关系。

4.6 常见问题与解决方案

问题现象	可能原因	解决方案
No such file or directory	内核源码树路径错误	检查 /lib/modules/$(uname -r)/build 是否存在
Invalid module format	内核版本不匹配	确保源码版本与运行内核一致
Unknown symbol	缺少符号导出或依赖模块	使用 modprobe 自动解决依赖
Permission denied	非 root 用户操作	使用 sudo 执行 insmod/rmmod
printk 无输出	日志级别低于控制台级别	设置 echo 8 > /proc/sys/kernel/printk