Apple Touchpad Driver (appletouch)

지원 PowerBook와 드라이버 계보

`appletouch`는 2005년 2월 이후 및 2005년 10월형 Apple Aluminium PowerBook에 탑재된 USB 터치패드를 위한 Linux 커널 드라이버입니다. 문서 저작권은 2005년 Stelian Pop에게 있습니다.

이 드라이버는 Johannes Berg의 `appletrackpad` 드라이버에서 파생되었지만 두 가지 면에서 개선되었습니다. 사용자 공간 프로그램이 필요 없는 완전한 커널 드라이버이며, Synaptics X11 드라이버와 연결해 가속·스크롤 같은 기능을 사용할 수 있습니다.

터치패드 프로토콜을 역공학한 Johannes Berg, 추가 개선을 한 Frank Arnold, 센서 내부 동작 정보를 제공한 Alex Harper에게 공로를 돌립니다. Michael Hanselmann은 2005년 10월 모델 지원을 추가했습니다.

.. include:: <isonum.txt>

----------------------------------
Apple Touchpad Driver (appletouch)
----------------------------------

:Copyright: |copy| 2005 Stelian Pop <[email protected]>

appletouch is a Linux kernel driver for the USB touchpad found on post
February 2005 and October 2005 Apple Aluminium Powerbooks.

This driver is derived from Johannes Berg's appletrackpad driver [#f1]_,
but it has been improved in some areas:

        * appletouch is a full kernel driver, no userspace program is necessary
        * appletouch can be interfaced with the synaptics X11 driver, in order
          to have touchpad acceleration, scrolling, etc.

Credits go to Johannes Berg for reverse-engineering the touchpad protocol,
Frank Arnold for further improvements, and Alex Harper for some additional
information about the inner workings of the touchpad sensors. Michael
Hanselmann added support for the October 2005 models.

기본 입력과 Synaptics X11 구성

기본 모드에서는 드라이버를 컴파일하고 모듈을 적재하면 새 입력 장치가 감지됩니다. `gpm`이나 X11에서 `/dev/input/mice`를 읽어 마우스 데이터를 사용할 수 있습니다.

X11에서 최신 Synaptics 드라이버를 사용하면 가속, 스크롤, 두 손가락 탭의 가운데 버튼 에뮬레이션, 세 손가락 탭의 오른쪽 버튼 에뮬레이션 같은 추가 기능을 얻습니다. 문서는 0.14.2 버전으로 시험했으며 새 `InputDevice`를 X11 구성에 추가하는 예를 제공합니다.

`ServerLayout`에는 일반 `Mouse`와 `Synaptics Touchpad` 입력 장치를 모두 추가합니다. 더 세부적인 조정은 Synaptics 드라이버 문서를 참조해야 합니다.

Usage
-----

In order to use the touchpad in the basic mode, compile the driver and load
the module. A new input device will be detected and you will be able to read
the mouse data from /dev/input/mice (using gpm, or X11).

In X11, you can configure the touchpad to use the synaptics X11 driver, which
will give additional functionalities, like acceleration, scrolling, 2 finger
tap for middle button mouse emulation, 3 finger tap for right button mouse
emulation, etc. In order to do this, make sure you're using a recent version of
the synaptics driver (tested with 0.14.2, available from [#f2]_), and configure
a new input device in your X11 configuration file (take a look below for an
example). For additional configuration, see the synaptics driver documentation::

        Section "InputDevice"
                Identifier      "Synaptics Touchpad"
                Driver          "synaptics"
                Option          "SendCoreEvents"        "true"
                Option          "Device"                "/dev/input/mice"
                Option          "Protocol"              "auto-dev"
                Option                "LeftEdge"                "0"
                Option                "RightEdge"                "850"
                Option                "TopEdge"                "0"
                Option                "BottomEdge"                "645"
                Option                "MinSpeed"                "0.4"
                Option                "MaxSpeed"                "1"
                Option                "AccelFactor"                "0.02"
                Option                "FingerLow"                "0"
                Option                "FingerHigh"                "30"
                Option                "MaxTapMove"                "20"
                Option                "MaxTapTime"                "100"
                Option                "HorizScrollDelta"        "0"
                Option                "VertScrollDelta"        "30"
                Option                "SHMConfig"                "on"
        EndSection

        Section "ServerLayout"
                ...
                InputDevice        "Mouse"
                InputDevice        "Synaptics Touchpad"
        ...
        EndSection

열 잡음 자동 보정과 디버그 수준

터치패드 센서는 열에 매우 민감해 온도가 변할 때 많은 잡음을 만듭니다. 특히 노트북 전원을 처음 켠 직후 이 현상이 두드러집니다.

`appletouch` 드라이버는 잡음을 처리하고 자동으로 적응하려 하지만 완벽하지 않습니다. 손가락 움직임을 더 이상 인식하지 못하면 드라이버를 다시 적재해 볼 수 있습니다.

`debug` 모듈 매개변수로 디버깅을 활성화합니다. 값 0은 디버깅을 끄고, 1은 유효하지 않은 샘플만 추적하며, 2는 모든 샘플을 추적합니다.

modprobe appletouch debug=1
echo "1" > /sys/module/appletouch/parameters/debug

Fuzz problems
-------------

The touchpad sensors are very sensitive to heat, and will generate a lot of
noise when the temperature changes. This is especially true when you power-on
the laptop for the first time.

The appletouch driver tries to handle this noise and auto adapt itself, but it
is not perfect. If finger movements are not recognized anymore, try reloading
the driver.

You can activate debugging using the 'debug' module parameter. A value of 0
deactivates any debugging, 1 activates tracing of invalid samples, 2 activates
full tracing (each sample is being traced)::

        modprobe appletouch debug=1

or::

        echo "1" > /sys/module/appletouch/parameters/debug


.. Links:

.. [#f1] http://johannes.sipsolutions.net/PowerBook/touchpad/

.. [#f2] `<http://web.archive.org/web/*/http://web.telia.com/~u89404340/touchpad/index.html>`_