Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 574a62c9 authored by Ben Gamari's avatar Ben Gamari Committed by Dmitry Torokhov
Browse files

Input: ALPS - add V8 protocol documentation 



Tested-by: default avatarMichal Hocko <mhocko@suse.com>
Signed-off-by: default avatarBen Gamari <ben@smart-cactus.org>
Signed-off-by: default avatarDmitry Torokhov <dmitry.torokhov@gmail.com>
parent aeaa881f

Documentation/input/alps.txt

+57 −0
Original line number Diff line number Diff line
@@ -319,3 +319,60 @@ For touchpad packet, the format is: 
               otherwise byte 0 bit 4 must be set and byte 0/4/5 are

               in NEW fmt

 F:         Number of fingers - 3, 0 means 3 fingers, 1 means 4 ...





ALPS Absolute Mode - Protocol Version 8

---------------------------------------



Spoken by SS4 (73 03 14) and SS5 (73 03 28) hardware.



The packet type is given by the APD field, bits 4-5 of byte 3.



Touchpad packet (APD = 0x2):



           b7   b6   b5   b4   b3   b2   b1   b0

 byte 0:  SWM  SWR  SWL    1    1    0    0   X7

 byte 1:    0   X6   X5   X4   X3   X2   X1   X0

 byte 2:    0   Y6   Y5   Y4   Y3   Y2   Y1   Y0

 byte 3:    0  T&P    1    0    1    0    0   Y7

 byte 4:    0   Z6   Z5   Z4   Z3   Z2   Z1   Z0

 byte 5:    0    0    0    0    0    0    0    0



SWM, SWR, SWL: Middle, Right, and Left button states



Touchpad 1 Finger packet (APD = 0x0):



           b7   b6   b5   b4   b3   b2   b1   b0

 byte 0:  SWM  SWR  SWL    1    1   X2   X1   X0

 byte 1:   X9   X8   X7    1   X6   X5   X4   X3

 byte 2:    0  X11  X10  LFB   Y3   Y2   Y1   Y0

 byte 3:   Y5   Y4    0    0    1 TAPF2 TAPF1 TAPF0

 byte 4:  Zv7  Y11  Y10    1   Y9   Y8   Y7   Y6

 byte 5:  Zv6  Zv5  Zv4    0  Zv3  Zv2  Zv1  Zv0



TAPF: ???

LFB:  ???



Touchpad 2 Finger packet (APD = 0x1):



           b7   b6   b5   b4   b3   b2   b1   b0

 byte 0:  SWM  SWR  SWL    1    1  AX6  AX5  AX4

 byte 1: AX11 AX10  AX9  AX8  AX7  AZ1  AY4  AZ0

 byte 2: AY11 AY10  AY9  CONT AY8  AY7  AY6  AY5

 byte 3:    0    0    0    1    1  BX6  BX5  BX4

 byte 4: BX11 BX10  BX9  BX8  BX7  BZ1  BY4  BZ0

 byte 5: BY11 BY10  BY9    0  BY8  BY7  BY5  BY5



CONT: A 3-or-4 Finger packet is to follow



Touchpad 3-or-4 Finger packet (APD = 0x3):



           b7   b6   b5   b4   b3   b2   b1   b0

 byte 0:  SWM  SWR  SWL    1    1  AX6  AX5  AX4

 byte 1: AX11 AX10  AX9  AX8  AX7  AZ1  AY4  AZ0

 byte 2: AY11 AY10  AY9  OVF  AY8  AY7  AY6  AY5

 byte 3:    0    0    1    1    1  BX6  BX5  BX4

 byte 4: BX11 BX10  BX9  BX8  BX7  BZ1  BY4  BZ0

 byte 5: BY11 BY10  BY9    0  BY8  BY7  BY5  BY5



OVF: 5th finger detected