bcm5974.rst 2.3 KB

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