ioctl

  • 除了读取和写入设备之外,大部分驱动程序还需要另外一种能力,就是通过设备驱动程序执行各种类型的硬件控制。
  • 除简单数据传输之外,大部分设备可以执行其他一些操作,比如,用户空间经常会请求设备锁门、弹出介质、报告错误信息、改变波特率等等。
  • 这些操作通常通过ioctl方法来实现
  • 用户空间,ioctl系统调用具有如下原型:
    int ioctl(int fd,int cmd, ...);
    参数:fd 使要操作的文件描述符
    cmd:控制命令
    ...:可选参数,具体形式依赖于第二个参数cmd,因为有些控制命令需要参数,有些命令不需要参数。
  • 内核驱动程序,ioctl方法原型如下:
    int (*ioctl)(struct inode *inode,struct file *filp,unsigned int cmd,unsigned long arg);
    参数inode和filp:和open方法的参数一样,表示文件节点和打开的file结构
    参数cmd:由用户空间不经修改地传递进来
    参数arg:使用户空间传递的整数值;如果用户空间的调用程序没有第三个参数,则驱动的arg参数为未定义状态。

ioctl参数传递

ioctl 命令

  • 在驱动中编写ioctl方法前,需要选择对应不同命令的编号。
  • 为了防止对错误的设备使用正确的命令,命令号必须在系统范围内唯一。
  • 为了方便程序员创建唯一的iotcl命令号,内核规定每一个命令号被分为4个位段,各位段的含义在头文件<asm-generic/ioctl.h>中说明,对于ARM来说,4个位段的含义分别是:


  • 在内核头文件<asm-generic/ioctl.h>中,提供了一些宏来构造命令号:
_IO(type,nr):用于构造无参数的命令号
_IOR(type,nr,datetype):用于构造从驱动程序中读取数据的命令号
_IOW(type,nr,datatype):用于构造向驱动程序写入数据的命令号
_IORW(type,nr,datatype):用于构造双向传输的命令号
  • 解开位字段的宏:
_IOC_DIR(cmd):获得传输方向位段的值
_IOC_TYPE(cmd):获得类型的值
_IOC_NR(cmd);获得编号的值
_IOC_SIZE(cmd):获得大小的值
  • 以按键为例子,在tiny4412定义一组ioctl命令,如下所示:



    命令类型为‘f’
    TINY4412_BTN_IORESET 是复位命令,复位驱动按键值为0
    TINY4412_BTN_IOGET 是获取按键值命令
    TINY4412_BTN_IOSET 是设置按键值命令

  • 使用ioctl参数
    • ioctl的第三个参数表示与命令对应的参数,通常这个参数是一个用户空间的指针;
    • 当参数是一个指向用户空间的指针时,在使用这个指针前,必须确保指向的用户空间是合法的。
    • 可以通过函数access_ok()来验证这个地址是否合法;
      int access_ok(int type,const void *addr,unsigned long size);
    • 第一个参数type: VERIFY_READ--从指向的空间中读取
      VERIFY_WRITE:写入到用户空间
    • addr:就是要验证的地址
    • size:指针指向用户内存空间的字节数
    • 返回值:1表示成功,0表示失败
  • 在2.6.36以后ioctl函数已经不再存在了,而是用unlocked_ioctl和compat_ioctl两个函数实现以前版本的ioctl函数。
    • unlocked_ioctl:不阻塞的ioctl
    • compat_ioctl:兼容性的ioctl(用户空间为32位模式,而内核运行在64位模式时)。

实战代码

btn_drv.c

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/init.h>
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/types.h>
#include <linux/wait.h>
#include <linux/sched.h>
#include <linux/delay.h>
#include <linux/irq.h>
#include <asm/uaccess.h>
#include <asm/irq.h>
#include <asm/io.h>
#include <linux/interrupt.h>
#include <linux/device.h>
#include <mach/hardware.h>
#include <linux/gpio.h>

#include <mach/map.h>
#include <mach/gpio.h>
#include <mach/regs-clock.h>
#include <mach/regs-gpio.h>

#include "btn.h"

struct btn_t {
    int gpio;
    int key;
    char *name;
};
static struct btn_t btns[] = {
    { EXYNOS4_GPX3(2), 1 ,"K1" },
    { EXYNOS4_GPX3(3), 2 ,"K2" },
    { EXYNOS4_GPX3(4), 3 ,"K3" },
    { EXYNOS4_GPX3(5), 4 ,"K4" },
};

static DECLARE_WAIT_QUEUE_HEAD(btn_waitq);
static volatile char key_value = 0;
static volatile int ev_press = 0;

static irqreturn_t btn_irq_handler(int irq, void *dev)
{
    struct btn_t * p = (struct btn_t *)dev;
    key_value = p->key;
    ev_press = 1;
    wake_up_interruptible(&btn_waitq);
    
    return IRQ_HANDLED;
}

