Linux驱动开发之Input子系统
一、引言
在Linux驱动开发的学习过程中，Input子系统绝对是你绕不开的一道关卡。
在Linux系统中，不论是按键、鼠标、键盘，亦或者是触摸屏，统统都使用Input子系统来处理输入事件。
二、Input子系统
1、Input子系统概述
Input就是输入的意思，因此Input子系统就是管理输入的系统，和Pinctrl、Gpio子系统一样，都是Linux内核针对某一类设备而创建的框架。
不同的输入设备在Input子系统所代表的含义不同，比如按键、键盘就是代表按键信息，鼠标和触摸屏则是代表坐标信息，因此对于不同的输入设备，在中间层或者应用层的处理方式就不一样。对于驱动开发者，并不需要关心他们的处理方式，我们只需要按照要求上报相应信息即可。
2、Input子系统框架
根据Linux内核设计子系统的尿性（驱动分层模型），Input子系统被分为驱动层、核心层、事件处理层。
如下图：
图中左边就是最底层的具体设备，中间部分属于内核空间，分为驱动层、核心层和事件处理层，最右边则是用户空间，所有的输入设备都以文件的形式供用户空间应用程序使用。
驱动层：输入设备的具体程序，比如按键驱动程序。
核心层：承上启下，为驱动层提供输入设备注册和操作接口，通知事件层对输入事件进行处理。
事件处理层：主要和用户空间进行交互。
三、Input驱动编写方法
输入设备本质上就是一个字符设备，只是在此基础上套上了Input子系统的框架。
因此编写Input驱动就是通过调用Input子系统核心层提供的接口向Linux内核去注册一个字符设备驱动。
struct class input_class{
.name = "input",
.devnode = input_devnode,
};
……
static int __init input_init(void){
int err;
err = class_register(&input_class);
if(err){
pr_err(unable to register input_dev clsaa!\n);
return err;
}
err = input_proc_init();
if(err)
goto fail1;
err = register_chrdev_region(MKDEV(INPUT_MAJOR, 0),INPUT_MAX_CHAR_DEVICES, "input");
if (err) {
pr_err("unable to register char major %d", INPUT_MAJOR);
goto fail2;
}
return 0;
fail2: input_proc_exit();
fail1: class_unregister(&input_class);
return err;
}第8行，注册了一个Input类，这样系统启动以后就会在/sys/class下有一个Input子目录。
第18行，注册了一个字符设备，主设备号为INPUT_MAJOR，INPUT_MAJOR在include/uapi/linux/major.h中定义，定义如下：
#define INPUT_MAJOR 13因此，Inpur子系统的所有设备主设备号都为13，我们在使用Input子系统时去处理输入设备时就不需要去注册字符设备了，我们只需要向系统注册一个Input_device即可。
1、注册Input_dev
在使用Input子系统时，我们需要注册一个Input子设备，Linux用Input_dev结构体来表示一个Input子设备，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;
};第9行，evbit表示输入事件类型。前面说过，Input子系统是管理输入的子系统，而在日常生活中，输入设备都很多，为了方便驱动开发者使用，Linux内核开发者定义了很多通用的输入设备类型。
他们被定义在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 /* 压力状态事件 */如果输入设备时键盘，则选择按键事件；如果输入设备时显示屏，则选择绝对坐标事件。
继续看到Input_dev结构体。第10行~17行，keybit、relbit等都是存放不同事件的值。比如接下来用来举例的代码（用按键作为输入事件）所用到的按键键值。
我们可以随便定义一个键值，也可以使用Linux定义的标准键值，标准键值定义在include/uapi/linux/input.h中。
接下来介绍注册Input_dev需要用到的Input子系统核心层提供的接口。
1.1、input_allocate_device
input_allocate_device用来申请一个Input_dev结构体。
函数原型如下：
struct input_dev *input_allocate_device(void)
参数：无。
返回值：申请到的 input_dev。1.2、input_free_device
有申请自然就有释放。
函数原型如下：
void input_free_device(struct input_dev *dev)
dev：需要释放的 input_dev。
返回值：无。1.3、input_register_device
申请之后，需要注册，否则内核，或者说Input子系统是不知道有新的Input子设备存在的。
函数原型如下：
int input_register_device(struct input_dev *dev)
dev：要注册的 input_dev 。
返回值：0，input_dev 注册成功；负值，input_dev 注册失败。1.4、input_unregister_device
该接口用来告诉Input子系统，你要注销一个Input子设备。
函数原型如下：
void input_unregister_device(struct input_dev *dev)
dev：要注销的 input_dev 。
返回值：无。综上，注册一个Input_dev的过程为：
①、使用input_allocate_device申请一个Input_dev结构体；
②、初始化Input_dev的事件类型和对应键值；
③、使用input_register_device向Linux注册之前初始化好的Input_dev；
④、卸载驱动时，先调用input_unregister_device注销，再调用input_free_device释放掉Input_dev。（注意，两者顺序不能弄反，负责会造成内核崩溃）
以下是注册Input_dev的示例代码：
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 */
}EV_KEY就是输入事件类型（按键输入），KEY_0就是对应支持的按键值。
这里需要注意，你有多少按键值，你就需要设置多少，否则你是上报不上去的，没有设置的按键值属于非法值，在Input事件处理层就会被拦下。
2、上报输入事件
当我们向内核注册好Input_dev并不能就此高枕无忧了，因为我们仅仅是注册了一个输入设备，对于用户层来说，他们什么都不知道。
因此，当输入事件来临时，内核就需要去处理并将其上报。
而内核对于不同的输入事件类型有不同的上报接口。
2.1、Input_event
函数原型：
void input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)
dev：需要上报的 input_dev。
type: 上报的事件类型，比如 EV_KEY。
code：事件码，也就是我们注册的按键值，比如 KEY_0、KEY_1 等等。
value：事件值，比如 1 表示按键按下，0 表示按键松开。
返回值：无。input_event可以上报所有的事件类型和事件值。
2.2、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);
}从代码可以看出，该接口由input_event封装而成，事实上，所有类型事件的专用上报接口都是由input_event接口封装而成，不过，对于内核开发者而言，更推荐使用专用的接口。
2.3、input_sync
当我们上报一次事件之后，还需要使用该接口告诉Input子系统上报结束，input_sync本质上是上报一个同步事件。
接下来来看示例代码：
void func(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); /* 同步事件 */
}
}