manualshive.com logo in svg

3M MicroTouch MT7, User Manual, Page: 42 / 57

Share
Download
3M MicroTouch MT7 User Manual Download Page 42

42 

 

3M™ MicroTouch™ Software MT 7 User Guide 

 

3M Touch Systems, Inc. Proprietary Information – 25695K 

Installation Instructions 

The MT 7 for Linux® software is proprietary and not open source. The distribution is an 
executable program. Run this program using the following command lines where "*" is 
replaced with the current file version number: 

chmod a+x mt7.*.bin 
/mt7.*.bin 

You will then be asked to either accept or decline the license agreement. If you accept the 
agreement, the program produces a 'tar.gz' file. Follow the remaining instructions to 
complete the installation process. For your convenience, the 'tar.gz' file contains a copy 
of the license in the file 'License.txt'. 

Preparation  

You must log in the Linux® operating system as the root user or use the 'su' command to 
get super user access. On some systems, you may need to run in single user mode (run 
level 1 on some systems). The installation process requires write access to various system 
directories. By default, the directories are: 

•

 

/etc/udev or /etc/hotplug  

•

 

/usr/lib/xorg/modules/input or /usr/X11R6/lib/modules/input 

•

 

/usr/lib 

•

 

/etc/init.d or /etc/rc.d  

•

 

/etc/X11/xinit/xinitrc.d or /etc/X11/xsessions.d 

After installation completes, the MT 7 for Linux® software no longer requires write 
access to these directories. 

General Instructions  

The MT 7 for Linux® package arrives as a tar.gz file. By default, the expanded package 
resides in the subdirectory 'twscreen'. A script named 'Install' installs the package. 
Installation includes creating the necessary init script, creating symbolic links in /usr/lib, 
making a X input module available, enabling USB hotplug for 3M™ MicroTouch™ 
devices, and creating a Remove script.  

Before installing the package, read below to see if any of these special situations apply to 
you. If they do, you may need to edit the Install script.  

If you run the Install script and then discover errors, always run the Remove script to 
undo the installation. This removes possibly erroneous links into your system. Then edit 
the Install script, make the necessary changes, and install again. 

Summary of Contents for MicroTouch MT7

Page 1: ...prietary Information 25695K 3M MicroTouch Software MT 7 User Guide For Microsoft Windows Windows CE and Linux Operating Systems Read and understand all safety information contained in this document before using this product 3 ...

Page 2: ...esigned for use in medical devices as defined by United States federal law 3M Touch Systems Inc products and software should not be used in such applications without 3M Touch Systems Inc express written consent User should contact its sales representative if User s opportunity involves a medical device application IMPORTANT NOTICE TO PURCHASER Specifications are subject to change without notice Th...

Page 3: ... Chapter 2 MT 7 Software Control Panel Overview 13 Opening the MT 7 Control Panel 13 Main Tab 14 Touch Settings Tab 17 Edge Adjustment Tab 20 Edge Adjustment Setting 20 Tools Tab 22 Controller Tab 25 Chapter 3 Windows CE Overview Installation Instructions 31 Instructions for Platform Builder for Microsoft Windows CE 6 0 R3 35 Supporting Multiple Windows CE Versions 36 Supporting Multiple Projects ...

Page 4: ...Windows Only Overview 49 Changing the Controller ID 49 Setting Up Multiple Monitors 49 Appendix B Troubleshooting the Touch System Overview 53 Other Serial Devices Do Not Work 53 Multiple Display Support 54 Cursor Does Not Reach Edges of Display 54 Cursor is Jittery 54 Cursor Jumps or Bounces Suddenly Across the Display 54 Double Click Doesn t Work not available on Windows CE or Linux 54 Drawing L...

Page 5: ...wing All current 3M MicroTouch controllers no legacy controllers and chipset designs Capacitive and resistive touch technologies Both USB and RS 232 communication protocols Sensor Care and Cleaning The sensor requires very little maintenance 3M Touch Systems Inc recommends that you periodically clean the glass surface CAUTION To reduce the risk of the potentially hazardous situations associated wi...

