4. 第一个字符设备驱动：Hello World驱动编写、模块初始化与退出函数、module_init/module_exit宏、编译与加载测试

本章是字符设备驱动开发的起点。我们将从零编写一个最简单的“Hello World”内核模块，通过它理解驱动模块的生命周期：加载 → 初始化 → 运行 → 卸载 → 退出。你将掌握 module_init 与 module_exit 宏的底层机制，并完成编译、加载、验证与卸载的完整闭环。

4.1 内核模块的基本结构

一个字符设备驱动本质上是一个可加载内核模块（Loadable Kernel Module, LKM）。它不依赖完整的应用程序框架，而是通过内核提供的 API 与内核空间交互。每个模块必须包含两个核心函数：

4.2 编写 Hello World 驱动代码

下面是一个完整的字符设备驱动骨架，它不操作硬件，只在加载和卸载时打印信息，并创建一个简单的设备节点。

#include <linux/module.h>      // 模块相关宏和函数
#include <linux/kernel.h>      // printk, KERN_INFO
#include <linux/fs.h>          // 文件操作结构体
#include <linux/device.h>      // 设备类
#include <linux/cdev.h>        // 字符设备结构体

#define DEVICE_NAME "hello_dev"
#define CLASS_NAME  "hello_class"

static int major_num;                 // 主设备号
static struct class *hello_class = NULL;
static struct device *hello_device = NULL;
static struct cdev hello_cdev;

// 设备打开函数（空实现）
static int hello_open(struct inode *inodep, struct file *filep) {
    printk(KERN_INFO "hello_dev: device opened\n");
    return 0;
}

// 设备释放函数（空实现）
static int hello_release(struct inode *inodep, struct file *filep) {
    printk(KERN_INFO "hello_dev: device closed\n");
    return 0;
}

// 文件操作结构体：关联用户空间操作与驱动函数
static struct file_operations hello_fops = {
    .owner   = THIS_MODULE,
    .open    = hello_open,
    .release = hello_release,
};

// 模块初始化函数
static int __init hello_init(void) {
    dev_t dev_num;

    printk(KERN_INFO "hello_dev: Initializing...\n");

    // 1. 动态分配主设备号
    if (alloc_chrdev_region(&dev_num, 0, 1, DEVICE_NAME) < 0) {
        printk(KERN_ALERT "hello_dev: Failed to allocate major number\n");
        return -1;
    }
    major_num = MAJOR(dev_num);
    printk(KERN_INFO "hello_dev: Major number = %d\n", major_num);

    // 2. 初始化 cdev 并添加到内核
    cdev_init(&hello_cdev, &hello_fops);
    hello_cdev.owner = THIS_MODULE;
    if (cdev_add(&hello_cdev, dev_num, 1) < 0) {
        printk(KERN_ALERT "hello_dev: Failed to add cdev\n");
        unregister_chrdev_region(dev_num, 1);
        return -1;
    }

    // 3. 创建设备类（在 /sys/class 下可见）
    hello_class = class_create(THIS_MODULE, CLASS_NAME);
    if (IS_ERR(hello_class)) {
        printk(KERN_ALERT "hello_dev: Failed to create class\n");
        cdev_del(&hello_cdev);
        unregister_chrdev_region(dev_num, 1);
        return PTR_ERR(hello_class);
    }

    // 4. 创建设备节点（自动在 /dev 下生成）
    hello_device = device_create(hello_class, NULL, dev_num, NULL, DEVICE_NAME);
    if (IS_ERR(hello_device)) {
        printk(KERN_ALERT "hello_dev: Failed to create device\n");
        class_destroy(hello_class);
        cdev_del(&hello_cdev);
        unregister_chrdev_region(dev_num, 1);
        return PTR_ERR(hello_device);
    }

    printk(KERN_INFO "hello_dev: Hello World! Driver loaded successfully.\n");
    return 0;
}

// 模块退出函数
static void __exit hello_exit(void) {
    dev_t dev_num = MKDEV(major_num, 0);

    device_destroy(hello_class, dev_num);   // 移除设备节点
    class_destroy(hello_class);             // 移除设备类
    cdev_del(&hello_cdev);                  // 从内核删除 cdev
    unregister_chrdev_region(dev_num, 1);   // 释放设备号

    printk(KERN_INFO "hello_dev: Goodbye! Driver unloaded.\n");
}

// 注册模块入口/出口
module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("A simple Hello World character device driver");
MODULE_VERSION("1.0");

4.3 module_init / module_exit 宏的底层机制

这两个宏是驱动与内核链接的“胶水”。它们不是简单的函数声明，而是通过编译器属性将函数指针放入特定的 ELF 段中。

宏展开后的实际效果：

• module_init(hello_init) → 将 hello_init 的函数指针放入 .initcall6.init 段（优先级 6 是普通驱动级别）。
• module_exit(hello_exit) → 将 hello_exit 的函数指针放入 .exitcall.exit 段。
• 内核在 insmod 时扫描 .initcall 段，按优先级依次调用；rmmod 时调用 .exitcall 段中的函数。

4.4 Makefile 编写与编译

内核模块的编译必须依赖内核源码树（或内核头文件包）。标准 Makefile 模板如下：

# Makefile for hello_dev driver

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

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

# 目标模块名称
obj-m := hello_dev.o

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

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

install:
    sudo insmod hello_dev.ko

remove:
    sudo rmmod hello_dev

info:
    lsmod | grep hello_dev
    dmesg | tail -10

编译步骤：

1. 将 hello_dev.c 和 Makefile 放在同一目录。
2. 执行 make，生成 hello_dev.ko（内核对象文件）。
3. 使用 file hello_dev.ko 确认文件类型为 ELF 64-bit LSB relocatable。

4.5 加载、测试与卸载

编译成功后，按以下步骤验证驱动：

4.6 驱动加载与卸载的完整生命周期

下面的 SVG 图展示了从 insmod 到 rmmod 的完整调用链：

4.7 常见问题与避坑指南

• 模块加载失败：insmod: ERROR: could not insert module — 使用 dmesg 查看具体错误，通常是设备号冲突或内存不足。
• 设备节点未出现： 确认 udev 服务是否运行，或手动创建 mknod /dev/hello_dev c <major> 0。
• 卸载时内核崩溃： 检查退出函数中是否释放了所有申请的资源，特别是 cdev_del 和 unregister_chrdev_region 的顺序。
• 权限问题： 加载/卸载模块需要 root 权限，使用 sudo 执行。