home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 33 VDrivers / 33-VDrivers.zip / os2_30.exe / READ.ME < prev    next >
Text File  |  1995-07-12  |  10KB  |  283 lines
  1.  
  2.                 MicroTouch Systems, Inc.
  3.         OS/2 Touch Screen driver, Version 3.0A
  4.  
  5. Procedure to Install and Operate the MicroTouch OS/2 Touch Screen Driver
  6. ------------------------------------------------------------------------
  7.  
  8. Hardware and Cabling:
  9. ---------------------
  10. Connect the touch screen controller to your PC's COM1 or COM2 port and
  11. be sure the power is on.
  12.  
  13. Software:
  14. ---------
  15. 1. Insert the floppy disk containing the touch screen software in your
  16.    A: (or B:) drive.
  17.        
  18. 2. Run SETUP.EXE from the A: (or B:) drive and follow the instructions
  19.    on the screen.
  20.  
  21. 3. Reboot the system.
  22.  
  23. The setup program will make the following changes to your system:
  24.  
  25. 1. The installation defaults to \MTSOS2 as the directory for all touch
  26.    screen files.  If the directory does not exist, it is created.
  27.  
  28. 2. Your CONFIG.SYS file is modified as follows:
  29.    a. The following line is added before the MOUSE device driver line
  30.       DEVICE=C:\MTSOS2\MTOUCH.SYS
  31.                   or
  32.       DEVICE=C:\MTSOS2\MTOUCHP.SYS
  33.  
  34.    b. The MOUSE device driver line is modified to read:
  35.       DEVICE=C:\MTSOS2\MOUSE.SYS TYPE=MTOUCH$
  36.  
  37.    Notes: The touch screen drivers must be loaded BEFORE any other
  38.           communications drivers such as COM.SYS and VCOM.SYS.
  39.           See the section called "COM.SYS Error Messages" if needed.
  40.  
  41.           If using a mouse AND a touch screen, see the section called 
  42.           "Installing the Touch Screen and a Mouse on the Same System".
  43.  
  44.           If using IBM's AVC software, see the section called "Audio
  45.           Visual Connection (AVC) Users" at the end of this file.
  46.  
  47.  
  48. 3. The control panel, MTCHCTRL.EXE (or PENPANEL.EXE), and the pen/finger
  49.    switching utility, OS2PEN.EXE, are added to a new Program Group called
  50.    MicroTouch Touch Screen.
  51.  
  52.  
  53. Additional Information:
  54. -----------------------
  55. The MTOUCH.SYS and MTOUCHP.SYS device drivers can take the following
  56. parameters:
  57.  
  58. DEVICE=C:\MTSOS2\MTOUCH.SYS
  59.    SERIAL=[COM1|COM2|COM3|COM4|COM5|COM6|COM7]   default = COM1
  60.    IRQ=[2|3|4|5|6|7]                             default = 4
  61.    BAUD=[1200|2400|4800|9600|19200]              default = 9600
  62.    ALTTYPE=[e.g. MSBUS$|MSINP$|MSSER$]           default = NONE
  63.    BEEP=[UP|DOWN|NONE]                           default = NONE
  64.    BUTTONEMUL=[LEFT|RIGHT]                       default = LEFT
  65.    BUTTONMODE=[TAP|DRAG|LIFTOFF]                 default = LIFTOFF
  66.    OFFSET=touchpoints (0 to 1023)                default = 0
  67.    TAPDISTANCE=pixels (0 to 1023)                default = 24
  68.    TAPTIME=milliseconds                          default = 750
  69.  
  70. Note: all the parameters should be on a single line separated by a space.
  71.  
  72. COM1 always uses IRQ4 regardless of the IRQ setting.
  73. COM2 always uses IRQ3 regardless of the IRQ setting.
  74.  
  75. ALTTYPE
  76.  
  77. The type of mouse being used, if one exists.
  78. Refer to your mouse documentation for the "type" parameter.
  79.  
  80. BAUD
  81.  
  82. The data rate used by the controller.
  83.  
  84. BEEP
  85.  
  86. Determines whether a beep is issued on touchdown, liftoff or not at all.
  87.  
  88. BUTTONEMUL
  89.  
  90. The mouse button emulated by a touch.
  91.  
  92. BUTTONMODE
  93.  
  94. The button events are handled differently depending on the BUTTONMODE
  95. that is in effect.
  96.  
  97.    For the BUTTON mode (called "tap" mode in config.sys), the first
  98.    touchdown will generate mouse movement and immediate left button down
  99.    and left button up events.
  100.  
  101.    For the DESKTOP mode (called "liftoff" mode in config.sys), the first
  102.    touchdown will generate mouse movement events.  The first liftoff will
  103.    generate a button down event followed by a button up event.  Subsequent
  104.    touchdowns (taps) on the same location will generate button down events.
  105.  
  106.    For the DRAWING mode (called "drag" mode in config.sys), all touchdowns
  107.    will generate button down events and all liftoffs will generate button
  108.    up events.
  109.  
  110.    The following table summarizes the mouse events generated under
  111.    various conditions:
  112.  
  113.                           Button Mode      Drawing Mode     Desktop Mode
  114.                             (Tap)            (Drag)          (Liftoff)
  115.                           -----------      ------------     ------------
  116.    1st touchdown          button down/up   button down      movement
  117.    continuing touch       movement         drag             movement
  118.    1st liftoff            movement         button up        button down/up
  119.                                         
  120.    tap                    button down/up   button down/up   button down/up 
  121.  
  122.    2nd continuing touch   movement         button down      movement
  123.    2nd liftoff            movement         button up        button down/up
  124.  
  125. IRQ
  126.  
  127. The hardware interrupt number used by the communications port.
  128.  
  129. OFFSET
  130.  
  131. The distance that the display cursor is shifted above your finger in order
  132. to make it visible.
  133.  
  134. SERIAL
  135.  
  136. The communications port to which the touch screen has been connected.
  137.  
  138. TAPDISTANCE
  139.  
  140. The maximum "distance" between taps for a double tap (or double mouse
  141. button click) to be recognized.
  142.  
  143. TAPTIME
  144.  
  145. The maximum "time" between taps for a double tap (or double mouse
  146. button click) to be recognized.
  147.  
  148.  
  149. Driver Load Messages:
  150. ---------------------
  151. If the driver loads successfully, the system will display a message
  152. similar to the following:
  153.  
  154. Touch Screen Device Driver (Version 2.x)
  155. Copyright (C) 1991-1995 MicroTouch Systems, Inc.
  156. Methuen, MA, All Rights Reserved
  157. Installed....
  158.  
  159.  
  160. Driver Error Messages:
  161. ----------------------
  162. If the driver does not load successfully, the system will display a
  163. message similar to the following:
  164.  
  165. Touch Screen Device Driver (Version 2.x)
  166. Copyright (C) 1991-1995 MicroTouch Systems, Inc.
  167. Methuen, MA, All Rights Reserved
  168. --> Touch screen controller not responding.
  169. --> Use alternate mouse device.
  170.  
  171. Other error messages are shown below:
  172.  
  173. --> Invalid Parameter
  174.    Meaning: The system is trying to parse the device line parameters
  175.             of the driver, but could not find a parameter that matched.
  176.    Action:  Check the device line parameters on the device driver.
  177.             Make sure the parameter names and formats are correct.
  178.  
  179. ** Error:   Unable to get DosGetInfoSeg
  180.    Meaning: The system is trying to get the global and local Info
  181.             segments, but fails.   This is an OS/2 kernel problem.
  182.    Action:  Check the CONFIG.SYS file to make sure the OS/2 kernel
  183.             is properly installed.
  184.  
  185. ** Error:   Serial Port not available
  186.    Meaning: There is no serial port available.
  187.    Action:  Make sure the serial port specified in the CONFIG.SYS
  188.             is present and free.
  189.  
  190. ** Error:   Unable to Initialize Comm Port
  191.    Meaning: The system is unable to initialize the Comm Port.
  192.             This is usually caused by a hardware problem.
  193.    Action:  Make sure the Comm Port is working.
  194.  
  195. ** Error:   Unable to set IRQ
  196.    Meaning: The IRQ specified in the device line parameter is used by
  197.             another process.
  198.    Action:  Make sure the Irq parameter in CONFIG.SYS file is valid.
  199.  
  200.  
  201. COM.SYS Error Messages:
  202. -----------------------
  203. If COM.SYS or VCOM.SYS do not load, the system will display one
  204. or more error messages.   The meanings of these error messages are:
  205.  
  206. ** Error:   COMx did not install. The interrupt level is not available.
  207.    Meaning: If 2 or more async cards use the same interrupt and the touch
  208.             screen is connected to one of them, this message will appear
  209.             when COM.SYS is loaded.
  210.    Action:  Change the interrupt level on the second card.
  211.  
  212. ** Errors:  SYS1201: Device driver "C:\OS2\BOOT\COM.SYS" specified in the
  213.             DEVICE statement on line xx of the CONFIG.SYS file was not
  214.             installed.  Line xx is ignored.
  215.             Press Enter to continue.
  216.  
  217.             SYS1201: Device driver "C:\OS2\MDOS\VCOM.SYS" specified in the
  218.             DEVICE statement on line xx of the CONFIG.SYS file was not
  219.             installed.  Line xx is ignored.
  220.             Press Enter to continue.
  221.    Meaning: All the async ports are used, for example, a serial mouse and
  222.             touch screen are connected to the 2 available ports.
  223.    Action:  Remove COM.SYS and VCOM.SYS from your CONFIG.SYS file.
  224.  
  225.  
  226. Installing the Touch Screen and a Mouse on the Same System:
  227. ----------------------------------------------------------
  228. If using Pen OS/2, change MTOUCH.SYS to MTOUCHP.SYS in what follows.
  229.  
  230. Under OS/2 Version 2.x:
  231.  
  232.    For a standard PS/2 mouse, edit the CONFIG.SYS file and add/modify
  233.    the following device statements:
  234.  
  235.        DEVICE=C:\MTSOS2\MTOUCH.SYS
  236.        DEVICE=C:\MTSOS2\MOUSE.SYS STYPE=MTOUCH$
  237.  
  238.    For a non-standard mouse, edit the CONFIG.SYS file and add/modify
  239.    the following device statements:
  240.  
  241.        DEVICE=C:\OS2\ddddd.SYS                 
  242.        DEVICE=C:\MTSOS2\MTOUCH.SYS ALTTYPE=ddddd
  243.        DEVICE=C:\MTSOS2\MOUSE.SYS TYPE=MTOUCH$
  244.  
  245.    where ddddd = the device dependent driver name
  246.  
  247. Under OS/2 Version 1.x:
  248.  
  249.    Edit the CONFIG.SYS file and add/modify the following three device
  250.    statements:
  251.  
  252.        DEVICE=C:\OS2\MSxxx01.SYS
  253.        DEVICE=C:\MTSOS2\MTOUCH.SYS ALTTYPE=MSxxx$
  254.        DEVICE=C:\MTSOS2\MOUSE.SYS TYPE=MTOUCH$
  255.  
  256.    where xxx = INP for an in-port mouse,
  257.                SER for a serial mouse or
  258.                BUS for a bus mouse
  259.  
  260.    The order of the above device statements is important, and cannot be
  261.    changed.  We recommend you test the mouse and touch screen devices
  262.    separately first before combining them on the same system.
  263.  
  264.  
  265. Audio Visual Connection (AVC) Users:
  266. ------------------------------------
  267. To use the touch screen with AVC, you MUST run the program MTS_AVC.EXE
  268. to enable AVC mode BEFORE running AVC as follows:
  269.  
  270.    MTS_AVC
  271.    AVC
  272.  
  273. If you don't run MTS_AVC, the touch screen will appear to be inaccurate.
  274. Upon exiting AVC, turn off the AVC mode as follows:
  275.  
  276.    MTS_AVC off
  277.  
  278. A sample command file, TOUCHAVC.CMD, is included with this software.  It
  279. contains the above commands to automatically enable and disable AVC mode.
  280.  
  281. Please also note that the touch screen should be in "DRAG" mode (see the
  282. "Control Panel" section above) for best results with AVC.
  283.