手把手教Linux驱动3-之字符设备架构详解,有这篇就够了


一、Linux设备分类

Linux系统为了管理方便,将设备分成三种基本类型:

  1. 字符设备

  2. 块设备

  3. 网络设备

字符设备:

  字符(char)设备是个能够像字节流(类似文件)一样被访问的设备,由字符设备驱动程序来实现这种特性。字符设备驱动程序通常至少要实现open、close、read和write的系统调用。

  字符终端(/dev/console)和串口(/dev/ttyS0以及类似设备)就是两个字符设备,它们能很好的说明“流”这种抽象概念。

  字符设备可以通过文件节点来访问,比如/dev/tty1和/dev/lp0等。这些设备文件和普通文件之间的唯一差别在于对普通文件的访问可以前后移动访问位置,而大多数字符设备是一个只能顺序访问的数据通道。然而,也存在具有数据区特性的字符设备,访问它们时可前后移动访问位置。例如framebuffer就是这样的一个设备,app可以用mmap或lseek访问抓取的整个图像。

 

 在/dev下执行ls -l ,可以看到很多创建好的设备节点:

字符设备文件(类型为c),设备文件是没有文件大小的,取而代之的是两个号码:主设备号5 +次设备号1 。

块设备:

  和字符设备类似,块设备也是通过/dev目录下的文件系统节点来访问。块设备(例如磁盘)上能够容纳filesystem。在大多数的Unix系统中,进行I/O操作时块设备每次只能传输一个或多个完整的块,而每块包含512字节(或2的更高次幂字节的数据)。

  Linux可以让app像字符设备一样地读写块设备,允许一次传递任意多字节的数据。因此,块设备和字符设备的区别仅仅在于内核内部管理数据的方式,也就是内核及驱动程序之间的软件接口,而这些不同对用户来讲是透明的。在内核中,和字符驱动程序相比,块驱动程序具有完全不同的接口。

 

  块设备文件(类型为b):

网络设备:

  任何网络事物都需要经过一个网络接口形成,网络接口是一个能够和其他主机交换数据的设备。接口通常是一个硬件设备,但也可能是个纯软件设备,比如回环(loopback)接口。

  网络接口由内核中的网络子系统驱动,负责发送和接收数据包。许多网络连接(尤其是使用TCP协议的连接)是面向流的,但网络设备却围绕数据包的传送和接收而设计。网络驱动程序不需要知道各个连接的相关信息,它只要处理数据包即可。

  由于不是面向流的设备,因此将网络接口映射到filesystem中的节点(比如/dev/tty1)比较困难。

  Unix访问网络接口的方法仍然是给它们分配一个唯一的名字(比如eth0),但这个名字在filesystem中不存在对应的节点。内核和网络设备驱动程序间的通信,完全不同于内核和字符以及块驱动程序之间的通信,内核调用一套和数据包相关的函数socket,也叫套接字。

   查看网络设备使用命令ifconfig:

二、字符设备架构是如何实现的?

在Linux的世界里面一切皆文件,所有的硬件设备操作到应用层都会被抽象成文件的操作。我们知道如果应用层要访问硬件设备,它必定要调用到硬件对应的驱动程序。Linux内核中有那么多驱动程序,应用层怎么才能精确的调用到底层的驱动程序呢?

  在这里我们字符设备为例,来看一下应用程序是如何和底层驱动程序关联起来的。必须知道的基础知识:

  1. 在Linux文件系统中,每个文件都用一个struct inode结构体来描述,这个结构体里面记录了这个文件的所有信息,例如:文件类型,访问权限等。

  2. 在Linux操作系统中,每个驱动程序在应用层的/dev目录下都会有一个设备文件和它对应,并且该文件会有对应的主设备号和次设备号。

  3. 在Linux操作系统中,每个驱动程序都要分配一个主设备号,字符设备的设备号保存在struct cdev结构体中。

     
    struct cdev {
        struct kobject kobj;
        struct module *owner;
        const struct file_operations *ops;//接口函数集合
        struct list_head list;//内核链表
        dev_t dev;    //设备号
        unsigned int count;//次设备号个数
    };
  4. 在Linux操作系统中,每打开一次文件,Linux操作系统在VFS层都会分配一个struct file结构体来描述打开的这个文件。该结构体用于维护文件打开权限、文件指针偏移值、私有内存地址等信息。

注意:

  常常我们认为struct inode描述的是文件的静态信息,即这些信息很少会改变。而struct file描述的是动态信息,即在对文件的操作的时候,struct file里面的信息经常会发生变化。典型的是struct file结构体里面的f_pos(记录当前文件的位移量),每次读写一个普通文件时f_ops的值都会发生改变。

 

 这几个结构体关系如下图所示:

