本文提供有关Elo触摸屏Linux驱动程序APR (USB) v2.1.0和安装说明的信息

以下是Elo触摸屏Linux驱动程序APR (USB) v2.1.0的安装说明。

该驱动程序已过时且不再支持。


Elo触摸屏Linux驱动程序 - APR (USB)

                   Intel i686 (32位)或AMD64/Intel (64位)
           
                    安装/卸载说明

--------------------------------------------------------------------------------         
             
                                  版本2.1.0 
                                2010年1月14日
                                Elo TouchSystems

================================================================================    

Elo Linux APR驱动程序包包含专为Linux 2.6内核设计的Linux驱动程序、图形控制面板和Elo APR触摸监视器的命令行控制面板实用程序。此驱动程序需要libusb-1.0库才能正确运行。请参见第3节以安装libusb-1.0库。


该自述文件的内容组织如下：

  1. 支持的触摸监视器和Elo触摸屏控制器
  2. 系统要求
  3. 安装libusb-1.0库
  4. 安装Elo触摸屏APR驱动程序
  5. APR驱动程序命令行选项及用法
  6. 访问控制面板
  7. 卸载Elo触摸屏APR驱动程序
  8. 联系Elo TouchSystems




==========================================================
1. 支持的触摸监视器和Elo触摸屏控制器
==========================================================

 - Elo APR (USB) 控制器 (APR 7000/7001)




======================
2. 系统要求
======================

 - 32位Intel i686 (x86)平台 (或)   [访问 www.elotouch.com 的Linux下载部分以下载适用于您的32位或64位Linux的驱动程序包]
 - 64位AMD/Intel x86_64平台

 - 支持的内核：
    内核版本2.6

 - 支持的libusb版本：
    libusb 1.0 (libusb-1.0.so.0)

 - 支持的Motif版本：
    Motif版本4.0 (libXm.so.4)
    Motif版本3.0 (libXm.so.3)

 - 支持的libusb版本：
    libusb版本1.0 




====================================
3. 安装libusb-1.0库
====================================

重要：
==========
a.) 必须在Linux系统上拥有管理员访问权限才能安装libusb-1.0库。
 
b.) 要从源代码构建libusb-1.0库，必须具有包含gcc、make等必要包的开发环境。请参考libusb-1.0源代码文档以获取更多详细信息。

c.) libusb-1.0函数使用“usbfs”文件系统与USB设备交互。如果在使用libusb-1.0函数时收到错误，请确保“usbfs”已挂载并处于活动状态。

d.) 此驱动程序将无法与较旧的libusb-0.1库一起使用。



Elo APR触摸屏Linux驱动程序组件现在要求libusb-1.0库支持（较旧的libusb-0.1库无法工作）。可以从各种Linux发行版提供的二进制包中安装此libusb-1.0库。也可以通过编译从libusb-1.0网站上下载的libusb-1.0源包安装该库。



从二进制包安装libusb-1.0库
-----------------------------------------------

最新的Linux发行版（例如：OpenSuse 11.1、Ubuntu 9.04、Fedora 10等）已开始将此库作为其标准发布的一部分（更新至流行的libusb-0.1库）进行提供。您仍然可能需要选择并从CD/DVD映像或在线软件包仓库中安装该库。

请查看下面提供的命令以在某些Linux发行版上安装libusb-1.0库的二进制包。

# yum install libusb1        [ Fedora 10 ]

# apt-get install libusb-1.0-0    [ Ubuntu 9.04 ]    


 
从源代码安装libusb-1.0库
-------------------------------------------

如果您的发行版（例如：OpenSuse 10.3、Ubuntu 8.04、Fedora 8等）没有libusb-1.0库的二进制包，您可以从libusb-1.0网站下载该库的最新源代码，轻松编译并安装。
 
网站         - http://libusb.wiki.sourceforge.net/Libusb1.0   
下载源 - http://sourceforge.net/projects/libusb/files/libusb-1.0/


解压库源代码，然后运行以下命令以从主要库文件夹配置、编译和安装库。
 
