Linux input子系统简述(Linux驱动开发篇)

1. 简介

• input 子系统就是管理输入的子系统，和pinctrl、gpio 子系统一样，都是 Linux 内核针对某一类设备而创建的框架。
• 按键、鼠标、键盘、触摸屏等都属于输入设备，linux内核为此专门做了一个叫做input子系统的框架来处理输入事件。
• 输入设备本质上还是字符设备，只是在此基础上套上了input框架，用户只需要负责上报输入事件，比如按键值、坐标等信息。
• 对于驱动编写者而言不需要去关心应用层的事情，我们只需要按照要求上报这些输入事件即可
• 为此input子系统分为 input驱动层、input 核心层、input 事件处理层，最终给用户空间提供可访问的设备节点

intput子系统框架

• 左边就是最底层的具体设备，比如按键、USB 键盘/鼠标等
• 中间部分属于Linux内核空间，分为驱动层、核心层和事件层
• 最右边的就是用户空间，所有的输入设备以文件的形式供用户应用程序使用

** input子系统用到了我们前面讲解的驱动分层模型**

编写驱动程序的时候只需要关注中间的驱动层、核心层和事件层.

• 驱动层：输入设备的具体驱动程序，比如按键驱动程序，向内核层报告输入内容。内核
• 核心层：承上启下，为驱动层提供输入设备注册和操作接口。通知事件层对输入事件进行处理。接口
• 事件层：主要和用户空间进行交互应用层

2.input驱动实现

2.1 注册input_dev

input子系统的所有设备主设备号都为 13，我们在使用input子系统处理输入设备的时候就不需要去注册字符设备了，我们只需要向系统注册一个input_device即可

** input_dev注册流程：**

• 1.使用input_allocate_device函数申请一个 input_dev。
• 2.初始化input_dev的事件类型以及事件值
• 3.使用input_register_device函数向Linux系统注册前面初始化好的 input_dev
• 4.卸载input驱动的时候需要先使用input_unregister_device函数注销掉注册的input_dev，然后使用input_free_device 函数释放掉前面申请的 input_dev

input_dev 注册流程 代码实现

/*
@	事件类型 ====定义在include/uapi/linux/input.h 文件
*/
define EV_SYN            0x00    /* 同步事件     */ 
define EV_KEY            0x01    /* 按键事件     */ 
define EV_REL            0x02    /* 相对坐标事件   */ 
define EV_ABS            0x03    /* 绝对坐标事件   */ 
define EV_MSC            0x04    /* 杂项(其他)事件   */ 
define EV_SW             0x05    /* 开关事件     */ 
define EV_LED            0x11    /* LED       */ 
define EV_SND            0x12    /* sound(声音)   */ 
define EV_REP            0x14    /* 重复事件     */ 
define EV_FF             0x15    /* 压力事件     */ 
define EV_PWR            0x16    /* 电源事件     */ 
define EV_FF_STATUS      0x17    /* 压力状态事件   */ 

/*
@	按键值===定义在 include/uapi/linux/input.h 文件中
*/
#define KEY_RESERVED      0 
#define KEY_ESC             1 
#define KEY_1               2 
#define KEY_2               3 
#define KEY_3               4 
#define KEY_4               5 
#define KEY_5               6 
#define KEY_6               7 
#define KEY_7               8 
#define KEY_8               9 
#define KEY_9               10 
#define KEY_0               11 
.. 
#define BTN_TRIGGER_HAPPY39  0x2e6 
#define BTN_TRIGGER_HAPPY40  0x2e7 
/* 

@	input_dev 结构体 =======定义在 include/linux/input.h文件中
*/
struct input_dev { 
    const char *name; 
    const char *phys; 
    const char *uniq; 
    struct input_id id; 
 
    unsigned long propbit[BITS_TO_LONGS(INPUT_PROP_CNT)]; 
 
    unsigned long evbit[BITS_TO_LONGS(EV_CNT)];  /* 事件类型的位图 */ 
    unsigned long keybit[BITS_TO_LONGS(KEY_CNT)];  /* 按键值的位图   */ 
    unsigned long relbit[BITS_TO_LONGS(REL_CNT)];  /* 相对坐标的位图  */ 
    unsigned long absbit[BITS_TO_LONGS(ABS_CNT)];  /* 绝对坐标的位图  */ 
    unsigned long mscbit[BITS_TO_LONGS(MSC_CNT)];  /* 杂项事件的位图  */ 
    unsigned long ledbit[BITS_TO_LONGS(LED_CNT)];  /*LED 相关的位图    */
    unsigned long sndbit[BITS_TO_LONGS(SND_CNT)];/* sound 有关的位图 */
    unsigned long ffbit[BITS_TO_LONGS(FF_CNT)];  /* 压力反馈的位图  */ 
    unsigned long swbit[BITS_TO_LONGS(SW_CNT)];   /*开关状态的位图   */ 
.. 
    bool devres_managed; 
}; 

