Linux字符设备驱动开发：从设备号到file_operations-嵌云网-嵌入式AI开发资源站

Linux字符设备驱动开发：从设备号到file_operations

汤汤七号

1. 字符设备驱动入门：从理论到实践

作为一名嵌入式开发工程师，我经常需要与Linux字符设备驱动打交道。记得第一次接触驱动开发时，面对各种结构体和函数指针完全摸不着头脑。经过多个项目的实战积累，现在终于能够游刃有余地编写字符设备驱动了。今天我就把自己这些年踩过的坑和总结的经验分享给大家。

字符设备驱动是Linux驱动开发中最基础也最常用的类型。键盘、鼠标、串口、LED等都属于字符设备。与块设备不同，字符设备的数据传输是面向字节流的，不能随机访问。理解字符设备驱动的工作原理，是进入Linux内核开发的必经之路。

2. 字符设备驱动核心概念解析

2.1 设备号：驱动与设备的身份证

在Linux系统中，每个字符设备都有一个唯一的设备号，就像我们的身份证号一样。设备号由主设备号和次设备号组成：

主设备号：标识设备对应的驱动程序。内核通过主设备号将设备文件与驱动程序关联起来。
次设备号：由驱动程序自身使用，用于区分同一驱动程序管理的不同设备实例。

设备号在内核中用dev_t类型表示，这是一个32位整数，其中高12位是主设备号，低20位是次设备号。内核提供了几个有用的宏来处理设备号：

c复制MAJOR(dev_t dev);  // 提取主设备号
MINOR(dev_t dev);  // 提取次设备号
MKDEV(int major, int minor);  // 合并主次设备号

在实际开发中，我们可以通过ls -l /dev命令查看系统中的设备文件。字符设备文件的第一列显示为'c'，第五列就是设备号，格式为主设备号,次设备号。

2.2 设备号的分配策略

驱动程序首先需要获取设备号，有两种分配方式：

静态分配：明确知道所需的设备号

c复制int register_chrdev_region(dev_t first, unsigned int count, char *name);

动态分配：由内核自动分配空闲设备号

c复制int alloc_chrdev_region(dev_t *dev, unsigned int firstminor, unsigned int count, char *name);

经验之谈：生产环境中建议使用动态分配，避免设备号冲突。开发阶段可以使用静态分配方便调试。

无论采用哪种方式，在模块卸载时都需要释放设备号：

c复制void unregister_chrdev_region(dev_t first, unsigned int count);

3. 驱动开发三大核心数据结构

3.1 struct file_operations：驱动功能的灵魂

这是驱动开发中最重要的结构体，定义了字符设备支持的操作方法。它包含了一系列函数指针，驱动开发者的主要工作就是实现这些函数：

c复制struct file_operations {
    struct module *owner;
    loff_t (*llseek)(struct file *, loff_t, int);
    ssize_t (*read)(struct file *, char __user *, size_t, loff_t *);
    ssize_t (*write)(struct file *, const char __user *, size_t, loff_t *);
    int (*open)(struct inode *, struct file *);
    int (*release)(struct inode *, struct file *);
    // 其他操作...
};

owner：通常设为THIS_MODULE，表示模块拥有这些操作
read/write：实现设备数据的读写
open/release：处理设备的打开和关闭

3.2 struct file：打开文件的上下文

内核为每个打开的文件创建一个file结构，代表一个文件描述符。重要字段包括：

f_mode：文件访问模式（读、写或读写）
f_pos：当前读写位置
f_op：指向该文件的file_operations结构
private_data：驱动私有数据指针，常用于保存设备状态

3.3 struct inode：文件的唯一标识

inode结构在内部表示文件本身（而非打开的文件）。一个文件只有一个inode，但可以被多次打开，对应多个file结构。对驱动有用的字段：

i_rdev：设备文件对应的设备号
i_cdev：指向内核中表示字符设备的cdev结构

关键区别：inode代表文件本身，file代表打开的文件实例。一个inode可能对应多个file结构。

4. 字符设备驱动开发框架

4.1 驱动初始化三部曲

4.1.1 分配cdev结构体

首先需要分配一个cdev结构体：

c复制struct cdev my_cdev;

4.1.2 初始化cdev

使用cdev_init初始化cdev并关联file_operations：

c复制void cdev_init(struct cdev *cdev, struct file_operations *fops);

4.1.3 注册cdev

将cdev添加到系统，完成字符设备注册：

c复制int cdev_add(struct cdev *p, dev_t dev, unsigned count);

4.2 实现设备操作方法