Page 6: ...m software and drivers obtain regularly updated technical documentation on 3M Touch Systems products and learn more about our company Whenever you contact Technical Support please provide the following information Touch display size part number and serial number Current driver version Operating system used Information on additional peripherals Technical Support is available Monday through Friday 8...

Page 7: ...are tools to help you work with and customize the touch sensor Specifically MT 7 Software includes the following programs and utilities Touch drivers Control panel Software uninstall utility Calibration tool Multi Display tool Windows only Touch Drivers Touch drivers are the software the system uses to communicate with the touch controllers MT 7 Software includes drivers for applications running i...

Page 8: ...rs 3 4 and 5 Calibration Tool This tool enables you to calibrate your touch sensor without launching the control panel For Linux use etc twscreen TwCalib For all other operating systems use twcalib exe Multiple Display Manager This tool enables you to set up an arrangement of multiple displays with sensors Microsoft WHQL Certification Note that the MT 7 touch driver is WHQL certified WHQL certific...

Page 9: ...stallation 5 When prompted to choose the installation type select whether to perform a Typical Install Full Install or Custom Install or if available Upgrade During installation you may get messages about finding new hardware This is the MT7 driver searching your serial ports for touch controllers The Typical option automatically installs the minimum required MT 7 software files creates a MT 7 pro...

Page 10: ...res when used in conjunction with Windows 7 This includes flicking an onscreen keyboard and a press hold liftoff action for the right click function HID Mouse Has right click desktop button Legacy Mouse Enables multi display mapping and has right click desktop button User Interface The User Interface provides the following components The Control Panel is used to configure the sensor The Help butto...

Page 11: ... this script by running the Setup program in record mode During a silent install the Setup program receives input from the recorded install script rather than from a user Once you record an installation script you can run it on as many similar systems as you like The first step in producing a silent installation is to record your standard installation Open a command line window and set your workin...

Page 12: ...l You can adjust settings for touch sounds double click speed and double click area not applicable to WIN CE or Linux systems Note You can define touch settings using the MT 7 Control Panel MT 7 stores the touch settings in the Windows system registry Whenever you save changes to the MT7 Control Panel MT 7 software records the new settings in the system registry These changes take effect immediate...

Page 13: ...e a frame around the active touch area in which the cursor moves closer to the edges of the sensor Use the Tools tab to restore hardware or software defaults reset controller run Draw Test from the desktop and to enable Advanced Options for your touch sensor Use the Controller tab to activate linearization select frequency set controller ID and determine pen finger modes Note that this tab appears...

Page 14: ...or If the sensor is not calibrated the active area of the sensor may not be aligned properly or may be unnecessarily small You should calibrate the sensor in the following cases Any time you change the size and position of the video image by adjusting the horizontal and vertical controls on your display Any time the cursor does not follow the movement of your finger or does not reach the edges of ...

Page 15: ... you touch the target 5 Repeat these instructions for additional calibration targets 6 Once you have calibrated the sensor a dialog box will appear to ask if you wish to test accept or cancel this calibration If you select Accept then the new calibration settings are automatically accepted If you select Test then a Draw refer to the Tools tab for more details screen appears When you exit Draw mode...

Page 16: ...ust This field identifies the controller s attached to your system It will display unique identifiers for each controller attached to your system in a drop box When you select a controller from this list the Controller tab will reflect only this controller any changes will be made only to this controller USB controller values include USB00000001 USB00000002 or USB00000003 For EX serial controllers...

Page 17: ...are error such as a checksum error in controller EEPROM CBL Error Cable NOVRAM missing this is only an error in systems requiring cable NOVRAM HDW Error Hardware error LIN Error Linearity data error NOV Error Checksum error in NOVRAM using defaults PWM Error Hardware error ROM Error Checksum error in ROM SET Error Unable to establish operating range at power up Any other condition indicates a hard...

