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

          Elo Multiple Touchscreen Linux Driver - Single Touch (ST) USB

          Intel i686 (32 bit) or AMD64/Intel (64 bit) or ARMv7l (32 bit) 
       
                         List of New Features & Changes

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

                                 Version 5.1.0
                                 March 25, 2019
                               Elo Touch Solutions

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


Summary of new features & changes in driver v5.1.0 :
----------------------------------------------------

  1. Added single touch support for Touch Pro PCAP products with VID:PID 
     (0x04e7:0x2902).

  2. Fixed an issue where touch calibration was lost on PCAP touchscreens when
     the video was rotated to portrait mode.    

  3. Added check for data received less than Atmel's multi touch report size, 
     report to driver log and not process it.
  
  4. Added check for non standard Atmel primary touch ID, which is not equal to 
     default ID 1 and track this new ID for primary touch. 

  5. Add driver start date and time to Elo driver log file.



Known Issues in driver v5.1.0 :
-------------------------------

  1. Recent Fedora distributions have SELINUX in enforcing mode by default. This
     causes the Elo STUSB driver daemon(elousbd) to fail due to permission 
     issues, when launched from elo.service systemd script. Setting SELINUX to 
     disabled or permissive mode will allow the Elo driver to load without 
     issues. Otherwise, please create a special SELINUX policy to allow the Elo 
     driver to access the restricted system resources.

  2. Recent Fedora distributions running Gnome/gdm desktop have Xwayland enabled
     by default for both login screen and user sessions. The STUSB driver will 
     only work with user sessions that run Xorg (instead of Xwayland). To launch
     an Xorg based Gnome user session, click on the gear icon or button at the 
     Gnome graphical login screen and select the "Gnome on Xorg" session option 
     and then proceed with the login. The system will remember the previous 
     session preferences and select the "Gnome on Xorg" option automatically for
     subsequent boots. Now touch input should be available for all Gnome/Xorg 
     user sessions.

  3. Recent Fedora distributions running Gnome/gdm desktop have Xwayland enabled
     by default in the login screen. Hence, the Elo STUSB driver will not be 
     able to provide touch input at the Gnome/Xwayland login screen. However 
     touch input will be available for all user sessions, once "Gnome on Xorg" 
     session is selected at the graphical login screen. The Elo STUSB driver can
     work with only one Xorg session at a time, hence enabling Xorg for both 
     login screen and user session will not help. If touch input is required at 
     the login screen also, please uninstall the Elo STUSB driver and use the 
     latest Elo MTUSB driver instead.     
 


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




Previous Versions:
------------------
================================================================================    

                                  Version 5.0.0
                                February 22, 2018
                               Elo Touch Solutions

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


Summary of new features & changes in driver v5.0.0 :
----------------------------------------------------

  1. Added onboard calibration feature to the elova calibration utility to align
     touch coordinates reported by certain touch controllers like 2701, 2218, 
     etc.  
  
  2. Added TouchPro branding for Elo PCAP products.

  3. Added single touch support for Touch Pro PCAP 9200xx products with VID:PID 
     (0x04e7:0x0090, 0x04e7:0x0091).

  4. Added single touch support for TouchPro PCAP controllers with VID:PID 
     (04e7:080b and 04e7:080c) and 3243L TouchPro PCAP.

  5. Updated support for latest Intellitouch eSAW 3200XX controller firmware.
 


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


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

                                  Version 4.4.0
                                  July 24, 2017
                               Elo Touch Solutions

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


Summary of new features & changes in driver v4.4.0 :
----------------------------------------------------

  1. Added support for 12 touch Intellitouch Pro PCAP products (0x04e7:0x240c).
  
  2. Added support for 10 & 20 touch IR products (0x1ff7:0x0013).
 


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


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

                                  Version 4.3.1 
                               September 15, 2016
                               Elo Touch Solutions

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


Summary of new features & changes in driver v4.3.1 :
----------------------------------------------------

  1. Added single touch support for Elo Intellitouch SAW Multi Touch(MT) 
     HID and non-HID controllers with VID:PID(04e7:0022, 04e7:0027, 04e7:0124, 
     04e7:0126)  
 
  2. Added single touch support for Elo Intellitouch Pro PCAP controllers with
     VID:PID(04e7:0063, 04e7:0064, 04e7:0067, 0eef:7200, 0eef:7402, 0eef:a800) 
 
  3. Added support for Linux ARM distributions(requires Xwindows support) with 
     ARMv7l 32 bit platform. The ARMv7l driver was built and tested using a 
     PandaBoard ES running Ubuntu 12.04.5 LTS(ARMv7l).    

  4. Added elo.service systemd startup script and instructions to enable elo
     driver startup on Linux distributions with systemd init system.
 


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


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

                                  Version 4.2.0 
                                  July 21, 2016
                               Elo Touch Solutions

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


