linux 字符设备实例 ioctl,linux高级字符设备驱动（一 设备Ioctl控制）

1. Ioctl 用来做什么?

大部分驱动除了需要具备读写设备的能力外,还需要具备对硬件控制的能力。例如,要求设备报告错误信息,改变波特率,这些操作常常通过ioctl方法来实现。

1.1 用户使用方法         在用户空间，使用ioctl 系统调用来控制设备，原型如下:

int ioctl(int fd,unsigned long cmd,...)

原型中的点表示这是一个可选的参数，存在与否依赖于控制命令(第2 个参数)是否涉及到与设备的数据交互。

1.2 驱动ioctl方法        ioctl 驱动方法有和用户空间版本不同的原型:

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

cmd参数从用户空间传下来,可选的参数arg 以一个unsigned long 的形式传递,不管它是一个整数或一个指针。如果cmd命令不涉及数据传输，则第3 个参数arg的值无任何意义。

2. Ioctl实现

2.1 实现Ioctl方法的步骤:      1)  定义命令

2.)  实现命令

2.2 定义命令        在编写ioctl代码之前，首先需要定义命令。为了防止对错误的设备使用正确的命令，命令号应该在系统范围内是唯一的。ioctl 命令编码被划分为几个位段，include/asm/ioctl.h中定义了这些位字段：类型(幻数)，序号，传送方向，参数的大小。Documentation/ioctl-number.txt文件中罗列了在内核中已经使用了的幻数。

定义ioctl 命令的正确方法是使用4 个位段, 这个列表中介绍的符号定义在中:

1) Type

幻数(类型): 表明哪个设备的命令,在参考了ioctlnumber.txt之后选出，8 位宽。

2)  Number

序号，表明设备命令中的第几个,8 位宽

3) Direction

数据传送的方向，可能的值是_IOC_NONE(没有数据传输),_IOC_READ, _IOC_WRITE。数据传送是从应用程序的观点来看待的，_IOC_READ 意思是从设备读。

4) Size

用户数据的大小。(13/14位宽，视处理器而定)

内核提供了下列宏来帮助定义命令:

1)  _IO(type，nr)

没有参数的命令

2)  _IOR(type，nr，datatype)

从驱动中读数据

3)  _IOW(type，nr，datatype)

写数据到驱动

4) _IOWR(type，nr，datatype)

双向传送，type 和number 成员作为参数被传递。

定义命令(范例)

#define MEM_IOC_MAGIC ‘m’ //定义幻数

#define MEM_IOCSET

_IOW(MEM_IOC_MAGIC, 0, int)

#define MEM_IOCGQSET

_IOR(MEM_IOC_MAGIC, 1, int)

2.3 Ioctl函数实现        定义好了命令,下一步就是要实现Ioctl函数了，Ioctl函数的实现包括如下3个技术环节:

1)  返回值

2) 参数使用

3) 命令操作

2.3.1 Ioctl函数实现(返回值)

Ioctl函数的实现通常是根据命令执行的一个switch语句。但是，当命令号不能匹配任何一个设备所支持的命令时，通常返回-EINVAL(“非法参数”)。

2.3..2 Ioctl函数实现(参数)

如何使用Ioctl中的参数?

如果是一个整数，可以直接使用。如果是指针，我们必须确保这个用户地址是有效的,因此使用前需进行正确的检查。

2.3.3 Ioctl函数实现(参数检查)

不需要检测：

1) copy_from_user

2) copy_to_user

3) get_user

4) put_user

需要检测：

1) __get_user

2) __put_user

int access_ok(int type, const void *addr, unsigned long size)

第一个参数是VERIFY_READ 或者VERIFY_WRITE，用来表明是读用户内存还是写用户内存。addr 参数是要操作的用户内存地址，size 是操作的长度。如果ioctl 需要从用户空间读一个整数，那么size参数等于sizeof(int)。access_ok 返回一个布尔值: 1 是成功(存取没问题)和0 是失败(存取有问题),如果该函数返回失败, 则Ioctl应当返回–EFAULT 。

3. Ioctl函数实现范例

if (_IOC_DIR(cmd) & _IOC_READ)

err = !access_ok(VERIFY_WRITE, (void __user *)arg,_IOC_SIZE(cmd));   //why _IOC_READ 对应VERIFY_WRITE ???

else if (_IOC_DIR(cmd) & _IOC_WRITE)

err = !access_ok(VERIFY_READ, (void __user *)arg,_IOC_SIZE(cmd));

if (err)

return -EFAULT;

switch(cmd)

{

case MEM_IOCSQUANTUM: /* Set: arg points to the value */

retval = __get_user(scull_quantum, (int *)arg);

break;

case MEM_IOCGQUANTUM: /* Get: arg is pointer to result */

retval = __put_user(scull_quantum, (int *)arg);

break;

default:

return –EINVAL;

}