Linux/Android多点触摸协议【转】
本文转载自:
链接点击打开链接
关于Linux多点触摸协议大家可以参考kernel中的文档:https://www.kernel.org/doc/Documentation/input/multi-touch-protocol.txt,而这里根据实际的例子来理解多点触摸协议。
多点触摸协议有两种,A协议和B协议。
首先来看A协议,协议上说了报点格式是这样的,以两点为例:
ABS_MT_POSITION_X x[0] ABS_MT_POSITION_Y y[0] SYN_MT_REPORT ABS_MT_POSITION_X x[1] ABS_MT_POSITION_Y y[1] SYN_MT_REPORT SYN_REPORT
如果第一个触点离开(抬起),这里的意思是说还有一个触点,需要继续上报这个触点。
ABS_MT_POSITION_X x[1] ABS_MT_POSITION_Y y[1] SYN_MT_REPORT SYN_REPORT
如果两个触点都离开了,那么只需要报告一个同步事件就可以了。
SYN_MT_REPORT SYN_REPORT
而代码示例如下:
- for (i = 0; i < count; i++) {
- input_report_abs(input_dev, ABS_MT_POSITION_X, finger[i].x);
- input_report_abs(input_dev, ABS_MT_POSITION_Y, finger[i].x);
- input_mt_sync(input_dev);
- }
- if (!count)
- input_mt_sync(input_dev);
- input_sync(input_dev);
其中count值表示触点个数,如果是2个,那么这里值就为2,如果所有触点都离开了,那么count值就为0。
上面可以说是最简单,也是最基本的A协议报点了。除了报点以外,我们也来关注一下input device注册时需要setting的一些东西。
- input_set_abs_params(input_dev, ABS_MT_POSITION_X, 0, MAX_X, 0, 0);
- input_set_abs_params(input_dev, ABS_MT_POSITION_Y, 0, MAX_Y, 0, 0);
- __set_bit(EV_SYN, input_dev->evbit);
- __set_bit(EV_ABS, input_dev->evbit);
- __set_bit(INPUT_PROP_DIRECT, input_dev->propbit);
可能你会看到有的代码会多下面这两句:
- __set_bit(ABS_MT_POSITION_X, input_dev->absbit);
- __set_bit(ABS_MT_POSITION_X, input_dev->absbit);
其实这两句(包括上面的__set_bit(EV_ABS, input_dev->evbit);)是可有可无的,因为在input_set_abs_params函数中会做相应的设置。
而这句__set_bit(INPUT_PROP_DIRECT, input_dev->propbit);也是必须要有的,否则在Android中会出现一个白色小圆环,感觉像是缺少idc文件一样。最后通过getevent -p命令看一下触摸屏的setting。
add device 1: /dev/input/event1 name: "ft6x36" events: ABS (0003): 0035 : value 0, min 0, max 540, fuzz 0, flat 0, resolution 0 0036 : value 0, min 0, max 960, fuzz 0, flat 0, resolution 0 input props: INPUT_PROP_DIRECT
对于B协议就稍微显得有点复杂。B协议需要硬件支持,和A协议主要区别在哪里呢?B协议可以使用一个ID来标识触点,可以减少上报到用户空间的数据量,这个ID(ABS_MT_TRACKING_ID)可以有硬件提供或者从原始数据计算而得。那>么下面我们就来看B协议怎么上报数据的。
ABS_MT_SLOT 0 ABS_MT_TRACKING_ID 45 ABS_MT_POSITION_X x[0] ABS_MT_POSITION_Y y[0] ABS_MT_SLOT 1 ABS_MT_TRACKING_ID 46 ABS_MT_POSITION_X x[1] ABS_MT_POSITION_Y y[1] SYN_REPORT
如果触点45只是在x方向做了移动,那么应该怎么报告这个事件呢?
ABS_MT_SLOT 0 ABS_MT_POSITION_X x[0] SYN_REPORT
可以看到减少了很多数据的上报,这就是同A协议最大的区别。
如果同slot 0相关的触点离开(抬起),只需要做下面的操作。 ABS_MT_TRACKING_ID -1 SYN_REPORT
这里为什么没有发送ABS_MT_SLOT 0事件呢,因为之前slot已经被置成了0,再次发送ABS_MT_SLOT 0是会被忽略掉的。
如果第二个触点被抬起,发送下面的事件序列。
ABS_MT_SLOT 1 ABS_MT_TRACKING_ID -1 SYN_REPORT
其他event
ABS_MT_POSITION_X和ABS_MT_POSITION_Y是多点触摸协议的最小事件集,是最基本的事件,也是必须的事件。除此之外呢,还包括下面的一些时间集(需要设置支持):
ABS_MT_TOUCH_MAJOR
ABS_MT_TOUCH_MINOR
ABS_MT_TOUCH*用来表示接触点区域大小(即手指与玻璃接触区域大小),通常接触区域是一个椭圆形状,那么MAJOR就表示椭圆的长轴,而MINOR就表示椭圆的短轴。如果接触区域是圆形的话,那么可以忽略MINOR,而MAJOR就表示圆形的直径大小。
ABS_MT_WIDTH_MAJOR
ABS_MT_WIDTH_MINOR
上面的TOUCH表示接触区域的大小,而WIDTH则表示为接触工具的大小(例如手指,触控笔等)。
ABS_MT_PRESSURE
而PRESSURE表示压力值,这个压力值可以通过上面的4个参数计算而得,例如:ABS_MT_TOUCH_MAJOR/ABS_MT_WIDTH_MAJOR,可以看到接触面积越大,压力值也就越大。当然这个压力值也可以直接由设备提供。
ABS_MT_DISTANCE
触点与接触面的距离,0表示触点在接触面的表面(已经实实在在的接触到了),而正数表示在接触面的上方。
ABS_MT_ORIENTATION
触点的方向。
ABS_MT_TOOL_X
ABS_MT_TOOL_Y
ABS_MT_TOOL_TYPE
关于上报虚拟按键值
通常触摸屏下方都有3个虚拟按键,而这3个按键同其它实体按键(例如:power按键、音量按键)又有所不同,它是触摸屏提供的一组虚拟按键,我们通过触摸屏会得到这一组按键的坐标值,可以通过这个坐标值上报相应的按键值来实
现按键功能,那么怎么来上报这个按键值呢。首先需要对input设备做一些setting:
- __set_bit(KEY_MENU, input_dev->keybit);
- __set_bit(KEY_HOMEPAGE, input_dev->keybit);
- __set_bit(KEY_BACK, input_dev->keybit);
- __set_bit(EV_KEY, input_dev->evbit);
- __set_bit(EV_SYN, input_dev->evbit);
OK,这些键值呢在kernel中是定义在uapi/linux/input.h中的,而通常我们的driver只需要包含linux/input.h就可以了,这个文件中include了的uapi/linux/input.h。
好的,再来看怎么上报键值。
按键按下:
- input_report_key(input_dev, key_value, 1);
- input_sync(input_dev);
按键抬起:
- input_report_key(input_dev, key_value, 0);
- input_sync(input_dev);
如果是按键一直被按下,重复上报按键被按下那部分就可以了。
有的地方可能会看到直接使用input_event函数,例如:
- input_event(input_dev, EV_KEY, key_value, 1);
大家也可以去看看input_report_key函数,它其实是对input_event函数做了封装,不管是input_report_abs也好,还是input_sync,最终都是调用的input_event函数,所以真正上报event的函数其实是input_event函数。
最后一点在setting时除了__set_bit之外,可能还会看到另外一个函数input_set_capability,这个函数实现在drivers/input/input.c中,而它最终还是调用了__set_bit函数,所以最后效果都是一样的。