Bug#646039: xserver-xorg-input-penmount: man page improvements
Package: xserver-xorg-input-penmount
Version: 1:1.5.0-1+b1
Severity: minor
I have an Advantech PPC-174T, which contains a Penmount DMC9000, so
I'd like to get this driver working if possible. Unfortunately, the
existing man page is almost empty. I've tried to read the source code,
and fill in as much of the man page as possible. The result is
attached. It still needs some work, but I think it's a good start.
Sorry it's just plain text so far; I'm not familiar with the markup
used for man pages, though I wouldn't mind learning it.
-- graham
Name
penmount - PenMount touchscreen controller input driver
Synopsis
Section "InputDevice"
Identifier "idevname"
Driver "penmount"
Option "Device" "devpath"
Option "ControllerModel" "modelname"
...
EndSection
Description
penmount is an Xorg input driver for Penmount touchscreen controllers.
The penmount driver functions as a pointer input device, and may be used as the X server's core pointer.
Supported Hardware
The Penmount DMC8910, DMC9000, and DMC9512 controllers are supported. Additional controller types appear to be supported, but precisely which ones is not known at this time.
Configuration Details
Please refer to xorg.conf(5x) 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 "Device" "string"
The device through which the touchscreen controller can be accessed. This option is mandatory, and there is no default setting.
The driver provides reasonable defaults for the standard serial port options. (Are these documented somewhere? These options are consumed by xf86OpenSerial() and xf86SetSerial(), in posix_tty.c.)
Option "ControllerModel" "string"
The type of touchscreen controller. This is used to select the appropriate communication protocol. The recognized settings are:
DMC8910, DMC9000, DMC9512
The default setting is "UNKNOWN", which selects another protocol implementation that is presumably applicable to some older Penmount hardware. We do not currently know which controllers use this protocol.
Option "ScreenNumber" "integer"
The screen to attach to the touchscreen when running with multiple screens. The default is screen 0.
Option "ButtonNumber" "integer"
The mouse button index that is assigned to touch-screen "click" events. The default is 1, corresponding to the left mouse button.
Option "SwapXY" "integer"
Swap the X and Y axis on the display. The default is false.
Option "InvertX" "integer"
Option "InvertY" "integer"
Invert the X and Y axes on the display, respectively. The default is false.
Option "MinX" "integer"
Option "MaxX" "integer"
Option "MinY" "integer"
Option "MaxY" "integer"
Provides calibration information. The defaults are (0,0) - (1024,768). These options should reflect the range of values that are actually returned by the controller. The driver will then scale the values to the display. (Is there any way to obtain these values, other than by trial-and-error?)
Option "ReportingMode" "string"
Selects the reporting mode. The default is "scaled". The other available option is "raw", which may be useful during calibration.
Notes
As of September 2011, this driver is considered unmaintained by upstream.
If this driver is unsuitable for your purposes, you might want to try the proprietary drivers that are available from SALT International Corporation:
http://www.salt.com.tw/
Unfortunately, SALT does not publish source code, and they may or may not publish binaries that are compatible with your system. Any questions or problems concerning the SALT device drivers should be directed to SALT Technical Support.
Reply to: