NAME

     atp — Apple touchpad driver

SYNOPSIS

     To compile this driver into the kernel, place the following lines into your kernel
     configuration file:

           device atp
           device usb

     Alternatively, to load the driver as a module at boot time, place the following line in
     loader.conf(5):

           atp_load="YES"

DESCRIPTION

     The atp driver provides support for the Apple Internal Trackpad device found in many Apple
     laptops.

     The driver simulates a three-button mouse using multi-finger tap detection.  A single-finger
     tap generates a left button click; two-finger tap maps to the middle button; whereas a
     three-finger tap gets treated as a right button click.  A double-tap followed by a drag is
     treated as a selection gesture; a virtual left-button click is assumed for the lifespan of
     the drag.  atp attempts to filter away activity at the horizontal edges of the
     trackpad--this is to keep unintentional palm movement from being considered as user input.

     atp supports dynamic reconfiguration using sysctl(8); through nodes under hw.usb.atp.
     Pointer sensitivity can be controlled using the sysctl tunable hw.usb.atp.scale_factor.

HARDWARE

     The atp driver provides support for the following Product IDs:

     •   Core Duo MacBook & MacBook Pro (IDs: 0x0217, 0x0218, 0x0219)
     •   Core2 Duo MacBook & MacBook Pro (IDs: 0x021a, 0x021b, 0x021c)
     •   Core2 Duo MacBook3,1 (IDs: 0x0229, 0x022a, 0x022b)
     •   12 inch PowerBook and iBook (IDs: 0x030a, 0x030b)
     •   15 inch PowerBook (IDs: 0x020e, 0x020f, 0x0215)
     •   17 inch PowerBook (ID: 0x020d)

     To discover the product-id of a touchpad, search for 'Trackpad' in the output of lshal(1)
     and look up the property usb_device.product_id.

FILES

     atp creates a blocking pseudo-device file, /dev/atp0, which presents the mouse as a sysmouse
     or mousesystems type device--see moused(8) for an explanation of these mouse types.
     moused(8) can be configured to read touchpad data from /dev/atp0 and pass it along to the
     sysmouse(4) driver so that any process wanting to utilize mouse operation (such as an X
     server) may fetch it from /dev/sysmouse; alternatively, /dev/atp0 may be manipulated via
     read(2) and ioctl(2) calls to get mouse data directly.

EXAMPLES

     To use a compatible Apple Trackpad as your console mouse:

           moused -p /dev/atp0 -t auto

     To launch moused(8) automatically upon boot, add the following to /etc/rc.conf:

           moused_enable="YES"
           moused_type="auto"
           moused_port="/dev/atp0"

     If you want moused(8) to also probe for external USB mice or other devices, then add the
     following to /etc/rc.conf:

           moused_nondefault_enable="YES"
           moused_ums0_enable="YES"
           moused_ums1_enable="YES"

     To be able to use the trackpad under X, change the "Pointer" section in xorg.conf to the
     following:

           Device /dev/atp0
           Protocol Auto

     Better still, if you want to be able to use the mouse in both virtual consoles as well as in
     X change it to:

           Device /dev/sysmouse
           Protocol Auto

SEE ALSO

     sysmouse(4), usb(4), loader.conf(5), xorg.conf(5) (ports/x11/xorg), moused(8), sysctl(8)

AUTHORS

     The atp driver was written by Rohit Grover <rgrover1@gmail.com>.