***************************************************
  README.TXT for the Linux USB Touch Panel Driver
  released date: 2006.7.26
***************************************************


============
Introduction
============
This driver is designed for X Window system of Linux.


==============
Supported List
==============
The supported distributions are listed bellow:

   Redhat 8.0, Redhat 9.0,
   Fedora Core 1, Fedora Core 2, Fedora Core 3, Fedora Core 4, Fedora Core 5
   SUSE 9.3 and SUSE 10.0. ubunta 6.06 


=========
File List
=========
All files in this package are listed bellow:

   readme.txt        This file. 
   auto_install      A shell script which automatically installs related driver.
   auto_uninstall    A shell script which automatically removes related driver.
   obj/ETouch_drv.o  The object file of the driver.
   obj/tscpl         A calibration tool makes the touch point on the panel
                     match to the position of cursor on the screen.
   obj/liftoff       This tool is used to enable the lift-off mode.
                     In the lift-off mode, the click is activated when touch is
                     lifted away from the touch screen. However, it is impossible
                     to drag or draw in this mode.
   obj/swap          This tool is used to swap touch functions between left and 
                     right mouse clicks.


==================
Installation guide
==================
Please follow automatic installation procedures for the supported Linux distributions
as mentioned above. If your Linux version is not listed in the supported list, you 
can do manual installation. Please make sure your Linux & X Window System are working
properly before the installation begins. Make sure login as root to do the installation
and calibration. Open a terminal session to do the following automatic or manual
installation steps.

1. Automatic Installation Procedures

   1.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

       Copy all the related files from CD to "/home/touch_CD" directory

   1.1 Change directory to /home/touch_CD and execute auto_install shell script
       to install the driver.

          cd /home/touch_CD

          ./auto_install

   1.2 After finishing the installation, you will be asked to reboot the computer.

   1.3 If you choose to reboot the computer, please plug in the touch controller
       to USB port prior rebooting.

   1.4 After system reboot is completed, you need to execute "Calibration" to calibrate 
       the touch panel.

          cd /usr/local/bin

          ./Calibration

       When you start the calibration program, you will see a circle with cross
       inside displayed at the lower left corner on the screen. Touch it by your 
       fingertip or the stylus pen. The program will display additional two circles 
       with cross inside, touch them one by one as well.

   1.5 There are three tools "Calibration", "Lift-off" and "Swap" will be put
       into the /usr/local/bin directory.

       The tool "Calibration" makes the touch point on the panel match to the position
       of the cursor on screen.

       The tool "Lift-off" enables the lift-off mode. In the lift-off mode, the click 
       is activated when touch is lifted away from the touch screen. However, it is 
       impossible to drag or draw in this mode.

       The tool "Swap" is used to swap touch functions between left and right mouse click.

   1.6 In order to access these tools easily, the auto_install shell script
       will create icons on your Desktop.

2. Manual Installation Steps

   2.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

   2.1 Mount the CD and copy all related files to "/home/touch_CD" directory

   2.2 Please create /etc/etandt directory for saving some initial files of
       the touch screen application.

          mkdir /etc/etandt

   2.3 In order to ensure you can return to original configuration, please make
       a copy of configuration file, depend on what operating system you are
       running. The /etc/X11/XF86Config is used by system if you are running
       Redhat 8.0, Redhat 9.0, and Fedora Core 1. The /etc/X11/xorg.conf is
       used by system if you are running Fedora Core 2, Fedora Core 3,
       Fedora Core 4, Fedora Core 5, SUSE 9.3 and SUSE 10.0. Otherwise, you
       have to find out the configuration file which is used by operating
       system you are running.

          cp /etc/X11/XF86Config /etc/X11/XF86Config.bak
       or
          cp /etc/X11/xorg.conf  /etc/X11/xorg.conf.bak

   2.4 Use editor, for example the vi, to add strings to /etc/X11/XF86Config or
       /etc/X11/xorg.conf.

       2.4.1 Find "ServerLayout" section, add the following entry:

             Section "ServerLayout"
             Inputdevice "ETouch" "SendCoreEvents"
             EndSection

       2.4.2 Find the path of hiddev0 description file to add the following entry:

             For example, in Redhat 8.0, Redhat 9.0, Fedora Core 1, Fedora Core 2 and SUSE 9.3:

                Section "InputDevice"
                Identifier "ETouch"
                Driver "ETouch"
                Option "Device" "/dev/usb/hiddev0"
                EndSection

             For example, in Fedora Core 3, Fedora Core 4, Fedora Core 5 and SUSE 10.0:

                Section "InputDevice"
                Identifier "ETouch"
                Driver "ETouch"
                Option "Device" "/dev/hiddev0"
                EndSection

       2.4.4 Save changes to the configuration file and exit the editor.

   2.5 Copy the ETouch_drv.o file from /home/touch_CD to the directory that it
       stores the module object files of X server. You can refer to the X server
       log file.

       For example, in Fedora Core 5:

          cp /home/touch_CD/obj/ETouch_drv.o /usr/lib/xorg/modules/input

       For example, in Fedora Core 1:

          cp /home/touch_CD/obj/ETouch_drv.o /usr/X11R6/lib/modules/input

   2.6 Copy three tools "tscpl", "liftoff" and "swap" to the directory /usr/bin.
       Their functionality was described in file list. In order to access them
       easily, you can copy them to your Desktop.

   2.7 Make sure to plug the controller into USB port before reboot the computer.

   2.8 When first time start X Window, the touch point may not accurately match 
       to the cursor on the screen, please execute /usr/bin/tscpl
       to calibrate the touch screen:

          cd /usr/bin

          ./tscpl

   2.9 Please don't use virtual desktop environment with touch screen, because
       it will not calibrate accurately.


=====
Notes
=====
1. Please pay attention to Uppercase and Lowercase when typing the above-mentioned 
   command examples,Linux commands are case-sensitive.

2. If you still have problem with the driver installation, please type

      startx &> startx.out

   This will create startx.out with some debug information. Please send back
   the start.out log to tech@magictouch.com for trouble-shooting.
