]>
Commit | Line | Data |
---|---|---|
d2912cb1 | 1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
1da177e4 LT |
2 | /* |
3 | * ALPS touchpad PS/2 mouse driver | |
4 | * | |
5 | * Copyright (c) 2003 Peter Osterlund <petero2@telia.com> | |
6 | * Copyright (c) 2005 Vojtech Pavlik <vojtech@suse.cz> | |
1da177e4 LT |
7 | */ |
8 | ||
9 | #ifndef _ALPS_H | |
10 | #define _ALPS_H | |
11 | ||
02d04254 HG |
12 | #include <linux/input/mt.h> |
13 | ||
d7c13d34 DT |
14 | #define ALPS_PROTO_V1 0x100 |
15 | #define ALPS_PROTO_V2 0x200 | |
16 | #define ALPS_PROTO_V3 0x300 | |
fb2dd7a6 | 17 | #define ALPS_PROTO_V3_RUSHMORE 0x310 |
d7c13d34 DT |
18 | #define ALPS_PROTO_V4 0x400 |
19 | #define ALPS_PROTO_V5 0x500 | |
20 | #define ALPS_PROTO_V6 0x600 | |
21 | #define ALPS_PROTO_V7 0x700 /* t3btl t4s */ | |
3db5b9f7 | 22 | #define ALPS_PROTO_V8 0x800 /* SS4btl SS4s */ |
c9815232 | 23 | #define ALPS_PROTO_V9 0x900 /* ss3btl */ |
fa629ef5 | 24 | |
3db5b9f7 | 25 | #define MAX_TOUCHES 4 |
02d04254 | 26 | |
ee65d4b3 YT |
27 | #define DOLPHIN_COUNT_PER_ELECTRODE 64 |
28 | #define DOLPHIN_PROFILE_XOFFSET 8 /* x-electrode offset */ | |
29 | #define DOLPHIN_PROFILE_YOFFSET 1 /* y-electrode offset */ | |
30 | ||
3db5b9f7 MO |
31 | /* |
32 | * enum SS4_PACKET_ID - defines the packet type for V8 | |
33 | * SS4_PACKET_ID_IDLE: There's no finger and no button activity. | |
34 | * SS4_PACKET_ID_ONE: There's one finger on touchpad | |
35 | * or there's button activities. | |
36 | * SS4_PACKET_ID_TWO: There's two or more fingers on touchpad | |
37 | * SS4_PACKET_ID_MULTI: There's three or more fingers on touchpad | |
4777ac22 | 38 | * SS4_PACKET_ID_STICK: A stick pointer packet |
3db5b9f7 MO |
39 | */ |
40 | enum SS4_PACKET_ID { | |
41 | SS4_PACKET_ID_IDLE = 0, | |
42 | SS4_PACKET_ID_ONE, | |
43 | SS4_PACKET_ID_TWO, | |
44 | SS4_PACKET_ID_MULTI, | |
4777ac22 | 45 | SS4_PACKET_ID_STICK, |
3db5b9f7 MO |
46 | }; |
47 | ||
48 | #define SS4_COUNT_PER_ELECTRODE 256 | |
49 | #define SS4_NUMSENSOR_XOFFSET 7 | |
50 | #define SS4_NUMSENSOR_YOFFSET 7 | |
51 | #define SS4_MIN_PITCH_MM 50 | |
52 | ||
53 | #define SS4_MASK_NORMAL_BUTTONS 0x07 | |
54 | ||
e7348396 MO |
55 | #define SS4PLUS_COUNT_PER_ELECTRODE 128 |
56 | #define SS4PLUS_NUMSENSOR_XOFFSET 16 | |
57 | #define SS4PLUS_NUMSENSOR_YOFFSET 5 | |
58 | #define SS4PLUS_MIN_PITCH_MM 37 | |
59 | ||
60 | #define IS_SS4PLUS_DEV(_b) (((_b[0]) == 0x73) && \ | |
61 | ((_b[1]) == 0x03) && \ | |
62 | ((_b[2]) == 0x28) \ | |
63 | ) | |
64 | ||
23fce365 PD |
65 | #define SS4_IS_IDLE_V2(_b) (((_b[0]) == 0x18) && \ |
66 | ((_b[1]) == 0x10) && \ | |
67 | ((_b[2]) == 0x00) && \ | |
68 | ((_b[3] & 0x88) == 0x08) && \ | |
69 | ((_b[4]) == 0x10) && \ | |
70 | ((_b[5]) == 0x00) \ | |
71 | ) | |
72 | ||
73 | #define SS4_1F_X_V2(_b) (((_b[0]) & 0x0007) | \ | |
3db5b9f7 MO |
74 | ((_b[1] << 3) & 0x0078) | \ |
75 | ((_b[1] << 2) & 0x0380) | \ | |
76 | ((_b[2] << 5) & 0x1C00) \ | |
77 | ) | |
78 | ||
79 | #define SS4_1F_Y_V2(_b) (((_b[2]) & 0x000F) | \ | |
80 | ((_b[3] >> 2) & 0x0030) | \ | |
81 | ((_b[4] << 6) & 0x03C0) | \ | |
82 | ((_b[4] << 5) & 0x0C00) \ | |
83 | ) | |
84 | ||
85 | #define SS4_1F_Z_V2(_b) (((_b[5]) & 0x0F) | \ | |
86 | ((_b[5] >> 1) & 0x70) | \ | |
87 | ((_b[4]) & 0x80) \ | |
88 | ) | |
89 | ||
90 | #define SS4_1F_LFB_V2(_b) (((_b[2] >> 4) & 0x01) == 0x01) | |
91 | ||
92 | #define SS4_MF_LF_V2(_b, _i) ((_b[1 + (_i) * 3] & 0x0004) == 0x0004) | |
93 | ||
94 | #define SS4_BTN_V2(_b) ((_b[0] >> 5) & SS4_MASK_NORMAL_BUTTONS) | |
95 | ||
96 | #define SS4_STD_MF_X_V2(_b, _i) (((_b[0 + (_i) * 3] << 5) & 0x00E0) | \ | |
97 | ((_b[1 + _i * 3] << 5) & 0x1F00) \ | |
98 | ) | |
99 | ||
4a646580 MO |
100 | #define SS4_PLUS_STD_MF_X_V2(_b, _i) (((_b[0 + (_i) * 3] << 4) & 0x0070) | \ |
101 | ((_b[1 + (_i) * 3] << 4) & 0x0F80) \ | |
102 | ) | |
103 | ||
3db5b9f7 MO |
104 | #define SS4_STD_MF_Y_V2(_b, _i) (((_b[1 + (_i) * 3] << 3) & 0x0010) | \ |
105 | ((_b[2 + (_i) * 3] << 5) & 0x01E0) | \ | |
106 | ((_b[2 + (_i) * 3] << 4) & 0x0E00) \ | |
107 | ) | |
108 | ||
109 | #define SS4_BTL_MF_X_V2(_b, _i) (SS4_STD_MF_X_V2(_b, _i) | \ | |
110 | ((_b[0 + (_i) * 3] >> 3) & 0x0010) \ | |
111 | ) | |
112 | ||
4a646580 MO |
113 | #define SS4_PLUS_BTL_MF_X_V2(_b, _i) (SS4_PLUS_STD_MF_X_V2(_b, _i) | \ |
114 | ((_b[0 + (_i) * 3] >> 4) & 0x0008) \ | |
115 | ) | |
116 | ||
3db5b9f7 MO |
117 | #define SS4_BTL_MF_Y_V2(_b, _i) (SS4_STD_MF_Y_V2(_b, _i) | \ |
118 | ((_b[0 + (_i) * 3] >> 3) & 0x0008) \ | |
119 | ) | |
120 | ||
121 | #define SS4_MF_Z_V2(_b, _i) (((_b[1 + (_i) * 3]) & 0x0001) | \ | |
122 | ((_b[1 + (_i) * 3] >> 1) & 0x0002) \ | |
123 | ) | |
124 | ||
125 | #define SS4_IS_MF_CONTINUE(_b) ((_b[2] & 0x10) == 0x10) | |
126 | #define SS4_IS_5F_DETECTED(_b) ((_b[2] & 0x10) == 0x10) | |
127 | ||
23fce365 PD |
128 | #define SS4_TS_X_V2(_b) (s8)( \ |
129 | ((_b[0] & 0x01) << 7) | \ | |
130 | (_b[1] & 0x7F) \ | |
131 | ) | |
132 | ||
47e3a5ed | 133 | #define SS4_TS_Y_V2(_b) -(s8)( \ |
23fce365 PD |
134 | ((_b[3] & 0x01) << 7) | \ |
135 | (_b[2] & 0x7F) \ | |
136 | ) | |
137 | ||
138 | #define SS4_TS_Z_V2(_b) (s8)(_b[4] & 0x7F) | |
139 | ||
3db5b9f7 | 140 | |
4d94e776 NP |
141 | #define SS4_MFPACKET_NO_AX 8160 /* X-Coordinate value */ |
142 | #define SS4_MFPACKET_NO_AY 4080 /* Y-Coordinate value */ | |
143 | #define SS4_MFPACKET_NO_AX_BL 8176 /* Buttonless X-Coord value */ | |
144 | #define SS4_MFPACKET_NO_AY_BL 4088 /* Buttonless Y-Coord value */ | |
145 | #define SS4_PLUS_MFPACKET_NO_AX 4080 /* SS4 PLUS, X */ | |
146 | #define SS4_PLUS_MFPACKET_NO_AX_BL 4088 /* Buttonless SS4 PLUS, X */ | |
3db5b9f7 | 147 | |
3808843c YT |
148 | /* |
149 | * enum V7_PACKET_ID - defines the packet type for V7 | |
150 | * V7_PACKET_ID_IDLE: There's no finger and no button activity. | |
151 | * V7_PACKET_ID_TWO: There's one or two non-resting fingers on touchpad | |
152 | * or there's button activities. | |
153 | * V7_PACKET_ID_MULTI: There are at least three non-resting fingers. | |
154 | * V7_PACKET_ID_NEW: The finger position in slot is not continues from | |
155 | * previous packet. | |
156 | */ | |
157 | enum V7_PACKET_ID { | |
158 | V7_PACKET_ID_IDLE, | |
159 | V7_PACKET_ID_TWO, | |
160 | V7_PACKET_ID_MULTI, | |
161 | V7_PACKET_ID_NEW, | |
162 | V7_PACKET_ID_UNKNOWN, | |
163 | }; | |
164 | ||
8326bb57 DT |
165 | /** |
166 | * struct alps_protocol_info - information about protocol used by a device | |
167 | * @version: Indicates V1/V2/V3/... | |
168 | * @byte0: Helps figure out whether a position report packet matches the | |
169 | * known format for this model. The first byte of the report, ANDed with | |
170 | * mask0, should match byte0. | |
171 | * @mask0: The mask used to check the first byte of the report. | |
172 | * @flags: Additional device capabilities (passthrough port, trackstick, etc.). | |
173 | */ | |
174 | struct alps_protocol_info { | |
175 | u16 version; | |
176 | u8 byte0, mask0; | |
177 | unsigned int flags; | |
178 | }; | |
179 | ||
88a80348 KC |
180 | /** |
181 | * struct alps_model_info - touchpad ID table | |
182 | * @signature: E7 response string to match. | |
7343d119 | 183 | * @protocol_info: information about protocol used by the device. |
88a80348 KC |
184 | * |
185 | * Many (but not all) ALPS touchpads can be identified by looking at the | |
186 | * values returned in the "E7 report" and/or the "EC report." This table | |
187 | * lists a number of such touchpads. | |
188 | */ | |
1da177e4 | 189 | struct alps_model_info { |
d7c13d34 | 190 | u8 signature[3]; |
8326bb57 | 191 | struct alps_protocol_info protocol_info; |
1da177e4 LT |
192 | }; |
193 | ||
88a80348 KC |
194 | /** |
195 | * struct alps_nibble_commands - encodings for register accesses | |
196 | * @command: PS/2 command used for the nibble | |
197 | * @data: Data supplied as an argument to the PS/2 command, if applicable | |
198 | * | |
199 | * The ALPS protocol uses magic sequences to transmit binary data to the | |
200 | * touchpad, as it is generally not OK to send arbitrary bytes out the | |
201 | * PS/2 port. Each of the sequences in this table sends one nibble of the | |
202 | * register address or (write) data. Different versions of the ALPS protocol | |
203 | * use slightly different encodings. | |
204 | */ | |
25bded7c SF |
205 | struct alps_nibble_commands { |
206 | int command; | |
207 | unsigned char data; | |
208 | }; | |
209 | ||
036e6c7b HG |
210 | struct alps_bitmap_point { |
211 | int start_bit; | |
212 | int num_bits; | |
213 | }; | |
214 | ||
f85e5001 KC |
215 | /** |
216 | * struct alps_fields - decoded version of the report packet | |
217 | * @x_map: Bitmap of active X positions for MT. | |
218 | * @y_map: Bitmap of active Y positions for MT. | |
219 | * @fingers: Number of fingers for MT. | |
02d04254 HG |
220 | * @pressure: Pressure. |
221 | * @st: position for ST. | |
222 | * @mt: position for MT. | |
f85e5001 KC |
223 | * @first_mp: Packet is the first of a multi-packet report. |
224 | * @is_mp: Packet is part of a multi-packet report. | |
225 | * @left: Left touchpad button is active. | |
226 | * @right: Right touchpad button is active. | |
227 | * @middle: Middle touchpad button is active. | |
228 | * @ts_left: Left trackstick button is active. | |
229 | * @ts_right: Right trackstick button is active. | |
230 | * @ts_middle: Middle trackstick button is active. | |
231 | */ | |
232 | struct alps_fields { | |
233 | unsigned int x_map; | |
234 | unsigned int y_map; | |
235 | unsigned int fingers; | |
02d04254 HG |
236 | |
237 | int pressure; | |
238 | struct input_mt_pos st; | |
239 | struct input_mt_pos mt[MAX_TOUCHES]; | |
240 | ||
f85e5001 KC |
241 | unsigned int first_mp:1; |
242 | unsigned int is_mp:1; | |
243 | ||
244 | unsigned int left:1; | |
245 | unsigned int right:1; | |
246 | unsigned int middle:1; | |
247 | ||
248 | unsigned int ts_left:1; | |
249 | unsigned int ts_right:1; | |
250 | unsigned int ts_middle:1; | |
251 | }; | |
252 | ||
88a80348 KC |
253 | /** |
254 | * struct alps_data - private data structure for the ALPS driver | |
04aae283 PR |
255 | * @psmouse: Pointer to parent psmouse device |
256 | * @dev2: Trackstick device (can be NULL). | |
257 | * @dev3: Generic PS/2 mouse (can be NULL, delayed registering). | |
258 | * @phys2: Physical path for the trackstick device. | |
259 | * @phys3: Physical path for the generic PS/2 mouse. | |
260 | * @dev3_register_work: Delayed work for registering PS/2 mouse. | |
88a80348 KC |
261 | * @nibble_commands: Command mapping used for touchpad register accesses. |
262 | * @addr_command: Command used to tell the touchpad that a register address | |
263 | * follows. | |
99df65e7 KC |
264 | * @proto_version: Indicates V1/V2/V3/... |
265 | * @byte0: Helps figure out whether a position report packet matches the | |
266 | * known format for this model. The first byte of the report, ANDed with | |
267 | * mask0, should match byte0. | |
268 | * @mask0: The mask used to check the first byte of the report. | |
c0cd17f6 | 269 | * @fw_ver: cached copy of firmware version (EC report) |
99df65e7 | 270 | * @flags: Additional device capabilities (passthrough port, trackstick, etc.). |
7a9f73e7 KC |
271 | * @x_max: Largest possible X position value. |
272 | * @y_max: Largest possible Y position value. | |
273 | * @x_bits: Number of X bits in the MT bitmap. | |
274 | * @y_bits: Number of Y bits in the MT bitmap. | |
24af5cb9 KC |
275 | * @hw_init: Protocol-specific hardware init function. |
276 | * @process_packet: Protocol-specific function to process a report packet. | |
f85e5001 | 277 | * @decode_fields: Protocol-specific function to read packet bitfields. |
24af5cb9 | 278 | * @set_abs_params: Protocol-specific function to configure the input_dev. |
88a80348 KC |
279 | * @prev_fin: Finger bit from previous packet. |
280 | * @multi_packet: Multi-packet data in progress. | |
281 | * @multi_data: Saved multi-packet data. | |
02d04254 | 282 | * @f: Decoded packet data fields. |
88a80348 KC |
283 | * @quirks: Bitmap of ALPS_QUIRK_*. |
284 | * @timer: Timer for flushing out the final report packet in the stream. | |
285 | */ | |
1da177e4 | 286 | struct alps_data { |
04aae283 | 287 | struct psmouse *psmouse; |
88a80348 | 288 | struct input_dev *dev2; |
04aae283 PR |
289 | struct input_dev *dev3; |
290 | char phys2[32]; | |
291 | char phys3[32]; | |
292 | struct delayed_work dev3_register_work; | |
99df65e7 KC |
293 | |
294 | /* these are autodetected when the device is identified */ | |
25bded7c | 295 | const struct alps_nibble_commands *nibble_commands; |
88a80348 | 296 | int addr_command; |
d7c13d34 DT |
297 | u16 proto_version; |
298 | u8 byte0, mask0; | |
e7348396 | 299 | u8 dev_id[3]; |
d7c13d34 | 300 | u8 fw_ver[3]; |
40e8f53b | 301 | int flags; |
7a9f73e7 KC |
302 | int x_max; |
303 | int y_max; | |
304 | int x_bits; | |
305 | int y_bits; | |
f3f33c67 HG |
306 | unsigned int x_res; |
307 | unsigned int y_res; | |
99df65e7 | 308 | |
24af5cb9 KC |
309 | int (*hw_init)(struct psmouse *psmouse); |
310 | void (*process_packet)(struct psmouse *psmouse); | |
38c11eaa | 311 | int (*decode_fields)(struct alps_fields *f, unsigned char *p, |
ee65d4b3 | 312 | struct psmouse *psmouse); |
24af5cb9 KC |
313 | void (*set_abs_params)(struct alps_data *priv, struct input_dev *dev1); |
314 | ||
88a80348 KC |
315 | int prev_fin; |
316 | int multi_packet; | |
4dd26573 | 317 | int second_touch; |
88a80348 | 318 | unsigned char multi_data[6]; |
02d04254 | 319 | struct alps_fields f; |
25bded7c | 320 | u8 quirks; |
1d9f2626 | 321 | struct timer_list timer; |
1da177e4 LT |
322 | }; |
323 | ||
25bded7c SF |
324 | #define ALPS_QUIRK_TRACKSTICK_BUTTONS 1 /* trakcstick buttons in trackstick packet */ |
325 | ||
55e3d922 | 326 | #ifdef CONFIG_MOUSE_PS2_ALPS |
b7802c5c | 327 | int alps_detect(struct psmouse *psmouse, bool set_properties); |
55e3d922 AS |
328 | int alps_init(struct psmouse *psmouse); |
329 | #else | |
b7802c5c | 330 | inline int alps_detect(struct psmouse *psmouse, bool set_properties) |
55e3d922 AS |
331 | { |
332 | return -ENOSYS; | |
333 | } | |
334 | inline int alps_init(struct psmouse *psmouse) | |
335 | { | |
336 | return -ENOSYS; | |
337 | } | |
338 | #endif /* CONFIG_MOUSE_PS2_ALPS */ | |
339 | ||
1da177e4 | 340 | #endif |