AIPTEK(4)						     Kernel Interfaces Manual							 AIPTEK(4)

NAME

       aiptek - Aiptek USB Digital Tablet Input Driver for Linux

SYNOPSIS

       Section "InputDevice"
	 Identifier "idevname"
	 Driver "aiptek"
	 Option "Device"   "devpath"
	 ...
       EndSection

DESCRIPTION

       aiptek  is  an  Xorg input driver for Aiptek HyperPen USB-based tablet devices.	This driver only supports the USB protocol, and only under
       Linux; for RS-232C-based HyperPens, please see the "hyperpen" driver.

       The aiptek driver functions as a pointer input device, and may be used as the X server's core pointer.

SUPPORTED HARDWARE

       This driver supports the Aiptek HyperPen 4000U, 5000U, 6000U, 8000U and 12000U USB-based input tablet on some Linux platforms.

CONFIGURATION DETAILS

       Please refer to xorg.conf(5) for general configuration details and for options that can be used with all input drivers.	This section  only
       covers configuration details specific to this driver.

       Multiple  instances of the Aiptek devices can cohabit. It can be useful to define multiple devices with different active zones. Each device
       supports the following entries:

	       Option "Type" "stylus"|"eraser"|"cursor"
		   sets the type of tool the device represent. This option is mandatory.

	       Option "Device" "path"
		   sets the path to the special file which represents serial line where the tablet is plugged.	You have to specify  it  for  each
		   subsection with the same value if you want to have multiple devices with the same tablet.  This option is mandatory.

	       Option "USB" "on"
		   specifies that you are using the USB bus to communicate with your tablet.  This setting is mandatory, as USB is the only proto-
		   col supported by this driver.

	       Option "DeviceName" "name"
		   sets the name of the X device.

	       Option "Mode" "Relative"|"Absolute"
		   sets the mode of the device.

	       Option "HistorySize" "number"
		   sets the motion history size. By default the value is zero.

	       Option "AlwaysCore" "on"
		   enables the sharing of the core pointer. When this feature is enabled, the device will take control of the  core  pointer  (and
		   thus  will emit core events) and at the same time will be able, when asked so, to report extended events.  You can use the last
		   available integer feedback to control this feature. When the value of the feedback is zero, the feature is disabled.  The  fea-
		   ture is enabled for any other value.

	       Option "XTop" "number"
		   First  of  three  sets  of  parameters to set the active zone. This sets the X coordinate of the top corner of the active zone.
		   "TopX" is a synonym.

	       Option "YTop" "number"
		   First of three sets of parameters to set the active zone. This sets the Y coordinate of the top  corner  of	the  active  zone.
		   "TopY" is a synonym.

	       Option "XBottom" "Inumber"
		   First  of  three sets of parameters to set the active zone. This sets the X coordinate of the bottom corner of the active zone.
		   "BottomX" is a synonym.

	       Option "YBottom" "number"
		   First of three sets of parameters to set the active zone. This sets the Y coordinate of the bottom corner of the  active  zone.
		   "BottomY" is a synonym.

	       Option "XMax" "number"
		   Second  of  three  sets of parameters to set the active zone. This sets the the X coordinate of the bottom corner of the active
		   zone. The Top X corner's coordinate is fixed at 0. "MaxX" is a synonym.

	       Option "YMax" "number"
		   Second of three sets of parameters to set the active zone. This sets the the Y coordinate of the bottom corner  of  the  active
		   zone. The Top Y corner's coordinate is fixed at 0. "MaxY" is a synonym.

	       Option "XOffset" "number"
		   Third  of  three  sets  of  parameters to set the active zone. This sets the X coordinate of the top corner of the active zone.
		   "OffsetX" is a synonym.

	       Option "YOffset" "number"
		   Third of three sets of parameters to set the active zone. This sets the Y coordinate of the top  corner  of	the  active  zone.
		   "OffsetY" is a synonym.

	       Option "XSize" "number"
		   Third  of  three sets of parameters to set the active zone. This sets the X coordinate of the bottom corner of the active zone.
		   Unlike others, this parameter is expressed in relative coordinates from the "XOffset" parameter. "XSize" is a synonym.

	       Option "YSize" "number"
		   Third of three sets of parameters to set the active zone. This sets the Y coordinate of the bottom corner of the  active  zone.
		   Unlike others, this parameter is expressed in relative coordinates from the "YOffset" parameter. "YSize" is a synonym.

	       Option "ZMin" "number"
		   Minimum pressure reading that will be accepted from the Stylus tool. "MinZ" is a synonym.

	       Option "ZMax" "number"
		   Maximum pressure reading that will be accepted from the Stylus tool. "MaxZ" is a synonym.

	       Option "XThreshold" "number"
		   Minimal change in X coordinate position that will be accepted as data input.  "ThresholdX" is a synonym.

	       Option "YThreshold" "number"
		   Minimal change in Y coordinate position that will be accepted as data input.  "ThresholdY" is a synonym.

	       Option "ZThreshold" "number"
		   Minimal change in pressure reading that will be accepted as data input.  "ThresholdZ" is a synonym.

	       Option "InvX" "on"
		   Inverts X coordinate reports. "XInv" is a synonym.

	       Option "InvY" "on"
		   Inverts Y coordinate reports. "YInv" is a synonym.

	       Option "Pressure" "soft"|"hard"|"linear"
		   Pressure  reports  either  delivered in linearly incremental values (default), or perturbed by one of two log-linear algorithms
		   ("soft" or "hard".)

	       Option "KeepShape" "on"
		   When this option is enabled, the active zone  begins according to TopX and TopY.  The bottom corner is  adjusted  to  keep  the
		   ratio  width/height	of  the  active  zone the same as the screen while maximizing the area described by the active area set of
		   parameters, XTop/YTop/XBottom/YBottom, XMax/YMax, or XOffset/YOffset/XSize/YSize.

	       Option "DebugLevel" number
		   sets the level of debugging info reported.

       This driver is currently Linux specific.

SEE ALSO

       Xorg(1), xorg.conf(5), Xserver(1), X(7), hyperpen(4).

AUTHORS

       Bryan W. Headley <bheadley@earthlink.net>

PROJECT PAGE

       http://aiptektablet.sourceforge.net tracks ongoing development of this driver, the Linux kernel driver, and  a  GUI  front-end  application
       that works in concert with the above.

X Version 11						      xf86-input-aiptek 1.4.1							 AIPTEK(4)