多点触摸协议
-------------------------
Copyright (C) 2009 Henrik Rydberg <[email protected] >
简介
为了使用功能强大的多点触控设备,一种方案是上报用户层所需的详细的手指触摸数据。这个文档所描述的多点触控协议可以让内核驱动程序向用户层上报任意多指的数据信息。
使用说明
任何一个手指的触控数据都是打包成 ABS event 包按顺序发送,只有 ABS_MT event包能作为多点触控数据被识别,调用 input_mt_sync()函数可以产生一个 SYN_MT_REPORT event ,这个函数接收并处理当前手指的信息并准备接收其它手指的触控信息。最后调用 input_sync()函数上报 EV_SYN/SYN_REPORT
event 完成一个包的开始处理并准备处理下一个包。
协议定义了 ABS_MT事件的属性,这些事件被分为几大类,充许只应用其中的一部份,多点触摸最小的事件集中应包括 ABS_MT_POSITION_X和 ABS_MT_POSITION_X,这两个事件用来描述多点触摸中手指的触摸轨迹。如果设备支持这两个事件,那么 ABS_MT_TOUCH_MAJOR和 ABS_MT_WIDTH_MAJOR 分别被用来提供手指的大小和触摸面积大小。
TOUCH 和 WIDTH参数给出了个,想想如果一个手指按在玻璃上,透过玻璃你将看到两个区域,一个是手指与玻璃接触的区域,用 ABS_MT_TOUCH_MAJOR描述,一个是手指本身大小的区域, ABS_MT_WIDTH_MAJOR描述, 手指与玻璃接触的面积要小于手指本身的大小,通过这两个参数,可以换算出手指的压力。也可通过 ABS_MT_PRESSURE参数直接提供手指的压力。
除了 MAJOR这个参数,还可以提供一个 MINOR参数,手指可以被认为是一个椭圆, MAJOR和 MINOR可以认为是这个椭圆的长轴和短轴,椭圆的中心可以被 ORIENTATION这个参数描述。
ABS_MT_TOOL_TYPE参数用来描述触摸工具的类型(手指,触控笔等)。不同的设备可能有一些其它的信息需要传递到用户层。比如 ABS_MT_BLOB_ID用来描述长方形的边的集合,目前仅有少数设备可以被支持, ABS_MT_TRACKING_ID事件用来向上层报告硬件所采集的手指的触摸轨迹。
下面是两指触摸的最小事件集 :
ABS_MT_POSITION_X
ABS_MT_POSITION_Y
SYN_MT_REPORT //上报第一指坐标数据
ABS_MT_POSITION_X
ABS_MT_POSITION_Y
SYN_MT_REPORT//上报第二指坐标数据
SYN_REPORT
完成一次上报
协议解析
“触摸”这个词用来描述工具(手指,笔,等)直接接触触摸屏表面。
ABS_MT_TOUCH_MAJOR 接触面的长轴。
ABS_MT_TOUCH_MINOR 接触面的短轴,如果是圆形接触面,这个参数可以省略。
ABS_MT_WIDTH_MAJOR 接触工具的长轴。
ABS_MT_WIDTH_MINOR 接触工具的切面的短轴,如果是圆形,此参数可以省略。
上面的四个参数用来描术接触面的一些附加信息, ABS_MT_TOUCH_MAJOR / ABS_MT_WIDTH_MAJOR的比值可以用来反应接触时的压力值。
ABS_MT_PRESSURE 接触工具对接触面的压力大小,可以用来代替上面的四个参数。
ABS_MT_ORIENTATION
描述随圆的转动趋势,这是一个抽相值,O值表示接触面在平行与触摸屏的Y轴,向左是负值,向右是正值,如果完全平行于X轴,则上向返回最大值。如果接触面是圆形,则可以忽略这个参数。如果内核不能获得这个参数有有效值,但可以区分接触面的长短轴,这个功能还是可以被部份支持,在一些设备中, ABS_MT_ORIENTATION 的值只能是 0和1。
ABS_MT_POSITION_X 接触面的形心的X坐标值。
ABS_MT_POSITION_Y 接触面的形心的Y坐标值。
ABS_MT_TOOL_TYPE 触摸工具的类型
ABS_MT_BLOB_ID 用来标识多边形的边的集合,大多数内核不支持这个参数。
ABS_MT_TRACKING_ID 仅有少数设备支持,用来区别一个触摸动作的周期。
计算方法
一些设备将触摸面作为一个矩形上报,可以通过下面这些公式来计算出协议中所需要的信息。
ABS_MT_TOUCH_MAJOR := max(X, Y)
ABS_MT_TOUCH_MINOR := min(X, Y)
ABS_MT_ORIENTATION := bool(X > Y)
ABS_MT_ORIENTATION的取值范围为0至1,用来标识矩形接触面偏向X轴或Y轴的程度。
触摸轨迹
仅有少数设备可以明触的标识真实的 trackingID,多数情况下 trackingID只能来标识一次触摸动作的过程。
手势
多点触摸指定的应用是创建手势动作, TOUCH和 WIDTH参数经常用来区别手指的压力和手指间的距离,另外 MINOR类的参数可以用来区别设备的接触面的大小(点接触还是面接触) ,ORIENTATION可以产生旋转事件。
说明:
为了完作支持己有的应用,多点触控驱动应上报单点触控相应的 event,另外,所有的触控事件需要通过 input子系统向上传递。
目前内核只有 bcm5974这么一个驱动支持多点触控,可以以此为例设计你的驱动。
1) ABS_MT_APPROACH_X和 ABS_MT_APPROACH_Y在不同的触摸设备中可以有不同的意义。
2)这个协议需要补充。
3)多点触控的驱动尚没不成熟,到目前为此( 2009年4月) ,多点触控协议还没有 merged到内核主开发分支。
4)水平有限,敬请指正。