Elo TouchSystems software, DOS and Windows Driver Disk Driver Manual
DOS and Windows
Driver Guide
Version 2.0
®
DOS and Windows
Driver Guide
Version 2.0
Manual Version 2.0b
Copyright © 1987-1994, 1994-1995
by
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
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 hold ers.
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. Printed in USA. H54798.
Software License Agreement
BY OPENING THE ACCOMPANYING DISKETTE ENVELOPE, YOU ARE AGREEING TO BECOME BOUND BY
THE TERMS OF THIS AGREEMENT, INCLUDING THIS SOFTWARE LICENSE AND LIMITED WARRANTY.
Software License
This software is protected by both the United States copyright law and international treaty provisions. Therefore, except as
noted below, you should treat the software just like any other copyrighted material. Elo TouchSystems, Inc. (Elo)
authorizes you to make archival copies of the sof tware for the purp oses of b acking-up your software and protecting your
investment from loss, and to make additional copies for use within a single company or facility.
THIS SOFTWARE IS LICENSED FOR USE ONLY WITH ELO TOUCHSCREENS.
The enclosed software program object code (drivers, utilities, diagnostics, and/or demon stration programs) may be freely
duplicated or distributed without charge, but may not be resold. You may not decompile, reverse assemble, reverse
engineer, or patch any software program object codes.
Any supplied software program source code is proprietary and may not be disclosed to third parties. Such source code may
be modified and/or partially or completely incorporated into your own applications, together with any supplied object
code, and the resulting programs may be used, given away or sold without additional licenses or fees.
You may not reproduce, distribute, or revise the program documentation without expressed written consent from Elo.
This software and accompanying written materials may contain reference to, or information about, Elo products
(equipment or programs), that are not now available. Such references or information must not be construed to mean that
Elo intends to provide such products, programming, or services.
Limited Warranty
THIS SOFTWARE AND ACCOMPANYING WRITTEN MATERIALS ARE PROVIDED "AS IS" WITHOUT
WARRANTY OF ANY KIND. FURTHER, ELO DOES NOT GUARANTEE, OR MAKE ANY REPRESEN-TATIONS
REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR ACCOMPANYING WRITTEN
MATERIALS IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY OR CURRENTNESS. IF THE
INCLUDED SOFTWARE OR ACCOMPANYING WRITTEN MATERIALS ARE DEFECTIVE, YOU, AND NOT ELO
OR ITS DEALERS, DISTRIBUTORS, AGENTS, OR EMPLOYEES, ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR, OR CORRECTION. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF
THE SOFTWARE AND ANY FURTHER PROGRAMS OR WRITTEN MATERIALS DEVELOPED UTILIZING
THESE MATERIALS IS ASSUMED BY YOU.
Elo warrants only that the diskette is free from defects in material and workmanship under normal use and service for a
period of sixty (60) days after receipt.
Elo's entire liability and your exclusive remedy as to the diskette shall be, at Elo's option, either return of the purchase
price or replacement of the diskette.
EXCEPT AS PROVIDED ABOVE, ELO DISCLAIMS ALL WARRANTIES, EITHER EXPRESSED OR IMPLIED,
INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE, WITH RESPECT TO THE SOFTWARE, WRITTEN MATERIALS OR DISKETTE. IN NO
EVENT SHALL ELO BE LIABLE FOR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND.
This Agreement shall be governed by and construed in accordance with the laws of the State of Tennessee.
Governing Law
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...................................................................................... 7
Product Registration............................................................................................. 7
Contacting Elo......................................................................................................7
Installation.................................................................................................9
Step 1 - Configuring the Touchscreen Controller................................................. 9
Step 2 - Installing the Controller......................................................................... 10
Step 3 - Running the INSTALL Program............................................................ 10
Command Line Flags .............................................................................. 11
Updating Existing Drivers ........................................................................ 11
Step 4 - Calibrating the Touchscreen................................................................. 12
Why Calibration is Necessary.................................................................. 12
When Recalibration is Necessary............................................................ 13
Where to Go from Here......................................................................................13
Changing Your Hardware Configuration With SETUP ....................................... 14
Uninstalling the Software.................................................................................... 14
Demonstration Program .......................................................................... 14
Previous Versions of MonitorMouse for DOS.......................................... 14
MonitorMouse for Windows..................................................................... 14
All Elo Software....................................................................................... 15
DOS Demonstration Program ................................................................17
Introduction ........................................................................................................ 17
Installation.......................................................................................................... 18
Included Files .......................................................................................... 18
Running ELODEMO...........................................................................................18
Command Line Flags .............................................................................. 18
Demo Descriptions.................................................................................. 20
Main Menu.................................................................................... 20
Process Control ............................................................................ 20
Busy Box....................................................................................... 20
Map Quiz....................................................................................... 20
Stereo Unit.................................................................................... 21
Finger Painting.............................................................................. 21
Touch Keyboard ........................................................................... 21
Teller Machine .............................................................................. 21
Touch Piano.................................................................................. 22
Touch Maze.................................................................................. 22
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....................................................................................................... 26
Installation.......................................................................................................... 26
ELODEV............................................................................................................. 27
Placement in AUTOEXEC.BAT............................................................... 27
ELODEV Command Line......................................................................... 27
ELODEV Command Syntax..................................................................... 27
Serial Controllers .......................................................................... 28
PC-Bus Controllers....................................................................... 28
Micro Channel Controllers ............................................................ 29
Command Line Flags.................................................................... 29
Calibration Points Flag (-c) ................................................. 30
X,Y Axes Swapping Flag (-s).............................................. 31
Software Interrupt Flag (-i) ................................................. 31
Untouch Wait Time Flag (-w) ............................................. 32
Program the Controller Flag (-p) ........................................ 32
Extract Flag (-x).................................................................. 33
Help Flag (-h)..................................................................... 33
Updating Flags................................................................... 34
Using Multiple Co-Resident Copies of ELODEV ..................................... 34
ELOCALIB.......................................................................................................... 35
Calibrating in Multiple Video Modes (ELOGRAPH.CAL)......................... 36
Command Line Flags .............................................................................. 36
Video Mode(s) Flag (-m)...............................................................36
Save Points in File Flag (-s).......................................................... 36
Update AUTOEXEC Flag (-u)....................................................... 37
Quick Calibration Flag (-q)............................................................ 37
Set Calibration From File Flag (-c)................................................ 37
Language Flag (-L) ....................................................................... 37
Help Flag (-h)................................................................................38
Examples...................................................................................... 38
Calibration Point Ordering ....................................................................... 38
Point Extrapolation .................................................................................. 39
Third Point............................................................................................... 39
MonitorMouse for DOS...........................................................................41
Introduction ........................................................................................................ 41
Who Should Use MonitorMouse for DOS................................................42
Compatibility....................................................................................................... 42
Coordinates vs. Mickeys.......................................................................... 42
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)................................................ 47
Cursor Flag (-c)........................................................................................ 48
Beep Flag (-b).......................................................................................... 49
Calibration File Directory Flag (-d)........................................................... 49
Mickey/Pixel Ratio Flag (-r)...................................................................... 50
Jump Flag (-j) .......................................................................................... 50
Spawn Flag (-s)....................................................................................... 51
Terminate Flag (-t)................................................................................... 51
Interrupt Flag (-i)...................................................................................... 51
Extract Flag (-x)....................................................................................... 51
Help Flag (-h)........................................................................................... 52
Flag Defaults ........................................................................................... 52
Updating Flags ........................................................................................ 52
Running the Tutorial Program............................................................................ 53
Command Line Flags .............................................................................. 53
MonitorMouse for Windows...................................................................55
Introduction ........................................................................................................ 55
Compatibility....................................................................................................... 56
Installation.......................................................................................................... 56
Included Files .......................................................................................... 56
DOS Mouse Driver................................................................................... 57
Hardware Mouse Cursor............................................................... 57
MonitorMouse for DOS............................................................................57
Windows Setup (SYSTEM.INI)................................................................ 58
Serial Mouse.................................................................................58
Bus Controller on COM Port Interrupt........................................... 58
Using the Touchscreen Control Panel................................................................ 59
Calibrating MonitorMouse for Windows...................................................59
Mouse Button Emulation Mode ............................................................... 60
Click Sound on Touches.......................................................................... 61
No Cursor................................................................................................ 61
Tips on Using the Touchscreen in Windows...................................................... 62
Double-Clicking........................................................................................ 62
Border Width ........................................................................................... 62
Menus...................................................................................................... 62
Scrolling................................................................................................... 63
Maximizing Windows............................................................................... 63
Using the Overscan Area......................................................................... 63
Option Buttons and Check Boxes............................................................ 63
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 ........................................................................................................ 67
Compatibility....................................................................................................... 67
Installation.......................................................................................................... 68
Included Files .......................................................................................... 68
Placement in AUTOEXEC.BAT............................................................... 68
Options............................................................................................................... 69
Environment Variables ............................................................................ 69
Command Line Flags .............................................................................. 70
Command Lead-in Character Flag (-c)......................................... 70
Number and Size of Buffers Flag (-b)........................................... 70
Interrupt Flag (-i)........................................................................... 71
Extract Flag (-x) ............................................................................ 71
Help Flag (-h)................................................................................71
Updating Flags.............................................................................. 71
Configuring Your Controller...................................................................73
General Information ........................................................................................... 73
Emulation Modes..................................................................................... 73
Increasing the Untouch Wait Time .......................................................... 74
Non-standard Serial Ports....................................................................... 74
Choosing an Interrupt (IRQ) for PC-Bus Controllers................................74
Controller Data Sheets.......................................................................................75
IntelliTouch Serial Controller (E281-2300)............................................... 77
IntelliTouch Serial Controller (E281{A}-4002).......................................... 78
AccuTouch Serial Controller (E271-2210)............................................... 79
AccuTouch and DuraTouch Serial Controller (E271-2200)..................... 80
AccuTouch Serial Controller (E271-140)................................................. 81
DuraTouch Serial Controller (E261-280)................................................. 82
IntelliTouch PC-Bus Controller (E281-4035) ........................................... 83
IntelliTouch PC-Bus Controller (E281{A}-4025)....................................... 85
AccuTouch and DuraTouch PC-Bus Controller (E271-2201).................. 87
AccuTouch PC-Bus Controller (E271-141) and DuraTouch PC-Bus
Controller (E271-142).............................................................................. 88
Touchscreen Type Jumpers (for AccuTouch E271-141 Only)...... 89
AccuTouch and DuraTouch Micro Channel Controller (E271-2202)....... 90
Controller Installation.................................................................... 90
Troubleshooting...................................................................................... 93
General Information ........................................................................................... 93
Display Problems..................................................................................... 93
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............................................................................................ 103
BUSSTAT.............................................................................................. 104
COMDUMP............................................................................................ 106
INFO...................................................................................................... 108
Interrupt Flag (-i)......................................................................... 108
Help Flag (-h)..............................................................................109
SAWDUMP............................................................................................ 110
TOUCHES............................................................................................. 111
Error Messages.....................................................................................113
ELODEMO Error Messages............................................................................. 113
ELODEV Error Messages ................................................................................ 114
MonitorMouse for DOS Error Messages .......................................................... 118
TouchBack Error Conditions ............................................................................ 121
Error Messages ..................................................................................... 121
Beep Codes........................................................................................... 123
MonitorMouse for DOS Programming Information ............................125
Introduction ...................................................................................................... 125
Subfunction 0 - Get Mode and Options............................................................126
Subfunction 1 - Set Mode and Options ............................................................ 126
Subfunction 2 - Wa it for Untouch..................................................................... 127
MonitorMouse for Window s Programming Information ....................129
Z-Axis Capability .............................................................................................. 129
Launching the Touchscreen Control Panel...................................................... 130
Calibrating from Within Your Program.............................................................. 130
Touch Icons...................................................................................................... 131
Index ................................................................................................................ 133
BOUT THIS MANUAL
A
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:
About this Manual
•
About Elo Software
•
Product Registration
•
Contacting Elo
•
Introduction
1
2
7
7
Chapter 1 Describes the included software and hardware requirements.
Chapter 2 Gives instructions on how to install the software.
Chapter 3 Describes the touchscreen demonstration program.
Chapter 4 Describes the installation and use of ELODEV™ and ELOCALIB,
Chapter 5 Details the use of MonitorMouse® for DOS, a mouse emulation
the touchscreen driver and calibration program for DOS.
driver.
1
2 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.
Appendix D Contains information for programmers on MonitorMouse for DOS.
Appendix E Contains information for programmers on MonitorMouse for
Windows.
See the !READ.ME! file on the accompanying DOS and Windows Driver Disk for
any additions or changes made after this manual was printed.
For details on available product configurations, touchscreen theory of operation,
and general troubleshooting, see the IntelliTouch® Product Manual or the
AccuTouch® Product Manual as appropriate.
BOUT ELO SOFTWARE
A
Included Software
The accompanying DOS and Windows Driver Disk contains the following Elo
driver software:
ELODEV Touchscreen driver program for DOS.
MonitorMouse for DOS Mouse emulation driver for DOS. Combines
Makes all Elo touchscreen controllers,
including serial RS-232, PC-Bus, and Micro
Channel versions, look the same to other
driver and application programs.
touch input from ELODEV and mouse input
from your mouse driver into a single
MOUSE.COM compatible application
interface.
MonitorMouse for Windows Mouse emulation driver for Microsoft
Windows. Allows all Windows programs to
be used with a touchscreen. Your mouse
About Elo Software 3
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.
The DOS and Windows Driver Disk also contains the following software:
ELODEMO A VGA-graphics program for DOS which
demonstrates the capabilities of the
touchscreen hardware and many techniques
for touchscreen software.
Utility and Diagnostic Programs An assortment of programs are included to
calibrate the touchscreen and verify the
operation of serial ports, touchscreen
controllers, and driver programs.
Other Software Available from Elo
MonitorMouse for DOS and MonitorMouse for Windows are only two in a family
of MonitorMouse products for various operating systems available separately
from Elo. Each has a similar "look and feel" for a consistent user interface across
platforms:
MonitorMouse for OS/2 Mouse emulation driver for OS/2 2.x and
MonitorMouse for Windows NT Mouse emulation driver for Windows NT.
MonitorMouse for Macintosh Mouse emulation driver for the Apple
1.3. DOS and Windows programs run under
OS/2 may also use the touchscreen.
DOS and Windows 3.1 programs run under
Windows NT may also use the touchscreen.
Macintosh family of computers.
4 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 the application programming
TouchBack
Programmer's Reference Defines the application programming
TouchUp™
User's Guide Includes the touch zone definition utility for
interface for the ELODEV touchscreen
driver. Includes sample source code in C,
Pascal, and assembly. (70 pages).
interface for the TouchBack keystroke
emulation driver. Includes sample source
code in BASIC, dBase, Clipper, etc. (50
pages).
ELODEV and TouchBack, screen capture
program, and example programs in C and
Pascal. (85 pages).
Writing Your Own Driver
If you are using an operating system not supported by the Elo drivers described
above, contact Elo Technical Support for information on the availability of other
drivers. Technical manuals are also available on the touchscreen controllers with
machine-independent example code for writing your own drivers.
Touchscreens and Controllers Supported
Elo produces two touchscreen technologies: resistive and surface wave (SW). The
AccuTouch® resistive touchscreen consists of a glass panel molded to the precise
shape of a display's face. The glass is coated with a transparent, conductive layer
and then covered by a clear, hard-coated sheet of plastic. This cover sheet is
suspended over the glass by less than one-thousandth of an inch with tiny
separator dots. With a light touch, the conductive inner surface of the plastic sheet
makes contact with the underlying glass. The resulting voltage is digitized for
each axis and a coordinate determined.
The IntelliTouch® surface wave touchscreen consists of a clear glass overlay with
piezoelectric transducers and a set of reflector stripes. Surface waves are
transmitted by the transducers, reflected across the face of the overlay, and
reconverted into an electronic signal. A finger or gloved hand touching the
About Elo Software 5
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. There are several types of controllers.
Serial controllers use a standard RS-232 port and are baud rate selectable. They
can be mounted anywhere; for example, externally (in separate enclosures) or
inside display enclosures.
Bus controllers plug directly into a card slot within an IBM PC, PS/2, or
compatible computer, so external packaging and power is not required. Bus
controllers are address and interrupt (IRQ) selectable and are available for PC-Bus
(ISA/EISA) and Micro Channel architectures.
The software on the Elo DOS and Windows Driver Disk supports the Elo
touchscreen controllers listed below. E281{A}-4002 refers to both the E281-4002
and E281A-4002 controllers. Likewise, E281{A}-4025 refers to both the E2814025 and E281A-4025 controllers.
Controller Enclosure Touchscreen
Model Model Interface Type
E281-2300 N/A RS-232 IntelliTouch
E281{A}-4002 E281{A}-2852 RS-232 IntelliTouch
E271-2210 E271-RS232BX RS-232 AccuTouch
E271-2200 N/A RS-232
E271-140 E271-3{R} RS-232 AccuTouch
E261-280 N/A RS-232 DuraTouch
E281-4035 N/A PC-Bus IntelliTouch
E281{A}-4025 N/A PC-Bus IntelliTouch
E271-2201 N/A PC-Bus AccuTouch & DuraTouch
E271-141 N/A PC-Bus AccuTouch
E271-142 N/A PC-Bus DuraTouch
E271-2202 N/A Micro Channel AccuTouch & DuraTouch
AccuTouch & DuraTouch
1
®
The following obsolete part numbers can be cross-referenced to the controller
model numbers referred to above.
1
DuraTouch touchscreens are no longer manufactured by Elo.
6 Chapter 1 - Introduction
Part Number Controller Model
00285X-XXX Enclosure Con tains E281-4002 IntelliTouch Serial
E271-3 Enclosure Contains E271-140 AccuTouch Serial
002710-XXX Controller E271-140 AccuTouch Serial Controller.
002714-XXX Controller E271-141 AccuTouch PC-Bus Controller.
002750-XXX Controller E261-280 DuraTouch Serial Controller.
002751-XXX Controller E271-142 DuraTouch PC-Bus Controller.
00285X-2-XXX Controller E281-4002 IntelliTouch Serial Controller.
Controller, configured for Stream Mode,
Binary Mode, Z-Axis Enabled, 9600 Baud.
Controller, configured for 2400 Baud, 8-Bit
Data, Binary Mode, Filtered Mode, Stream
Mode.
00285X-25-XXX Controller E281-4025 IntelliTouch PC-Bus Controller.
E271-280 Controller E261-280 DuraTouch Serial Controller.
E271-141 Controller with
Daughter Board
System Requirements
The DOS drivers will run on any system with DOS version 2.0 or later. The
Windows drivers will run on any system with Windows 3.1 or later. The DOS
demonstration program requires a VGA color display. The touchscreen calibration
program for DOS supports standard and VESA-compatible display modes.
Otherwise, all software is video independent. An Elo touchscreen must be
installed on the display and connected to a serial or bus controller.
Differences from Previous Versions
The ELODEV and MonitorMouse for DOS/Windows disks and manuals have
•
been combined into this single manual and disk. A new installation program is
included. The installation program and Touchscreen Control Panel for
Windows are included in English, German, French, and Spanish.
E271-142 DuraTouch PC-Bus Controller.
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.
Many other minor improvements have been made to the various drivers and
•
utility programs. For information on differences between all prior versions,
see the DIFFER.* files, an option selectable when installing the DOS and
Windows Driver Disk. All drivers are backwards compatible with previous
versions.
Distribution Rights
ELODEV, MonitorMouse for DOS, MonitorMouse for Windows, TouchBack,
and their support software may be distributed freely in executable form with any
software you develop using them. See the license agreement at the beginning of
this manual for details.
Product Registration 7
RODUCT REGISTRATION
P
To stay informed on the latest product announcements and software releases, be
sure to fill out and return the product registration card packaged with this manual.
ONTACTING ELO
C
Elo TouchSystems, Inc.
105 Randolph Road
Oak Ridge, TN 37830
VOICE: (615) 482-4100 (Eastern Time)
FAX: (615) 482-4943
Technical Support Line
VOICE: (615) 220-4299 (Voice mail after hours)
FAX: (615) 482-6617
INTERNET: ELOTECH@raychem.com
BBS: (615) 482-9840
(Downloads only, up to 14.4K baud, multiple protocols)
CompuServe: GO ELOTOUCH
Select Elo TouchSystems from the Messages and Library menus.
8 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.
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. Four steps are required:
Step 1 Configuring the touchscreen controller.
Step 2 Installing the controller.
Step 3 Running the INSTALL program.
Step 4 Calibrating the touchscreen.
TEP
S
1 - C
ONFIGURING THE TOUCHSCREEN CONTROLLER
Elo ships most touchscreen controllers preconfigured for use with Elo software.
9
10 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.
Switch and jumper settings, as well as other configuration information, are given
in Appendix A.
S
S
TEP
TEP
2 - I
3 - R
NSTALLING THE CONTROLLER
If you need help installing the controller or making the connections, see the
AccuTouch Product Manual or the IntelliTouch Product Manual as appropriate
for step-by-step instructions.
UNNING THE
The DOS and Windows Driver Disk contains an installation program which
automatically transfers all necessary files to your hard disk.
If you will be installing the Windows drivers, be sure Windows is installed and
operating properly before proceeding. You must have a DOS mouse driver
(MOUSE.COM) installed for your mouse if you wish to continue using your
mouse along with the touchscreen in DOS or Windows.
If you only wish to change the configuration of your touchscreen controller, see
Changing Your Hardware Configuration with SETUP, page 14, for information
on the SETUP utility.
INSTALL P
ROGRAM
To install the software, insert the DOS and Windows Driver Disk and type:
A:INSTALL [Enter]
or
B:INSTALL [Enter]
Respond to the on-screen prompts and instructions. You will be asked to specify
the model and configuration of your controller, then select
Installation
Installation
displayed for each installation option. You may specify the drive and directory for
the files you choose to install, or use the default (C:\TOUCH).
between
Windows Express Installation
,
. The software to be installed and disk space requirements will be
DOS Express
, or
Selective
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>
Use -Lg or -Ld for German, -Ls for Spanish, -Lf for French, or -Le for English.
To override the path to C:\AUTOEXEC.BAT, use the -a flag as follows:
INSTALL -a<filename with path>
Step 3 - Running the INSTALL Program 11
To skip the VGA graphics sign-on screen, enter:
INSTALL :
More than one flag may be specified, separated by spaces. Flags may be in upper
or lower case.
Updating Existing Drivers
If you are updating a previous version of the drivers, be sure to install and read the
DIFFER.* files. These files explain the differences from all previous versions.
The file extension corresponds to the version for which changes are listed. For
example, ELODIFF.16 lists the changes made from ELODEV version 1.5b to
version 1.6.
It is best to erase or overwrite any files from previous releases. All files are
generally compatible, but mixing files from different versions may cause
problems. If you are updating to a hard disk, specify the paths containing the
earlier version and the INSTALL program will overwrite the obsolete files.
All files are now installed into a single directory (default is \TOUCH). You will
probably want to delete the old version of MonitorMouse for DOS which was
previously installed in a separate directory (typically \MONMOUSE). INSTALL
does not delete this directory.
NOTE
12 Chapter 2 - Installation
S
TEP
4 - C
ALIBRATING THE TOUCHSCREEN
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.
Using your finger as accurately as possible, touch each of the three points as they
appear in the corners of the screen. The program responds with a beep as you lift
your finger from each point.
Calibration is performed in four common video modes: 80x25 text mode, CGA
320x200 graphics, VGA 320x200 graphics, and VGA 640x480. If your DOS
application runs in another video mode, see Chapter 4 for additional information
on ELOCALIB. If you are running Windows in another video mode such as super
VGA, see Chapter 6 for information on calibrating the touchscreen in Windows
with the Touchscreen Control Panel.
The numerical values for the calibration points for the last video mode are
displayed. X or Y axis inversion is normal.
If the calibration program does not respond to a touch, check the cabling, the
switch and/or jumper settings on the controller, and the configuration you selected
when installing the software. Run SETUP to change the configuration (see page
14). See Appendix B, page 93 for additional troubleshooting information.
Why Calibration is Necessary
The need for calibration is unique to the touchscreen. Unlike mouse or keyboard
applications where the cursor is part of the image, a touchscreen is a physical
overlay with an independent coordinate system. Only by knowing the position of
the image can the PC software convert touchscreen coordinates into image
coordinates.
Besides the differences among touchscreens and controllers, calibration also
compensates for the variation in video image among displays. The image is
affected by horizontal and vertical adjustments on the monitor and by the physical
mounting of the touchscreen.
Additional calibration complications include image blooming, where bright
colored images expand, and the "pin cushion" effect, which causes the corners of
the display to be stretched. Poor display linearity can cause similarly sized boxes
to be larger at the edges of the screen than they are in the m iddle, or vice versa.
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.
Even the most sophisticated calibration techniques can only partially overcome
such variations. Therefore, most touchscreen software uses only a two or threepoint calibration sequence and relies instead on well placed touch zones and
appropriate user feedback.
The three-point calibration sequence used by Elo automatically corrects inverted
touchscreen installations and backwards cable connections. X or Y-axis inversion
is normal for most touchscreens.
When Recalibration is Necessary
Where to Go from Here 13
Once calibrated, the touchscreen will be ready to run automatically each time the
system is restarted. Recalibration should only be necessary after moving or
resizing the video image, or after changing either the touchscreen, controller, or
monitor.
Type "DEMOCAL" or click on Calibrate in the Windows Touchscreen Control
Panel to re-run the calibration sequence.
HERE TO GO FROM HERE
W
If you chose:
DOS Express Installation
Windows Express Installation
Proceed to Chapter 3 for information on
running the demonstration program.
Then see Chapter 5 if you will be using
the MonitorMouse for DOS mouse
emulator or Chapter 7 for the
TouchBack driver.
Skip to Chapter 6 for information on
MonitorMouse for Windows, the
Windows mouse emulator.
Selective Installation
If you will doing software development under DOS, see the DOS Programmer's
Toolkit, available separately from Elo.
See Chapters 3-7 as appropriate.
14 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.
HANGING YOUR HARDWARE CONFIGURATION WITH
C
If you reconfigure your hardware settings, run the SETUP program from your hard
disk to reconfigure the drivers. SETUP is typically found in the \TOUCH
directory. Be careful not to confuse this program with the Windows Setup
program. To run SETUP, type:
SETUP [Enter]
SETUP
The procedure is very similar to the INSTALL program, except no software is
installed and the DOS and Windows Driver Disk is not required.
Flags may be specified for SETUP as with INSTALL. See page 11.
NINSTALLING THE SOFTWARE
U
Demonstration Program
You may wish to delete the demonstration program from your hard disk after you
have run it. This will free approximately 1.7 Mbytes of disk space. Delete
ELODEMO.EXE, *.PIC, *.IMG, and *.BGI, typically found in the \TOUCH
directory.
Previous Versions of MonitorMouse for DOS
If you have a previous version of MonitorMouse for DOS already installed
(version 1.4x or earlier), you should delete it as it was previously installed in a
separate directory (typically \MONMOUSE).
MonitorMouse for Windows
Delete CURSOFF.EXE and ELO.BMP from the \WINDOWS directory. Delete
MONMOUSE.DRV, VMMD.386, ELOCALW.*, and OEMELO.INF from
\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. Remove any lines for
ELODEV, MONMOUSE, NOMOUSE, and TCHBACK from AUTOEXEC.BAT
as necessary.
Uninstalling the Software 15
DOS Demonstration Program
NTRODUCTION
I
Included on the accompanying DOS and Wi ndows 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.
Introduction
•
Installation
•
Running ELODEMO
•
How ELODEMO Was Created
•
67
18
18
24
Programmers: ELODEMO also demonstrates various user interface
programming techniques. If you will be doing software development under DOS,
see the DOS Programmer's Toolkit, available separately from Elo for technical
details.
17
18 Chapter 3 - DOS Demonstration Program
NSTALLATION
I
ELODEMO is installed with the INSTALL program on the DOS and Windows
Driver Disk by choosing
Installation
choose
ELODEMO with
ELODEMO requires a 286 computer or better with VGA graphics, approximately
400K of available RAM, and 1.7 Mbytes of hard disk space.
Windows Express Installation
. To conserve disk space, ELODEMO is not installed if you
Selective Installation
DOS Express Installation
Included Files
The following files are typically installed in the \TOUCH directory:
ELODEMO.EXE Demo program.
*.PIC,*.IMG Screen images used by ELODEMO.EXE.
*.BGI Video driver used by ELODEMO.EXE.
Selective
or
. You may choose later to install
.
To delete the demonstration program from your hard disk after you have run it,
see Uninstalling the Software, page 14.
UNNING
R
ELODEMO
To run ELODEMO, type:
ELODEMO [Enter]
typically from the \TOUCH directory. The main menu is shown in Figure 3-1.
Command Line Flags
Several flags are available when running ELODEMO.
To prevent the main menu from timing out to the DOS prompt after one minute of
no activity, type:
ELODEMO -x
This flag is especially useful at trade shows. To exit, you must either press the
[Esc] key or touch the secret button (extreme lo wer-left corner of the screen), t hen
touch the normal "Stop Demo" button.
Running ELODEMO 19
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>"
Two other flags are available. The -i flag specifies which copy of ELODEV to use
if multiple copies are loaded. For example:
ELODEMO -i62
See Using Multiple Co-Resident Copies of ELODEV, page 34, for more
information.
The -h flag lists the available flags.
Flags may be upper or lower case. Multiple flags may be specified, separated by
spaces. For example, to run ELODEMO at a trade show without any screen timing
out, type:
ELODEMO -x -t
20 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" zone to exit.
Secret zones may be used by applications to select diagnostic or set-up modes.
Process Control
This screen simulates a process or industrial control system. The screen appears to
operate in real time, meaning it senses and reacts to data from on-line machinery.
The object is to stabilize the system by making adjustments until the flashing
warning messages are eliminated.
Adjusting the flame affects the temperature and pressure. The pressure release
valve can be used to adjust the pressure in the tank. The bottles must be filled, but
filling them too much will cause them to overflow. The tank must also be filled
periodically. With IntelliTouch touchscreens, pressing the "Fill" button harder fills
the tank faster.
The speed of the line can be adjusted, as well as hal ted with the "Stop" button.
"Stop" and "Start" must be held continuously for five seconds before they will
activate.
Busy Box
This screen demonstrates various types of buttons, slide switches, dials, pull-down
menus, keypads, etc. If you have an IntelliTouch touchscreen, the Z-axis
(pressure) is also demonstrated.
Map Quiz
Tests how well you can identify the states of the U.S. or the countries of Europe in
this educational demo.
Touch each state or country as prompted. After 10 questions, your score will be
displayed.
Studies have shown that scores are generally higher when computerized
interactive training programs use a touchscreen. Other input devices detract from
the lesson, while the touchscreen permits focused attention.
Running ELODEMO 21
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. With wide lines selected, the width
of the line is based on the Z-axis if using an IntelliTouch touchscreen, or the speed
of motion if using an AccuTouch touchscreen. The Erase button works like an
erasure. The Clear button clears the whole screen.
Touch Keyboard
This screen demonstrates the feasibility of data entry using a touchscreen. While it
is not always practical to replace standard keyboards with touchscreen keyboards,
there are instances where a keyboard such as this may suffice for limited text
entry.
Keys are only entered on untouch, (when you lift your finger), allowing for
correction of missed touches. Using this software technique with a trained
operator, keyboard screens can be made even smaller.
Do not touch "Shift" at the same time as a key. Touch "Shift", release, then touch
the key to be shifted. Touchscreens cannot distinguish between two simultaneous
touches.
This screen also demonstrates an implementation of touch timing. Hold your
finger on a key and it begins to repeat. Continue holding and it repeats even faster.
Teller Machine
This screen simulates an Automated Teller Machine (ATM). It allows deposits,
withdrawals, transfers, balance and check clearing inquiries.
The ATM demonstrates a public-oriented user interface. All such applications
should use Point Mode, where the software acts immediately on touch-down and
ignores all other touch data until untouch and retouch. Try touching a zone and
holding it. The software highlights and beeps, waits half a second, then removes
the highlighting. You must untouch before it will recognize another touch.
Contrast this screen with the Keyboard demo which maintains the highlighting
and acts only on untouch.
22 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.
Touch Piano
Play the piano right on the screen.
You cannot touch more than one note at a time.
Touch Maze
Find your way through this maze.
Touch "Start" and slide your finger down the paths. If you hit the hedges, slide
back to the center of the path and continue. As you move through the maze, you
leave behind footprints.
Black Jack
This demonstration simulates casino-style black jack.
Touch the stacks of chips to place your bet, up to $200. As you touch the chips,
they form new stacks. You may touch these stacks to reduce your bet. Touch
"DEAL".
After the cards are dealt, touch "Hit," "Stand," or "Double". Splits and insurance
are not implemented.
Touch "Wager" to play again.
Touch X,Y
This screen outputs the coordinates of your touch and demonstrates some of the
modes the Elo drivers make available to programmers.
As you slide your finger around, coordinates are displayed. Initially you are in
Untranslated Mode, meaning the coordinates are displayed as they are received
from the touchscreen controller. Note they are unscaled and uncalibrated and the
origin is in the upper left or lower right corner. Touch "Untranslated" to switch the
driver into Translated Mode. Now the coordinates are adjusted by the driver to
match the screen resolution. A cursor appears which can be moved to 10,10.
Stream Mode outputs coordinates continuously as long as the screen is touched.
Point Mode only outputs a point when the screen is first touched. Point Mode with
Running ELODEMO 23
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. You may slide pieces on top of each other if you wish. Pieces cannot be
rotated.
Touch Windows
This demo shows how windowing software can be implemented using a
touchscreen.
Touch any of the overlay activation zones, labeled "Ovly1 - Ovly10". Each causes
an overlay to appear. Multiple overlays are stacked. When an overlay is "opened",
its "icon" disappears. Overlays are removed and returned to icon form by pressing
"HIDE".
Overlays can be moved by touching their "MOVE" zone and sliding. You can also
move them by touching their left, right, or bottom edges and sliding.
Overlays underneath can be brought to the top of the stack by moving them until
part of the "TOP" zone is visible, and then touching that zone.
Within the overlay, there are three zones which make different tones. Slide your
finger up and down over these zones. The selection is made on untouch.
Although this screen is in text mode, a graphical version would work identically.
Home Control
Shows how a home can be controlled using a touchscreen.
The main menu displays the status of the Security, Lighting, Heating, and
Sprinkler systems, along with the current day and time. The current state of the
device is displayed in the "ON/OFF" field in real time. Touching this area
manually overrides the device.
Touching the name of a device displays a screen with two analog clocks - one for
the start time and one for the end time. Move the hands on the clock simply by
Loading...