用户空间通过文件操作访问设备，这些调用最终会转到file_operations中对应的函数。典型实现如下：

c复制static struct file_operations my_fops = {
    .owner = THIS_MODULE,
    .open = my_open,
    .release = my_release,
    .read = my_read,
    .write = my_write,
};

static int my_open(struct inode *inode, struct file *filp)
{
    // 初始化设备、增加引用计数等
    return 0;
}

static ssize_t my_read(struct file *filp, char __user *buf, size_t count, loff_t *f_pos)
{
    // 从设备读取数据到用户空间
    return bytes_read;
}

注意事项：用户空间缓冲区需要使用__user标记，并通过copy_to_user/copy_from_user安全访问。

4.3 驱动注销流程

4.3.1 删除cdev

模块卸载时调用cdev_del注销字符设备：

c复制void cdev_del(struct cdev *p);

4.3.2 释放设备号

最后释放之前申请的设备号：

c复制void unregister_chrdev_region(dev_t from, unsigned count);

4.4 cdev结构详解

cdev是内核中描述字符设备的核心结构：

c复制struct cdev {
    struct kobject kobj;
    struct module *owner;
    const struct file_operations *ops;
    struct list_head list;
    dev_t dev;
    unsigned int count;
};

kobj：内嵌的内核对象，用于设备模型管理
owner：指向拥有该驱动的模块
ops：文件操作集合
list：用于将字符设备链接到内核链表
dev：设备号
count：次设备号的数量

5. 实战：LED设备驱动开发

5.1 硬件准备与原理图分析

假设我们有一个通过GPIO控制的LED，硬件连接如下：

LED正极接3.3V
负极通过限流电阻接GPIO 21

当GPIO输出高电平时LED熄灭，低电平时点亮。

5.2 驱动实现步骤

5.2.1 模块初始化和退出函数

c复制static int __init led_init(void)
{
    int ret;
    dev_t devno;
    
    // 1. 动态申请设备号
    ret = alloc_chrdev_region(&devno, 0, 1, "myled");
    if (ret < 0) {
        printk(KERN_ERR "Failed to alloc chrdev region\n");
        return ret;
    }
    major = MAJOR(devno);
    
    // 2. 初始化cdev
    cdev_init(&led_cdev, &led_fops);
    led_cdev.owner = THIS_MODULE;
    
    // 3. 添加cdev到系统
    ret = cdev_add(&led_cdev, devno, 1);
    if (ret) {
        printk(KERN_ERR "Failed to add cdev\n");
        unregister_chrdev_region(devno, 1);
        return ret;
    }
    
    // 4. 硬件初始化
    gpio_request(LED_GPIO, "led");
    gpio_direction_output(LED_GPIO, 1); // 初始状态关闭
    
    printk(KERN_INFO "LED driver loaded\n");
    return 0;
}

static void __exit led_exit(void)
{
    // 1. 删除cdev
    cdev_del(&led_cdev);
    
    // 2. 释放设备号
    unregister_chrdev_region(MKDEV(major, 0), 1);
    
    // 3. 释放GPIO
    gpio_free(LED_GPIO);
    
    printk(KERN_INFO "LED driver unloaded\n");
}

5.2.2 文件操作实现

c复制static struct file_operations led_fops = {
    .owner = THIS_MODULE,
    .open = led_open,
    .release = led_release,
    .read = led_read,
    .write = led_write,
};

static int led_open(struct inode *inode, struct file *filp)
{
    filp->private_data = &led_status;
    return 0;
}

static ssize_t led_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos)
{
    char val;
    
    if (copy_from_user(&val, buf, 1))
        return -EFAULT;
    
    gpio_set_value(LED_GPIO, !val); // 根据用户输入控制LED
    *((int *)filp->private_data) = val;
    
    return 1;
}

5.3 用户空间测试程序

c复制#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>

int main()
{
    int fd = open("/dev/myled", O_RDWR);
    if (fd < 0) {
        perror("open device failed");
        return -1;
    }
    
    char val = 1; // 点亮LED
    write(fd, &val, 1);
    
    sleep(2);
    
    val = 0; // 熄灭LED
    write(fd, &val, 1);
    
    close(fd);
    return 0;
}

6. 常见问题与调试技巧

6.1 设备号冲突问题

症状：加载模块时出现"Device or resource busy"错误

解决方案：

检查/proc/devices确认设备号是否已被占用
改用动态分配设备号
确保卸载模块时正确释放了设备号

6.2 权限问题

症状：用户程序无法打开设备文件