linux 输入子系统(1) -Event types

输入系统协议用类型types和编码codecs来表示输入设备的值并用此来通知用户空间的应用程序。

input协议是一个基于状态的协议,只有当相应事件编码对应的参数值发生变化时才会发送该事件。不过,状态是由Linux的输入子系统进行维护,驱动程序无需维护输入的状态,就算参数值没有变化时向输入子系统发出事件也不会有问题。用户空间可以用linux/input.h 中定义的EVIOCG*ioctls来获得当前事件编码和参数的状态。设备的所支持的上报事件种类也可以通过sysfs的class/input/event*/device/capabilities/来获取,设备的特性和可以通过class/input/event*/device/properties来获取。

###########################

Event types:

###########################

types对应于一个相同逻辑输入结构的一组Codes。每个type都有一组可用的codes用于产生输入事件。每个type可用的codes的详细信息请参考Codes一节的内容。

* EV_SYN:

  - 用于事件间的分割标志。事件可能按时间或空间进行分割,就像在多点触摸协议中的例子。

* EV_KEY:

  - 用来描述键盘,按键或者类似键盘设备的状态变化。

* EV_REL:

  - 用来描述相对坐标轴上数值的变化,例如:鼠标向左方移动了5个单位。

* EV_ABS:

  -用来描述相对坐标轴上数值的变化,例如:描述触摸屏上坐标的值。

* EV_MSC:

  - 当不能匹配现有的类型时,使用该类型进行描述。

* EV_SW:

  - 用来描述具备两种状态的输入开关。

* EV_LED:

  - 用于控制设备上的LED灯的开和关。

* EV_SND:

  - 用来给设备输出提示声音。

* EV_REP:

  -用于可以自动重复的设备(autorepeating)。

* EV_FF:

  - 用来给输入设备发送强制回馈命令。(震动?)

* EV_PWR:

  - 特别用于电源开关的输入。.

* EV_FF_STATUS:

  - 用于接收设备的强制反馈状态。

Event codes:

===========

Event codes 用于对事件的type进行更精确的定义

EV_SYN:

----------

EV_SYN 事件没有对values进行具体的定义, 它们的使用方式仅在发送evdev的事件串中有定义。

* SYN_REPORT:

  - 当多个输入数据在同一时间发生变化时,SYN_REPORT用于把这些数据进行打包和包同步。例如,一次鼠标的移动可以上报REL_X和REL_Y两个数值,然后发出一个SYN_REPORT。下一次鼠标移动可以再次发出REL_X和REL_Y两个数值,然后经跟这另一个SYN_REPORT。

* SYN_CONFIG:

  -TBD

* SYN_MT_REPORT:

  - 用于同步和分离触摸事件。更多的信息请参考内核文档:multi-touch-protocol.txt。

* SYN_DROPPED:

  - 用来指出evdev客户的事件队列的的缓冲区溢出。客户端顶盖忽略所有的事件,包括下一个SYN_REPORT事件,并且要查询设备来获得它的状态(使用EVIOCG* ioctls)。

EV_KEY:

----------

EV_KEY事件采取KEY_<name> 或BTN_<name>的形式,比如,KEY_A代表键盘上的A键,当一个按键被按下时,一个带有按键编码和value为1的事件被发出。当一个按键被释放时,一个value为0的事件被发出。有些硬件当按键重复时会发出事件,这些事件的value值为2。通常,KEY_<name>用作键盘上的按键,而BTN_<name>则用于开关按钮事件。

几个 EV_KEY的 codes具有特别的意义:

* BTN_TOOL_<name>:

- 这些codes用于配合触控板,平板和触摸屏这些设备的输入,这些设备可以使用手指,笔或者其它工具。当一个事件发生并且检测到某种工具在使用时,相应的BTN_TOOL_<name> code事件应该把value设为1,当该工具不再和输入设备进行交互时,value应该复位为0。所有的触控板,当事件发生时,平板和触摸屏映泰至少使用一种BTN_TOOL_<name> code。

* BTN_TOUCH:

BTN_TOUCH用于触摸接触事件。当一个输入工具被判定为有意义的物理接触时,这一特性的value值应该设为1。所谓有意义的物理接触可以是任何的接触,又或者是满足某种定义条件的接触。例如,触摸板可以当触摸的压力达到某一个值以上时才把value设为1,一个用笔的平板当笔划过但没有接触到平板的表面时,把BTN_TOOL_PEN的value设为1,而把BTN_TOUCH的value设为0.