Page 18: ...o create an immediate button action as soon as you touch the sensor In Touchdown Mode you cause a button down at the cursor location with a short pause and then a button up You can leave your finger on the sensor but only a single touch is registered until you lift your finger off the sensor and touch down again Touching the sensor is equivalent to pressing and releasing the mouse button The actio...

Page 19: ...r around the point at which you are touching and upon liftoff the right click menu will appear Touch Sound Select audible beep on touchdown liftoff or no beep at all Click on the Beep button to select the appropriate option for your application The default setting is no beep on touch Beep off Double Click Speed not available on Windows CE or Linux Double click speed defines how quickly you must to...

Page 20: ...e Windows Start button check boxes or radio buttons For example if you have a row of buttons along the left edge of your sensor you may want to set an edge adjustment to enable users to easily activate these buttons Because each edge is independent of the other you only need to adjust the left margin to accommodate this row of buttons Edge Adjustment Setting To set the Edge Adjustment move the sli...

Page 21: ...area you have defined is sufficient for your needs Can you touch into the corners and along the edges of the sensor Click Escape End Test or Return to go back to the Edge Adjustment tab If you are satisfied with the selections you have made you are done If not adjust the sliders to better accommodate your needs ...

Page 22: ...ab The Tools tab enables you to perform a variety of diagnostics to optimize the performance of your sensor This tab is also the gateway to advanced touch options Component Versions This is an informational screen for diagnostic purposes that details the building blocks of MT 7 and its version numbers ...

Page 23: ...play a grid that you can use as a drawing guide default setting Press L line to draw solid lines on the screen default setting Press D dots to draw dotted lines on the screen where each dot represents a point reported by the sensor Press the Space Bar to clear the display Restore Factory Settings Software The Reset Software option is useful if you have reconfigured the MT 7 software and need to ge...

Page 24: ...ing the Advanced Options may alter the performance of your sensor or render it inoperable You should be aware of expected results before executing any option If you are not familiar with the outcome of these settings you should not be using these options This option controls certain advanced functions for your controller Depending on the options you have selected and the availability of that funct...

Page 25: ...plays the controller currently selected on the Main tab This data may be useful for Technical Support issues The touch controllers supported with this release are as follows EX USB HID and Serial capacitive and resistive controllers CX USB controllers DX Dual mode USB and Serial controllers PX Dual mode USB and Serial controllers RX USB and Serial resistive controllers SX Serial pen controllers De...

Page 26: ... When touching the target make sure you a Face the display directly b Perform the linearization in the position sitting or standing you expect to use the sensor c Touch the target firmly and precisely with your fingertip Be careful to keep your other fingers away from the sensor as you touch the target Hold a steady touch over the target until you hear a beep or until the target turns red 5 Repeat...

Page 27: ...lection You can still use the mouse to select an option The system saves the Pen mode so that the next time you power up the system the selected pen mode is active Pen and Finger Calibration On a pen system you must calibrate the sensor twice once with your finger and once with the pen if you are using Pen Finger mode Pen Modes Note Changing the Pen mode setting can optimize the performance of the...

Page 28: ...the default setting depends on your touch controller You can set a new operating frequency and then check the performance of the touch sensor at that frequency setting Be aware that if you choose Restore Factory Settings Controller from the Tools tab you will change the Sensor Frequency to the factory default setting You may need to redo the Sensor Frequency at this time Sensor Frequency Procedure...

Page 29: ... good frequency It is recommended that you recalibrate the touch sensor after you run the Sensor Frequency option Controller ID Note Changing this field will affect your multiple display setup From the Tools tab you can choose the Advanced Options button From the Advanced Options dialog select Enable Controller Identifier Selection to activate this option on the controller tab If you do not have a...

Page 30: ......

Page 31: ...he Installer puts the driver and control panel selected by user into the proper Platform Builder directories If you downloaded the distribution unzip the file into another directory Go to www 3mtouch com and click Touchscreen Software located on the left hand side of the page On the Touch Screen Software page there are several tabs click MT7 Drivers Choose CE from the dropdown menu under the headi...