通过上图我们可以知道,如果想访问底层设备,就必须打开对应的设备文件。也就是在这个打开的过程中,Linux内核将应用层和对应的驱动程序关联起来。

  1. 当open函数打开设备文件时,可以根据设备文件对应的struct inode结构体描述的信息,可以知道接下来要操作的设备类型(字符设备还是块设备)。还会分配一个struct file结构体。

  2. 根据struct inode结构体里面记录的设备号,可以找到对应的驱动程序。这里以字符设备为例。在Linux操作系统中每个字符设备有一个struct cdev结构体。此结构体描述了字符设备所有的信息,其中最重要一项的就是字符设备的操作函数接口。

  3. 找到struct cdev结构体后,Linux内核就会将struct cdev结构体所在的内存空间首地记录在struct inode结构体的i_cdev成员中。将struct cdev结构体的中记录的函数操作接口地址记录在struct file结构体的f_op成员中。

  4. 任务完成,VFS层会给应用层返回一个文件描述符(fd)。这个fd是和struct file结构体对应的。接下来上层的应用程序就可以通过fd来找到strut file,然后在由struct file找到操作字符设备的函数接口了。

三、字符驱动相关函数分析

 

 1 /**
 2  * cdev_init() - initialize a cdev structure
 3  * @cdev: the structure to initialize
 4  * @fops: the file_operations for this device
 5  *
 6  * Initializes @cdev, remembering @fops, making it ready to add to the
 7  * system with cdev_add().
 8  */
 9 void cdev_init(struct cdev *cdev, const struct file_operations *fops)
10 功能:
11   初始化cdev结构体
12 参数:
13   @cdev cdev结构体地址
14   @fops 操作字符设备的函数接口地址
15 返回值:
16
 1 /**
 2  * register_chrdev_region() - register a range of device numbers
 3  * @from: the first in the desired range of device numbers; must include
 4  *        the major number.
 5  * @count: the number of consecutive device numbers required
 6  * @name: the name of the device or driver.
 7  *
 8  * Return value is zero on success, a negative error code on failure.
 9  */                                              
10 int register_chrdev_region(dev_t from, unsigned count, const char *name)
11 功能:
12   注册一个范围()的设备号
13 参数:
14   @from 设备号
15   @count 注册的设备个数
16   @name 设备的名字
17 返回值:
18   成功返回0,失败返回错误码(负数)
 1 /**
 2  * cdev_add() - add a char device to the system
 3  * @p: the cdev structure for the device
 4  * @dev: the first device number for which this device is responsible
 5  * @count: the number of consecutive minor numbers corresponding to this
 6  *         device
 7  *
 8  * cdev_add() adds the device represented by @p to the system, making it
 9  * live immediately.  A negative error code is returned on failure.
10  */
11 int cdev_add(struct cdev *p, dev_t dev, unsigned count)
12 功能:
13   添加一个字符设备到操作系统
14 参数:
15   @p cdev结构体地址
16   @dev 设备号
17   @count 次设备号个数
18 返回值:
19   成功返回0,失败返回错误码(负数)
 1 /**
 2  * cdev_del() - remove a cdev from the system
 3  * @p: the cdev structure to be removed
 4  *
 5  * cdev_del() removes @p from the system, possibly freeing the structure
 6  * itself.
 7  */
 8 void cdev_del(struct cdev *p)
 9 功能:
10   从系统中删除一个字符设备
11 参数:
12   @p cdev结构体地址
13 返回值:
14
 1 static inline int register_chrdev(unsigned int major, const char *name,
 2           const struct file_operations *fops)
 3 
 4 功能:
 5   注册或者分配设备号,并注册fops到cdev结构体,
 6   如果major>0,功能为注册该主设备号,
 7   如果major=0,功能为动态分配主设备号。
 8 参数:
 9   @major : 主设备号
10   @name : 设备名称,执行 cat /proc/devices显示的名称
11   @fops  : 文件系统的接口指针
12 返回值
13   如果major>0   成功返回0,失败返回负的错误码
14   如果major=0  成功返回主设备号,失败返回负的错误码

该函数实现了对cdev的初始化和注册的封装,所以调用该函数之后就不需要自己操作cdev了。

 

 相对的注销函数为unregister_chrdev

 

1 static inline void unregister_chrdev(unsigned int major, const char *name)

四、如何编写字符设备驱动

 

参考上图,编写字符设备驱动步骤如下:



1 实现模块加载和卸载入口函数

module_init (hello_init);
module_exit (hello_exit);