注意:为了配合一些老的传统mousedev模拟驱动程序可以工作,BTN_TOUCH必须作为一个同步帧的第一个evdevcode发出。

注意:出于历史的原因,用户空间会把带有BTN_TOOL_FINGER和 BTN_TOUCH的触摸设备解释为触摸板,而类似的不带BTN_TOOL_FINGER的触摸设备则被解释为触摸屏。为了与目前的用户空间应用向后兼容,建议遵循这一区分原则。以后,这一区分方法将会失效,而会使用设备属性ioctl EVIOCGPROP(定义在linux/input.h)来传送设备的类型。

* BTN_TOOL_FINGER, BTN_TOOL_DOUBLETAP,BTN_TOOL_TRIPLETAP, BTN_TOOL_QUADTAP:

- 这些codes表明一个,两个,三个和四个手指参与触摸板和触摸屏的操作。例如,如果用户使用两只手指在触摸板上试图滚动屏幕上的内容,在运动期间,应该发送value为1的BTN_TOOL_DOUBLETAP。注意的是所有的BTN_TOOL_<name>codes 和 BTN_TOUCH code是用于正交目的的,一个触摸板由手指碰触时,应该在这两组中各生成一个事件code,至少在一个同步帧中带有一个value为1的BTN_TOOL_<name>code。

注意:出于历史原因,一些驱动会在同一个同步帧内发送多个value为1的上报手指数的codes,但是这一方法现在已经过时了(不再使用)。

注意:在多手指触摸驱动中,应该使用input_mt_report_finger_count()函数来发出以上这些codes,详情请参看内核文档:multi-touch-protocol.txt。

EV_REL:

----------

EV_REL事件描述了某种特性的相对变化量。例如,鼠标向左方移动了几个单位距离,但是他的绝对位置是未知的。如果我们可以知道绝对位置,那我们应该使用EV_ABS而不是EV_REL。

下面这些属于EV_REL的codes有特别的意义:

* REL_WHEEL, REL_HWHEEL:

  - 这两个codes用于对应的垂直方向和水平方向的滚轮。

EV_ABS:

----------

EV_ABS事件描述了某一特性的绝对变化值,例如,触摸板会用它发出当前位置的绝对坐标值。

以下这些属于EV_ABS的 codes有特殊的意义:

* ABS_DISTANCE:

- 用来描述触摸工具离触摸表面的距离。这一事件应该只有当触摸工具在表面悬空滑过时发出,也就是说,在靠经触摸表面,但是BTN_TOUCH的value是0的时候。如果输入设备可以工作在3维坐标时,应该考虑使用ABS_Z会更好。

* ABS_MT_<name>:

- 用于描述多手指触摸输入设备。详情请参考内核文档:multi-touch-protocol.txt。

EV_SW:

----------

EV_SW事件用于描述一个两态开关的状态,比如,SW_LID code用来指出笔记本电脑的屏幕已经合上了。

当绑定一个设备或者从suspend状态中resuming回来,驱动程序必须上报开关的当前状态。从而保证设备,内核和用户空间的状态保持同步。

在resume时,如果开关的状态和suspend之前相同,input子系统会这一重复的状态上报消息。驱动程序任何时候都无需记住开关的状态。

EV_MSC:

----------

当事件不能用其它事件类型描述时,使用EV_MSC是将进行输入和输出事件的上报。

EV_LED:

----------

EV_LED事件用来设置或查询设备上LED的状态。

EV_REP:

----------

EV_REP 用来指出自动重复事件(autorepeating)。

EV_SND:

----------

EV_SND用于对那些简单的发声设备发出发音指令。

EV_FF:

----------

EV_FF事件用来初始化具有强制反馈能力的设备,并可以让这些设备发出反馈动作。

EV_PWR:

----------

EV_PWR事件是一个特殊的类型,它是电源管理的专用事件,目前没有对它做出良好的定义,将来会完善这一事件。

设备特性(Device properties):

=================

正常情况下,用户空间基于设备发出的数据(比如事件的types)来建立一个输入设备,当两个设备都发出相同的事件types时,这时设备特性就可以提供额外的识别信息。

INPUT_PROP_DIRECT + INPUT_PROP_POINTER:

--------------------------------------

INPUT_PROP_DIRECT特性表明设备的坐标直接和屏幕坐标向对应(无需琐碎的转换操作,像缩放,反转,旋转等)。非直接输入设备则需要一些必要的变换,比如触摸板上绝对到相对的变换。典型的直接输入设备有:触摸屏,手写板;非直接输入设备有:触摸板,鼠标。

