 
*****************************************************************************************************************
*   README file of ETWOTOUCH Touchscreen driver of USB interface for Linux X Window System(xorg 7.x.x)
*	Support linux 2.6.25 kernel	
*   Copyright 2001-2008 ETWOTOUCH ELECTRONIC EQUIPMENT Co.,Ltd Guangzhou China.
*****************************************************************************************************************

  This Driver Version 1.0.2 compiled for Xorg7.x.x,with supports for revolving Touch Screen by 90 degree,180 degree and 270 degree, and adjustable touching precision,.
  
  This touchscreen driver package consists of 5 files:
    1. etwousb_drv.so (a touchscreen driver for USB interface),
    2. etwocalibusb (a calibration utility ),
    3. this readme file,
    4. a chinese readmeCN file,
    5. an install sh.
    
  Supported controller:
       --- ETWOTOUCH ELECTRONIC EQUIPMENT Co.,Ltd USB controller Model: 5001U and etc.

******************************  CONTENTS  ***************************************
1. Install touch screen driver, calibration utility, and calibrate it.
   (I assume that you have properly installed ETwoTouch Touch Screen hardware.)
2. Valid entries for each of the lines in the Section.
3. Trouble shooting.
*********************************************************************************
1. Install touch screen driver, calibration utility, and calibrate it.
  ( I assume that you have properly installed our ETWOTOUCH Touchscreen hardware. )
********
  !!After you have done step 1.1 to 1.6 step by step,the SETUP will be finished and the ETwoTouch Screen will work for you !!
**
  (1.1).After installing the hardware, boot your system as root.
**
  (1.2).To install the driver, go to console and chang the direction to the driver folder ETwoTouchUSBLinuxDrvV1.2.0.
        you can type ./install to automatically install this driver or manually install as bellow:
          cp etwousb_drv.so /usr/lib/xorg/modules/input
          cp etwocalusb  /usr/local/bin
**
  (1.3). Add the touch screen device configuration to X Window Config file: /etc/X11/xorg.conf
    <1.3.1>.bakeup the xorg.conf file before edit it as bellow.
    <1.3.2>.Add the following lines to the Section "ServerLayout"
	Inputdevice   "touchscreenusb"  "SendCoreEvents"  
	Option		"AutoAddDevices" "off"               #this is needs.
    <1.3.3>.Find out which event the ETwoTouch USB touchscreen is attached to. (Be sure you have plug the ETwoTouch usb device into usb port.)
          (a) use "cat /proc/bus/input/devices" in terminal,you will see "Name=ETWO Co. Ltd. ETWO USB TOUCHSCREEN" and "Handlers=event*"
    <1.3.4>.Add the following section to the xorg.conf file:

Section "InputDevice"	
	Identifier  	"touchscreenusb"
	Driver    	"etwousb"
	Option    "Device" "/dev/input/event*"  #fill the event* that you have found out in step1.3.4(for example:/dev/input/event3)
	Option    	"AlwaysCore"
	Option    	"ScreenNumber" "0"
	Option    	"MouseMode"   "1"
   	Option  	"BorderLeft"    "85"
    	Option  	"BorderRight"   "1069"
    	Option  	"BorderTop"    "5"
    	Option  	"BorderBottom"  "961"
	Option 	"MoveStep"     "8"
	Option		"RBDelay" "2"
EndSection

**
  (1.4).Save the Config file, and then restart the system.
	Note: In the linux 2.6.25 kernel, HID device is auto adding to system. It is needs for restart the system.
**
  (1.5).run the touchscreen calibrating program etwocalibusb,and then write the calibrating results to the xorg.conf.
    like this: etwocalusb /dev/input/event*  (the results will be save to /tmp/etwocalusb.tmp)
**
  (1.6).Restarting the system, the touch screen device will work.
    Note: After calibrating and save to the X config file , you should restart X Window to make the calibration take effect.

*************************************************
2.Valid entries for each of the lines in the subsection are as follows:
*********
Device
    - identifies the usb input event to which the controller is attached
	- use "/dev/input/event2" for event2
ScreenNumber
	- in a multi-monitor system, identifies which monitor the touchscreen is mounted on.
	- use 0 for a single monitor system
AlwaysCore
	- enables sharing of the core pointer (you want to do this)
	- does not require any parameters
BorderLeft
	- used together with the BorderRight value to calibrate the X axis of the 
          touchscreen,try an initial value of 238
BorderRight
	- used together with the BorderLeft value to calibrate the X axis of the 
          touchscreen,try an initial value of 1287
BorderTop
	- used together with the BorderBottom value to calibrate the Y axis of the 
          touchscreen,try an initial value of 412
BorderBottom
	- used together with the BorderTop value to calibrate the Y axis of the 
          touchscreen,try an initial value of 1240
MoveStep
    -- This is the precision that prevent the coursor from moving unless your touch point move over the MoveStep distance.
    -- the value of MoveStep can be 0, whice is the most precise of your finger motion. you can change it to 1,2, 3,...10,... on     your need.
RBDelayY
     -- This is the right button delay click time(about seconds). If it is 0 ,right button is not effect.

***************************************************
3. Trouble shooting.
**********
(3.1).The usb touch screen seems not work again? please "cat /proc/bus/input/devices" and find out "Name=ETWO Co. Ltd. ETWO USB TOUCHSCREEN",
"Handlers=event*".If this event* dosn't match the the event* of X config,then modify the event* of X config file with the "Handlers=event*"
(3.2).After modify the X Config file, you can't start the X? 
    Recover the backup config file(cp /etc/X11/xorg.conf-bk /etc/X11/xorg.conf),and then remodify the file.
(3.3).Replug the USB touchscreen while using it may cause the USB touchscreen attach to another event device name, so you should reconfig the xorg.conf for this change.
**********************************************************************************************
*        Copyright 2001-2007 ETWOTOUCH ELECTRONIC EQUIPMENT Co.,Ltd Guangzhou China.
*                                All rights reserved.
**********************************************************************************************
             Welcome to OUR TOUCH WORLD : http://www.etwotouch.com
		 
      ***********THANK YOU FOR USING ETWOTOUCH PRODUCTS.***************      
          
