按键、鼠标、键盘、触摸屏等都属于输入(input)
设备,
Linux
内核为此专门做了一个叫做
input 子系统的框架来处理输入事件。
输入设备本质上还是字符设备,只是在此基础上套上了 input 框架
,用户只需要负责上报输入事件,比如按键值、坐标等信息,input
核心层负责处理这些事件。
input 就是输入的意思,因此
input
子系统就是管理输入的子系统,和
pinctrl
、
gpio
子系统一样,都是 Linux
内核针对某一类设备而创建的框架。比如按键输入、键盘、鼠标、触摸屏等等这些都属于输入设备,不同的输入设备所代表的含义不同,按键和键盘就是代表按键信息,鼠标和触摸屏代表坐标信息,因此在应用层的处理就不同,
对于驱动编写者而言不需要去关心应用层的事情,我们只需要按照要求上报这些输入事件即可
。为此 input
子系统分为
input
驱动层、input
核心层、
input
事件处理层,最终给用户空间提供可访问的设备节点
驱动层:输入设备的具体驱动程序,比如按键驱动程序,向内核层报告输入内容。
核心层:承上启下,为驱动层提供输入设备注册和操作接口。通知事件层对输入事件进行处理。
事件层:主要和用户空间进行交互
input 驱动编写流程
input 核心层会向 Linux
内核注册一个字符设备,大家找到
drivers/input/input.c
这个文件,
input.c
就是
input
输入子系统的核心层
1、注册 input_dev
在使用
input
子系统的时候我们只需要注册一个
input
设备即可,
input_dev
结构体表示
input
设备,此结构体定义在
include/linux/input.h
文件中
比如本章我们要使用到按键,那么就需要注册
EV_KEY
事件,如果要使用连按功能的话还需要注册 EV_REP
事件。
在编写 input
设备驱动的时候我们需要先申请一个
input_dev
结构体变量,使用 input_allocate_device 函数来申请一个
input_dev
,此函数原型如下所示:
struct input_dev *input_allocate_device(void)
如果要注销的 input
设备的话需要使用
input_free_device
函数来释放掉前面申请到的
input_dev
,
input_free_device
函数原型如下:
void input_free_device(struct input_dev *dev)
申请好一个 input_dev
以后就需要初始化这个
input_dev
,需要初始化的内容主要为事件类
型
(evbit)
和事件值
(keybit)
这两种。
input_dev
初始化完成以后就需要向
Linux
内核注册
input_dev
了,需要用到
input_register_device
函数,此函数原型如下:
int input_register_device(struct input_dev *dev)
注销 input
驱动的时候也需要使用
input_unregister_device
函数来注销掉前面注册
的
input_dev
,
input_unregister_device
函数原型如下:
void input_unregister_device(struct input_dev *dev)
综上所述,input_dev 注册过程如下:
三种设置事件类型及其事件值的方法
2、上报输入事件
具体是什么样的输入值
Linux
内核是不知道的,我们需要获取到具体的输入值,或者说是输入事件,然后将输入事件上报给 Linux
内核。比如按键,我们需要在按键中断处理函数,或者消抖定时器中断函数中将按键值上报给 Linux
内核,这样
Linux
内核才能获取到正确的输入值。不同的事件,其上报事件的 API
函数不同,
我们依次来看一下一些常用的事件上报 API 函数。
1、首先是
input_event
函数,此函数用于上报指定的事件以及对应的值,函数原型如下:
void input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)
input_event
函数可以上报所有的事件类型和事件值,
Linux
内核也提供了其他的针对具体
事件的上报函数,这些函数其实都用到了
input_event
函数。比如上报
按键
所使用的
input_report_key 函数
,此函数内容如下:
同样的还有一些其他的事件上报函数,这些函数如下所示:
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
函数本质是上报一个同步事件,此函数原型如下所示:
void input_sync(struct input_dev *dev)
3 input_event 结构体
Linux 内核使用
input_event
这个结构体来表示所有的输入事件,
input_envent
结构体定义在
include/uapi/linux/input.h
文件中
time
:时间,也就是此事件发生的时间,为
timeval 结构体类型 ,tv_sec 和 tv_usec 这两个成员变量都为 long 类型,也就是 32位
type:事件类型,比如 EV_KEY,表示此次事件为按键事件,此成员变量为 16 位。
code:事件码,比如在 EV_KEY 事件中 code 就表示具体的按键码,如:KEY_0、KEY_1 等等这些按键。此成员变量为 16 位。
value
:
值,比如
EV_KEY
事件中
value
就是按键值,表示按键有没有被按下,如果为
1
的话说明按键按下,如果为 0
的话说明按键没有被按下或者按键松开了。
input_envent 这个结构体非常重要,因为所有的输入设备最终都是按照 input_event
结构体呈现给用户的,用户应用程序可以通过 input_event
来获取到具体的输入事件或相关的值,比如按键值等。
具体的key or button 值 看文件 input-event-codes.h 这个实验驱动层和应用层都重要
Linux内核自带了按键驱动,上一个是LED驱动(这些都是主机驱动)(也就是说你只需要给设备信息就可以了)
是一个标准的platform驱动编写框架,就是又回到了上 上章 有设备树的platform驱动框架程序
/* linux自带的key驱动设备树 */
gpio-keys {
compatible = "gpio-keys";
#address-cells = <1>;
#size-cells = <0>;
autorepeat;
key0 {
label = "GPIO Key Enter";
linux,code = <KEY_ENTER>;
gpios = <&gpio1 18 GPIO_ACTIVE_LOW>;
};
};
=========================================================================
platform misc input三种框架对比
platform驱动框架 (有设备树)
misc驱动框架
input驱动框架 与platform没关系 全新的框架
=========================================================================
#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>
/***************************************************************
Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved.
文件名 : keyinput.c
作者 : 左忠凯
版本 : V1.0
描述 : Linux按键input子系统实验
其他 : 无
论坛 : www.openedv.com
日志 : 初版V1.0 2019/8/21 左忠凯创建
***************************************************************/
#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_report_key 上报按键值 */
/* input_sync 作同步 */
//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("zuozhongkai");
#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>
/***************************************************************
Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved.
文件名 : keyinputApp.c
作者 : 左忠凯
版本 : V1.0
描述 : input子系统测试APP。
其他 : 无
使用方法 :./keyinputApp /dev/input/event1
论坛 : www.openedv.com
日志 : 初版V1.0 2019/8/26 左忠凯创建
***************************************************************/
/* 定义一个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) { /* 键盘键值 区分是 key 还是 button*/
/* 一般来说用 button 因为key是模拟键盘的 */
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;
}