2 申请主设备号

  申请主设备号  (内核中用于区分和管理不同字符设备)
1 register_chrdev_region (devno, number_of_devices, "hello");
3 创建设备节点

创建设备节点文件 (为用户提供一个可操作到文件接口--open())
创建设备节点有两种方式:手动方式创建,函数自动创建。
    手动创建:
1 mknod /dev/hello c 250 0
    自动创建设备节点

除了使用mknod命令手动创建设备节点,还可以利用linux的udev、mdev机制,而我们的ARM开发板上移植的busybox有mdev机制,那么就使用mdev机制来自动创建设备节点。


在etc/init.d/rcS文件里有一句:

1 echo /sbin/mdev > /proc/sys/kernel/hotplug

   该名命令就是用来自动创建设备节点。

 

 udev 是一个工作在用户空间的工具,它能根据系统中硬件设备的状态动态的更新设备文件,包括设备文件的创建,删除,权限等。这些文件通常都定义在/dev 目录下,但也可以在配置文件中指定。udev 必须有内核中的sysfs和tmpfs支持,sysfs 为udev 提供设备入口和uevent 通道,tmpfs 为udev 设备文件提供存放空间。 

 udev 运行在用户模式,而非内核中。udev 的初始化脚本在系统启动时创建设备节点,并且当插入新设备——加入驱动模块——在sysfs上注册新的数据后,udev会创新新的设备节点。

   注意,udev 是通过对内核产生的设备文件修改,或增加别名的方式来达到自定义设备文件的目的。但是,udev 是用户模式程序,其不会更改内核行为。也就是说,内核仍然会创建sda,sdb等设备文件,而udev可根据设备的唯一信息来区分不同的设备,并产生新的设备文件(或链接)。

 

例如:

如果驱动模块可以将自己的设备号作为内核参数导出,在sysfs文件中就有一个叫做uevent文件记录它的值。

由上图可知,uevent中包含了主设备号和次设备号的值以及设备名字。

 

在Linux应用层启动一个udev程序,这个程序的第一次运行的时候,会遍历/sys目录,寻找每个子目录的uevent文件,从这些uevent文件中获取创建设备节点的信息,然后调用mknod程序在/dev目录下创建设备节点。结束之后,udev就开始等待内核空间的event。这个设备模型的东西,我们在后面再详细说。这里大就可以这样理解,在Linux内核中提供了一些函数接口,通过这些函数接口,我们可在sysfs文件系统中导出我们的设备号的值,导出值之后,内核还会向应用层上报event。此时udev就知道有活可以干了,它收到这个event后,就读取event对应的信息,接下来就开始创建设备节点啦。

 

如何创建一个设备类?

第一步 :通过宏class_create() 创建一个class类型的对象;

 1 /* This is a #define to keep the compiler from merging different
 2  * instances of the __key variable */
 3 #define class_create(owner, name)    \
 4 ({            \
 5   static struct lock_class_key __key;  \
 6   __class_create(owner, name, &__key);  \
 7 })
 8 参数:
 9   @owner  THIS_MODULE
10   @name   类名字
11 返回值
12   可以定义一个struct class的指针变量cls接受返回值,然后通过IS_ERR(cls)判断
13   是否失败,如果成功这个宏返回0,失败返回非9值(可以通过PTR_ERR(cls)来获得
14   失败返回的错误码)

在Linux内核中,把设备进行了分类,同一类设备可以放在同一个目录下,该函数启示就是创建了一个类,例如:

 

第二步:导出我们的设备信息到用户空间

 1 /**
 2  * device_create - creates a device and registers it with sysfs
 3  * @class: pointer to the struct class that this device should be registered to
 4  * @parent: pointer to the parent struct device of this new device, if any
 5  * @devt: the dev_t for the char device to be added
 6  * @drvdata: the data to be added to the device for callbacks
 7  * @fmt: string for the device's name
 8  *
 9  * This function can be used by char device classes.  A struct device
10  * will be created in sysfs, registered to the specified class.
11  *
12  * A "dev" file will be created, showing the dev_t for the device, if
13  * the dev_t is not 0,0.
14  * If a pointer to a parent struct device is passed in, the newly created
15  * struct device will be a child of that device in sysfs.
16  * The pointer to the struct device will be returned from the call.
17  * Any further sysfs files that might be required can be created using this
18  * pointer.
19  *
20  * Returns &struct device pointer on success, or ERR_PTR() on error.
21  *
22  * Note: the struct class passed to this function must have previously
23  * been created with a call to class_create().
24  */
25 struct device *device_create(struct class *class, struct device *parent,
26            dev_t devt, void *drvdata, const char *fmt, ...)

