****************************************************
  README.TXT for the Linux USB Touch Panel Driver

  touch_linux_usb_v2.10.2
  released date: 2007.8.2
****************************************************


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


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

   Debian 4.0

   Fedora Core 6, Fedora 7

   openSUSE 10.3

   Ubuntu 7.04


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

   readme.txt            This file which it described what distributions
                         supported, what this package contain and how to install

                         this package by automatically or manually.
   install_Debian4.0     A shell script which automatically install ETouch

                         driver related in Debian 4.0.

   uninstall_Debian4.0   A shell script which automatically remove ETouch driver

                         related in Debian 4.0.

   install_Fedora6       A shell script which automatically install ETouch

                         driver related in Fedora Core 6.
   uninstall_Fedora6     A shell script which automatically remove ETouch driver

                         related in Fedora Core 6.

   install_Fedora7       A shell script which automatically install ETouch
                         driver related in Fedora 7.
   uninstall_Fedora7     A shell script which automatically remove ETouch driver

                         related in Fedora 7.
   install_SUSE10.3      A shell script which automatically install ETouch
                         driver related in openSUSE 10.3.
   uninstall_SUSE10.3    A shell script which automatically remove ETouch driver

                         related in openSUSE 10.3.

   install_Ubuntu7.04    A shell script which automatically install ETouch
                         driver related in Ubuntu 7.04.
   uninstall_Ubuntu7.04  A shell script which automatically remove ETouch driver

                         related in Ubuntu 7.04.
   driver/ETouch_drv.so  The object file of the ETouch driver.
   driver/ETouch_drv.o   The old format object file of the ETouch driver.

   utility/Calibration   A calibration tool which it makes the touch point of
                         panel matched with the cursor on screen.

                         Need to run as a root user account.

   utility/Lift-off      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.
   utility/Swap          This tool is used to swap touch or lift-off definition

                         which is between left and right mouse buttons.


====================
 Installation Guide
====================
Please follow automatic installation procedures for the supported distributions

as above. If the distribution is not listed in supported list, you can do
manual
installation steps. Please make sure your Linux & X Window System is
working properly before the installation. Make sure login as root to do the
installation
and calibration. Open a terminal session to do the following
automatic or manual
installation steps.

Notice: Please plug in the touch controller to USB port before installing.

1. Automatic Installation Procedures

   1.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

       Copy all 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

          ./install_Debian4.0   (for Debian 4.0)

       or

          ./install_Fedora6	(for Fedora Core 6)

       or

          ./install_Fedora7     (for Fedora 7)

       or

          ./install_SUSE10.3	(for openSUSE 10.3)

       or

          ./install_Ubuntu7.04  (for Ubuntu 7.04)


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

   1.3 After system reboot complete, you have to execute "Calibration" to do the
       calibration for 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. You have to
       touch it by your fingertip or the tip of pen. The program will display
       additional two circles with cross inside, please touch them as well.

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

       The tool "Calibration" which it makes the touch point of panel matched
       with the cursor on screen.

       The tool "Lift-off" which it 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 or lift-off definition which is
       between left and right mouse buttons.

   1.5 In order to access these tools easily, the auto-install shell script will
       create icons onto 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/xorg.conf is used by system if you are running
       Debian 4.0, Fedora Core 6, Fedora 7, openSUSE 10.3 or Ubuntu 7.04.

       Otherwise, you have to find out the configuration file which is used by

       operating system you are running.

          cp /etc/X11/xorg.conf  /etc/X11/xorg.conf.bak.touch

   2.4 Use editor, for example the vi, to add strings to /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 Fedora Core 6 and openSUSE 10.3:

             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.so file from /home/touch_CD/driver to the directory
       that it stores the module object files of X server. You can refer to the
       X server log file.

       2.5.1 For example, in Fedora Core 6:

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

       2.5.2 If you are running Fedora Core 6 or Fedora 7, please check the

             state of SELinux by referring the /etc/selinux/config file. If
             SELinux is enabled on your system, you must change security context

             of ETouch_drv.so file. Or else the driver couldn't be loaded

             successfully while X server starting.

             chcon -t textrel_shlib_t /usr/lib/xorg/modules/input/ETouch_drv.so

   2.6 Copy three tools "Calibration", "Lift-off" and "Swap" to the directory

       /usr/bin. Their functionality was described in file list. In order to

       access them conveniently, you can copy them to your Desktop.

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

       computer.

   2.8 When first time start X Window, the touch controller may be not
       accurately matched to the screen, please execute

       /usr/local/bin/Calibration to calibrate the touch screen:

          cd /usr/local/bin

          ./Calibration

   2.9 Please don't use virtual desktop environment with touch screen, due to
       it will not accurately for calibration.


======
 Note
======
1. Please pay attention with Uppercase and Lowercase on above 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 us for trouble-shooting.
