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

                       Elo Touchscreen Linux Driver - MT-USB 

        Intel i686 (32 bit) or AMD64/Intel (64 bit) ARMv7 (32 bit) or ARMv8 (64 bit)

                         List of New Features & Changes

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




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

                                 Version 4.1.0 
                                 May 04, 2021
                              Elo Touch Solutions

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

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

New features:
  1. Driver: Add support for multiple touch monitors
     [LINUXMTUSB-5]

  2. MTUSB: Add support PID 0x0865 - ET5503L, EETI CTR-835600
     [LINUXMTUSB-20]
     
  3. MTUSB: Add support PID 0x0820 - Report ID 17 & 18, EETI CTR-835600
     [LINUXMTUSB-22]

  4. MTUSB: Add support PID 0x0D22 - SiS9519V, CTR-826019
     [LINUXMTUSB-40]

  5. MTUSB: Add support PID 0x0816 - EETI 80H32 CTR-82532
     [LINUXMTUSB-44]
  
  6. cplcmd: Add support enable/disable beep sound on touch from cplcmd
     command line interface
     [LINUXMTUSB-39]

  7. elova utility: Add support for multiple touch monitors
     [LINUXMTUSB-31]

  8. cpl, cplcmd utilities: Add support for multiple touch monitors
     [LINUXMTUSB-32]
     
Fixed bugs:
  9. cplcmd, cpl utilities: "Disable/Enable This Touchscreen" sometime not working
     [LINUXMTUSB-26]

  10. elova utility: Under some conditions, calibration is failed to run on 2nd 
      consecutive time.
      [LINUXMTUSB-38]

  11. In ReadMe.txt, add Notes for "Calibrating the Touchscreen"
      [LINUXMTUSB-27]



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

                                 Version 4.0.0 
                               September 29, 2020
                              Elo Touch Solutions

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

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

  1. Fixed problem: No touch on desktop in mtdigitizer mode
     [LINUXMTUSB-13]

  2. Improvement: implement to support up-to-date multi-touch protocol.
     Make EloMTUSB compatible to most major current Linux OS
     [LINUXMTUSB-24]

  3. Set to multi-touch mode by default

  4. Add support for Wayland graphical shell
     [LINUXMTUSB-19]

  5. Fixed problem: Failed to run on CentOS 7, SLES 11
     [LINUXMTUSB-18]
     Note:
	 For RedHat and its family OS. Please see "readme.txt" in "Installation/STEP III/Update" section 
	 for more information.



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

                                 Version 3.2.0 
                                April 01, 2020
                              Elo Touch Solutions

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

Summary of new features in driver v3.2.0:
---------------------------------------------------

  1. Added support for ET0702L Touch Pro PCAP products with VID:PID 
     (0x04e7:0x1080)

  2. Added support for Touch Pro PCAP products with VID:PID 
     (0x04e7:0x0820) controller model CTR-825184


  3. Added support Raspbian and Ubuntu on ARMv8 platform (64 bit)




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

                                 Version 3.1.0 
                               November 11, 2019
                              Elo Touch Solutions

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

Summary of new features in driver v3.1.0:
---------------------------------------------------

  1. Added 10-touch support for Touch Pro PCAP products with VID:PID 
     (0x04e7:0x2902, 0x04e7:0x2903).

  2. Added 40-touch support for Touch Pro PCAP products with VID:PID 
     (0x04e7:0x0801).

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