Page 32: ...he Setup wizard To continue click Next License Agreement The next screen you will be shown is the License agreement Read through this agreement and either click I Do Not Agree or I Agree By clicking I Do Not Agree you will terminate the Setup and close the window Clicking I Agree will activate the Next button which will allow you to continue with the Setup ...

Page 33: ...he default Platform Builder Root Directory If you have your platform builder directory in a different folder select Browse and choose an alternate location Also on this screen is the Disk Cost button The Disk Cost button will tell you the amount of space the program will take up In addition you are given an option to install MT 7 13 for Windows CE on your own account or universally for all users o...

Page 34: ...tup is ready to install To continue and install click Next Installation Complete This is the final screen of the installation process and a notification of its completion Click close to exit out of the screen The Installer places most its files in a central directory called C WINCE600 PUBLIC 3MTOUCH This allows multiple Platform Builder projects to access the same files ...

Page 35: ...e under the Platform Builder for Windows CE 6 0 R3 and above without any user changes If you open a project for a CE 6 0 device using platform builder under Catalog Item Views you will see an entry for MT7 drivers under Third Party Device Drivers 3M Touch Systems MT7 Add the MT7 drivers and the Control Panel application by selecting the check boxes next to the MT7 catalog items Once the relevant c...

Page 36: ...tion into your image For the touch driver to work you must include USB support in your Windows CE image regardless of the type of sensor you use Supporting Multiple Windows CE Versions This supports all 6 0 versions if you re looking for support for CE 4 0 5 0 please refer to the legacy section of the website www 3mtouch com Supporting Multiple Projects By default the Installer places MT 7 in a ce...

Page 37: ... improve the behavior and appearance of the curve without affecting overall performance of the Windows CE system You can add this parameter to the system by editing the text file TwParams reg found in C MT7_CE x86 To add this parameter with a new default value insert the IOPollDelay line after the line below HKEY_LOCAL_MACHINE Drivers BuiltIn TwTouch Parameters IOPollDelay dword 1 value A value be...

Page 38: ......

Page 39: ...s including On line Help optional files on the development system The Installer puts the files in a default directory called C MT7_XPe You may select a different location if desired Loading MT 7 Into The Components Database Manager Use the Microsoft Component Database Manager CDM to add the MT 7 components to your XPe database In the CDM go to the Database tab and click on the Import button In the...

Page 40: ...T7 has several additional components found in the Component Browser under Software Application OEM that you may select according to the needs of your target system The MT7 Control Panel component allows the end user to calibrate their sensor configure and modify some touch behavior The MT7 Calibration Tool component allows the user to calibrate their sensor Note that you must select one or more of...

Page 41: ...of processors One or more of the following 3M MicroTouch touch controllers EX USB HID and Serial controllers CX USB controllers DX Dual mode USB and Serial controllers PX Dual mode USB and Serial controllers RX USB and Serial controllers SX Serial pen controllers Depending on the sensor either a serial port or a USB port is required Software Prerequisites The MT 7 for Linux software requires a 32 ...

Page 42: ...s to various system directories By default the directories are etc udev or etc hotplug usr lib xorg modules input or usr X11R6 lib modules input usr lib etc init d or etc rc d etc X11 xinit xinitrc d or etc X11 xsessions d After installation completes the MT 7 for Linux software no longer requires write access to these directories General Instructions The MT 7 for Linux package arrives as a tar gz...

Page 43: ...ut other changes on most Linux systems However if you have a customized directory structure or the installation script fails you may need to edit the Install script and change one or more of the following script variables ConvertAtRead The MT 7 for Linux X input module translates raw touch data from the touch driver into the X Windows server display locations Normally the X server does this in two...

Page 44: ...script detects SELinux it assigns the security type texrel_shlib_t to some shared objects If this is not appropriate for your system edit the script and change this variable UdevDir and HotplugDir The MT 7 for Linux software supports hot plugging of USB controllers through either the udev or the hotplug systems Older versions of Linux used the hotplug system The udev system replaced hotplug It is ...

