® MonitorMouse FOR OS/2 Version 2.1 Manual Version 2.
® MonitorMouse for OS/2 Version 1.0 User’s Guide Manual Version 1.0a Copyright © 1992-1995 by Elo TouchSystems, Inc. 105 Randolph Road Oak Ridge, Tennessee 37830 (615) 482-4100 A Raychem Company All rights reserved.
Trademark Acknowledgements IntelliTouch, AccuTouch, and MonitorMouse are registered trademarks, and ELODEV is a trademark of Elo TouchSystems, Inc. All other trademarks are the property of their respective holders. Copyright Copyright © 1992-1995 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. H55039.
Contents Chapter 1- Introduction ................................... 1 About this Manual ............................................. 1 About MonitorMouse for OS/2 .................................... 2 Touchscreen Controller Compatibility .......................... 2 Software Compatibility..................................... 4 Coordinates vs. Mickeys .............................. 4 Video Compatibility ....................................... 4 Differences from Previous Versions ..........................
Tips on Using the Touchscreen in Presentation Manager .................. 20 Removing the Mouse Pointer ............................... 20 Resizing Windows....................................... 21 Menus ............................................... 21 Scrolling .............................................. 21 Maximizing Windows ..................................... 21 Using the Overscan Area.................................. 21 Option Buttons and Check Boxes............................
Introduction • About this Manual 1 • About MonitorMouse for OS/2 2 • Product Registration 5 • Contacting Elo 6 ABOUT THIS MANUAL This manual provides all of the information you need to install and use MonitorMouse for OS/2, Elo TouchSystems’ touchscreen driver for OS/2. This manual is organized as follows: Chapter 1 Describes the software included, and the hardware requirements. Chapter 2 Describes how to install the MonitorMouse for OS/2 software.
2 Chapter 1 - Introduction Appendix C Gives tips on troubleshooting a MonitorMouse for OS/2 installation and includes a sample CONFIG.SYS file. Appendix D Gives additional installation steps for using MonitorMouse for OS/2 with IBM Audio Visual Connection (AVC) multimedia authoring tool. See the !READ.ME! file (if present) on the accompanying disk. It contains any additions or changes made after this manual was printed.
About MonitorMouse for OS/2 3 MonitorMouse for OS/2 will work with 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 E281-4025 and E281A-4025 controllers.
4 Chapter 1 - Introduction Software Compatibility MonitorMouse for OS/2 is compatible with (Warp). OS/2 versions 1.3 through 3.x Coordinates vs. Mickeys MonitorMouse will work with all Presentation Manager and WIN-OS/2 mousedriven applications. All OS/2 Full Screen and DOS applications that ask the mouse driver for coordinates (absolute position) rather than mickeys (relative motion) will also work.
Product Registration 5 Distribution Rights MonitorMouse for OS/2 and its 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. Other Versions of MonitorMouse MonitorMouse for OS/2 is only one 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.
6 Chapter 1 - Introduction CONTACTING ELO 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 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.
Installing MonitorMouse for OS/2 • Before you Begin 7 • Configure your Controller 8 • Copy the Software 8 • Modify CONFIG.SYS 9 • Install the Touchscreen Control Panel 14 • Calibrate the Touchscreen 14 • Installing the Elo Wallpaper 15 BEFORE YOU BEGIN First be sure OS/2 is installed and operating properly with your mouse. As you will be modifying the CONFIG.SYS file, it is best to have the OS/2 installation disks or a bootable DOS disk readily available. This way, any problems in CONFIG.
8 Chapter 2 - Installing MonitorMouse for OS/2 Step 1 Step 2 Step 3 Step 4 Step 5 Configure your controller Copy the software Modify CONFIG.SYS Install the Touchscreen Control Panel Calibrate the touchscreen STEP 1 - CONFIGURE YOUR CONTROLLER Verify your controller configuration using the setup instructions provided in Appendix A. Elo typically ships touchscreen controllers preconfigured for use with Elo software, including MonitorMouse for OS/2.
Step 3 - Modify CONFIG.SYS 9 Create a subdirectory on your hard disk and copy the files into it. For example, CD \ MD ELO COPY A:*.* ELO International Versions International versions of the Touchscreen Control Panel are included in subdirectories on the MonitorMouse for OS/2 disk. Replace ELOCAL2.DLL and ELOCAL2.HLP on your hard disk with the versions from the appropriate subdirectory. STEP 3 - MODIFY CONFIG.SYS MonitorMouse for OS/2 is installed by commands in CONFIG.SYS.
10 Chapter 2 - Installing MonitorMouse for OS/2 Serial Touchscreen Controller on PC-Bus System Change your CONFIG.SYS file as follows: TGO &'8+%' % >15 >/175' 5;5 =HNCIU? FGXKEG E >GNQ>OQPOQW U[U EQPVTQNNGT %1/ RQTV DCWF TCVG FGXKEG E >QU >OQWUG U[U UV[RG GNQOQW =HNCIU MGGR UCOG CU CDQXG? where is: 2300 4002 2210 140 for the IntelliTouch E281-2300 serial controller. for the IntelliTouch E281{A}-4002 serial controller. for the AccuTouch E271-2210 serial controller.
Step 3 - Modify CONFIG.SYS 11 Serial Touchscreen Controller on PS/2 System Change your CONFIG.SYS file as follows: TGO &'8+%' % >15 >/175' 5;5 =HNCIU? FGXKEG E >GNQ>OQPOQW U[U EQPVTQNNGT %1/ RQTV DCWF TCVG FGXKEG E >QU >OQWUG U[U UV[RG GNQOQW =HNCIU MGGR UCOG CU CDQXG? where is: 2300 4002 2210 140 for the IntelliTouch E281-2300 serial controller. for the IntelliTouch E281{A}-4002 serial controller. for the AccuTouch E271-2210 serial controller.
12 Chapter 2 - Installing MonitorMouse for OS/2 PC-Bus Touchscreen Controller Change you CONFIG.SYS file as follows: TGO &'8+%' % >15 >/175' 5;5 =HNCIU? FGXKEG E >GNQ>OQPOQW U[U EQPVTQNNGT $CUG + 1 2QTV +43 FGXKEG E >QU >OQWUG U[U UV[RG GNQOQW =HNCIU MGGR UCOG CU CDQXG? where is: 4035 4025 2201 141 for the IntelliTouch E281-4035 PC-Bus controller. for the IntelliTouch E281{A}-4025 PC-Bus controllers. for the AccuTouch E271-2201 PC-Bus controller.
Step 3 - Modify CONFIG.SYS 13 Micro Channel Touchscreen Controller Change your CONFIG.SYS file as follows: TGO &'8+%' % >15 >/175' 5;5 =HNCIU? FGXKEG E >GNQ>OQPOQW U[U EQPVTQNNGT FGXKEG E >QU >OQWUG U[U UV[RG GNQOQW =HNCIU MGGR UCOG CU CDQXG? where is: 2202 for the AccuTouch E271-2202 Micro Channel controller.
14 Chapter 2 - Installing MonitorMouse for OS/2 STEP 4 - INSTALL THE TOUCHSCREEN CONTROL PANEL The Touchscreen Control Panel program, ELOCAL2.EXE, is a Presentation Manager application for calibrating the touchscreen and setting various options. See Figure 2-1. Add the \ELO\ELOCAL2.EXE program to the System Setup Folder and label the icon "Touchscreen". This is accomplished as follows: 1. Open the OS/2 System folder, then System Setup. 2. Open the Templates folder. 3.
Installing the Elo Wallpaper 15 Figure 2-1. MonitorMouse for OS/2 Touchscreen Control Panel INSTALLING THE ELO WALLPAPER ELO.BMP can be used to display Elo “wallpaper” when giving demos of MonitorMouse for OS/2. To load, copy the file ELO.BMP to the \OS2\BITMAP directory. Call up the pop-up menu for the desktop with the right mouse button, then choose Open/Settings/Background/Image/Tiled, and select ELO.BMP.
16 Chapter 2 - Installing MonitorMouse for OS/2
Using MonitorMouse for OS/2 • Touchscreen Control Panel 17 • Tips on Using the Touchscreen in Presentation Manager 20 • Tips on Public Access Kiosk Applications 22 • Programming Options 24 TOUCHSCREEN CONTROL PANEL The MonitorMouse for OS/2 Touchscreen Control Panel (see Figure 2-1, page 15) is detailed in the following sections. Calibration Select Calibrate to initiate the calibration sequence. Follow the on-screen instructions. You will be given the opportunity to confirm the calibration points.
18 Chapter 3 - Using MonitorMouse for OS/2 affected by horizontal and vertical adjustments on the monitor and by the physical mounting of the touchscreen. Additional calibration complications include image blooming, where brightlycolored images expand, and the "pincushion" 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 middle, or vice-versa.
Touchscreen Control Panel 19 move, nor will any other clicks be simulated until your finger is lifted and the screen retouched. Mode 1 Left button clicking only. No dragging or right button is supported. Works with large and small targets. The mouse pointer follows your sliding finger and the left button is clicked at the point of release (lift-off). Mode 5 Left button clicking and dragging. No right button is supported.
20 Chapter 3 - Using MonitorMouse for OS/2 Click Sound on Touches A check box is available in the Touchscreen Control Panel for enabling/disabling the "click" sound from the PC’s internal speaker for each touch. Audible feedback is important because the touchscreen does not have any tactile feedback mechanism. CONFIG.SYS is updated with the new setting (-b flag). Beeps are enabled by default. Double-Click Area The double-click area may be specified in the Touchscreen Control Panel.
Tips on Using the Touchscreen in Presentation Manager 21 2. Open the Mouse icon. A Settings notebook will be displayed. 3. Select the Pointers tab. 4. Highlight the arrow icon. Select Edit. 5. With the Icon Editor, select File/New to create a null cursor. Select File/Save. 6. Close the notebook. Resizing Windows See Border Width, page 20. Menus Menus are best navigated by sliding along the menu bar, then down a drop-down menu. Highlighting will follow your finger, indicating the position of touch.
22 Chapter 3 - Using MonitorMouse for OS/2 window is maximized, you may touch the upper-right corner to restore the window, touch the top to click on the window title, and double-tap the upper-left corner to close the window. Option Buttons and Check Boxes It is easier to select an option by touching the option name rather than touching the option button. The same is true with check boxes.
Tips on Public Access Kiosk Applications 23 6. Optimize the application for speed. A quick response keeps the user's attention. Users will walk away from a sluggish system. Speedy systems also reduce vandalism. Do not use a graphics mode with higher than necessary colors/resolution. It will only slow down the system. (Use of 256 colors is typically more important than resolution above 640x480.) 7. The application must be intuitive. Guide the user. Limit choices. Test the application on focus groups.
24 Chapter 3 - Using MonitorMouse for OS/2 PROGRAMMING OPTIONS Presentation Manager applications can launch the Touchscreen Control Panel (ELOCAL2.EXE) with the DosExecPgm() function. It is also possible to directly call the calibration procedure in the Touchscreen Control Panel by executing ELOCAL2.
$SSHQGL[ $ Configuring Your Controller • General Information 25 • Controller Data Sheets 26 GENERAL INFORMATION This appendix describes how to configure your controller’s switch and/or jumper settings for use with MonitorMouse for OS/2. Controllers are typically shipped pre-configured for use with MonitorMouse for OS/2. Your controller’s switch and jumper settings can be found on one of the next few pages.
26 Appendix A - Configuring Your Controller The following table lists the devices normally assigned to each IRQ: IRQ 2 3 4 5 6 7 Device Mapped to IRQ9 COM2 COM1 LPT2 Floppy disk controller LPT1 Below are Elo’s recommendations for choosing an interrupt, in order of preference. Skip the IRQ if a conflict may exist. 5, 7, 2, 3, 4, 6 CONTROLLER DATA SHEETS Setup information for each controller begins on a new page. Skip to the appropriate page for your controller.
Controller Data Sheets 27 IntelliTouch Serial Controller (E281-2300) Verify the controller’s jumper settings are as follows: 9600 Baud Binary Mode Hardware handshaking enabled Stream Mode Reserved Reserved Power-on settings from jumpers Reserved Reserved Emulation mode disabled (From Left) J0 - N J1 - N J2 - N J3 - N J4 - N J5 - N J6 - N J7 - Y J8 - N J9 - N J10 - N J11 - N Jumpers cross-connected horizontally on the bottom pins of the jumper block have no effect and are available as extra jumpers.
28 Appendix A - Configuring Your Controller IntelliTouch Serial Controller (E281{A}-4002) Verify the controller’s switch settings are as follows: Stream Mode Binary Mode Z-axis enable 9600 Baud (recommended) Reserved Reserved (From Bottom) SW0 - OFF SW1 - OFF SW2 - ON SW3 - ON SW4 - ON SW5 - ON SW6 - ON SW7 - ON
Controller Data Sheets 29 AccuTouch Serial Controller (E271-2210) Verify the controller’s jumper settings are as follows: 9600 Baud Binary Mode Hardware handshaking enabled Stream Mode Reserved Reserved Power-on settings from jumpers Reserved Reserved Emulation mode disabled (From Left) J0 - N J1 - N J2 - N J3 - N J4 - N J5 - N J6 - N J7 - Y J8 - N J9 - N J10 - N J11 - N Jumpers cross-connected horizonatally on the bottom pins of the jumper block have no effect and are available as extra jumpers.
30 Appendix A - Configuring Your Controller AccuTouch Serial Controller (E271-140) Verify the controller’s switch settings are as follows: Baud Rate 9600 4800 2400 (recommended) 300 8-Bit Data Binary Mode Filtered Mode Stream Mode SW1 - OFF SW1 - ON SW1 - OFF SW1 - ON SW3 - OFF SW4 - ON SW5 - ON SW6 - OFF SW2 - OFF SW2 - OFF SW2 - ON SW2 - ON 2400 baud is recommended to limit the excessive amounts of data at higher baud rates. Next, verify the Touchscreen Type jumpers.
Controller Data Sheets 31 IntelliTouch PC-Bus Controller (E281-4035) Verify the controller’s switch settings are as follows: 12-Bit Mode Reserved Stream Mode Reserved Z-axis enable Reserved SW1 - ON SW2 - ON SW3 - OFF SW4 - ON SW5 - ON SW6 - 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 th low-order address.
32 Appendix A - Configuring Your Controller Next, install a jumper vertically at W1 to select the Interrupt (IRQ). The E2814035 is shipped jumpered for IRQ5. See Choosing an Interrupt (IRQ) for PC-Bus Controllers, page 25. The jumper block positions are as follows: Interrupt (IRQ) W1 (from left) 2 3 4 5 (factory set) 6 7 Remember the Base I/O Port address and IRQ values. You will need them when updating your CONFIG.SYS file.
Controller Data Sheets 33 IntelliTouch PC-Bus Controller (E281{A}-4025) Verify the controller’s switch settings are as follows: (From Bottom) SW1 - ON SW2 - ON SW3 - OFF SW4 - ON SW5 - ON SW6 - ON SW7 - ON SW8 - ON 12-Bit Mode Reserved Stream Mode Reserved Z-axis enable Reserved Reserved Reserved 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.
34 Appendix A - Configuring Your Controller Next, install a jumper vertically at W1 to select the Interrupt (IRQ). A jumper is supplied, but may be found in a horizontal, inactive position. See Choosing an Interrupt (IRQ) for PC-Bus Controllers, page 25. The jumper block positions are as follows: W1 Position (from left) 6 5 4 3 2 1 Interrupt (IRQ) 2 3 4 5 (factory set) 6 7 Remember the Base I/O Port address and IRQ values. You will need them when updating your CONFIG.SYS file.
Controller Data Sheets 35 AccuTouch PC-Bus Controller (E271-2201) Verify the controller’s jumper settings are as follows: Default from jumpers Reserved Touchscreen Type AccuTouch Stream Mode No Interrupt (software selected) Base I/O Port (in hex) 280 (recommended) 240 180 100 2A0 (From Top) J7 - Y J6 - N J5 - Y J4 - N J3 - N J2 - N J1 - N J0 - N J1 - N J0 - Y J1 - Y J0 - N J1 - Y J0 - Y Cross-connect (connect jumper vertically so the left pins of J0 and J1 are jumpered) J10 and J11 elsewhere on the cont
36 Appendix A - Configuring Your Controller AccuTouch PC-Bus Controller (E271-141) Verify the controller’s switch settings are as follows: 12-Bit Mode No calibration data on reset Stream Mode Filtered Mode (From Top) SW1 - ON SW2 - ON SW3 - OFF SW4 - 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.
Controller Data Sheets 37 Next, install a jumper vertically at W1 to select the Interrupt (IRQ). A jumper is supplied, but may be found in a horizontal, inactive position. See Choosing an Interrupt (IRQ) for PC-Bus Controllers, page 25. The jumper block positions are as follows: Position (from left) 1 2 3 4 5 6 Interrupt (IRQ) 2 3 4 5 (factory set) 6 7 Remember the Base I/O Port address and IRQ values. You will need them when updating your CONFIG.SYS file. Next, verify the Touchscreen Type jumpers.
38 Appendix A - Configuring Your Controller AccuTouch Micro Channel Controller (E271-2202) Verify the controller’s jumper settings are as follows: Default from jumpers Reserved Touchscreen Type AccuTouch Stream Mode Reserved Reserved Reserved Reserved (From Top) J7 - Y J6 - N J5 - Y J4 - N J3 - N J2 - N J1 - N J0 - N Jumpers cross-connected vertically on the right side of the jumper block have no effect and are available as extra jumpers.
$SSHQGL[ % Driver Command Reference • Command Line 39 • Flags 40 COMMAND LINE In general, the MonitorMouse for O/S2 driver is configured with parameters and flags as follows: FGXKEG E >GNQ>OQPOQW :: U[U EQPVTQNNGT RCTCOGVGTU HNCIU where is: 01 02 03 for serial touchscreen controllers on PC-Bus systems. for serial touchscreen controllers on Micro Channel systems. for PC-Bus and Micro Channel touchscreen controllers.
40 Appendix B - Driver Command Reference and the parameters are: ,, for serial touchscreen controllers. ,, for PC-Bus touchscreen controllers. for Micro Channel touchscreen controllers. FLAGS The following may be specified on the DEVICE=MONMOUxx command line in any order, upper or lower case, separated by spaces. No flags are required during initial installation.
Flags 41 Touchscreen Control Panel program. This area may then be manually adjusted with the Touchscreen Control Panel. -w This flag is not normally required. If a stationary touch generates continuous mouse clicks, add the -w flag. Causes of continuous mouse clicks include IntelliTouch controller firmware prior to version 2.2, serial controllers operating at slower than recommended baud rates, or controllers operating in environments of extreme noise.
42 Appendix B - Driver Command Reference
$SSHQGL[ & Troubleshooting Most problems are due to improper installation of the software drivers. Below is a sample OS/2 2.1 CONFIG.SYS file. +(5 % >15 >*2(5 +(5 %#%*' %4'%. 24165*'.. % >15 >2/5*'.. ':' 5'6 75'4A+0+ % >15 >15 +0+ 5'6 5;56'/A+0+ % >15 >15 5;5 +0+ 5'6 15 A5*'.. % >15 >%/& ':' 5'6 #76156#46 241)4#/5 6#5-.+56 (1.&'45 %100'%6+105 5'6 470914-2.#%' % >15 >2/5*'.. ':' 5'6 %1/52'% % >15 >%/& ':' .+$2#6* % >15 >&.. % >15 >/&15 % > % >15 >#225>&..
44 Appendix C - Troubleshooting 5'6 $11-5*'.( % >15 >$115'6 '2/2#6* % >15 >#225 2416'%610.; 01 5*'.. % >15 >/&15>%1//#0& %1/ % >15 >/&15 (%$5 4/5+<' &'8+%' % >15 >/&15>8'// 5;5 &15 .
$SSHQGL[ ' Installation for AVC To use MonitorMouse for OS/2 with IBM Audio Visual Connection (AVC) multimedia authoring tool, perform the following additional steps after verifying correct operation of the touchscreen with pRESENTATION Manager. 1. Extract the TOUCH.SYS and VTOUCH.SYS files from your OS/2 disks or CD-ROM. Place TOUCH.SYS in the \OS2 directory and VTOUCH.SYS in \OS@\MDOS directory. 2. Add DEVICE commands to your CONFIG.SYS file for TOUCH.SYS nad VTOUCH.SYS as in the following example.
46 Appendix D - Installation for AVC
,QGH[ @ @6253.ADF, 11, 44 0 002710-XXX Controller, 3 00285X-25-XXX Controller, 4 00285X-2-XXX Controller, 4 00285X-XXX Enclosure, 3 A -a flag, 26, 48 absolute position coordinates, 4 AccuTouch PC-Bus Controller. See controllers AccuTouch Product Manual, 2, 10, 31, 52 AccuTouch Serial Controller. See controllers Apple Macintosh, 5 Audio Visual Connection (AVC), 2, 53 B -b flag, 26, 48 BBS, 7 border width, 26 BUSSTAT program, 11, 52 compatibility software, 4 touchscreen, 3 video, 4 CONFIG.
48 Index - I-Y E281-2300 serial controller, 14, 15, 32, 33 E281-4035 PC-Bus controller, 16, 32, 37 Elo BBS, 7 Elo touchscreens, 2 ELO.BMP file, 11, 20 ELOCAL2.EXE program, 19 ELOCAL2.
49