Input: clarify the no-finger event in multitouch protocol

Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
From: Linux Kernel Mailing List
Date: Thursday, April 15, 2010 - 1:59 pm

Gitweb:     http://git.kernel.org/linus/97065e033ec5fd824d0133ecd0c614fe1e5c20bd
Commit:     97065e033ec5fd824d0133ecd0c614fe1e5c20bd
Parent:     d90e6f6aad0ffdc674bc3a05c85c40dcc18e604c
Author:     Henrik Rydberg <rydberg@euromail.se>
AuthorDate: Sun Mar 21 22:31:26 2010 -0700
Committer:  Dmitry Torokhov <dmitry.torokhov@gmail.com>
CommitDate: Sun Mar 21 22:38:56 2010 -0700

    Input: clarify the no-finger event in multitouch protocol
    
    The current documentation does not explicitly specify how to report
    zero fingers, leaving a potential problem in the driver implementations
    and giving no parsing directive to userland. This patch defines two
    equally valid ways.
    
    Signed-off-by: Henrik Rydberg <rydberg@euromail.se>
    Signed-off-by: Dmitry Torokhov <dtor@mail.ru>
---
 Documentation/input/multi-touch-protocol.txt |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)

diff --git a/Documentation/input/multi-touch-protocol.txt b/Documentation/input/multi-touch-protocol.txt
index 8490480..eacb226 100644
--- a/Documentation/input/multi-touch-protocol.txt
+++ b/Documentation/input/multi-touch-protocol.txt
@@ -68,6 +68,22 @@ like:
    SYN_MT_REPORT
    SYN_REPORT
 
+Here is the sequence after lifting one of the fingers:
+
+   ABS_MT_POSITION_X
+   ABS_MT_POSITION_Y
+   SYN_MT_REPORT
+   SYN_REPORT
+
+And here is the sequence after lifting the remaining finger:
+
+   SYN_MT_REPORT
+   SYN_REPORT
+
+If the driver reports one of BTN_TOUCH or ABS_PRESSURE in addition to the
+ABS_MT events, the last SYN_MT_REPORT event may be omitted. Otherwise, the
+last SYN_REPORT will be dropped by the input core, resulting in no
+zero-finger event reaching userland.
 
 Event Semantics
 ---------------
--
To unsubscribe from this list: send the line "unsubscribe git-commits-head" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]

Messages in current thread:
Input: clarify the no-finger event in multitouch protocol, Linux Kernel Mailing ..., (Thu Apr 15, 1:59 pm)