Page 45: ... of the message may refer to other directories depending on the setting of the LibDir variable in the Install script The installation script could not find the standard C shared objects Confirm that the LibDir variable is set correctly If so you need to install the C shared objects or if already present create a symbolic link using the name libstdc so to the C shared object Cannot find shared memo...

Page 46: ...ed by MT 7 for Linux to launch background tasks Edit the Install script and set the XinitDir variable Cannot install the X input module The Install script could not find the directory for the X input module Confirm that the variable XorgDir or XFree86Dir is set correctly in the Install script Hot plugging of USB touch controllers is not supported The Install script cannot find the udev or hotplug ...

Page 47: ... is missing or there is an error in the log file refer to the section above Troubleshooting the Init Script If the cursor reacts to a touch but does not appear under your finger usually a simple calibration fixes the problem If it does not open a terminal window and type the command X version If the first line of the output starts with X Org X Server 1 4 then you may need to enable the ConvertAtRe...

Page 48: ...with the value of MT7FontSansSerif until the calibration text is suitable For example if MT 7 for Linux is in etc twscreen a test sequence may be MT7FontSansSerif utopia export MT7FontSansSerif etc twscreen TwCalib You can also test your font string with xlsfonts After setting MT7FontSansSerif issue the command xlsfonts fn MT7FontSansSerif to see what font if any matches If you find a suitable fon...

Page 49: ...me identifier You must change these IDs before you run the multiple monitor manager Changing the Controller ID To change the Controller ID 1 These values may be edited from the Tools tab Advanced Options menu and select Enable controller identifier editing The resulting editable field appears on the Controller tab 2 Controller ID values can be as simple as 00000001 00000002 and 00000003 3 Once the...

Page 50: ...ou may choose to Save your changes Cancel your changes or simply Start Over In the screen below none of the touch screens or monitors has been linked In the following example Touch Screen A has been linked to Monitor 1 and Touch Screen B has been linked to Monitor 2 Note the color similarities once a Touch Screen and a Monitor have been associated ...

Page 51: ...tors that can be linked In the following example touch Screen A has been linked to Monitor 2 Touch Screen B has been linked to Monitor 7 Touch Screen C has been linked to Monitor 1 Touch Screen D has been linked to Monitor 9 and Touch Screen E has been linked to Monitor 8 Note the color similarities once a Touch Screen and a Monitor have been associated ...

Page 52: ......

Page 53: ...nd restart your system Verify that any previously loaded hardware and or software installed in the same serial port as your sensor has been uninstalled Even though the hardware has been disconnected the software can still claim the port Ensure that all components are completely removed from the system files To correct the communication settings in a Windows system use the Windows Hardware Conflict...

Page 54: ...ners and edges of the sensor Cursor is Jittery You need to adjust the Sensor Frequency Choose Sensor Frequency from the Controller tab Any time you adjust the frequency you should test how the sensor is working and verify you are satisfied with the operation of the sensor Note This option applies to capacitive EX and CX series controllers Cursor Jumps or Bounces Suddenly Across the Display You are...

Page 55: ...nformation box on the Main Tab is grayed out and contains no information the sensor is not communicating with the controller If MT 7 does not find the sensor check that the sensor is connected properly If you are experiencing problems with the sensor check that all cables are connected properly and restart your system To correct the communication settings in a Windows system use the Windows Hardwa...

Page 56: ...d setting above a touch starts producing a right click To address this edit the file TwFactory cfg in the MT 7 for Windows software directory If this file is empty add in the text Touch Touch Between these two lines add a new line SwapMouseButtons 1 Save the file Open a command line window and set your working directory to the MT 7 for Windows directory Issue the command TwCfgUtil u TwFactory cfg ...

Page 57: ...3M Touch Systems Inc Proprietary Information 25695K If this does not work MT 7 still won t install then the Registry needs editing Start REGEDIT and browse to HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services MTSTCH and delete the MTSTCH key ...

Reviews:

No comments