本文提供 Elo Touchscreen Linux Driver - APR (USB) v2.20 的信息和安装说明
以下是 Elo Touchscreen Linux Driver APR (USB) v2.20 安装说明。
此驱动程序已过时，不再支持。
Elo Touchscreen Linux Driver - APR (USB)
Intel i686 (32位) 或 AMD64/Intel (64位)
安装/卸载说明
--------------------------------------------------------------------------------
版本 2.2.0
2010年10月07日
Elo TouchSystems
================================================================================
Elo Linux APR 驱动程序包包含为 Linux 2.6
内核设计的 Linux 驱动程序、图形控制面板和命令行控制面板工具，用于 Elo
APR 触摸显示器。此驱动程序需要 libusb-1.0 库才能正常工作。有关安装 libusb-1.0 库的信息，请参见第 3 节。
此自述文件的结构如下：
1. 支持的触摸显示器和 Elo 触摸屏控制器
2. 系统要求
3. 安装 libusb-1.0 库
4. 安装 Elo Touchscreen APR Driver
5. APR 驱动程序命令行选项和用法
6. 访问控制面板
7. 卸载 Elo Touchscreen APR Driver
8. 联系 Elo TouchSystems
==========================================================
1. 支持的触摸显示器和 Elo 触摸屏控制器
==========================================================
- Elo APR (USB) 控制器 (APR 7000/7001/7002)
======================
2. 系统要求
======================
- 32 位 Intel i686 (x86) 平台 (或) [访问 www.elotouch.com 的 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 库无法工作）。此 libusb-1.0 库可以从各个 Linux 发行版提供的二进制软件包中安装。该库也可以通过编译在 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 Touchscreen APR Driver
============================================
重要提示：
==========
a.) 必须在 Linux 系统上拥有管理员访问权限才能安装 Elo Touchscreen APR Driver。
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 触摸屏已连接到系统。
步骤 I:
-------
将解压缩的“bin-apr”二进制文件夹中的 Elo APR 驱动程序文件复制到默认的 elo 文件夹 (/etc/opt/elo-apr)。
# cp -r ./bin-apr/ /etc/opt/elo-apr
# cd /etc/opt/elo-apr
步骤 II:
--------
带有外部特征数据文件的 APR 触摸屏（在 USB 存储器上）：
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
如果 APR 触摸屏（例如：3200L 互动数字标牌显示器）随附 USB 存储器，请将 USB 存储器插入并在您的 Linux 发行版上挂载。
现在将外部特征数据文件从 USB 存储器复制到 APR 特征数据文件夹 (/etc/opt/elo-apr/ConfigData/APRCalData/) 并准确重命名为 "AprCF.bin" (aprcf.bin 将无法正常工作)。如果该文件夹不存在，请创建特征数据文件夹。如果 AprCF.bin 文件已存在，请覆盖它。
# mkdir -p /etc/opt/elo-apr/ConfigData/APRCalData/
# cp -r / /etc/opt/elo-apr/ConfigData/APRCalData/AprCF.bin
如果 USB 存储器挂载在 "/media/usbdisk" 上，且如果特征文件名为 "F102000120PD_U03"，请使用以下命令。根据需要修改 USB 挂载点和文件名。
# cp -r /media/usbdisk/F102000120PD_U03 /etc/opt/elo-apr/ConfigData/APRCalData/AprCF.bin
现在从终端运行驱动程序以检测新的 APR 触摸屏并开始使用新的 AprCF.bin 特征数据文件。
# cd /etc/opt/elo-apr
# ./eloapr
该驱动程序将开始对任何用户（root 或普通用户）的触摸输入做出响应。在下次系统重启后，触摸也应在登录屏幕上可用。
现在继续安装步骤 III。
带有内置特征数据文件的 APR 触摸屏：
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
确保 APR 触摸屏已连接到系统，并继续进行特征数据文件下载。
现在从终端运行驱动程序以检测新的 APR 触摸屏并下载特征数据文件。此数据下载将花费几分钟完成，并且每个触摸屏仅需执行一次。此数据存储在硬盘上，对每个触摸屏都是唯一的，驱动程序将使用其与特定触摸屏进行工作。
# cd /etc/opt/elo-apr
# ./eloapr
数据下载完成后，该驱动程序将开始对任何用户（root 或普通用户）的触摸输入做出响应。在下次系统重启后，触摸也应在登录屏幕上可用。
步骤 III:
---------
OpenSuse 和 Suse 企业 Linux 系统：
- - - - - - - - - - - - - - - - - - - - - -
将 Elo APR 驱动程序 udev 规则文件 (99-elotouch-suse.rules) 复制到 udev 规则文件夹 "/etc/udev/rules.d/"。如果您的 Xserver 不使用 X 身份验证，请在 "/etc/udev/rules.d/99-elotouch-suse.rules" 文件中，将 "--noxauthentication" 命令行参数添加到 eloapr 启动行。
# 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" 文件中，将 "--noxauthentication" 命令行参数添加到 eloapr 启动行。
# 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 企业 Linux 系统：
- - - - - - - - - - - - - - - - - - - - - - -
将 Elo APR 驱动程序 udev 规则文件 (99-elotouch-rhel.rules) 复制到 udev 规则文件夹 "/etc/udev/rules.d/"。如果您的 Xserver 不使用 X 身份验证，请在 "/etc/udev/rules.d/99-elotouch-rhel.rules" 文件中，将 "--noxauthentication" 命令行参数添加到 eloapr 启动行。
# 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" 文件中，将 "--noxauthentication" 命令行参数添加到 eloapr 启动行。
# 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" 文件中，将 "--noxauthentication" 命令行参数添加到 eloapr 启动行。
# 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 规则文件以进行可能的修改。
步骤 IV:
--------
确保 Elo APR (USB) 触摸屏已连接到计算机，并重启系统。
# shutdown -r now
===========================================
5. APR 驱动程序命令行选项和用法
===========================================
APR (eloapr) 驱动程序命令行选项如下所示。如有必要，请修改 Elo UDEV 规则文件以将命令行选项添加到 eloapr 驱动程序启动。
--nobeepontouch [ 禁用触摸时的蜂鸣声功能 ]
--noxauthentication [ 禁用 X 身份验证过程，用于不要求身份验证程序
与 Xserver 交互的 Xorg Xserver（嵌入式系统） ]
--displaycoordinates [ 显示与每个触摸相关的触摸数据，
在终端上。触摸数据由触摸状态（触摸/流/未触摸）和 X 及 Y
坐标组成。此选项用于测试 APR
触摸屏，因此触摸数据仅显示，不会发送到 Xserver 以移动鼠标指针。 ]
--rotation [ 启动 APR 驱动程序以支持相应的视频
旋转模式。支持的视频旋转角度为 0、90、180 和 270。 ]
--linearinputgain [ 更改线性输入增益指数。增益指数的有效范围为
0 到 45。 ]
--aprmode_pos [ 启动 Elo APR 驱动程序，专为销售点
(POS) 应用（默认模式）设计。 ]
--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 签名
模式，然后替换某些
custom parameter 文件中提供的参数。 ]
eloapr --custom_parameters [ 加载标准 APR POS 模式
（默认）并替换
custom parameter 文件中提供的一些参数。 ]
==============================
6. 访问控制面板
==============================
控制面板应用程序允许用户轻松设置可用的驱动程序配置选项。在驱动程序安装和加载后，切换到
/etc/opt/elo-apr 文件夹并运行控制面板应用程序。
重要提示：
==========
用户必须具有管理员或 root 访问权限才能运行控制面板
应用程序。
步骤 I:
-------
从 /etc/opt/elo-apr 文件夹中的命令窗口在 X Windows 中运行控制面板实用程序。使用 GUI 控制面板需要求 Motif 版本 4.0（libXm.so.4）或 Motif 版本 3.0（libXm.so.3）。
# cd /etc/opt/elo-apr
# ./cpl
步骤 II:
--------
通过单击不同的选项卡进行浏览。以下是每个选项卡相关信息的概述。
常规 - 通用触摸屏信息
模式 - 更改触摸屏模式
属性 - 显示与 APR 触摸显示器相关的数据
关于 - 有关该程序包的信息。单击“自述”按钮以打开此 readme.txt 文件。
步骤 III:
---------
如果未安装 Motif，请使用应用程序的命令行版本访问控制面板。通过在 X Windows 中的命令窗口运行命令行应用程序，从 /etc/opt/elo-apr 文件夹中运行。
# cd /etc/opt/elo-apr
# ./cplcmd
==============================================
7. 卸载 Elo Touchscreen APR Driver
==============================================
重要提示：
==========
a.) 必须在 Linux 系统上拥有管理员访问权限才能卸载
Elo Touchscreen APR Driver。
b.) 硬盘上下载的所有触摸屏特征数据将被删除。
步骤 I:
-------
移除已复制到 udev 规则文件夹 "/etc/udev/rules.d" 的 Elo APR 驱动程序 udev 规则文件(99-elotouch-*.rules)，该步骤在安装步骤 III 中进行。
# cd /etc/udev/rules.d
# rm -i /etc/udev/rules.d/99-elotouch-*.rules
步骤 II:
--------
删除在安装步骤 I 中创建的主要 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
================================================================================
版权所有 (c) 2010 Elo TouchSystems
保留所有权利。
================================================================================
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article