PALMAX(__drivermansuffix__)

NAME
palmax - Palmax (TR88L803) touchscreen driver

SYNOPSIS
Section "InputDevice"
Identifier "idevname"
Driver "palmax"
Option "Device" "devpath"
...
EndSection

DESCRIPTION
palmax is an XFree86 input driver for the Palmax PD1000/PD1100

The palmax driver functions as a pointer input device, and is normally used as the X server's core pointer. It supports positioning and mouse buttons using the touchscreen display and lid buttons on the Palmax machines.

SUPPORTED HARDWARE
Palmax PD1000, Palmax PD1100. In theory also any other system using a TR88L803 wired to a serial port.

CONFIGURATION DETAILS
Please refer to XF86Config(__filemansuffix__) 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.

The following driver options are supported

Option "MinX" "integer"
    Set the left hand X value from the touchscreen, for calibration.

Option "MaxX" "integer"
    Set the right hand X value from the touchscreen, for calibration.

Option "MinY" "integer"
    Set the top Y value from the touchscreen, for calibration.

Option "MaxY" "integer"
    Set the bottom Y value from the touchscreen, for calibration.

Option "Screen" "integer"
    The screen to attach to the touchscreen when running with multiple screens. The default is screen 0.

Option "Device" "string"
    The serial port that is attached to the touchscreen interface. On the Palmax PD1000 and PD1100 this is ttyS0.

Option "DeviceName" "string"
    Set the X11 device name for the touchscreen. This defaults to TOUCHSCREEN.

Option "PortraitMode" "string"
    Set the display orientation. The default is "landscape" but you can rotate the screen clockwise ("portrait") or anticlockwise ("portraitCCW").

Option "SwapXY" "boolean"
    Swap the X and Y values on the display. The default is false.

Option "TapButton" "boolean"
    Set the touchscreen tap to act as mouse button 1. This allows single handed operation except when using the menu buttons. The default is false.

BUGS
The driver has been tested on the Palmax systems, the defaults reflect the Palmax hardware and should work out of the box. No testing has been done on other systems using the same digitizer.

Support for a double-tap menu button option would be nice.

The smoothing algorithm would benefit from real mathematics.

XFree86 needs a nice calibration tool.

SEE ALSO
XFree86(1), XF86Config(__filemansuffix__), xf86config(1), Xserver(1), X(__miscmansuffix__).

AUTHORS
Authors include...
 Alan Cox