自动创建设备节点使用实例:

 1 static struct class *cls;
 2 static struct device *test_device;
 3 
 4   devno = MKDEV(major,minor);
 5   cls = class_create(THIS_MODULE,"helloclass");
 6   if(IS_ERR(cls))
 7   {
 8     unregister_chrdev(major,"hello");
 9     return result;
10   }
11   test_device = device_create(cls,NULL,devno,NULL,"hellodevice");
12   if(IS_ERR(test_device ))
13   {
14     class_destroy(cls);
15     unregister_chrdev(major,"hello");
16     return result;
17   }


4 实现file_operations

1 static const struct file_operations fifo_operations = {
2     .owner =   THIS_MODULE,
3     .open =   dev_fifo_open,
4     .read =   dev_fifo_read,
5     .write =   dev_fifo_write,
6     .unlocked_ioctl =   dev_fifo_unlocked_ioctl,
7 };

  open、release对应应用层的open()、close()函数。实现比较简单,

直接返回0即可。
其中read、write、unloched_ioctrl 函数的实现需要涉及到用户空间
和内存空间的数据拷贝。

  在Linux操作系统中,用户空间和内核空间是相互独立的。也就是说内核空间是不能直接访问用户空间内存地址,同理用户空间也不能直接访问内核空间内存地址。

如果想实现,将用户空间的数据拷贝到内核空间或将内核空间数据拷贝到用户空间,就必须借助内核给我们提供的接口来完成。

 

read接口实现

用户空间-->内核空间

字符设备的write接口定义如下:

1 ssize_t (*write)(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos);
2 参数:
3   filp:待操作的设备文件file结构体指针
4   buf:待写入所读取数据的用户空间缓冲区指针
5   count:待读取数据字节数
6   f_pos:待读取数据文件位置,写入完成后根据实际写入字节数重新定位
7 返回:
8   成功实际写入的字节数,失败返回负值

如果该操作为空,将使得write系统调用返回负EINVAL失败,正常返回实际写入的字节数。

 

用户空间向内核空间拷贝数据需要使用copy_from_user函数,该函数定义在arch/arm/include/asm/uaccess.h中。

1 static inline int copy_from_user(void *to, const void __user volatile *from,unsigned long n)
2 参数:
3   to:目标地址(内核空间)
4   from:源地址(用户空间)
5   n:将要拷贝数据的字节数
6 返回:
7   成功返回0,失败返回没有拷贝成功的数据字节数

还可以使用get_user宏:

1 int get_user(data, ptr);
2 参数:
3   data:可以是字节、半字、字、双字类型的内核变量
4   ptr:用户空间内存指针
5 返回:
6   成功返回0,失败返回非0

write接口实现

内核空间-->用户空间

字符设备的read接口定义如下:

 1 ssize_t (*read)(struct file *filp, char __user *buf, size_t  count, lofft *f_pos);
 2 参数:
 3   filp: 待操作的设备文件file结构体指针
 4   buf:  待写入所读取数据的用户空间缓冲区指针
 5   count:待读取数据字节数
 6   f_pos:待读取数据文件位置,读取完成后根据实际读取字节数重新定位
 7   __user :是一个空的宏,主要用来显示的告诉程序员它修饰的指针变量存放的是用户空间的地址。
 8 
 9 返回值:
10   成功实际读取的字节数,失败返回负值

注意:如果该操作为空,将使得read系统调用返回负EINVAL失败,正常返回实际读取的字节数。

 

用户空间从内核空间读取数据需要使用copy_to_user函数:

1 static inline int copy_to_user(void __user volatile *to, const void *from,unsigned long n)
2 参数:
3   to:目标地址(用户空间)
4   from:源地址(内核空间)
5   n:将要拷贝数据的字节数
6 返回:
7   成功返回0,失败返回没有拷贝成功的数据字节数

还可以使用put_user宏:

1 int put_user(data, prt)
2 参数:
3   data:可以是字节、半字、字、双字类型的内核变量
4   ptr:用户空间内存指针
5 返回:
6   成功返回0, 失败返回非0

