2 * Apple "Magic" Wireless Mouse driver
4 * Copyright (c) 2010 Michael Poole <mdpoole@troilus.org>
5 * Copyright (c) 2010 Chase Douglas <chase.douglas@canonical.com>
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU General Public License as published by the Free
11 * Software Foundation; either version 2 of the License, or (at your option)
15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
17 #include <linux/device.h>
18 #include <linux/hid.h>
19 #include <linux/input/mt.h>
20 #include <linux/module.h>
21 #include <linux/slab.h>
22 #include <linux/usb.h>
26 static bool emulate_3button
= true;
27 module_param(emulate_3button
, bool, 0644);
28 MODULE_PARM_DESC(emulate_3button
, "Emulate a middle button");
30 static int middle_button_start
= -350;
31 static int middle_button_stop
= +350;
33 static bool emulate_scroll_wheel
= true;
34 module_param(emulate_scroll_wheel
, bool, 0644);
35 MODULE_PARM_DESC(emulate_scroll_wheel
, "Emulate a scroll wheel");
37 static unsigned int scroll_speed
= 32;
38 static int param_set_scroll_speed(const char *val
, struct kernel_param
*kp
) {
40 if (!val
|| strict_strtoul(val
, 0, &speed
) || speed
> 63)
45 module_param_call(scroll_speed
, param_set_scroll_speed
, param_get_uint
, &scroll_speed
, 0644);
46 MODULE_PARM_DESC(scroll_speed
, "Scroll speed, value from 0 (slow) to 63 (fast)");
48 static bool scroll_acceleration
= false;
49 module_param(scroll_acceleration
, bool, 0644);
50 MODULE_PARM_DESC(scroll_acceleration
, "Accelerate sequential scroll events");
52 static bool report_undeciphered
;
53 module_param(report_undeciphered
, bool, 0644);
54 MODULE_PARM_DESC(report_undeciphered
, "Report undeciphered multi-touch state field using a MSC_RAW event");
56 #define TRACKPAD_REPORT_ID 0x28
57 #define MOUSE_REPORT_ID 0x29
58 #define DOUBLE_REPORT_ID 0xf7
59 /* These definitions are not precise, but they're close enough. (Bits
60 * 0x03 seem to indicate the aspect ratio of the touch, bits 0x70 seem
61 * to be some kind of bit mask -- 0x20 may be a near-field reading,
62 * and 0x40 is actual contact, and 0x10 may be a start/stop or change
65 #define TOUCH_STATE_MASK 0xf0
66 #define TOUCH_STATE_NONE 0x00
67 #define TOUCH_STATE_START 0x30
68 #define TOUCH_STATE_DRAG 0x40
70 #define SCROLL_ACCEL_DEFAULT 7
72 /* Touch surface information. Dimension is in hundredths of a mm, min and max
74 #define MOUSE_DIMENSION_X (float)9056
75 #define MOUSE_MIN_X -1100
76 #define MOUSE_MAX_X 1258
77 #define MOUSE_RES_X ((MOUSE_MAX_X - MOUSE_MIN_X) / (MOUSE_DIMENSION_X / 100))
78 #define MOUSE_DIMENSION_Y (float)5152
79 #define MOUSE_MIN_Y -1589
80 #define MOUSE_MAX_Y 2047
81 #define MOUSE_RES_Y ((MOUSE_MAX_Y - MOUSE_MIN_Y) / (MOUSE_DIMENSION_Y / 100))
83 #define TRACKPAD_DIMENSION_X (float)13000
84 #define TRACKPAD_MIN_X -2909
85 #define TRACKPAD_MAX_X 3167
86 #define TRACKPAD_RES_X \
87 ((TRACKPAD_MAX_X - TRACKPAD_MIN_X) / (TRACKPAD_DIMENSION_X / 100))
88 #define TRACKPAD_DIMENSION_Y (float)11000
89 #define TRACKPAD_MIN_Y -2456
90 #define TRACKPAD_MAX_Y 2565
91 #define TRACKPAD_RES_Y \
92 ((TRACKPAD_MAX_Y - TRACKPAD_MIN_Y) / (TRACKPAD_DIMENSION_Y / 100))
95 * struct magicmouse_sc - Tracks Magic Mouse-specific data.
96 * @input: Input device through which we report events.
97 * @quirks: Currently unused.
98 * @ntouches: Number of touches in most recent touch report.
99 * @scroll_accel: Number of consecutive scroll motions.
100 * @scroll_jiffies: Time of last scroll motion.
101 * @touches: Most recent data for a touch, indexed by tracking ID.
102 * @tracking_ids: Mapping of current touch input data to @touches.
104 struct magicmouse_sc
{
105 struct input_dev
*input
;
106 unsigned long quirks
;
110 unsigned long scroll_jiffies
;
119 int tracking_ids
[16];
122 static int magicmouse_firm_touch(struct magicmouse_sc
*msc
)
127 /* If there is only one "firm" touch, set touch to its
130 for (ii
= 0; ii
< msc
->ntouches
; ii
++) {
131 int idx
= msc
->tracking_ids
[ii
];
132 if (msc
->touches
[idx
].size
< 8) {
133 /* Ignore this touch. */
134 } else if (touch
>= 0) {
145 static void magicmouse_emit_buttons(struct magicmouse_sc
*msc
, int state
)
147 int last_state
= test_bit(BTN_LEFT
, msc
->input
->key
) << 0 |
148 test_bit(BTN_RIGHT
, msc
->input
->key
) << 1 |
149 test_bit(BTN_MIDDLE
, msc
->input
->key
) << 2;
151 if (emulate_3button
) {
154 /* If some button was pressed before, keep it held
155 * down. Otherwise, if there's exactly one firm
156 * touch, use that to override the mouse's guess.
159 /* The button was released. */
160 } else if (last_state
!= 0) {
162 } else if ((id
= magicmouse_firm_touch(msc
)) >= 0) {
163 int x
= msc
->touches
[id
].x
;
164 if (x
< middle_button_start
)
166 else if (x
> middle_button_stop
)
170 } /* else: we keep the mouse's guess */
172 input_report_key(msc
->input
, BTN_MIDDLE
, state
& 4);
175 input_report_key(msc
->input
, BTN_LEFT
, state
& 1);
176 input_report_key(msc
->input
, BTN_RIGHT
, state
& 2);
178 if (state
!= last_state
)
179 msc
->scroll_accel
= SCROLL_ACCEL_DEFAULT
;
182 static void magicmouse_emit_touch(struct magicmouse_sc
*msc
, int raw_id
, u8
*tdata
)
184 struct input_dev
*input
= msc
->input
;
185 int id
, x
, y
, size
, orientation
, touch_major
, touch_minor
, state
, down
;
187 if (input
->id
.product
== USB_DEVICE_ID_APPLE_MAGICMOUSE
) {
188 id
= (tdata
[6] << 2 | tdata
[5] >> 6) & 0xf;
189 x
= (tdata
[1] << 28 | tdata
[0] << 20) >> 20;
190 y
= -((tdata
[2] << 24 | tdata
[1] << 16) >> 20);
191 size
= tdata
[5] & 0x3f;
192 orientation
= (tdata
[6] >> 2) - 32;
193 touch_major
= tdata
[3];
194 touch_minor
= tdata
[4];
195 state
= tdata
[7] & TOUCH_STATE_MASK
;
196 down
= state
!= TOUCH_STATE_NONE
;
197 } else { /* USB_DEVICE_ID_APPLE_MAGICTRACKPAD */
198 id
= (tdata
[7] << 2 | tdata
[6] >> 6) & 0xf;
199 x
= (tdata
[1] << 27 | tdata
[0] << 19) >> 19;
200 y
= -((tdata
[3] << 30 | tdata
[2] << 22 | tdata
[1] << 14) >> 19);
201 size
= tdata
[6] & 0x3f;
202 orientation
= (tdata
[7] >> 2) - 32;
203 touch_major
= tdata
[4];
204 touch_minor
= tdata
[5];
205 state
= tdata
[8] & TOUCH_STATE_MASK
;
206 down
= state
!= TOUCH_STATE_NONE
;
209 /* Store tracking ID and other fields. */
210 msc
->tracking_ids
[raw_id
] = id
;
211 msc
->touches
[id
].x
= x
;
212 msc
->touches
[id
].y
= y
;
213 msc
->touches
[id
].size
= size
;
215 /* If requested, emulate a scroll wheel by detecting small
216 * vertical touch motions.
218 if (emulate_scroll_wheel
) {
219 unsigned long now
= jiffies
;
220 int step_x
= msc
->touches
[id
].scroll_x
- x
;
221 int step_y
= msc
->touches
[id
].scroll_y
- y
;
223 /* Calculate and apply the scroll motion. */
225 case TOUCH_STATE_START
:
226 msc
->touches
[id
].scroll_x
= x
;
227 msc
->touches
[id
].scroll_y
= y
;
229 /* Reset acceleration after half a second. */
230 if (scroll_acceleration
&& time_before(now
,
231 msc
->scroll_jiffies
+ HZ
/ 2))
232 msc
->scroll_accel
= max_t(int,
233 msc
->scroll_accel
- 1, 1);
235 msc
->scroll_accel
= SCROLL_ACCEL_DEFAULT
;
238 case TOUCH_STATE_DRAG
:
239 step_x
/= (64 - (int)scroll_speed
) * msc
->scroll_accel
;
241 msc
->touches
[id
].scroll_x
-= step_x
*
242 (64 - scroll_speed
) * msc
->scroll_accel
;
243 msc
->scroll_jiffies
= now
;
244 input_report_rel(input
, REL_HWHEEL
, -step_x
);
247 step_y
/= (64 - (int)scroll_speed
) * msc
->scroll_accel
;
249 msc
->touches
[id
].scroll_y
-= step_y
*
250 (64 - scroll_speed
) * msc
->scroll_accel
;
251 msc
->scroll_jiffies
= now
;
252 input_report_rel(input
, REL_WHEEL
, step_y
);
261 input_mt_slot(input
, id
);
262 input_mt_report_slot_state(input
, MT_TOOL_FINGER
, down
);
264 /* Generate the input events for this touch. */
266 input_report_abs(input
, ABS_MT_TOUCH_MAJOR
, touch_major
<< 2);
267 input_report_abs(input
, ABS_MT_TOUCH_MINOR
, touch_minor
<< 2);
268 input_report_abs(input
, ABS_MT_ORIENTATION
, -orientation
);
269 input_report_abs(input
, ABS_MT_POSITION_X
, x
);
270 input_report_abs(input
, ABS_MT_POSITION_Y
, y
);
272 if (report_undeciphered
) {
273 if (input
->id
.product
== USB_DEVICE_ID_APPLE_MAGICMOUSE
)
274 input_event(input
, EV_MSC
, MSC_RAW
, tdata
[7]);
275 else /* USB_DEVICE_ID_APPLE_MAGICTRACKPAD */
276 input_event(input
, EV_MSC
, MSC_RAW
, tdata
[8]);
281 static int magicmouse_raw_event(struct hid_device
*hdev
,
282 struct hid_report
*report
, u8
*data
, int size
)
284 struct magicmouse_sc
*msc
= hid_get_drvdata(hdev
);
285 struct input_dev
*input
= msc
->input
;
286 int x
= 0, y
= 0, ii
, clicks
= 0, npoints
;
289 case TRACKPAD_REPORT_ID
:
290 /* Expect four bytes of prefix, and N*9 bytes of touch data. */
291 if (size
< 4 || ((size
- 4) % 9) != 0)
293 npoints
= (size
- 4) / 9;
295 for (ii
= 0; ii
< npoints
; ii
++)
296 magicmouse_emit_touch(msc
, ii
, data
+ ii
* 9 + 4);
300 /* The following bits provide a device specific timestamp. They
303 * ts = data[1] >> 6 | data[2] << 2 | data[3] << 10;
306 case MOUSE_REPORT_ID
:
307 /* Expect six bytes of prefix, and N*8 bytes of touch data. */
308 if (size
< 6 || ((size
- 6) % 8) != 0)
310 npoints
= (size
- 6) / 8;
312 for (ii
= 0; ii
< npoints
; ii
++)
313 magicmouse_emit_touch(msc
, ii
, data
+ ii
* 8 + 6);
315 /* When emulating three-button mode, it is important
316 * to have the current touch information before
317 * generating a click event.
319 x
= (int)(((data
[3] & 0x0c) << 28) | (data
[1] << 22)) >> 22;
320 y
= (int)(((data
[3] & 0x30) << 26) | (data
[2] << 22)) >> 22;
323 /* The following bits provide a device specific timestamp. They
326 * ts = data[3] >> 6 | data[4] << 2 | data[5] << 10;
329 case DOUBLE_REPORT_ID
:
330 /* Sometimes the trackpad sends two touch reports in one
333 magicmouse_raw_event(hdev
, report
, data
+ 2, data
[1]);
334 magicmouse_raw_event(hdev
, report
, data
+ 2 + data
[1],
341 if (input
->id
.product
== USB_DEVICE_ID_APPLE_MAGICMOUSE
) {
342 magicmouse_emit_buttons(msc
, clicks
& 3);
343 input_report_rel(input
, REL_X
, x
);
344 input_report_rel(input
, REL_Y
, y
);
345 } else { /* USB_DEVICE_ID_APPLE_MAGICTRACKPAD */
346 input_report_key(input
, BTN_MOUSE
, clicks
& 1);
347 input_mt_report_pointer_emulation(input
, true);
354 static int magicmouse_setup_input(struct input_dev
*input
, struct hid_device
*hdev
)
358 __set_bit(EV_KEY
, input
->evbit
);
360 if (input
->id
.product
== USB_DEVICE_ID_APPLE_MAGICMOUSE
) {
361 __set_bit(BTN_LEFT
, input
->keybit
);
362 __set_bit(BTN_RIGHT
, input
->keybit
);
364 __set_bit(BTN_MIDDLE
, input
->keybit
);
366 __set_bit(EV_REL
, input
->evbit
);
367 __set_bit(REL_X
, input
->relbit
);
368 __set_bit(REL_Y
, input
->relbit
);
369 if (emulate_scroll_wheel
) {
370 __set_bit(REL_WHEEL
, input
->relbit
);
371 __set_bit(REL_HWHEEL
, input
->relbit
);
373 } else { /* USB_DEVICE_ID_APPLE_MAGICTRACKPAD */
374 /* input->keybit is initialized with incorrect button info
375 * for Magic Trackpad. There really is only one physical
376 * button (BTN_LEFT == BTN_MOUSE). Make sure we don't
377 * advertise buttons that don't exist...
379 __clear_bit(BTN_RIGHT
, input
->keybit
);
380 __clear_bit(BTN_MIDDLE
, input
->keybit
);
381 __set_bit(BTN_MOUSE
, input
->keybit
);
382 __set_bit(BTN_TOOL_FINGER
, input
->keybit
);
383 __set_bit(BTN_TOOL_DOUBLETAP
, input
->keybit
);
384 __set_bit(BTN_TOOL_TRIPLETAP
, input
->keybit
);
385 __set_bit(BTN_TOOL_QUADTAP
, input
->keybit
);
386 __set_bit(BTN_TOOL_QUINTTAP
, input
->keybit
);
387 __set_bit(BTN_TOUCH
, input
->keybit
);
388 __set_bit(INPUT_PROP_POINTER
, input
->propbit
);
389 __set_bit(INPUT_PROP_BUTTONPAD
, input
->propbit
);
393 __set_bit(EV_ABS
, input
->evbit
);
395 error
= input_mt_init_slots(input
, 16);
398 input_set_abs_params(input
, ABS_MT_TOUCH_MAJOR
, 0, 255 << 2,
400 input_set_abs_params(input
, ABS_MT_TOUCH_MINOR
, 0, 255 << 2,
402 input_set_abs_params(input
, ABS_MT_ORIENTATION
, -31, 32, 1, 0);
404 /* Note: Touch Y position from the device is inverted relative
405 * to how pointer motion is reported (and relative to how USB
406 * HID recommends the coordinates work). This driver keeps
407 * the origin at the same position, and just uses the additive
408 * inverse of the reported Y.
410 if (input
->id
.product
== USB_DEVICE_ID_APPLE_MAGICMOUSE
) {
411 input_set_abs_params(input
, ABS_MT_POSITION_X
,
412 MOUSE_MIN_X
, MOUSE_MAX_X
, 4, 0);
413 input_set_abs_params(input
, ABS_MT_POSITION_Y
,
414 MOUSE_MIN_Y
, MOUSE_MAX_Y
, 4, 0);
416 input_abs_set_res(input
, ABS_MT_POSITION_X
,
418 input_abs_set_res(input
, ABS_MT_POSITION_Y
,
420 } else { /* USB_DEVICE_ID_APPLE_MAGICTRACKPAD */
421 input_set_abs_params(input
, ABS_X
, TRACKPAD_MIN_X
,
422 TRACKPAD_MAX_X
, 4, 0);
423 input_set_abs_params(input
, ABS_Y
, TRACKPAD_MIN_Y
,
424 TRACKPAD_MAX_Y
, 4, 0);
425 input_set_abs_params(input
, ABS_MT_POSITION_X
,
426 TRACKPAD_MIN_X
, TRACKPAD_MAX_X
, 4, 0);
427 input_set_abs_params(input
, ABS_MT_POSITION_Y
,
428 TRACKPAD_MIN_Y
, TRACKPAD_MAX_Y
, 4, 0);
430 input_abs_set_res(input
, ABS_X
, TRACKPAD_RES_X
);
431 input_abs_set_res(input
, ABS_Y
, TRACKPAD_RES_Y
);
432 input_abs_set_res(input
, ABS_MT_POSITION_X
,
434 input_abs_set_res(input
, ABS_MT_POSITION_Y
,
438 input_set_events_per_packet(input
, 60);
440 if (report_undeciphered
) {
441 __set_bit(EV_MSC
, input
->evbit
);
442 __set_bit(MSC_RAW
, input
->mscbit
);
448 static int magicmouse_input_mapping(struct hid_device
*hdev
,
449 struct hid_input
*hi
, struct hid_field
*field
,
450 struct hid_usage
*usage
, unsigned long **bit
, int *max
)
452 struct magicmouse_sc
*msc
= hid_get_drvdata(hdev
);
455 msc
->input
= hi
->input
;
457 /* Magic Trackpad does not give relative data after switching to MT */
458 if (hi
->input
->id
.product
== USB_DEVICE_ID_APPLE_MAGICTRACKPAD
&&
459 field
->flags
& HID_MAIN_ITEM_RELATIVE
)
465 static int magicmouse_probe(struct hid_device
*hdev
,
466 const struct hid_device_id
*id
)
468 __u8 feature
[] = { 0xd7, 0x01 };
469 struct magicmouse_sc
*msc
;
470 struct hid_report
*report
;
473 msc
= kzalloc(sizeof(*msc
), GFP_KERNEL
);
475 hid_err(hdev
, "can't alloc magicmouse descriptor\n");
479 msc
->scroll_accel
= SCROLL_ACCEL_DEFAULT
;
481 msc
->quirks
= id
->driver_data
;
482 hid_set_drvdata(hdev
, msc
);
484 ret
= hid_parse(hdev
);
486 hid_err(hdev
, "magicmouse hid parse failed\n");
490 ret
= hid_hw_start(hdev
, HID_CONNECT_DEFAULT
);
492 hid_err(hdev
, "magicmouse hw start failed\n");
496 /* We do this after hid-input is done parsing reports so that
497 * hid-input uses the most natural button and axis IDs.
500 ret
= magicmouse_setup_input(msc
->input
, hdev
);
502 hid_err(hdev
, "magicmouse setup input failed (%d)\n", ret
);
507 if (id
->product
== USB_DEVICE_ID_APPLE_MAGICMOUSE
)
508 report
= hid_register_report(hdev
, HID_INPUT_REPORT
,
510 else { /* USB_DEVICE_ID_APPLE_MAGICTRACKPAD */
511 report
= hid_register_report(hdev
, HID_INPUT_REPORT
,
513 report
= hid_register_report(hdev
, HID_INPUT_REPORT
,
518 hid_err(hdev
, "unable to register touch report\n");
525 * Some devices repond with 'invalid report id' when feature
526 * report switching it into multitouch mode is sent to it.
528 * This results in -EIO from the _raw low-level transport callback,
529 * but there seems to be no other way of switching the mode.
530 * Thus the super-ugly hacky success check below.
532 ret
= hdev
->hid_output_raw_report(hdev
, feature
, sizeof(feature
),
534 if (ret
!= -EIO
&& ret
!= sizeof(feature
)) {
535 hid_err(hdev
, "unable to request touch data (%d)\n", ret
);
547 static void magicmouse_remove(struct hid_device
*hdev
)
549 struct magicmouse_sc
*msc
= hid_get_drvdata(hdev
);
555 static const struct hid_device_id magic_mice
[] = {
556 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE
,
557 USB_DEVICE_ID_APPLE_MAGICMOUSE
), .driver_data
= 0 },
558 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE
,
559 USB_DEVICE_ID_APPLE_MAGICTRACKPAD
), .driver_data
= 0 },
562 MODULE_DEVICE_TABLE(hid
, magic_mice
);
564 static struct hid_driver magicmouse_driver
= {
565 .name
= "magicmouse",
566 .id_table
= magic_mice
,
567 .probe
= magicmouse_probe
,
568 .remove
= magicmouse_remove
,
569 .raw_event
= magicmouse_raw_event
,
570 .input_mapping
= magicmouse_input_mapping
,
573 static int __init
magicmouse_init(void)
577 ret
= hid_register_driver(&magicmouse_driver
);
579 pr_err("can't register magicmouse driver\n");
584 static void __exit
magicmouse_exit(void)
586 hid_unregister_driver(&magicmouse_driver
);
589 module_init(magicmouse_init
);
590 module_exit(magicmouse_exit
);
591 MODULE_LICENSE("GPL");