===============================================================================
 
                                 Version 3.0.0 
                               November 15, 2018
                              Elo Touch Solutions

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


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

  1. Added Uinput kernel module support in the MTUSB driver to send touch 
     related input events directly to the Linux kernel layer. This allows all 
     the components of the new MTUSB driver to exist in userspace.  

  2. Added support for 3 types of input devices(Absolute Mouse, Single Touch(ST)
     Digitizer and Multi Touch(MT) Digitizer) in the MTUSB driver, which can be 
     selected at runtime via driver commandline parameter. The driver startup 
     script is setup to start as a Single Touch(ST) digitizer. Selecting one of 
     these input devices changes the type of input events sent by the MTUSB 
     driver to the Linux kernel.          

  3. The Absolute Mouse input device can be selected using the --absmouse  
     commandline parameter in the elomtusbd driver binary. Absolute mouse input
     device sends mouse events corresponding to the primary touch only. In this 
     mode the MTUSB driver sends BTN_LEFT, ABS_X and ABS_Y input events. This 
     mode is useful to support legacy applications or older Linux kernels, which 
     are not aware of ST or MT digitizer devices or digitizer events. Use evtest 
     application to test the touchscreen in this mode.     

  4. The Single Touch(ST) Digitizer input device can be selected using the 
     --stdigitizer commandline parameter in the elomtusbd driver binary. ST 
     digitizer input device sends single touch digitizer events corresponding to
     the primary touch only. In this mode the MTUSB driver sends BTN_TOUCH, 
     ABS_PRESSURE, ABS_X and ABS_Y input events. This mode is useful to support 
     legacy applications or older Linux kernels, which are not aware of MT 
     digitizer devices or multi touch digitizer events. It can be used to 
     retrict the number of touches sent to Linux kernel to just one(primary 
     touch) and avoid triggering multi touch system gestures. Use evtest 
     application to test the touchscreen in this mode.     

  5. The Multi Touch(MT) Digitizer input device is the default selection and can
     also be selected using the --mtdigitizer commandline parameter in the 
     elomtusbd driver binary. MT digitizer input device sends multi touch 
     digitizer events corresponding to the Linux Multi Touch protocol(Type A 
     device) . In this mode the MTUSB driver sends ABS_MT_PRESSURE, 
     ABS_MT_POSITION_X and ABS_MT_POSITION_Y input events. This mode is useful 
     to support the latest multi touch aware applications or multi touch system 
     gestures on newer Linux kernels. Please note that the number of touches 
     reported to the top level application depends on the Linux distribution and 
     some multi touch events could be filtered to report system level gestures. 
     Some Linux desktop elements including the mouse pointer may not respond in 
     this pure multitouch mode, since they listen to mouse or ST digitizer 
     events only. Use evtest or QT5 multitouch aware applications to test the 
     touchscreen in this mode.     

  6. Removed the Elo kernel module [elo_mt_input_mod.ko]. This kernel component
     is no longer needed, since the driver now uses Uinput module to route touch
     events to the Linux kernel. 

  7. The installation procedure for the current MTUSB driver is very much 
     simplified compared to the previous MTUSB drivers with Elo kernel 
     components. Customers do not have to build any driver components from 
     source code on the target system and hence do not need to have a 
     development environment installed.

  8. Removed autosizing routine from the driver initialization sequence of SAW 
     HID touchscreens. 

  9. Updated the value reported for touch status to 1(instead of 3), during 
     active touch for Elo Single Touch products.

 10. Updated the Elo logo used in the control panel utility, cpl.   



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

  1. In Fedora 25, the root user cannot execute the calibration utility, elova 
     due to Xwindows restrictions. However, a normal user with sudo access can 
     execute elova utility and complete the calibration process.

  2. In Debian 9.3, the commandline control panel application(cplcmd) does not
     show the controller type string when touchscreen diagnostics option is 
     selected. Only the firmware version is shown. The workaround for this is to
     use the cplcmd binary packaged with the previous version of the driver, 
     MTUSB v2.5.0.
 
  3. Touch input cannot be used to select the various tabs of the motif based 
     Graphic User Interface(GUI) control panel(cpl) utility. Use a mouse to 
     select the different tabs. 

  4. During the operation of the GUI control panel utility, a benign error 
     related to XtGrabPointer failure might be reported in the terminal 
     console. It will not cause any issues during touchscreen operation.

  5. The GUI control panel Readme button might not be active to open and view
     the readme file, if some the popular text editors like emacs, gedit, kedit
     or kate are not installed. The readme file can be opened directly in any 
     text editor application from the Elo driver path /etc/opt/elo-mt-usb.        




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


================================================================================
 
                                 Version 2.5.0 
                               February 23, 2018
                              Elo Touch Solutions

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


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

  1. Added TouchPro branding for Elo PCAP products.

  2. Added support for TouchPro PCAP 9200xx products with VID:PID 
     (0x04e7:0x0090, 0x04e7:0x0091).

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

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



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


================================================================================
   
                                 Version 2.4.0 
                                 July 26, 2017
                              Elo Touch Solutions

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


Summary of new features & changes in driver v2.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).
 
 3. Added multitouch support for CentOS 6.8 (kernel: 2.6.32-642). 



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


================================================================================
 
                                 Version 2.3.1 
                               February 23, 2017
                              Elo Touch Solutions

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


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

 1. Enhanced support for 1523L SAW(2515-07 non HID) touch monitor, ensuring 
    touch is aligned out of the box and does not require calibration.  



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


================================================================================
 
                                 Version 2.3.0 
                                January 30, 2017
                              Elo Touch Solutions

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


Summary of new features & changes in driver v2.3.0:
---------------------------------------------------

 1. Added support for Elo Intellitouch SAW 3200XX series controllers.

 2. Added support for all Elo Intellitouch Pro PCAP controllers.



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


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

                                Version 2.0.3-b3 
                                 March 15, 2016
                              Elo Touch Solutions

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