这样我们就可以实现read、write函数了,实例如下:

 1 ssize_t hello_read (struct file *filp, char *buff,   size_t count, loff_t *offp)
 2 {
 3   ssize_t   result = 0;
 4 
 5   if (count   > 127) 
 6     count = 127;
 7 
 8   if   (copy_to_user (buff, data, count))
 9   {
10     result =   -EFAULT;
11   }
12   else
13   {
14     printk   (KERN_INFO "wrote %d bytes\n", count);
15     result =   count;
16   } 
17   return   result;
18 }
19 ssize_t hello_write (struct file *filp,const char *buf, size_t count, loff_t *f_pos)
20 {
21   ssize_t ret   = 0;
22   //printk   (KERN_INFO "Writing %d bytes\n", count);
23   if (count   > 127) return -ENOMEM;
24 
25   if   (copy_from_user (data, buf, count)) {
26     ret =   -EFAULT;
27   }
28   else {
29     data[count] = '\0';
30     printk   (KERN_INFO"Received: %s\n", data);
31     ret =   count;
32   }
33   return ret;
34 }

unlocked_ioctl接口实现

(1)为什么要实现xxx_ioctl ? 

    前面我们在驱动中已经实现了读写接口,通过这些接口我们可以完成对设备的读写。但是很多时候我们的应用层工程师除了要对设备进行读写数据之外,还希望可以对设备进行控制。例如:针对串口设备,驱动层除了需要提供对串口的读写之外,还需提供对串口波特率、奇偶校验位、终止位的设置,这些配置信息需要从应用层传递一些基本数据,仅仅是数据类型不同。

 

    通过xxx_ioctl函数接口,可以提供对设备的控制能力,增加驱动程序的灵活性。

 

(2)如何实现xxx_ioctl函数接口?

增加xxx_ioctl函数接口,应用层可以通过ioctl系统调用,根据不同的命令来操作dev_fifo。

 

   kernel 2.6.35 及之前的版本中struct file_operations 一共有3个ioctl :ioctl,unlocked_ioctl和compat_ioctl 现在只有unlocked_ioctl和compat_ioctl 了

在kernel 2.6.36 中已经完全删除了struct file_operations 中的ioctl 函数指针,取而代之的是unlocked_ioctl 。

 

·         2.6.36 之前的内核

1 long (ioctl) (struct inode node ,struct file* filp, unsigned int cmd,unsigned long arg)

·         2.6.36之后的内核

1 long (*unlocked_ioctl) (struct file *filp, unsigned int cmd, unsigned long arg)

参数cmd: 通过应用函数ioctl传递下来的命令

 

 

先来看看应用层的ioctl和驱动层的xxx_ioctl对应关系:

    

 

<1>应用层ioctl参数分析

1 int ioctl(int fd, int cmd, ...);
2 参数:
3 @fd:打开设备文件的时候获得文件描述符 
4 @ cmd:第二个参数:给驱动层传递的命令,需要注意的时候,驱动层的命令和应用层的命令一定要统一
5 @第三个参数: "..."在C语言中,很多时候都被理解成可变参数。
6 返回值
7        成功:0
8        失败:-1,同时设置errno

小贴士:

当我们通过ioctl调用驱动层xxx_ioctl的时候,有三种情况可供选择:

1: 不传递数据给xxx_ioctl 

2: 传递数据给xxx_ioctl,希望它最终能把数据写入设备(例如:设置串口的波特率)

3: 调用xxxx_ioctl希望获取设备的硬件参数(例如:获取当前串口设备的波特率)

这三种情况中,有些时候需要传递数据,有些时候不需要传递数据。在C语言中,是无法实现函数重载的。那怎么办?用"..."来欺骗编译器了,"..."本来的意思是传递多参数。在这里的意思是带一个参数还是不带参数。

参数可以传递整型值,也可以传递某块内存的地址,内核接口函数必须根据实际情况提取对应的信息。

 

 

 

 

 

 

 

 

 

<2>驱动层xxx_ioctl参数分析 

 

1 long (*unlocked_ioctl) (struct file *file, unsigned int cmd, unsigned long arg);
2 参数:
3 @file:   vfs层为打开字符设备文件的进程创建的结构体,用于存放文件的动态信息 
4 @ cmd: 用户空间传递的命令,可以根据不同的命令做不同的事情
5 @第三个参数: 用户空间的数据,主要这个数据可能是一个地址值(用户空间传递的是一个地址),也可能是一个数值,也可能没值
6 返回值
7        成功:0
8        失败:带错误码的负值

<3>如何确定cmd 的值。

该值主要用于区分命令的类型,虽然我只需要传递任意一个整型值即可,但是我们尽量按照内核规范要求,充分利用这32bite的空间,如果大家都没有规矩,又如何能成方圆?

现在我就来看看,在Linux 内核中这个cmd是如何设计的吧!


 

具体含义如下:

设备类型 类型或叫幻数,代表一类设备,一般用一个字母或者1个8bit的数字
序列号 代表这个设备的第几个命令
方向 表示是由内核空间到用户空间,或是用户空间到内核空间,入:只读,只写,读写,其他
数据尺寸 表示需要读写的参数大小

 

 

 

 

 

