Linux MT 协议

本文内提到的内容来至于 Kernel Documentation。

协议被分为了两种类型的设备：

• 所有设备都处理匿名接触点(A类), 协议描述如何发送 raw 数据来自所有接触点给接收者
• 处理带Tracking ID 的接触点(B类)，协议描述如何通过事件slot发送更新每个独立接触点

协议使用

接触点描述的每个包都通过 ABS_MT_* 事件来进行发送单条信息。

在Type A 设备驱动中每个独立接触点之后都会使用 input_mt_sync() 来发送 SYN_MT_REPORT 事件。

而在Type B 设备驱动中每个独立接触点之前都会使用 input_mt_slot() 函数来发送 ABS_MT_SLOT 事件，用来表示准备开始更新某给定的slot 事件。同时要求使用 ABS_MT_TRACKING_ID 来描述slot协议。

所有类型的驱动都会通过 input_sync() 函数来结束单次操作的 EV_SYN/SYN_REPORT事件来进行同步。表示当前事件已经结束，可以使用之前更新的数据。

无状态的Type A 协议与含状态的Type B slot协议主要区别在于使用接触点Id 来减少大量数据发送给到用户空间中。

对于A类设备来说，内核驱动随意迭代所有接触点，数据包在事件流中的位置并不重要。事件过滤及事件tracking都被遗留给了用户空间来处理。而 B 类设备，内核用 slot 来关联每个接触点，通过 slot 来传递接触点的变化。接触点的创建，更新及销毁都通过修改关联的slot的 ABS_MT_TRACKING_ID 来完成(非负数表示诠释一个接触点，-1 表示为一个无用的接触点)。当出现一个之前没有出现过tracking id 时，表示为一个新的点。某个tracking id 不再次出现时，表示已经移除。

如果tracking的接触点多余当前上报的硬件信号时，驱动应该使用 BTN_TOOL_TAP 事件来告知用户空间当前tracking的接触点总数量。驱动应该通过发送相应的 BTN_TOOL_TAP 事件以及在调用 input_mt_report_pointer_emulation() 函数时设置 use_count 为 false 。

ABS_MT_SLOT 最小值为 0。

协议样例

A 类协议

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

当其中某点发送移动，进行更新时，这时所有呈现的接触点的 raw 数据通过发送 SYN_REPORT 来同步数据。
比如：

   ABS_MT_POSITION_X x[1]
   ABS_MT_POSITION_Y y[1]
   SYN_MT_REPORT
   SYN_REPORT

接下来通过如下方式来将更新及同步数据

   SYN_MT_REPORT
   SYN_REPORT

如果驱动除 ABS_MT 事件外额外上报一个 BTN_TOUCH 或 ABS_PRESSURE 事件。最后一个 SYN_MT_REPORT 事件可能会省略。

B 类协议

如下是两个接触点的 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

如下是在当第一个 slot 在 x 轴上移动之后，上报的日志：

   ABS_MT_SLOT 0
   ABS_MT_POSITION_X x[0]
   SYN_REPORT

如下是当slot 关联的 slot 抬起(release)之后，上报如下事件：

   ABS_MT_TRACKING_ID -1
   SYN_REPORT

如果第二点抬起之后，则上报如下事件：

   ABS_MT_SLOT 1
   ABS_MT_TRACKING_ID -1
   SYN_REPORT

即当变化的接触点所关联的 slot 与上次同步数据的 slot 不一致时，必须先发送 ABS_MT_SLOT 来标记当前要修改的 slot 数据。(类似于 patch 将单个 slot 数据进行缓存，然后通过修改变更的数据来同步当前接触点的数据)。