Linux Touch Screen Driver README TEXT
3M Touch Systems, Inc.
TouchWare for Linux
Version 5.63, May 2005
Copyright 2001-2005 3M. All rights reserved.
---------------------------------
PRODUCT SUMMARY
---------------------------------
TouchWare for Linux is the software for your 3M Touch Systems touch screen.
It allows you to select, launch, and drag objects using the touch screen.
TouchWare provides full touch screen functionality for all applications
running under Linux Kernel 2.4 kernels running XFree86 4.
---------------------------------
FEATURES AND ENHANCEMENTS
---------------------------------
* Added support for kernel 2.6.
* Changed distribution from a tar.gz file to an RPM. This eases the
installation of the product.
* Added support for the SC series USB touch screens.
* Moved the automated searching of the serial ports for touch controllers
from kernel driver to an optional daemon program. This eliminates
conflicts and workarounds found in systems that run Red Hat Fedora Core 2
or 3 and with systems that do not have serial ports. This also eliminates
some delays in the booting a system.
* Added support of init scripts that automatically installs the driver and
modifies the XF86Config file. This eliminates the manual setup used in
previous versions.
---------------------------------
RETRIEVING THE FILES
---------------------------------
* TouchWare for Linux arrives as an RPM file. This file contains a kernel
driver, a calibration tool, and an X input module. The kernel driver is
specially built against particular Linux distributions.
* Make sure you obtain the RPM that matches your distribution when you
download the package. If you have a distrbution that is not support or
if you have upgraded your kernel, you should not use the ready-to-run
RPM. Contact technical support at us-ts-techsupport@mmm.com.
---------------------------------
INSTALLING THE DRIVER
---------------------------------
* Open a terminal window if you are not already at a command line prompt.
* Change your working directory to the location of the RPM file.
* Issue the command "rpm -i TWDrv.rpm" where is the rest
of the RPM file name.
---------------------------------
UNINSTALLING THE DRIVER
---------------------------------
* Open a terminal window if you are not already at a command line prompt.
* Issue the command "rpm -e TWDrv". This command does not remove the kernel
module. To finish the uninstall, you need to reboot the system.
---------------------------------
RUNNING THE CALIBRATION UTILITY
---------------------------------
* The calibration utility is named TwCalib and is in the directory
/etc/twscreen/TwCalib. This program may be moved to any location
for your convenience, for example /usr/bin.
* Run this program with the command "/etc/twscreen/TwCalib/TWCalib" or
equivalent to calibrate your touch screen. Note that this is an
X Windows program and must be run while the X Server is running.
* TWCalib presents two targets (three for some SC controllers), one at the
time, for you to touch. Touching these targets are all that are required
to calibration the touch screen controller.
* There is one command line argument for TWCalib. This specifies the device
to which the touch screen controller is attached. The default is
/dev/twscreen1, which is the first touch screen controller supported by
the driver. You may specify other devices as appropriate, such as
/dev/ttyS0.
* If the calibration utility fails to open a port even if it appears touch is
working, there are two known issues. The first issue is that the SC USB
controllers are supported and recognized by the HID module provided by
kernel. This module conflicts with the TouchWare kernel module. The second
issue is a conflict with the "mtouchusb" module described below.
---------------------------------
DISABLING HID SUPPORT
---------------------------------
* SC series controllers are HID compliant devices therefore they are recognized
by HID kernel module. This module does not correctly support the MicroTouch
devices and conflicts with the TouchWare kernel module. To resolve this
conflict, recompile HID module and include the MicroTouch devices in module's
black list. MicroTouch's vendor ID is 0x0596 and the device IDs are 0x0100 for
the SC400 and SC800 controllers and 0x0102 for the SC500 controller.
---------------------------------
HANDLING MONITOR ROTATION
---------------------------------
* Most monitors are used in landscape mode, where the display is wider than
it is taller. This is the normal situation. If your system is like this,
you should not need to make any adjustments. However, if your display is
oriented differently, such as in portrait mode where the display is taller
than it is wide, you may need to add options to the "InputDevice" section.
* First, always test your system without making any adjustments. Calibrate the
touch screen. Touch the display in a corner. If the cursor appears under your
finger, then you need no further changes. Otherwise, follow these steps.
* In the "InputDevice" section, add the option "AutoRotate" and set it to "off".
Save the changes and restart the X Windows server. Calibrate the touch screen
and test a corner. If the touch is still off, proceed to the next step. The
line you need to add to turn autorotation off follows.
Option "AutoRotate" "off"
* Finally, keeping the "AutoRotate" option "off", add the option "Rotate" and
give it a value of "CW", "CCW", or "UD". Use "CW" if your monitor is rotated
90 degrees clockwise, "CCW" if your monitor is rotated 90 degrees
counterclockwise, and "UD" if your monitor is upside down. Save the changes,
restart the X Windows server, and calibrate the touch screen in normal
landscape mode. You need to add one of these three lines.
Option "Rotate" "CW"
Option "Rotate" "CCW"
Option "Rotate" "UD"
---------------------------------
KNOWN ANOMALIES
---------------------------------
* At this time, there are versions of the X Input module that are built
against XFree86 versions 4.0.3 and 4.1.0. The version built against
XFree86 version 4.1.0 also works on systems using versions 4.2.0 and 4.3.0.
* The calibration utility uses the library libglut.so.3. You need to
download and install a package, such as Mesa, that supplies this library
if it is not already on your system. The RPM cannot install until this is
installed.
* The driver requires exclusive access to the serial port¡¦s IRQ. If the IRQ
must be shared, the driver may not work. If you need shared access, you
need to edit the init script /etc/init.d/TWDrvStartup. Locate the line
that defines the variable SEARCH_OPTIONS. Change the argument "-iexclusive"
to "-ishared".
* In some Linux distributions, the "mtouchusb" module is enabled to support
MicroTouch devices. This module conflicts with the TouchWare kernel module.
To resolve this problem, disable the "mtouchusb" either in the kernel or
simply delete it from kernel modules tree.
___________________________________________________________________________
MicroTouch, the MicroTouch logo, and TouchWare are either registered
trademarks or trademarks of 3M in the United States and/or other countries.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.