由上可以一个命令由4个部分组成,每个部分需要的bite都不完全一样,制作一个命令需要在不同的位域写不同的数字,Linux 系统已经给我们封装好了宏,我们只需要直接调用宏来设计命令即可。 

   通过Linux 系统给我们提供的宏,我们在设计命令的时候,只需要指定设备类型、命令序号,数据类型三个字段就可以了。

Linux 系统中已经设计了一场用的命令,可以通过查阅Linux 源码中的Documentation/ioctl/ioctl-number.txt文件,看哪些命令已经被使用过了。

 


<4> 如何检查命令?

可以通过宏_IOC_TYPE(nr)来判断应用程序传下来的命令type是否正确;

可以通过宏_IOC_DIR(nr)来得到命令是读还是写,然后再通过宏access_ok(type,addr,size)来判断用户层传递的内存地址是否合法。

使用方法如下:

 1  if(_IOC_TYPE(cmd)!=DEV_FIFO_TYPE){
 2     pr_err("cmd   %u,bad magic 0x%x/0x%x.\n",cmd,_IOC_TYPE(cmd),DEV_FIFO_TYPE);
 3     return-ENOTTY;
 4   }
 5   if(_IOC_DIR(cmd)&_IOC_READ)
 6     ret=!access_ok(VERIFY_WRITE,(void __user*)arg,_IOC_SIZE(cmd));
 7   else if( _IOC_DIR(cmd)&_IOC_WRITE )
 8     ret=!access_ok(VERIFY_READ,(void   __user*)arg,_IOC_SIZE(cmd));
 9   if(ret){
10     pr_err("bad   access %ld.\n",ret);
11     return-EFAULT;
12   }

5 注册cdev

 

定义好file_operations结构体,就可以通过函数cdev_init()、cdev_add()注册字符设备驱动了。

实例如下:

1 static struct cdev cdev;
2 
3 cdev_init(&cdev,&hello_ops);
4 error = cdev_add(&cdev,devno,1);

注意如果使用了函数register_chrdev(),就不用了执行上述操作,因为该函数已经实现了对cdev的封装。

五、实例

