Android 多點觸摸介面

簡介

為了使用功能強大的多點觸控裝置，就需要一種方案去上報使用者層所需的詳細的手指觸摸資料。這個文檔所描述的多點觸控協議可以讓核心驅動程式向使用者層上報任意多指的資料資訊。

使用說明

單點觸摸資訊是以ABS承載並按一定順序發送，如BTN_TOUCH、ABS_X、ABS_Y、SYNC。而多點觸摸資訊則是以ABS_MT承載並按一 定順序發送，如ABS_MT_POSITION_X、ABS_MT_POSITION_Y，然後通過調用input_mt_sync()產生一個 SYN_MT_REPORT event來標記一個點的結束，告訴接收方接收當前手指的資訊並準備接收其它手指的觸控資訊。最後調用 input_sync()函數上報觸摸資訊開始動作並告訴接收方開始接收下一系列多點觸摸資訊。

協議定義了一系列ABS_MT事件，這些事件被分為幾大類，允許只應用其中的一部份，多點觸摸最小的事件集裡應包括 ABS_MT_TOUCH_MAJOR、ABS_MT_POSITION_X和ABS_MT_POSITION_Y，以此來實現多點觸摸。如果裝置支援ABS_MT_WIDTH_MAJOR這個事件，那麼此事件可以提供手指觸摸接觸面積大小。觸摸方向等資訊可以由ABS_MT_TOUCH_MINOR, ABS_MT_WIDTH_MINOR and ABS_MT_ORIENTATION提供。ABS_MT_TOOL_TYPE提供觸摸裝置的類別，如手或是筆或是其它。最後有些裝置可能會支援
ABS_MT_TRACKING_ID，用來支援硬體跟蹤多點資訊，即該點屬於哪一條線等。

下面是兩點觸摸支援的最小事件集序列：

ABS_MT_TOUCH_MAJOR
ABS_MT_POSITION_X
ABS_MT_POSITION_Y
SYN_MT_REPORT      //上報第一個點
ABS_MT_TOUCH_MAJOR
ABS_MT_POSITION_X
ABS_MT_POSITION_Y
SYN_MT_REPORT      //上報第二個點
SYN_REPORT         //開始動作

Event 原語

“接觸”一詞用來描述一個物體直接碰到另一個物體的表面。

ABS_MT_TOUCH_MAJOR描述了主接觸面的長軸，它和X，Y同一個單位，如果一個面的解析度為X*Y，則ABS_MT_TOUCH_MAJOR的最大值為sqrt(X^2+Y^2)

ABS_MT_TOUCH_MINOR描述了接觸面的短軸，如果接觸面是圓形，它可以不用。

ABS_MT_WIDTH_MAJOR描述了接觸工具的長軸

ABS_MT_WIDTH_MINOR描述了接觸工具的短軸

ABS_MT_TOUCH_MAJOR:= max(X, Y)
ABS_MT_TOUCH_MINOR := min(X, Y)
ABS_MT_ORIENTATION := bool(X > Y)

以上四個參數可以用來產生額外的觸摸資訊，如ABS_MT_TOUCH_MAJOR/ABS_MT_WIDTH_MAJOR的比率可以用來描述壓力。

ABS_MT_ORIENTATION

ABS_MT_POSITION_X接觸面的中心點X座標

ABS_MT_POSITION_Y接觸面的中心點Y座標

ABS_MT_TOOL_TYPE描述接觸工具類型，很多核心驅動無法區分此參數如手指及筆，如果是這樣，該參數可以不用，協議目前支援MT_TOOL_FINGER和MT_TOOL_PEN兩種類型。

ABS_MT_BLOB_ID形狀集ID，集合幾個點以描述一個形狀，很多驅動沒有形狀屬性，此參數可以不用。

ABS_MT_TRACKING_ID描述了從接觸開始到釋放的整個過程的集合，如果裝置不支援，此參數可是不用。

觸摸軌跡

　　僅有少數裝置可以明確的標識真實的 trackingID，多數情況下 trackingID只能來標識一次觸摸動作的過程。

手勢

　　多點觸摸指定的應用是建立手勢動作， TOUCH和 WIDTH參數經常用來區別手指的壓力和手指間的距離，另外 MINOR類的參數可以用來區別裝置的接觸面的大小（點接觸還是面接觸),ORIENTATION可以產生旋轉事件。

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

在Linux核心支援的基礎上，Android在其2.0源碼中加入多點觸摸功能。由此觸控螢幕在Android的frameworks被完全分為2種實現途徑：單點觸控螢幕的單點方式，多點觸控螢幕的單點和多點方式。

在Linux的input.h中，多點觸摸功能依賴於以下幾個主要的軟體位：