# cd libusb-1.0.0
# ./configure
# make
# make install

Intel 32位i686平台:
- - - - - - - - - - - - -    

# ln  -s  /usr/local/lib/libusb-1.0.so.0  /usr/lib/libusb-1.0.so.0        

(或)

AMD64/Intel 64位x86_64平台:   
- - - - - - - - - - - - - - - - - 

# ln  -s  /usr/local/lib64/libusb-1.0.so.0  /usr/lib64/libusb-1.0.so.0    


较旧的Linux发行版可能由于gcc编译器版本的原因对编译此库源代码存在一些限制。请参考libusb-1.0源代码文档以获取更多详细信息。




============================================
4. 安装Elo触摸屏APR驱动程序
============================================

重要：
==========
a.) 必须在Linux系统上拥有管理员访问权限才能安装Elo触摸屏APR驱动程序。
 
b.) 确保系统中卸载所有早期的Elo驱动程序。

c.) 请勿在Windows系统上解压下载的二进制包。

d.) 此驱动程序仅在Linux内核版本2.6上工作。

e.) 确保在继续进行触摸屏驱动程序安装之前已安装libusb-1.0库（libusb-1_0-0-0.9.3-4.22或libusb-1.0-0包）。

f.) 使用图形用户界面（GUI）控制面板（/etc/opt/elo-apr/cpl）需要Motif 4.0（libXm.so.4）或Motif 3.0（libXm.so.3）库。Openmotif、libmotif、libopenmotif或lesstif安装包提供所需的libXm.so.4或libXm.so.3库。

g.) 确保在安装驱动程序时，APR触摸屏已连接到系统，并在驱动程序安装后重启时保持连接。



步骤一：
-------

将Elo APR驱动程序文件从解压后的“bin-apr”二进制文件夹复制到默认的elo文件夹（/etc/opt/elo-apr）。确保APR触摸屏已连接到系统并继续进行特征数据文件下载。

  # cp -r ./bin-apr/  /etc/opt/elo-apr
  # cd /etc/opt/elo-apr

现在从终端运行驱动程序以检测新的APR触摸屏并下载特征数据文件。此数据下载将需要几分钟完成，并且每个触摸屏仅需进行一次。此数据存储在硬盘上，每个触摸屏都是唯一的，驱动程序用它来与特定的触摸屏一起工作。

  # cd /etc/opt/elo-apr
  # ./eloapr

数据下载完成后，驱动程序将开始响应任何用户（root或普通用户）的触摸输入。下一次系统重启后，登录屏幕也应能使用触摸。



步骤二：
--------

OpenSuse和Suse Enterprise Linux系统：
- - - - - - - - - - - - - - - - - - - - - -
将Elo APR驱动程序udev规则文件（99-elotouch-suse.rules）复制到udev规则文件夹"/etc/udev/rules.d/"。如果您的Xserver不使用X身份验证，请在"/etc/udev/rules.d/99-elotouch-suse.rules"文件中向eloapr启动行添加"--noxauthentication"命令行参数。

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-suse.rules /etc/udev/rules.d/


拔掉并重新插拔APR触摸屏并检查触摸是否有效。如果触摸仍未恢复，请修改APR UDEV规则文件以适应Linux发行版。检查/etc/opt/elo-apr/setup文件夹和/etc/udev/rules.d文件夹中的可用udev规则文件以获取可能的修改。


Debian、Ubuntu和Gentoo系统：
- - - - - - - - - - - - - - - - - 
将Elo APR驱动程序udev规则文件（99-elotouch-ubuntu.rules）复制到udev规则文件夹"/etc/udev/rules.d/"。如果您的Xserver不使用X身份验证，请在"/etc/udev/rules.d/99-elotouch-ubuntu.rules"文件中向eloapr启动行添加"--noxauthentication"命令行参数。

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-ubuntu.rules /etc/udev/rules.d/


拔掉并重新插拔APR触摸屏并检查触摸是否有效。如果触摸仍未恢复，请修改APR UDEV规则文件以适应Linux发行版。检查/etc/opt/elo-apr/setup文件夹和/etc/udev/rules.d文件夹中的可用udev规则文件以获取可能的修改。