Summary of new features & changes in driver v4.2.0 :
----------------------------------------------------

  1. Added Right Click On Hold(RCOH) feature for all supported touchscreens. The
     RCOH feature is disabled by default and can be enabled using the command 
     line control panel utility(cplcmd) or eloconvertconfig utility.

  2. Added RCOH parameters(RCOHFlag, RCOHToleranceArea and RCOHDelay) which can 
     be used to configure the RCOH settings for each specific touchscreen. The 
     command line control panel utility(cplcmd) or eloconvertconfig utility can
     be used to view the current RCOH parameters and set them as needed.
 
  3. Added single touch support for Elo Intellitouch Pro PCAP controllers with
     VID:PID(03eb:8a6e, 04e7:00c0, 04e7:1d00, 04e7:1c00, 04e7:240b, 04e7:2410,   
     2149:3ab8, 2149:42cf, 04e7:2003 & 04e7:2100)  
 
  4. Elo Intellitouch Pro PCAP controllers with VID:PID(03eb:8a6e, 04e7:00c0, 
     04e7:1d00, 04e7:2003, etc) that do not contain a valid serial number will 
     only work in single touchscreen mode. Driver requires unique serial numbers 
     to work with multiple touchscreens.  

  5. Fixed a driver issue where the active touch controller with no serial 
     number could be mistaken for a new touch device, resulting in some unwanted 
     initialization errors - "Device 1: Could not claim interface 1"

  6. Initialized the Serial Number string to "None", so touch controllers that 
     have no serial number will now report "None" instead of unprintable 
     characters in the driver log.

  7. Added driver commandline option "--ignoreserialnumber" to ignore serial 
     number matching for using the touch driver configuration data.

  8. Added more protection in the code to avoid any race condition or any errors 
     when the Elo driver is killed manually.  

  9. Added a commandline option "--file" to the eloautocalib utility to read the
     touchscreen calibration parameters from a specified file and apply it to
     the driver.

 10. Renamed Intellitouch 2800XX series eSAW controllers to 3200XX series.



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

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

                                  Version 4.1.0-b3 
                                December 31, 2015
                               Elo Touch Solutions

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


Summary of new features & changes in driver v4.1.0 :
----------------------------------------------------

  1. Added single touch support for Elo Intellitouch Pro PCAP and Intellitouch
     2800XX series SAW controllers.

  2. Added support for touch controller serial numbers greater than 8 characters.

  3. Added a new tool to display or modify current global and device specific
     touchscreen parameters [eloconvertconfig]. Type the command
     "/etc/opt/elo-usb/eloconvertconfig --help" for available command line
     parameters and usage.

  4. Converted beep parameters(BeepOnTouch, BeepTime and BeepFreq) to device 
     specific parameters. Each touchscreen device can now be configured with
     different beep settings.

  5. Modified the default videoscreen to touchscreen association. Previously,
     if a valid video2touch association is not found then the touchscreen would
     be assigned to videoscreen 0. Now, the touchscreen is assigned to the same    
     videoscreen (example: touch 0 => video 0, touch 1 => video 1, etc.). 
     Running the calibration utility, elova will overwrite this default 
     association.  

  6. Modified the default initialization behaviour for PCAP touchscreens such 
     that they would be aligned to the associated videoscreen out of the box and
     would not require calibration. Running the calibration utility, elova will 
     overwrite this default alignment. 



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

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

                                 Version 4.0.1 
                                November 11, 2014
                               Elo Touch Solutions

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


Summary of new features & changes in driver v4.0.1 :
----------------------------------------------------

  1. Fixed a device handle leak that caused the driver to quit or stop 
     functioning after a few hours.

  2. Fixed a file write error that resulted in loss of device specific 
     information including calibration data in a multiple touchscreen setup. 

  3. Fixed a stale data issue that resulted in loss of new calibration data 
     after unplug and replug of a USB touchscreen.  

  4. Fixed a minor issue that prevented the use of certain commandline 
     parameters in the driver binary(--xwarppointer, --displaycoordinates, etc).

  5. Fixed a X authentication issue in the driver that occured during system 
     startup on SUSE Linux Enterprise Desktop (SLED) 11 SP3.   
  
  6. Verified support for multiple videoscreen setup based on multiple X 
     videoscreens(Xinerama or separate X videoscreens). Use the "--xwarppointer" 
     driver commandline parameter to use XWarpPointer call to send touch events 
     to X window system. This option is essential if the target Linux
     platform has multiple video screens configured in separate X video screen 
     mode or Xinerama mode. The default call to send touch events, 
     XTestFakeMotionEvent has a bug that prevents the switching of cursor across 
     video screens in Xinerama mode or separate X video screen mode [Xorg v7.4 
     or later].    

  7. Enabled the --xwarppointer option in the driver by default in the driver 
     startup script (/etc/opt/elo-usb/loadEloTouchUSB.sh).
 
  8. Added X videoscreen information to the touch events that are displayed when 
     the --displaycoordinates option is enabled in the driver.

  9. Improved the robustness of the driver to be tolerant to errors during
     dynamic memory allocation.

 10. Improved the robustness of the data read and writes to driver configuration
     file.

 11. The USB driver log file(EloUsbErrorLog.txt) that was previously located in 
     the driver folder (/etc/opt/elo-usb/) has been moved to /var/log/elo-usb/
     folder.    



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


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

                                  Version 4.0.0
                                November 08, 2013 
                               Elo Touch Solutions

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