INPUT_PROP_POINTER特性表明设备不是利用屏幕来获取输入信息,从而需要一个屏幕上的指针来跟踪用户的移动。典型的指针设备有:触控板,鼠标;非指针设备:触摸屏。

如果INPUT_PROP_DIRECT或者 INPUT_PROP_POINTER都没有设置,设备将会被认为是未定义,它的类型需要按传统的方式利用事件的types推导出来。

INPUT_PROP_BUTTONPAD:

--------------------

有些触摸板,它的按键位于触摸板的底部,这样按下触摸板会产生一次按键消息,对于这种设备,应该设置该特性。自2009年以来,配置这种触控板的notebooks和macbooks变多越来越普遍。

最初,这种按键特性是在bcm5974的驱动中通过名字的版本字段来进行编码,为了向后兼容性,用户空间有必要按这两种方法都进行检查。

INPUT_PROP_SEMI_MT:

------------------

在2008年至2011年之间,很多触摸板只能检测到多个接触点,但是不知道它们的独立位置,只是知道触点的数量和包围它们的一个矩形。对于这样的设备,应该设置这个半多点触摸特性。

不同的设备,这个矩形可能包围所有的触控点,就像边界框一样,也可能只是包围了一部分触控点,比如最后的两个触控点。这种不确定性限制了这个矩形的用处,只是有些手势识别会对它进行分析。

如果没有设置INPUT_PROP_SEMI_MT特性,该设备被假设为全多点触控设备。

使用指引:

==========

以下的使用指引确保了单点触摸和多点触摸可以正常地工作,更详尽的信息请参考文档:multi-touch-protocol.txt。

鼠标:

----------

当鼠标移动时,REL_{X,Y}必须被上报。主键被按下时,BTN_LEFT必须被上报。 其它按键按下时,BTN_{MIDDLE,RIGHT,4,5,etc.}应该被上报。鼠标上的滚轮滚动时,REL_WHEEL and REL_HWHEEL事件应该被上报。

触摸屏:

----------

触摸发生时,必须要用ABS_{X,Y}上报触摸的位置。触摸有效时,BTN_TOUCH必须被上报,而不必用BTN_{MOUSE,LEFT,MIDDLE,RIGHT}来表明一次触摸事件。有可能的话,BTN_TOOL_<name>事件也可以应该上报。

对于新的硬件,应该设置INPUT_PROP_DIRECT特性。

触控板:

----------

传统的触控板只是想上面鼠标所说那样上报相对位置信息即可。

具备绝对位置信息的触控板需要通过ABS_{X,Y}上报触控点的位置信息。同样,触摸有效时应该上报BTN_TOUCH事件。如果支持多点触摸,应该通过BTN_TOOL_<name>上报有效触摸的数量。

对于新的硬件,应该设置INPUT_PROP_POINTER特性。

Tablets:

----------

当笔或其它工具被有效检测后,必须上报BTN_TOOL_<name>事件,必须用ABS_{X,Y}上报触控的位置信息,同时应该上报BTN_TOUCH事件。当触控工具上的按钮有效时,应该上报BTN_{STYLUS,STYLUS2}消息。除了BTN_{MOUSE,LEFT}以外,其它任意的按键消息都可以用于上报平板上的按键,对于没有标记的按键,BTN_{0,1,2,etc}是个不错的选择,避免使用有特别意义的按键:像BTN_FORWARD之类,除非设备上特别标明了就是这一按键。

对于新的硬件,INPUT_PROP_DIRECT和 INPUT_PROP_POINTER都应该被设置。

时间: 2024-11-05 23:36:05

linux 输入子系统(1) -Event types的相关文章

Linux输入子系统框架分析(1)

在Linux下的输入设备键盘.触摸屏.鼠标等都可以用输入子系统来实现驱动.输入子系统分为三层,核心层和设备驱动层,事件层.核心层和事件层由Linux输入子系统本身实现,设备驱动层由我们实现.我们在设备驱动层将输入事件上报给核心层input.c,核心层找到匹配的事件层,将事件交给事件层处理,事件层处理完后传递到用户空间. 我们最终要搞清楚的是在用户空间调用open和read最终在内核中是怎样处理的,向内核上报的事件又是谁处理的,处理完后是怎样传递到用户空间的? 上面两个图是输入子系统的框架. 下面