Slackware和Redhat Enterprise Linux系统：
- - - - - - - - - - - - - - - - - - - - - - - 
将Elo APR驱动程序udev规则文件（99-elotouch-rhel.rules）复制到udev规则文件夹"/etc/udev/rules.d/"。如果您的Xserver不使用X身份验证，请在"/etc/udev/rules.d/99-elotouch-rhel.rules"文件中向eloapr启动行添加"--noxauthentication"命令行参数。

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-rhel.rules /etc/udev/rules.d/


拔掉并重新插拔APR触摸屏并检查触摸是否有效。如果触摸仍未恢复，请修改APR UDEV规则文件以适应Linux发行版。检查/etc/opt/elo-apr/setup文件夹和/etc/udev/rules.d文件夹中的可用udev规则文件以获取可能的修改。


Fedora系统：
- - - - - - - - 
将Elo APR驱动程序udev规则文件（99-elotouch-fedora.rules）复制到udev规则文件夹"/etc/udev/rules.d/"。如果您的Xserver不使用X身份验证，请在"/etc/udev/rules.d/99-elotouch-fedora.rules"文件中向eloapr启动行添加"--noxauthentication"命令行参数。

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-fedora.rules /etc/udev/rules.d/


拔掉并重新插拔APR触摸屏并检查触摸是否有效。如果触摸仍未恢复，请修改APR UDEV规则文件以适应Linux发行版。检查/etc/opt/elo-apr/setup文件夹和/etc/udev/rules.d文件夹中的可用udev规则文件以获取可能的修改。


Mandriva系统：
- - - - - - - - -
将Elo APR驱动程序udev规则文件（99-elotouch-mandriva.rules）复制到udev规则文件夹"/etc/udev/rules.d/"。如果您的Xserver不使用X身份验证，请在"/etc/udev/rules.d/99-elotouch-mandriva.rules"文件中向eloapr启动行添加"--noxauthentication"命令行参数。

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-mandriva.rules /etc/udev/rules.d/


拔掉并重新插拔APR触摸屏并检查触摸是否有效。如果触摸仍未恢复，请修改APR UDEV规则文件以适应Linux发行版。检查/etc/opt/elo-apr/setup文件夹和/etc/udev/rules.d文件夹中的可用udev规则文件以获取可能的修改。



步骤三：
---------

确保Elo APR (USB)触摸屏已连接到计算机并重启您的系统。

  # shutdown -r now




===========================================
5. APR驱动程序命令行选项及用法
===========================================

APR (eloapr)驱动程序命令行选项如下所示。如有需要，修改Elo UDEV规则文件以向eloapr驱动程序启动添加命令行选项。

  --nobeepontouch     [ 禁用触摸时的蜂鸣声功能 ]

  --noxauthentication   [ 禁用X认证过程，对不需要身份验证程序来与Xserver交互的Xserver（嵌入式系统） ]

  --displaycoordinates    [ 在终端上显示每次触摸对应的触摸数据。触摸数据包括触摸状态（触摸/流/未触摸）以及X和Y坐标。此选项用于测试APR触摸屏，因此触摸数据仅显示而不发送到Xserver以移动鼠标指针。 ]

  --rotation    [ 启动APR驱动程序以支持相应的视频旋转模式。支持的视频旋转角度为0、90、180和270。 ]

  --aprmode_pos        [ 启动为销售点（POS）应用量身定制的Elo APR驱动程序（默认模式）。 ]

  --aprmode_general    [ 启动为一般应用量身定制的Elo APR驱动程序。 ]

  --aprmode_signature    [ 启动为签名应用量身定制的Elo APR驱动程序。 ]

  --aprmode_gaming    [ 启动为游戏应用量身定制的Elo APR驱动程序。 ]

  --custom_parameters    [ 启动Elo APR驱动程序并为特定APR模式提供自定义参数。自定义参数从/etc/opt/elo-apr/setup/customAprParameters.txt文件中读取。如果4种标准APR模式不合适，请联系Elo技术支持以获取自定义参数的帮助。自定义参数格式记录在customAprParameters.txt文件中，有效范围为Parameter_0到Parameter_37。  ]



