71 lines · plain
1.. include:: <isonum.txt>2 3------------------------4BCM5974 Driver (bcm5974)5------------------------6 7:Copyright: |copy| 2008-2009 Henrik Rydberg <rydberg@euromail.se>8 9The USB initialization and package decoding was made by Scott Shawcroft as10part of the touchd user-space driver project:11 12:Copyright: |copy| 2008 Scott Shawcroft (scott.shawcroft@gmail.com)13 14The BCM5974 driver is based on the appletouch driver: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)23 24This driver adds support for the multi-touch trackpad on the new Apple25Macbook Air and Macbook Pro laptops. It replaces the appletouch driver on26those computers, and integrates well with the synaptics driver of the Xorg27system.28 29Known to work on Macbook Air, Macbook Pro Penryn and the new unibody30Macbook 5 and Macbook Pro 5.31 32Usage33-----34 35The driver loads automatically for the supported usb device ids, and36becomes available both as an event device (/dev/input/event*) and as a37mouse via the mousedev driver (/dev/input/mice).38 39USB Race40--------41 42The Apple multi-touch trackpads report both mouse and keyboard events via43different interfaces of the same usb device. This creates a race condition44with the HID driver, which, if not told otherwise, will find the standard45HID mouse and keyboard, and claim the whole device. To remedy, the usb46product id must be listed in the mouse_ignore list of the hid driver.47 48Debug output49------------50 51To ease the development for new hardware version, verbose packet output can52be switched on with the debug kernel module parameter. The range [1-9]53yields different levels of verbosity. Example (as root)::54 55 echo -n 9 > /sys/module/bcm5974/parameters/debug56 57 tail -f /var/log/debug58 59 echo -n 0 > /sys/module/bcm5974/parameters/debug60 61Trivia62------63 64The driver was developed at the ubuntu forums in June 2008 [#f1]_, and now has65a more permanent home at bitmath.org [#f2]_.66 67.. Links68 69.. [#f1] http://ubuntuforums.org/showthread.php?t=84004070.. [#f2] http://bitmath.org/code/71