Summary of new features & changes in driver v4.0.0 :
----------------------------------------------------

  1. Supports multiple ST(Single Touch) touchscreens (maximum: 32) and multiple
     videoscreens (maximum: 32) 

  2. Supports Linux 3.x.x and 2.6.x kernels

  3. Supports latest Xorg Xserver versions (v1.14.3 or newer)

  4. Video monitor to touchscreen associations for multiple touchscreens 
     enables touch routing to correct video monitor, based on unique touchscreen
     serial number.[Video2Touch.txt]   



Supported System Configurations:
--------------------------------

 The current version of the USB driver will support the following 
 video and touchscreen configurations: 

 1. Single video and single touchscreen.
 2. Multiple video and single touchscreen. 
 3. Multiple video and multiple touchscreens. 

 

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


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

                                  Version 3.5.4-beta1
                                  April 30, 2013 
                                Elo Touch Solutions

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


Summary of new features & changes in driver v3.5.4-beta1 :
----------------------------------------------------------

  1. Precalibration support using touchscreen controller's NVRAM (Non 
     Volatile Random Access Memory), if available.

  2. Desktop position independent calibration using precalibration 
     feature in a multiple monitor setup. Requires USB configuration file
     (/etc/opt/elo-usb/USBConfigData) to be stored on the hard drive of target 
     Linux system.  

  3. Dynamic adjustment of touchscreen calibration to suit current video 
     resolution using precalibration feature [eloautocalib].Type 
     "/etc/opt/elo-usb/eloautocalib --help" for available command line 
     parameters and usage.



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


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

                                  Version 3.5.3
                                 December 14, 2012 
                                Elo Touch Solutions

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


Summary of new features & changes in driver v3.5.3 :
----------------------------------------------------

  1. Added command line parameters for the 'elousbd' driver. All parameters use 
     the long command line option with the "--" format. Use the "--help" option 
     to see all the available commandline options.

  2. Added help section for the 'elousbd' driver. The "--help" driver commandline 
     parameter displays all the available commandline options and some driver
     usage examples.

  3. Added "--version" driver commandline parameter to display the USB touchscreen 
     driver version information.

  4. Added "--displaycoordinates" driver commandline parameter to display the 
     touch data, corresponding to each touch, on a terminal. This option is used 
     for testing the touchscreen, hence touch data is only displayed and not sent 
     to Xserver to move the mouse pointer.

  5. Added "--xwarppointer" driver commandline parameter to use XWarpPointer call
     to send touch events to X window system. Use this option if the target Linux
     platform has multiple video screens configured in separate X video screen mode
     (not twinview mode). The default call to send touch events, XTestFakeMotionEvent 
     has a bug that prevents the switching of cursor across video screens in separate
     X video screen mode [Xorg v7.4 or later].     

  6. Added "--activetoucharea" driver commandline parameter to enable the mouse 
     pointer to respond to touch input within the specified area only. This option
     needs the following parameters to specify the touch area: OriginX, OriginY, 
     Width and Height. 


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


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

                                  Version 3.5.2-1 
                                   June 07, 2012
                                Elo Touch Solutions

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


Summary of new features & changes in driver v3.5.2-1 :
------------------------------------------------------

  1. Fixed an issue where the driver consumed 100% cpu resources  
     when launched at system boot on some Linux distributions.

  2. Fixed an issue where the driver could corrupt the USB touchscreen
     configuration file during system reboot.

  3. Fixed an issue where the driver would exit after several hundred 
     trials while recycling power to the touch controller.

  4. Added delays to the USB device arrival and exit routines to allow 
     more time for the touch controller to stabilize during an USB unplug 
     and replug event. 


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


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

                                  Version 3.5.2 
                                February 15, 2011
                                Elo TouchSystems

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