用法示例：    
---------------

  eloapr --nobeepontouch
  
  eloapr --nobeepontouch --noxauthentication --aprmode_gaming

  eloapr --rotate 90

  eloapr --rotate 180 --displaycoordinates
  
  eloapr --aprmode_signature
  
  eloapr --aprmode_signature --custom_parameters  [ 加载标准APR签名模式，然后替换自定义参数文件中提供的一些参数。 ]

  eloapr --custom_parameters                      [ 加载标准APR销售点模式（默认），然后替换自定义参数文件中提供的一些参数。 ]




==============================
6. 访问控制面板 
==============================

控制面板应用程序允许用户轻松设置可用的驱动程序配置选项。安装并加载驱动程序后，切换到/etc/opt/elo-apr文件夹并运行控制面板应用程序。


重要：
==========

用户必须具有管理员或root权限才能运行控制面板应用程序。


步骤一：
-------

在X Windows的命令窗口中从/etc/opt/elo-apr文件夹运行控制面板实用程序。使用图形用户界面（GUI）控制面板（/etc/opt/elo-apr/cpl）需要Motif版本4.0（libXm.so.4）或Motif版本3.0（libXm.so.3）。

  # cd /etc/opt/elo-apr
  # ./cpl 



步骤二：
--------

通过单击各个选项卡浏览。以下是与每个选项卡相关的信息概述。

  常规    - 一般触摸屏信息
  模式       - 更改触摸屏模式
  属性 - 显示与APR触摸监视器相关的数据
  关于      - 有关该软件包的信息。单击“阅读我”按钮以打开此readme.txt文件。
    


步骤三：
---------

如果未安装Motif，请使用该应用程序的命令行版本访问控制面板。从/etc/opt/elo-apr文件夹的X Windows命令窗口运行命令行应用程序。

  # cd /etc/opt/elo-apr
  # ./cplcmd




==============================================
7. 卸载Elo触摸屏APR驱动程序
==============================================


重要：
==========
a.) 必须在Linux系统上拥有管理员访问权限才能卸载Elo触摸屏APR驱动程序。
 
b.) 所有已经下载到硬盘的触摸屏特征数据将被删除。  


步骤一：
-------

删除在安装步骤二中复制到udev规则文件夹"/etc/udev/rules.d"的Elo APR驱动程序udev规则文件（99-elotouch-*.rules）。

  # cd /etc/udev/rules.d
  # rm -i /etc/udev/rules.d/99-elotouch-*.rules


步骤二：
--------

删除主Elo APR驱动程序文件夹"/etc/opt/elo-apr"中的Elo APR驱动程序文件和文件夹，该文件夹是在安装步骤一中创建的。 

  # cd /etc/opt
  # rm -rf /etc/opt/elo-apr


重启系统以完成卸载过程。

  # shutdown -r now




==============================
8. 联系Elo TouchSystems
==============================

网站: http://www.elotouch.com


电子邮件: customerservice@elotouch.com


邮寄地址：
----------------

  Elo TouchSystems
  A Tyco Electronics Business 
  301 Constitution Drive
  Menlo Park, CA 94025
  USA

  电话:   (800) 557-1458
           (650) 361-4800

  传真:     (650) 361-4722

--------------------------------  

  Elo TouchSystems GmbH & Co. KG
  Haidgraben 6
  D-85521 Ottobrunn
  Germany
         
  电话: +49 (0) 89/60822-0
  传真:   +49 (0) 89/60822-150

--------------------------------  

  Elo TouchSystems, NV
  Diestsesteenweg 692
  B-3010 Kessel-Lo
  Belgium

  电话: +32 (16) 35-2100
  传真:   +32 (16) 35-2101


================================================================================    

                       Copyright (c) 2010 Elo TouchSystems

                              保留所有权利。

================================================================================