Linux字符设备驱动开发实战：从零构建你的第一个内核模块

咖啡JSON

415人浏览 · 2026-02-14 00:55:17

咖啡JSON · 2026-02-14 00:55:17 发布

1. 初识Linux字符设备驱动

大家好，今天我们来聊聊Linux字符设备驱动的开发。如果你对Linux驱动编程感兴趣，但又觉得它高深莫测，那这篇文章就是为你准备的。我会用最直白的方式，带你从零开始构建第一个内核模块，让你真正理解字符设备驱动的来龙去脉。

Linux系统中的设备驱动分为三大类：字符设备驱动、块设备驱动和网络设备驱动。字符设备驱动是最常见的一种，从简单的LED控制到复杂的IIC、SPI、音频设备，都属于字符设备的范畴。块设备驱动主要针对存储设备，比如EMMC、NAND、SD卡和U盘，这些设备以数据块为单位进行读写。网络设备驱动则负责网络通信，不管是有线还是无线网络，都归它管。有趣的是，一个设备可能同时属于多种类型，比如USB WIFI，它既是字符设备（因为通过USB接口通信），又是网络设备（因为能上网）。

为什么我们要从字符设备驱动开始学呢？因为它最简单、最基础，而且应用最广泛。学好了字符设备驱动，再学块设备和网络设备驱动就会轻松很多。今天，我们就以LED控制为例，一步步实现一个完整的字符设备驱动。我会带你了解驱动注册、file_operations结构体实现、模块编译与加载、设备节点创建等核心步骤，让你不仅能看懂代码，还能自己动手写出来。

2. 环境准备与基础概念

在开始写代码之前，我们需要准备好开发环境。Linux驱动开发通常在Linux系统上进行，推荐使用Ubuntu 20.04或更高版本。如果你用的是Windows，可以安装WSL（Windows Subsystem for Linux）或者直接装一个虚拟机。开发工具方面，你需要安装Linux内核头文件和编译工具链。打开终端，运行以下命令来安装必要的依赖：

sudo apt update
sudo apt install build-essential linux-headers-$(uname -r)

这些工具会帮你编译和加载内核模块。接下来，我们聊聊字符设备驱动的几个核心概念。首先，Linux系统中万物皆文件，驱动加载后会在/dev目录下生成一个对应的设备文件，比如/dev/led。应用程序通过open、read、write、close等系统调用来操作这个文件，而这些操作最终会调用驱动中对应的函数。

设备号是另一个重要概念。每个字符设备都有一个主设备号和次设备号，主设备号用来标识驱动，次设备号用来区分同一驱动下的不同设备。你可以通过cat /proc/devices命令查看系统中已使用的设备号。在写驱动时，我们需要选择一个未被占用的主设备号，比如200，避免冲突。

最后，file_operations结构体是驱动的心脏，它定义了一系列函数指针，对应应用程序的系统调用。比如，当应用程序调用open时，驱动中的open函数就会被执行。我们需要实现这些函数，才能让驱动正常工作。

3. 编写驱动的基本框架

现在，我们开始写代码。首先，创建一个名为first_driver.c的文件，并填入以下基础框架：

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

#define DEVICE_NAME "first_driver"
#define DEVICE_MAJOR 200

static int first_driver_open(struct inode *inode, struct file *file) {
    printk(KERN_INFO "First driver opened.\n");
    return 0;
}

static int first_driver_release(struct inode *inode, struct file *file) {
    printk(KERN_INFO "First driver closed.\n");
    return 0;
}

static struct file_operations fops = {
    .owner = THIS_MODULE,
    .open = first_driver_open,
    .release = first_driver_release,
};

static int __init first_driver_init(void) {
    int ret = register_chrdev(DEVICE_MAJOR, DEVICE_NAME, &fops);
    if (ret < 0) {
        printk(KERN_ERR "Failed to register driver.\n");
        return ret;
    }
    printk(KERN_INFO "First driver registered.\n");
    return 0;
}

static void __exit first_driver_exit(void) {
    unregister_chrdev(DEVICE_MAJOR, DEVICE_NAME);
    printk(KERN_INFO "First driver unregistered.\n");
}