………………………..

#define SYN_REPORT         0

#define SYN_CONFIG         1

#define SYN_MT_REPORT  2

………………………...

#define ABS_MT_TOUCH_MAJOR    0x30/* Major axis of touching ellipse */

#define ABS_MT_TOUCH_MINOR    0x31/* Minor axis (omit if circular) */

#define ABS_MT_WIDTH_MAJOR    0x32/* Major axis of approaching ellipse */

#define ABS_MT_WIDTH_MINOR     0x33/* Minor axis (omit if circular) */

#define ABS_MT_ORIENTATION      0x34/* Ellipse orientation */

#define ABS_MT_POSITION_X         0x35/* Center X ellipse position */

#define ABS_MT_POSITION_Y         0x36/* Center Y ellipse position */

#define ABS_MT_TOOL_TYPE          0x37/* Type of touching device */

#define ABS_MT_BLOB_ID               0x38/* Group a set of packets as a blob */

…………………………

在Android中對應的軟體位定義在RawInputEvent.java中:

…………………..

public class RawInputEvent {

……………….

  public static final int CLASS_TOUCHSCREEN_MT = 0x00000010;

………………..

  public static final int ABS_MT_TOUCH_MAJOR = 0x30;

  public static final int ABS_MT_TOUCH_MINOR = 0x31;

  public static final int ABS_MT_WIDTH_MAJOR = 0x32;

  public static final int ABS_MT_WIDTH_MINOR = 0x33;

  public static final int ABS_MT_ORIENTATION = 0x34;

  public static final int ABS_MT_POSITION_X = 0x35;

  public static final int ABS_MT_POSITION_Y = 0x36;

  public static final int ABS_MT_TOOL_TYPE = 0x37;

  public static final int ABS_MT_BLOB_ID = 0x38;

………………….

public static final int SYN_REPORT = 0;

  public static final int SYN_CONFIG = 1;

public static final int SYN_MT_REPORT = 2;

………………..

在Android中，多點觸摸的實現方法在具體的代碼實現中和單點是完全區分開的。在Android代碼的EventHub.cpp中，單點屏和多點屏由如下程式碼片段來判定：

int EventHub::open_device(const char *deviceName)

{

………………………

if (test_bit(ABS_MT_TOUCH_MAJOR, abs_bitmask)

&& test_bit(ABS_MT_POSITION_X, abs_bitmask)

&& test_bit(ABS_MT_POSITION_Y, abs_bitmask)) {

device->classes |= CLASS_TOUCHSCREEN | CLASS_TOUCHSCREEN_MT;

//LOGI("It is a multi-touch screen!");

} 

//single-touch?

else if (test_bit(BTN_TOUCH, key_bitmask)

&& test_bit(ABS_X, abs_bitmask) 

&& test_bit(ABS_Y, abs_bitmask)) {

device->classes |= CLASS_TOUCHSCREEN;

//LOGI("It is a single-touch screen!");

}

………………..

}

我們知道，在觸控螢幕驅動中，通常在probe函數中會調用input_set_abs_params給裝置的input_dev結構體初始化，這些 input_dev的參數會在Android的EventHub.cpp中被讀取。如上可知，如果我們的觸控螢幕想被當成多點屏被處理，只需要在驅動中給 input_dev額外增加以下幾個參數即可：

input_set_abs_params(mcs_data.input, ABS_MT_POSITION_X, pdata->abs_x_min,  pdata->abs_x_max, 0, 0);

input_set_abs_params(mcs_data.input, ABS_MT_POSITION_Y, pdata->abs_y_min,  pdata->abs_y_max, 0, 0);

input_set_abs_params(mcs_data.input, ABS_MT_TOUCH_MAJOR, 0, 15, 0, 0);

                //相當於單點屏的ABX_PRESSURE

input_set_abs_params(mcs_data.input, ABS_MT_WIDTH_MAJOR, 0, 15, 0, 0); 

//相當於單點屏的ABS_TOOL_WIDTH

由 於多點觸摸技術需要採集到多個點，然後再一起處理這些點，所以在軟體實現中需要保證每一波點的準確性和完整性。因此，Linux核心提供了 input_mt_sync(struct input_dev * input)函數。在每波的每個點上報後需要緊跟一句 input_mt_sync(), 當這波所有點上報後再使用input_sync()進行同步。例如一波要上報3個點：

/* 上報點1*/

……………..

input_mt_sync(input);

/* 上報點2*/

……………..

input_mt_sync(input);

/* 上報點3*/

……………..

input_mt_sync(input);

input_sync(input);

註：即使是僅上報一個點的單時間點事件，也需要一次input_my_sync。