]>
Commit | Line | Data |
---|---|---|
60874a79 MCC |
1 | .. include:: <isonum.txt> |
2 | ||
3 | ------------------------ | |
4c57e379 HR |
4 | BCM5974 Driver (bcm5974) |
5 | ------------------------ | |
60874a79 MCC |
6 | |
7 | :Copyright: |copy| 2008-2009 Henrik Rydberg <rydberg@euromail.se> | |
4c57e379 HR |
8 | |
9 | The USB initialization and package decoding was made by Scott Shawcroft as | |
10 | part of the touchd user-space driver project: | |
60874a79 MCC |
11 | |
12 | :Copyright: |copy| 2008 Scott Shawcroft (scott.shawcroft@gmail.com) | |
4c57e379 HR |
13 | |
14 | The BCM5974 driver is based on the appletouch driver: | |
60874a79 MCC |
15 | |
16 | :Copyright: |copy| 2001-2004 Greg Kroah-Hartman (greg@kroah.com) | |
17 | :Copyright: |copy| 2005 Johannes Berg (johannes@sipsolutions.net) | |
18 | :Copyright: |copy| 2005 Stelian Pop (stelian@popies.net) | |
19 | :Copyright: |copy| 2005 Frank Arnold (frank@scirocco-5v-turbo.de) | |
20 | :Copyright: |copy| 2005 Peter Osterlund (petero2@telia.com) | |
21 | :Copyright: |copy| 2005 Michael Hanselmann (linux-kernel@hansmi.ch) | |
22 | :Copyright: |copy| 2006 Nicolas Boichat (nicolas@boichat.ch) | |
4c57e379 HR |
23 | |
24 | This driver adds support for the multi-touch trackpad on the new Apple | |
25 | Macbook Air and Macbook Pro laptops. It replaces the appletouch driver on | |
26 | those computers, and integrates well with the synaptics driver of the Xorg | |
27 | system. | |
28 | ||
29 | Known to work on Macbook Air, Macbook Pro Penryn and the new unibody | |
30 | Macbook 5 and Macbook Pro 5. | |
31 | ||
32 | Usage | |
33 | ----- | |
34 | ||
35 | The driver loads automatically for the supported usb device ids, and | |
36 | becomes available both as an event device (/dev/input/event*) and as a | |
37 | mouse via the mousedev driver (/dev/input/mice). | |
38 | ||
39 | USB Race | |
40 | -------- | |
41 | ||
42 | The Apple multi-touch trackpads report both mouse and keyboard events via | |
43 | different interfaces of the same usb device. This creates a race condition | |
44 | with the HID driver, which, if not told otherwise, will find the standard | |
45 | HID mouse and keyboard, and claim the whole device. To remedy, the usb | |
46 | product id must be listed in the mouse_ignore list of the hid driver. | |
47 | ||
48 | Debug output | |
49 | ------------ | |
50 | ||
51 | To ease the development for new hardware version, verbose packet output can | |
52 | be switched on with the debug kernel module parameter. The range [1-9] | |
60874a79 | 53 | yields different levels of verbosity. Example (as root):: |
4c57e379 | 54 | |
60874a79 | 55 | echo -n 9 > /sys/module/bcm5974/parameters/debug |
4c57e379 | 56 | |
60874a79 | 57 | tail -f /var/log/debug |
4c57e379 | 58 | |
60874a79 | 59 | echo -n 0 > /sys/module/bcm5974/parameters/debug |
4c57e379 HR |
60 | |
61 | Trivia | |
62 | ------ | |
63 | ||
60874a79 MCC |
64 | The driver was developed at the ubuntu forums in June 2008 [#f1]_, and now has |
65 | a more permanent home at bitmath.org [#f2]_. | |
4c57e379 | 66 | |
60874a79 | 67 | .. Links |
4c57e379 | 68 | |
60874a79 MCC |
69 | .. [#f1] http://ubuntuforums.org/showthread.php?t=840040 |
70 | .. [#f2] http://bitmath.org/code/ |