~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/hid/hid-alps.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/hid/hid-alps.rst (Version linux-6.12-rc7) and /Documentation/hid/hid-alps.rst (Version linux-5.16.20)


  1 ==========================                          1 ==========================
  2 ALPS HID Touchpad Protocol                          2 ALPS HID Touchpad Protocol
  3 ==========================                          3 ==========================
  4                                                     4 
  5 Introduction                                        5 Introduction
  6 ------------                                        6 ------------
  7 Currently ALPS HID driver supports U1 Touchpad      7 Currently ALPS HID driver supports U1 Touchpad device.
  8                                                     8 
  9 U1 device basic information.                        9 U1 device basic information.
 10                                                    10 
 11 ==========      ======                             11 ==========      ======
 12 Vendor ID       0x044E                         !!  12 Vender ID       0x044E
 13 Product ID      0x120B                             13 Product ID      0x120B
 14 Version ID      0x0121                             14 Version ID      0x0121
 15 ==========      ======                             15 ==========      ======
 16                                                    16 
 17                                                    17 
 18 HID Descriptor                                     18 HID Descriptor
 19 --------------                                     19 --------------
 20                                                    20 
 21 ======= ====================    =====   ======     21 ======= ====================    =====   =======================================
 22 Byte    Field                   Value   Notes      22 Byte    Field                   Value   Notes
 23 ======= ====================    =====   ======     23 ======= ====================    =====   =======================================
 24 0       wHIDDescLength          001E    Length     24 0       wHIDDescLength          001E    Length of HID Descriptor : 30 bytes
 25 2       bcdVersion              0100    Compli     25 2       bcdVersion              0100    Compliant with Version 1.00
 26 4       wReportDescLength       00B2    Report     26 4       wReportDescLength       00B2    Report Descriptor is 178 Bytes (0x00B2)
 27 6       wReportDescRegister     0002    Identi     27 6       wReportDescRegister     0002    Identifier to read Report Descriptor
 28 8       wInputRegister          0003    Identi     28 8       wInputRegister          0003    Identifier to read Input Report
 29 10      wMaxInputLength         0053    Input      29 10      wMaxInputLength         0053    Input Report is 80 Bytes + 2
 30 12      wOutputRegister         0000    Identi     30 12      wOutputRegister         0000    Identifier to read Output Report
 31 14      wMaxOutputLength        0000    No Out     31 14      wMaxOutputLength        0000    No Output Reports
 32 16      wCommandRegister        0005    Identi     32 16      wCommandRegister        0005    Identifier for Command Register
 33 18      wDataRegister           0006    Identi     33 18      wDataRegister           0006    Identifier for Data Register
 34 20      wVendorID               044E    Vendor     34 20      wVendorID               044E    Vendor ID 0x044E
 35 22      wProductID              120B    Produc     35 22      wProductID              120B    Product ID 0x120B
 36 24      wVersionID              0121    Versio     36 24      wVersionID              0121    Version 01.21
 37 26      RESERVED                0000    RESERV     37 26      RESERVED                0000    RESERVED
 38 ======= ====================    =====   ======     38 ======= ====================    =====   =======================================
 39                                                    39 
 40                                                    40 
 41 Report ID                                          41 Report ID
 42 ---------                                          42 ---------
 43                                                    43 
 44 ==========      =================  ===========     44 ==========      =================  =========================================
 45 ReportID-1      (Input Reports)    (HIDUsage-M     45 ReportID-1      (Input Reports)    (HIDUsage-Mouse) for TP&SP
 46 ReportID-2      (Input Reports)    (HIDUsage-k     46 ReportID-2      (Input Reports)    (HIDUsage-keyboard) for TP
 47 ReportID-3      (Input Reports)    (Vendor Usa     47 ReportID-3      (Input Reports)    (Vendor Usage: Max 10 finger data) for TP
 48 ReportID-4      (Input Reports)    (Vendor Usa     48 ReportID-4      (Input Reports)    (Vendor Usage: ON bit data) for GP
 49 ReportID-5      (Feature Reports)  Feature Rep     49 ReportID-5      (Feature Reports)  Feature Reports
 50 ReportID-6      (Input Reports)    (Vendor Usa     50 ReportID-6      (Input Reports)    (Vendor Usage: StickPointer data) for SP
 51 ReportID-7      (Feature Reports)  Flash updat     51 ReportID-7      (Feature Reports)  Flash update (Bootloader)
 52 ==========      =================  ===========     52 ==========      =================  =========================================
 53                                                    53 
 54                                                    54 
 55 Data pattern                                       55 Data pattern
 56 ------------                                       56 ------------
 57                                                    57 
 58 =====   ==========      =====   ==============     58 =====   ==========      =====   =================
 59 Case1   ReportID_1      TP/SP   Relative/Relat     59 Case1   ReportID_1      TP/SP   Relative/Relative
 60 Case2   ReportID_3      TP      Absolute           60 Case2   ReportID_3      TP      Absolute
 61         ReportID_6      SP      Absolute           61         ReportID_6      SP      Absolute
 62 =====   ==========      =====   ==============     62 =====   ==========      =====   =================
 63                                                    63 
 64                                                    64 
 65 Command Read/Write                                 65 Command Read/Write
 66 ------------------                                 66 ------------------
 67 To read/write to RAM, need to send a command t     67 To read/write to RAM, need to send a command to the device.
 68                                                    68 
 69 The command format is as below.                    69 The command format is as below.
 70                                                    70 
 71 DataByte(SET_REPORT)                               71 DataByte(SET_REPORT)
 72                                                    72 
 73 =====   ======================                     73 =====   ======================
 74 Byte1   Command Byte                               74 Byte1   Command Byte
 75 Byte2   Address - Byte 0 (LSB)                     75 Byte2   Address - Byte 0 (LSB)
 76 Byte3   Address - Byte 1                           76 Byte3   Address - Byte 1
 77 Byte4   Address - Byte 2                           77 Byte4   Address - Byte 2
 78 Byte5   Address - Byte 3 (MSB)                     78 Byte5   Address - Byte 3 (MSB)
 79 Byte6   Value Byte                                 79 Byte6   Value Byte
 80 Byte7   Checksum                                   80 Byte7   Checksum
 81 =====   ======================                     81 =====   ======================
 82                                                    82 
 83 Command Byte is read=0xD1/write=0xD2.              83 Command Byte is read=0xD1/write=0xD2.
 84                                                    84 
 85 Address is read/write RAM address.                 85 Address is read/write RAM address.
 86                                                    86 
 87 Value Byte is writing data when you send the w     87 Value Byte is writing data when you send the write commands.
 88                                                    88 
 89 When you read RAM, there is no meaning.            89 When you read RAM, there is no meaning.
 90                                                    90 
 91 DataByte(GET_REPORT)                               91 DataByte(GET_REPORT)
 92                                                    92 
 93 =====   ======================                     93 =====   ======================
 94 Byte1   Response Byte                              94 Byte1   Response Byte
 95 Byte2   Address - Byte 0 (LSB)                     95 Byte2   Address - Byte 0 (LSB)
 96 Byte3   Address - Byte 1                           96 Byte3   Address - Byte 1
 97 Byte4   Address - Byte 2                           97 Byte4   Address - Byte 2
 98 Byte5   Address - Byte 3 (MSB)                     98 Byte5   Address - Byte 3 (MSB)
 99 Byte6   Value Byte                                 99 Byte6   Value Byte
100 Byte7   Checksum                                  100 Byte7   Checksum
101 =====   ======================                    101 =====   ======================
102                                                   102 
103 Read value is stored in Value Byte.               103 Read value is stored in Value Byte.
104                                                   104 
105                                                   105 
106 Packet Format                                     106 Packet Format
107 Touchpad data byte                                107 Touchpad data byte
108 ------------------                                108 ------------------
109                                                   109 
110                                                   110 
111 ======= ======= ======= ======= ======= ======    111 ======= ======= ======= ======= ======= ======= ======= ======= =====
112 -       b7      b6      b5      b4      b3        112 -       b7      b6      b5      b4      b3      b2      b1      b0
113 ======= ======= ======= ======= ======= ======    113 ======= ======= ======= ======= ======= ======= ======= ======= =====
114 1       0       0       SW6     SW5     SW4       114 1       0       0       SW6     SW5     SW4     SW3     SW2     SW1
115 2       0       0       0       Fcv     Fn3       115 2       0       0       0       Fcv     Fn3     Fn2     Fn1     Fn0
116 3       Xa0_7   Xa0_6   Xa0_5   Xa0_4   Xa0_3     116 3       Xa0_7   Xa0_6   Xa0_5   Xa0_4   Xa0_3   Xa0_2   Xa0_1   Xa0_0
117 4       Xa0_15  Xa0_14  Xa0_13  Xa0_12  Xa0_11    117 4       Xa0_15  Xa0_14  Xa0_13  Xa0_12  Xa0_11  Xa0_10  Xa0_9   Xa0_8
118 5       Ya0_7   Ya0_6   Ya0_5   Ya0_4   Ya0_3     118 5       Ya0_7   Ya0_6   Ya0_5   Ya0_4   Ya0_3   Ya0_2   Ya0_1   Ya0_0
119 6       Ya0_15  Ya0_14  Ya0_13  Ya0_12  Ya0_11    119 6       Ya0_15  Ya0_14  Ya0_13  Ya0_12  Ya0_11  Ya0_10  Ya0_9   Ya0_8
120 7       LFB0    Zs0_6   Zs0_5   Zs0_4   Zs0_3     120 7       LFB0    Zs0_6   Zs0_5   Zs0_4   Zs0_3   Zs0_2   Zs0_1   Zs0_0
121                                                   121 
122 8       Xa1_7   Xa1_6   Xa1_5   Xa1_4   Xa1_3     122 8       Xa1_7   Xa1_6   Xa1_5   Xa1_4   Xa1_3   Xa1_2   Xa1_1   Xa1_0
123 9       Xa1_15  Xa1_14  Xa1_13  Xa1_12  Xa1_11    123 9       Xa1_15  Xa1_14  Xa1_13  Xa1_12  Xa1_11  Xa1_10  Xa1_9   Xa1_8
124 10      Ya1_7   Ya1_6   Ya1_5   Ya1_4   Ya1_3     124 10      Ya1_7   Ya1_6   Ya1_5   Ya1_4   Ya1_3   Ya1_2   Ya1_1   Ya1_0
125 11      Ya1_15  Ya1_14  Ya1_13  Ya1_12  Ya1_11    125 11      Ya1_15  Ya1_14  Ya1_13  Ya1_12  Ya1_11  Ya1_10  Ya1_9   Ya1_8
126 12      LFB1    Zs1_6   Zs1_5   Zs1_4   Zs1_3     126 12      LFB1    Zs1_6   Zs1_5   Zs1_4   Zs1_3   Zs1_2   Zs1_1   Zs1_0
127                                                   127 
128 13      Xa2_7   Xa2_6   Xa2_5   Xa2_4   Xa2_3     128 13      Xa2_7   Xa2_6   Xa2_5   Xa2_4   Xa2_3   Xa2_2   Xa2_1   Xa2_0
129 14      Xa2_15  Xa2_14  Xa2_13  Xa2_12  Xa2_11    129 14      Xa2_15  Xa2_14  Xa2_13  Xa2_12  Xa2_11  Xa2_10  Xa2_9   Xa2_8
130 15      Ya2_7   Ya2_6   Ya2_5   Ya2_4   Ya2_3     130 15      Ya2_7   Ya2_6   Ya2_5   Ya2_4   Ya2_3   Ya2_2   Ya2_1   Ya2_0
131 16      Ya2_15  Ya2_14  Ya2_13  Ya2_12  Ya2_11    131 16      Ya2_15  Ya2_14  Ya2_13  Ya2_12  Ya2_11  Ya2_10  Ya2_9   Ya2_8
132 17      LFB2    Zs2_6   Zs2_5   Zs2_4   Zs2_3     132 17      LFB2    Zs2_6   Zs2_5   Zs2_4   Zs2_3   Zs2_2   Zs2_1   Zs2_0
133                                                   133 
134 18      Xa3_7   Xa3_6   Xa3_5   Xa3_4   Xa3_3     134 18      Xa3_7   Xa3_6   Xa3_5   Xa3_4   Xa3_3   Xa3_2   Xa3_1   Xa3_0
135 19      Xa3_15  Xa3_14  Xa3_13  Xa3_12  Xa3_11    135 19      Xa3_15  Xa3_14  Xa3_13  Xa3_12  Xa3_11  Xa3_10  Xa3_9   Xa3_8
136 20      Ya3_7   Ya3_6   Ya3_5   Ya3_4   Ya3_3     136 20      Ya3_7   Ya3_6   Ya3_5   Ya3_4   Ya3_3   Ya3_2   Ya3_1   Ya3_0
137 21      Ya3_15  Ya3_14  Ya3_13  Ya3_12  Ya3_11    137 21      Ya3_15  Ya3_14  Ya3_13  Ya3_12  Ya3_11  Ya3_10  Ya3_9   Ya3_8
138 22      LFB3    Zs3_6   Zs3_5   Zs3_4   Zs3_3     138 22      LFB3    Zs3_6   Zs3_5   Zs3_4   Zs3_3   Zs3_2   Zs3_1   Zs3_0
139                                                   139 
140 23      Xa4_7   Xa4_6   Xa4_5   Xa4_4   Xa4_3     140 23      Xa4_7   Xa4_6   Xa4_5   Xa4_4   Xa4_3   Xa4_2   Xa4_1   Xa4_0
141 24      Xa4_15  Xa4_14  Xa4_13  Xa4_12  Xa4_11    141 24      Xa4_15  Xa4_14  Xa4_13  Xa4_12  Xa4_11  Xa4_10  Xa4_9   Xa4_8
142 25      Ya4_7   Ya4_6   Ya4_5   Ya4_4   Ya4_3     142 25      Ya4_7   Ya4_6   Ya4_5   Ya4_4   Ya4_3   Ya4_2   Ya4_1   Ya4_0
143 26      Ya4_15  Ya4_14  Ya4_13  Ya4_12  Ya4_11    143 26      Ya4_15  Ya4_14  Ya4_13  Ya4_12  Ya4_11  Ya4_10  Ya4_9   Ya4_8
144 27      LFB4    Zs4_6   Zs4_5   Zs4_4   Zs4_3     144 27      LFB4    Zs4_6   Zs4_5   Zs4_4   Zs4_3   Zs4_2   Zs4_1   Zs4_0
145 ======= ======= ======= ======= ======= ======    145 ======= ======= ======= ======= ======= ======= ======= ======= =====
146                                                   146 
147                                                   147 
148 SW1-SW6:                                          148 SW1-SW6:
149         SW ON/OFF status                          149         SW ON/OFF status
150 Xan_15-0(16bit):                                  150 Xan_15-0(16bit):
151         X Absolute data of the "n"th finger       151         X Absolute data of the "n"th finger
152 Yan_15-0(16bit):                                  152 Yan_15-0(16bit):
153         Y Absolute data of the "n"th finger       153         Y Absolute data of the "n"th finger
154 Zsn_6-0(7bit):                                    154 Zsn_6-0(7bit):
155         Operation area of the "n"th finger        155         Operation area of the "n"th finger
156                                                   156 
157                                                   157 
158 StickPointer data byte                            158 StickPointer data byte
159 ----------------------                            159 ----------------------
160                                                   160 
161 ======= ======= ======= ======= ======= ======    161 ======= ======= ======= ======= ======= ======= ======= ======= =====
162 -       b7      b6      b5      b4      b3        162 -       b7      b6      b5      b4      b3      b2      b1      b0
163 ======= ======= ======= ======= ======= ======    163 ======= ======= ======= ======= ======= ======= ======= ======= =====
164 Byte1   1       1       1       0       1         164 Byte1   1       1       1       0       1       SW3     SW2     SW1
165 Byte2   X7      X6      X5      X4      X3        165 Byte2   X7      X6      X5      X4      X3      X2      X1      X0
166 Byte3   X15     X14     X13     X12     X11       166 Byte3   X15     X14     X13     X12     X11     X10     X9      X8
167 Byte4   Y7      Y6      Y5      Y4      Y3        167 Byte4   Y7      Y6      Y5      Y4      Y3      Y2      Y1      Y0
168 Byte5   Y15     Y14     Y13     Y12     Y11       168 Byte5   Y15     Y14     Y13     Y12     Y11     Y10     Y9      Y8
169 Byte6   Z7      Z6      Z5      Z4      Z3        169 Byte6   Z7      Z6      Z5      Z4      Z3      Z2      Z1      Z0
170 Byte7   T&P     Z14     Z13     Z12     Z11       170 Byte7   T&P     Z14     Z13     Z12     Z11     Z10     Z9      Z8
171 ======= ======= ======= ======= ======= ======    171 ======= ======= ======= ======= ======= ======= ======= ======= =====
172                                                   172 
173 SW1-SW3:                                          173 SW1-SW3:
174         SW ON/OFF status                          174         SW ON/OFF status
175 Xn_15-0(16bit):                                   175 Xn_15-0(16bit):
176         X Absolute data                           176         X Absolute data
177 Yn_15-0(16bit):                                   177 Yn_15-0(16bit):
178         Y Absolute data                           178         Y Absolute data
179 Zn_14-0(15bit):                                   179 Zn_14-0(15bit):
180         Z                                         180         Z
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php