$Id: README.txt 1173 2008-10-28 12:47:57Z volker $

README zu xf86-input-utouch - X.Org / Xfree86 Utouch Input Treiber
Touchscreen USB Treiber

xorg.conf (Beispiel-)Einstellungen:


Section "InputDevice"
	Identifier	"Touchscreen1"
	Driver	"utouch"
	Option	"Device"	"/dev/utouch0"
	Option	"DebugLevel"	"0"
	Option	"Threshold"	"30"
	Option	"FilterLimit"	"2"
	Option	"Invert X"	"0"
	Option	"Invert Y"	"1"
	Option	"Rotate"	"left"
	Option	"Min X"	"372"	
	Option	"Max X"	"2691"
	Option	"Min Y"	"632"
	Option	"Max Y"	"1908"
EndSection

Section "ServerLayout"
	InputDevice "Touchscreen1" "SendCoreEvents"
EndSection


ThresHold:	(1..254)

Druckintensitaet zur Click-Ausloesung (Default: 1)
Der aktuelle Wert zur Intensitaet des Druckpunktes muss diesen Schwellwert 
uebersteigen, um vom Treiber einen simulierten Button-Click im X11 auszu-
loesen. Ermittelte Werte der signalisierten Druckintensitaet lagen zwischen
25 und 130. Sinnvollerweise sollte dieser ThresHold-Wert zwischen 30 und 50
eingestellt werden, um die Click-Verarbeitung zuverlaessig zu realisieren.

FilterLimit (0..255)

Filterung von Touchkoordinaten bei Unruhe des Pointers (Default: 0)
Wirkt der Zeiger auf dem Bildschirm zu unruhig, kann mit dem Filter-Wert
eine Unruhe in der Zeigerbewegung herausgerechnet werden.
Der eingestellte Wert wird als Promille (n/1000) gerechnet.
Empirisch wurde der Wert 2 (2/1000) zur Filterung als optimal ermittelt.
Dieser Wert erzeugt einen ruhigen Zeiger, der die Bewegungen des Fingers
auf dem Bildschirm nachvollzieht.

Invert X/Y: (Yes, No, True, False, 1, 0)

Korrektur der physikalischen Achsen (Nullpunkte) (Default: keiner)
Der logische Nullpunkt auf dem Bildschirm liegt links oben. Der Touchscreen
kann jedoch den physikalischen Nullpunkt an anderer Stelle zu liegen haben.
Bei bisher getesteten Einheiten lagen die physikalischen Nullpunkte in
der rechten oberen oder in der linken unteren Ecke. Diese Einstellung dient
dazu, den physikalisch falschen Nullpunkt zu korrigieren, dass er dem
logischen Nullpunkt des Bildschirms entspricht (links oben).
Liegt der physikalische Nullpunkt oben rechts, muss die X-Achse invertiert,
die Y-Achse jedoch beibehalten werden (Invert X: Yes, Invert Y: No).
Liegt der Nullpunkt unten rechts, muss die Y-Achse invertiert werden.


Rotate:		(left, right, inverted)

Umrechnung der Cursor-Positionierung bei Aenderung der Bildorientierung
Wird im Nvidia-Treiber die Bildorientierung gedreht (Rotate left|right),
muss auch im Touch-Treiber eine Drehung der Positionsberechnung veranlasst
werden. Diese Einstellung in der Section Touchscreen muss mit der gleichen
Einstellung in der Nvidia-Section korrespondieren!


Min X/Y - Max X/Y:

Beschreibung der physikalischen Minimal-/Maximalkoordinaten
Der Touchscreen erzeugt keine absoluten Nullpunkte. Die Minimalkoordinaten
(physikalische Werte wie vom Touchscreen / Kernel Modul "utouch.ko"
signalisiert) werden in einen logischen Nullpunkt umgerechnet. Kommt der
Mauszeiger auf dem Bildschirm nie auf den absoluten Nullpunkt (linke obere
Ecke im X11), muss diese Einstellung korrigiert werden.
Die Maximalkoordinaten werden zur Berechnung der korrekten Bildschirm-
skalierung benoetigt.

Sind diese Werte zu niedrig (Minimum zu hoch, Maximum zu niedrig) eingestellt,
fuehrt der xf86-Treiber eine Autokalibrierung im laufenden Betrieb durch.

Sind diese Einstellungen gar nicht vorhanden, fuehrt der Treiber eine
Autokalibrierung durch. Dabei sollte vor der erstmaligen Nutzung in
jede aeusserste Ecke gegriffen werden, um dem Treiber genuegend physikalische
Koordinaten zur korrekten Cursor-Positionsberechnung zuzufuehren.

Sind diese Werte zu hoch (Minimum zu niedrig, Maximum zu hoch) eingestellt,
kommt es zu Fehlpositionierungen des Cursors! In diesem Fall werden die
Ecken und Raender nie erreicht.


ServerLayout:

	InputDevice "Touchscreen1" "SendCoreEvents"
SendCoreEvents ist notwendig, damit der Input-Treiber Zugriff auf den
gesamten Bildschirm erhaelt.

Alternativ kann die folgende Einstellung genutzt werden:
	InputDevice "Touchscreen1" "AlwaysCore"