linux驱动开发(三):Linux字符设备驱动实例

上一篇我们介绍了字符设备架构的大概原理、常用的数据结构和函数。接下来,我们撰写一个简单的驱动程序和用户程序,使用户程序可以通过open、release、read、write等常用的文件操作函数,来完成对驱动程序的打开、关闭、读写等控制。

编写代码前,我们再梳理一下思路。想要实现上述效果,我们的工作主要分为三大部分:

  1. 编写驱动程序,并加载到内核中,等待被用户程序调用。

  2. 在console控制台下使用mknod命令创建一个设备节点。

  3. 编写用户程序,通过调用设备节点间接控制驱动程序。

这三部分每一部分实现的具体步骤如下,下面这张图只涉及到了模块注册时的操作和初始化操作,其他操作没有反映出来。

下面我们来逐步实现一过程。

一、注册设备号

首先使用cat /proc/device我们找到一个未被占用的主设备号,这里我们使用233作为新注册设备的主设备号。

注册设备号的操作在驱动程序中,通过调用register_chrdev_region函数完成。因此我们创建一个驱动程序cdev_driver.c,写入下面的代码。

#include 
#include 
#include 
#include 

MODULE_LICENSE("GPL");
MODULE_AUTHOR("zz");

static int major = 233; //主设备号
static int minor = 0;   //一系列次设备号中的第一个次设备号
static dev_t devno;     //设备号

static int demo_init(void)
{
    int rc;
    devno = MKDEV(major, minor);    //根据主设备号和次设备号合成设备号
    rc = register_chrdev_region(devno, 1, "test");  //向系统中注册设备号
    if(rc < 0) {
        pr_err("register_chrdev_region failed!");
        return rc;
    }
    return 0;
}

static void demo_exit(void)
{
    unregister_chrdev_region(devno, 1); //向系统中注销设备号
    return;
}

module_init(demo_init);
module_exit(demo_exit);

编写Makefile。

ifneq ($(KERNELRELEASE),)
    obj-m := cdev_driver.o
else
    KDIR    := /lib/modules/$(shell uname -r)/build
    PWD     := $(shell pwd)
all:
    make -C $(KDIR) M=$(PWD) modules
clean:
    rm -rf *.ko *.o *.mod.o *.symvers *.cmd *.mod.c *.order *.dwo *.mod.dwo *.mod
endif

编译该文件,并在系统中加载该驱动模块,可以看到系统中233的设备号被分配给名为“test”的设备。


二、实现file_operations结构体

这一步同样在驱动程序cdev_driver.c中,我们需要首先新建一个file_operations结构体fops,并实现其中的open、release、read、write函数。

#define KMAX_LEN 32

static int demo_open(struct inode *ind, struct file *fp)
{
    printk("demo open\n");
    return 0;
}

static int demo_release(struct inode *ind, struct file *fp)
{
    printk("demo release\n");
    return 0;
}

static ssize_t demo_read(struct file *fp, char __user *buf, size_t size, loff_t *pos)
{
    int rc;
    char kbuf[KMAX_LEN] = "read test\n"; 
    if (size > KMAX_LEN)
        size = KMAX_LEN;
    
    rc = copy_to_user(buf, kbuf, size); //将字符串kbuf拷贝到用户空间下的buf中
    if(rc < 0) {
        return -EFAULT;
        pr_err("copy_to_user failed!");
    }
    return size;
}

static ssize_t demo_write(struct file *fp, const char __user *buf, size_t size, loff_t *pos)
{
    int rc;
    char kbuf[KMAX_LEN];
    if (size > KMAX_LEN)
        size = KMAX_LEN;

    rc = copy_from_user(kbuf, buf, size);   //将用户空间下的buf中的内容拷贝到内核空间中
    if(rc < 0) {
        return -EFAULT;
        pr_err("copy_from_user failed!");
    }
    printk("%s", kbuf);
    return size;
}

static struct file_operations fops = {
    .open = demo_open,
    .release = demo_release,
    .read = demo_read,
    .write = demo_write,
};

file_operations结构体中的成员都是函数指针,我们的工作就是编写四个函数demo_open、demo_release、demo_read、demo_write,并将它们分别赋值给.open、.release、.read、.write四个函数指针。其中demo_open和demo_release两个函数比较简单,打印两句话即可,demo_read和demo_write分别实现读写操作。demo_read用于将内核中定义的字符串“read test”读出到buf中,并返回实际读出的字符串长度size;demo_write用于向内核中写入一个长度为size的字符串buf。size不能超过限定的最大长度KMAX_LEN。

由于读出和写入操作是跨越用户空间和内核空间的,所以需要使用copy_to_user和copy_from_user两个函数。前者用来从内核空间拷贝到用户空间,后者反之。

三、注册字符设备结构体

在写好file_operations结构体后,就可以调用cdev_init和cdev_add函数,对字符设备结构体进行初始化并加入系统了。在模块卸载时,需要调用cdev_del移除字符设备结构体。最终得到的完整的驱动程序的代码如下。

#include 
#include 
#include 
#include 
#include 

MODULE_LICENSE("GPL");
MODULE_AUTHOR("zz");

static int major = 233;
static int minor = 0;
static dev_t devno;

#define KMAX_LEN 32

static int demo_open(struct inode *ind, struct file *fp)
{
    printk("demo open\n");
    return 0;
}

static int demo_release(struct inode *ind, struct file *fp)
{
    printk("demo release\n");
    return 0;
}

static ssize_t demo_read(struct file *fp, char __user *buf, size_t size, loff_t *pos)
{
    int rc;
    char kbuf[KMAX_LEN] = "read test\n"; 
    if (size > KMAX_LEN)
        size = KMAX_LEN;
    
    rc = copy_to_user(buf, kbuf, size);
    if(rc < 0) {
        return -EFAULT;
        pr_err("copy_to_user failed!");
    }
    return size;
}

static ssize_t demo_write(struct file *fp, const char __user *buf, size_t size, loff_t *pos)
{
    int rc;
    char kbuf[KMAX_LEN];
    if (size > KMAX_LEN)
        size = KMAX_LEN;

    rc = copy_from_user(kbuf, buf, size);
    if(rc < 0) {
        return -EFAULT;
        pr_err("copy_from_user failed!");
    }
    printk("%s", kbuf);
    return size;
}

static struct file_operations fops = {
    .open = demo_open,
    .release = demo_release,
    .read = demo_read,
    .write = demo_write,
};

static struct cdev cd;

static int demo_init(void)
{
    int rc;
    devno = MKDEV(major, minor);
    rc = register_chrdev_region(devno, 1, "test");
    if(rc < 0) {
        pr_err("register_chrdev_region failed!");
        return rc;
    }

    cdev_init(&cd, &fops);          //初始化字符设备结构体
    rc = cdev_add(&cd, devno, 1);   //将字符设备结构体加入系统中
    if (rc < 0) {
        pr_err("cdev_add failed!");
        return rc;
    }
    return 0;
}

static void demo_exit(void)
{
    cdev_del(&cd);  //从系统中删除字符设备结构体
    unregister_chrdev_region(devno, 1);
    return;
}

module_init(demo_init);
module_exit(demo_exit);

四、应用程序编写

驱动程序完全编写完毕,下面编写应用程序。在应用程序中,我们要完成下面的操作:使用open函数打开字符设备,使用read函数从字符设备中读出字符串“read test”,使用write函数向字符设备中写入字符串“write test”,使用close释放字符设备。我们将设备节点的名称命名为test_chr_dev。代码如下。

#include 
#include 
#include 

int main()
{
    int rc;
    char buf[32];
    int fd = open("/dev/test_chr_dev", O_RDWR);
    if (fd < 0) {
        printf("open file failed!\n");
        return -1;
    }
    read(fd, buf, 32);
    printf("%s", buf);
    write(fd, "write test\n", 32);
    close(fd);
    return 0;
}

使用gcc对代码进行编译。

gcc app.c -o app

五、程序运行

进入root模式,首先使用mknod指令向系统中创建设备节点。


查看dev目录可以看到新增加的设备节点。

然后加载驱动模块,再运行应用程序。可以看到读功能正常。


dmesg打印一下内核信息,可以看到设备打开、写功能、释放正常。


你可能感兴趣的:(linux驱动开发(三):Linux字符设备驱动实例)