Linux内核驱动开发实战50例 - 第1节

1.1 开发环境全景概览

Linux 内核驱动开发的第一步是搭建一个稳定、可复现的编译与调试环境。本章将引导你完成从工具链安装到内核镜像生成的全流程，并深入理解内核模块的编译框架。

1.1.1 工具链安装

使用以下命令一次性安装内核编译所需的全部基础包：

sudo apt update
sudo apt install -y \
    build-essential \
    libncurses-dev \
    flex bison \
    libssl-dev \
    libelf-dev \
    bc \
    dwarves \
    git \
    qemu-system-x86 \
    gdb-multiarch

1.2 内核源码获取与版本管理

推荐从 kernel.org 获取主线源码，或使用发行版打补丁后的源码树。本课程统一使用 Linus Torvalds 的 torvalds/linux 仓库。

# 克隆主线仓库（浅克隆，节省带宽）
git clone --depth=1 --branch v6.6 https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
cd linux

1.2.1 源码目录结构

理解内核源码的顶层目录是驱动开发的基础：

1.3 内核配置与编译

内核配置是编译前最关键的一步。错误的配置会导致驱动无法加载或系统崩溃。本课程采用 defconfig 为基础，再手动开启驱动开发所需的选项。

1.3.1 配置方法对比

# 生成 x86_64 默认配置
make defconfig

# 进入菜单配置界面，开启以下选项：
#   CONFIG_MODULES=y          —— 支持模块
#   CONFIG_MODVERSIONS=y      —— 模块版本检查
#   CONFIG_DEBUG_INFO=y       —— 调试符号
make menuconfig

1.3.2 编译内核与模块

# 使用全部 CPU 核心编译内核（-j 参数）
make -j$(nproc)

# 单独编译内核模块
make modules -j$(nproc)

# 安装模块到 /lib/modules/$(uname -r)/
sudo make modules_install

# 安装内核镜像和 System.map
sudo make install

1.4 内核模块编译框架

内核模块的编译不依赖传统的 gcc 直接调用，而是通过内核构建系统（Kbuild）完成。Kbuild 会读取源码目录下的 Kbuild 或 Makefile，自动处理依赖、交叉编译和版本检查。

1.4.1 最小模块 Makefile 模板

# Makefile —— 单文件模块
obj-m := hello.o

# 如果模块由多个源文件组成：
# hello-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

1.4.2 模块入口与退出函数

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

static int __init hello_init(void)
{
    pr_info("Hello, Linux Kernel Module!\n");
    return 0;
}

static void __exit hello_exit(void)
{
    pr_info("Goodbye, Kernel Module!\n");
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("A simple Hello World module");

1.4.3 编译与测试

# 编译模块
make

# 加载模块（需要 root 权限）
sudo insmod hello.ko

# 查看内核日志
dmesg | tail -5
# 输出: [  xxx] Hello, Linux Kernel Module!

# 卸载模块
sudo rmmod hello

# 再次查看日志
dmesg | tail -5
# 输出: [  xxx] Goodbye, Kernel Module!

1.5 本章小结与实战要点

• 环境搭建：优先使用 Ubuntu/Debian，安装 build-essential 及内核编译依赖。
• 源码管理：使用 git clone --depth=1 获取主线内核，避免下载完整历史。
• 配置编译：make defconfig 后通过 menuconfig 开启 CONFIG_MODULES 和 CONFIG_DEBUG_INFO。
• 模块框架：牢记 obj-m 与 module_init/module_exit 的配对使用。
• 调试手段：dmesg 是驱动开发者的第一调试工具，学会过滤关键词 dmesg | grep -i hello。