struct input_dev *inputdev;      /* input 结构体变量 */ 
 
/* 驱动入口函数 */ 
static int __init xxx_init(void) 
{ 
   ...... 
   inputdev = input_allocate_device();   /* 申请 input_dev    */ 
   inputdev->name = "test_inputdev";      /* 设置 input_dev 名字  */ 
 
   /*********第一种设置事件和事件值的方法***********/ 
   __set_bit(EV_KEY, inputdev->evbit);   /* 设置产生按键事件     */ 
   __set_bit(EV_REP, inputdev->evbit);   /* 重复事件        */ 
   __set_bit(KEY_0, inputdev->keybit);   /*设置产生哪些按键值   */ 
   /************************************************/ 

   /*********第二种设置事件和事件值的方法***********/ 
   keyinputdev.inputdev->evbit[0] = BIT_MASK(EV_KEY) |  
BIT_MASK(EV_REP); 
   keyinputdev.inputdev->keybit[BIT_WORD(KEY_0)] |=  
BIT_MASK(KEY_0); 
   /************************************************/ 
 
   /*********第三种设置事件和事件值的方法***********/ 
   keyinputdev.inputdev->evbit[0] = BIT_MASK(EV_KEY) |  
BIT_MASK(EV_REP); 
   input_set_capability(keyinputdev.inputdev, EV_KEY, KEY_0); 
   /************************************************/ 
  
   /* 注册 input_dev */ 
   input_register_device(inputdev); 
   ...... 
   return 0; 
} 
/* 驱动出口函数 */ 
static void __exit xxx_exit(void) 
{ 
   input_unregister_device(inputdev);    /* 注销 input_dev  */ 
   input_free_device(inputdev);            /* 删除 input_dev  */ 
} 

2.2 上报事件

2.2.1介绍

• 当我们向Linux内核注册好 input_dev以后还不能高枕无忧的使用input设备
• input设备都是具有输入功能的，但是具体是什么样的输入值 Linux 内核是不知道的，我们需要获取到具体的输入值，或者说是输入事件，然后将输入事件上报给 Linux 内核
• 1.不同的事件，其上报事件的 API函数不同。

/*
@	用于上报指定的事件以及对应的值(可以上报所有的事件类型和事件值)
@	dev：需要上报的 input_dev
@	type: 上报的事件类型，比如 EV_KEY
@	code：事件码，也就是我们注册的按键值，比如KEY_0、KEY_1 等等
@	value：事件值，比如1表示按键按下，0表示按键松开
*/
void input_event(struct input_dev* dev,unsigned int type,unsigned int code, int value)

/*
@	上报按键的特定input_report_key函数		
*/
static inline void input_report_key(struct input_dev* dev,unsigned int code,int value)
{
	input_event(dev,EV_KEY,code,!!value););
}

/*
@	还有其它的特定对应的上报事件函数
*/
void input_report_rel(struct input_dev *dev, unsigned int code, int value) 
void input_report_abs(struct input_dev *dev, unsigned int code, int value) 
void input_report_ff_status(struct input_dev *dev, unsigned int code, int value) 
void input_report_switch(struct input_dev *dev, unsigned int code, int value) 
void input_mt_sync(struct input_dev *dev) 

• 2.当我们上报事件以后还需要使用 input_sync 函数来告诉 Linux 内核 input 子系统上报结束

/*
@	input_sync函数本质是上报一个同步事件
@	dev：需要上报同步事件的 input_dev
@	返回值：无
*/

void input_sync(struct input_dev* dev)

事件上报参考代码

/* 用于按键消抖的定时器服务函数 */ 
void timer_function(unsigned long arg) 
{ 
   unsigned char value; 
  
   value = gpio_get_value(keydesc->gpio);    /* 读取 IO 值   */ 
   if(value == 0){                             /* 按下按键     */ 
         /* 上报按键值 */ 
         input_report_key(inputdev, KEY_0, 1);  /* 最后一个参数 1，按下 
       input_sync(inputdev);                   /*  同步事件   */ 
   } else {                                      /* 按键松开     */ 
       input_report_key(inputdev, KEY_0, 0);  /* 最后一个参数 0，松开 
       input_sync(inputdev);                   /*  同步事件   */ 
   }    
} 

3.例子

按键驱动

#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/delay.h>
#include <linux/ide.h>
#include <linux/init.h>
#include <linux/module.h>
#include <linux/errno.h>
#include <linux/gpio.h>
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/of_gpio.h>
#include <linux/input.h>
#include <linux/semaphore.h>
#include <linux/timer.h>
#include <linux/of_irq.h>
#include <linux/irq.h>
#include <asm/mach/map.h>
#include <asm/uaccess.h>
#include <asm/io.h>

