===================================================================== Elo Touchscreen Linux Driver - APR (USB) Installation/Uninstallation Instructions --------------------------------------------------------------------- Version 1.1 beta1 October 17, 2008 Elo TouchSystems ===================================================================== Elo Linux APR Driver package contains Linux drivers designed for Linux 2.6 kernel, graphic control panel and commandline control panel utilities for Elo APR touchmonitors. This driver works only for kernel versions 2.6.24 and below. This readme file is organized as follows: 1. Supported Touchmonitors and Elo Touchscreen Controllers 2. System Requirements 3. Installing the Elo Touchscreen APR Driver 4. Accessing the Control Panel 5. Uninstalling the Elo Touchscreen APR Driver 6. Contacting Elo TouchSystems ========================================================== 1. Supported Touchmonitors and Elo Touchscreen Controllers ========================================================== - Elo APR (USB) Controllers (APR 7000/7001) ====================== 2. System Requirements ====================== - 32 bit x86 platforms only - Kernels supported: Kernel version 2.6.24 and below - Motif versions supported: Motif version 3.0 (libXm.so.3) Note: ===== The same binaries folder can be used for installation on other machines using the same kernel. ============================================ 3. Installing the Elo Touchscreen APR Driver ============================================ Important: ========== a.) Must have administrator access rights on the Linux machine to install the Elo Touchscreen APR Driver. b.) Ensure all earlier Elo drivers are uninstalled from the system. c.) Do not extract the downloaded binary package on a Windows system. d.) If you wish to build a new kernel module for your kernel, the environment should be setup for building kernel modules. Check if necessary packages like gcc, make, kernel header files or kernel sources are installed. Refer to other documentation on setting up the system for building loadable kernel modules. e.) This driver will work only on kernel versions 2.6.24 and below. f.) Motif 3.0 (libXm.so.3) library is required to use the Graphic User Interface (GUI) based control panel (/elo/cpl). Openmotif, libopenmotif3-2.2.3 or lesstif installation packages provide the required libXm.so.3 library. g.) Ensure that the APR touchscreen is connected via USB before running the install.sh script in Installation Step IV. Step I: ------- Copy the Elo APR driver files from the extracted "bin-apr" binary folder to the default elo folder (/elo). > cp -r ./bin-apr/ /elo > cd /elo Step II: -------- Check if the kernel version for the usb_eloapr kernel module (see the kernel version listed in the kernel module name) matches your current system's kernel version. If the kernel versions match, skip Step III and proceed to Step IV. > uname -r [ List your current kernel version ] > ls -l /elo/usb_eloapr* [ List the kernel module name that contains the kernel version ] Step III: --------- Compile and build a new kernel module (usb_eloapr.ko) for your system kernel if required. The kernel module source is present in the /elo/EloAprKrnlDrvr_src folder. Kernel source or header files, gcc, make and other development tools are needed to build a kernel module. Type "make install" to copy the kernel module to /elo folder or use the cp command to manually copy the new kernel module to the /elo folder and rename it with your current kernel version. > cd /elo/EloAprKrnlDrvr_src > make > make install (or) > cp /elo/EloAprKrnlDrvr_src/usb_eloapr.ko /elo/usb_eloapr-`uname -r`.ko Step IV: -------- Ensure that the Elo APR (USB) touchscreen is connected to the computer. Run the install.sh script from the /elo/setup folder to install the Linux APR driver. > cd /elo/setup > ./install.sh The install.sh script will install all the necessary driver components and then proceed to download the touchscreen characterization data. This data download will take a few minutes to complete and is done only once per touchscreen. This data, stored on the hard disk, is unique for every touchscreen and used by the driver to work with a specific touchscreen. This data will be erased only when the driver is uninstalled. Once the data download is complete the driver will start responding to user's touch input. ============================== 4. Accessing the Control Panel ============================== The control panel application allows the user to easily set the available driver configuration options. After the driver package is installed, change to the /elo folder and run control panel application. Important: ========== Users must have administrator or root access to run the control panel applications. Step I: ------- Run the control panel utility from a command window in X Windows from the /elo folder. Motif version 3.0 (libXm.so.3) is required to use the GUI based control panel (/elo/cpl). > cd /elo > ./cpl Step II: -------- Navigate through the various tabs by clicking on them. Here is an overview of information related to each tab. General - General touchscreen information Mode - Change the touchscreen mode Properties - Display data related to the APR touch monitor About - Information about the package. Click on the Readme button to open this readme.txt file. Step III: --------- If Motif is not installed, use the command line version of the application to access the control panel. Run the command line application from a command window in X Windows from the /elo folder. > cd /elo > ./cplcmd ============================================== 5. Uninstalling the Elo Touchscreen APR Driver ============================================== Important: ========== a.) Must have administrator access rights on the Linux machine to uninstall the Elo Touchscreen APR Driver. b.) All the touchscreen characterization data that have been downloaded to the hard disk will be erased. Step I: ------- Change the current folder to the default elo setup folder (/elo/setup). > cd /elo/setup Step II: -------- Run the uninstall.sh shell script in the /elo/setup folder to uninstall the Elo Linux APR driver. All the touchscreen characterization data that have been downloaded to the hard disk will be erased. The files needed to reinstall the driver will still be available in the /elo folder. > ./uninstall.sh ============================== 6. Contacting Elo TouchSystems ============================== Website: http://www.elotouch.com E-mail: customerservice@elotouch.com Mailing Address: ---------------- Elo TouchSystems, 301 Constitution Dr., Menlo Park, CA 94025 USA Phone: (800) 557-1458 (650) 361-4700 Fax: (650) 361-4722 -------------------------------- Elo TouchSystems GmbH & Co. KG Haidgraben 6 D-85521 Ottobrunn Germany Phone: +49 (0) 89/60822-0 Fax: +49 (0) 89/60822-150 -------------------------------- Elo TouchSystems, NV Diestsesteenweg 692 B-3010 Kessel-Lo Belgium Phone: +32 (16) 35-2100 Fax: +32 (16) 35-2101 ===================================================================== Copyright (c) 2008 Elo TouchSystems All rights reserved. =====================================================================