﻿# ===================== Drvier Version ============================= #

     TouchKit driver for 32bit Linux kernel 2.6.x with Xorg 1.4.0

Driver version: 2.03.1712-32b-k26-x14
Module version: 2.03
Utilty version: 2.03.1712
                                        released date: 2008/05/12

# ==================== Installation Guide ========================== #

(*) Installation with script file:
    User can use the script file "setup.sh" to install 
    the driver package easily in a terminal window.

    Syntax:
        sh setup.sh            # To install the TouchKti driver.
    or  sh setup.sh uninstall  # To remove the TouchKit driver.
    or  sh setup.sh version    # To get the installer version.

    Note that the root permission is required to run this 
    installation script. Otherwise, below error messages would be 
    popped up. ( Assume, the working system is Ubuntu 8.04 )

    test@test-desktop:~$ sh setup.sh
    (*) Linux driver installer for TouchKit controller

    (I) Begin to setup TouchKit driver.
    (I) Checking user permission: test, you are NOT the supervisor.
    (E) The root permission is required to run this installer.

    The user can get the root permission by the following command.
    For example:
                su        ( For general Linux )
            or  sudo -s   ( For Ubuntu series only )

(*) Driver package installation:

    root@test-desktop:~# sh setup.sh
    (*) Linux driver installer for TouchKit controller

    (I) Begin to setup TouchKit driver.
    (I) Checking user permission: root, you are the supervisor.
    (I) Extract TouchKit driver package to /usr/local/TouchKit_x14.
    (I) Create TouchKit utility shortcut in /usr/bin.
    (I) Copy X module egalax_drv.so to /usr/lib/xorg/modules/input.

    (Q) Which interface of controller do you use?
    (I) [1] RS232 [2] PS/2 [3] USB: 1
    (Q) Which COM port will be connected? e.g. /dev/ttyS0 (COM1)
    (A) Please input: /dev/ttyS0

    (I) Found X configuration file xorg.conf in /etc/X11
    (I) Add touch configuration into /etc/X11/xorg.conf

    (I) Please reboot the system for some changes to take effect.

  1. For serial RS232 interface:
    (Q) Which interface controller do you use?
    (I) [1] RS232 [2] PS/2 [3] USB: 1
    (Q) Which COM port will be connected? e.g. /dev/ttyS0 (COM1)
    (A) Please input: /dev/ttyS4

    Note that the user must input correct serial device node
    where the controller connected.
    For example:
            /dev/ttyS4    ( Connected to COM5 )

  2. For PS/2 interface:
    (Q) Which interface controller do you use?
    (I) [1] RS232 [2] PS/2 [3] USB: 2
    (I) Using interface: PS/2
    (I) Please make sure the kernel module for PS/2 controller
        is available.
    (I) For details, see the document "How to rebuild kernel.pdf".

  3. For USB interface:
    (Q) Which interface controller do you use?
    (I) [1] RS232 [2] PS/2 [3] USB: 3
    (I) Using interface: USB
    (I) Found a HID compliant touch controller.
    (I) Found kernel module usbtouchscreen.
    (I) It is highly recommended that add it into blacklist.
    (Q) Do you want to add it into blacklist? (y/n) y
    (I) Add kernel module usbtouchscreen into
        /etc/modprobe.d/blacklist.

    Note that it is highly recommended that add inbuilt kernel
    module "usbtouchscreen" or "touchkitusb" into blacklist to
    avoid conflict if the touch controller is HID compliant device
    and the inbuilt kernel module "usbtouchscreen" or "touchkitusb"
    is loaded in the kernel.

    (Q) Which interface controller do you use?
    (I) [1] RS232 [2] PS/2 [3] USB: 3
    (I) Using interface: USB
    (I) Found a non-HID compliant touch controller.
    (W) No suitable kernel module found.
    (I) The user must build tkusb kernel module for touch controller.
    (I) For details, see the document "How to build module.pdf".

    Note that the user needs to build the TouchKit kernel module
    "tkusb" for touch controller if the inbuilt kernel module
    "usbtouchscreen" or "touchkitusb" does NOT exist.

(*) Driver package un-installation

    root@test-desktop:~# sh setup.sh uninstall
    (*) Linux driver installer for TouchKit controller

    (I) Begin to remove TouchKit driver.
    (I) Checking user permission: root, you are the supervisor.
    (I) Removed TouchKit driver from /usr/local/TouchKit_x14.
    (I) Removed TouchKit utility shortcut.
    (I) Removed X module.
    (I) Found X configuration file xorg.conf in /etc/X11.
    (I) Removed touch configuration in /etc/X11/xorg.conf.

    (I) The TouchKit driver has been removed successfully.
    (I) Please reboot the system for some changes to take effect.

(*) The version of the installer

    root@test-desktop:~# sh setup.sh version
    (*) Linux driver installer for TouchKit controller

    (I) Version: 1.00.0325

    For more information about X configuration setting, please see
    the section "Installation of the Xorg module manually" in the
    document "Driver Guide.pdf".

# ================================================================== #