static int btn_drv_open(struct inode *inode, struct file *file)
{
    return 0;
}

static int btn_drv_close(struct inode *inode, struct file *file)
{
    return 0;
}

static int btn_drv_read(struct file *filp, char __user *buff,size_t count, loff_t *offp)
{
    //休眠直到ev_press为真
    wait_event_interruptible(btn_waitq, ev_press);
    ev_press = 0;
    copy_to_user(buff,&key_value,sizeof(key_value));
    return sizeof(key_value);
}

static long btn_drv_ioctl (struct file *filp, unsigned int cmd, unsigned long arg)
{
    int err = 0;
    int retval = 0;
    if(_IOC_TYPE(cmd) != TINY4412_BTN_TYPE )
        return -EINVAL;
    if(_IOC_NR(cmd) >TINY4412_BTN_MAXNUM )
        return -EINVAL;
    if(_IOC_DIR(cmd) &_IOC_READ)
        {
            if(!access_ok(VERIFY_WRITE, (void __user *)arg, _IOC_SIZE(cmd)))
                return -EFAULT;
        }
    else if(_IOC_DIR(cmd)&_IOC_WRITE)
        {
            if(!access_ok(VERIFY_READ, (void __user *)arg, _IOC_SIZE(cmd)))
                return -EFAULT;
        }

    switch(cmd)
    {
        case TINY4412_BTN_IORESET:
            key_value = 0;
            printk("TINY4412 btn drv ioctl IORESET!\n ");
            break;
            
        case TINY4412_BTN_IOGET:
            key_value++;
            copy_to_user((void __user *)arg, &key_value, sizeof(char));
            printk("TINY4412 btn drv ioctl IOGET key_val++\n");
            break;
            
        case TINY4412_BTN_IOSET:
            copy_from_user(&key_value, (void __user *)arg, sizeof(char));
            printk("TINY4412 btn drv ioctl IOSET\n");
            break;
        default:
            printk("TINY4412 btn drv ioctl error cmd\n");
            return -EINVAL;
    }

    return retval;
}


static struct file_operations btn_fops = {
    .owner      = THIS_MODULE,
    .open       = btn_drv_open,
    .release    = btn_drv_close, 
    .read       = btn_drv_read,
    .unlocked_ioctl = btn_drv_ioctl,
};

static int major = 0;
static struct class *btn_class = NULL;

static int __init btn_drv_init(void)
{
    int irq;
    int i;
    for(i = 0;i<4;i++){
        irq = gpio_to_irq(btns[i].gpio);
        request_irq(irq, btn_irq_handler, IRQ_TYPE_EDGE_FALLING, 
                btns[i].name, &btns[i]);
    }
    
    major = register_chrdev(0, "btn",&btn_fops);
    btn_class = class_create(THIS_MODULE, "btn");
    device_create(btn_class, NULL, MKDEV(major, 0),NULL,"btn");
    return 0;
}

static void __exit btn_drv_exit(void)
{
    int irq;
    int i;
    for(i = 0;i<4;i++){
        irq = gpio_to_irq(btns[i].gpio);
        free_irq(irq, &btns[i]);
    }
    device_destroy(btn_class, MKDEV(major,0));
    class_destroy(btn_class);
    unregister_chrdev(major, "btn");
}

module_init(btn_drv_init);
module_exit(btn_drv_exit);
MODULE_LICENSE("GPL");

ioctl_test.c

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/ioctl.h>

#include "btn.h"

int main(void)
{
    int fd;
    fd = open("/dev/btn",O_RDWR);
    if(fd<0)
    {
        perror("open");
        exit(-1);
    }
    char val;
    /*复位*/
    ioctl(fd,TINY4412_BTN_IORESET);
    /*复位后,获取并打印*/
    ioctl(fd,TINY4412_BTN_IOGET,&val);
    sleep(1);
    printf("app: reset and get val %d\n",val);  

    /*设置值为10*/
    val = 10;
    ioctl(fd,TINY4412_BTN_IOSET,&val);

    /*设置值后,再获取打印值*/
    ioctl(fd,TINY4412_BTN_IOGET,&val);
    sleep(1);   
    printf("app:set and get val %d\n",val);

    return 0;
}

btn.h

#ifndef __BTN_H
#define __BTN_H

#include <linux/ioctl.h>

#define TINY4412_BTN_TYPE 'f'

#define TINY4412_BTN_IORESET    _IO(TINY4412_BTN_TYPE,0)
#define TINY4412_BTN_IOGET  _IOR(TINY4412_BTN_TYPE, 1, char )
#define TINY4412_BTN_IOSET  _IOW(TINY4412_BTN_TYPE, 2, char )

#define TINY4412_BTN_MAXNUM     3

#endif
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容