Driverless Controller User Guide - data
Contents
1. A casyANALYZER v2 0 lolek Select d i masa ED Graph Settings C Reference Mode C Delta Mode Fast Delta Mode For more information please contact Data Modul Page 15 of 19 DATA MODUL www data modul com DATA MODUL 10 Known Issues Operating Problem System 29521 2 Controller maxtouch txt showing wrong mXT firmware version in debug mode 1 2 instead of 1 1 easySETTINGS not written to The easySETTINGS file should not be controller smaller than 7 kb Please add enough spaces after the ENTER behind the reset command Two maxtouch txts on the Mass Only modify or delete one of the two files Storage Device Page 16 of 19 DATA MODUL www data modul com DATA MODUL Appendix 1 Adjust the touch area to a smaller display The settings Clipping X low Clipping X high Clipping Y low Clipping Y high in maxtouch txt can be used to set up a clipping boundary These fields allow settings in the range from 50 to 50 The maximum clipping value allows a clipping boundary one eight of the touch screen height or width Positive values 0 to 50 increase the size of the clipping boundary Below you can find an example to adjust a bigger touch area to a smaller display Example Positive Clipping Boundary Clipping Y low Touch Area Ke Display Size SEIN Clipping X high l Clipping Y high Negative values 1 to 50 are used2. DATA MODUL easy TOUCH Data Modul easy TOUCH Driverless T Series Controller User Guide Rev 3 1 DATA MODUL www data modul com DATA MODUL R ev IS On Date 11 09 2015 Name T Grand DATA MODUL www data modul com DATA MODUL Table of Contents WT e e Uer e EE 4 2 Operational A AA a erent ene kb kalov 5 3 Configuration using Mass Storage Device nnnnnnnannnnnannanannnanaannanana 6 9 Ed EE 7 3 2 Read User Gettngs aaa 9 4 Operating KEE E E 10 o le E 11 5 1 Change Sensitivity threshold ene 11 5 2 Change operational MOJE vnetni veti eni rabe beni sestvendsnsiansiaeseansdacninenddesseendecs 11 0 CaSVSE TINGS SUPPO seirinin eA EAE AEEA Eae 12 C 01 009 0 cr 0 E E ee ee eee 12 62 DisdlayGasySe I TINGS gegeessgedeeesgengegeesged enge eeneg 12 6 3 Save easySETTINGS t touch ee te 13 7 CasyBUTTON SU DOV GE 13 CAS Eeer 14 9 easyANALYZER Eege 15 Ir WR le RE TT 16 ele ET ale D e a A ee a Ek VE Valve be bube ab 17 AD PENA EE 18 Page 3 of 19 DATA MODUL www data modul com DATA MODUL 1 Introduction Data Moduls new generation of easy TOUCH T Series controllers includes a firmware that is based on a standard HID pointer device for both single and multi touch Since those HID device classes are an USB org standard there is no need for any kind of additional drivers for most operating systems If the operating system includes HID multi t
3. install the Windows CE patch for Data WinCE 6 ST Modul easyT OUCH using Driverless HID WinEC 7 ST MT Application Note Implementing multi touch using Linux Page 10 of 19 DATA MODUL www data modul com DATA MODUL 5 Examples 5 1 Change sensitivity threshold Open mass storage device named Max Touch Open the text file maxtouch txt Edit the text file with an editor that creates no local copy of the file Now you can change the sensitivity threshold value In some cases it is necessary to reset the controller to apply the new settings For this the reset command can be used me ee Attention It is important to press Enter after a new command For some OS like Win8 64Bit it is required to replace the spaces at the end of maxtouch txt with a new command Firmware version 2 0 Single Touch Controller mxXT640T V1 2 FW Rev 12001457 000 Self test disable Sensitivity threshold 30 Switch X and Y 0 reset r n reset the controller 5 Save maxtouch tt 5 2 Change operational mode 1 Open the text file maxtouch txt Attention It is important to press Enter after a new command Firmware version 3 0 Single Touch Controller mXTo640T V1 2 FW Rev 12001457 000 Self test disable Sensitivity threshold 30 operational 1 r n Single Touch HID reset r n reset the controller 2 Save maxtouch ixt Please note that this examples are tested under Windows 7 only Page 11 of
4. 19 DATA MODUL www data modul com DATA MODUL 6 easySETTINGS support 6 1 Introduction The driverless firmware version 3 0 or higher supports easySETTINGS controller configurations With this feature it is possible to display the easySETTINGS in the maxtouch txt file or to write a new configuration to the touch controller The easySETTINGS include all controller parameters which can be used for support requests or to copy a configuration from one controller to another This feature is also supported in the easyANALYZER Attention easySETTINGS for firmware 3 0 and 3 1 are not compatible 6 2 Display easySETTINGS Displaying the easySETTINGS in the maxtouch txt file 1 Plug in the easyTouch controller to the PC EI 1 sce Datei Bearbeiten Format Ansicht Firmware version controller Fw Rev Self test disabled Sensitivity threshold 4 Switch X and Y clipping x low clipping X high Clipping Y low cli ping Y high e right click OOOOOOPUOOOOOCOO Open the maxtouch txt file from the mass storage device At the end of the file type debug return Save the file CTRL S or File Save The controller is now rebooting After rebooting the maxtouch txt looks like this m et ee ee Datei Bearbeiten Format Ansicht Firmware version 3 0 Single Touch Controller mxT640T V1 2 FW_Rev 12010000_000 self test disabled 7 Save the easySETTINGS file to a local directory Page 12 of 19 DATA MODUL w
5. e USB for buttons and sensor e Upto 8 buttons configurable For more information please contact Data Modul Touch Area Touch Sensor Button Area ABC Page 13 of 19 DATA MODUL www data modul com DATA MODUL 8 easyCARE The easyCARE function tests the PCAP touch system for failure Therefor the sensor field and the drive voltage are checked during startup of the controller In case of an error the controller switches to a special mode and signal the fault Two different modes can be chosen in which one completely stops the controller reporting while the other tries to get the system operable This prevents the system to generate ghost touches or get in an unusable state if there are problems with the sensor or the controller There are three tests which can be activated 1 Signal Limit Test This test checks if the sensor reference values are in a given limit 2 AVDD Test This test checks if AVdd or XVdd power is present 3 Pin Fault Test This test can detect resistive line to line and low resistance sensor shorts In maxtouch txt file three states are printed Wee disabled No test is activated default Date Bearbeiten Format Ansicht Firmware version 3 0 single Touch Controller mxT640T V1 2 FW Rev TI ar cen passed All activated tests passed sensitivity threshold Switch x and Y failed One of the activated tests failed lf one of the tests failed there are two operati
6. e Version FW Rev 12001457 000 Self test disable _ 5 Article Revision Number Sensitivity threshold 45 easyCARE Switch X and Y Invert X coordinates Invert Y coordinates Initial movement hysteresis Next movement hysteresis Touch detection integration H A N N O O O User Settings Number of reported touches Touch automatic calibration 50 Clipping X low Clipping X high Clipping Y low Clipping Y high Enable right click 0 0 0 0 1 Page 9 of 19 DATA MODUL www data modul com DATA MODUL 4 Operating Systems With the technology of the Driverless firmware easy TOUCH USB controllers can be used with the most common operating systems The following table gives an overview of the tested operating systems and the available features Operating Version Operational Note System Mode Win 8 Professional ST 32Bit MT Win 8 1 Professional ST Changing configuration in mass storage device may 64Bit SP 1 differ to other OS MT Please use the easyANALYZER tool to change settings Win7 Professional ST 32 bit 64 bit MT Linux Ubuntu 12 04 ST Limited right click functionality may depend on used LTS window manager and X configuration Precise Pangolin MT For multi touch under Linux please refer to the 3 5 0 23 Application Note Multitouch under Linux generic 32 bit WinCE 5 ST The document touchHID WinCE Patch Instalation pdi shows how to
7. erts X coordinates CON Invert Y coordinates Inverts Y coordinates a Initial movement This setting is used to detect an initial 0 255 2 5 hysteresis movement Setting this parameter with a high value will make the system less sensitive to non desired small finger movements avoiding cursor flickering At the same time a larger finger movement will be necessary for starting the cursor to move Next movement This setting is used to detect further 0 255 hysteresis movement after initial movement Setting this parameter with a low value will increase the sensibility of the cursor in a movement Touch detection This setting is used to provide detection 1 255 integration filtering A counter is incremented each time v Ge 1 a touch is detected If the counter reaches means no the given limit it will be reported as touch integration event to the operating system This is very useful to supress electrical noise Number of reported Defines the number of touches reported by 1 10 10 the touch controller Range 1 10 In order to Page 7 of 19 DATA MODUL www data modul com DATA MODUL Command Description Range Typical Value keep response time short use the lowest possible value suitable for your application In single Touch Mode operational mode 1 there is only one touch reported to the operating system Touch automatic 0 infinite 1 255 in 200ms increments Defines the duration a touch is
8. for negative clipping boundary For example to adjust a smaller touch area to a bigger display Example Negative Clipping Boundary kaL Y low Clipping X low Clipping X high AGENCE CippingY high Y high Page 17 of 19 DATA MODUL www data modul com DATA MODUL Appendix 2 Changes from Firmware 1 3 to 2 0 e Added easyBUTTON support e Added easyANALYSER support e Added easySETTINGS support e Added easyCARE support e Fixed multi touch right click issue Changes from Firmware 2 0 to 3 0 e Firmware 3 0 is only available for easy TOUCH T Series e Firmware 3 0 based on a new Xmega microcontroller e Config HID is available in operational mode 1 and 2 Changes from Firmware 3 0 to 3 1 e Added mXT640T Firmware 1 5 support e Improved easySETTINGS e Included calibration command for easyANALYZER e Improved multi touch task for better touch performance Page 18 of 19 DATA MODUL www data modul com DATA MODUL Headquarters DATA MODUL AG Landsberger Str 322 DE 80687 Munich Germany Phone 49 89 56017 0 Fax 49 89 56017 119 www data modul com Logistics Production amp Services DATA MODUL Weikersheim GmbH Lindenstrasse 8 DE 97990 Weikersheim Germany Phone 49 7934 101 0 Fax 49 7934 101 101 Subsidiaries amp Sales Offices Germany Hamburg Germany Duesseldorf Denmark Dubai Finland Baltic France Italy Singapore Spain S
9. ge Device Copy the file maxtouch txt from the Mass Storage Device to a local directory Modify and save the file locally not in Mass Storage Device Copy the file maxtouch txt from the local directory back to the Mass Storage Device Do not open the file maxtouch txt directly on the Mass Storage Device Reset your embedded computer for the settings to be applied How to read the content of maxtouch txt Reset your embedded computer Do not open the file maxtouch txt directly from the Mass Storage Device Copy the file maxtouch txt from the Mass Storage Device into a local directory Open your local copy of maxtouch txt Page 6 of 19 DATA MODUL www data modul com DATA MODUL 3 1 Write User Settings In order to write a new configuration to the controller commands must be written into the maxtouch ixt file Each line of the text file contains one command which ends with a RETURN At the end of the file there must be at least one empty line A command is usually followed by a value The value can be any number in the range that is shown in the table below lt command gt lt Value gt Example Sensitivity threshold 20 The following commands are supported Command Description Range Typical Value Sensitivity threshold threshold Sets the touch sensitivity threshold the touch Sets the touch sensitivity threshold threshold nm 255 2045 45 sie A and Y Switches X and Y orientation S in Invert A coordinates Inv
10. held until it is considered as false and an automatic calibration is performed to compensate This is useful to keep touchscreen operating when foreign objects dirt water drops are located on the touch surface After an automatic calibration the field change at the position of the object is considered as normal so no unexpected touch events are generated anymore Clipping X low This setting can be used to adjust the touch area See appendix 1 Clipping X high calibration 0 50 or 1 to 50 0 50 or 1 to 50 This setting can be used to adjust the touch area See appendix 1 Clipping Y low This setting can be used to adjust the touch area See appendix 1 Clipping Y high This setting can be used to adjust the touch area See appendix 1 0 50 or 1 to 50 Enable right click This setting can be used to enable right click for Single Touch only Page 8 of 19 DATA MODUL www data modul com DATA MODUL The following commands will not be visible in the modified maxtouch ixt after a reset operational Sets the operational Mode to the supplied value 1 2 7 8 see chapter operational modes Writes all easySETTINGS to the controller no value no value Requires a reset afterwards 3 2 Read User Settings Example for the maxtouch txt file eee version 2 0 aingle Tonchi Driverless Firmware Version Single Multi Touch Controller mXT640T V1 2 m Atmel Controller Atmel Firmwar
11. onal modes selectable 1 Complete touch system hold no touches will be reported 2 A warning is printed in maxtouch ixt normal operation if possible with defect sensor This feature is only available after consulting DATA MODUL Page 14 of 19 DATA MODUL www data modul com DATA MODUL 9 easyANALYZER support The easyANALYZER application consists of a debugging analysis and configuration toolset for fault detection and optimization The Driverless firmware version 3 0 or higher requires an easyANALYZER version 2 0 or higher The application communicates with the firmware via USB and visualizes the diagnostic data in a 3D view for interpretation Using easyTOUCH T Series controllers running Driverless firmware 3 0 or higher it is no longer necessary to switch to a special mode for using easyANALYZER Please check the detailed description of the operational modes in chapter 2 of this document Main features e Display sensor reference values for sensor health check e Display raw touch signals to check for noise and SNR e Record and playback of the raw touch signals e Recorded data file can be emailed to DATA MODUL for analysis e Read and write basic controller settings like in maxtouch txt e Read and write easySETTINGS complete controller settings e Change between single touch multi touch e Enable disable maxtouch drive mass storage drive e Multitouch FULL SCREEN drawing tool only in multi touch mode
12. ouch support the controller does not need an own driver and uses the driver which is included in the OS Data Moduls easy TOUCH driverless controllers offer a very simple way to change the controller settings like adjusting touch sensitivity By providing a configuration file which is saved on a mass storage drive on the easyTOUCH USB controller the adjustments can be done without any additional software Beside this the controller configuration can also be edited with the easyANALYZER software The controller provides different operational modes which switch between single or multi touch and hide or show the mass storage drive The operational mode can be changed via the configuration file or with the easyANALYZER software 1 http www usb org developers Some operating systems may need a patch for internal configuration that is provided by Data Modul Page 4 of 19 DATA MODUL www data modul com DATA MODUL 2 Operational Modes The Driverless firmware has different operational modes Each mode is defined by its available features The following features are possible Feature Description MS Allows the user to change the configuration of the touch Mass Storage controller using a text file see chapter Configuration using Mass Storage Device ST In this mode the touch controller behaves like a mouse with Single Touch HID absolute coordinates That means that only one touch is reported from the USB con
13. s storage interface enabled This mass storage interface is used like an USB stick and therefore the operating system will treat this the same way The easyTOUCH mass storage drive has a size of 41kB and is based on a FAT file system It contains only one file named maxtouch txt Configuration settings can be changed by writing data into the text file The currently active configuration can be read by opening the file Please note while working with the configuration file on the mass storage drive there is absolutely no connection between the data that is written into the file and the data that can be read from the file This is caused by data buffering of the operating system After buffering the operating system overwrites the data written to the file as current content li the maxtouch txt file does not show the settings that where just entered it may be necessary to reset the controller using the reset command or restart the OS Please consult the examples section for the needed commands The easiest way to edit the maxtouch txt is to use a text editor that directly edits the file and does not create a local copy of the file and then tries to overwrite the maxtouch txt Regarding writing and reading from Mass Storage Device there are some OS dependencies that must be considered Windows CE5 CE6 EC7 How to change a parameter on the maxtouch txt Reset your embedded computer Do not open the file maxtouch txt directly from the Mass Stora
14. troller Use this mode for operating systems with no multi touch support To use the right mouse click please touch the sensor for at least 1 5 seconds on the same position Caution Right click functionality and performance may differ between operating systems MT In this mode up to 10 touches can be reported from the USB Multiple Touch HID Digitizer controller to the operating system Caution Use this mode only if your operating system supports the USB HID multi touch class see chapter operating system CH In this mode it is possible to use the easyANALYZER software Config HID for debugging and configuration These are the available operational modes and their active features Mode Features Description VO This mode shall not be used For recovery the MS is still active in all invalid modes MS ST CH Mass Storage Single Touch and Config HID MS MT CH Mass Storage Multi Touch and Config HID ST CH Single Touch and Config HID e MT CH Multi Touch and Config HID To change the mode see chapter 5 2 Change operational mode Page 5 of 19 DATA MODUL www data modul com DATA MODUL 3 Configuration using Mass Storage Device The Driverless firmware allows the user to change the configuration of the easyTOUCH USB controller using a text file If the Mass Storage Interface is enabled the easyTOUCH USB controller will be detected as a composite USB device that also has a mas
15. witzerland UK USA DATA MODUL s worldwide offices can be found on our website www data modul com eu sm H contact us offices html H no d NNN Page 19 of 19 DATA MODUL www data modul com
16. ww data modul com DATA MODUL 6 3 Save easySETTINGS to touch controller 1 Delete maxtouch txt from the mass storage device 2 Open the easySETTINGS file 51 84 FF 59 29 82 7A 02 4F FC 2C OF D1 85 78 49 B6 95 9F E8 D9 74 16 BD 97 D6 7D 85 FD BO EF gt gt store reset At the end of the file type store return and reset return Save the file Copy the easySETTINGS file into the mass storage device The controller is now rebooting After reboot all controller parameters are updated a oe m ee ES 7 easyBUTTON support The driverless firmware supports eight touch keys which can be defined along the edges of the touch sensor in special button area Additionally to the keys a touch area can be defined for single or multi touch EasyBUTTON support can be used with easy TOUCH T Series which feature the Atmel mXT640T and mXT2952T2 controllers To use easyBUTTON support the firmware can be switched in two special operational modes These two modes disable the mass storage device enable ST or MI mode and a keyboard HID device This device reports the pressed key to the host device like a common USB keyboard Additionally there will be a special USB protocol provided by the Config HID device which allows the configuration of the keys These enhancements are available from driverless firmware versions 3 0 and higher Main features e Unique solution for a PCAP sensor and PCAP buttons with only 1 controller e Only 1 interfac
Download Pdf Manuals
Related Search