Linux字符设备驱动框架(一):cdev接口

/************************************************************************************

*本文为个人学习记录,如有错误,欢迎指正。

*本文参考资料: 

*        http://www.cnblogs.com/xiaojiang1025/p/6367061.html

*        http://www.cnblogs.com/xiaojiang1025/p/6367910.html

*        http://www.cnblogs.com/xiaojiang1025/p/6369065.html

*        https://www.cnblogs.com/lifexy/p/7569371.html

*        https://www.cnblogs.com/biaohc/p/6667529.html

************************************************************************************/

1. 字符设备

字符设备是指在I/O传输过程中以字节为单位进行传输的设备。其特点是,不能随机读取字符设备的某一数据,只能按照字节的先后顺序读取数据。常见的字符设备有串口、键盘、鼠标等。

字符设备相关数据结构详见Linux设备管理(二):内核中字符设备的管理

 2. 字符设备驱动框架

2.1 注册驱动

(1)动态申请cdev内存

/* 
*所在文件:/kernel/fs/char_dev.c
*参数:无
*返回值:
*    成功: cdev 对象首地址
*    失败:NULL 
*/
struct cdev *cdev_alloc(void);  

(2)初始化cdev

初始化cdev,建立cdev与file_operations之间的关联。

/* 
*所在文件:/kernel/fs/char_dev.c
*参数:
*        struct cdev *p:                 被初始化的cdev对象  
*        const struct file_operations *p:字符设备操作方法集
*返回值:无 
*/
void cdev_init(struct cdev *p, const struct file_operations *p); 

(3)申请设备号

1)指定设备号

/*
*所在文件:/kernel/fs/char_dev.c
*参数:
*    dev_t from:        起始设备号
*    unsigned count:    需注册的次设备个数
*    const char *name:  设备名称
*返回值:
*    0:   注册成功
*    负数: 注册失败
*/
int register_chrdev_region(dev_t from, unsigned count, const char *name);

2)系统自动分配设备号

/*
*所在文件:/kernel/fs/char_dev.c
*参数:
*    dev_t *dev:         输出型参数,系统自动分配的设备号
*    unsigned baseminor: 次设备的起始编号
*    unsigned count:     次设备的个数
*    const char *name:   设备名称
*返回值:
*    0:   注册成功
*    负数: 注册失败
*/

int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)

(4)注册cdev设备对象

将cdev添加至系统字符设备链表中。

/* 
*所在文件:/kernel/fs/char_dev.c
*参数:
*        struct cdev *p:被初始化的cdev对象  
*        dev_t dev:     起始设备号
*        unsigned count:该设备连续的次设备号的个数
*返回值:
*         成功:返回0
*         失败:返回负数
*/
int cdev_add(struct cdev *p, dev_t dev, unsigned count);

2.2 创建设备文件

创建设备文件的细节详见Linux设备文件的创建

(1)在/sys中导出设备类信息

/* 
*所在文件:/kernel/include/linux/device.h
*参数:
*        owner:类所属模块,一般为THIS_MODULE
*        name: 类名
*返回值:
*        struct class *:指向所创建的类
*/
#define class_create(owner, name)        \
({                                       \
    static struct lock_class_key __key;  \
    __class_create(owner, name, &__key); \
})

(2)创建设备文件

/* 
*所在文件:/kernel/driver/base/core.c
*参数:
*        struct class *class:  被初始化的cdev对象  
*        struct device *parent:父设备
*        dev_t dev:            设备号
*        void *drvdata:     设备的回调数据
*        const char *fmt:      设备名
*返回值:
*        struct device *:      指向所创建的设备
*/
struct device *device_create(struct class *class, struct device *parent, dev_t devt, void *drvdata, const char *fmt, ...);

2.3 实现设备操作

根据需要实现file_operations中的函数,常用的函数如下:

(1)read、write

Linux下各个进程都有自己独立的进程空间,即使是将内核的数据映射到用户进程,该数据的PID也会自动转变为该用户进程的PID,由于这种机制的存在,我们不能直接将数据从内核空间和用户空间进行拷贝,而需要专门的拷贝数据函数/宏:

long copy_from_user(void *to, const void __user * from, unsigned long n)

long copy_to_user(void __user *to, const void *from, unsigned long n)

有了这两个函数,内核中的read,write就可以实现内核空间和用户空间的数据拷贝。

(2)ioctl

虽然在文件操作结构体"structfile_operations"中有很多对应的设备操作函数,但是有些命令是实在找不到对应的操作函数。如CD-ROM的驱动,想要一个弹出光驱的操作,这种操作并不是所有的字符设备都需要的,所以文件操作结构体也不会有对应的函数操作。

出于这样的原因,ioctl就有它的用处了——一些没办法归类的函数就统一放在ioctl这个函数操作中,通过指定的命令来实现对应的操作。所以,ioctl函数里面都实现了多个的对硬件的操作,通过应用层传入的命令来调用相应的操作。

ioctl函数使用的详细方法,详见Linux驱动程序中ioctl函数的用法

/* 
*参数:
*    struct inode *inode和struct file *filp: ioctl的操作有可能是要修改文件的属性,或者访问硬件。要修改文件属性的话,就要用到这两个结构体了,所以这里传来了它们的指针。
*       unsigned int cmd: 命令
*       unsigned long arg:参数
*返回值: 无 
*/

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

2.4 注销驱动

(1)注销cdev

将cdev对象从系统字符设备链表中剔除,并清理cdev所占的内存资源。

/* 
*所在文件:/kernel/fs/char_dev.c
*参数:
*        struct cdev *p:被注销的cdev对象  
*返回值:    无
*/
void cdev_del(struct cdev *p);

(2)释放设备号

/* 
*所在文件:/kernel/fs/char_dev.c
*参数:
*        dev_t from:被注销设备的起始设备号
*        unsigned count:该设备连续的次设备号个数
*返回值:    无
*/
void unregister_chrdev_region(dev_t from, unsigned count);

(3)删除设备类

/* 
*所在文件:/kernel/driver/base/class.c
*参数:
*        struct class *cls:设备类
*返回值:    无
*/
void class_destroy(struct class *cls);

(4)删除设备文件

/* 
*所在文件:/kernel/driver/base/core.c
*参数:
*        struct class *class:设备类
*        dev_t devt:            设备号
*返回值:    无
*/
void device_destroy(struct class *class, dev_t devt);

3. 实例

 详见驱动程序实例(二):LED设备驱动程序( platform + cdev)

posted @ 2018-07-31 22:43  LinFeng-Learning  阅读(1443)  评论(0编辑  收藏  举报