Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
ATP(4)		       FreeBSD Kernel Interfaces Manual			ATP(4)

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 detec-
     tion.  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 life-
     span 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 tun-
     able hw.usb.atp.scale_factor.

HARDWARE
     The atp driver provides support for the following Product IDs:

     +o	 Core Duo MacBook & MacBook Pro	(IDs: 0x0217, 0x0218, 0x0219)
     +o	 Core2 Duo MacBook & MacBook Pro (IDs: 0x021a, 0x021b, 0x021c)
     +o	 Core2 Duo MacBook3,1 (IDs: 0x0229, 0x022a, 0x022b)
     +o	 12 inch PowerBook and iBook (IDs: 0x030a, 0x030b)
     +o	 15 inch PowerBook (IDs: 0x020e, 0x020f, 0x0215)
     +o	 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>.

FreeBSD	10.1		       November	12, 2009		  FreeBSD 10.1

NAME | SYNOPSIS | DESCRIPTION | HARDWARE | FILES | EXAMPLES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=atp&manpath=FreeBSD+10.0-RELEASE>

home | help