好了,现在我们可以来实现一个完整的字符设备框架的实例,包括打开、关闭、读写、ioctrl、自动创建设备节点等功能。

  1 #include 
  2 #include 
  3 #include 
  4 #include 
  5 #include 
  6 #include 
  7 #include 
  8 #include "dev_fifo_head.h"
  9 
 10 //指定的主设备号
 11 #define   MAJOR_NUM 250
 12 
 13 //自己的字符设备
 14 struct mycdev
 15 {
 16     int len;
 17     unsigned   char buffer[50];
 18     struct   cdev cdev;
 19 };
 20 
 21 MODULE_LICENSE("GPL");
 22 //设备号
 23 static dev_t   dev_num = {0};
 24 //全局gcd
 25 struct mycdev *gcd;
 26 //设备类
 27 struct class *cls;
 28 //获得用户传递的数据,根据它来决定注册的设备个数
 29 static int ndevices = 1;
 30 module_param(ndevices, int, 0644);
 31 MODULE_PARM_DESC(ndevices, "The number of devices for register.\n");
 32 
 33 //打开设备
 34 static int dev_fifo_open(struct   inode *inode,   struct file *file)
 35 {
 36     struct   mycdev *cd;  
 37 
 38     printk("dev_fifo_open   success!\n");  
 39     //用struct file的文件私有数据指针保存struct mycdev结构体指针
 40     cd   = container_of(inode->i_cdev,struct   mycdev,cdev);
 41     file->private_data =   cd;  
 42     return   0;
 43 }
 44 
 45 //读设备
 46 static ssize_t   dev_fifo_read(struct file *file, char   __user *ubuf,   size_t
 47 size, loff_t *ppos)
 48 {
 49     int n;
 50     int ret;
 51     char   *kbuf;
 52     struct   mycdev *mycd =   file->private_data;
 53 
 54     printk("read *ppos :   %lld\n",*ppos); 
 55 
 56     if(*ppos == mycd->len)
 57         return   0;
 58 
 59     //请求大大小 > buffer剩余的字节数   :读取实际记得字节数
 60     if(size > mycd->len - *ppos)
 61         n = mycd->len - *ppos;
 62     else
 63         n = size;
 64 
 65     printk("n =   %d\n",n);
 66     //从上一次文件位置指针的位置开始读取数据
 67     kbuf   = mycd->buffer   + *ppos;
 68     //拷贝数据到用户空间
 69     ret   = copy_to_user(ubuf,kbuf, n);
 70     if(ret != 0)
 71         return   -EFAULT;
 72 
 73     //更新文件位置指针的值
 74     *ppos += n;
 75     printk("dev_fifo_read   success!\n");
 76     return   n;
 77 }
 78 //写设备
 79 static ssize_t   dev_fifo_write(struct file *file, const char __user *ubuf,size_t size, loff_t *ppos)
 80 {
 81     int n;
 82     int ret;
 83     char   *kbuf;
 84     struct   mycdev *mycd =   file->private_data;
 85 
 86     printk("write *ppos :   %lld\n",*ppos);
 87     //已经到达buffer尾部了
 88     if(*ppos == sizeof(mycd->buffer))
 89        return   -1;
 90     //请求大大小 > buffer剩余的字节数(有多少空间就写多少数据)
 91     if(size > sizeof(mycd->buffer) - *ppos)
 92         n = sizeof(mycd->buffer) - *ppos;
 93     else
 94         n = size;
 95     //从上一次文件位置指针的位置开始写入数据
 96 
 97     kbuf   = mycd->buffer   + *ppos;
 98     //拷贝数据到内核空间
 99     ret   = copy_from_user(kbuf, ubuf, n);
100     if(ret != 0)
101         return   -EFAULT;
102 
103     //更新文件位置指针的值
104     *ppos += n;
105     //更新dev_fifo.len
106     mycd->len += n;
107     printk("dev_fifo_write   success!\n");
108     return   n;
109 }
110 
111 //linux 内核在2.6以后,已经废弃了ioctl函数指针结构,取而代之的是
112 
113 long   dev_fifo_unlocked_ioctl(struct file *file,   unsigned int cmd,
114     unsigned   long arg)
115 {
116   int ret = 0;
117   struct mycdev *mycd   = file->private_data;
118 
119   if(_IOC_TYPE(cmd)!=DEV_FIFO_TYPE){
120     pr_err("cmd   %u,bad magic 0x%x/0x%x.\n",cmd,_IOC_TYPE(cmd),DEV_FIFO_TYPE);
121     return-ENOTTY;
122   }
123   if(_IOC_DIR(cmd)&_IOC_READ)
124     ret=!access_ok(VERIFY_WRITE,(void __user*)arg,_IOC_SIZE(cmd));
125   else if( _IOC_DIR(cmd)&_IOC_WRITE )
126     ret=!access_ok(VERIFY_READ,(void   __user*)arg,_IOC_SIZE(cmd));
127   if(ret){
128     pr_err("bad   access %ld.\n",ret);
129     return-EFAULT;
130   } 
131     switch(cmd)
132     {
133       case DEV_FIFO_CLEAN:
134          printk("CMD:CLEAN\n");
135       memset(mycd->buffer, 0, sizeof(mycd->buffer));
136          break;
137       case DEV_FIFO_SETVALUE:
138          printk("CMD:SETVALUE\n");
139          mycd->len = arg;
140          break;
141       case DEV_FIFO_GETVALUE:
142          printk("CMD:GETVALUE\n");
143          ret   = put_user(mycd->len, (int *)arg);
144          break;
145       default:
146          return   -EFAULT;
147     }
148     return   ret;
149 }
150 
151 //设备操作函数接口
152 
153 static const struct file_operations fifo_operations = {
154     .owner =   THIS_MODULE,
155     .open =   dev_fifo_open,
156     .read =   dev_fifo_read,
157     .write =   dev_fifo_write,
158     .unlocked_ioctl =   dev_fifo_unlocked_ioctl,
159 };
160 //模块入口
161 int __init dev_fifo_init(void)
162 {
163     int i = 0;
164     int n = 0;
165     int ret;
166 
167     struct   device *device;
168   gcd   = kzalloc(ndevices   * sizeof(struct   mycdev), GFP_KERNEL);
169 
170     if(!gcd){
171         return   -ENOMEM;
172     }
173 
174     //设备号 : 主设备号(12bit) | 次设备号(20bit)
175     dev_num   = MKDEV(MAJOR_NUM, 0);
176     //静态注册设备号
177     ret   = register_chrdev_region(dev_num,ndevices,"dev_fifo");
178     if(ret < 0){
179     //静态注册失败,进行动态注册设备号
180      ret   =alloc_chrdev_region(&dev_num,0,ndevices,"dev_fifo");
181       if(ret < 0){
182         printk("Fail to register_chrdev_region\n");
183         goto   err_register_chrdev_region;
184       }
185     }
186     //创建设备类
187     cls   = class_create(THIS_MODULE, "dev_fifo");
188     if(IS_ERR(cls)){
189         ret   = PTR_ERR(cls);
190         goto   err_class_create;
191     }
192     printk("ndevices :   %d\n",ndevices);
193     for(n = 0;n < ndevices;n   ++)
194     {
195       //初始化字符设备
196       cdev_init(&gcd[n].cdev,&fifo_operations);
197       //添加设备到操作系统
198       ret   = cdev_add(&gcd[n].cdev,dev_num + n,1);
199       if (ret < 0)
200       {
201          goto   err_cdev_add;
202       }
203      //导出设备信息到用户空间(/sys/class/类名/设备名)
204       device   = device_create(cls,NULL,dev_num +n,NULL,"dev_fifo%d",n);
205       if(IS_ERR(device)){
206          ret   = PTR_ERR(device);
207          printk("Fail to device_create\n");
208          goto   err_device_create;    
209       }
210     }
211     printk("Register   dev_fito to system,ok!\n");
212     return   0;
213 err_device_create:
214 
215     //将已经导出的设备信息除去
216     for(i = 0;i < n;i ++)
217     {
218        device_destroy(cls,dev_num + i);    
219     }
220 err_cdev_add:
221     //将已经添加的全部除去
222     for(i = 0;i < n;i ++)
223     {
224        cdev_del(&gcd[i].cdev);
225     }
226 err_class_create:
227     unregister_chrdev_region(dev_num,   ndevices);
228 err_register_chrdev_region:
229     return   ret;
230 }
231 void __exit dev_fifo_exit(void)
232 {
233     int i;
234     //删除sysfs文件系统中的设备
235     for(i = 0;i < ndevices;i   ++)
236     {
237         device_destroy(cls,dev_num + i);    
238     }
239     //删除系统中的设备类
240     class_destroy(cls);
241     //从系统中删除添加的字符设备
242     for(i = 0;i < ndevices;i   ++)
243     {
244        cdev_del(&gcd[i].cdev);
245     } 
246     //释放申请的设备号
247     unregister_chrdev_region(dev_num,   ndevices);
248     return;
249 }
250 module_init(dev_fifo_init);
251 module_exit(dev_fifo_exit);   

