本文提供有关Elo多点触控Linux驱动程序,单点触控(ST)USB v4.0.1的安装说明
以下是Elo多点触控Linux驱动程序,单点触控(ST)USB v4.0.1的安装说明。
该驱动程序已经过时,并且不再支持。
Elo多点触控Linux驱动程序 - 单点触控(ST)USB
Intel i686(32位)或AMD64/Intel(64位)
安装/校准/卸载说明
--------------------------------------------------------------------------------
版本4.0.1
2014年11月11日
Elo Touch Solutions
===============================================================================
Elo Linux多点触控ST USB驱动程序包包含为Linux内核2.6.x和3.x.x(GCC版本4.0.0及以上)设计的用户空间Linux驱动程序,视频对齐工具和单点触控Elo触摸显示器的控制面板工具(不支持多点触控)。由于编译libusb-1.0库源代码的限制,该多USB触摸屏驱动程序仅在至少具有GCC版本4.0.0或更高版本的Linux发行版上工作。
该自述文件的组织结构如下:
1. 支持的触摸显示器和Elo触摸控制器
2. 系统要求
3. 安装Elo触摸屏USB驱动程序
4. USB驱动程序命令行选项和用法
5. 设置活动触摸区域
6. 校准触摸屏
7. 从NVRAM检索校准值/预校准(可选)
8. 访问控制面板
9. 卸载Elo触摸屏USB驱动程序
10. 故障排除
11. 联系Elo Touch Solutions
==========================================================
1. 支持的触摸显示器和Elo触摸控制器
==========================================================
- Elo Smartset USB控制器
(IntelliTouch(R) 2701,2700,2600,2500U,
CarrollTouch(R) 4500U,4000U,
Accutouch(R) 2216,3000U,2218,
表面电容5020,5010,5000,
声脉冲识别(APR)Smartset 7010
及其他Elo Smartset USB控制器)
======================
2. 系统要求
======================
- 32位Intel i686(x86)平台(或) [访问www.elotouch.com的Linux下载部分
64位AMD/Intel x86_64平台 下载适用于您的32或64位Linux的驱动程序包]
- 支持的内核:
内核版本2.6.x(GCC版本4.0.0及以上)
内核版本3.x.x
- 支持的Xorg Xwindows版本:
Xorg版本6.8.2 - 7.2
Xorg(Xserver)版本1.3 - 1.8
Xorg(Xserver)版本1.9及更新版本
- 支持的Motif版本:
Motif版本3.0(libXm.so.3)
- 支持的libusb版本:
libusb版本1.0
===============================================
3. 安装Elo触摸屏USB驱动程序
===============================================
重要:
==========
a.) 必须具有Linux计算机的管理员访问权限以
安装Elo触摸屏USB驱动程序。
b.) 确保系统中卸载所有早期的Elo驱动程序。
c.) 当前Elo触摸屏驱动程序组件需要新的libusb-1.0库支持(旧的libusb-0.1库将无法工作)。大多数更新的Linux发行版已经开始将此库作为其标准发布的一部分提供(更新到流行的libusb-0.1库)。客户还可以从libusb网站下载并编译libusb-1.0库的源代码(需要gcc v4.0.0或更高版本)。此驱动程序将不会与旧版libusb-0.1库一起工作。
d.) 请勿在Windows系统上解压下载的二进制包。
e.) 使用基于图形用户界面的控制面板(/etc/opt/elo-usb/cpl)需要Motif 3.0(libXm.so.3)库。
Openmotif或lesstif安装包提供所需的libXm.so.3库。
步骤I:
-------
将elo驱动程序文件从二进制文件夹复制到默认的elo文件夹。更改所有elo驱动程序文件的权限。这些宽权限适合大多数系统。请根据您的访问控制策略以及特定用户或组更改它们。
a.) 将驱动程序文件复制到/etc/opt/elo-usb文件夹位置。
# cp -r ./bin-usb/ /etc/opt/elo-usb
b.) 使用chmod命令为所有用户设置/etc/opt/elo-usb文件夹的完全权限。(读/写/执行)。
这些宽权限适合大多数系统。
请根据您的访问控制政策以及特定用户或组更改它们。
# cd /etc/opt/elo-usb
# chmod 777 *
# chmod 444 *.txt
c.) 将udev规则文件复制到/etc/udev/rules.d/文件夹位置。
请编辑触摸屏设备权限,以便满足您的访问控制策略以及特定用户或组。
# cp /etc/opt/elo-usb/99-elotouch.rules /etc/udev/rules.d
步骤II:
--------
配置一个脚本以在系统启动时调用Elo服务。
Debian、Ubuntu(6.10之前)系统:
- - - - - - - - - - - - - - - - - - - - -
将/etc/opt/elo-usb目录中的elorc脚本文件复制到/etc/init.d目录。
# cp /etc/opt/elo-usb/elorc /etc/init.d
必须在所需的运行级目录中为elorc脚本创建一个符号链接(示例:rc2.d,rc3.d,....rc5.d)。这将允许elorc脚本在系统启动时运行。Ubuntu和Debian系统默认使用运行级2(rc2.d目录)。
此目录包含形式为SDDxxxx的启动文件(符号链接),其中DD是序列号。选择序列号XX,它必须大于该目录中显示管理器脚本(xdm,gdm等)的序列号。
使用维护脚本update-rc.d以所选序列号XX创建elorc符号链接。
# cd /etc/rc2.d
# update-rc.d elorc start XX 2 .
重要:
==========
- 仅使用update-rc.d维护脚本修改这些符号链接。如果这些符号链接是手动创建的,则elorc脚本将在启动时不会运行。
- 请注意,update-rc.d命令的语法在运行级参数后有一个空格和一个句点。
- 上面的示例适用于运行级2。选择适当的文件夹以匹配所需的运行级。默认的运行级可以在/etc/inittab文件中找到。
注意:
=====
运行级目录的路径可能因发行版而异。Redhat中的运行级5路径是"/etc/rc.d/rc5.d",而Debian和Ubuntu中的路径是"/etc/rc2.d"对应于运行级2。
在系统中找到相应的运行级目录,并使用update-rc.d维护脚本在该目录中创建elorc脚本文件的符号链接。
Redhat、Fedora、Mandrake、Slackware和Ubuntu(6.10或更高)系统:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
在上述发行版中,从/etc/rc.d/rc*.d目录运行elorc脚本存在一些限制。因此,请在"/etc/rc.local"文件中的守护进程配置脚本末尾添加以下行。
[ rc.local文件也可能位于/etc/rc.d/rc.local位置。使用"# find /etc -name rc.local"命令找到rc.local文件。]
/etc/opt/elo-usb/loadEloTouchUSB.sh
SUSE系统:
- - - - - - -
在"/etc/init.d/boot.local"文件中的配置脚本末尾添加以下行。
/etc/opt/elo-usb/loadEloTouchUSB.sh
步骤III:
----------
插入USB触摸屏并重启系统以完成驱动程序安装过程。
# shutdown -r now
===========================================
4. USB驱动程序命令行选项和用法
===========================================
USB(elousbd)驱动程序命令行选项如下所列。如有必要,请修改
/etc/opt/elo-usb/loadEloTouchUSB.sh脚本文件,以将命令行选项添加到elousbd
驱动程序启动。
--help [ 打印使用信息和可用选项 ]
--version [ 显示USB触摸屏驱动程序版本信息 ]
--displaycoordinates [ 在终端显示每个触摸对应的触摸数据。
触摸数据包括触摸状态(触摸/流/未触摸)以及X和Y坐标。此选项用于测试触摸屏,因此触摸数据仅会显示,而不会发送到
X服务器以移动鼠标指针。 ]
--xwarppointer [ 使用XWarpPointer调用将触摸事件发送到X窗口系统 ]
--activetoucharea <originx,originy,width,height> [ 设置活动触摸区域参数:OriginX,OriginY,宽度和
高度。当设置这些参数时,鼠标指针将仅对指定区域内的触摸输入作出响应。 ]
用法示例:
---------------
elousbd --help [ 打印此使用信息 ]
elousbd --version [ 显示USB触摸屏驱动程序版本信息 ]
elousbd --displaycoordinates [ 启用在终端上打印触摸数据以测试触摸屏 ]
elousbd --xwarppointer [ 使用XWarpPointer调用将触摸事件发送到X窗口系统 ]
elousbd --activetoucharea 150,200,1000,700 [ 设置活动触摸区域:Origin=(150,200),宽度=1000,高度=700 ]
============================
5. 设置活动触摸区域
============================
重要:
==========
命令行选项"--activetoucharea"将使Linux桌面的某些区域不再无法进行触摸输入。
此选项当前仅适用于一个视频屏幕,且在多视频屏幕设置中的行为未知。如果Elo触摸屏是Linux系统的唯一输入设备,请特别关注活动触摸区域参数。
步骤I:
-------
如果您已经知道"--activetoucharea"选项参数的值,请跳过此步骤。
打开终端,检查USB触摸屏是否已连接。如果“elousbd”驱动程序处于活动状态,请卸载它。用"--displaycoordinates"选项启动elousbd驱动程序,以确定和计算"--activetoucharea"选项参数(OriginX,OriginY,宽度和高度)的值。使用sudo命令执行以下命令,如果您没有管理员访问权限。
# lsusb [ 列出所有连接到Linux系统的USB设备 ]
# killall elousbd [ 卸载elousbd驱动程序,如果已加载 ]
# cd /etc/opt/elo-usb
# ./elousbd --displaycoordinates [ 加载elousbd驱动程序以在终端上显示坐标 ]
现在,驱动程序将报告与被触摸区域对应的视频坐标。使用这些信息来确定和计算原点坐标(左上角),宽度和高度的活动触摸区域。
步骤II:
--------
使用"--activetoucharea"选项参数(OriginX,OriginY,宽度和高度)的值手动加载elousbd驱动程序。
# killall elousbd [ 卸载elousbd驱动程序,如果已加载 ]
# elousbd --activetoucharea 150,200,1000,700 [ 设置活动触摸区域:Origin=(150,200),宽度=1000,高度=700 ]
要使这些参数在每次加载驱动程序时生效,请修改/etc/opt/elo-usb/loadEloTouchUSB.sh脚本文件,并将这些命令行选项添加到elousbd
驱动程序启动。
注意:
=====
当在驱动程序中选择活动触摸区域选项时,所有在活动区域之外生成的触摸事件将被驱动程序丢弃,不会上报到Xwindows。当在活动区域内生成触摸事件时,事件上报将恢复。
==============================
6. 校准触摸屏
==============================
重要:
==========
用户必须具有对"/dev/elo-usb"和"/etc/opt/elo-usb"目录的读写访问权限,才能执行触摸屏校准。先前的校准命令行参数-u和-s现已过时。elova校准工具中的所有长命令行选项已修改为使用双破折号格式,而不是单破折号格式。(例如:"--help"而不是"-help")
输入"# /etc/opt/elo-usb/elova --help"以获取可用的命令行参数和用法。
步骤I:
-------
在X Windows的命令窗口中使用root权限从/etc/opt/elo-usb目录运行校准工具,以便用于单个或多个视频设置(支持Xorg Xinerama、Xorg非Xinerama和Nvidia Twinview选项)。
# cd /etc/opt/elo-usb
# sudo ./elova --nvram
'--nvram'或'--precal'选项将校准数据写入监视器的NVRAM(非易失性随机存取存储器)和硬盘上的配置文件。要进行校准并仅更新硬盘上的配置文件,请使用以下命令。
# cd /etc/opt/elo-usb
# sudo ./elova
在多个视频设置中,校准目标将在第一个视频屏幕上显示,并在每个目标或屏幕的默认超时30秒后切换到下一个视频屏幕。所有触摸屏校准后,数据将存储在硬盘上的配置文件中。要在特定视频屏幕(示例:videoscreen[1])上仅显示校准目标,请使用以下命令。
# cd /etc/opt/elo-usb
# sudo ./elova --videoscreen=1
要更改或禁用每个目标或屏幕的默认校准超时,请使用以下命令。[超时范围:最小=0(无超时),最大=300秒,默认=30秒]
# cd /etc/opt/elo-usb
# sudo ./elova --caltargettimeout=0 [禁用所有目标和视频屏幕的校准超时]
# sudo ./elova --caltargettimeout=45 [将校准超时修改为45秒]
要查看可用于校准的视频和USB触摸设备列表,请使用以下命令。
# cd /etc/opt/elo-usb
# ./elova --viewdevices
要查看elova校准程序的所有可用选项和特定用法,请使用以下命令。
# cd /etc/opt/elo-usb
# ./elova --help
步骤II:
--------
从正常使用的位置触摸目标。校准数据将在校准结束时写入驱动程序。声脉冲识别(APR)smartset 7010控制器不需要像其他smartset控制器那样进行三点校准。如果检测到APR 7010控制器,则仅执行单点对齐(仅显示1个目标),而不是完整的三点校准。
=============================================================
7. 从NVRAM检索校准值/预校准(可选)
=============================================================
重要:
==========
必须在监视器NVRAM(非易失性随机存取存储器)中存在有效的校准,以使用此功能。用户必须首先使用elova执行触摸屏校准,并将校准值写入监视器NVRAM。NVRAM中的现有值将丢失,因为仅能在NVRAM中存储一组校准值。因此,在执行新的校准并写入NVRAM之前,请确保当前NVRAM中的校准值可以被覆盖。
选项I:[手动选项]
---------
要立即从NVRAM检索校准值,请从X Windows的命令窗口中的/etc/opt/elo-usb目录运行程序'eloautocalib'。命令行选项'--renew'启用从监视器NVRAM读取校准值并覆盖硬盘配置文件中当前值。
# cd /etc/opt/elo-usb
# ./eloautocalib --renew
要查看eloautocalib程序的所有可用选项和特定用法,请使用以下命令。
# cd /etc/opt/elo-usb
# ./eloautocalib --help
选项II:[自动选项]
----------
将/etc/opt/elo-usb目录中的xEloInit.sh脚本文件复制到/etc/X11/xinit/xinitrc.d/目录。如果目标"xinitrc.d"不存在(例如:Ubuntu),请编辑/etc/X11/xinit/xinitrc脚本文件,并添加一行以调用/etc/opt/elo-usb/xEloInit.sh脚本文件。
# cp /etc/opt/elo-usb/xEloInit.sh /etc/X11/xinit/xinitrc.d/
要在系统启动时自动从NVRAM检索校准值,请启用位于'/etc/X11/xinit/xinitrc.d/'目录中的'xEloInit.sh'脚本文件中的'eloautocalib'条目。eloautocalib条目默认被注释掉,并且不会从监视器NVRAM加载校准值。取消注释'/etc/opt/elo-usb/eloautocalib --renew'条目,以在系统启动期间启用从监视器NVRAM读取校准值并覆盖硬盘配置文件中的当前值。
默认: '# /etc/opt/elo-usb/eloautocalib --renew' - 不从NVRAM加载校准值
已修改:'/etc/opt/elo-usb/eloautocalib --renew' - 从NVRAM加载校准值
==============================
8. 访问控制面板
==============================
控制面板应用程序使用户可以轻松设置可用的驱动程序配置选项。驱动程序包安装后,切换到/etc/opt/elo-usb目录并运行控制面板应用程序。
重要:
==========
用户必须对"/dev/elo-usb"文件夹具有读写访问权限,以运行控制面板应用程序。
步骤I:
-------
从X Windows的命令窗口中的/etc/opt/elo-usb目录以root权限运行控制面板工具。使用基于图形用户界面的控制面板(/etc/opt/elo-usb/cpl)需要Motif版本3.0(libXm.so.3)。
# cd /etc/opt/elo-usb
# sudo ./cpl
步骤II:
--------
通过单击不同的标签进行导航。以下是与每个标签相关的信息概述。
一般 - 执行触摸屏校准
模式 - 更改触摸屏模式
声音 - 更改触摸参数(启用/禁用哔声,哔声音调,哔声持续时间)
Touchscreen-0 - 显示与USB触摸屏0相关的数据。
Touchscreen-1 - 显示与USB触摸屏1相关的数据。
关于 - 关于该软件包的信息。单击Readme按钮打开此自述文件。
步骤III:
---------
如果没有安装Motif,请使用应用程序的命令行版本访问控制面板。通过在X Windows的命令窗口中从/etc/opt/elo-usb目录运行命令行应用程序。
# cd /etc/opt/elo-usb
# ./cplcmd
=================================================
9. 卸载Elo触摸屏USB驱动程序
=================================================
重要:
==========
必须具有Linux计算机的管理员访问权限才能卸载Elo触摸屏USB驱动程序。
步骤I:
-------
删除在启动时调用Elo服务的脚本或命令。
SUSE系统:
- - - - - - -
从"/etc/init.d/boot.local"文件中的配置脚本中删除在安装部分步骤II中创建的以下条目。
/etc/opt/elo-usb/loadEloTouchUSB.sh
Redhat、Fedora、Mandrake、Slackware和Ubuntu(6.10或更高)系统:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
从"/etc/rc.local"文件(或"/etc/rc.d/rc.local"文件)中的配置脚本中删除在安装部分步骤II中创建的以下条目。
/etc/opt/elo-usb/loadEloTouchUSB.sh
Debian、Ubuntu(6.10之前)系统:
- - - - - - - - - - - - - - - - - - - - -
a.) 使用update-rc.d维护脚本删除安装部分步骤II中创建的符号链接文件。
# update-rc.d -f elorc remove
b.) 删除放置在"/etc/init.d"目录中的elo脚本文件"elorc"。
# rm /etc/init.d/elorc
步骤II:
--------
从系统中删除所有elo驱动程序文件。
a.) 删除主elo驱动程序文件夹。
# rm -rf /etc/opt/elo-usb
b.) 删除与elo相关的设备文件夹和文件。
# rm -rf /dev/elo-usb
# rm -rf /etc/udev/rules.d/99-elotouch.rules
步骤III:
---------
重新启动系统以完成驱动程序卸载过程。
# shutdown -r now
===================
10. 故障排除
===================
A. 确保在目标Linux系统上安装了libusb-1.0库。此驱动程序将不与旧版libusb-0.1库一起工作。大多数Linux发行版默认配备了较新的libusb-1.0库。您也可以通过从libusb-1.0网站下载和编译库源代码进行安装(需要gcc v4.0.0或更高版本)。
B. 如果触摸不起作用,请检查elousbd驱动程序是否已加载并当前是否在内存中。一些Xorg Xserver版本在用户注销时会终止触摸屏驱动程序。在这种情况下的当前解决方法是从Xwindows启动脚本启动驱动程序或重新启动系统。
# ps -e |grep elo
检查驱动程序日志文件中是否有报告的错误。
# gedit /var/log/elo-usb/EloUsbErrorLog.txt
如果驱动程序不存在,请再次加载驱动程序。需要Root访问权限以手动加载驱动程序。正常用户将必须重新启动系统,以便在系统启动期间再次加载elousbd守护程序。正常用户可能能够手动加载驱动程序,具体取决于设置的访问控制和文件权限。
# sudo /etc/opt/elo-usb/elousbd
C. 如果在rc.local或boot.local等正常启动位置启动Elo触摸屏驱动程序无效,请首先通过手动在XWindows GUI中的终端窗口中启动驱动程序来测试触摸屏是否有效。
# sudo /etc/opt/elo-usb/loadEloTouchUSB.sh
如果手动启动驱动程序时触摸屏有效,请尝试将触摸屏驱动程序的启动行添加到XWindows启动脚本的末尾。Xwindows启动脚本通常位于以下路径/etc/X11/xinit/xinitrc.d/。从Xwindows启动脚本运行触摸屏驱动程序将在用户成功登录GUI登录屏幕后仅提供触摸输入。
D. 在GUI控制面板声音选项卡(哔声测试按钮)中,哔声功能无效或如果驱动程序在非Root用户上下文中手动加载。驱动程序必须从系统启动脚本或Root用户帐户中加载,以使哔声功能正常运行。触摸时的哔声功能还取决于pcspkr(PC扬声器)内核模块。
E. 在尝试手动加载驱动程序时,如果您收到"Error opening USB_ERROR_LOG_FILE"错误,请检查/var/log/elo-usb/EloUsbErrorLog.txt文件的权限。用户需要对该日志文件具有读写访问权限,以启动驱动程序。
F. 如果目标Linux平台在单独的X视频屏幕模式或Xinerama模式下配置了多个视频屏幕,则光标在校准后可能不会始终正确响应触摸。在这种情况下,驱动程序提出的默认调用XTestFakeMotionEvent存在一个bug,导致在单独的X视频屏幕模式或Xinerama模式下无法在视频屏幕之间切换光标。建议使用"--xwarppointer"命令行参数启动驱动程序,以使用XWarpPointer调用发送触摸事件到X窗口系统。
==============================
11. 联系Elo TouchSystems
==============================
网站:http://www.elotouch.com
电子邮件:eloinfo@elotouch.com
邮寄地址:
----------------
Elo Touch Solutions Inc,
1033 McCarthy Blvd,
Milpitas, CA 95035
美国
电话:(800)557-1458
(650)361-4700
传真:(650)361-4722
--------------------------------
Elo TouchSystems GmbH & Co. KG
Haidgraben 6
D-85521 Ottobrunn
德国
电话:+49(0)89/60822-0
传真:+49(0)89/60822-150
--------------------------------
Elo TouchSystems, NV
Diestsesteenweg 692
B-3010 Kessel-Lo
比利时
电话:+32(16)35-2100
传真:+32(16)35-2101
================================================================================
版权(c)2014 Elo Touch Solutions
保留所有权利。
================================================================================
000004145</originx,originy,width,height>
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article