#define KEYINPUT_CNT		1			/* 设备号个数 	*/
#define KEYINPUT_NAME		"keyinput"	/* 名字 		*/
#define KEY0VALUE			0X01		/* KEY0按键值 	*/
#define INVAKEY				0XFF		/* 无效的按键值 */
#define KEY_NUM				1			/* 按键数量 	*/

/* 中断IO描述结构体 */
struct irq_keydesc {
	int gpio;								/* gpio */
	int irqnum;								/* 中断号     */
	unsigned char value;					/* 按键对应的键值 */
	char name[10];							/* 名字 */
	irqreturn_t (*handler)(int, void *);	/* 中断服务函数 */
};

/* keyinput设备结构体 */
struct keyinput_dev{
	dev_t devid;			/* 设备号 	 */
	struct cdev cdev;		/* cdev 	*/
	struct class *class;	/* 类 		*/
	struct device *device;	/* 设备 	 */
	struct device_node	*nd; /* 设备节点 */

	struct timer_list timer;/* 定义一个定时器*/

	struct irq_keydesc irqkeydesc[KEY_NUM];	/* 按键描述数组 */
	
	unsigned char curkeynum;				/* 当前的按键号 */
	
	struct input_dev *inputdev;		/* input结构体 */
};

struct keyinput_dev keyinputdev;	/* key input设备 */

/* @description		: 中断服务函数，开启定时器，延时10ms，
 *				  	  定时器用于按键消抖。
 * @param - irq 	: 中断号 
 * @param - dev_id	: 设备结构。
 * @return 			: 中断执行结果
 */
static irqreturn_t key0_handler(int irq, void *dev_id)
{
	struct keyinput_dev *dev = (struct keyinput_dev *)dev_id;

	dev->curkeynum = 0;
	dev->timer.data = (volatile long)dev_id;
	mod_timer(&dev->timer, jiffies + msecs_to_jiffies(10));	/* 10ms定时 */
	return IRQ_RETVAL(IRQ_HANDLED);
}

/* @description	: 定时器服务函数，用于按键消抖，定时器到了以后
 *				  再次读取按键值，如果按键还是处于按下状态就表示按键有效。
 * @param - arg	: 设备结构变量
 * @return 		: 无
 */
void timer_function(unsigned long arg)
{
	unsigned char value;
	unsigned char num;
	struct irq_keydesc *keydesc;
	struct keyinput_dev *dev = (struct keyinput_dev *)arg;

	num = dev->curkeynum;
	keydesc = &dev->irqkeydesc[num];
	value = gpio_get_value(keydesc->gpio); 	/* 读取IO值 */
	if(value == 0){ 						/* 按下按键 */
		/* 上报按键值 */
		//input_event(dev->inputdev, EV_KEY, keydesc->value, 1);
		input_report_key(dev->inputdev, keydesc->value, 1);/* 最后一个参数表示按下还是松开，1为按下，0为松开 */
		input_sync(dev->inputdev);
	} else { 									/* 按键松开 */
		//input_event(dev->inputdev, EV_KEY, keydesc->value, 0);
		input_report_key(dev->inputdev, keydesc->value, 0);
		input_sync(dev->inputdev);
	}	
}

/*
 * @description	: 按键IO初始化
 * @param 		: 无
 * @return 		: 无
 */