头文件内容:

dev_fifo_head.h

1 #ifndef _DEV_FIFO_HEAD_H
2 #define _DEV_FIFO_HEAD_H
3 #define DEV_FIFO_TYPE 'k'
4 #define DEV_FIFO_CLEAN _IO(DEV_FIFO_TYPE,0x10)
5 #define DEV_FIFO_GETVALUE _IOR(DEV_FIFO_TYPE,0x11,int)
6 #define DEV_FIFO_SETVALUE _IOW(DEV_FIFO_TYPE,0x12,int)
7 #endif

Makefile :

 1 ifeq ($(KERNELRELEASE),)
 2 KERNEL_DIR ?=/lib/modules/$(shell uname -r)/build  
 3 PWD :=$(shell pwd)
 4 modules:
 5     $(MAKE) -C $(KERNEL_DIR)   M=$(PWD) modules
 6 .PHONY:modules clean
 7 clean:
 8     $(MAKE) -C $(KERNEL_DIR)   M=$(PWD) clean
 9 else
10     obj-m := dev_fifo.o  
11 endif

应用程序:

 1 #include 
 2 #include 
 3 #include 
 4 #include <string.h>
 5 #include 
 6 #include 
 7 
 8 int main(int argc, const char *argv[])
 9 {
10     int fd ;
11     int n;
12     char buf[1024] = "hello   word";
13     
14     fd = open("/dev/dev_fifo0",O_RDWR);
15     if(fd < 0){
16         perror("Fail   ot open");
17         return   -1;
18     }
19     printf("open   successful ,fd = %d\n",fd);
20     n = write(fd,buf,strlen(buf));
21     if(n < 0){
22         perror("Fail   to write");
23         return   -1;
24     }
25     printf("write   %d bytes!\n",n);
26     n = write(fd,buf,strlen(buf));
27     if(n < 0){
28         perror("Fail   to write");
29         return   -1;
30     }
31     printf("write   %d bytes!\n",n);
32     return 0;
33 }

测试步骤:

(1)   加载模块

1 sudo insmod hello.ko

(2)   创建设备节点

1 sudo mknod /dev/hello c 250 0

如果代码中增加了自动创建设备节点的功能,这个步骤不要执行。

(3)   测试字符设备

1 gcc test.c -o runsudo 
2 ./run

更多嵌入式资料,请关注公众号: 一口Linux