





















                                     MonitorMouse 
                                       for OS/2

                                     Version 2.1
                                     User's Guide


                                  Manual Version 2.1

















                                Copyright   1992-1994
                                          by

                                Elo TouchSystems, Inc.
                                  105 Randolph Road
                             Oak Ridge, Tennessee  37830

                                    (615) 482-4100

                                  A Raychem Company

                                 All rights reserved.

                           P/N 008010-A    DOC # SW000042-A




                              Trademark Acknowledgements

          IntelliTouch, AccuTouch,  and MonitorMouse are  registered trade-
          marks, and ELODEV  is a trademark  of Elo TouchSystems, Inc.  All
          other trademarks are the property of their respective holders.


                                      Copyright

          Copyright     1992-1994  by  Elo  TouchSystems, Inc.  All  rights
          reserved. Reproduction, adaptation, or translation without  prior
          written permission is  prohibited, except as allowed  under copy-
          right laws. Printed in USA. H55039.


                              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  software  for the  purposes of
          backing-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 demonstration programs)  may be freely dupli-
          cated or distributed without  charge, but may not be  resold. You
          may not decompile,  reverse assemble, reverse engineer,  or patch
          any software program object code.

          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 documen-
          tation 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 infor-
          mation must not be construed to mean that  Elo intends to provide
          such products, programming, or services.

                                   Limited Warranty


                                          ii




          THIS SOFTWARE AND ACCOMPANYING WRITTEN MATERIALS ARE PROVIDED "AS
          IS" WITHOUT WARRANTY OF  ANY KIND. FURTHER, ELO DOES  NOT GUARAN-
          TEE,  OR  MAKE ANY  REPRESENTATIONS  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,  DIS-
          TRIBUTORS 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.

                                    Governing Law

          This  Agreement shall be governed  by and construed in accordance
          with the laws of the State of Tennessee.



























                                         iii




























































                                          iv







                                       Contents


          Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   1
               About this Manual  . . . . . . . . . . . . . . . . . . .   1
               About MonitorMouse for OS/2  . . . . . . . . . . . . . .   2
                    Touchscreen Controller Compatibility  . . . . . . .   3
                    Software Compatibility  . . . . . . . . . . . . . .   4
                         Coordinates vs. Mickeys  . . . . . . . . . . .   4
                    Video Compatibility . . . . . . . . . . . . . . . .   4
                    Differences from Previous Versions  . . . . . . . .   4
                    Distribution Rights . . . . . . . . . . . . . . . .   5
                    Other Versions of MonitorMouse Available  . . . . .   5
               Product Registration . . . . . . . . . . . . . . . . . .   5
               Contacting Elo . . . . . . . . . . . . . . . . . . . . .   6

          Installing MonitorMouse for OS/2  . . . . . . . . . . . . . .   7
               Before you Begin . . . . . . . . . . . . . . . . . . . .   7
               Step 1 - Configure your Controller . . . . . . . . . . .   8
               Step 2 - Copy the Software . . . . . . . . . . . . . . .   8
                    International Versions  . . . . . . . . . . . . . .   9
               Step 3 - Modify CONFIG.SYS . . . . . . . . . . . . . . .   9
                    Detailed Instructions for System Configurations . .   9
                    Serial Touchscreen Controller on PC-Bus System  . .  10
                         No Mouse . . . . . . . . . . . . . . . . . . .  10
                         Disabling the COM Drivers  . . . . . . . . . .  10
                    Serial Touchscreen Controller on PS/2 System  . . .  12
                         No Mouse . . . . . . . . . . . . . . . . . . .  12
                         Disabling the COM Drivers  . . . . . . . . . .  12
                    PC-Bus Touchscreen Controller . . . . . . . . . . .  14
                         No Mouse . . . . . . . . . . . . . . . . . . .  14
                         Disabling the COM Drivers  . . . . . . . . . .  14
                    Micro Channel Touchscreen Controller  . . . . . . .  16
                         No Mouse . . . . . . . . . . . . . . . . . . .  16
               Step 4 - Install the Touchscreen Control Panel . . . . .  17
               Step 5 - Calibrate the Touchscreen . . . . . . . . . . .  17
               Installing the Elo Wallpaper . . . . . . . . . . . . . .  18

          Using MonitorMouse for OS/2 . . . . . . . . . . . . . . . . .  19
               Touchscreen Control Panel  . . . . . . . . . . . . . . .  19
                    Calibration . . . . . . . . . . . . . . . . . . . .  19
                    Mouse Button Emulation Mode . . . . . . . . . . . .  20
                         Double-Clicking  . . . . . . . . . . . . . . .  21
                    Click Sound on Touches  . . . . . . . . . . . . . .  23
                    Double-Click Area . . . . . . . . . . . . . . . . .  23
                    Border Width  . . . . . . . . . . . . . . . . . . .  23
               Tips on Using the Touchscreen in Presentation Manager  .  23
                    Resizing Windows  . . . . . . . . . . . . . . . . .  23
                    Menus . . . . . . . . . . . . . . . . . . . . . . .  24
                    Scrolling . . . . . . . . . . . . . . . . . . . . .  24
                    Maximizing Windows  . . . . . . . . . . . . . . . .  24
                    Using the Overscan Area . . . . . . . . . . . . . .  24

                                          v







                    Option Buttons and Check Boxes  . . . . . . . . . .  24
                    Choosing the Control-Menu, Minimize, Maximize, and
                         Restore Buttons  . . . . . . . . . . . . . . .  25
                    Removing the Mouse Pointer  . . . . . . . . . . . .  25

          Configuring Your Controller . . . . . . . . . . . . . . . . .  27
               General Information  . . . . . . . . . . . . . . . . . .  27
                    Choosing  an  Interrupt  (IRQ)  for  PC-Bus   Con-
                         trollers . . . . . . . . . . . . . . . . . . .  27
               Controller Data Sheets . . . . . . . . . . . . . . . . .  28
                    IntelliTouch Serial Controller (E281-2300)  . . . .  29
                    IntelliTouch Serial Controller (E281{A}-4002) . . .  30
                    AccuTouch Serial Controller (E271-2210) . . . . . .  31
                    AccuTouch Serial Controller (E271-140)  . . . . . .  32
                    IntelliTouch PC-Bus Controller (E281-4035)  . . . .  33
                    IntelliTouch PC-Bus Controller (E281{A}-4025) . . .  35
                    AccuTouch PC-Bus Controller (E271-2201) . . . . . .  37
                    AccuTouch PC-Bus Controller (E271-141)  . . . . . .  38
                    AccuTouch Micro Channel Controller (E271-2202)  . .  40
                         Controller Installation  . . . . . . . . . . .  40

          Driver Command Reference  . . . . . . . . . . . . . . . . . .  43
               Command Line . . . . . . . . . . . . . . . . . . . . . .  43
               Flags  . . . . . . . . . . . . . . . . . . . . . . . . .  44

          Troubleshooting . . . . . . . . . . . . . . . . . . . . . . .  47

          Installation for AVC  . . . . . . . . . . . . . . . . . . . .  51

          Index . . . . . . . . . . . . . . . . . . . . . . . . . . . .  53























                                          vi




                                                                          















                                                                          1

                                                               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 TouchSys-
                    tems'  touchscreen  driver  for  OS/2.  This  manual is
                    organized as follows:

                    Chapter 1 Describes the software included  on the disk,
                              and the hardware requirements.

                    Chapter 2 Describes how to install the MonitorMouse for
                              OS/2 software.

                    Chapter 3 Details  the use of MonitorMouse for OS/2 and
                              its options.

                    Appendix A     Provides  detailed  information  on con-
                                   figuring your touchscreen controller.




          2    Chapter 1 - Introduction


                    Appendix B     Provides a  reference  for the  Monitor-
                                   Mouse for OS/2  driver command line  and
                                   flags.

                    Appendix C     Gives tips on troubleshooting a Monitor-
                                   Mouse 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.

                    For details on available product configurations, touch-
                    screen theory  of operation, and  general troubleshoot-
                    ing, see the IntelliTouch  Product Manual or the  Accu-
                    Touch Product Manual as appropriate.


          ABOUT MONITORMOUSE FOR OS/2

                    Included  on the accompanying  disk is MonitorMouse for
                    OS/2, a touchscreen  driver for  IBM OS/2 versions  1.3
                    through 3.x. MonitorMouse  for OS/2  allows you to  run
                    all Presentation Manager mouse-driven applications  and
                    off-the-shelf software  without  modification using  an
                    Elo touchscreen.

                    MonitorMouse for OS/2 and an Elo touchscreen are recom-
                    mended for all OS/2 applications that require an intui-
                    tive user interface,  such as  a public kiosk  applica-
                    tion. Touchscreens  are also popular  in point-of-sale,
                    process control,  instrumentation, multimedia,  gaming,
                    education,  simulation, and training  applications. Elo
                    touchscreens may  be used  in a  harsh environment  not
                    appropriate for a mouse or keyboard.

                    With MonitorMouse for OS/2, the touchscreen may be used
                    alone, or in conjunction with  any mouse. Various mouse
                    button emulation modes are  supported providing options
                    on how button clicks are simulated. You can  choose the
                    best  mode  for  your application,  and  change between
                    modes at any time.

                    Applications using only the left button are the easiest
                    to use with the touchscreen.




                                           About MonitorMouse for OS/2    3


          Touchscreen Controller Compatibility

                    Elo manufactures two types of touchscreen technologies.
                    The  IntelliTouch   surface  wave  technology  provides
                    excellent clarity and durability. The AccuTouch  resis-
                    tive  technology  features  pressure-activated  screens
                    with rapid response and high resolution. PC-Bus,  Micro
                    Channel, and serial touchscreen  controllers are avail-
                    able.

                    MonitorMouse for  OS/2 will  work with  the Elo  touch-
                    screen controllers listed below. E281{A}-4002 refers to
                    both  the E281-4002  and E281A-4002  controllers. Like-
                    wise,  E281{A}-4025 refers  to  both the  E281-4025 and
                    E281A-4025 controllers.

                    Controller Model       Interface        Touchscreen
                    Type
                    E281-2300              RS-232           IntelliTouch
                    E281{A}-4002           RS-232           IntelliTouch
                    E271-2210              RS-232           AccuTouch
                    E271-140               RS-232           AccuTouch
                    E281-4035              PC-Bus           IntelliTouch
                    E281{A}-4025           PC-Bus           IntelliTouch
                    E271-2201              PC-Bus           AccuTouch
                    E271-141               PC-Bus           AccuTouch
                    E271-2202              Micro Channel    AccuTouch

                    The following obsolete part numbers may be cross-refer-
                    enced to some of the  controller model numbers referred
                    to above.

                    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 Ser-
                                           ial Controller, configured for
                                           2400 Baud, 8-Bit Data, Binary
                                           Mode, Filtered Mode, Stream
                                           Mode.

                    002710-XXX Con-        E271-140 AccuTouch Serial Cont-
                    troller                roller.

                    002714-XXX Cont-       E271-141 AccuTouch PC-Bus Cont-
                    roller                 roller.

                    00285X-2-XXX Cont-     E281-4002 IntelliTouch Serial
                    roller                 Controller.




          4    Chapter 1 - Introduction



                    00285X-25-XXX Con-     E281-4025 IntelliTouch PC-Bus
                    troller                Controller.


          Software Compatibility

                    MonitorMouse for OS/2 is  compatible with OS/2 versions
                    1.3 through 3.x.


                    Coordinates vs. Mickeys

                    MonitorMouse will  work with  all Presentation  Manager
                    and WIN-OS/2  mouse-driven 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.

                    If your OS/2  Full Screen or DOS application is mickey-
                    based,  find out  from  the developer  if  it can  also
                    operate in an  absolute mode. Sometimes a  set-up para-
                    meter or  flag can be used, or a different input device
                    specified during installation, which also emulates  the
                    mouse.

                    Relative motion cannot be emulated with absolute point-
                    ing  devices  because  the position  of  the  cursor or
                    highlighting in mickey-based applications is unknown to
                    the pointing device  driver. The driver is  not able to
                    determine  the  distance from  a  touch to  the cursor.
                    Knowing this distance is  critical for simulating  that
                    motion with mickeys. Other complicating factors include
                    unknown  mickey-to-pixel  ratios  and  acceleration  or
                    ballistic algorithms used by the application.


          Video Compatibility

                    The  video function of  the display and  the Elo touch-
                    screen installed  on the display are  entirely separate
                    systems. Therefore, the touchscreen is compatible  with
                    all video cards  and modes.  Problems with the  display
                    should  be treated as display problems, not touchscreen
                    problems.


          Differences from Previous Versions

                    MonitorMouse for OS/2 version  2.1 replaces version 2.0
                    on systems  with OS/2  1.3 or  later. MonitorMouse  for
                    OS/2 version  2.1 cannot  be used  on OS/2  1.1 or  1.2
                    systems.




                                           About MonitorMouse for OS/2    5



                    Touchscreen  performance  with  MonitorMouse  for  OS/2
                    version 2.1  has been  enhanced over  version 2.0  when
                    using an IntelliTouch controller with firmware revision
                    2.2 or later, or an AccuTouch or IntelliTouch SmartSet-
                    TM controller (E271-22xx or E281-23xx).


          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 Available

                    MonitorMouse for OS/2 is only  one in a family of  Mon-
                    itorMouse products for various operating systems avail-
                    able separately from Elo. Each  has a similar "look and
                    feel" for a consistent user  interface across all plat-
                    forms.

                    MonitorMouse for DOS emulates the standard mouse driver
                    MOUSE.COM on the IBM family of personal computers, 100%
                    compatibles,  and PS/2  systems  running DOS.  Programs
                    using MOUSE.COM, MOUSE.SYS, or compatible versions will
                    work  with  MonitorMouse.  ELODEVTM,  the   touchscreen
                    driver program for DOS, is also included.

                    MonitorMouse  for  Windows  works  with  all  Microsoft
                    Windows  applications.  MonitorMouse  for  Windows   is
                    included with MonitorMouse for DOS.

                    MonitorMouse for  Windows NT  works with  all Microsoft
                    Windows NT applications (PC version only).

                    MonitorMouse for Macintosh works on the Apple Macintosh
                    II computer or later with System 6 or System 7.x.


          PRODUCT REGISTRATION

                    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 man-
                    ual.




          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 proto-
                    cols)

                    CompuServe:    GO ELOTOUCH
                    Select Elo from the Libraries and Messages menus.

                    Product  announcements,  press   releases,  application
                    notes,  and  the latest  versions  of the  software are
                    available on CompuServe and the Elo BBS.

                    Your comments and suggestions are welcome.




















                                                                          2

                                           Installing MonitorMouse for OS/2


                                  Before you Begin  7

                             Configuring your Controller  8

                                Copying the Software  8

                                Modifying CONFIG.SYS  9

                      Installing the Touchscreen Control Panel  17

                            Calibrating the Touchscreen  17

                            Installing the Elo Wallpaper  18



          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.SYS which  cause the system  not to boot  can be
                    corrected by rebooting from the disk(s).

                    Five steps  are then required when  installing Monitor-
                    Mouse for OS/2:

                         Step 1         Configure your controller
                         Step 2         Copy the software
                         Step 3         Modify CONFIG.SYS




          8    Chapter 2 - Installing MonitorMouse for OS/2


                         Step 4         Install  the   Touchscreen  Control
                                        Panel
                         Step 5         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  pre-configured for  use
                    with  Elo  software, including  MonitorMouse  for OS/2.
                    Configuration requires setting switches and/or install-
                    ing jumpers  that determine controller  operating para-
                    meters. Be  sure to  note these  parameters, which  you
                    will need when  you install  the MonitorMouse for  OS/2
                    driver software.

                    For controller installation instructions, refer to  the
                    IntelliTouch  Product Manual  or the  AccuTouch Product
                    Manual.


          STEP 2 - COPY THE SOFTWARE

                    The following files  are on  the MonitorMouse for  OS/2
                    disk:

                         !READ.ME!      Text file containing  any additions
                                        or  changes made after  this manual
                                        was printed.
                         MONMOU01.SYS   Touchscreen   driver   for   serial
                                        touchscreen  controllers  on PC-Bus
                                        systems.
                         MONMOU02.SYS   Touchscreen   driver   for   serial
                                        touchscreen  controllers  on  Micro
                                        Channel systems.
                         MONMOU03.SYS   Touchscreen driver  for PC-Bus  and
                                        Micro   Channel   touchscreen  con-
                                        trollers.
                         ELOCAL2.EXE    Touchscreen  Control Panel  program
                                        for OS/2.
                         ELOCAL2.DLL    Used by ELOCAL2.EXE.
                         ELOCAL2.HLP    Help file for ELOCAL2.EXE.
                         ELO.BMP        Elo desktop wallpaper.
                         @6253.ADF      Description File for  the E271-2202
                                        Micro   Channel  touchscreen   con-
                                        troller.
                         COMDUMP.EXE    DOS  program  for   testing  serial
                                        touchscreen controllers.
                         BUSSTAT.EXE    DOS program for testing PC-Bus  and
                                        Micro   Channel  touchscreen   con-
                                        trollers.




                                            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 available 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 sub-
                    directory.


          STEP 3 - MODIFY CONFIG.SYS

                    MonitorMouse  for  OS/2  is installed  by  commands  in
                    CONFIG.SYS. Use your system editor  to make these chan-
                    ges. In general, the changes are as follows:

                              Comment-out  the  existing  DEVICE command(s)
                              for your mouse.

                              Add a  DEVICE  command  for  the  appropriate
                              MonitorMouse  for  OS/2   touchscreen  driver
                              immediately  after  the  commented-out DEVICE
                              command(s).

                              Add a new DEVICE command for MOUSE.SYS.

                    The order of the DEVICE  commands is important. See the
                    sample CONFIG.SYS file in Appendix C, page 47.

                    Other changes may  be required depending on  your hard-
                    ware configuration and version of OS/2.


          Detailed Instructions for System Configurations

                    Refer  to  the  page number  given  below  for detailed
                    instructions on your specific configuration.

                    Serial Touchscreen Controller on PC-Bus System       10
                    Serial Touchscreen Controller on PS/2 System         12
                    PC-Bus Touchscreen Controller                        14
                    Micro Channel Touchscreen Controller                 16




          10    Chapter 2 - Installing MonitorMouse for OS/2


          Serial Touchscreen Controller on PC-Bus System

                    Change your CONFIG.SYS file as follows:

                    rem DEVICE=C:\OS2\MOUSE.SYS [flags]
                    device=c:\elo\monmou01.sys   <controller>,<COM  port>,-
                    <baud rate>
                    device=c:\os2\mouse.sys  stype=elomou$  [flags  -  keep
                    same as above]

                    where <controller> is:

                         2300 for the  IntelliTouch  E281-2300 serial  con-
                              troller.
                         4002 for  the  IntelliTouch   E281{A}-4002  serial
                              controller.
                         2210 for  the  AccuTouch  E271-2210  serial   con-
                              troller.
                         140  for the AccuTouch E271-140 serial controller.

                    <COM port>  is the  number of  the COM  port where  the
                    serial  output of  the touchscreen  controller is  con-
                    nected.

                    <baud rate> matches  the switch  or jumper settings  on
                    the controller.

                    Here is an  example MonitorMouse  for OS/2 DEVICE  com-
                    mand:

                    device=c:\elo\monmou01.sys 2300,1,9600


                    No Mouse

                    If you  do not wish to  have a mouse  connected, change
                    the  "stype=elomou$"  flag  to  "type=elomou$"  on  the
                    DEVICE=MOUSE.SYS command.


                    Disabling the COM Drivers

                    If your system COM ports  are being used by the  touch-
                    screen and mouse,  REM out the DEVICE=COM.SYS  and DEV-
                    ICE=VCOM.SYS commands (if present) in CONFIG.SYS.  This
                    prevents  the  COM  drivers from  displaying  a message
                    saying the COM ports are unavailable.

                    If only the touchscreen is  using a COM port, move  the
                    DEVICE=COM.SYS and DEVICE=VCOM.SYS commands before  the
                    DEVICE=MONMOU01.SYS command in CONFIG.SYS. Then add the
                    flag (<COM Port>,0,0)  to COM.SYS, where <COM  Port> is




                                           Step 3 - Modify CONFIG.SYS    11


                    the  same as  on the  DEVICE=MONMOU01.SYS command.  For
                    example,

                    DEVICE=C:\OS2\COM.SYS (1,0,0)


                             Reboot and proceed to Step 4, page 17.




          12    Chapter 2 - Installing MonitorMouse for OS/2


          Serial Touchscreen Controller on PS/2 System

                    Change your CONFIG.SYS file as follows:

                    rem DEVICE=C:\OS2\MOUSE.SYS [flags]
                    device=c:\elo\monmou02.sys   <controller>,<COM  port>,-
                    <baud rate>
                    device=c:\os2\mouse.sys  stype=elomou$  [flags  -  keep
                    same as above]

                    where <controller> is:

                         2300 for the  IntelliTouch  E281-2300 serial  con-
                              troller.
                         4002 for  the  IntelliTouch   E281{A}-4002  serial
                              controller.
                         2210 for  the  AccuTouch  E271-2210  serial   con-
                              troller.
                         140  for the AccuTouch E271-140 serial controller.

                    <COM port>  is the  number of  the COM  port where  the
                    serial  output of  the touchscreen  controller is  con-
                    nected.

                    <baud rate> matches  the switch  or jumper settings  on
                    the controller.

                    Here is an  example MonitorMouse  for OS/2 DEVICE  com-
                    mand:

                    device=c:\elo\monmou02.sys 2300,1,9600


                    No Mouse

                    If you  do not wish to  have a mouse  connected, change
                    the  "stype=elomou$"  flag  to  "type=elomou$"  on  the
                    DEVICE=MOUSE.SYS command.


                    Disabling the COM Drivers

                    If  your system has  only one  COM port which  is being
                    used by the touchscreen, REM out the DEVICE=COM.SYS and
                    DEVICE=VCOM.SYS commands  (if  present) in  CONFIG.SYS.
                    This prevents the COM drivers from displaying a message
                    saying the COM port is unavailable.

                    Otherwise, move the DEVICE=COM.SYS and  DEVICE=VCOM.SYS
                    commands before the DEVICE=MONMOU02.SYS command in CON-
                    FIG.SYS. Then add the flag (<COM Port>,0,0) to COM.SYS,
                    where  <COM Port>  is the  same as  on the  DEVICE=MON-
                    MOU02.SYS command. For example,




                                           Step 3 - Modify CONFIG.SYS    13



                    DEVICE=C:\OS2\COM.SYS (1,0,0)


                             Reboot and proceed to Step 4, page 17.




          14    Chapter 2 - Installing MonitorMouse for OS/2


          PC-Bus Touchscreen Controller

                    Change your CONFIG.SYS file as follows:

                    rem DEVICE=C:\OS2\MOUSE.SYS [flags]
                    device=c:\elo\monmou03.sys <controller>,<Base I/O
                    Port>,<IRQ>
                    device=c:\os2\mouse.sys  stype=elomou$  [flags  -  keep
                    same as above]

                    where <controller> is:

                         4035 for the  IntelliTouch  E281-4035 PC-Bus  con-
                              troller.
                         4025 for  the  IntelliTouch   E281{A}-4025  PC-Bus
                              controllers.
                         2201 for  the  AccuTouch  E271-2201  PC-Bus   con-
                              troller.
                         141  for the AccuTouch E271-141 PC-Bus controller.

                    <Base  I/O  Port> matches  the  jumper settings  on the
                    controller.

                    <IRQ> matches the interrupt jumper on the controller.

                    Here is an  example MonitorMouse  for OS/2 DEVICE  com-
                    mand:

                    device=c:\elo\monmou03.sys 2201,280,5


                    No Mouse

                    If you  do not wish to  have a mouse  connected, change
                    the  "stype=elomou$"  flag  to  "type=elomou$"  on  the
                    DEVICE=MOUSE.SYS command.


                    Disabling the COM Drivers

                    If you  selected IRQ4 or IRQ3 for  the touchscreen con-
                    troller (the  interrupts reserved for  COM1 and  COM2),
                    move the  DEVICE=COM.SYS  and DEVICE=VCOM.SYS  commands
                    (if present) before the DEVICE= MONMOU03.SYS command in
                    CONFIG.SYS. This prevents the COM drivers from display-
                    ing a message  saying the COM port is  unavailable. Add
                    the flag (<COM Port>,0,0) to  COM.SYS, where <COM Port>
                    is 1 for IRQ4 or 2 for IRQ3. For example,

                    DEVICE=C:\OS2\COM.SYS (1,0,0)


                             Reboot and proceed to Step 4, page 17.




                                           Step 3 - Modify CONFIG.SYS    15




          16    Chapter 2 - Installing MonitorMouse for OS/2


          Micro Channel Touchscreen Controller

                    Change your CONFIG.SYS file as follows:

                    rem DEVICE=C:\OS2\MOUSE.SYS [flags]
                    device=c:\elo\monmou03.sys <controller>
                    device=c:\os2\mouse.sys  stype=elomou$  [flags  -  keep
                    same as above]

                    where <controller> is:

                         2202 for  the  AccuTouch  E271-2202  Micro Channel
                              controller.

                    Here is an  example MonitorMouse  for OS/2 DEVICE  com-
                    mand:

                    device=c:\elo\monmou03.sys 2202


                    No Mouse

                    If you  do not wish to  have a mouse  connected, change
                    the  "stype=elomou$"  flag  to  "type=elomou$"  on  the
                    DEVICE=MOUSE.SYS command.


                             Reboot and proceed to Step 4, page 17.




                                           Step 3 - Modify CONFIG.SYS    17


          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  ac-
                    complished as follows:

                    1. Open the OS/2 System folder, then System Setup.

                    2. Open the Templates folder.

                    3. Drag the  Program  template  with  the  right  mouse
                       button  into  the System  Setup  folder.  A Settings
                       notebook will be displayed.

                    4. Enter  "C:\ELO\ELOCAL2.EXE"  as  the Path  and  file
                       name. Enter "C:\ELO" as the Working directory.

                    5. Select the General tab. Change the  Title to "Touch-
                       screen".

                    6. Close the notebook.

                    See your  OS/2 documentation for  detailed instructions
                    on installing new applications.


          STEP 5 - CALIBRATE THE TOUCHSCREEN

                    Double-click the  Touchscreen icon  with the  mouse, or
                    use the keyboard (as the touchscreen  may not be calib-
                    rated  yet). You may also run  ELOCAL2.EXE from an OS/2
                    Window prompt.

                    Select Calibrate and follow the on-screen instructions.
                    After  calibrating, the touchscreen  will work like the
                    mouse.  The  DEVICE=MONMOUxx command  in  CONFIG.SYS is
                    updated with the new calibration  points (-c flag). The
                    calibration points are then set automatically each time
                    the system is started.

                    Close the  Touchscreen Control Panel. (Other options in
                    the Touchscreen Control Panel are described in the next
                    chapter).




          18    Chapter 2 - Installing MonitorMouse for OS/2


                    




















                    Figure 2-1. ELOCAL2.EXE - 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.




















                                                                          3

                                                Using MonitorMouse for OS/2


                             Touchscreen Control Panel  19

               Tips on Using the Touchscreen in Presentation Manager  23



          TOUCHSCREEN CONTROL PANEL

                    The  MonitorMouse  for OS/2  Touchscreen  Control Panel
                    (Figure  2-1, page  18) 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.

                    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  in   touchscreens  and  con-
                    trollers, calibration  also compensates for  the varia-
                    tion  in video image  among displays. The  image is af-
                    fected by  horizontal and  vertical adjustments  on the
                    monitor  and by  the physical  mounting  of the  touch-
                    screen.




          20    Chapter 3 - Using MonitorMouse for OS/2


                    Additional  calibration  complications   include  image
                    blooming, where bright-colored  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.  The displayed  image can  also be tilted.  Even
                    changing video modes can affect the screen size.

                    Perfect calibration cannot  be achieved in all  circum-
                    stances. 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  three-
                    point calibration  sequence and instead relies on well-
                    placed touch zones and appropriate user feedback.

                    The three-point calibration sequence used by the Touch-
                    screen Control  Panel  automatically corrects  inverted
                    touchscreen  installations and backwards  cable connec-
                    tions. X or Y-axis inversion  is normal for some touch-
                    screens.

                    Once calibrated, MonitorMouse for OS/2 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.


          Mouse Button Emulation Mode

                    Four  mouse  button  emulation  modes  are   supported,
                    equivalent  to the corresponding  mode  numbers  in the
                    other versions  of the MonitorMouse family of products.
                    The current mode  may be  changed with the  Touchscreen
                    Control Panel. After selecting  the mode, CONFIG.SYS is
                    updated (-m flag). Mode 6 is the default.

                    The  modes  vary  in the  button  actions  they support
                    (clicking, dragging, double-clicking, etc.) You  should
                    choose  the simplest mode  that will work  for your ap-
                    plication.

                    Mode 0    Left  button clicking  only.  No dragging  or
                              right button is  supported. Works with  large
                              targets.  Recommended  for  public  kiosk ap-
                              plications.




                                            Touchscreen Control Panel    21


                              Moves  the mouse  pointer  to  your point  of
                              touch  and "clicks"  the left button.  A beep
                              will  confirm the  click.  The mouse  pointer
                              will not 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.

                              The left button  is held down when  you touch
                              the  screen,  and  it stays  down  until  you
                              release, dragging as you move.

                    Mode 6    Same as Mode 5,  but supports double-clicking
                              by  tapping  twice.  Recommended  for general
                              use.

                              If the second touch occurs immediately  after
                              the first and is nearby, a double-click  will
                              be simulated at the exact  point of the first
                              touch. If you do not hear two beeps, you have
                              tapped too fast.


                    Double-Clicking

                    Double-clicking is  common in the OS/2  environment, so
                    MonitorMouse  mouse button  emulation mode 6  is recom-
                    mended.  If  you are  running  a  dedicated application
                    which does not use double-clicking,  you may use one of
                    the other modes.

                    The double-click speed for the mouse can be adjusted by
                    changing the mouse settings in the System Setup folder.
                    It may be helpful to adjust  this threshold towards the
                    slower end of the scale.

                    The hardware limitations of the touchscreen controller,
                    the driver software,  and the  system clock combine  to
                    limit  the minimum  double-tapping  speed. A  threshold
                    setting  which permits  a rapid  double-click with  the
                    mouse may not  allow an  equal double-click speed  with
                    the touchscreen. Use the mouse settings program to test




          22    Chapter 3 - Using MonitorMouse for OS/2


                    the  double-click  speed  for both  the  mouse  and the
                    touchscreen.

                    If you do not hear  two beeps when double-tapping  with
                    some older touchscreen controllers, you are tapping too
                    fast. Use a relaxed pace.




                                            Touchscreen Control Panel    23


          Click Sound on Touches

                    A check  box is  available in  the Touchscreen  Control
                    Panel  for  enabling/  disabling the  "click"  sound on
                    touch. 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  Touch-
                    screen Control Panel.  This area is used  for detecting
                    double-clicks in mouse button emulation mode 6. Normal-
                    ly, OS/2 expects a double-click to be on the same pixel
                    -- easy  to do with a mouse, but almost impossible with
                    a touchscreen.  By  expanding  this  area,  it  becomes
                    easier  to  double-click  by  double-tapping   anywhere
                    within this  area. The default  number of pixels  for X
                    and Y  are calculated  after you  calibrate the  touch-
                    screen. CONFIG.SYS is  updated with the new  values (-a
                    flag).


          Border Width

                    To  make resizing windows  easier with the touchscreen,
                    increase  the Border Width for the  desktop. A value of
                    17 is recommended for 640x480  video resolution, 26 for
                    1024x768. For  other resolutions,  pick a  border width
                    that visually matches the title bar width. Wide borders
                    may look strange at first,  but after awhile they  will
                    seem normal. The new border width will not be reflected
                    until the system is rebooted.


          TIPS ON USING THE TOUCHSCREEN IN PRESENTATION MANAGER

                    The following are suggestions for using the touchscreen
                    with Presentation Manager. Mouse button emulation  mode
                    6 is assumed.


          Resizing Windows

                    See Border Width above.




          24    Chapter 3 - Using MonitorMouse for OS/2


          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. When you
                    release, the  highlighted item  will be  selected. This
                    technique is easier than accurately  tapping an item on
                    the menu bar, and then  tapping an item within a  drop-
                    down or pop-up menu.


          Scrolling

                    Scrolling lists can be performed by touching the scroll
                    bars, as  you would with the  mouse. Some lists  can be
                    scrolled more easily by touching the data area, sliding
                    your finger to an  edge, then continuing to  slide out-
                    side the area. This technique works in drop-down lists,
                    for example. In  fact, the farther away you  slide from
                    the list, the faster the data scrolls!


          Maximizing Windows

                    To maximize a  window, try  double-tapping on the  win-
                    dow's  title  bar,  rather  than  tapping the  Maximize
                    button. Likewise, to restore a  maximized window to its
                    previous size, double-tap  on its title bar  instead of
                    tapping  the Restore button. You  can also use the Con-
                    trol menu to maximize, minimize, and restore windows.


          Using the Overscan Area

                    MonitorMouse for OS/2  pushes all  touches in the  dis-
                    play's  overscan area  within  the  screen image.  This
                    effectively enlarges the active touch  area of zones on
                    the  edges of the  image. You  may touch the  edges and
                    corners of the CRT face  to easily click on items  dis-
                    played at the extremes of the image.  For example, when
                    a 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 Using the Touchscreen in Presentation Manager    25


          Choosing the  Control-Menu, Minimize, Maximize, and  Restore But-
                    tons

                    Windows can be maximized and restored easily by double-
                    tapping the title bar as described above. The Minimize,
                    Maximize, and Restore buttons, and the Control-menu box
                    can be  difficult to touch as  they are quite  small on
                    high-resolution screens.  Since they all act  on button
                    release, you can  slide among them before  selecting as
                    with  the drop-down menus. You can also use the Control
                    menu to easily maximize,  minimize, restore, and  close
                    windows.


          Removing the Mouse Pointer

                    A mouse  pointer is  not required  in most  touchscreen
                    applications  and may  actually be  a  distraction. The
                    user's eyes will follow the pointer's  movement instead
                    of focusing on the application. With a pointer present,
                    the user performs the indirect  act of moving the arrow
                    to an  object  instead of  the direct,  natural act  of
                    touching the object.

                    With  OS/2 3.0,  it is  possible to  disable the  mouse
                    pointer as follows:

                    1. Open the OS/2 System folder, then System Setup.

                    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.




          26    Chapter 3 - Using MonitorMouse for OS/2




















                                                                 Appendix A

                                                Configuring Your Controller


                                General Information  27

                               Controller Data Sheets  28



          GENERAL INFORMATION

                    This  appendix describes  how  to  configure your  con-
                    troller's  switch and/or  jumper settings for  use with
                    MonitorMouse for OS/2.  Controllers are typically ship-
                    ped 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. Our recommendations
                    should give you the best performance, but feel  free to
                    try other settings if an option is given.

                    For controller installation instructions, refer to  the
                    IntelliTouch  Product Manual  or the  AccuTouch Product
                    Manual.


          Choosing an Interrupt (IRQ) for PC-Bus Controllers

                    MonitorMouse for  OS/2 requires all  PC-Bus controllers
                    to  be in Interrupt Mode. Choose the hardware interrupt
                    (IRQ)  carefully so it  will not conflict  with another
                    device  installed in  the  system. The  following table
                    lists the devices normally assigned to each IRQ:

                         IRQ  Device
                         2    Mapped to IRQ9




          28    Appendix A - Configuring Your Controller


                         3    COM2
                         4    COM1
                         5    LPT2
                         6    Floppy disk controller
                         7    LPT1

                    Below are Elo's recommendations for choosing an  inter-
                    rupt, in  order of preference. Skip  the IRQ if  a con-
                    flict may exist.

                         5,7,3,4,2,6


          CONTROLLER DATA SHEETS

                    Setup information for  each controller begins on  a new
                    page. Skip to the appropriate page for your controller.

                    Controller                                         Page
                    IntelliTouch Serial Controller (E281-2300)           29
                    IntelliTouch Serial Controller (E281{A}-4002)        30
                    AccuTouch Serial Controller (E271-2210)              31
                    AccuTouch Serial Controller (E271-140)               32
                    IntelliTouch PC-Bus Controller (E281-4035)           33
                    IntelliTouch PC-Bus Controller (E281{A}-4025)        35
                    AccuTouch PC-Bus Controller (E271-2201)              37
                    AccuTouch PC-Bus Controller (E271-141)               38
                    AccuTouch Micro Channel Controller (E271-2202)       40

                                             NOTE:
                    Switches  may be labeled  either OFF/ON  or OPEN/CLOSE,
                    depending  on your  controller. The  data sheet  tables
                    always list switch positions as  OFF (open) or ON (clo-
                    se).




                                               Controller Data Sheets    29


          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
                    Hardware handshaking enabled  J3 - N
                    Stream Mode              J4 - N
                    Reserved                 J5 - N
                    Reserved                 J6 - N
                    Power-on settings from jumpers     J7 - Y
                    Reserved                 J8 - N
                    Reserved                 J9 - N
                    Emulation mode
                         None                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.

                    9600 baud is recommended because  it has the throughput
                    necessary for most applications.




          30    Appendix A - Configuring Your Controller


          IntelliTouch Serial Controller (E281{A}-4002)

                    Verify the controller's switch settings are as follows:

                                             (From Bottom)
                    Stream Mode              SW0 - OFF
                    Binary Mode              SW1 - OFF
                    Z-axis enable            SW2 - ON
                    Baud Rate
                         9600 (recommended)  SW3 - ON, SW4 - ON, SW5 - ON
                         4800                SW3 - ON, SW4 - ON, SW5 - OFF
                         2400                SW3 - ON, SW4 - OFF, SW5 - ON
                         1200                SW3 - ON, SW4 - OFF, SW5 - OFF
                         600                 SW3 - OFF, SW4 - ON, SW5 - ON
                         300                 SW3 - OFF, SW4 - ON, SW5 - OFF
                         150                 SW3 - OFF, SW4 - OFF, SW5 - ON
                    Reserved                 SW6 - ON
                    Reserved                 SW7 - ON

                    9600 baud is recommended because  it has the throughput
                    necessary for most applications.




                                               Controller Data Sheets    31


          AccuTouch Serial Controller (E271-2210)

                    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
                         300                 J0 - Y
                                             J1 - Y
                    Binary Mode              J2 - N
                    Hardware handshaking enabled  J3 - N
                    Stream Mode              J4 - N
                    Reserved                 J5 - N
                    Reserved                 J6 - N
                    Power-on settings from jumpers     J7 - Y
                    Reserved                 J8 - N
                    Reserved                 J9 - N
                    Emulation mode
                         None                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.

                    9600 baud is recommended because  it has the throughput
                    necessary for most applications.




          32    Appendix A - Configuring Your Controller


          AccuTouch Serial Controller (E271-140)

                    Verify the controller's switch settings are as follows:

                    Baud Rate
                         9600                SW1 - OFF SW2 - OFF
                         4800                SW1 - ON  SW2 - OFF
                         2400 (recommended)  SW1 - OFF SW2 - ON
                         300                 SW1 - ON  SW2 - ON
                    8-Bit Data               SW3 - OFF
                    Binary Mode              SW4 - ON
                    Filtered Mode            SW5 - ON
                    Stream Mode              SW6 - OFF

                    2400 baud is recommended to limit the excessive amounts
                    of data at higher baud rates.

                    Next,  verify the  Touchscreen Type  jumpers.  The con-
                    troller  is shipped with a jumper installed on the pins
                    marked W1. This  is the correct setting for E274 5-wire
                    touchscreens. If  you are  using an  older E270  3-wire
                    touchscreen, install the jumper on W2 instead.




                                               Controller Data Sheets    33


          IntelliTouch PC-Bus Controller (E281-4035)

                    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. W3 selects  the high-order ad-
                    dress, and W2 the low-order address. The values of  the
                    settings are shown in the following table:

                              W3                       W2
                              HI (100X)               LOW (10X)
                    Position       Value     Position       Value
                    (from top)     (in hex)  (from top)     (in hex)
                    0              000       0              00
                    1              100       2              20
                    2 (recommended)200       4              40
                    3              300       6              60
                                             8 (recommended)80
                                             A              A0
                                             C              C0
                                             E              E0

                    To calculate the Base I/O Port address,  add the values
                    of the jumpered  positions of W3  and W2. For  example,
                    the E281-4035 is shipped  jumpered for a Base I/O  Port
                    address of 280 hexadecimal. W3 is jumpered in the third
                    position (200), and W2  is jumpered in the  fifth posi-
                    tion (80). The address is the sum of 200 + 80, which is
                    280.

                    Next, install a  jumper vertically at W1  to select the
                    Interrupt (IRQ). The E281-4035 is shipped  jumpered for
                    IRQ5. See Choosing  an Interrupt (IRQ) for  PC-Bus Con-
                    trollers, page 27.  The jumper  block positions are  as
                    follows:

                    Interrupt (IRQ)
                    W1
                    (from left)
                    2
                    3
                    4
                    5 (factory set)
                    6
                    7




          34    Appendix A - Configuring Your Controller



                    Remember the Base  I/O Port address and IRQ values. You
                    will need them when updating your CONFIG.SYS file.




                                               Controller Data Sheets    35


          IntelliTouch PC-Bus Controller (E281{A}-4025)

                    Verify the controller's switch settings are as follows:

                                             (From Bottom)
                    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 ad-
                    dress, and W2 the low-order address.  The values of the
                    settings are shown in the following table:

                              W3                       W2
                    Position       Value     Position       Value
                    (from top)     (in hex)  (from top)     (in hex)
                    4              300       8              E0
                    3 (recommended)200       7              C0
                    2              100       6              A0
                    1              000       5 (recommended)80
                                             4              60
                                             3              40
                                             2              20
                                             1              00

                    To calculate  the Base I/O Port address, add the values
                    of the  jumpered positions of  W3 and W2.  For example,
                    the E281{A}-4025 is usually shipped jumpered for a Base
                    I/O Port address of 280 hexadecimal. W3 is  jumpered in
                    the third  position (200),  and W2 is  jumpered in  the
                    fifth position  (80). The address is  the sum of  200 +
                    80, which is 280.

                    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  27. The
                    jumper block positions are as follows:




          36    Appendix A - Configuring Your Controller


                    W1 Position    Interrupt (IRQ)
                    (from left)
                    6              2
                    5              3
                    4              4
                    3              5 (factory set)
                    2              6
                    1              7

                    Remember  the Base I/O Port address and IRQ values. You
                    will need them when updating your CONFIG.SYS file.




                                               Controller Data Sheets    37


          AccuTouch 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
                    Stream Mode              J4 - N
                    No Interrupt (software selected)   J3 - N
                                             J2 - N
                    Base I/O Port (in hex)
                         280 (recommended)   J1 - N
                                             J0 - N
                         240                 J1 - N
                                             J0 - Y
                         180                 J1 - Y
                                             J0 - N
                         100                 J1 - Y
                                             J0 - Y
                         2A0                 Cross-connect  (connect jumper
                                             vertically so the left pins of
                                             J0 and J1 are jumpered)

                    J10 and J11 elsewhere  on the controller should  not be
                    jumpered.

                    Jumpers cross-connected vertically on the right side of
                    the jumper  block have no  effect and are  available as
                    extra jumpers.




          38    Appendix A - Configuring Your Controller


          AccuTouch PC-Bus Controller (E271-141)

                    Verify the controller's switch settings are as follows:

                                             (From Top)
                    12-Bit Mode              SW1 - ON
                    No calibration data on reset  SW2 - ON
                    Stream Mode              SW3 - OFF
                    Filtered Mode            SW4 - ON

                    Next, set the  controller's Base I/O Port  address with
                    the W2  and W3 jumpers.  W3 selects the  high-order ad-
                    dress, and W2 the low-order address. The  values of the
                    setting are shown in the following table:

                              W3                       W2
                    Position       Value     Position       Value
                    (from top)     (in hex)  (from right)   (in hex)
                    1              000       1              00
                    2              100       2              20
                    3 (recommended)200       3              40
                    4              300       4              60
                                             5 (recommended)80
                                             6              A0
                                             7              C0
                                             8              E0

                    To calculate the  Base I/O Port address, add the values
                    of the  jumpered positions of  W3 and W2.  For example,
                    the E271-141 is usually shipped jumpered for a Base I/O
                    Port address of 280 hexadecimal. W3 is jumpered in  the
                    3rd  position (200),  and  W2 is  jumpered  in the  5th
                    position  (80).  The address  is  the sum  of 200 + 80,
                    which is 280.

                    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  27. The
                    jumper block positions are as follows:

                    W1 Position    Interrupt (IRQ)
                    (from left)
                    1              2
                    2              3
                    3              4
                    4              5 (factory set)
                    5              6
                    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    39


                    Next,  verify the  Touchscreen Type  jumpers. The  con-
                    troller is shipped  with a jumper installed on the pins
                    marked W4. This is the  correct setting for E274 5-wire
                    touchscreens. If  you are  using an  older E270  3-wire
                    touchscreen, install the jumper on W5 instead.




          40    Appendix A - Configuring Your Controller


          AccuTouch 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
                    Stream Mode              J4 - N
                    Reserved                 J3 - N
                    Reserved                 J2 - N
                    Reserved                 J1 - N
                    Reserved                 J0 - N

                    Jumpers cross-connected vertically on the right side of
                    the jumper block  have no effect  and are available  as
                    extra jumpers.


                    Controller Installation

                    Installing  controllers  in  a  Micro Channel  computer
                    requires several additional steps. Proceed  in order as
                    follows:

                    Copy the file @6253.ADF from  the MonitorMouse for OS/2
                    distribution disk to your Backup Copy of your "IBM PS/2
                    Reference Disk".  If you do not  have a backup  of your
                    Reference Disk, boot with the Reference Disk in drive A
                    and follow the on-screen instructions to create one.

                    Follow the "Installing an Adapter" instructions in your
                    IBM Personal  System/2 Quick Reference.  The controller
                    (adapter) may be installed in any available slot.

                    Power up with your backup copy of the Reference Disk in
                    drive A. Error  165 --  Adapter Configuration Error  --
                    will appear because  you just installed a  new adapter.
                    Press  [Enter]  on  the logo  screen,  then  follow the
                    on-screen instructions to "Automatically configure  the
                    system."

                    Next, follow the  on-screen instructions to  "View Con-
                    figuration" and  verify that  the E271-2202  controller
                    was  detected. You should  see installed in  a slot the
                    "Elo E271-2202  Touchscreen Controller".  The Base  I/O
                    Port and selected  Interrupt (IRQ) will also  be shown.
                    Later, if you have problems, you can "Change Configura-
                    tion" of the controller's Base I/O Port and Interrupt.

                    Quit the program,  remove the Reference Disk,  and res-
                    tart the computer.  The system should now  boot without




                                               Controller Data Sheets    41


                    any error messages. Continue your MonitorMouse for OS/2
                    installation as you would with other controllers.




          42    Appendix A - Configuring Your Controller




















                                                                 Appendix B

                                                   Driver Command Reference


                                    Command Line  43

                                       Flags  44



          COMMAND LINE

                    In  general, the MonitorMouse  for OS/2 driver  is con-
                    figured with parameters and flags as follows:

                         device=c:\elo\monmou<XX>.sys   <controller   para-
                    meters> <flags>

                    where <XX> is:

                         01   for serial touchscreen  controllers on PC-Bus
                              systems.
                         02   for serial  touchscreen controllers  on Micro
                              Channel systems.
                         03   for  PC-Bus  and  Micro  Channel  touchscreen
                              controllers.




          44    Appendix B - Driver Command Reference


                    and the <controller parameters> are:

                         <controller>,<COM port #>,<baud rate>   for serial
                                                                 touch-
                                                                 screen
                                                                 control-
                                                                 lers.

                         <controller>,<base port>,<interrupt (IRQ)>   f o r
                                                                      P C -
                                                                      B u s
                                                                      tou-
                                                                      chs-
                                                                      creen
                                                                      con-
                                                                      trol-
                                                                      lers.

                         <controller>                            for  Micro
                                                                 Channel
                                                                 touch-
                                                                 screen
                                                                 control-
                                                                 lers.


          FLAGS

                    The following <flags> 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.  Some  flags will  be  added and
                    updated by the Touchscreen Control Panel  program, ELO-
                    CAL2.EXE.

                    -c<n1,..,n6>        The -c flag lists the n1-n6  calib-
                                        ration points  in  the order  XLow,
                                        XHigh,  YLow,  YHigh,  ZLow, ZHigh.
                                        Calibration  points are  determined
                                        and  updated  by   the  Touchscreen
                                        Control Panel program.

                    -s<+/->        The -s+ flag may be  added by the Touch-
                                   screen  Control   Panel  program   after
                                   calibrating to  correct swapped X  and Y
                                   axes  due to  incorrect cabling.  -s- is
                                   the default.

                    -m<n>          The -m  flag specifies the  mouse button
                                   emulation  mode, identical to  the modes
                                   used  in MonitorMouse for  DOS, Windows,
                                   Windows  NT, and  Macintosh.  Mode 6  is
                                   suggested  for general use  in Presenta-




                                                                Flags    45


                                   tion Manager. The -m flag can be changed
                                   with  the   Touchscreen  Control   Panel
                                   program. -m6 is the default.

                    -b<+/->        The -b+ flag enables a "click"  sound on
                                   touch. The  -b flag can be  changed with
                                   the Touchscreen Control Panel program.
                                   -b+ is the default.

                    -a<x>,<y>      The -a flag  specifies the  size of  the
                                   double-click  area in pixels.  This area
                                   is  used for detecting  double-clicks in
                                   mouse button emulation mode 6. Normally,
                                   OS/2 expects a double-click to be on the
                                   same pixel --  easy to do with  a mouse,
                                   but  almost  impossible  with  a  touch-
                                   screen.  By  expanding  this  area,   it
                                   becomes  easier to double-click  by dou-
                                   ble-tapping anywhere  within this  area.
                                   The defaults for <x>  and <y> are calcu-
                                   lated  after  you  calibrate  with   the
                                   Touchscreen Control Panel  program. This
                                   area may then be  manually adjusted with
                                   the Touchscreen Control Panel.

                    -w<n>          This flag is not normally required. If a
                                   stationary  touch  generates  continuous
                                   mouse clicks, add the -w flag. Causes of
                                   continuous mouse  clicks include  Intel-
                                   liTouch  controller  firmware  prior  to
                                   2.2,  serial  controllers  operating  at
                                   slower  than recommended baud  rates, or
                                   controllers operating in environments of
                                   extreme  noise. Start  with -w2  and in-
                                   crease <n> until the problem is solved.




          46    Appendix B - Driver Command Reference




















                                                                 Appendix C

                                                            Troubleshooting


                    Most problems are  due to improper installation  of the
                    software drivers. Below is a sample OS/2 2.1 CONFIG.SYS
                    file.

                    IFS=C:\OS2\HPFS.IFS  /CACHE:64 /CRECL:4
                    PROTSHELL=C:\OS2\PMSHELL.EXE
                    SET USER_INI=C:\OS2\OS2.INI
                    SET SYSTEM_INI=C:\OS2\OS2SYS.INI
                    SET OS2_SHELL=C:\OS2\CMD.EXE
                    SET AUTOSTART=PROGRAMS,TASKLIST,FOLDERS,CONNECTIONS
                    SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE
                    SET COMSPEC=C:\OS2\CMD.EXE
                    LIBPATH=.;C:\OS2\DLL;C:\OS2\MDOS;C:\;C:\OS2\APPS\DLL;
                    SET PATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS\WINOS2;-
                         C:\OS2\INSTALL;C:\;C:\OS2\MDOS;C:\OS2\APPS;
                    SET DPATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS\WINOS2;-
                         C:\OS2\INSTALL;C:\;C:\OS2\BITMAP;-
                         C:\OS2\MDOS;C:\OS2\APPS;
                    SET PROMPT=$i[$p]
                    SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;
                    SET GLOSSARY=C:\OS2\HELP\GLOSS;
                    SET IPF_KEYS=SBCS
                    PRIORITY_DISK_IO=YES
                    FILES=20
                    DEVICE=C:\OS2\TESTCFG.SYS
                    DEVICE=C:\OS2\DOS.SYS
                    DEVICE=C:\OS2\PMDD.SYS
                    BUFFERS=30
                    IOPL=YES
                    DISKCACHE=1024,LW,AC:C
                    MAXWAIT=3
                    MEMMAN=SWAP,PROTECT
                    SWAPPATH=C:\OS2\SYSTEM 2048 2048
                    BREAK=OFF




          48    Appendix C - Troubleshooting


                    THREADS=256
                    PRINTMONBUFSIZE=134,134,134
                    COUNTRY=001,C:\OS2\SYSTEM\COUNTRY.SYS
                    SET KEYS=ON
                    BASEDEV=PRINT01.SYS
                    BASEDEV=IBM1FLPY.ADD
                    BASEDEV=IBM1S506.ADD
                    BASEDEV=OS2DASD.DMD
                    SET BOOKSHELF=C:\OS2\BOOK
                    SET EPMPATH=C:\OS2\APPS;
                    PROTECTONLY=NO
                    SHELL=C:\OS2\MDOS\COMMAND.COM C:\OS2\MDOS
                    FCBS=16,8
                    RMSIZE=640
                    DEVICE=C:\OS2\MDOS\VEMM.SYS 
                    DOS=LOW,NOUMB
                    DEVICE=C:\OS2\MDOS\VDPX.SYS 
                    DEVICE=C:\OS2\MDOS\VXMS.SYS /UMB
                    DEVICE=C:\OS2\MDOS\VDPMI.SYS 
                    DEVICE=C:\OS2\MDOS\VCDROM.SYS 
                    DEVICE=C:\OS2\MDOS\VWIN.SYS 
                    DEVICE=C:\OS2\OS2CDROM.DMD /Q
                    IFS=C:\OS2\CDFS.IFS /Q 
                    BASEDEV=OS2SCSI.DMD 
                    BASEDEV=AHA154X.ADD 
                    DEVICE=C:\OS2\MDOS\VMOUSE.SYS 
                    DEVICE=C:\OS2\POINTDD.SYS 
                    rem DEVICE=C:\OS2\MOUSE.SYS 
                    device=c:\elo\monmou03.sys 4035,280,5 -s-
                       -c62,2377,1854,137,1,15 -m6 -b+ -f-
                    device=c:\os2\mouse.sys stype=elomou$
                    DEVICE=C:\OS2\COM.SYS 
                    DEVICE=C:\OS2\MDOS\VCOM.SYS 
                    CODEPAGE=437,850
                    DEVINFO=KBD,US,C:\OS2\KEYBOARD.DCP
                    DEVINFO=SCR,VGA,C:\OS2\VIOTBL.DCP
                    SET VIDEO_DEVICES=VIO_VGA
                    SET VIO_VGA=DEVICE(BVHVGA)
                    DEVICE=C:\OS2\MDOS\VVGA.SYS

                    If the  driver commands  are correctly  placed in  CON-
                    FIG.SYS, verify that the controller type and communica-
                    tion parameters match the  controller's. See Appendix A
                    for controller switch/jumper settings.

                    Check for any  error message  displayed by the  drivers
                    when the system is started. The touchscreen driver will
                    display  power-on diagnostic  results  for most  touch-
                    screen  controllers,  possibly  indicating  a  hardware
                    problem. Verify all connections.

                    To display the  diagnostic results, controller communi-
                    cation parameters, controller firmware revision  level,




                                                                Flags    49


                    and  software  revision  levels  from  the  Touchscreen
                    Control Panel, select About, then Info.

                    You may use  the included COMDUMP or  BUSSTAT utilities
                    after booting under  DOS to see  if the touchscreen  is
                    transmitting any  data. Refer  to the  DOS and  Windows
                    Driver Guide for information on these utilities.

                    For additional hardware troubleshooting steps, see  the
                    IntelliTouch  Product Manual  or the  AccuTouch Product
                    Manual as appropriate. If you need help, see Contacting
                    Elo, page 6.




          50    Appendix C - Troubleshooting




















                                                                 Appendix D

                                                       Installation for AVC


                    To use MonitorMouse for OS/2  with the 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  \OS2\MDOS direc-
                       tory.

                    2. Add  DEVICE commands  to your CONFIG.SYS  for TOUCH-
                       .SYS  and  VTOUCH.SYS as  in the  following example.
                       These commands are  in addition to  the changes  de-
                       scribed in Chapter 2.

                       DEVICE=C:\ELO\MONMOU0X.SYS [existing parameters]
                       DEVICE=C:\OS2\TOUCH.SYS TYPE=ELOTOU$
                       DEVICE=C:\OS2\MDOS\VTOUCH.SYS 
                       DEVICE=C:\OS2\MOUSE.SYS [existing parameters]

                    3. Reboot.

                    If the touchscreen does not appear properly  calibrated
                    in AVC  applications, verify that  Presentation Manager
                    is  running in  640x480 resolution and  recalibrate the
                    touchscreen with the Touchscreen Control Panel.


