【Linux学习笔记】INPUT 子系统

系列文章目录

【Linux学习笔记】开发板挂载根文件系统

【Linux学习笔记】设备树学习

【Linux学习笔记】pinctrl和gpio子系统

【Linux学习笔记】Linux 并发与竞争

【Linux学习笔记】Linux内核定时器

【Linux学习笔记】Linux中断

【Linux学习笔记】阻塞和非阻塞IO

【Linux学习笔记】异步通知

【Linux学习笔记】platform 设备

【Linux学习笔记】MISC

---

本系列使用的开发板为正点原子阿尔法IMX6ULL开发板，及根据正点原子所的提供教程学习同系列笔记已放置链接在上面。

---

---

用于处理输入信息，本质上还是个字符设备。

一、input子系统简介

   input子系统就是管理输入的子系统，和pinctrl、gpio子系统一样，都是Linux针对于某一类设备而创建的框架，比如按键输入、键盘、鼠标、触摸屏等。不同的输入设备所代表的含义不同，在应用层的处理就不同。
   对于驱动来说只需要按照要求上报这些输入事件即可，根据分层的思想，input子系统分为input驱动层、input核心层、inputs事件处理层，最终给用户提供可访问的设备节点，其框架如图：

   从最左边依次为最底层的具体设备、Linux内核空间和用户空间，其中内核空间又分为：
驱动层：输入设备的具体驱动程序，向内核报告输入内容；
核心层：承上启下，为驱动层提供输入设备注册和操作接口，通知事件层对输入事件进行处理；
事件层：主要和用户空间进行交互。

二、input驱动编写流程

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

input 子系统的所有设备主设备号都为 13多个设备的设备号怎么弄还没搞明白
定义在include/uapi/linux/major.h 文件中，定义如下：

#define INPUT_MAJOR 13

2.1 创建input_dev结构体

struct input_dev *inputdev;

使用input子系统之前需要创建input_dev结构体用于注册一个input设备，此结构体定义在 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;
};

evbit、keybit、relbit 等等都是存放不同事件对应的值。
evbit 表示输入事件类型，可选的事件类型定义在 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 /* 压力状态事件 */

keybit 就是按键事件使用的位图，Linux 内核定义了很多按键值，这些按键值定义在 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

2.2 申请一个 input_dev

使用input设备前要先申请一个 input_dev：

struct input_dev *input_allocate_device(void)
参数：无。
返回值：申请到的 input_dev。

使用示例：
inputdev = input_allocate_device();

2.3 初始化input_dev

设置事件类型和事件值

/*********第一种设置事件和事件值的方法***********/
	/* 初始化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);	


/*********第二种设置事件和事件值的方法***********/
	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);

2.4 注册input_dev

int input_register_device(struct input_dev *dev)
dev：要注册的 input_dev 。
返回值：0，input_dev 注册成功；负值，input_dev 注册失败。

2.5 卸载input驱动

1. 首先使用input_unregister_device函数注销掉注册的input_dev

void input_unregister_device(struct input_dev *dev)
dev：要注销的 input_dev 。
返回值：无。

2. 然后使用 input_free_device 函数释放掉前面申请的 input_dev

void input_free_device(struct input_dev *dev)
dev：需要释放的 input_dev。
返回值：无。

2.6 驱动编写示例

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 */
}

三、事件上报

注册好input_dev以后还不能使用input设备，需要将输入事件上报给Linux内核，比如在按键中断处理函数中将按键值上报给Linux内核，不同事件上报的API也不同。

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 函数可以上报所有的事件类型和事件值，Linux 内核也提供了其他的针对具体事件的上报函数，这些函数其实都用到了 input_event 函数。比如上报按键所使用的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)

当我们上报事件以后还需要使用 input_sync 函数来告诉 Linux 内核 input 子系统上报结束，input_sync 函数本质是上报一个同步事件，此函数原型如下所示：

void input_sync(struct input_dev *dev)
dev：需要上报同步事件的 input_dev。
返回值：无。

使用示例如下：

input_report_key(inputdev, KEY_0, 1); /* 最后一个参数 1，按下 */
input_sync(inputdev); /* 同步事件 */

四、input_event 结构体

Linux 内核使用 input_event 这个结构体来表示所有的输入事件，input_envent 结构体定义在include/uapi/linux/input.h 文件中，结构体内容如下：

struct input_event {
	struct timeval time;
	__u16 type;
	__u16 code;
	__s32 value;
};

time：时间，也就是此事件发生的时间，为 timeval 结构体类型，timeval 结构体定义如下：

typedef long __kernel_long_t;
typedef __kernel_long_t __kernel_time_t;
typedef __kernel_long_t __kernel_suseconds_t;

struct timeval {
	__kernel_time_t tv_sec; /* 秒 long 类型*/
	__kernel_suseconds_t tv_usec; /* 微秒 long 类型*/
};

type：事件类型，比如 EV_KEY，表示此次事件为按键事件，此成员变量为 16 位。
code：事件码，比如在 EV_KEY 事件中 code 就表示具体的按键码，如：KEY_0、KEY_1等等这些按键。此成员变量为 16 位。
value：值，比如 EV_KEY 事件中 value 就是按键值，表示按键有没有被按下，如果为 1 的话说明按键按下，如果为 0 的话说明按键没有被按下或者按键松开了。

所有输入设备最终都是按照input_event结构体呈现给客户的

使用示例如下：

static struct input_event inputevent;

/*
 * @description		: main主程序
 * @param - argc 	: argv数组元素个数
 * @param - argv 	: 具体参数
 * @return 			: 0 成功;其他 失败
 */
int main(int argc, char *argv[])
{
	int fd;
	int err = 0;
	char *filename;

	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:
					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:
					break;
				case EV_ABS:
					break;
				case EV_MSC:
					break;
				case EV_SW:
					break;
			}
		} else {
			printf("读取数据失败\r\n");
		}
	}
	return 0;
}