Summary of new features & changes in driver v3.5.2 :
----------------------------------------------------

  1. Fixed an issue where touch is lost when an user restarts an 
     Xwindows session using Ctrl+Alt+Backspace key combination.

  2. Fixed an issue where the driver would not work with a Xwindows
     system that does not require authentication (xauth).

  3. Fixed an issue in the drag delay logic in the driver for mousemode.

  4. Updated the range for Drag Delay parameter to be consistent with
     other drivers. New Drag Delay Range is from 50 ms to 2500 ms.  

  5. Removed the requirement for controller serial number matching
     to retrieve data from configuration file.


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


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

                                 Version 3.5.1 
                                August 11, 2010
                                Elo TouchSystems

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


Summary of new features & changes in driver v3.5.1 :
----------------------------------------------------

  1. Fixed an issue where the touchscreen driver (elousbd) gets terminated
     when an user logs out of a Xwindows session and touches the screen

  2. Support for Motif verions 3.0 [libXm.so.3] and 4.0 [libXm.so.4]


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


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

                                 Version 3.5.0 
                                 July 14, 2009
                                Elo TouchSystems

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

Summary of new features & changes in driver v3.5.0 :
----------------------------------------------------

  1. Support for 64 bit AMD/Intel x86_64 platform added. Visit the   
     Linux downloads section at www.elotouch.com to download the 
     64 bit AMD/Intel x86_64 platform driver package or the standard 
     32 bit Intel i686 (x86) platform driver package.  

  2. This userspace driver adds support for recent Linux kernel versions
     2.6.25 and newer.  

  3. The Elo Touchscreen driver components now require new libusb-1.0 library
     support (older libusb-0.1 library will not work). Most newer Linux 
     distributions have started shipping this library(update to the popular 
     libusb-0.1 library) as a part of their standard release. Customers can 
     also download and compile the libusb-1.0 library from source (requires 
     gcc v4.0.0 or later) available at libusb website. This driver will 
     NOT work with the older libusb-0.1 library.   

  4. Eliminates the Elo Touchscreen driver requirement for USB Human
     Interface Device (USBHID) component to be a loadable kernel module.
     Hence, for Linux distributions that have USBHID component built
     into the kernel by default (example: Redhat, Fedora, etc),
     recompiling the kernel is not required to install the Elo Touchscreen 
     driver.

  5. Adds support for Xorg Xserver versions 1.5RC and newer. Older versions
     of Xorg Xserver are also supported.

  6. Adds support for multiple video screens and single USB touchscreen 
     configuration. Nvidia Twinview, Xorg Xinerama and Xorg non-Xinerama 
     based multiple video screens are supported.

  7. The calibration utility provides a default timeout of 30 seconds for 
     each calibration target. The timeout can be disabled or changed using
     commandline option --caltargettimeout. It also provides a list of 
     available video and touch devices for calibration and options to select 
     specific devices for calibration. The previous calibration command line 
     parameters -u and -s are now obsolete. All long command line options in 
     the elova calibration utility have been modified to use the "--" format
     instead of the "-" format. Formatted the elova output and help information 
     width to 80 columns for low resolution displays and text consoles. Type 
     "/etc/opt/elo-usb/elova --help" for available command line parameters 
     and usage.

  8. Adds a new single touch alignment feature in the elova calibration 
     utility to support the APR Smartset 7010 controller. This mode displays 
     only 1 target instead of 3 targets to determine the video screen 
     associated with the APR Smartset touchscreen.   
 
  9. Adds Beep-on-Touch feature. Beep can be enabled or disabled and other
     beep parameters can be modified using the GUI control panel (cpl - 
     sound tab) or using the command line control panel (cplcmd).
 
 10. The installation procedure for the Userscape USB driver is simplified 
     compared to previous kernel USB drivers. Customers do have to build 
     any driver components on the target system and hence do not need to
     have development environment installed. 
 
 11. Adds support for recent touchscreen controllers including Surface 
     Capacitive 5020, APR Smartset 7010 and Accutouch COACh IV controllers.

 12. Improved plug and play support for USB touchscreen controllers. Changed 
     the Elo USB touchscreen device permissions to allow normal users to work 
     with the plugged in touchscreen.

 13. Adds support for Emacs text editor in the graphic control panel
     to view the Readme.txt file. 

 14. This driver release is a major change from the previous version. 
     Hence some features, options and components from the previous driver
     versions are now obsolete. 



Known Issues in driver v3.5.0 :
-------------------------------

  1. In some Xserver versions the touchscreen driver (elousbd) gets terminated
     when a user logs out. See troubleshooting section in the readme.txt file
     for more details and options.

  2. When the driver is started manually from a non-root user account within 
     Xwindows, the beep-on-touch feature does not work. The driver has to be 
     loaded from a system startup environment or root user account to get the 
     beep-on-touch feature functioning properly.      



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

                       Copyright (c) 2019 Elo Touch Solutions

                              All rights reserved.

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