Summary of new features & changes in driver v2.0.3-b3 :
-------------------------------------------------------

  1. Added capability to report only Single Touch events(primary touch) to a 
     multitouch capable Linux kernel (2.6.38 or 3.x.x or 4.x.x) as mouse events.
     The primary touch events are only reported to the system, while the other 
     touches are discarded. Enable this capability by uncommenting the code that
     defines FORCE_SINGLE_TOUCH in elo_mt_input.c kernel module source code and 
     generate and install a kernel module.
 
     This single touch reporting feature is very useful if some components in 
     the software stack do not process multitouch events properly or the 
     applications do not want multitouch events/gestures or to ensure 
     compatibility with legacy applications that require mouse events.   

  2. Added support for Intellitouch Pro PCAP products 1940L(0x04e7/0x0064), 
     3201L(0x04e7/0x0067), 3243L(0x04e7/0x240b), PCAP controller(0x04e7/0x2410)
     and other similar products.

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

  4. The USB driver configuration file(MT-USBConfigData) that was previously 
     located in the driver folder (/etc/opt/elo-mt-usb/) has been moved to 
     /etc/opt/elo-mt-usb/ConfigData folder. 



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


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

                                Version 2.0.3-b2 
                               February 19, 2016
                              Elo Touch Solutions

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

Note for ARM Platforms:
=======================
This touchscreen driver ported for ARM v7l platform requires a Linux 
distribution with Xwindows (example: Ubuntu 14.04.3 LTS ARM version). The driver 
was built and tested using ODROID-XU4 ARM board running Lbuntu 14.04.3 LTS
(Kernel: 3.10.92+). The driver package already contains a pre-built kernel 
module elo_mt_input_mod.ko in the driver main folder for Linux kernel 3.10.92+ 
(ARM v7l) that can be used directly for driver installation. 


Summary of new features & changes in driver v2.0.3-b2 :
-------------------------------------------------------

  1. Added capability to report only Single Touch events(primary touch) to a 
     multitouch capable Linux kernel (2.6.38 or 3.x.x or 4.x.x) as mouse events.
     The primary touch events are only reported to the system, while the other 
     touches are discarded. Enable this capability by uncommenting the code that
     defines FORCE_SINGLE_TOUCH in elo_mt_input.c kernel module source code and 
     generate and install a kernel module.
 
     This single touch reporting feature is very useful if some components in 
     the software stack do not process multitouch events properly or the 
     applications do not want multitouch events/gestures or to ensure 
     compatibility with legacy applications that require mouse events.   

  2. Added support for Intellitouch Pro PCAP products 1940L(0x04e7/0x0064), 
     3201L(0x04e7/0x0067) and other similar products.



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


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

                                 Version 2.0.2 
                                August 28, 2015
                              Elo Touch Solutions

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

Summary of new features & changes in driver v2.0.2 :
----------------------------------------------------

  1. Added single touch support for Accutouch and Intellitouch products based
     on the 2216, 2218, 2700 and 2701 single touch controllers.

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

  3. Fixed an issue in the calibration scheme where untouches used for computing
     the calibration parameters were not be reported to Linux kernel. This could
     potentially result in unwanted behavior due to missing untouches in the
     touch input sequence.

  4. Fixed issues in the graphic and commandline control panel utilities to 
     display the X-Windows Video Screen number and Controller firmware version
     number properly.

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



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


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

                                 Version 2.0.0
                               February 20, 2014
                              Elo Touch Solutions

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

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

  1. Added support for Intellitouch Plus and iTouch Plus products that provide
     dual touch capability based on the 2515-07(non HID), 2521(HID) and
     2515-00(HID) controllers.

  2. Added support for various multitouch PCAP products (2 touch, 4 touch and
     10 touch controllers).

  3. Added commandline and GUI control panel utilities (cplcmd and cpl).



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


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

                                 Version 1.0.0
                                August 26, 2013
                              Elo Touch Solutions

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

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

  1. Added support for Linux Multi Touch protocol to send multitouch events to
     the Linux kernel(2.6.38 or 3.x.x). The primary touch events are used to
     generate pointer events(emulation) to work with existing application.

  2. Added support for older Linux kernels(2.6.x) that do not support the new
     Linux Multi Touch protocol, to send single touch events instead. The
     primary touch events are only reported to the system, while the other
     touches are discarded.

  3. Added support for Intellitouch Plus and iTouch Plus products that provide
     dual touch capability based on the 2515-07 controller.



Known Issues in driver v1.0.0 :
-------------------------------

  1. In some older Linux distributions(example: SLES 11, kernel: 2.6.27.x) the
     pointer is not aligned properly with the touch location, even after
     calibration.




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

                       Copyright (c) 2019 Elo Touch Solutions

                              All rights reserved.

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