Android底层开发之Linux输入子系统要不要推断系统休眠状态上报键值

Android底层开发之Linux输入子系统要不要推断系统休眠状态上报键值 题外话:一个问题研究到最后,那边记录文档的前半部分基本上都是没用的,甚至是错误的. 重点在最后,前边不过一些假想猜測. http://blog.csdn.net/kangear/article/details/40072707 在调试一下红外遥控器input驱动时,直接採用的是一个半成品的驱动在上边实现的自己的设备的匹配,但同一时候遇到了一些关于input输入子系统的疑惑. 按键一般有「按下和抬起」两个状态一般使用0和1

Linux输入子系统(转)

Linux输入子系统(Input Subsystem) 1.1.input子系统概述 输入设备(如按键,键盘,触摸屏,鼠标等)是典型的字符设备,其一般的工作机制是低层在按键,触摸等动作发生时产生一个中断(或驱动通过timer定时查询),然后cpu通过SPI,I2C或者外部存储器总线读取键值,坐标等数据,放一个缓冲区,字符设备驱动管理该缓冲区,而驱动的read()接口让用户可以读取键值,坐标等数据. 在Linux中,输入子系统是由输入子系统设备驱动层.输入子系统核心层(Input Core)和输入

Android底层开发之Linux输入子系统要不要判断系统休眠状态上报键值

Android底层开发之Linux输入子系统要不要判断系统休眠状态上报键值 题外话:一个问题研究到最后,那边记录文档的前半部分基本上都是无用的,甚至是错误的.重点在最后,前边仅仅是一些假想推测. http://blog.csdn.net/kangear/article/details/40072707 在调试一下红外遥控器input驱动时,直接采用的是一个半成品的驱动在上边实现的自己的设备的匹配,但同时遇到了一些关于input输入子系统的疑惑. 按键一般有「按下和抬起」两个状态一般使用0和1来分

linux输入子系统(input subsystem)之evdev.c事件处理过程

1.代码 input_subsys.drv.c 在linux输入子系统(input subsystem)之按键输入和LED控制的基础上有小改动,input_subsys_test.c不变. input_subsys.drv.c 1 #include <linux/module.h> 2 #include <linux/version.h> 3 4 #include <linux/init.h> 5 #include <linux/fs.h> 6 #inclu

Linux 输入子系统原理理解(原创)

linux    输入子系统原理理解(原创) 以前学了单独的按键设备驱动以及鼠标驱动,实际上,在linux中实现这些设备驱动,有一种更为推荐的方法,就是input输入子系统.平常我们的按键,触摸屏,鼠标等输入型设备都可以利用input接口来简化驱动程序并实现设备驱动. 输入子系统原理 linux输入子系统的体系结构可以分为三个层面,分别为:驱动层.输入核心层.事件处理层,三个有点类似PHP的MVC模式,意思就是每个层次只是负责单独的一个功能,无需参与其他的功能,有点类似函数的封装,好了,废话不多

Linux输入子系统(Input Subsystem)

Linux输入子系统(Input Subsystem) http://blog.csdn.net/lbmygf/article/details/7360084 input子系统分析  http://blog.chinaunix.net/uid-27717694-id-3758334.html

Linux 输入子系统

Technorati 标签: Kernel 输入子系统 Input      在Linux中,输入设备(如按键.键盘.触摸屏.鼠标等)是典型的字符设备,其一般的工作机理,是底层在按键.触摸时,触发一个中断,或者驱动通过定时器定时查询,通过这两种方式通知CPU,CPU然后通过SPI.I2C或I/O接口读取键值.坐标等数据,放入缓冲区,字符设备驱动管理该缓冲区,向上提供read接口供应用程序使用.      在上述的工作流程中,只有终端.读取数值是根具体硬件设备相关,而输入事件的缓冲区管理以及字符设

linux输入子系统(6)-input子系统介绍及结构图

注:本系列转自: http://www.ourunix.org/post/290.html input子系统介绍         输入设备(如按键,键盘,触摸屏,鼠标,蜂鸣器等)是典型的字符设备,其一般的工作机制是底层在按键,触摸等动作发生时产生一个中断(或驱动通过timer定时查询),然后cpu通过SPI,I2C或者外部存储器总线读取键值,坐标等数据,放一个缓冲区,字符设备驱动管理该缓冲区,而驱动的read()接口让用户可以读取键值,坐标等数据.         在Linux中,输入子系统是由