Elo TouchSystems software Driver Manual

Dos and windows
Table of Contents

Advertisement

®
DOS and Windows
Driver Guide
Version 2.0

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the software and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Elo TouchSystems software

  • Page 1 ® DOS and Windows Driver Guide Version 2.0...
  • Page 2 DOS and Windows Driver Guide Version 2.0 Manual Version 2.0b Copyright 1987-1994, 1994-1995 © Elo TouchSystems, Inc. 105 Randolph Road Oak Ridge, Tennessee 37830 (615) 482-4100 A Raychem Company All rights reserved. P/N 008100-A DOC # SW000054...
  • Page 3: Software License Agreement

    Trademark Acknowledgements IntelliTouch, AccuTouch, and MonitorMouse are registered trademarks, and ELODEV, TouchUp, TouchBack, and SmartSet are trademarks of Elo TouchSystems, Inc. All other trademarks are the property of their respective holders. Copyright Copyright © 1987-1992, 1994-95 by Elo TouchSystems, Inc. All rights reserved. Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under copyright laws.
  • Page 4: Table Of Contents

    Contents Introduction ....................1 About this Manual....................1 About Elo Software....................2 Included Software..................2 Other Software Available from Elo............. 3 Writing Your Own Driver ................4 Touchscreens and Controllers Supported ..........4 System Requirements ................6 Differences from Previous Versions ............6 Distribution Rights..................
  • Page 5 Black Jack..................22 Touch X,Y ..................22 Jigsaw Puzzle ................23 Touch Windows ................23 Home Control................23 How ELODEMO Was Created ................24 DOS Touchscreen Driver and Calibration Utility ........25 Introduction ......................25 Who Should Use ELODEV and ELOCALIB ..........25 Compatibility.......................
  • Page 6 Light Pen Emulation ................43 Installation ......................44 Included Files ..................44 Placement in AUTOEXEC.BAT ............... 44 Using MonitorMouse Without a Mouse............ 45 Using NOMOUSE.COM ..............45 Command Line Flags ............46 Using PATCHMSE.EXE..............46 Command Line Flags ..................47 Mouse Button Emulation Mode Flag (-m) ..........
  • Page 7 Choosing the Control-Menu, Minimize, Maximize, and Restore Buttons . 63 Elo Wallpaper ..................64 Running DOS Programs from Windows............. 64 Running DOS Mouse-Driven Programs........... 64 Running DOS ELODEV-Based Programs ..........64 Running DOS Polled Touchscreen Programs ......... 65 Other Driver Configurations................65 TouchBack....................67 Introduction ......................
  • Page 8 Peeling Back the Layers ................94 Calibration Problems ................94 Where to Go From Here ................95 MonitorMouse for Windows ..............96 Touchscreen Control Panel ............98 MonitorMouse for DOS ................99 TouchBack..................... 101 ELODEV ....................102 ELODEMO..................... 103 ELOCALIB ..................... 103 Diagnostic Utilities ....................
  • Page 9: Introduction

    Introduction About this Manual 1 About Elo Software 2 Product Registration 7 Contacting Elo 7 BOUT THIS ANUAL This manual provides all of the information you need to install and use the software on the Elo TouchSystems DOS and Windows Driver Disk. This manual is organized as follows: Chapter 1 Describes the included software and hardware requirements.
  • Page 10: About Elo Software

    Chapter 1 - Introduction Chapter 6 Details the use of MonitorMouse for Windows. Chapter 7 Describes the installation of TouchBack™, a keystroke emulation driver for DOS. Appendix A Provides detailed information on configuring your touchscreen controller. Appendix B Gives tips on troubleshooting an installation. Appendix C Lists error messages with explanations.
  • Page 11: Other Software Available From Elo

    About Elo Software may be used in conjunction with the touchscreen. DOS mouse-driven programs run from Windows may also use the touchscreen. TouchBack Keystroke emulation driver for DOS. Applications must be specially written for use with TouchBack. Your application documentation should specify if TouchBack is required.
  • Page 12: Writing Your Own Driver

    Chapter 1 - Introduction The following manuals and software are included in the DOS Programmer's Toolkit, also available separately from Elo: ELODEV Programmer's Reference Defines application programming interface for the ELODEV touchscreen driver. Includes sample source code in C, Pascal, and assembly. (70 pages). TouchBack Programmer's Reference Defines...
  • Page 13 About Elo Software touchscreen absorbs a portion of the wave at the touch location. The touchscreen controller's microprocessor analyzes the resulting change in the received signal and determines the touch coordinates. The IntelliTouch touchscreen can sense both touch location and touch pressure. A touchscreen controller is required for both technologies to provide touchscreen drive signals, convert received analog signals into digital coordinates, and transmit coordinates to the PC.
  • Page 14: System Requirements

    Chapter 1 - Introduction Part Number Controller Model 00285X-XXX Enclosure Contains E281-4002 IntelliTouch Serial Controller, configured for Stream Mode, Binary Mode, Z-Axis Enabled, 9600 Baud. E271-3 Enclosure Contains E271-140 AccuTouch Serial Controller, configured for 2400 Baud, 8-Bit Data, Binary Mode, Filtered Mode, Stream Mode.
  • Page 15: Distribution Rights

    Product Registration The performance of MonitorMouse for DOS and MonitorMouse for Windows have been enhanced when using an IntelliTouch controller with firmware revision 2.2 or later, or a SmartSet™ controller (E271-22xx or E281-23xx). The DOS demonstration program has been converted to VGA and enhanced considerably.
  • Page 16 Chapter 1 - Introduction Product announcements, press releases, application notes, software drivers and utilities are available on CompuServe and the Elo BBS. Your comments and suggestions are welcome.
  • Page 17: Installation

    Installation Step 1 - Configuring the Touchscreen Controller 9 Step 2 - Installing the Controller 10 Step 3 - Running the INSTALL Program 10 Step 4 - Calibrating the Touchscreen 12 Where to Go from Here 13 Changing Your Hardware Configuration with SETUP 14 Uninstalling the Software 14 This chapter describes the installation procedure for the software on the DOS and Windows Driver Disk.
  • Page 18: Step 2 - Installing The Controller

    Chapter 2 - Installation Serial controllers are usually ready to use. PC-Bus controllers require a hardware interrupt (IRQ) and a block of I/O ports that will not contend with another device. If IRQ5 and/or I/O ports 280-299 are not available, you may have to re-jumper your controller. Micro Channel controllers are configured with the Reference Disk included with your PS/2 or compatible computer.
  • Page 19: Command Line Flags

    Step 3 - Running the INSTALL Program Your AUTOEXEC.BAT file, (and SYSTEM.INI file for Windows install-ations), will be modified by the INSTALL program. Copies of the original files will be saved as AUTOEXEC.OLD and SYSTEM.OLD. Command Line Flags Several flags may be specified on the INSTALL command line. To override the default system language used by INSTALL, specify the -L flag as follows: INSTALL -L<x>...
  • Page 20: Step 4 - Calibrating The Touchscreen

    Chapter 2 - Installation 4 - C ALIBRATING THE OUCHSCREEN The final installation step is calibrating the touchscreen. Type "GO" when instructed to begin the calibration sequence. You will be prompted to touch three calibration points on the screen. Before you do so, position yourself in front of the screen in normal sitting (or standing) position, with normal height and reach.
  • Page 21: When Recalibration Is Necessary

    Where to Go from Here The displayed image can also be tilted. Even changing video modes can affect the screen size. Perfect calibration cannot be achieved in all circumstances. For example, the user can encounter parallax problems with a change in position, or because the present user is not the same stature as the person who calibrated the screen.
  • Page 22: Changing Your Hardware Configuration With Setup

    Chapter 2 - Installation For details on available product configurations, theory of operation, touchscreen installation, and general troubleshooting, see the IntelliTouch Product Manual or the AccuTouch Product Manual as appropriate. Technical Reference manuals are also available for Elo touchscreen controllers. The remainder of this chapter discusses changing your hardware configuration and uninstalling the software.
  • Page 23: All Elo Software

    Uninstalling the Software \WINDOWS\SYSTEM. Delete the lines indicated by comments as added by Elo from your SYSTEM.INI file. Delete the [EloCalW] section from WIN.INI. Run Windows Setup and re-select your mouse. All Elo Software Delete the Elo directory (typically \TOUCH) and then follow the instructions above for deleting MonitorMouse for Windows if necessary.
  • Page 24: Dos Demonstration Program

    DOS Demonstration Program Introduction 67 Installation 18 Running ELODEMO 18 How ELODEMO Was Created 24 NTRODUCTION Included on the accompanying DOS and Windows Driver Disk is ELODEMO, a touchscreen demonstration program for DOS. ELODEMO has several sample applications, but its main purpose is to demonstrate the capabilities of the hardware.
  • Page 25: Installation

    Chapter 3 - DOS Demonstration Program NSTALLATION ELODEMO is installed with the INSTALL program on the DOS and Windows Driver Disk by choosing Express Installation Selective . To conserve disk space, ELODEMO is not installed if you Installation choose . You may choose later to install Windows Express Installation ELODEMO with Selective Installation...
  • Page 26 Running ELODEMO Figure 3-1. ELODEMO Main Menu To prevent the various demos from timing out to the main menu, type: ELODEMO -t To customize your demo with a trade show or company name, use the -c flag. The text between the quotes can be up to 15 characters: ELODEMO -c"<Name>"...
  • Page 27: Demo Descriptions

    Chapter 3 - DOS Demonstration Program Demo Descriptions The following is information on ELODEMO that may not be obvious. Main Menu This screen demonstrates a "secret zone". If the "-x" flag is used when running ELODEMO to prevent users from exiting to DOS, you must touch the extreme lower left corner of the screen, then touch the normal "Stop Demo"...
  • Page 28: Stereo Unit

    Running ELODEMO Stereo Unit Touch the "Power" button to activate and quit the equalizer/spectrum analyzer. It is easy to set all the levels at once. Simply slide your finger horizontally across all of the slide controls. Finger Painting This screen demonstrates the speed, resolution, and accuracy of Elo touchscreens. You can choose a color and thin or wide lines.
  • Page 29: Touch Piano

    Chapter 3 - DOS Demonstration Program While the use of untouch in the keyboard demo allows a higher density of touch zones, it does require training, although only a few seconds worth. With the public, you do not have any opportunity for training. Because Point Mode is natural to use, public-oriented applications should be written using it.
  • Page 30: Jigsaw Puzzle

    Running ELODEMO Untouch Mode outputs two points for each touch—once when first touched, and once on untouch. For more information on programming, see the DOS Programmer's Toolkit, available separately from Elo. Jigsaw Puzzle Solve a jigsaw puzzle. Slide each piece into place. An audio signal indicates it is locked into its correct position.
  • Page 31: How Elodemo Was Created

    Chapter 3 - DOS Demonstration Program sliding them, as you would set the time on a grandfather clock. As you move the minute hand, the hour hand and AM/PM will change appropriately. You may also move the hour hand and touch "AM" or "PM" directly. Note the On Time selected is displayed.
  • Page 32: Dos Touchscreen Driver And Calibration Utility

    DOS Touchscreen Driver and Calibration Utility Introduction 25 Compatibility 26 Installation 26 ELODEV 27 ELOCALIB 35 NTRODUCTION Included on the accompanying DOS and Windows Driver Disk are ELODEV™ and ELOCALIB, a touchscreen driver and calibration utility for DOS. Who Should Use ELODEV and ELOCALIB ELODEV makes all Elo touchscreens and controllers look the same to application programs or other drivers.
  • Page 33: Compatibility

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility The ELOCALIB utility is run automatically during the calibration step of the installation process. You may run it again as required. ELOCALIB is used only with DOS programs as MonitorMouse for Windows has its own calibration program.
  • Page 34: Elodev

    ELODEV ELODEV Placement in AUTOEXEC.BAT The ELODEV command line is placed in AUTOEXEC.BAT by the INSTALL program. ELODEV.EXE is a terminate-and-stay-resident (TSR) program and must be installed before any other Elo driver, including MonitorMouse for DOS (MONMOUSE.COM) and TouchBack (TCHBACK.EXE). ELODEV occupies about 6K of system RAM when loaded.
  • Page 35: Serial Controllers

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility Serial Controllers Command format: ELODEV <controller>,<COM port>,<baud rate> where <controller> is: 2300 for the IntelliTouch E281-2300 controller. 4002 for the IntelliTouch E281{A}-4002 controller. 2210 for the AccuTouch E271-2210 controller. 2200 for the AccuTouch and DuraTouch E271-2200 controller. for the AccuTouch E271-140 controller.
  • Page 36: Micro Channel Controllers

    ELODEV <IRQ> matches the interrupt jumper on the controller. (The IRQ for the E271- 2201 controller is software selected by the ELODEV command line rather than with a jumper.) For example, ELODEV 2201,280,5 Micro Channel Controllers Command format: ELODEV <controller> Where <controller>...
  • Page 37: Calibration Points Flag (-C)

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility Calibration Points Flag (-c) This flag specifies the Calibration Points: -c<XLow,XHigh,YLow,YHigh,ZLow,ZHigh> The coordinates are specified in decimal. Purpose Calibration tells ELODEV the position and size of the video image in relation to the touchscreen.
  • Page 38: X,Y Axes Swapping Flag (-S)

    ELODEV 10 will be reported as having a value of 10. Likewise, when ZLow is increased to 5, all lighter touches will be reported as having a value of 5. X,Y Axes Swapping Flag (-s) This flag can be used to swap the X and Y axes to correct touchscreens rotated 90°...
  • Page 39: Untouch Wait Time Flag (-W)

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility Untouch Wait Time Flag (-w) This flag specifies the Untouch Wait Time (also called Wait Time): -w<n> where <n> is the time (in milliseconds) required before the program recognizes an untouch (lifting of the finger). The default Wait Time will vary depending on the controller.
  • Page 40: Extract Flag (-X)

    ELODEV Specifying -p+ is useful only after ELODEV is installed. It uses the original ELODEV parameters to determine if and how the controller should be reprogrammed. Use the -i flag if ELODEV is not at the default software interrupt (65 hex). For example, ELODEV -p+ -i62 The -p+ flag will also re-display the controller firmware revision level and other information.
  • Page 41: Updating Flags

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility Updating Flags ELODEV may be re-run to modify the settings of a previously installed copy. For example: ELODEV -w90 Note that no controller information is specified. Only the -c, -s, -w, and -p flags can be changed using this method. To change the -i flag, extract and reinstall ELODEV as explained above.
  • Page 42: Elocalib

    ELOCALIB ELOCALIB ELOCALIB.EXE measures the touch coordinates of known points near the outside edges of the video image, and stores these calibration points for later use. If you elect to store these points in AUTOEXEC.BAT when so prompted, ELODEV uses them to automatically calibrate each time you reset the system. To run ELOCALIB, type the following (typically from the \TOUCH directory): ELOCALIB [Enter] You will see a menu listing the video modes supported by your video card, such...
  • Page 43: Calibrating In Multiple Video Modes (Elograph.cal)

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility Calibrating in Multiple Video Modes (ELOGRAPH.CAL) Most applications use only one video mode, and that is the mode you should calibrate in. If your application uses multiple video modes, the extremes of the display area may change with the mode switches.
  • Page 44: Update Autoexec Flag (-U)

    ELOCALIB Update AUTOEXEC Flag (-u) Use: ELOCALIB -u<+/->[,<FileName>] to update (-u+) or not update (-u-) the ELODEV command line in AUTOEXEC.BAT with the calibration points (-c flag, page 30). Another batch file containing the ELODEV command line may be specified with <FileName>. Quick Calibration Flag (-q) Use: ELOCALIB -q...
  • Page 45: Help Flag (-H)

    Chapter 4 - DOS Touchscreen Driver and Calibration Utility Help Flag (-h) Type: ELOCALIB -h to display quick reference information on all flags and the current version of ELOCALIB. Examples ELOCALIB Provides a menu of video modes to calibrate in (see Figure 4-1, page 35).
  • Page 46: Point Extrapolation

    ELOCALIB Point Extrapolation You may have noticed ELOCALIB does not acquire its calibration points in the corners of the video image. The points are taken a little in from the edges, then extrapolated to achieve an estimated value at the edges. This is because the image on many monitors is not very linear, and usually least linear in the corners, due to the pin cushion effect.
  • Page 47: Monitormouse For Dos

    MonitorMouse for DOS Introduction 41 Compatibility 42 Installation 44 Command Line Flags 46 Running the Tutorial Program 53 NTRODUCTION Included on the accompanying DOS and Windows Driver Disk is MonitorMouse ® for DOS, a touchscreen driver which emulates the Microsoft mouse driver under DOS.
  • Page 48: Who Should Use Monitormouse For Dos

    Chapter 5 - MonitorMouse for DOS Who Should Use MonitorMouse for DOS MonitorMouse for DOS is recommended when converting existing DOS mouse- driven applications to touch, and for applications that will support both a mouse and a touchscreen. Programmers: MonitorMouse for DOS is not necessarily recommended for new DOS applications, unless they must also support a mouse.
  • Page 49: Light Pen Emulation

    Compatibility desired area. Try choosing a mouse button emulation mode (-m flag) where the cursor can be slid before clicking (see page 47). Use in combination with the -j- flag (see page 50). The cursor may not track with your finger because of the application's mickey-to-pixel ratio and/or acceleration or ballistic algorithms.
  • Page 50: Installation

    Chapter 5 - MonitorMouse for DOS NSTALLATION MonitorMouse for DOS is installed by the INSTALL program described in Chapter 2. Choose Express Installation Windows Express , or Installation Selective Installation The rest of this section describes the details of the installation. Typically you can skip to Mouse Button Emulation Mode Flag (-m), page 47.
  • Page 51: Using Monitormouse Without A Mouse

    Installation If you will be connecting and disconnecting your mouse you can place MOUSE and NOMOUSE in your AUTOEXEC file. NOMOUSE will not load if it sees a mouse driver. A trick to prevent the warning message output by NOMOUSE is shown in the following example: MOUSE ;...
  • Page 52: Command Line Flags

    Chapter 5 - MonitorMouse for DOS If you require a cursor and one is not being displayed, see Using PATCHMSE.EXE below. Command Line Flags NOMOUSE.COM supports two command line flags. Flags consist of a hyphen and a letter, in upper or lower case: NOMOUSE {-x | -h} where: displays these flags...
  • Page 53: Command Line Flags

    Command Line Flags NOTE To find out the version of your mouse driver, install it and read its sign-on message. The company (e.g. Microsoft, Logitech) and version number are usually displayed. If PATCHMSE does not list your version, try to locate a copy of one supported. MOUSE.COM may be found in the \MOUSE, \DOS, or \WINDOWS directory.
  • Page 54: Cursor Flag (-C)

    Chapter 5 - MonitorMouse for DOS vary in the button actions they support (clicking, dragging, double-clicking). The modes are the same as in MonitorMouse for Windows and all other versions of MonitorMouse. You should choose the simplest mode that will work for your application.
  • Page 55: Beep Flag (-B)

    Command Line Flags Control Panel to turn off the cursor (see page 61). The default for the cursor flag is on (-c+). Beep Flag (-b) Normally MonitorMouse for DOS gives a "click" sound for each touch. The beep flag may be used to disable the beeps (-b-). Because the touchscreen does not have the tactile feedback of a mouse button, audible feedback helps to confirm your action.
  • Page 56: Mickey/Pixel Ratio Flag (-R)

    Chapter 5 - MonitorMouse for DOS Mickey/Pixel Ratio Flag (-r) This flag specifies the default "mickey-to-pixel ratio" for horizontal and vertical motion. A "mickey" is a unit of distance, typically 1/200 of an inch. Consequently, the mickey/pixel ratios specify how far the mouse must move for the cursor to move a given number of pixels.
  • Page 57: Spawn Flag (-S)

    Command Line Flags Spawn Flag (-s) Instructs MonitorMouse for DOS to remain active when an application spawns another program. This flag is required for some off-the-shelf software to run properly. Therefore, the default for the spawn flag is on (-s+). Technically speaking, if the application sets up a mouse interrupt routine, then spawns another program which expects to receive mouse interrupts, MonitorMouse for DOS must remain active after the spawn.
  • Page 58: Help Flag (-H)

    Chapter 5 - MonitorMouse for DOS MONMOUSE.COM may be interfering with its extraction. Generally you should extract TSR's in the reverse order from which they were loaded. Help Flag (-h) At anytime, type: MONMOUSE -h to display quick reference information on all flags and the current version of MonitorMouse for DOS.
  • Page 59: Running The Tutorial Program

    Running the Tutorial Program UNNING THE UTORIAL ROGRAM The DOS and Windows Driver Disk installation includes a tutorial program for practicing with the various mouse button emulation modes (see -m flag, page 47). It is also useful to verify the operation of the touchscreen and mouse hardware with MonitorMouse for DOS before trying your application.
  • Page 60: Monitormouse For Windows

    MonitorMouse for Windows Introduction 55 Compatibility 56 Installation 56 Using the Touchscreen Control Panel 59 Tips on Using the Touchscreen in Windows 62 Running DOS Programs from Windows 64 Other Driver Configurations 65 NTRODUCTION Included on the accompanying DOS and Windows Driver Disk is MonitorMouse ®...
  • Page 61: Compatibility

    Chapter 6 - MonitorMouse for Windows OMPATIBILITY MonitorMouse for Windows is compatible with all Windows 3.1 applications. Applications using only the left button will be the easiest to use with the touchscreen. Because MonitorMouse for Windows works with ELODEV, it is compatible with all Elo touchscreens and controllers.
  • Page 62: Dos Mouse Driver

    Installation These files are copied to your hard disk by the INSTALL program described in Chapter 2. ELOCALW.CPL and ELOCALW.HLP are included in English, French, Spanish, and German. DOS Mouse Driver A DOS mouse driver (MOUSE.COM, MOUSE.SYS or compatible) is required if you wish to use your mouse along with the touchscreen in Windows.
  • Page 63: Windows Setup (System.ini)

    Chapter 6 - MonitorMouse for Windows Windows Setup (SYSTEM.INI) The Elo INSTALL program modifies the Windows driver settings in SYSTEM.INI, so running the Microsoft Windows Setup utility is not required. Changes made by INSTALL to SYSTEM.INI are indicated by inserted comments. Typical changes are shown below: [boot] ;Start of line(s) placed by Elo TouchSystems...
  • Page 64: Using The Touchscreen Control Panel

    Using the Touchscreen Control Panel If your touchscreen controller is configured for IRQ3, the following lines are added to the [386Enh] section of SYSTEM.INI: COM2Base=0 COM2Irq= 1 If your touchscreen controller is configured for IRQ4, the following lines are added: COM1Base=0 COM1Irq= 1 SING THE...
  • Page 65: Mouse Button Emulation Mode

    Chapter 6 - MonitorMouse for Windows NOTE If the calibration is off when running DOS mouse-driven programs from Windows, you may need to use an ELOGRAPH.CAL file with MON- MOUSE.COM. ELOGRAPH.CAL is created by ELOCALIB and should contain calibration points for each video mode you use in your DOS programs. See Calibrating in Multiple Video Modes (ELOGRAPH.CAL), page 36, and the Calibration File Directory Flag (-d), page 49.
  • Page 66: Click Sound On Touches

    Using the Touchscreen Control Panel The cursor follows your sliding finger and the left button is clicked at the point of untouch (lift-off). Mode 5 Left button clicking and dragging. No right button is supported. The left button is held down when you touch the screen, and it stays down until you untouch, dragging as you move.
  • Page 67: Tips On Using The Touchscreen In Windows

    Chapter 6 - MonitorMouse for Windows IPS ON SING THE OUCHSCREEN IN INDOWS The following are suggestions for using the touchscreen in Windows. Mouse button emulation mode 6 is assumed. Double-Clicking Double-clicking is common in the Windows environment, so MonitorMouse mouse button emulation mode 6 is recommended.
  • Page 68: Scrolling

    Tips on Using the Touchscreen in Windows to the [windows] section of the WIN.INI file. Drop-down menus will be shifted left so they will not appear under your hand. Scrolling Scrolling lists can be performed by touching the scroll bars, as you would with the mouse.
  • Page 69: Elo Wallpaper

    Chapter 6 - MonitorMouse for Windows Elo Wallpaper ELO.BMP can be used to display Elo "wallpaper" when giving demos of MonitorMouse for Windows. To load, click on Control Panel, select Desktop, Wallpaper, and enter ELO.BMP. Select Tile. DOS P UNNING ROGRAMS FROM INDOWS DOS programs run from Windows may also use the touchscreen.
  • Page 70: Running Dos Polled Touchscreen Programs

    Other Driver Configurations If you load a second copy of ELODEV in the DOS session, ignore the Windows message about TSR's when EXITing the session in Standard Mode. Extracting ELODEV before EXITing will not eliminate this message, because Windows cannot detect TSR extractions. Calibrating ELODEV in one DOS session will not affect calibration in other sessions or Windows.
  • Page 71 Chapter 6 - MonitorMouse for Windows manually loaded in DOS sessions to use the touchscreen with ELODEV-based and DOS mouse-driven programs. The Touchscreen Control Panel cannot calibrate the touchscreen nor select the mouse button emulation mode.
  • Page 72: Introduction

    TouchBack Introduction 67 Compatibility 67 Installation 68 Options 69 NTRODUCTION Included on the accompanying DOS and Windows Driver Disk is TouchBack™, a touchscreen driver which emulates keystrokes for DOS keyboard-driven applications. OMPATIBILITY Applications must be specially written for use with TouchBack. Your application documentation should specify if TouchBack is required.
  • Page 73: Touchback

    Chapter 7 - TouchBack the TouchBack driver. The TouchUp manual describes the touch zone definition utility used when developing TouchBack-based programs. Sample source code is included in BASIC, dBase, Clipper, and many other languages. NSTALLATION TouchBack is installed by the INSTALL program described in Chapter 2. Choose DOS Express Installation Selective Installation The rest of this chapter describes the details of the installation.
  • Page 74: Options

    Options PTIONS TouchBack supports several environment variables and command line flags. Environment Variables TouchBack normally looks for application screen files (.PIC extension) and touch zone table files (.BIN extension) in the directory where the application is running. You can specify different directories with the following environment commands: SET PICPATH=<pathname>...
  • Page 75: Command Line Flags

    Chapter 7 - TouchBack Command Line Flags TouchBack command line flags enable you to change the command lead-in character, specify the number and size of buffers, remove TouchBack from memory, and display a list of available flags. Flags consist of a hyphen and a letter, in upper or lower case. For example: TCHBACK -c127 Multiple flags may be specified, separated by spaces.
  • Page 76: Interrupt Flag (-I)

    Options Interrupt Flag (-i) The -i flag allows you to specify the software interrupt of ELODEV: TCHBACK -i<n> where <n> is specified in hex. This flag is necessary if more than one copy of ELODEV is loaded, as when controlling two touchscreens. You will also need it if ELODEV is installed at a software interrupt other than 60 through 66 (hex).
  • Page 77: Configuring Your Controller

    $SSHQGL[$ Configuring Your Controller General Information 73 Controller Data Sheets 75 ENERAL NFORMATION This appendix explains how to configure your touchscreen controller's switch and/or jumper settings for use with the drivers on the DOS and Windows Driver Disk. Your controller's switch and jumper settings can be found on one of the next few pages.
  • Page 78: Increasing The Untouch Wait Time

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller Increasing the Untouch Wait Time If you use a baud rate lower than the one recommended for certain serial controllers, you may have to increase the Untouch Wait Time (-w flag) when loading ELODEV.
  • Page 79: Controller Data Sheets

    Controller Data Sheets NOTE When XT disk controllers are installed in AT type systems, IRQ5 is not available. For 286/386/486's or later, IRQ5 (LPT2) is highly recommended. Since the BIOS does not use interrupts when outputting to a printer and most software uses the BIOS for printer output, you can jumper your PC-Bus touchscreen controller for IRQ5 without contending with LPT2.
  • Page 80 Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller NOTE Switches may be labeled either OFF/ON or OPEN/CLOSE, depending on your controller. The data sheets tables always list switch positions as OFF (open) or ON (close).
  • Page 81: Intellitouch Serial Controller (E281-2300)

    Controller Data Sheets IntelliTouch Serial Controller (E281-2300) Verify the controller's jumper settings are as follows: Baud Rate (From Left) 9600 (recommended) J0-N J1-N 4800 J0-Y J1-Y 2400 J0-Y J1-N 1200 J0-N J1-Y 19200 Cross-connect (connect jumper horizontally so the top pins of J0 and J1 are jumpered) Binary Mode J2-N...
  • Page 82: Intellitouch Serial Controller (E281{A}-4002)

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller IntelliTouch Serial Controller (E281{A}-4002) Verify the controller's switch settings are as follows: For: Set: Stream Mode SW0-OFF Binary Mode SW1-OFF Z-axis enable SW2-ON 9600 Baud (recommended) SW3-ON, SW4-ON, SW5-ON 4800 Baud SW3-ON, SW4-ON, SW5-OFF 2400 Baud...
  • Page 83: Accutouch Serial Controller (E271-2210)

    Controller Data Sheets AccuTouch Serial Controller (E271-2210) The E271-2210 controller is a compact version of the E271-2200 controller. Verify the controller's jumper settings are as follows: Baud Rate (From Left) 9600 (recommended) J0-N J1-N 2400 J0-Y J1-N 1200 J0-N J1-Y J0-Y J1-Y 19200...
  • Page 84: Accutouch And Duratouch Serial Controller (E271-2200)

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller AccuTouch and DuraTouch Serial Controller (E271-2200) Verify the controller's jumper settings are as follows: (From Top) Default from jumpers J7-Y Reserved J6-N Touchscreen Type AccuTouch J5-Y DuraTouch J5-N Stream Mode J4-N Hardware handshaking enabled J3-N...
  • Page 85: Accutouch Serial Controller (E271-140)

    Controller Data Sheets AccuTouch Serial Controller (E271-140) Verify the controller's switch settings are as follows: For: Set: 9600 Baud SW1-OFF SW2-OFF 4800 Baud SW1-ON SW2-OFF 2400 Baud (recommended) SW1-OFF SW2-ON 300 Baud SW1-ON SW2-ON 8-bit Data SW3-OFF Binary Mode SW4-ON Filtered SW5-ON Stream Mode...
  • Page 86: Duratouch Serial Controller (E261-280)

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller DuraTouch Serial Controller (E261-280) Verify the controller's jumper settings are as follows: For: Jumper: Binary Mode E2 (requires 4.0 EPROM) 9600 Baud (recommended) 300 Baud 1200 Baud Neither If Elo has installed the controller inside your monitor, then E2 and E5 have already been jumpered.
  • Page 87: Intellitouch Pc-Bus Controller (E281-4035)

    Controller Data Sheets IntelliTouch PC-Bus Controller (E281-4035) The E281-4035 controller is a half-card version of the E281{A}-4025 controller. Verify the controller's switch settings are as follows: 12-bit Mode SW1-ON Reserved SW2-ON Stream Mode SW3-OFF Reserved SW4-ON Z-axis enable SW5-ON Reserved SW6-ON Next, set the controller's Base I/O Port address with the W2 and W3 jumpers.
  • Page 88 Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller Interrupt (IRQ) (from left) 5 (factory set) Remember the Base I/O Port address and IRQ values. You will need them when running the INSTALL program.
  • Page 89: Intellitouch Pc-Bus Controller (E281{A}-4025)

    Controller Data Sheets IntelliTouch PC-Bus Controller (E281{A}-4025) Verify the controller's switch settings are as follows: 12-bit Mode SW1-ON Reserved SW2-ON Stream Mode SW3-OFF Reserved SW4-ON Z-axis enable SW5-ON Reserved SW6-ON Reserved SW7-ON Reserved SW8-ON Next, set the controller's Base I/O Port address with the W2 and W3 jumpers. W3 selects the high order address, and W2 the low order address.
  • Page 90 Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller W1 Position Interrupt (IRQ) (from left) 5 (factory set) Remember the Base I/O Port address and IRQ values. You will need them when running the INSTALL program.
  • Page 91: Accutouch And Duratouch Pc-Bus Controller (E271-2201)

    Controller Data Sheets AccuTouch and DuraTouch PC-Bus Controller (E271-2201) Verify the controller's jumper settings are as follows: (From Top) Default from jumpers J7-Y Reserved J6-N Touchscreen Type AccuTouch J5-Y DuraTouch J5-N Stream Mode J4-N No Interrupt (software selected) J3-N J2-N Base I/O Port (in hex) 280 (recommended) J1-N...
  • Page 92: Accutouch Pc-Bus Controller (E271-141) And Duratouch Pc-Bus Controller (E271-142)

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller AccuTouch PC-Bus Controller (E271-141) and DuraTouch PC-Bus Controller (E271-142) Verify the controller's switch settings are as follows: For: Set: 12-bit Mode (recommended) SW1-ON 8-bit Mode SW1-OFF No calibration data on reset SW2-ON Stream Mode SW3-OFF...
  • Page 93: Touchscreen Type Jumpers (For Accutouch E271-141 Only)

    Controller Data Sheets Position Interrupt (IRQ) (from left) 5 (factory set) Remember the Base I/O Port address and IRQ values. You will need them when running the INSTALL program. Touchscreen Type Jumpers (for AccuTouch E271-141 Only) Verify the Touchscreen Type jumpers on the AccuTouch E271-141 Controller only.
  • Page 94: Accutouch And Duratouch Micro Channel Controller (E271-2202)

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Configuring Your Controller AccuTouch and DuraTouch Micro Channel Controller (E271-2202) Verify the controller's jumper settings are as follows: (From Top) Default from jumpers J7-Y Reserved J6-N Touchscreen Type AccuTouch J5-Y DuraTouch J5-N Stream Mode J4-N...
  • Page 95 Controller Data Sheets Note that the Base I/O Port and Interrupt (IRQ) are not specified because they were determined by the configuration programs on the Reference Disk, the ADF file, and other adapters present in your system. After the software is installed, you can run the INFO utility to display and verify the chosen Base I/O Port and Interrupt for the E271-2202 controller.
  • Page 96: Troubleshooting

    $SSHQGL[% Troubleshooting General Information 93 Diagnostic Utilities 103 ENERAL NFORMATION Should you experience operational difficulties with the touchscreen system either during or after installation, this appendix should help you determine the source of the problem. The first step in troubleshooting a touchscreen system is to determine whether the problem is due to the hardware, driver software, or application software.
  • Page 97: Peeling Back The Layers

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting display is powered off. Internal serial controllers are usually powered by a supply that is separate from the display's power supply, but controlled through the display's power switch. In this case, even if display problems exist, the touchscreen system will probably function if the display power switch is on.
  • Page 98: Where To Go From Here

    General Information Section Page Step 4 - Calibrating the Touchscreen Calibration Points Flag (-c) ELOCALIB Calibrating in Multiple Video Modes (ELOGRAPH.CAL) Calibration File Directory Flag (-d) Calibrating MonitorMouse for Windows Running DOS Mouse-Driven Programs (from Windows) Where to Go From Here The remainder of this appendix discusses troubleshooting the MonitorMouse for Windows, MonitorMouse for DOS, TouchBack, and ELODEV drivers, as well as the ELODEMO and ELOCALIB programs.
  • Page 99: Monitormouse For Windows

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting MonitorMouse for Windows The layers for MonitorMouse for Windows are as follows: Windows Enhanced Mode Driver (VMMD.386) Windows Standard Mode Driver (MONMOUSE.DRV) Windows MonitorMouse for DOS (MONMOUSE.COM) ELODEV.EXE Your mouse driver (MOUSE.COM/.SYS, etc.) Try these procedures: Run Windows Setup and verify that MonitorMouse for Windows is selected as your mouse driver.
  • Page 100 General Information The mouse IRQ is important in Windows Enhanced Mode even if you are using NOMOUSE.COM. See if NOMOUSE.COM is the same as the version on the DOS and Windows Driver Disk. If not, try that version. If NOMOUSE.COM was created with PATCHMSE from Microsoft MOUSE.COM version 7.04, the IRQ will be 2.
  • Page 101: Touchscreen Control Panel

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting Touchscreen Control Panel If the mouse button emulation mode is dimmed, MONMOUSE.COM is not loaded. See Chapter 5. If the Calibrate button is dimmed, ELODEV.EXE is not loaded. See Chapter 4.
  • Page 102: Monitormouse For Dos

    General Information MonitorMouse for DOS The layers for MonitorMouse for DOS applications are as follows: Your application MonitorMouse for DOS (MONMOUSE.COM) ELODEV.EXE Your mouse driver (MOUSE.COM/.SYS, etc.) Try these procedures: Reboot and check to see if MONMOUSE.COM is installing without an error message.
  • Page 103 Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting To determine the interrupt for bus touchscreen controllers, run the INFO utility (typically in \TOUCH). See page 108. To determine the interrupt for a non-serial mouse, check your mouse documentation. You may also use the DOS DEBUG utility as in the following example.
  • Page 104: Touchback

    General Information TouchBack The layers for TouchBack applications are as follows: Your application TouchBack (TCHBACK.EXE) ELODEV.EXE Try these procedures: Reboot and check to see if TCHBACK.EXE is installing without an error message. See page 121 for a description of each message or Chapter 7 for installation instructions.
  • Page 105: Elodev

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting ELODEV The layers for ELODEV applications are as follows: Your application ELODEV.EXE Hardware Try these procedures: Reboot and check to see if ELODEV.EXE is installing without an error message. See page 114 for a description of each message or Chapter 4 for installation instructions.
  • Page 106: Elodemo

    Diagnostic Utilities ELODEMO If ELODEMO does not work, or only works in some screens, press [Esc] to abort. Try recalibrating with DEMOCAL. If it still does not work, try the TOUCHES program (see page 111). If TOUCHES does not display any coordinates when the touchscreen is touched, use COMDUMP (page 106) or BUSSTAT (page 104) to determine if data is reaching the computer from the touchscreen controller.
  • Page 107: Busstat

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting BUSSTAT BUSSTAT.EXE allows you to test any Elo PC-Bus or Micro Channel controller (E281-4035, E281{A}-4025, E271-2201, E271-2202, E271-141, or E271-142) with or without ELODEV installed. The utility displays the controller's switch or jumper settings, then displays the touch coordinates as they are received.
  • Page 108 Diagnostic Utilities ELODEV did not match your jumper placement. Try selecting another interrupt and double-check your jumper placement. With the E271-2201 controller, you may simply change the interrupt specified on the ELODEV command line—it is not necessary to change jumpers (except when in E271-141 emulation mode).
  • Page 109: Comdump

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting COMDUMP COMDUMP.EXE allows you to test any Elo serial controller (E281-2300, E281{A}-4002, E271-2210, E271-2200, E271-140, or E261-280) with or without ELODEV installed. COMDUMP directly reads the system's serial ports and displays any received data.
  • Page 110 Diagnostic Utilities problem. See the IntelliTouch Product Manual or the AccuTouch Product Manual for hardware troubleshooting information. Contact Elo Technical Support if you believe you have a hardware problem.
  • Page 111: Info

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting INFO INFO.EXE allows you to confirm ELODEV settings. To run INFO, type the following at the DOS prompt: INFO [Enter] A sample output is shown below: Controller: 2210 Rev: 1.3-0.0 Diags: 00-00 ID: EloInc. Base Port: 03F8H Interrupt (IRQ):...
  • Page 112: Help Flag (-H)

    Diagnostic Utilities where <n> is the software interrupt of ELODEV in hex. This flag is necessary if more than one copy of ELODEV is loaded, as when controlling two touchscreens. You will also need it if ELODEV is installed at a software interrupt other than 60 through 66 (hex).
  • Page 113: Sawdump

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting SAWDUMP SAWDUMP.EXE displays the firmware revision level, results of power-on diagnostics, signal gain values, and can capture further signal information into a .SWV file for analysis by Elo Technical Support. SAWDUMP works only with IntelliTouch controllers with 2.2 firmware or later (E281-2300, E281A-4002, E281-4035, or E281A-4025).
  • Page 114: Touches

    Diagnostic Utilities TOUCHES TOUCHES.EXE allows you to confirm that ELODEV is communicating properly with the controller and to check touchscreen linearity. To run TOUCHES, type the following at the DOS prompt: TOUCHES [Enter] Touch the screen and the program will display the X and Y coordinates of your touch, the Z value if the controller determines one, and a single "TRUE"...
  • Page 115 Appendix Error! Main Document Only.Error! Main Document Only.7 - Troubleshooting...
  • Page 116: Error Messages

    $SSHQGL[& Error Messages ELODEMO Error Messages 113 ELODEV Error Messages 114 MonitorMouse for DOS Error Messages 118 TouchBack Error Conditions 121 ELODEMO E RROR ESSAGES If ELODEMO aborts with error codes 202 or 203 (not enough memory), remove any TSR programs you can and re-run ELODEMO. A system with at least 400K of available RAM is recommended.
  • Page 117: Elodev Error Messages

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Error Messages ELODEV E RROR ESSAGES This section lists the error messages that can be displayed by ELODEV upon installation, with a brief explanation where necessary. No error messages are ever output by an installed copy of ELODEV.
  • Page 118 ELODEV Error Messages Controller not responding. Controller is not responding to the software setup sequence. Check the cabling and the baud rate of the controller. Controller not responding correctly. Controller is responding, but not correctly, to the software setup sequence. Check the controller's baud rate.
  • Page 119 Appendix Error! Main Document Only.Error! Main Document Only.7 - Error Messages Invalid buffer size flag. The buffer size (-b flag) must be between 3 and 1000 (decimal) inclusive. Invalid calibration range. Six unsigned decimal values must be specified (-c flag). Invalid COM port.
  • Page 120 ELODEV Error Messages Invalid syntax. An argument on the command line was missing or not as expected. Usually a comma was expected. If you specified a COM port of 0, no baud rate should be specified. If using a Micro Channel controller, you should not specify a Base I/O Port or Interrupt (IRQ).
  • Page 121: Monitormouse For Dos Error Messages

    Appendix Error! Main Document Only.Error! Main Document Only.7 - Error Messages DOS E ONITOR OUSE FOR RROR ESSAGES This section lists the error messages that can be displayed by MONMOUSE.COM upon installation, along with a brief explanation where necessary. No error messages are ever output by an installed copy of MonitorMouse for DOS.
  • Page 122 MonitorMouse for DOS Error Messages ELODEV [Enter] ELOGRAPH.CAL not correct format. Either your ELOGRAPH.CAL file is damaged, or it was created with ELOCALIB from a version of ELODEV before ELODEV 1.3a. Erase the .CAL file, and recalibrate in the video modes you will be using with a current version of ELOCALIB.
  • Page 123 Appendix Error! Main Document Only.Error! Main Document Only.7 - Error Messages Invalid mickey/pixel ratio. The mickey-to-pixel ratios (-r flag) must be specified as two decimal numbers for X and Y, separated by a comma. Invalid mode. The mode (-m flag) must be between 0 and 6 inclusive. Invalid spawn flag.
  • Page 124: Touchback Error Conditions

    TouchBack Error Conditions OUCH RROR ONDITIONS TouchBack may output an error message as it is loaded. Once loaded, run-time error conditions are indicated with beep codes rather than error messages. Error messages and beep codes are listed in the following sections. Error Messages TouchBack may display any of the following error messages as it is loaded.
  • Page 125 Appendix Error! Main Document Only.Error! Main Document Only.7 - Error Messages ELODEV not version x.x or later. (2) Copy the latest version from your distribution disk into the correct directory. Check AUTOEXEC.BAT or the batch file that loads ELODEV to see where it looks for ELODEV. To find out the version, type: ELODEV [Enter] Insufficient memory.
  • Page 126: Beep Codes

    TouchBack Error Conditions TouchBack already installed. (4) Reminds you that TouchBack was already loaded when you gave the command. All TouchBack flags except -b may be used after TouchBack is loaded. TouchBack cannot be extracted. (7) Another program or TSR loaded after TouchBack has changed interrupt vectors affecting TouchBack.
  • Page 127 Appendix Error! Main Document Only.Error! Main Document Only.7 - Error Messages TUFLAGS=480 to your DOS environment with the SET command. 3. Cannot find BIN file. Check the path and the SET BINPATH in your environment. See page 4. Cannot load BIN file. One of the following conditions occurred: A disk error occurred while reading the file.
  • Page 128: Monitormouse For Dos Programming Information

    $SSHQGL[' MonitorMouse for DOS Programming Information Introduction 125 Subfunction 0 - Get Mode and Options 126 Subfunction 1 - Set Mode and Options 126 Subfunction 2 - Wait for Untouch 127 NTRODUCTION MonitorMouse for DOS supports a special mouse function number (65 hex) with three subfunctions: Get MonitorMouse for DOS mode and options.
  • Page 129: Subfunction 0 - Get Mode And Options

    Appendix Error! Main Document Only.Error! Main Document Only.7 - MonitorMouse for DOS Programming Information 0 - G UBFUNCTION ODE AND PTIONS Subfunction 0 is used to get the current mode, flags, and version number of MonitorMouse for DOS. In the style of Microsoft mouse programmer's documentation: INPUT OUTPUT...
  • Page 130: Subfunction 2 - Wait For Untouch

    Subfunction 2 - Wait for Untouch 100 M1%=&H65 ' MonitorMouse special function 200 M2%=1 ' subfunction 1 300 M3%=&H302 ' set -c+, -b+, -s-, -t-, -m2 400 CALL MOUSE(M1%, M2%, M3%, M4%) 500 IF M2%<>M1% THEN PRINT "MonitorMouse not installed." Here's the same code in C: regs.x.ax = 0x65;...
  • Page 131: Monitormouse For Windows Programming Information

    $SSHQGL[( MonitorMouse for Windows Programming Information Z-Axis Capability 129 Launching the Touchscreen Control Panel 130 Calibrating from Within Your Program 130 Touch Icons 131 APABILITY Windows 3.1 programmers can take advantage of IntelliTouch Z axis capabilities. For a demo, select File/Run from Program Manager and enter ZAXIS.EXE (typically found in the \TOUCH directory).
  • Page 132: Calibrating From Within Your Program

    Appendix Error! Main Document Only.Error! Main Document Only.7 - MonitorMouse for Windows Programming Information Be aware that the string returned after "mouse.drv=" may be in upper or lower case. Then, use the GetMessageExtraInfo() function to receive additional information about your input device (mouse, tablet, touchscreen, etc.). MonitorMouse for Windows returns a 32-bit field containing additional information on touch and mouse events, as well as controller capabilities.
  • Page 133: Touch Icons

    Touch Icons WORD Timeout; HWND hWnd; // window handle FARPROC lpfnCalibrateScreen; // pointer to Calibrate function HANDLE hLibrary; // ELOCALW.CPL library handle // Load the Control Panel applet hLibrary = LoadLibrary("ELOCALW.CPL"); if (hLibrary < (HANDLE)32) { MessageBox(NULL, "Could not load Calibration Library.", "NoLoad", MB_OK); break;...
  • Page 134 ,QGH[...

This manual is also suitable for:

Dos and windows driver disk

Table of Contents