synaptics.c revision 1.63 1 /* $NetBSD: synaptics.c,v 1.63 2020/03/27 11:10:07 nia Exp $ */
2
3 /*
4 * Copyright (c) 2005, Steve C. Woodford
5 * Copyright (c) 2004, Ales Krenek
6 * Copyright (c) 2004, Kentaro A. Kurahone
7 * All rights reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 *
13 * * Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * * Redistributions in binary form must reproduce the above
16 * copyright notice, this list of conditions and the following
17 * disclaimer in the documentation and/or other materials provided
18 * with the distribution.
19 * * Neither the name of the authors nor the names of its
20 * contributors may be used to endorse or promote products derived
21 * from this software without specific prior written permission.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
26 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
27 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
28 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
29 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
33 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34 * POSSIBILITY OF SUCH DAMAGE.
35 *
36 */
37
38 /*
39 * TODO:
40 * - Make the sysctl values per-instance instead of global.
41 * - Consider setting initial scaling factors at runtime according
42 * to the values returned by the 'Read Resolutions' command.
43 * - Support the serial protocol (we only support PS/2 for now)
44 * - Support auto-repeat for up/down button Z-axis emulation.
45 * - Maybe add some more gestures (can we use Palm support somehow?)
46 */
47
48 #include "opt_pms.h"
49
50 #include <sys/cdefs.h>
51 __KERNEL_RCSID(0, "$NetBSD: synaptics.c,v 1.63 2020/03/27 11:10:07 nia Exp $");
52
53 #include <sys/param.h>
54 #include <sys/systm.h>
55 #include <sys/device.h>
56 #include <sys/ioctl.h>
57 #include <sys/sysctl.h>
58 #include <sys/kernel.h>
59 #include <sys/proc.h>
60
61 #include <sys/bus.h>
62
63 #include <dev/pckbport/pckbportvar.h>
64
65 #include <dev/pckbport/synapticsreg.h>
66 #include <dev/pckbport/synapticsvar.h>
67
68 #include <dev/pckbport/pmsreg.h>
69 #include <dev/pckbport/pmsvar.h>
70
71 #include <dev/wscons/wsconsio.h>
72 #include <dev/wscons/wsmousevar.h>
73
74 /*
75 * Absolute-mode packets are decoded and passed around using
76 * the following structure.
77 */
78 struct synaptics_packet {
79 signed short sp_x; /* Unscaled absolute X/Y coordinates */
80 signed short sp_y;
81 u_char sp_z; /* Z (pressure) */
82 u_char sp_w; /* W (contact patch width) */
83 signed short sp_sx; /* Secondary finger unscaled absolute */
84 /* X/Y coordinates */
85 signed short sp_xy;
86 u_char sp_finger; /* 0 for primary, 1 for secondary */
87 char sp_left; /* Left mouse button status */
88 char sp_right; /* Right mouse button status */
89 char sp_middle; /* Middle button status (possibly emulated) */
90 char sp_up; /* Up button status */
91 char sp_down; /* Down button status */
92 };
93
94 static void pms_synaptics_input(void *, int);
95 static void pms_synaptics_process_packet(struct pms_softc *,
96 struct synaptics_packet *);
97 static void pms_sysctl_synaptics(struct sysctllog **);
98 static int pms_sysctl_synaptics_verify(SYSCTLFN_ARGS);
99
100 /* Controlled by sysctl. */
101 static int synaptics_up_down_emul = 3;
102 static int synaptics_up_down_motion_delta = 1;
103 static int synaptics_gesture_move = 200;
104 static int synaptics_gesture_length = 20;
105 static int synaptics_edge_left = SYNAPTICS_EDGE_LEFT;
106 static int synaptics_edge_right = SYNAPTICS_EDGE_RIGHT;
107 static int synaptics_edge_top = SYNAPTICS_EDGE_TOP;
108 static int synaptics_edge_bottom = SYNAPTICS_EDGE_BOTTOM;
109 static int synaptics_edge_motion_delta = 32;
110 static u_int synaptics_finger_high = SYNAPTICS_FINGER_LIGHT + 5;
111 static u_int synaptics_finger_low = SYNAPTICS_FINGER_LIGHT - 10;
112 static int synaptics_button_boundary = SYNAPTICS_EDGE_BOTTOM + 720;
113 static int synaptics_button2 = SYNAPTICS_EDGE_LEFT + (SYNAPTICS_EDGE_RIGHT - SYNAPTICS_EDGE_LEFT) / 3;
114 static int synaptics_button3 = SYNAPTICS_EDGE_LEFT + 2 * (SYNAPTICS_EDGE_RIGHT - SYNAPTICS_EDGE_LEFT) / 3;
115 static int synaptics_two_fingers_emul = 0;
116 static int synaptics_scale_x = 16;
117 static int synaptics_scale_y = 16;
118 static int synaptics_scale_z = 32;
119 static int synaptics_max_speed_x = 32;
120 static int synaptics_max_speed_y = 32;
121 static int synaptics_max_speed_z = 2;
122 static int synaptics_movement_threshold = 4;
123 static int synaptics_fscroll_min = 13;
124 static int synaptics_fscroll_max = 14;
125 static int synaptics_dz_hold = 30;
126 static int synaptics_movement_enable = 1;
127
128 /* Sysctl nodes. */
129 static int synaptics_button_boundary_nodenum;
130 static int synaptics_button2_nodenum;
131 static int synaptics_button3_nodenum;
132 static int synaptics_up_down_emul_nodenum;
133 static int synaptics_up_down_motion_delta_nodenum;
134 static int synaptics_gesture_move_nodenum;
135 static int synaptics_gesture_length_nodenum;
136 static int synaptics_edge_left_nodenum;
137 static int synaptics_edge_right_nodenum;
138 static int synaptics_edge_top_nodenum;
139 static int synaptics_edge_bottom_nodenum;
140 static int synaptics_edge_motion_delta_nodenum;
141 static int synaptics_finger_high_nodenum;
142 static int synaptics_finger_low_nodenum;
143 static int synaptics_two_fingers_emul_nodenum;
144 static int synaptics_scale_x_nodenum;
145 static int synaptics_scale_y_nodenum;
146 static int synaptics_scale_z_nodenum;
147 static int synaptics_max_speed_x_nodenum;
148 static int synaptics_max_speed_y_nodenum;
149 static int synaptics_max_speed_z_nodenum;
150 static int synaptics_movement_threshold_nodenum;
151 static int synaptics_finger_scroll_min_nodenum;
152 static int synaptics_finger_scroll_max_nodenum;
153 static int synaptics_dz_hold_nodenum;
154 static int synaptics_movement_enable_nodenum;
155
156 static int
157 synaptics_poll_cmd(struct pms_softc *psc, ...)
158 {
159 u_char cmd[4];
160 size_t i;
161 va_list ap;
162
163 va_start(ap, psc);
164
165 for (i = 0; i < __arraycount(cmd); i++)
166 if ((cmd[i] = (u_char)va_arg(ap, int)) == 0)
167 break;
168 va_end(ap);
169
170 int res = pckbport_poll_cmd(psc->sc_kbctag, psc->sc_kbcslot, cmd, i, 0,
171 NULL, 0);
172 if (res)
173 aprint_error_dev(psc->sc_dev, "command error %#x\n", cmd[0]);
174 return res;
175 }
176
177 static int
178 synaptics_poll_reset(struct pms_softc *psc)
179 {
180 u_char resp[2];
181 int res;
182
183 u_char cmd[1] = { PMS_RESET };
184 res = pckbport_poll_cmd(psc->sc_kbctag, psc->sc_kbcslot, cmd, 1, 2,
185 resp, 1);
186 aprint_debug_dev(psc->sc_dev, "reset %d 0x%02x 0x%02x\n",
187 res, resp[0], resp[1]);
188 return res;
189 }
190
191 static int
192 synaptics_special_read(struct pms_softc *psc, u_char slice, u_char resp[3])
193 {
194 u_char cmd[1] = { PMS_SEND_DEV_STATUS };
195 int res = pms_sliced_command(psc->sc_kbctag, psc->sc_kbcslot, slice);
196
197 return res | pckbport_poll_cmd(psc->sc_kbctag, psc->sc_kbcslot,
198 cmd, 1, 3, resp, 0);
199 }
200
201 static int
202 synaptics_special_write(struct pms_softc *psc, u_char command, u_char arg)
203 {
204 int res = pms_sliced_command(psc->sc_kbctag, psc->sc_kbcslot, arg);
205 if (res)
206 return res;
207
208 u_char cmd[2];
209 cmd[0] = PMS_SET_SAMPLE;
210 cmd[1] = command;
211 res = pckbport_poll_cmd(psc->sc_kbctag, psc->sc_kbcslot,
212 cmd, 2, 0, NULL, 0);
213 return res;
214 }
215
216 static void
217 pms_synaptics_probe_extended(struct pms_softc *psc)
218 {
219 struct synaptics_softc *sc = &psc->u.synaptics;
220 u_char resp[3];
221 int res;
222
223 aprint_debug_dev(psc->sc_dev,
224 "synaptics_probe: Capabilities 0x%04x.\n", sc->caps);
225 if (sc->caps & SYNAPTICS_CAP_PASSTHROUGH)
226 sc->flags |= SYN_FLAG_HAS_PASSTHROUGH;
227
228 if (sc->caps & SYNAPTICS_CAP_PALMDETECT)
229 sc->flags |= SYN_FLAG_HAS_PALM_DETECT;
230
231 if (sc->caps & SYNAPTICS_CAP_MULTIDETECT)
232 sc->flags |= SYN_FLAG_HAS_MULTI_FINGER;
233
234 if (sc->caps & SYNAPTICS_CAP_MULTIFINGERREPORT)
235 sc->flags |= SYN_FLAG_HAS_MULTI_FINGER_REPORT;
236
237 /* Ask about extra buttons to detect up/down. */
238 if (((sc->caps & SYNAPTICS_CAP_EXTNUM) + 0x08)
239 >= SYNAPTICS_EXTENDED_QUERY)
240 {
241 res = synaptics_special_read(psc, SYNAPTICS_EXTENDED_QUERY, resp);
242 if (res == 0) {
243 int buttons = (resp[1] >> 4);
244 aprint_debug_dev(psc->sc_dev,
245 "%s: Extended Buttons: %d.\n", __func__, buttons);
246
247 aprint_debug_dev(psc->sc_dev, "%s: Extended "
248 "Capabilities: 0x%02x 0x%02x 0x%02x.\n", __func__,
249 resp[0], resp[1], resp[2]);
250 if (buttons >= 2) {
251 /* Yes. */
252 sc->flags |= SYN_FLAG_HAS_UP_DOWN_BUTTONS;
253 }
254 if (resp[0] & 0x1) {
255 /* Vertical scroll area */
256 sc->flags |= SYN_FLAG_HAS_VERTICAL_SCROLL;
257 }
258 if (resp[0] & 0x2) {
259 /* Horizontal scroll area */
260 sc->flags |= SYN_FLAG_HAS_HORIZONTAL_SCROLL;
261 }
262 if (resp[0] & 0x4) {
263 /* Extended W-Mode */
264 sc->flags |= SYN_FLAG_HAS_EXTENDED_WMODE;
265 }
266 }
267 }
268
269 /* Ask about click pad */
270 if (((sc->caps & SYNAPTICS_CAP_EXTNUM) + 0x08) >=
271 SYNAPTICS_CONTINUED_CAPABILITIES)
272 {
273 res = synaptics_special_read(psc,
274 SYNAPTICS_CONTINUED_CAPABILITIES, resp);
275
276 /*
277 * The following describes response for the
278 * SYNAPTICS_CONTINUED_CAPABILITIES query.
279 *
280 * byte mask name meaning
281 * ---- ---- ------- ------------
282 * 0 0x01 adjustable threshold capacitive button sensitivity
283 * can be adjusted
284 * 0 0x02 report max query 0x0d gives max coord reported
285 * 0 0x04 clearpad sensor is ClearPad product
286 * 0 0x08 advanced gesture not particularly meaningful
287 * 0 0x10 clickpad bit 0 1-button ClickPad
288 * 0 0x60 multifinger mode identifies firmware finger counting
289 * (not reporting!) algorithm.
290 * Not particularly meaningful
291 * 0 0x80 covered pad W clipped to 14, 15 == pad mostly covered
292 * 1 0x01 clickpad bit 1 2-button ClickPad
293 * 1 0x02 deluxe LED controls touchpad support LED commands
294 * ala multimedia control bar
295 * 1 0x04 reduced filtering firmware does less filtering on
296 * position data, driver should watch
297 * for noise.
298 * 1 0x08 image sensor image sensor tracks 5 fingers, but only
299 * reports 2.
300 * 1 0x10 uniform clickpad whole clickpad moves instead of being
301 * hinged at the top.
302 * 1 0x20 report min query 0x0f gives min coord reported
303 */
304 if (res == 0) {
305 uint val = SYN_CCAP_VALUE(resp);
306
307 aprint_debug_dev(psc->sc_dev, "%s: Continued "
308 "Capabilities 0x%02x 0x%02x 0x%02x.\n", __func__,
309 resp[0], resp[1], resp[2]);
310 switch (SYN_CCAP_CLICKPAD_TYPE(val)) {
311 case 0: /* not a clickpad */
312 break;
313 case 1:
314 sc->flags |= SYN_FLAG_HAS_ONE_BUTTON_CLICKPAD;
315 break;
316 case 2:
317 sc->flags |= SYN_FLAG_HAS_TWO_BUTTON_CLICKPAD;
318 break;
319 case 3: /* reserved */
320 default:
321 /* unreached */
322 break;
323 }
324
325 if ((val & SYN_CCAP_HAS_ADV_GESTURE_MODE))
326 sc->flags |= SYN_FLAG_HAS_ADV_GESTURE_MODE;
327 }
328 }
329 }
330
331 static const struct {
332 int bit;
333 const char *desc;
334 } syn_flags[] = {
335 { SYN_FLAG_HAS_EXTENDED_WMODE, "Extended W mode", },
336 { SYN_FLAG_HAS_PASSTHROUGH, "Passthrough", },
337 { SYN_FLAG_HAS_MIDDLE_BUTTON, "Middle button", },
338 { SYN_FLAG_HAS_BUTTONS_4_5, "Buttons 4/5", },
339 { SYN_FLAG_HAS_UP_DOWN_BUTTONS, "Up/down buttons", },
340 { SYN_FLAG_HAS_PALM_DETECT, "Palm detect", },
341 { SYN_FLAG_HAS_ONE_BUTTON_CLICKPAD, "One button click pad", },
342 { SYN_FLAG_HAS_TWO_BUTTON_CLICKPAD, "Two button click pad", },
343 { SYN_FLAG_HAS_VERTICAL_SCROLL, "Vertical scroll", },
344 { SYN_FLAG_HAS_HORIZONTAL_SCROLL, "Horizontal scroll", },
345 { SYN_FLAG_HAS_MULTI_FINGER_REPORT, "Multi-finger Report", },
346 { SYN_FLAG_HAS_MULTI_FINGER, "Multi-finger", },
347 };
348
349 int
350 pms_synaptics_probe_init(void *vsc)
351 {
352 struct pms_softc *psc = vsc;
353 struct synaptics_softc *sc = &psc->u.synaptics;
354 u_char cmd[1], resp[3];
355 int res, ver_minor, ver_major;
356 struct sysctllog *clog = NULL;
357
358 res = pms_sliced_command(psc->sc_kbctag, psc->sc_kbcslot,
359 SYNAPTICS_IDENTIFY_TOUCHPAD);
360 cmd[0] = PMS_SEND_DEV_STATUS;
361 res |= pckbport_poll_cmd(psc->sc_kbctag, psc->sc_kbcslot, cmd, 1, 3,
362 resp, 0);
363 if (res) {
364 aprint_debug_dev(psc->sc_dev,
365 "synaptics_probe: Identify Touchpad error.\n");
366 /*
367 * Reset device in case the probe confused it.
368 */
369 doreset:
370 (void)synaptics_poll_reset(psc);
371 return res;
372 }
373
374 if (resp[1] != SYNAPTICS_MAGIC_BYTE) {
375 aprint_debug_dev(psc->sc_dev,
376 "synaptics_probe: Not synaptics.\n");
377 res = 1;
378 goto doreset;
379 }
380
381 sc->flags = 0;
382
383 /* Check for minimum version and print a nice message. */
384 ver_major = resp[2] & 0x0f;
385 ver_minor = resp[0];
386 aprint_normal_dev(psc->sc_dev, "Synaptics touchpad version %d.%d\n",
387 ver_major, ver_minor);
388 if (ver_major * 10 + ver_minor < SYNAPTICS_MIN_VERSION) {
389 /* No capability query support. */
390 sc->caps = 0;
391 goto done;
392 }
393
394
395 /* Query the hardware capabilities. */
396 res = synaptics_special_read(psc, SYNAPTICS_READ_CAPABILITIES, resp);
397 if (res) {
398 /* Hmm, failed to get capabilites. */
399 aprint_error_dev(psc->sc_dev,
400 "synaptics_probe: Failed to query capabilities.\n");
401 goto doreset;
402 }
403
404 sc->caps = SYNAPTICS_CAP_VALUE(resp);
405
406 if (sc->caps & SYNAPTICS_CAP_MBUTTON)
407 sc->flags |= SYN_FLAG_HAS_MIDDLE_BUTTON;
408
409 if (sc->caps & SYNAPTICS_CAP_4BUTTON)
410 sc->flags |= SYN_FLAG_HAS_BUTTONS_4_5;
411
412 if (sc->caps & SYNAPTICS_CAP_EXTENDED) {
413 pms_synaptics_probe_extended(psc);
414 }
415
416 if (sc->flags) {
417 const char comma[] = ", ";
418 const char *sep = "";
419 aprint_normal_dev(psc->sc_dev, "");
420 for (size_t f = 0; f < __arraycount(syn_flags); f++) {
421 if (sc->flags & syn_flags[f].bit) {
422 aprint_normal("%s%s", sep, syn_flags[f].desc);
423 sep = comma;
424 }
425 }
426 aprint_normal("\n");
427 }
428
429 done:
430 pms_sysctl_synaptics(&clog);
431 pckbport_set_inputhandler(psc->sc_kbctag, psc->sc_kbcslot,
432 pms_synaptics_input, psc, device_xname(psc->sc_dev));
433
434 return (0);
435 }
436
437 void
438 pms_synaptics_enable(void *vsc)
439 {
440 struct pms_softc *psc = vsc;
441 struct synaptics_softc *sc = &psc->u.synaptics;
442 u_char enable_modes;
443 int res, i;
444
445 if (sc->flags & SYN_FLAG_HAS_PASSTHROUGH) {
446 /*
447 * Extended capability probes can confuse the passthrough
448 * device; reset the touchpad now to cure that.
449 */
450 res = synaptics_poll_reset(psc);
451 }
452
453 /*
454 * Enable Absolute mode with W (width) reporting, and set
455 * the packet rate to maximum (80 packets per second). Enable
456 * extended W mode if supported so we can report second finger
457 * position.
458 */
459 enable_modes =
460 SYNAPTICS_MODE_ABSOLUTE | SYNAPTICS_MODE_W | SYNAPTICS_MODE_RATE;
461
462 if (sc->flags & SYN_FLAG_HAS_EXTENDED_WMODE)
463 enable_modes |= SYNAPTICS_MODE_EXTENDED_W;
464
465 /*
466 * Synaptics documentation says to disable device before
467 * setting mode.
468 */
469 synaptics_poll_cmd(psc, PMS_DEV_DISABLE, 0);
470 /* a couple of set scales to clear out pending commands */
471 for (i = 0; i < 2; i++)
472 synaptics_poll_cmd(psc, PMS_SET_SCALE11, 0);
473
474 res = synaptics_special_write(psc, SYNAPTICS_CMD_SET_MODE2, enable_modes);
475 if (res)
476 aprint_error("synaptics: set mode error\n");
477
478 /* a couple of set scales to clear out pending commands */
479 for (i = 0; i < 2; i++)
480 synaptics_poll_cmd(psc, PMS_SET_SCALE11, 0);
481
482 /* Set advanced gesture mode */
483 if ((sc->flags & SYN_FLAG_HAS_EXTENDED_WMODE) ||
484 (sc->flags & SYN_FLAG_HAS_ADV_GESTURE_MODE))
485 synaptics_special_write(psc, SYNAPTICS_WRITE_DELUXE_3, 0x3);
486
487 synaptics_poll_cmd(psc, PMS_DEV_ENABLE, 0);
488
489 sc->up_down = 0;
490 sc->prev_fingers = 0;
491 sc->gesture_start_x = sc->gesture_start_y = 0;
492 sc->gesture_start_packet = 0;
493 sc->gesture_tap_packet = 0;
494 sc->gesture_type = 0;
495 sc->gesture_buttons = 0;
496 sc->dz_hold = 0;
497 for (i = 0; i < SYN_MAX_FINGERS; i++) {
498 sc->rem_x[i] = sc->rem_y[i] = sc->rem_z[i] = 0;
499 sc->movement_history[i] = 0;
500 }
501 sc->button_history = 0;
502 }
503
504 void
505 pms_synaptics_resume(void *vsc)
506 {
507 (void)synaptics_poll_reset(vsc);
508 }
509
510 static void
511 pms_sysctl_synaptics(struct sysctllog **clog)
512 {
513 int rc, root_num;
514 const struct sysctlnode *node;
515
516 if ((rc = sysctl_createv(clog, 0, NULL, &node,
517 CTLFLAG_PERMANENT, CTLTYPE_NODE, "synaptics",
518 SYSCTL_DESCR("Synaptics touchpad controls"),
519 NULL, 0, NULL, 0, CTL_HW, CTL_CREATE, CTL_EOL)) != 0)
520 goto err;
521
522 root_num = node->sysctl_num;
523
524 if ((rc = sysctl_createv(clog, 0, NULL, &node,
525 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
526 CTLTYPE_INT, "up_down_emulation",
527 SYSCTL_DESCR("Middle button/Z-axis emulation with up/down buttons"),
528 pms_sysctl_synaptics_verify, 0,
529 &synaptics_up_down_emul,
530 0, CTL_HW, root_num, CTL_CREATE,
531 CTL_EOL)) != 0)
532 goto err;
533
534 synaptics_up_down_emul_nodenum = node->sysctl_num;
535
536 if ((rc = sysctl_createv(clog, 0, NULL, &node,
537 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
538 CTLTYPE_INT, "up_down_motion_delta",
539 SYSCTL_DESCR("Up/down button Z-axis emulation rate"),
540 pms_sysctl_synaptics_verify, 0,
541 &synaptics_up_down_motion_delta,
542 0, CTL_HW, root_num, CTL_CREATE,
543 CTL_EOL)) != 0)
544 goto err;
545
546 synaptics_up_down_motion_delta_nodenum = node->sysctl_num;
547
548 if ((rc = sysctl_createv(clog, 0, NULL, &node,
549 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
550 CTLTYPE_INT, "gesture_move",
551 SYSCTL_DESCR("Movement greater than this between taps cancels gesture"),
552 pms_sysctl_synaptics_verify, 0,
553 &synaptics_gesture_move,
554 0, CTL_HW, root_num, CTL_CREATE,
555 CTL_EOL)) != 0)
556 goto err;
557
558 synaptics_gesture_move_nodenum = node->sysctl_num;
559
560 if ((rc = sysctl_createv(clog, 0, NULL, &node,
561 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
562 CTLTYPE_INT, "gesture_length",
563 SYSCTL_DESCR("Time period in which tap is recognised as a gesture"),
564 pms_sysctl_synaptics_verify, 0,
565 &synaptics_gesture_length,
566 0, CTL_HW, root_num, CTL_CREATE,
567 CTL_EOL)) != 0)
568 goto err;
569
570 synaptics_gesture_length_nodenum = node->sysctl_num;
571
572 if ((rc = sysctl_createv(clog, 0, NULL, &node,
573 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
574 CTLTYPE_INT, "edge_left",
575 SYSCTL_DESCR("Define left edge of touchpad"),
576 pms_sysctl_synaptics_verify, 0,
577 &synaptics_edge_left,
578 0, CTL_HW, root_num, CTL_CREATE,
579 CTL_EOL)) != 0)
580 goto err;
581
582 synaptics_edge_left_nodenum = node->sysctl_num;
583
584 if ((rc = sysctl_createv(clog, 0, NULL, &node,
585 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
586 CTLTYPE_INT, "edge_right",
587 SYSCTL_DESCR("Define right edge of touchpad"),
588 pms_sysctl_synaptics_verify, 0,
589 &synaptics_edge_right,
590 0, CTL_HW, root_num, CTL_CREATE,
591 CTL_EOL)) != 0)
592 goto err;
593
594 synaptics_edge_right_nodenum = node->sysctl_num;
595
596 if ((rc = sysctl_createv(clog, 0, NULL, &node,
597 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
598 CTLTYPE_INT, "edge_top",
599 SYSCTL_DESCR("Define top edge of touchpad"),
600 pms_sysctl_synaptics_verify, 0,
601 &synaptics_edge_top,
602 0, CTL_HW, root_num, CTL_CREATE,
603 CTL_EOL)) != 0)
604 goto err;
605
606 synaptics_edge_top_nodenum = node->sysctl_num;
607
608 if ((rc = sysctl_createv(clog, 0, NULL, &node,
609 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
610 CTLTYPE_INT, "edge_bottom",
611 SYSCTL_DESCR("Define bottom edge of touchpad"),
612 pms_sysctl_synaptics_verify, 0,
613 &synaptics_edge_bottom,
614 0, CTL_HW, root_num, CTL_CREATE,
615 CTL_EOL)) != 0)
616 goto err;
617
618 synaptics_edge_bottom_nodenum = node->sysctl_num;
619
620 if ((rc = sysctl_createv(clog, 0, NULL, &node,
621 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
622 CTLTYPE_INT, "edge_motion_delta",
623 SYSCTL_DESCR("Define edge motion rate"),
624 pms_sysctl_synaptics_verify, 0,
625 &synaptics_edge_motion_delta,
626 0, CTL_HW, root_num, CTL_CREATE,
627 CTL_EOL)) != 0)
628 goto err;
629
630 synaptics_edge_motion_delta_nodenum = node->sysctl_num;
631
632 if ((rc = sysctl_createv(clog, 0, NULL, &node,
633 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
634 CTLTYPE_INT, "finger_high",
635 SYSCTL_DESCR("Define finger applied pressure threshold"),
636 pms_sysctl_synaptics_verify, 0,
637 &synaptics_finger_high,
638 0, CTL_HW, root_num, CTL_CREATE,
639 CTL_EOL)) != 0)
640 goto err;
641
642 synaptics_finger_high_nodenum = node->sysctl_num;
643
644 if ((rc = sysctl_createv(clog, 0, NULL, &node,
645 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
646 CTLTYPE_INT, "finger_low",
647 SYSCTL_DESCR("Define finger removed pressure threshold"),
648 pms_sysctl_synaptics_verify, 0,
649 &synaptics_finger_low,
650 0, CTL_HW, root_num, CTL_CREATE,
651 CTL_EOL)) != 0)
652 goto err;
653
654 synaptics_finger_low_nodenum = node->sysctl_num;
655
656 if ((rc = sysctl_createv(clog, 0, NULL, &node,
657 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
658 CTLTYPE_INT, "two_fingers_emulation",
659 SYSCTL_DESCR("Map two fingers to middle button"),
660 pms_sysctl_synaptics_verify, 0,
661 &synaptics_two_fingers_emul,
662 0, CTL_HW, root_num, CTL_CREATE,
663 CTL_EOL)) != 0)
664 goto err;
665
666 synaptics_two_fingers_emul_nodenum = node->sysctl_num;
667
668 if ((rc = sysctl_createv(clog, 0, NULL, &node,
669 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
670 CTLTYPE_INT, "scale_x",
671 SYSCTL_DESCR("Horizontal movement scale factor"),
672 pms_sysctl_synaptics_verify, 0,
673 &synaptics_scale_x,
674 0, CTL_HW, root_num, CTL_CREATE,
675 CTL_EOL)) != 0)
676 goto err;
677
678 synaptics_scale_x_nodenum = node->sysctl_num;
679
680 if ((rc = sysctl_createv(clog, 0, NULL, &node,
681 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
682 CTLTYPE_INT, "scale_y",
683 SYSCTL_DESCR("Vertical movement scale factor"),
684 pms_sysctl_synaptics_verify, 0,
685 &synaptics_scale_y,
686 0, CTL_HW, root_num, CTL_CREATE,
687 CTL_EOL)) != 0)
688 goto err;
689
690 synaptics_scale_y_nodenum = node->sysctl_num;
691
692 if ((rc = sysctl_createv(clog, 0, NULL, &node,
693 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
694 CTLTYPE_INT, "scale_z",
695 SYSCTL_DESCR("Sroll wheel emulation scale factor"),
696 pms_sysctl_synaptics_verify, 0,
697 &synaptics_scale_z,
698 0, CTL_HW, root_num, CTL_CREATE,
699 CTL_EOL)) != 0)
700 goto err;
701
702 synaptics_scale_z_nodenum = node->sysctl_num;
703
704 if ((rc = sysctl_createv(clog, 0, NULL, &node,
705 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
706 CTLTYPE_INT, "max_speed_x",
707 SYSCTL_DESCR("Horizontal movement maximum speed"),
708 pms_sysctl_synaptics_verify, 0,
709 &synaptics_max_speed_x,
710 0, CTL_HW, root_num, CTL_CREATE,
711 CTL_EOL)) != 0)
712 goto err;
713
714 synaptics_max_speed_x_nodenum = node->sysctl_num;
715
716 if ((rc = sysctl_createv(clog, 0, NULL, &node,
717 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
718 CTLTYPE_INT, "max_speed_y",
719 SYSCTL_DESCR("Vertical movement maximum speed"),
720 pms_sysctl_synaptics_verify, 0,
721 &synaptics_max_speed_y,
722 0, CTL_HW, root_num, CTL_CREATE,
723 CTL_EOL)) != 0)
724 goto err;
725
726 synaptics_max_speed_y_nodenum = node->sysctl_num;
727
728 if ((rc = sysctl_createv(clog, 0, NULL, &node,
729 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
730 CTLTYPE_INT, "max_speed_z",
731 SYSCTL_DESCR("Scroll wheel emulation maximum speed"),
732 pms_sysctl_synaptics_verify, 0,
733 &synaptics_max_speed_z,
734 0, CTL_HW, root_num, CTL_CREATE,
735 CTL_EOL)) != 0)
736 goto err;
737
738 synaptics_max_speed_z_nodenum = node->sysctl_num;
739
740 if ((rc = sysctl_createv(clog, 0, NULL, &node,
741 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
742 CTLTYPE_INT, "movement_threshold",
743 SYSCTL_DESCR("Minimum reported movement threshold"),
744 pms_sysctl_synaptics_verify, 0,
745 &synaptics_movement_threshold,
746 0, CTL_HW, root_num, CTL_CREATE,
747 CTL_EOL)) != 0)
748 goto err;
749
750 synaptics_movement_threshold_nodenum = node->sysctl_num;
751
752 if ((rc = sysctl_createv(clog, 0, NULL, &node,
753 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
754 CTLTYPE_INT, "movement_enable",
755 SYSCTL_DESCR("Enable movement reporting"),
756 pms_sysctl_synaptics_verify, 0,
757 &synaptics_movement_enable,
758 0, CTL_HW, root_num, CTL_CREATE,
759 CTL_EOL)) != 0)
760 goto err;
761
762 synaptics_movement_enable_nodenum = node->sysctl_num;
763
764 if ((rc = sysctl_createv(clog, 0, NULL, &node,
765 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
766 CTLTYPE_INT, "button_boundary",
767 SYSCTL_DESCR("Top edge of button area"),
768 pms_sysctl_synaptics_verify, 0,
769 &synaptics_button_boundary,
770 0, CTL_HW, root_num, CTL_CREATE,
771 CTL_EOL)) != 0)
772 goto err;
773
774 synaptics_button_boundary_nodenum = node->sysctl_num;
775
776 if ((rc = sysctl_createv(clog, 0, NULL, &node,
777 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
778 CTLTYPE_INT, "button2_edge",
779 SYSCTL_DESCR("Left edge of button 2 region"),
780 pms_sysctl_synaptics_verify, 0,
781 &synaptics_button2,
782 0, CTL_HW, root_num, CTL_CREATE,
783 CTL_EOL)) != 0)
784 goto err;
785
786 synaptics_button2_nodenum = node->sysctl_num;
787
788 if ((rc = sysctl_createv(clog, 0, NULL, &node,
789 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
790 CTLTYPE_INT, "button3_edge",
791 SYSCTL_DESCR("Left edge of button 3 region"),
792 pms_sysctl_synaptics_verify, 0,
793 &synaptics_button3,
794 0, CTL_HW, root_num, CTL_CREATE,
795 CTL_EOL)) != 0)
796 goto err;
797
798 synaptics_button3_nodenum = node->sysctl_num;
799
800 if ((rc = sysctl_createv(clog, 0, NULL, &node,
801 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
802 CTLTYPE_INT, "finger_scroll-min",
803 SYSCTL_DESCR("Minimum width at which y cursor movements will be converted to scroll wheel events"),
804 pms_sysctl_synaptics_verify, 0,
805 &synaptics_fscroll_min,
806 0, CTL_HW, root_num, CTL_CREATE,
807 CTL_EOL)) != 0)
808 goto err;
809
810 synaptics_finger_scroll_min_nodenum = node->sysctl_num;
811
812 if ((rc = sysctl_createv(clog, 0, NULL, &node,
813 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
814 CTLTYPE_INT, "finger_scroll-max",
815 SYSCTL_DESCR("Maximum width at which y cursor movements will be converted to scroll wheel events"),
816 pms_sysctl_synaptics_verify, 0,
817 &synaptics_fscroll_max,
818 0, CTL_HW, root_num, CTL_CREATE,
819 CTL_EOL)) != 0)
820 goto err;
821
822 synaptics_finger_scroll_max_nodenum = node->sysctl_num;
823
824 if ((rc = sysctl_createv(clog, 0, NULL, &node,
825 CTLFLAG_PERMANENT | CTLFLAG_READWRITE,
826 CTLTYPE_INT, "finger_scroll-hysteresis",
827 SYSCTL_DESCR("Number of packets to keep reporting y cursor movements as scroll wheel events"),
828 pms_sysctl_synaptics_verify, 0,
829 &synaptics_dz_hold,
830 0, CTL_HW, root_num, CTL_CREATE,
831 CTL_EOL)) != 0)
832 goto err;
833
834 synaptics_dz_hold_nodenum = node->sysctl_num;
835 return;
836
837 err:
838 aprint_error("%s: sysctl_createv failed (rc = %d)\n", __func__, rc);
839 }
840
841 static int
842 pms_sysctl_synaptics_verify(SYSCTLFN_ARGS)
843 {
844 int error, t;
845 struct sysctlnode node;
846
847 node = *rnode;
848 t = *(int *)rnode->sysctl_data;
849 node.sysctl_data = &t;
850 error = sysctl_lookup(SYSCTLFN_CALL(&node));
851 if (error || newp == NULL)
852 return error;
853
854 /* Sanity check the params. */
855 if (node.sysctl_num == synaptics_up_down_emul_nodenum) {
856 if (t < 0 || t > 3)
857 return (EINVAL);
858 } else
859 if (node.sysctl_num == synaptics_two_fingers_emul_nodenum) {
860 if (t < 0 || t > 2)
861 return (EINVAL);
862 } else
863 if (node.sysctl_num == synaptics_gesture_length_nodenum ||
864 node.sysctl_num == synaptics_edge_motion_delta_nodenum ||
865 node.sysctl_num == synaptics_up_down_motion_delta_nodenum ||
866 node.sysctl_num == synaptics_max_speed_x_nodenum ||
867 node.sysctl_num == synaptics_max_speed_y_nodenum ||
868 node.sysctl_num == synaptics_max_speed_z_nodenum) {
869 if (t < 0)
870 return (EINVAL);
871 } else
872 if (node.sysctl_num == synaptics_edge_left_nodenum ||
873 node.sysctl_num == synaptics_edge_bottom_nodenum) {
874 if (t < 0 || t > (SYNAPTICS_EDGE_MAX / 2))
875 return (EINVAL);
876 } else
877 if (node.sysctl_num == synaptics_edge_right_nodenum ||
878 node.sysctl_num == synaptics_edge_top_nodenum) {
879 if (t < (SYNAPTICS_EDGE_MAX / 2))
880 return (EINVAL);
881 } else
882 if (node.sysctl_num == synaptics_scale_x_nodenum ||
883 node.sysctl_num == synaptics_scale_y_nodenum ||
884 node.sysctl_num == synaptics_scale_z_nodenum) {
885 if (t < 1 || t > (SYNAPTICS_EDGE_MAX / 4))
886 return (EINVAL);
887 } else
888 if (node.sysctl_num == synaptics_finger_high_nodenum) {
889 if (t < 0 || t > SYNAPTICS_FINGER_PALM ||
890 t < synaptics_finger_low)
891 return (EINVAL);
892 } else
893 if (node.sysctl_num == synaptics_finger_low_nodenum) {
894 if (t < 0 || t > SYNAPTICS_FINGER_PALM ||
895 t > synaptics_finger_high)
896 return (EINVAL);
897 } else
898 if (node.sysctl_num == synaptics_gesture_move_nodenum ||
899 node.sysctl_num == synaptics_movement_threshold_nodenum) {
900 if (t < 0 || t > (SYNAPTICS_EDGE_MAX / 4))
901 return (EINVAL);
902 } else
903 if (node.sysctl_num == synaptics_button_boundary_nodenum) {
904 if (t < 0 || t < SYNAPTICS_EDGE_BOTTOM ||
905 t > SYNAPTICS_EDGE_TOP)
906 return (EINVAL);
907 } else
908 if (node.sysctl_num == synaptics_button2_nodenum ||
909 node.sysctl_num == synaptics_button3_nodenum) {
910 if (t < SYNAPTICS_EDGE_LEFT || t > SYNAPTICS_EDGE_RIGHT)
911 return (EINVAL);
912 } else
913 if (node.sysctl_num == synaptics_finger_scroll_min_nodenum ||
914 node.sysctl_num == synaptics_finger_scroll_max_nodenum) {
915 /* make sure we avoid the "magic" widths, 4 and below
916 are for fingers, 15 is palm detect. */
917 if ((t < 5) || (t > 14))
918 return (EINVAL);
919 } else
920 if (node.sysctl_num == synaptics_dz_hold_nodenum) {
921 if (t < 0)
922 return (EINVAL);
923 } else
924 if (node.sysctl_num == synaptics_movement_enable_nodenum) {
925 if (t < 0 || t > 1)
926 return (EINVAL);
927 } else
928 return (EINVAL);
929
930 *(int *)rnode->sysctl_data = t;
931
932 return (0);
933 }
934
935 /* Masks for the first byte of a packet */
936 #define PMS_LBUTMASK 0x01
937 #define PMS_RBUTMASK 0x02
938 #define PMS_MBUTMASK 0x04
939
940 static void
941 pms_synaptics_parse(struct pms_softc *psc)
942 {
943 struct synaptics_softc *sc = &psc->u.synaptics;
944 struct synaptics_packet sp;
945 char new_buttons, ew_mode;
946
947 memset(&sp, 0, sizeof(sp));
948
949 /* Width of finger */
950 sp.sp_w = ((psc->packet[0] & 0x30) >> 2) +
951 ((psc->packet[0] & 0x04) >> 1) +
952 ((psc->packet[3] & 0x04) >> 2);
953 sp.sp_finger = 0;
954 if ((sc->flags & SYN_FLAG_HAS_EXTENDED_WMODE) &&
955 (sp.sp_w == SYNAPTICS_WIDTH_EXTENDED_W)) {
956 ew_mode = psc->packet[5] >> 4;
957 switch (ew_mode)
958 {
959 case SYNAPTICS_EW_WHEEL:
960 /* scroll wheel report, ignore for now */
961 aprint_debug_dev(psc->sc_dev, "mouse wheel packet\n");
962 return;
963
964 case SYNAPTICS_EW_SECONDARY_FINGER:
965 /* parse the second finger report */
966
967 sp.sp_finger = 1; /* just one other finger for now */
968 sp.sp_x = psc->packet[1]
969 + ((psc->packet[4] & 0x0f) << 8);
970 sp.sp_y = psc->packet[2]
971 + ((psc->packet[4] & 0xf0) << 4);
972 sp.sp_z = (psc->packet[3] & 0x30)
973 + (psc->packet[5] & 0x0f);
974
975 /* keep same buttons down as primary */
976 sp.sp_left = sc->button_history & PMS_LBUTMASK;
977 sp.sp_middle = sc->button_history & PMS_MBUTMASK;
978 sp.sp_right = sc->button_history & PMS_RBUTMASK;
979 break;
980
981 case SYNAPTICS_EW_FINGER_STATUS:
982 /* reports which finger is primary/secondary
983 * ignore for now.
984 */
985 return;
986
987 default:
988 aprint_error_dev(psc->sc_dev,
989 "invalid extended w mode %d\n",
990 ew_mode);
991 return;
992 }
993 } else {
994
995 /* Absolute X/Y coordinates of finger */
996 sp.sp_x = psc->packet[4] + ((psc->packet[1] & 0x0f) << 8) +
997 ((psc->packet[3] & 0x10) << 8);
998 sp.sp_y = psc->packet[5] + ((psc->packet[1] & 0xf0) << 4) +
999 ((psc->packet[3] & 0x20) << 7);
1000
1001 /* Pressure */
1002 sp.sp_z = psc->packet[2];
1003
1004 if ((psc->packet[0] ^ psc->packet[3]) & 0x02) {
1005 /* extended buttons */
1006
1007 aprint_debug_dev(psc->sc_dev,
1008 "synaptics_parse: %02x %02x %02x %02x %02x %02x\n",
1009 psc->packet[0], psc->packet[1], psc->packet[2],
1010 psc->packet[3], psc->packet[4], psc->packet[5]);
1011
1012 if ((psc->packet[4] & SYN_1BUTMASK) != 0)
1013 sp.sp_left = PMS_LBUTMASK;
1014
1015 if ((psc->packet[4] & SYN_3BUTMASK) != 0)
1016 sp.sp_middle = PMS_MBUTMASK;
1017
1018 if ((psc->packet[5] & SYN_2BUTMASK) != 0)
1019 sp.sp_right = PMS_RBUTMASK;
1020
1021 if ((psc->packet[5] & SYN_4BUTMASK) != 0)
1022 sp.sp_up = 1;
1023
1024 if ((psc->packet[4] & SYN_5BUTMASK) != 0)
1025 sp.sp_down = 1;
1026 } else {
1027 /* Left/Right button handling. */
1028 sp.sp_left = psc->packet[0] & PMS_LBUTMASK;
1029 sp.sp_right = psc->packet[0] & PMS_RBUTMASK;
1030 }
1031
1032 /* Up/Down buttons. */
1033 if (sc->flags & SYN_FLAG_HAS_BUTTONS_4_5) {
1034 /* Old up/down buttons. */
1035 sp.sp_up = sp.sp_left ^
1036 (psc->packet[3] & PMS_LBUTMASK);
1037 sp.sp_down = sp.sp_right ^
1038 (psc->packet[3] & PMS_RBUTMASK);
1039 } else if (sc->flags & SYN_FLAG_HAS_UP_DOWN_BUTTONS &&
1040 ((psc->packet[0] & PMS_RBUTMASK) ^
1041 (psc->packet[3] & PMS_RBUTMASK))) {
1042 /* New up/down button. */
1043 sp.sp_up = psc->packet[4] & SYN_1BUTMASK;
1044 sp.sp_down = psc->packet[5] & SYN_2BUTMASK;
1045 } else {
1046 sp.sp_up = 0;
1047 sp.sp_down = 0;
1048 }
1049
1050 new_buttons = 0;
1051 if(sc->flags & SYN_FLAG_HAS_ONE_BUTTON_CLICKPAD) {
1052 /* This is not correctly specified. Read this button press
1053 * from L/U bit. Emulate 3 buttons by checking the
1054 * coordinates of the click and returning the appropriate
1055 * button code. Outside the button region default to a
1056 * left click.
1057 */
1058 u_char bstate = (psc->packet[0] ^ psc->packet[3])
1059 & 0x01;
1060 if (sp.sp_y < synaptics_button_boundary) {
1061 if (sp.sp_x > synaptics_button3) {
1062 sp.sp_right =
1063 bstate ? PMS_RBUTMASK : 0;
1064 } else if (sp.sp_x > synaptics_button2) {
1065 sp.sp_middle =
1066 bstate ? PMS_MBUTMASK : 0;
1067 } else {
1068 sp.sp_left = bstate ? PMS_LBUTMASK : 0;
1069 }
1070 } else
1071 sp.sp_left = bstate ? 1 : 0;
1072 new_buttons = sp.sp_left | sp.sp_middle | sp.sp_right;
1073 if (new_buttons != sc->button_history) {
1074 if (sc->button_history == 0)
1075 sc->button_history = new_buttons;
1076 else if (new_buttons == 0) {
1077 sc->button_history = 0;
1078 /* ensure all buttons are cleared just in
1079 * case finger comes off in a different
1080 * region.
1081 */
1082 sp.sp_left = 0;
1083 sp.sp_middle = 0;
1084 sp.sp_right = 0;
1085 } else {
1086 /* make sure we keep the same button even
1087 * if the finger moves to a different
1088 * region. This precludes chording
1089 * but, oh well.
1090 */
1091 sp.sp_left = sc->button_history & PMS_LBUTMASK;
1092 sp.sp_middle = sc->button_history
1093 & PMS_MBUTMASK;
1094 sp.sp_right = sc->button_history & PMS_RBUTMASK;
1095 }
1096 }
1097 } else if (sc->flags & SYN_FLAG_HAS_MIDDLE_BUTTON) {
1098 /* Old style Middle Button. */
1099 sp.sp_middle = (psc->packet[0] & PMS_LBUTMASK) ^
1100 (psc->packet[3] & PMS_LBUTMASK);
1101 } else if (synaptics_up_down_emul != 1) {
1102 sp.sp_middle = 0;
1103 }
1104
1105 switch (synaptics_up_down_emul) {
1106 case 1:
1107 /* Do middle button emulation using up/down buttons */
1108 sp.sp_middle = sp.sp_up | sp.sp_down;
1109 sp.sp_up = sp.sp_down = 0;
1110 break;
1111 case 3:
1112 /* Do left/right button emulation using up/down buttons */
1113 sp.sp_left = sp.sp_up;
1114 sp.sp_right = sp.sp_down;
1115 sp.sp_up = sp.sp_down = 0;
1116 break;
1117 default:
1118 /*
1119 * Don't do any remapping...
1120 * Z-axis emulation is handled in pms_synaptics_process_packet
1121 */
1122 break;
1123 }
1124 }
1125
1126 pms_synaptics_process_packet(psc, &sp);
1127 }
1128
1129 static void
1130 pms_synaptics_passthrough(struct pms_softc *psc)
1131 {
1132 int dx, dy, dz;
1133 int buttons, changed;
1134 int s;
1135
1136 buttons = ((psc->packet[1] & PMS_LBUTMASK) ? 0x20 : 0) |
1137 ((psc->packet[1] & PMS_MBUTMASK) ? 0x40 : 0) |
1138 ((psc->packet[1] & PMS_RBUTMASK) ? 0x80 : 0);
1139
1140 dx = psc->packet[4];
1141 if (dx >= 128)
1142 dx -= 256;
1143 if (dx == -128)
1144 dx = -127;
1145
1146 dy = psc->packet[5];
1147 if (dy >= 128)
1148 dy -= 256;
1149 if (dy == -128)
1150 dy = -127;
1151
1152 dz = 0;
1153
1154 changed = buttons ^ (psc->buttons & 0xe0);
1155 psc->buttons ^= changed;
1156
1157 if (dx || dy || dz || changed) {
1158 buttons = (psc->buttons & 0x1f) | ((psc->buttons >> 5) & 0x7);
1159 s = spltty();
1160 wsmouse_input(psc->sc_wsmousedev,
1161 buttons, dx, dy, dz, 0,
1162 WSMOUSE_INPUT_DELTA);
1163 splx(s);
1164 }
1165 }
1166
1167 static void
1168 pms_synaptics_input(void *vsc, int data)
1169 {
1170 struct pms_softc *psc = vsc;
1171 struct timeval diff;
1172
1173 if (!psc->sc_enabled) {
1174 /* Interrupts are not expected. Discard the byte. */
1175 return;
1176 }
1177
1178 getmicrouptime(&psc->current);
1179
1180 if (psc->inputstate != 0) {
1181 timersub(&psc->current, &psc->last, &diff);
1182 if (diff.tv_sec > 0 || diff.tv_usec >= 40000) {
1183 aprint_debug_dev(psc->sc_dev,
1184 "pms_synaptics_input: unusual delay (%ld.%06ld s), "
1185 "scheduling reset\n",
1186 (long)diff.tv_sec, (long)diff.tv_usec);
1187 printf("pms_synaptics_input: unusual delay (%ld.%06ld s), "
1188 "scheduling reset\n",
1189 (long)diff.tv_sec, (long)diff.tv_usec);
1190 psc->inputstate = 0;
1191 psc->sc_enabled = 0;
1192 wakeup(&psc->sc_enabled);
1193 return;
1194 }
1195 }
1196 psc->last = psc->current;
1197
1198 switch (psc->inputstate) {
1199 case -5:
1200 case -4:
1201 case -3:
1202 case -2:
1203 case -1:
1204 case 0:
1205 if ((data & 0xc8) != 0x80) {
1206 aprint_debug_dev(psc->sc_dev,
1207 "pms_synaptics_input: 0x%02x out of sync\n", data);
1208 /* use negative counts to limit resync phase */
1209 psc->inputstate--;
1210 return; /* not in sync yet, discard input */
1211 }
1212 psc->inputstate = 0;
1213 /*FALLTHROUGH*/
1214
1215 case -6:
1216 case 3:
1217 if ((data & 8) == 8) {
1218 aprint_debug_dev(psc->sc_dev,
1219 "pms_synaptics_input: dropped in relative mode, reset\n");
1220 psc->inputstate = 0;
1221 psc->sc_enabled = 0;
1222 wakeup(&psc->sc_enabled);
1223 return;
1224 }
1225 }
1226
1227 psc->packet[psc->inputstate++] = data & 0xff;
1228 if (psc->inputstate == 6) {
1229 /*
1230 * We have a complete packet.
1231 * Extract the pertinent details.
1232 */
1233 psc->inputstate = 0;
1234 if ((psc->packet[0] & 0xfc) == 0x84 &&
1235 (psc->packet[3] & 0xcc) == 0xc4) {
1236 /* W = SYNAPTICS_WIDTH_PASSTHROUGH, PS/2 passthrough */
1237 pms_synaptics_passthrough(psc);
1238 } else {
1239 pms_synaptics_parse(psc);
1240 }
1241 }
1242 }
1243
1244 static inline int
1245 synaptics_finger_detect(struct synaptics_softc *sc, struct synaptics_packet *sp,
1246 int *palmp)
1247 {
1248 int fingers;
1249
1250 /* Assume no palm */
1251 *palmp = 0;
1252
1253 /*
1254 * Apply some hysteresis when checking for a finger.
1255 * When the finger is first applied, we ignore it until the
1256 * pressure exceeds the 'high' threshold. The finger is considered
1257 * removed only when pressure falls beneath the 'low' threshold.
1258 */
1259 if ((sc->prev_fingers == 0 && sp->sp_z > synaptics_finger_high) ||
1260 (sc->prev_fingers != 0 && sp->sp_z > synaptics_finger_low))
1261 fingers = 1;
1262 else
1263 fingers = 0;
1264
1265 /*
1266 * If the pad can't do palm detection, skip the rest.
1267 */
1268 if (fingers == 0 || (sc->flags & SYN_FLAG_HAS_PALM_DETECT) == 0)
1269 return (fingers);
1270
1271 /*
1272 * Palm detection
1273 */
1274 if (sp->sp_z > SYNAPTICS_FINGER_FLAT &&
1275 sp->sp_w >= SYNAPTICS_WIDTH_PALM_MIN)
1276 *palmp = 1;
1277
1278 if (sc->prev_fingers == 0 &&
1279 (sp->sp_z > SYNAPTICS_FINGER_FLAT ||
1280 sp->sp_w >= SYNAPTICS_WIDTH_PALM_MIN)) {
1281 /*
1282 * Contact area or pressure is too great to be a finger.
1283 * Just ignore it for now.
1284 */
1285 return (0);
1286 }
1287
1288 /*
1289 * Detect 2 and 3 fingers if supported, but only if multiple
1290 * fingers appear within the tap gesture time period.
1291 */
1292 if (sc->flags & SYN_FLAG_HAS_MULTI_FINGER &&
1293 SYN_TIME(sc, sc->gesture_start_packet,
1294 sp->sp_finger) < synaptics_gesture_length) {
1295 switch (sp->sp_w) {
1296 case SYNAPTICS_WIDTH_TWO_FINGERS:
1297 fingers = 2;
1298 break;
1299
1300 case SYNAPTICS_WIDTH_THREE_OR_MORE:
1301 fingers = 3;
1302 break;
1303
1304 default:
1305 /*
1306 * The width value can report spurious single-finger
1307 * events after a multi-finger event.
1308 */
1309 fingers = sc->prev_fingers <= 1 ? 1 : sc->prev_fingers;
1310 break;
1311 }
1312 }
1313
1314 return (fingers);
1315 }
1316
1317 static inline void
1318 synaptics_gesture_detect(struct synaptics_softc *sc,
1319 struct synaptics_packet *sp, int fingers)
1320 {
1321 int gesture_len, gesture_buttons;
1322 int set_buttons;
1323
1324 gesture_len = SYN_TIME(sc, sc->gesture_start_packet, sp->sp_finger);
1325 gesture_buttons = sc->gesture_buttons;
1326
1327 if (fingers > 0 && (fingers == sc->prev_fingers)) {
1328 /* Finger is still present */
1329 sc->gesture_move_x = abs(sc->gesture_start_x - sp->sp_x);
1330 sc->gesture_move_y = abs(sc->gesture_start_y - sp->sp_y);
1331 } else
1332 if (fingers && sc->prev_fingers == 0) {
1333 /*
1334 * Finger was just applied.
1335 * If the previous gesture was a single-click, set things
1336 * up to deal with a possible drag or double-click gesture.
1337 * Basically, if the finger is removed again within
1338 * 'synaptics_gesture_length' packets, this is treated
1339 * as a double-click. Otherwise we will emulate holding
1340 * the left button down whilst dragging the mouse.
1341 */
1342 if (SYN_IS_SINGLE_TAP(sc->gesture_type))
1343 sc->gesture_type |= SYN_GESTURE_DRAG;
1344
1345 sc->gesture_start_x = abs(sp->sp_x);
1346 sc->gesture_start_y = abs(sp->sp_y);
1347 sc->gesture_move_x = 0;
1348 sc->gesture_move_y = 0;
1349 sc->gesture_start_packet = sc->total_packets[0];
1350
1351 #ifdef DIAGNOSTIC
1352 aprint_debug("Finger applied: gesture_start_x: %d gesture_start_y: %d\n",
1353 sc->gesture_start_x, sc->gesture_start_y);
1354 #endif
1355 } else
1356 if (fingers == 0 && sc->prev_fingers != 0) {
1357 /*
1358 * Finger was just removed.
1359 * Check if the contact time and finger movement were
1360 * small enough to qualify as a gesture.
1361 * Ignore finger movement if multiple fingers were
1362 * detected (the pad may report coordinates for any
1363 * of the fingers).
1364 */
1365
1366 #ifdef DIAGNOSTIC
1367 aprint_debug("Finger removed: gesture_len: %d (%d)\n",
1368 gesture_len, synaptics_gesture_length);
1369 aprint_debug("gesture_move_x: %d (%d) sp_x: %d\n",
1370 sc->gesture_move_x, synaptics_gesture_move, abs(sp->sp_x));
1371 aprint_debug("gesture_move_y: %d (%d) sp_y: %d\n",
1372 sc->gesture_move_y, synaptics_gesture_move, abs(sp->sp_y));
1373 #endif
1374
1375 if (gesture_len < synaptics_gesture_length &&
1376 ((sc->gesture_move_x < synaptics_gesture_move &&
1377 sc->gesture_move_y < synaptics_gesture_move))) {
1378 /*
1379 * Looking good so far.
1380 */
1381 if (SYN_IS_DRAG(sc->gesture_type)) {
1382 /*
1383 * Promote this gesture to double-click.
1384 */
1385 sc->gesture_type |= SYN_GESTURE_DOUBLE;
1386 sc->gesture_type &= ~SYN_GESTURE_SINGLE;
1387 } else {
1388 /*
1389 * Single tap gesture. Set the tap length timer
1390 * and flag a single-click.
1391 */
1392 sc->gesture_tap_packet = sc->total_packets[0];
1393 sc->gesture_type |= SYN_GESTURE_SINGLE;
1394
1395 /*
1396 * The gesture can be modified depending on
1397 * the number of fingers detected.
1398 *
1399 * 1: Normal left button emulation.
1400 * 2: Either middle button or right button
1401 * depending on the value of the two_fingers
1402 * sysctl variable.
1403 * 3: Right button.
1404 */
1405 switch (sc->prev_fingers) {
1406 case 2:
1407 if (synaptics_two_fingers_emul == 1)
1408 gesture_buttons |= PMS_RBUTMASK;
1409 else
1410 if (synaptics_two_fingers_emul == 2)
1411 gesture_buttons |= PMS_MBUTMASK;
1412 break;
1413 case 3:
1414 gesture_buttons |= PMS_RBUTMASK;
1415 break;
1416 default:
1417 gesture_buttons |= PMS_LBUTMASK;
1418 break;
1419 }
1420 }
1421 }
1422
1423 /*
1424 * Always clear drag state when the finger is removed.
1425 */
1426 sc->gesture_type &= ~SYN_GESTURE_DRAG;
1427 }
1428
1429 if (sc->gesture_type == 0) {
1430 /*
1431 * There is no gesture in progress.
1432 * Clear emulated button state.
1433 */
1434 sc->gesture_buttons = 0;
1435 return;
1436 }
1437
1438 /*
1439 * A gesture is in progress.
1440 */
1441 set_buttons = 0;
1442
1443 if (SYN_IS_SINGLE_TAP(sc->gesture_type)) {
1444 /*
1445 * Single-click.
1446 * Activate the relevant button(s) until the
1447 * gesture tap timer has expired.
1448 */
1449 if (SYN_TIME(sc, sc->gesture_tap_packet, sp->sp_finger) <
1450 synaptics_gesture_length)
1451 set_buttons = 1;
1452 else
1453 sc->gesture_type &= ~SYN_GESTURE_SINGLE;
1454 } else
1455 if (SYN_IS_DOUBLE_TAP(sc->gesture_type) && sc->prev_fingers == 0) {
1456 /*
1457 * Double-click.
1458 * Activate the relevant button(s) once.
1459 */
1460 set_buttons = 1;
1461 sc->gesture_type &= ~SYN_GESTURE_DOUBLE;
1462 }
1463
1464 if (set_buttons || SYN_IS_DRAG(sc->gesture_type)) {
1465 /*
1466 * Single-click and drag.
1467 * Maintain button state until the finger is removed.
1468 */
1469 sp->sp_left |= gesture_buttons & PMS_LBUTMASK;
1470 sp->sp_right |= gesture_buttons & PMS_RBUTMASK;
1471 sp->sp_middle |= gesture_buttons & PMS_MBUTMASK;
1472 }
1473
1474 sc->gesture_buttons = gesture_buttons;
1475 }
1476
1477 static inline int
1478 synaptics_filter_policy(struct synaptics_softc *sc, int finger, int *history,
1479 int value)
1480 {
1481 int a, b, rv, count;
1482
1483 count = sc->total_packets[finger];
1484
1485 /*
1486 * Once we've accumulated at least SYN_HIST_SIZE values, combine
1487 * each new value with the previous two and return the average.
1488 *
1489 * This is necessary when the touchpad is operating in 80 packets
1490 * per second mode, as it performs little internal filtering on
1491 * reported values.
1492 *
1493 * Using a rolling average helps to filter out jitter caused by
1494 * tiny finger movements.
1495 */
1496 if (sc->movement_history[finger] >= SYN_HIST_SIZE) {
1497 a = (history[(count + 0) % SYN_HIST_SIZE] +
1498 history[(count + 1) % SYN_HIST_SIZE]) / 2;
1499
1500 b = (value + history[(count + 0) % SYN_HIST_SIZE]) / 2;
1501
1502 rv = b - a;
1503
1504 /*
1505 * Don't report the movement if it's below a certain
1506 * threshold.
1507 */
1508 if (abs(rv) < synaptics_movement_threshold)
1509 rv = 0;
1510 } else
1511 rv = 0;
1512
1513 /*
1514 * Add the new value to the history buffer.
1515 */
1516 history[(count + 1) % SYN_HIST_SIZE] = value;
1517
1518 return (rv);
1519 }
1520
1521 /* Edge detection */
1522 #define SYN_EDGE_TOP 1
1523 #define SYN_EDGE_BOTTOM 2
1524 #define SYN_EDGE_LEFT 4
1525 #define SYN_EDGE_RIGHT 8
1526
1527 static inline int
1528 synaptics_check_edge(int x, int y)
1529 {
1530 int rv = 0;
1531
1532 if (x < synaptics_edge_left)
1533 rv |= SYN_EDGE_LEFT;
1534 else
1535 if (x > synaptics_edge_right)
1536 rv |= SYN_EDGE_RIGHT;
1537
1538 if (y < synaptics_edge_bottom)
1539 rv |= SYN_EDGE_BOTTOM;
1540 else
1541 if (y > synaptics_edge_top)
1542 rv |= SYN_EDGE_TOP;
1543
1544 return (rv);
1545 }
1546
1547 static inline int
1548 synaptics_edge_motion(struct synaptics_softc *sc, int delta, int dir)
1549 {
1550
1551 /*
1552 * When edge motion is enabled, synaptics_edge_motion_delta is
1553 * combined with the current delta, together with the direction
1554 * in which to simulate the motion. The result is added to
1555 * the delta derived from finger movement. This provides a smooth
1556 * transition from finger movement to edge motion.
1557 */
1558 delta = synaptics_edge_motion_delta + (dir * delta);
1559 if (delta < 0)
1560 return (0);
1561 if (delta > synaptics_edge_motion_delta)
1562 return (synaptics_edge_motion_delta);
1563 return (delta);
1564 }
1565
1566 static inline int
1567 synaptics_scale(int delta, int scale, int *remp)
1568 {
1569 int rv;
1570
1571 /*
1572 * Scale the raw delta in Synaptics coordinates (0-6143) into
1573 * something more reasonable by dividing the raw delta by a
1574 * scale factor. Any remainder from the previous scale result
1575 * is added to the current delta before scaling.
1576 * This prevents loss of resolution for very small/slow
1577 * movements of the finger.
1578 */
1579 delta += *remp;
1580 rv = delta / scale;
1581 *remp = delta % scale;
1582
1583 return (rv);
1584 }
1585
1586 static inline void
1587 synaptics_movement(struct synaptics_softc *sc, struct synaptics_packet *sp,
1588 int finger, int scroll_emul, int *dxp, int *dyp, int *dzp)
1589 {
1590 int dx, dy, dz, edge;
1591
1592 dx = dy = dz = 0;
1593
1594 /*
1595 * Compute the next values of dx and dy and dz. If scroll_emul
1596 * is non-zero, take the dy and used it as use it as dz so we
1597 * can emulate a scroll wheel.
1598 */
1599 if (scroll_emul == 0) {
1600 dx = synaptics_filter_policy(sc, finger, sc->history_x[finger],
1601 sp->sp_x);
1602 dy = synaptics_filter_policy(sc, finger, sc->history_y[finger],
1603 sp->sp_y);
1604 } else {
1605 dz = synaptics_filter_policy(sc, finger, sc->history_z[finger],
1606 sp->sp_y);
1607 dx = dy = 0;
1608 }
1609
1610 /*
1611 * If we're dealing with a drag gesture, and the finger moves to
1612 * the edge of the touchpad, apply edge motion emulation if it
1613 * is enabled.
1614 */
1615 if (synaptics_edge_motion_delta && SYN_IS_DRAG(sc->gesture_type)) {
1616 edge = synaptics_check_edge(sp->sp_x, sp->sp_y);
1617
1618 if (edge & SYN_EDGE_LEFT)
1619 dx -= synaptics_edge_motion(sc, dx, 1);
1620 if (edge & SYN_EDGE_RIGHT)
1621 dx += synaptics_edge_motion(sc, dx, -1);
1622 if (edge & SYN_EDGE_BOTTOM)
1623 dy -= synaptics_edge_motion(sc, dy, 1);
1624 if (edge & SYN_EDGE_TOP)
1625 dy += synaptics_edge_motion(sc, dy, -1);
1626 }
1627
1628 /*
1629 * Apply scaling to the deltas
1630 */
1631 dx = synaptics_scale(dx, synaptics_scale_x, &sc->rem_x[finger]);
1632 dy = synaptics_scale(dy, synaptics_scale_y, &sc->rem_y[finger]);
1633 dz = synaptics_scale(dz, synaptics_scale_z, &sc->rem_z[finger]);
1634
1635 /*
1636 * Clamp deltas to specified maximums.
1637 */
1638 if (abs(dx) > synaptics_max_speed_x)
1639 dx = ((dx >= 0)? 1 : -1) * synaptics_max_speed_x;
1640 if (abs(dy) > synaptics_max_speed_y)
1641 dy = ((dy >= 0)? 1 : -1) * synaptics_max_speed_y;
1642 if (abs(dz) > synaptics_max_speed_z)
1643 dz = ((dz >= 0)? 1 : -1) * synaptics_max_speed_z;
1644
1645 *dxp = dx;
1646 *dyp = dy;
1647 *dzp = dz;
1648
1649 sc->movement_history[finger]++;
1650 }
1651
1652 static void
1653 pms_synaptics_process_packet(struct pms_softc *psc, struct synaptics_packet *sp)
1654 {
1655 struct synaptics_softc *sc = &psc->u.synaptics;
1656 int dx, dy, dz;
1657 int fingers, palm, buttons, changed;
1658 int s, z_emul;
1659
1660 /*
1661 * Do Z-axis emulation using up/down buttons if required.
1662 * Note that the pad will send a one second burst of packets
1663 * when an up/down button is pressed and held. At the moment
1664 * we don't deal with auto-repeat, so convert the burst into
1665 * a one-shot.
1666 */
1667 dz = 0;
1668 if (synaptics_up_down_emul == 2) {
1669 if (sc->up_down == 0) {
1670 if (sp->sp_up && sp->sp_down) {
1671 /*
1672 * Most up/down buttons will be actuated using
1673 * a rocker switch, so we should never see
1674 * them both simultaneously. But just in case,
1675 * treat this situation as a middle button
1676 * event.
1677 */
1678 sp->sp_middle = 1;
1679 } else
1680 if (sp->sp_up)
1681 dz = -synaptics_up_down_motion_delta;
1682 else
1683 if (sp->sp_down)
1684 dz = synaptics_up_down_motion_delta;
1685 }
1686
1687 sc->up_down = sp->sp_up | sp->sp_down;
1688 sp->sp_up = sp->sp_down = 0;
1689 }
1690
1691 /*
1692 * Determine whether or not a finger is on the pad.
1693 * On some pads, this will return the number of fingers
1694 * detected.
1695 */
1696 fingers = synaptics_finger_detect(sc, sp, &palm);
1697
1698 /*
1699 * Do gesture processing only if we didn't detect a palm and
1700 * it is not the seondary finger.
1701 */
1702 if ((sp->sp_finger == 0) && (palm == 0))
1703 synaptics_gesture_detect(sc, sp, fingers);
1704 else
1705 sc->gesture_type = sc->gesture_buttons = 0;
1706
1707 /*
1708 * Determine what buttons to report
1709 */
1710 buttons = (sp->sp_left ? 0x1 : 0) |
1711 (sp->sp_middle ? 0x2 : 0) |
1712 (sp->sp_right ? 0x4 : 0) |
1713 (sp->sp_up ? 0x8 : 0) |
1714 (sp->sp_down ? 0x10 : 0);
1715 changed = buttons ^ (psc->buttons & 0x1f);
1716 psc->buttons ^= changed;
1717
1718 sc->prev_fingers = fingers;
1719 sc->total_packets[sp->sp_finger]++;
1720
1721 /*
1722 * Do movement processing IFF we have a single finger and no palm or
1723 * a secondary finger and no palm.
1724 */
1725 if (palm == 0 && synaptics_movement_enable) {
1726 if (fingers == 1) {
1727 z_emul = 0;
1728
1729 if ((sp->sp_w >= synaptics_fscroll_min) &&
1730 (sp->sp_w <= synaptics_fscroll_max)) {
1731 z_emul = 1;
1732 sc->dz_hold = synaptics_dz_hold;
1733 }
1734
1735 if (sc->dz_hold > 0) {
1736 z_emul = 1;
1737 }
1738
1739 synaptics_movement(sc, sp, sp->sp_finger,
1740 z_emul, &dx, &dy, &dz);
1741 } else {
1742 /*
1743 * No valid finger. Therefore no movement.
1744 */
1745 sc->movement_history[sp->sp_finger] = 0;
1746 sc->rem_x[sp->sp_finger] = sc->rem_y[sp->sp_finger] = 0;
1747 dx = dy = 0;
1748 }
1749 } else {
1750 /*
1751 * No valid finger. Therefore no movement.
1752 */
1753 sc->movement_history[0] = 0;
1754 sc->rem_x[0] = sc->rem_y[0] = sc->rem_z[0] = 0;
1755 dx = dy = dz = 0;
1756 }
1757
1758 if (sc->dz_hold > 0)
1759 sc->dz_hold--;
1760
1761 /*
1762 * Pass the final results up to wsmouse_input() if necessary.
1763 */
1764 if (dx || dy || dz || changed) {
1765 buttons = (psc->buttons & 0x1f) | ((psc->buttons >> 5) & 0x7);
1766 s = spltty();
1767 wsmouse_input(psc->sc_wsmousedev,
1768 buttons,
1769 dx, dy, dz, 0,
1770 WSMOUSE_INPUT_DELTA);
1771 splx(s);
1772 }
1773 }
1774