module_init(first_driver_init);
module_exit(first_driver_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");

这段代码包含了驱动的基本结构。module_init和module_exit宏定义了驱动加载和卸载时调用的函数。first_driver_init函数中，我们调用register_chrdev注册字符设备，传入主设备号、设备名和file_operations结构体。first_driver_exit函数则负责卸载驱动。

file_operations结构体中，我们实现了open和release函数，分别对应应用程序的open和close操作。这里只是简单打印日志，实际应用中，你可以在这些函数中初始化硬件或释放资源。printk是内核中的打印函数，类似用户空间的printf，日志可以通过dmesg命令查看。

4. 实现file_operations函数

现在，我们来完善file_operations中的函数。以LED控制为例，我们需要实现read、write和ioctl函数，让应用程序能读取LED状态和控制LED亮灭。首先，定义一些全局变量来模拟硬件状态：

static int led_status = 0;

static ssize_t first_driver_read(struct file *file, char __user *buf, size_t count, loff_t *offset) {
    if (copy_to_user(buf, &led_status, sizeof(led_status))) {
        return -EFAULT;
    }
    printk(KERN_INFO "LED status read: %d\n", led_status);
    return sizeof(led_status);
}

static ssize_t first_driver_write(struct file *file, const char __user *buf, size_t count, loff_t *offset) {
    if (copy_from_user(&led_status, buf, sizeof(led_status))) {
        return -EFAULT;
    }
    printk(KERN_INFO "LED status set to: %d\n", led_status);
    return sizeof(led_status);
}

static long first_driver_ioctl(struct file *file, unsigned int cmd, unsigned long arg) {
    switch (cmd) {
        case 0: // Turn off LED
            led_status = 0;
            break;
        case 1: // Turn on LED
            led_status = 1;
            break;
        default:
            return -EINVAL;
    }
    printk(KERN_INFO "LED controlled via ioctl: %d\n", led_status);
    return 0;
}

static struct file_operations fops = {
    .owner = THIS_MODULE,
    .open = first_driver_open,
    .release = first_driver_release,
    .read = first_driver_read,
    .write = first_driver_write,
    .unlocked_ioctl = first_driver_ioctl,
};

这里，read函数用copy_to_user将LED状态复制到用户空间，write函数用copy_from_user从用户空间读取数据并设置LED状态。ioctl函数则通过命令字控制LED，比如0关灯、1开灯。注意，用户空间和内核空间的数据传输必须使用copy_to_user和copy_from_user函数，否则会导致内存安全问题。

在实际硬件操作中，你可能需要通过GPIO控制LED，这里为了简化，用变量模拟。如果你想操作真实硬件，可以加入GPIO操作代码，比如gpio_set_value来设置引脚电平。

5. 编译与加载驱动

代码写好了，接下来要编译成内核模块。创建一個Makefile文件，内容如下：

obj-m += first_driver.o

all:
	make -C /lib/modules/$(shell uname -r)/build M=$(PWD) modules

clean:
	make -C /lib/modules/$(shell uname -r)/build M=$(PWD) clean

运行make命令编译，生成first_driver.ko文件。如果编译成功，你可以用insmod first_driver.ko加载模块，用lsmod查看已加载的模块，用rmmod first_driver卸载模块。加载后，用dmesg查看内核日志，确认驱动是否注册成功。

如果主设备号已被占用，加载可能会失败。这时，你可以换一个设备号，或者让系统动态分配主设备号。修改注册代码，将register_chrdev的第一个参数改为0，系统会自动分配一个可用主设备号，之后通过/proc/devices查看分配结果。

6. 创建设备节点与测试

驱动加载成功后，还需要在/dev目录下创建设备节点，应用程序才能访问。使用mknod命令创建节点：

sudo mknod /dev/first_driver c 200 0

这里，c表示字符设备，200是主设备号，0是次设备号。创建后，应用程序就可以通过/dev/first_driver文件操作驱动了。写一个简单的测试程序来验证驱动功能：

#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>

int main() {
    int fd = open("/dev/first_driver", O_RDWR);
    if (fd < 0) {
        perror("Open device failed");
        return -1;
    }

    int status;
    read(fd, &status, sizeof(status));
    printf("Current LED status: %d\n", status);

    status = 1;
    write(fd, &status, sizeof(status));

    ioctl(fd, 1); // Turn on LED
    close(fd);
    return 0;
}

编译并运行测试程序，检查LED状态是否按预期变化。如果一切正常，恭喜你，你已经成功实现了第一个字符设备驱动！