0001 .. include:: <isonum.txt>
0002
0003 ----------------------------------
0004 Apple Touchpad Driver (appletouch)
0005 ----------------------------------
0006
0007 :Copyright: |copy| 2005 Stelian Pop <stelian@popies.net>
0008
0009 appletouch is a Linux kernel driver for the USB touchpad found on post
0010 February 2005 and October 2005 Apple Aluminium Powerbooks.
0011
0012 This driver is derived from Johannes Berg's appletrackpad driver [#f1]_,
0013 but it has been improved in some areas:
0014
0015 * appletouch is a full kernel driver, no userspace program is necessary
0016 * appletouch can be interfaced with the synaptics X11 driver, in order
0017 to have touchpad acceleration, scrolling, etc.
0018
0019 Credits go to Johannes Berg for reverse-engineering the touchpad protocol,
0020 Frank Arnold for further improvements, and Alex Harper for some additional
0021 information about the inner workings of the touchpad sensors. Michael
0022 Hanselmann added support for the October 2005 models.
0023
0024 Usage
0025 -----
0026
0027 In order to use the touchpad in the basic mode, compile the driver and load
0028 the module. A new input device will be detected and you will be able to read
0029 the mouse data from /dev/input/mice (using gpm, or X11).
0030
0031 In X11, you can configure the touchpad to use the synaptics X11 driver, which
0032 will give additional functionalities, like acceleration, scrolling, 2 finger
0033 tap for middle button mouse emulation, 3 finger tap for right button mouse
0034 emulation, etc. In order to do this, make sure you're using a recent version of
0035 the synaptics driver (tested with 0.14.2, available from [#f2]_), and configure
0036 a new input device in your X11 configuration file (take a look below for an
0037 example). For additional configuration, see the synaptics driver documentation::
0038
0039 Section "InputDevice"
0040 Identifier "Synaptics Touchpad"
0041 Driver "synaptics"
0042 Option "SendCoreEvents" "true"
0043 Option "Device" "/dev/input/mice"
0044 Option "Protocol" "auto-dev"
0045 Option "LeftEdge" "0"
0046 Option "RightEdge" "850"
0047 Option "TopEdge" "0"
0048 Option "BottomEdge" "645"
0049 Option "MinSpeed" "0.4"
0050 Option "MaxSpeed" "1"
0051 Option "AccelFactor" "0.02"
0052 Option "FingerLow" "0"
0053 Option "FingerHigh" "30"
0054 Option "MaxTapMove" "20"
0055 Option "MaxTapTime" "100"
0056 Option "HorizScrollDelta" "0"
0057 Option "VertScrollDelta" "30"
0058 Option "SHMConfig" "on"
0059 EndSection
0060
0061 Section "ServerLayout"
0062 ...
0063 InputDevice "Mouse"
0064 InputDevice "Synaptics Touchpad"
0065 ...
0066 EndSection
0067
0068 Fuzz problems
0069 -------------
0070
0071 The touchpad sensors are very sensitive to heat, and will generate a lot of
0072 noise when the temperature changes. This is especially true when you power-on
0073 the laptop for the first time.
0074
0075 The appletouch driver tries to handle this noise and auto adapt itself, but it
0076 is not perfect. If finger movements are not recognized anymore, try reloading
0077 the driver.
0078
0079 You can activate debugging using the 'debug' module parameter. A value of 0
0080 deactivates any debugging, 1 activates tracing of invalid samples, 2 activates
0081 full tracing (each sample is being traced)::
0082
0083 modprobe appletouch debug=1
0084
0085 or::
0086
0087 echo "1" > /sys/module/appletouch/parameters/debug
0088
0089
0090 .. Links:
0091
0092 .. [#f1] http://johannes.sipsolutions.net/PowerBook/touchpad/
0093
0094 .. [#f2] `<http://web.archive.org/web/*/http://web.telia.com/~u89404340/touchpad/index.html>`_
