12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970 |
- .. include:: <isonum.txt>
- ------------------------
- BCM5974 Driver (bcm5974)
- ------------------------
- :Copyright: |copy| 2008-2009 Henrik Rydberg <[email protected]>
- The USB initialization and package decoding was made by Scott Shawcroft as
- part of the touchd user-space driver project:
- :Copyright: |copy| 2008 Scott Shawcroft ([email protected])
- The BCM5974 driver is based on the appletouch driver:
- :Copyright: |copy| 2001-2004 Greg Kroah-Hartman ([email protected])
- :Copyright: |copy| 2005 Johannes Berg ([email protected])
- :Copyright: |copy| 2005 Stelian Pop ([email protected])
- :Copyright: |copy| 2005 Frank Arnold ([email protected])
- :Copyright: |copy| 2005 Peter Osterlund ([email protected])
- :Copyright: |copy| 2005 Michael Hanselmann ([email protected])
- :Copyright: |copy| 2006 Nicolas Boichat ([email protected])
- This driver adds support for the multi-touch trackpad on the new Apple
- Macbook Air and Macbook Pro laptops. It replaces the appletouch driver on
- those computers, and integrates well with the synaptics driver of the Xorg
- system.
- Known to work on Macbook Air, Macbook Pro Penryn and the new unibody
- Macbook 5 and Macbook Pro 5.
- Usage
- -----
- The driver loads automatically for the supported usb device ids, and
- becomes available both as an event device (/dev/input/event*) and as a
- mouse via the mousedev driver (/dev/input/mice).
- USB Race
- --------
- The Apple multi-touch trackpads report both mouse and keyboard events via
- different interfaces of the same usb device. This creates a race condition
- with the HID driver, which, if not told otherwise, will find the standard
- HID mouse and keyboard, and claim the whole device. To remedy, the usb
- product id must be listed in the mouse_ignore list of the hid driver.
- Debug output
- ------------
- To ease the development for new hardware version, verbose packet output can
- be switched on with the debug kernel module parameter. The range [1-9]
- yields different levels of verbosity. Example (as root)::
- echo -n 9 > /sys/module/bcm5974/parameters/debug
- tail -f /var/log/debug
- echo -n 0 > /sys/module/bcm5974/parameters/debug
- Trivia
- ------
- The driver was developed at the ubuntu forums in June 2008 [#f1]_, and now has
- a more permanent home at bitmath.org [#f2]_.
- .. Links
- .. [#f1] http://ubuntuforums.org/showthread.php?t=840040
- .. [#f2] http://bitmath.org/code/
|