static int keyio_init(void)
{
	unsigned char i = 0;
	char name[10];
	int ret = 0;
	
	keyinputdev.nd = of_find_node_by_path("/key");
	if (keyinputdev.nd== NULL){
		printk("key node not find!\r\n");
		return -EINVAL;
	} 

	/* 提取GPIO */
	for (i = 0; i < KEY_NUM; i++) {
		keyinputdev.irqkeydesc[i].gpio = of_get_named_gpio(keyinputdev.nd ,"key-gpio", i);
		if (keyinputdev.irqkeydesc[i].gpio < 0) {
			printk("can't get key%d\r\n", i);
		}
	}
	
	/* 初始化key所使用的IO，并且设置成中断模式 */
	for (i = 0; i < KEY_NUM; i++) {
		memset(keyinputdev.irqkeydesc[i].name, 0, sizeof(name));	/* 缓冲区清零 */
		sprintf(keyinputdev.irqkeydesc[i].name, "KEY%d", i);		/* 组合名字 */
		gpio_request(keyinputdev.irqkeydesc[i].gpio, name);
		gpio_direction_input(keyinputdev.irqkeydesc[i].gpio);	
		keyinputdev.irqkeydesc[i].irqnum = irq_of_parse_and_map(keyinputdev.nd, i);
	}
	/* 申请中断 */
	keyinputdev.irqkeydesc[0].handler = key0_handler;
	keyinputdev.irqkeydesc[0].value = KEY_0;
	
	for (i = 0; i < KEY_NUM; i++) {
		ret = request_irq(keyinputdev.irqkeydesc[i].irqnum, keyinputdev.irqkeydesc[i].handler, 
		                 IRQF_TRIGGER_FALLING|IRQF_TRIGGER_RISING, keyinputdev.irqkeydesc[i].name, &keyinputdev);
		if(ret < 0){
			printk("irq %d request failed!\r\n", keyinputdev.irqkeydesc[i].irqnum);
			return -EFAULT;
		}
	}

	/* 创建定时器 */
	init_timer(&keyinputdev.timer);
	keyinputdev.timer.function = timer_function;

	/* 申请input_dev */
	keyinputdev.inputdev = input_allocate_device();
	keyinputdev.inputdev->name = KEYINPUT_NAME;
#if 0
	/* 初始化input_dev，设置产生哪些事件 */
	__set_bit(EV_KEY, keyinputdev.inputdev->evbit);	/* 设置产生按键事件          */
	__set_bit(EV_REP, keyinputdev.inputdev->evbit);	/* 重复事件，比如按下去不放开，就会一直输出信息 		 */

	/* 初始化input_dev，设置产生哪些按键 */
	__set_bit(KEY_0, keyinputdev.inputdev->keybit);	
#endif

#if 0
	keyinputdev.inputdev->evbit[0] = BIT_MASK(EV_KEY) | BIT_MASK(EV_REP);
	keyinputdev.inputdev->keybit[BIT_WORD(KEY_0)] |= BIT_MASK(KEY_0);
#endif

	keyinputdev.inputdev->evbit[0] = BIT_MASK(EV_KEY) | BIT_MASK(EV_REP);
	input_set_capability(keyinputdev.inputdev, EV_KEY, KEY_0);

	/* 注册输入设备 */
	ret = input_register_device(keyinputdev.inputdev);
	if (ret) {
		printk("register input device failed!\r\n");
		return ret;
	}
	return 0;
}

/*
 * @description	: 驱动入口函数
 * @param 		: 无
 * @return 		: 无
 */
static int __init keyinput_init(void)
{
	keyio_init();
	return 0;
}

/*
 * @description	: 驱动出口函数
 * @param 		: 无
 * @return 		: 无
 */
static void __exit keyinput_exit(void)
{
	unsigned int i = 0;
	/* 删除定时器 */
	del_timer_sync(&keyinputdev.timer);	/* 删除定时器 */
		
	/* 释放中断 */
	for (i = 0; i < KEY_NUM; i++) {
		free_irq(keyinputdev.irqkeydesc[i].irqnum, &keyinputdev);
	}
	/* 释放input_dev */
	input_unregister_device(keyinputdev.inputdev);
	input_free_device(keyinputdev.inputdev);
}

module_init(keyinput_init);
module_exit(keyinput_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("yinghuochong");

测试app

#include "stdio.h"
#include "unistd.h"
#include "sys/types.h"
#include "sys/stat.h"
#include "sys/ioctl.h"
#include "fcntl.h"
#include "stdlib.h"
#include "string.h"
#include <poll.h>
#include <sys/select.h>
#include <sys/time.h>
#include <signal.h>
#include <fcntl.h>
#include <linux/input.h>

/*定义一个input_event变量，用来存放输入事件信息*/
static struct input_event inputevent;

int main(int argc,char* argv[])
{
	char* filename;
	int fd;
	int err=0;

	filename = argv[1];
	if(argc != 2) {
		printf("Error Usage!\r\n");
		return -1;
	}

	fd=open(filename,O_RDWR);
	if (fd < 0) {
		printf("Can't open file %s\r\n", filename);
		return -1;
	}

	while(1){
		err=read(fd,&inputevent,sizeof(inputevent));
		if(err>0){
			switch (inputevent.type)
			{
			case EV_KEY: /* constant-expression */
				if(inputevent.code<BTN_MISC){
					printf("key %d %s\r\n", inputevent.code, inputevent.value ? "press" : "release");
				}else{
					printf("button %d %s\r\n", inputevent.code, inputevent.value ? "press" : "release");
				}
				break;
	
			case EV_REL: /* constant-expression */
				/* code */
				break;
			case EV_ABS: /* constant-expression */
				/* code */
				break;
			case EV_MSC: /* constant-expression */
				/* code */
				break;
			case EV_SW: /* constant-expression */
				/* code */
				break;
			default:
				break;
			}
		}else{
			printf("读取数据失败\r\n");
		}
	}

	return 0;
}