home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / RODNT100.ZIP / RODENT.DOC < prev    next >
Text File  |  1993-07-13  |  78KB  |  1,747 lines
  1. --------------------------------- Copyright ----------------------------------
  2.  
  3.    Copyright (c) 1993 by Michael Lee Finney.  All rights reserved.
  4.  
  5. --------------------------------- Trademarks ---------------------------------
  6.  
  7.    Many names used in this document are trademarked.  I apologize for the
  8. omission of any trademark which I have used and failed to mention as
  9. trademarked.  If notified, I will gladly place the appropriate notice in
  10. the next revision of this file.  The trademarks of which I am aware are...
  11.  
  12.    Trademark   ...................Owner...................
  13.  
  14.    Altra       Altra
  15.    Felix       Altra
  16.    IBM         International Business Machines Corporation
  17.    Inport      Microsoft Corporation
  18.    Logitech    Logitech
  19.    Microsoft   Microsoft Corporation
  20.    Mouseman    Logitech
  21.    OS/2        International Business Machines Corporation
  22.    PC Mouse    MSC Technologies
  23.    PS/2        International Business Machines Corporation
  24.    Trackman    Logitech
  25.    WIN-OS/2    International Business Machines Corporation
  26.    Windows     Microsoft Corporation
  27.  
  28. --------------------------------- Shareware ----------------------------------
  29.  
  30.    This program is shareware.  If you find this program useful you must
  31. register your copy.  To register a private copy, send $15.00 (US funds)
  32. for each copy to:
  33.  
  34.    Michael Lee Finney
  35.    114 Old Wiggington Road
  36.    Lynchburg, Va. 24502-4669
  37.  
  38. Please make remittance payable to: Michael Lee Finney, and include your
  39. company name (for a corporate license), name, address and phone number.
  40. I would also appreciate the options used for your particular mouse.  This
  41. information will allow me to better tune the options in the next release
  42. and possibly provide an installation program.  The registration cost for
  43. corporate site licenses is...
  44.  
  45.        1..4   copies -- $25 each             
  46.        5..10  copies -- $20 each        
  47.       11..20  copies -- $15 each
  48.       21..40  copies -- $10 each
  49.       41...   copies --  $5 each
  50.  
  51.    These prices are accumulative, so the first four copies cost $25 each,
  52. the next six cost $20 each, and so on.  Thus, for example, a corporate
  53. license for 23 copies would cost...
  54.  
  55.     4 @ $25 ... $100
  56.     6 @ $20 ... $120
  57.    10 @ $15 ... $150
  58.     3 @ $10 ...  $60
  59.                ------
  60.                 $430
  61.  
  62.    To obtain the latest version of this program when you register, send
  63. $10 for shipping and handling to the above address.  This $10 does NOT
  64. apply to the registration cost and only one copy will be sent regardless
  65. of the number of copies registered (the author is NOT in the business of
  66. diskette duplication).  However, the $10 is a flat fee and not a per
  67. registered copy charge.  If you send me $25 without indicating that a
  68. private license with requested diskette or a commercial license without
  69. a requested diskette is desired, I will take my cue from the method of
  70. payment and request -- namely a check that appears to be a company check
  71. or the use of a company letterhead or the mention of a company name will
  72. be assumed to indicate a commercial registration whereas a private check
  73. and a simple note without the mention of any company will be assumed to
  74. be a private registration with a request for a diskette.
  75.  
  76. Note: Registration is not required for beta releases of this program.
  77.       However, the license to use the beta release expires when the
  78.       corresponding general availability release is issued and with this
  79.       release the license to use all previous beta releases has expired.
  80.  
  81. ---------------------------------- License -----------------------------------
  82.  
  83.    Unregistered users (personal or corporate) are permitted to use this
  84. program for a trial period of one month.  By the end of this period you
  85. must either register the program or remove it from your system(s).
  86.  
  87.    Registered users are permitted to use this program on one system at a
  88. time and may make as many archived copies for backup purposes as needed.
  89. It may be used on multiple systems (for a single license) only under the
  90. condition that only one of the systems is in use at a time.  Since this
  91. program is an operating system device driver, the assumption is that it is
  92. in continual use when the system in use.  Therefore a registered copy
  93. is required for each system on which this program is used simultaneously.
  94.  
  95.    Registered users are entitled to support.  If after registration a
  96. program error is found, the author will make every attempt possible to
  97. repair the program.  If the failure cannot be repaired and makes the
  98. product unusable the author will refund the registration fee.  Otherwise,
  99. registered users are eligible for the "bug" reward (see details below).
  100. Additionally, registered users will also be sent notices of new versions
  101. of this program, and of other shareware releases by the author.  In
  102. particular a registered beta user will be notified of the general
  103. availability release.  Your name will NOT be sold to a mailing list.
  104.  
  105.    This program is not intentionally crippled in any manner, therefore a
  106. new copy of the program will NOT be sent when the program is registered
  107. unless explicitly requested.
  108.  
  109. Note: The license to use previous beta releases has expired with this
  110.       release of the general availability version of this software.
  111.  
  112. ---------------------------------- Contents ----------------------------------
  113.  
  114. The distribution file RODNT100.ZIP contains the following files...
  115.  
  116.    LICENSE.DOC  - Licensing information
  117.    ORDER.DOC    - Ordering information
  118.    RELEASE.DOC  - Release information
  119.    README.1ST   - Quick installation hints
  120.    RODENT.DOC   - This file
  121.    RODENT.SYS   - Mouse driver
  122.    RODENT.EXE   - Presentation Manager test program
  123.  
  124.    BUSS.DDP     - Device driver installation file
  125.    CALCMP2X.DDP - Device driver installation file
  126.    CALCMP3X.DDP - Device driver installation file
  127.    CALCMP9X.DDP - Device driver installation file
  128.    CALCMPWZ.DDP - Device driver installation file
  129.    FELIX.DDP    - Device driver installation file
  130.    INPORT.DDP   - Device driver installation file
  131.    LOGITECH.DDP - Device driver installation file
  132.    MSOFT.DDP    - Device driver installation file
  133.    MSYSTEMS.DDP - Device driver installation file
  134.    PS2.DDP      - Device driver installation file
  135.    SGRAPH.DDP   - Device driver installation file
  136.  
  137.    If this device driver is placed on a bulletin board, all files must
  138. be distributed -- preferably in the original RODNT100.ZIP file.
  139.  
  140. ---------------------------------- Summary -----------------------------------
  141.  
  142.    RODENT.SYS is a mouse driver which supports most mice.  It provides
  143. three button support.  The advantages of RODENT.SYS over the IBM mouse
  144. drivers (assuming that they even work for your mouse) are...
  145.  
  146.    1. Up to 7 buttons are supported.
  147.  
  148.    2. The mouse buttons can be arbitrarily reassigned (reordered).
  149.  
  150.    3. The middle button on most 3 button mouse can be programmed as a
  151.       chord of the left and right buttons.
  152.  
  153.    4. The interrupt handlers have been carefully tuned resulting in a
  154.       lower system load (compared to the IBM mouse drivers) when the
  155.       mouse is active.
  156.  
  157.    5. The FIFO buffer of an 16550AFN or 16552 can be enabled, further
  158.       lowering the system load under the appropriate conditions.
  159.  
  160.    6. More serial mice are supported using more protocols than the IBM
  161.       mouse drivers support.  Some digitizer tablets are supported.
  162.       All mice supported by the IBM mouse drivers are supported.
  163.  
  164.    7. Auto-detects the type of mouse, where possible.
  165.  
  166.    8. Auto-detects the number of mouse buttons, where possible.
  167.  
  168.    9. Auto-detects the type of uart (for serial mice).
  169.  
  170.   10. Supports additional baud rates over the basic 1200 provided by the
  171.       IBM mouse drivers.  Baud rates of 150, 300, 600, 1200, 2400, 4800,
  172.       9600 and 19200 are supported for those mice which allow the baud
  173.       rate to be set.
  174.  
  175.   11. Supports additional reporting rates over the default provided by
  176.       the IBM mouse drivers.  Reporting rates of 10, 20, 30, 40, 50,
  177.       60, 80, 100 and 200 are supported for those mice which allow the
  178.       reporting rate to be set.
  179.  
  180.   12. Any 8250 compatible uart can be used at any port address and any irq.
  181.       The IBM drivers only support COM1..COM2.
  182.  
  183.   13. Should not "lose" the mouse during a reboot via Ctrl-Alt-Del.
  184.  
  185.   14. Mouse deinstalls correctly on ABIOS systems (a bug in some of the IBM
  186.       mouse drivers).
  187.  
  188.   15. Low battery detection for serial Logitech radio mice is provided
  189.       during system boot.
  190.  
  191.   16. The actual mouse resolution can be specified.
  192.  
  193.   17. The mouse sensitivity can be increased or reduced by a factor of
  194.       1, 2, 4 or 8.  This is useful for very low or high resolution mice
  195.       and for handicapped individuals who have problems with fine motor
  196.       control.
  197.  
  198. ---------------------------------- Support -----------------------------------
  199.  
  200.    This is a shareware product.  Support is only available to registered
  201. users.  The registration cost is only $15 so PLEASE register if you find
  202. this product useful.  Problems can be reported via email (in order of
  203. preference at:
  204.  
  205.    IBM NTS:    Mike Finney
  206.  
  207.    Compuserve: 71573,1075
  208.  
  209.    Genie:      M.FINNEY
  210.  
  211.    Commercial usage of the Internet is prohibited so it may not be used
  212. to provide general support.  However, I will respond to a personal note
  213. from any source whatsoever including an Internet email message.  Please
  214. refrain from using the Internet for support issues unless you have no
  215. alternative.  My Internet email addresses are:
  216.  
  217.    Internet:   71573.1075@COMPUSERVE.COM
  218.  
  219.    Internet:   M.FINNEY@GENIE.GEIS.COM
  220.  
  221.       Note: Delays and/or failures in sending/receiving messages via this
  222.             address have been reported.  If you send a message and fail
  223.             to get a response please try again, possibly with another
  224.             address.  I respond to EVERY message, but have had one or two
  225.             returned and without a repost have no way to deliver my
  226.             response.
  227.  
  228. and by U.S. Mail at:
  229.  
  230.    Michael Lee Finney
  231.    114 Old Wiggington Road
  232.    Lynchburg, Va. 24502-4669
  233.  
  234.    Please include all pertinent information regarding the problem, including
  235. hardware configuration, operating system release and corrective service
  236. level.  Include your name, address, email address, phone number, etc. so that
  237. I can contact you.  Please include time zone, and the best hours to reach you
  238. by phone and the hours you would rather NOT be reached by phone (shareware
  239. authors aren't permitted to sleep).  However, a binary copy of another mouse 
  240. driver is useless (several people have actually sent me one).
  241.  
  242.    I will attempt to resolve any reported problems.  However, if the problem
  243. is caused by a hardware incompatibility then resolution may be difficult if
  244. I am unable to locate equivalent hardware.  I will work with you as far as
  245. possible.  I am willing to support incompatible mice, but I must be able to
  246. get the necessary hardware.  If you have such a mouse send me a note with a
  247. return address or phone number and I will work with you.
  248.  
  249. ----------------------------------- Reward -----------------------------------
  250.  
  251.    In order to promote software quality, and as an assurance of the existing
  252. software quality of this product, a reward of 25% of the registration fee
  253. with a minimum of $5.00 and maximum of $25.00 is offered to any registered
  254. user for each report of a previously unknown program error.
  255.  
  256. RULES:
  257.  
  258.    1. The reward is only offered to registered users who have not requested
  259.       a refund (however, I will accept bug reports from any user).
  260.  
  261.    2. The maximum reward paid to a single user is limited to twice the
  262.       registration cost paid by the user (if you register 10 copies then
  263.       your maximum possible reward is greater than if you register 1 copy).
  264.  
  265.    3. I am the final arbiter with regards to precedence between users
  266.       reporting the same program error.
  267.  
  268.    4. I am the final arbiter in determining that a reported program error
  269.       does, in fact, exist.
  270.  
  271.    5. Failure to support incompatible hardware is NOT considered an error.
  272.       I cannot be responsible for every device some twisted hardware
  273.       designer creates (even IBM cannot do that).  However, I will work
  274.       with users to resolve any problem to the best of my ability.  To
  275.       date, all but one reported problem (for the beta release) has fallen
  276.       into this category.
  277.  
  278.    6. This reward is not offered for beta releases and experimental
  279.       features.
  280.  
  281.    7. The reward is only offered to end users.  A distributor that purchases
  282.       copies for their users is NOT considered an end user.  A company that
  283.       purchases copies for their internal use IS considered an end user.
  284.  
  285. -------------------------------- Installation --------------------------------
  286.  
  287.    This mouse driver is an OS/2 2.x device driver ONLY, it does NOT
  288. function under OS/2 1.x or under any version of DOS, Windows or Unix.
  289. It is not possible to install this driver under OS/2 1.x, DOS, Windows
  290. or Unix.
  291.  
  292. Installing RODENT.SYS during OS/2 installation:
  293.  
  294.    1. Unzip RODNT100.ZIP and copy the files to the root directory on
  295.       a diskette prior to installing OS/2 (unless using a diskette
  296.       received from the author, in which case this step has been done
  297.       for you).
  298.  
  299.    2. Proceed with installing OS/2.
  300.  
  301.    3. At the "Select Mouse" screen, select "No pointing device support".
  302.       This prevents OS/2 from placing incorrect statements in CONFIG.SYS
  303.       during installation.
  304.  
  305.    4. At the "Advanced Options" screen, select "Install Device Support
  306.       Diskette".
  307.  
  308.    5. At the "OS/2 2.1 Device Driver Installation" screen, place the
  309.       diskette from step 1 into the diskette drive and select "Install".
  310.  
  311.    6. At the "Select Device Drivers" screen, select the appropriate mouse
  312.       driver (down arrow to change current highlighted entry and space bar
  313.       to select the current highlighted entry).  Press <tab> to move to
  314.       the "Ok" button and then press <Enter>.  OS/2 will copy RODENT.SYS
  315.       into the \OS2 directory and update your CONFIG.SYS file.  It will
  316.       then present the "OS/2 2.1 Device Driver Installation" screen again
  317.       because you might have other device drivers.  If so, install them
  318.       now.  After all of your device drivers have been installed use the
  319.       right arrow to select "Exit" and press <Enter>.  At the "Exit the
  320.       Program" dialog, select "Yes".  OS/2 will then present you with a
  321.       message that your system configuration has been changed.  Press
  322.       <Enter> to continue with the installation of OS/2.
  323.  
  324.    7. At the "Advanced Options" screen, press <Enter> to continue.  You
  325.       may now complete the installation of OS/2.
  326.  
  327.    Warning: OS/2 will add the statements to CONFIG.SYS in the incorrect
  328.             order.  If you have installed a serial mouse you may need
  329.             to edit your CONFIG.SYS file before your mouse can be used.
  330.             The mouse statements in your CONFIG.SYS file must occur in
  331.             the following order...
  332.  
  333.                DEVICE=...POINTDD.SYS...
  334.                DEVICE=...RODENT.SYS...
  335.                DEVICE=...MOUSE.SYS...
  336.                DEVICE=...VMOUSE.SYS...
  337.                DEVICE=...COM.SYS...
  338.                DEVICE=...VCOM.SYS...
  339.  
  340.             If this is the case, then when OS/2 is rebooted it may tell
  341.             you that it failed to install some or all of RODENT.SYS,
  342.             MOUSE.SYS and VMOUSE.SYS.  Press <Enter> to continue booting
  343.             OS/2, start an editor (the system editor is always available)
  344.             and change the CONFIG.SYS file so that the mouse statements
  345.             are in the correct order.  This should be done when installing
  346.             a serial mouse even if OS/2 boots without error messages to
  347.             avoid conflicts with the mouse driver and the serial port
  348.             driver.
  349.  
  350. Installing RODENT.SYS after OS/2 installation:
  351.  
  352.       The file RODENT.SYS should be copied to a directory of your
  353.    choice -- the C:\OS2 directory is the usual choice, but any directory
  354.    can be used.  If OS/2 does not support your mouse at all then remember
  355.    that the mouse will not function correctly until RODENT.SYS has been
  356.    installed.  It is necessary to modify the CONFIG.SYS files to contain
  357.    the following lines...
  358.  
  359.       DEVICE=x:\OS2\POINTDD.SYS
  360.       DEVICE=x:\path\RODENT.SYS [options...]
  361.       DEVICE=x:\OS2\MOUSE.SYS TYPE=RODENT$
  362.       DEVICE=x:\OS2\MDOS\VMOUSE.SYS
  363.  
  364.    and any other existing lines relating to the mouse driver should be
  365.    removed.  These lines should be placed in the order given and for
  366.    serial mice must precede the "DEVICE=...COM.SYS..." line.  For
  367.    example, assuming that OS/2 is located on the C: drive and that
  368.    RODENT.SYS has been placed in the C:\OS2 directory:
  369.  
  370.       DEVICE=C:\OS2\POINTDD.SYS
  371.       DEVICE=C:\OS2\RODENT.SYS
  372.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  373.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  374.  
  375.       or:
  376.  
  377.       DEVICE=C:\OS2\POINTDD.SYS
  378.       DEVICE=C:\OS2\RODENT.SYS BAUD=19200 BUFFERED DPI=400
  379.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  380.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  381.  
  382.       or:
  383.  
  384.       DEVICE=C:\OS2\POINTDD.SYS
  385.       DEVICE=C:\OS2\RODENT.SYS PORT=73D8 IRQ=11 BAUD=2400 BUFFERED MOUSE=C PROTOCOL=MM BUTTONS=2 DPI=300
  386.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  387.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  388.  
  389.    The first DEVICE line in the last example is longer than 80 characters.
  390.    In most cases an installation similar to the first two examples would
  391.    be used.  If you have multiple mice attached to your system, then you
  392.    may need to specify the mouse type or the serial port for the desired
  393.    mouse.  Only one mouse can be used at a time.  Lines in your CONFIG.SYS
  394.    which are mouse related are...
  395.  
  396.       DEVICE=C:\OS2\POINTDD.SYS
  397.       DEVICE=C:\OS2\VISION.SYS...
  398.       DEVICE=C:\OS2\PCLOGIC.SYS...
  399.       DEVICE=C:\OS2\MOUSE.SYS...
  400.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS...
  401.  
  402.    all such lines should be removed and replaced as shown above.  There may
  403.    be other mouse related lines for different releases of OS/2 and where
  404.    mouse vendors have provided an OS/2 mouse driver.  Further, the
  405.    statements in CONFIG.SYS should occur in the following order...
  406.  
  407.       DEVICE=...POINTDD.SYS...
  408.       DEVICE=...RODENT.SYS...
  409.       DEVICE=...MOUSE.SYS...
  410.       DEVICE=...VMOUSE.SYS...
  411.       DEVICE=...COM.SYS...
  412.       DEVICE=...VCOM.SYS...
  413.  
  414.    failure to observe this ordering may result in failure of the mouse to
  415.    load properly or of the serial ports to operate correctly.  This mouse
  416.    driver has been tested under OS/2 2.0 GA, 2.0 GA+SP, 2.1 March beta and
  417.    2.1 GA.  It has been tested on a 50Mhz 486DX AT-clone and on an IBM
  418.    PS/2 model 70 (25Mhz 386).  The following mice have been tested...
  419.  
  420.       CalComp Wiz digitizer
  421.       CalComp DrawingPad digitizer
  422.       Felix mouse
  423.       Honeywell Mouse
  424.       Keen Mouse
  425.       Logitech C9 Mouse
  426.       Logitech First Mouse (serial)
  427.       Logitech MouseMan Cordless Mouse (serial)
  428.       Logitech MouseMan Mouse (buss)
  429.       Logitech TrackMan Mouse (serial -- Mouse Systems compatible)
  430.       Microsoft Mouse (Inport buss)
  431.       Microsoft Mouse (serial)
  432.       SummaSketch III
  433.  
  434.       Only these mice have been tested by the author with this mouse
  435.    driver.  However, the driver is MUCH more capable because special
  436.    provisions have been made to support "partially" compatible mice
  437.    and most common mice use one of the available support protocols.
  438.  
  439.       In some cases a mouse might function with the driver, but require
  440.    some of the more exotic options (see the option list below).  For
  441.    example, you could have a mouse which recognized most of the protocols
  442.    associated with a Logitech type C mouse, but could not be automagically
  443.    recognized.  In this case you would use the CONFIG.SYS entries:
  444.  
  445.       DEVICE=C:\OS2\POINTDD.SYS
  446.       DEVICE=C:\OS2\RODENT.SYS COM=1 MOUSE=C
  447.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  448.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  449.  
  450.    (assuming the mouse is attached to COM1) which forces the mouse
  451.    driver to accept the mouse as a Logitech type C mouse, but avoids
  452.    the recognition check used for the type C mice.  However, all
  453.    programming codes are still sent to the mouse.  Or as a more severe
  454.    example, you could have a mouse which supports the Mouse System's 5B
  455.    communication protocol (default with Mouse System's mice) but nothing
  456.    else works.  In that case you would use the CONFIG.SYS entries:
  457.  
  458.       DEVICE=C:\OS2\POINTDD.SYS
  459.       DEVICE=C:\OS2\RODENT.SYS COM=1 MOUSE=* PROTOCOL=5B
  460.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  461.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  462.  
  463.    which forces the mouse driver to use the correct communication protocol,
  464.    but with NO attempt made at sending programming codes to the mouse.
  465.    The mouse must default to the appropriate state to use the specified
  466.    protocol.  Many mice can be setup this way, however other mice either
  467.    cannot be automagically recognized or intrinsically REQUIRE programming.
  468.  
  469. ------------------------- Known Setup Configurations -------------------------
  470.  
  471.    Felix mouse
  472.    Honeywell Mouse (as shipped)
  473.    Keen Mouse (switch in MS mode, provides two buttons)
  474.    Logitech C7 Mouse (serial)
  475.    Logitech C9 Mouse (serial or buss)
  476.    Logitech First Mouse (serial -- model: M-MD15L-9F)
  477.    Logitech MouseMan Cordless Mouse (serial -- model: M-RA12)
  478.    Logitech MouseMan Mouse (buss -- model: M-PD13-9MD)
  479.    Logitech TrackMan Mouse (serial -- models: T-CA1- and T-CA1-9F)
  480.    Microsoft Mouse (serial or Inport buss)
  481.    PS/2 port mice
  482.  
  483.       DEVICE=C:\OS2\POINTDD.SYS
  484.       DEVICE=C:\OS2\RODENT\RODENT.SYS
  485.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  486.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  487.  
  488.    Honeywell Mouse (with jumper J3 cut)
  489.    Keen Mouse (switch in PC mode, provides three buttons)
  490.    Mouse Systems PC Mouse III
  491.  
  492.       DEVICE=C:\OS2\POINTDD.SYS
  493.       DEVICE=C:\OS2\RODENT.SYS COM=# MOUSE=MS
  494.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  495.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  496.  
  497.    CalComp Wiz and 2x00 digitizers
  498.  
  499.       DEVICE=C:\OS2\POINTDD.SYS
  500.       DEVICE=C:\OS2\RODENT.SYS MOUSE=DW
  501.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  502.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  503.  
  504.    CalComp 3300 (and newer) digitizers
  505.  
  506.       DEVICE=C:\OS2\POINTDD.SYS
  507.       DEVICE=C:\OS2\RODENT.SYS MOUSE=D3
  508.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  509.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  510.  
  511.    CalComp 9x00 digitizers
  512.  
  513.       DEVICE=C:\OS2\POINTDD.SYS
  514.       DEVICE=C:\OS2\RODENT.SYS MOUSE=D9
  515.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  516.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  517.  
  518.    Summagraphics digitizers
  519.  
  520.       DEVICE=C:\OS2\POINTDD.SYS
  521.       DEVICE=C:\OS2\RODENT.SYS MOUSE=SG
  522.       DEVICE=C:\OS2\MOUSE.SYS TYPE=RODENT$
  523.       DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  524.  
  525. ----------------------------------- Hints ------------------------------------
  526.  
  527. Absolute pointing device:
  528.  
  529.    When using the Felix mouse, or any other absolute positioning device
  530.    whose maximum resolution is less than the screen dimensions the mouse
  531.    pointer will not traverse every screen point.  For example, on a 640x480
  532.    screen and an absolute device that has 320 points, only every other
  533.    horizontal screen point can be pointed at using the mouse cursor.
  534.    This does not cause a problem for most applications.  However, when
  535.    attempting to size a window it may not be possible to "grab" the
  536.    window's border.  There are two ways to alleviate this problem: first,
  537.    change the default border width using the Scheme Palette and second
  538.    use the window menu to select the "resize" option.  After the window
  539.    has been resized once using the mouse there will be no future
  540.    difficulties unless the screen resolution or the mouse resolution
  541.    is subsequently changed.
  542.  
  543. Button ordering:
  544.  
  545.    When using a digitizer or mouse whose buttons aren't arranged in a good
  546.    default order, use the ORDER option to rearrange the buttons.
  547.  
  548.    If the button order (i.e. right hand vs left hand) option has been
  549.    changed using the Presentation Manager mouse setup options the button
  550.    ordering is not maintained correctly for all sessions, and may even
  551.    reorder the wrong buttons.  Do not use the PM mouse setup option for
  552.    button ordering.  Use the "ORDER=..." option for RODENT.SYS instead.
  553.    This allows button reordering to apply to EVERY session and is
  554.    independent of PM.
  555.  
  556. CalComp DrawingPad
  557.  
  558.    I have seen one occasion that the DrawingPad reversed the vertical
  559.    direction (down became up and vice-versa).  Admittedly, this WAS after
  560.    plugging in the wrong power supply <g> (but operating with the correct
  561.    supply).  Powering down the system and rebooting corrected the problem.
  562.  
  563. Clone mice:
  564.  
  565.    Many of these mice (the Honeywell and Keen mice, for example) emulate
  566.    Microsoft mice and Mouse System's mice.  However, frequently these mice
  567.    have three buttons and when emulating Microsoft mice only allow the
  568.    outermost two buttons to be used.  Sometimes the middle button may
  569.    produce a chord click (the Honeywell mouse, for example) or may simply
  570.    ignore the middle button (the Keen mouse, for example).  RODENT.SYS
  571.    cannot do anything about this situation because that is a mouse hardware
  572.    limitation.  However, when emulating Mouse System's mice all three
  573.    buttons work properly.  This is the recommended mode for such mice.
  574.    This mode can frequently be selected by a slide switch.  The Honeywell
  575.    mouse requires disassembly of the mouse and cutting jumper J3 (see the
  576.    note below about Honeywell mice).
  577.  
  578. COM4 Installation:
  579.  
  580.    There's a problem in VVGA.SYS and VSVGA.SYS that can kill COM4 when you
  581.    enter (or exit) a DOS full-screen session, even if that session isn't
  582.    using that port.  The drivers which handle that screen switching,
  583.    mistakenly think that there's an 8514/A video card also in the system.
  584.    and write to two registers on that card.  Of course, if you really DO
  585.    have an 8514/A or S3-based video card then you CAN'T use COM4 at 0x02E8
  586.    for this very reason.
  587.  
  588.    You can patch VVGA.SYS and VSVGA.SYS to eliminate the problem; look for
  589.    the
  590.  
  591.       MOV DX,4AE8
  592.  
  593.    instruction and NOP out the next two OUT DX,AL instructions which write
  594.    to 0x4AE8 and 0x4AE9 (which map to 0x02E8 and 0x02E9 on most com boards).
  595.  
  596.    This appears to be fixed in the March beta of OS/2 2.1 and in the GA
  597.    release of OS/2 2.1.
  598.  
  599.    Thanks to Jens Schlatter for relaying this information from Bill Hinkle.
  600.  
  601. DOS session support:
  602.  
  603.    All DOS support is provided by the IBM virtual mouse driver VMOUSE.SYS.
  604.    If you do not have DOS support, i.e. your CONFIG.SYS contains the line:
  605.  
  606.       PROTECTONLY=YES
  607.  
  608.    then none of the lines:
  609.  
  610.       DEVICE=...VMOUSE.SYS...
  611.       DEVICE=...VCOM.SYS...
  612.  
  613.    should be included in your CONFIG.SYS file.
  614.  
  615. DOS Virtual Machine support:
  616.  
  617.    When booting a version of DOS in a virtual machine (VMB) then a native
  618.    mouse driver should NOT be used, but instead use the "stub" driver that
  619.    OS/2 provides.  This driver is called MOUSE.COM and is located in the
  620.    OS2\MDOS directory.  It can be loaded in your AUTOEXEC.BAT if you so
  621.    desire.
  622.  
  623. Dual boot or boot manager:
  624.  
  625.    The Logitech type C mice frequently use the MM protocol when in DOS and
  626.    so the option "PROTOCOL=MM" may be necessary.  This allows OS/2 to use the
  627.    same protocol as used under DOS so the mouse won't be lost when switching
  628.    between DOS and OS/2.  In general, if using dual boot or boot manager and
  629.    the mouse uses a particular protocol under DOS the appropriate option may
  630.    need to be used under OS/2 to allow switching without losing the mouse.
  631.    However, under normal circumstances programmable mice such as the Logitech
  632.    type C mice are reset by RODENT.SYS to avoid such problems.  But (see the
  633.    note below for Logitech mice) there are some older type C mice which
  634.    appear to have initialization problems.
  635.  
  636. Felix mouse:
  637.  
  638.    When this mouse is first powered on, it is necessary to move the mouse
  639.    stick to each edge of the mouse for the hardware to correctly recognize
  640.    the range of motion for the mouse stick.  If the mouse stick is moved
  641.    to one side and the cursor stops partway across the screen then this
  642.    resetting action needs to be performed.  The Felix mouse is an absolute
  643.    pointing device which has lower resolution than the screen.  Therefore
  644.    it cannot point to every pixel on the screen.  Normally this is not a
  645.    problem.  See the hints section for more information on how to handle
  646.    this situation.
  647.  
  648. Honeywell mice:
  649.  
  650.    These mice emulate Microsoft mice, but the middle button generates a
  651.    chord click.  However, they can also emulate Mouse System's mice if
  652.    jumper J3 is cut.  This requires disassembly of the mouse.  Please
  653.    call Honeywell at 800/445-6939 to obtain instructions for making this
  654.    modification.  I take no responsibility for any such hardware
  655.    modification.  Please note that any hardware alteration may affect
  656.    your warranty.  Honeywell is releasing a mouse with a slide switch to
  657.    overcome this problem 4Q '93.  Call Honeywell for availability and
  658.    pricing.
  659.  
  660. Hot plugging:
  661.  
  662.    Unplugging the mouse and then plugging it back in while the system
  663.    is active is not supported in this release.  This is normally not
  664.    a problem unless you are using a mouse switcher between multiple
  665.    systems.  However, many protocols have no problem with this because
  666.    they automatically resynchronize.  Usually the mouse must be present
  667.    for the mouse driver to load, however using the "MOUSE=* PROTOCOL=xx"
  668.    options (where xx is the desired protocol may allow OS/2 to be booted
  669.    without the mouse being present.  The mouse must default to the
  670.    specified protocol or must be attached to a computer which sets the
  671.    protocol properly when booted.  PS/2 port mice disable themselves
  672.    when unplugged and replugged so they may not be used in this type of
  673.    application.
  674.  
  675. IBM 8516 Touch Screen
  676.  
  677.    This is not supported.  IBM has a special driver for this device, see
  678.    the OS/2 documentation for installation instructions.
  679.  
  680. IBM PS/2 mice:
  681.  
  682.    Some IBM PS/2 mice with a black roller ball have hardware problems.
  683.    IBM's recommendation for these mice is to replace them with IBM PS/2
  684.    mice with a gray roller ball (or any OTHER mouse for that matter).
  685.  
  686. Keyboard operation of OS/2:
  687.  
  688.    When installing RODENT.SYS, especially if experimenting with different
  689.    features make sure that you have an editor easily accessible from the
  690.    desktop and make sure that you know the various keyboard commands
  691.    needed to navigate the desktop during times that the system is booted
  692.    without mouse support.  Some keyboard commands that are especially
  693.    useful are...
  694.  
  695.       <Alt> + <Tab>
  696.  
  697.          Move to the next window
  698.  
  699.       <Up arrow> or <down arrow>
  700.  
  701.          Use to highlight an object in a window or option in a menu
  702.  
  703.       <Enter>
  704.  
  705.          Use to select the highlighted object
  706.  
  707.       <Alt> + F O
  708.  
  709.          Use to open a file once the system editor (E.EXE) has been started
  710.  
  711.       <Alt> + F S
  712.  
  713.          Use to save a file once altered when using the system editor
  714.  
  715.       <Alt> + <F4>
  716.  
  717.          Use to close a window (for example the system editor)
  718.  
  719.       <Alt> + <Shift> + <Tab>
  720.  
  721.          Use to select the desktop
  722.  
  723.       <Ctrl> + "\"
  724.  
  725.          Use to deselect all objects on the desktop once the desktop has
  726.          been selected
  727.  
  728.       <Shift> + <F10>
  729.  
  730.          Use to pop-up the desktop menu that contains the shutdown option
  731.  
  732.    Note: these last three commands are usually used in order to shutdown
  733.          OS/2 when the mouse is not available.
  734.  
  735. Logitech mice:
  736.  
  737.    There are some older Logitech mice which seem to have initialization
  738.    problems.  These mice typically hang up or completely refuse to
  739.    install.  Using the "UART=..." option and possibly the "MOUSE=C" or the
  740.    "MOUSE=*" and "PROTOCOL=5B" options may help.  If the mouse installs but
  741.    hangs up and unplugging the mouse and then plugging it back in makes the
  742.    mouse come "alive" then try the above options.
  743.  
  744. Microsoft PS/2 mice:
  745.  
  746.    Microsoft PS/2 mice are not fully compatible with IBM PS/2 mice and
  747.    Logitech PS/2 mice.  This causes some difficulties in the interrupt
  748.    handler because the protocol is dependent upon the number of physical
  749.    buttons.  If using any three button PS/2 mouse with the options:
  750.  
  751.       PORT=0060 IRQ=12 MOUSE=* PROTOCOL=PS BUTTONS=2
  752.  
  753.    then the middle button will not be recognized.  However, this problem
  754.    does not exist when using any of:
  755.  
  756.       ...\RODENT.SYS
  757.       ...\RODENT.SYS BUTTONS=2
  758.       ...\RODENT.SYS BUTTONS=3
  759.       ...\RODENT.SYS MOUSE=PS
  760.       ...\RODENT.SYS MOUSE=PS BUTTONS=2
  761.       ...\RODENT.SYS MOUSE=PS BUTTONS=3
  762.  
  763.    because these allow the actual number of physical buttons to be
  764.    determined.  Also, the option:
  765.  
  766.       ...\RODENT.SYS PORT=0060 IRQ=12 MOUSE=* PROTOCOL=PS BUTTONS=3
  767.  
  768.    can be used as well because it correctly specified the number of
  769.    physical buttons.  There are no problems when using two button
  770.    PS/2 mice.
  771.  
  772. Mouse sensitivity:
  773.  
  774.    When the mouse is too sensitive or too slow, use the RESPONSE option
  775.    to change the mouse responsiveness.  Remember that the BAUD and RATE
  776.    options interact with the RESPONSE option.  If the reporting frequency
  777.    is increased then the average distance moved by the mouse between
  778.    reports is smaller.  Since there is a gradual acceleration threshold
  779.    to allow pixel by pixel control at slow speeds this means that the
  780.    mouse must be moved faster before acceleration becomes effective.
  781.    Conversely reducing the reporting frequency will effectively make the
  782.    mouse more "active" because the acceleration threshold is more likely
  783.    to be reached.
  784.  
  785.    If the mouse sensitivity has been changed using the Presentation
  786.    Manager mouse setup options it may be found that the sensitivity in
  787.    other sessions is not appropriate.  Use the "RESPONSE=..." option
  788.    for RODENT.SYS instead.  This allows the mouse sensitivity to apply
  789.    to EVERY session and is independent of PM.  Also the Presentation
  790.    Manager acceleration occurs in addition to the acceleration provided
  791.    by RODENT.SYS.
  792.  
  793. Multiple mice:
  794.  
  795.    While multiple mice may be present in your computer system, only one mouse
  796.    can be used at a time.  The mouse to be used is selected when OS/2 is
  797.    booted and cannot be changed without rebooting OS/2.  When searching for
  798.    a mouse, RODENT.SYS uses the search order:
  799.  
  800.       Inport mice
  801.       Buss mice
  802.       PS/2 mice
  803.       Serial mice
  804.          Logitech type C mice
  805.          Microsoft compatible mice (also Logitech type M, MW, V or VW mice)
  806.          Felix mice
  807.          Mouse System mice                 (MOUSE=MS required)
  808.          CalComp 3300 and newer digitizers (MOUSE=D3 required)
  809.          CalComp 9x00 digitizers           (MOUSE=D9 required)
  810.          CalComp 2x00 and WIZ digitizers   (MOUSE=DW required)
  811.          SummaGraphics digitizers          (MOUSE=SG required)
  812.  
  813.    Therefore Buss mice, Inport mice and PS/2 mice are recognized before
  814.    serial mice.  If you have one of these mice in your system but also
  815.    have a serial mouse attached you can force only serial mice to be
  816.    recognized by using the "MOUSE=S" option.  You can also force a
  817.    particular mouse to be recognized by using the appropriate "MOUSE=xx"
  818.    option.  You can prevent recognition of any mouse by using the "MOUSE=*"
  819.    option with the appropriate "PROTOCOL=xx" option.
  820.  
  821. PS/2 Installation:
  822.  
  823.    Some PS/2 systems will require you to tell the hardware that you have "no 
  824.    mouse" when installing a serial mouse instead of a PS/2 mouse.
  825.  
  826. PS/2 mice:
  827.  
  828.    Some motherboards have incompatible keyboard/mouse controllers.  Normally
  829.    an 8042 chip is used, but some clones have used the 8242.  PS/2 mice will
  830.    not function on such systems.
  831.  
  832. RODENT.SYS not found
  833.  
  834.    Check the drive and path used in your CONFIG.SYS file.
  835.  
  836. RODENT.SYS not installed
  837.  
  838.    Check the options used for RODENT.SYS in your CONFIG.SYS file.
  839.  
  840. Serial port support:
  841.  
  842.    If you are using a serial mouse and only have a single serial port then
  843.    none of the lines:
  844.  
  845.       DEVICE=...COM.SYS...
  846.       DEVICE=...VCOM.SYS...
  847.  
  848.    should be placed in your CONFIG.SYS file.
  849.  
  850. Summagraphics digitizers
  851.  
  852.    This release does not support changing the puck while OS/2 is running.
  853.    Shutdown OS/2, power off the digitizer, change the puck and then reboot
  854.    the system.
  855.  
  856. SummaSketch III
  857.  
  858.    If the SummaSketch III is attached to a PS/2 model 70 and is powered on
  859.    before the model 70 then the model 70 may signal a hardware failure
  860.    during the power on hardware check.  This is a hardware issue and cannot
  861.    be alleviated by RODENT.SYS because the problem occurs before RODENT.SYS
  862.    is loaded into memory.  To alleviate this problem simply power up the
  863.    SummaSketch III after the model 70 has completed its hardware checks.
  864.  
  865. VMOUSE.SYS not installed, but RODENT.SYS and MOUSE.SYS installed
  866.  
  867.    This is frequently due to the failure to specify either the COM option
  868.    or the PORT and IRQ options when using MOUSE=* PROTOCOL=xx.  This
  869.    generally happens when RODENT.SYS installed but the mouse is not
  870.    actually present.  This can happen for mice which cannot be checked
  871.    and when checking is disabled.
  872.  
  873. ---------------------------------- Testing -----------------------------------
  874.  
  875.    After booting OS/2 preliminary testing can be accomplished simply by
  876. moving the mouse and making sure that the mouse cursor follows the movement
  877. of the mouse.  Execute RODENT.EXE to further test this device driver.  This
  878. test program will display a Presentation Manager window.  It will display
  879. the number of buttons as perceived by OS/2 and the mouse resolution as
  880. perceived by OS/2.  Further, if you click the mouse buttons, the associated
  881. OS/2 mouse event is displayed.  The most recent mouse event is flagged by
  882. an asterisk.  If the mouse pointer follows mouse movement correctly and
  883. all buttons operate correctly then you will probably not have any trouble
  884. with the mouse driver.  Other signs of trouble might be consistently missing
  885. mouse events (such as clicks) or events occurring without any associated
  886. physical mouse action.
  887.  
  888.    When evaluating missing or extra events reasonable care should be taken.
  889. It has been observed that occasionally OS/2 will "lose" a mouse click during
  890. rapid mouse activity -- this is related to the fact that OS/2 only maintains
  891. a small mouse event queue to avoid "piling" up an extremely large number of
  892. events.  Sometimes losing a button release has the appearance of additional
  893. clicks if an application auto-repeats while a mouse button is pressed.  The
  894. loss, by OS/2, of mouse events is VERY rare except under very heavy mouse
  895. activity.  However, it appears to be slightly more common when using higher
  896. baud rates because the internal OS/2 queue is more likely to overflow.  This
  897. has been seen using the Logitech radio mouse at 9600 baud.  Also this loss
  898. might not actually be the fault of OS/2, but is occurring in the applications
  899. instead (actually more probable).  Nevertheless, this behavior has sometimes
  900. been seen, both with these mouse drivers AND with the OS/2 mouse drivers.
  901. It has been seen most often using Logitech's radio mouse and Microsoft's PWB
  902. in a full screen session.  Sometimes if this happens when scrolling releasing
  903. the mouse button will not stop the scrolling.  Simply click the mouse button
  904. again to stop scrolling.
  905.  
  906.    This is a low-level mouse driver.  OS/2 handles all of the higher level
  907. functions, including routing mouse events to DOS sessions, OS/2 sessions,
  908. PM sessions, WIN-OS2 sessions and VMB sessions.  OS/2 reports all mouse
  909. events (in the appropriate form) to the currently active session.  Therefore
  910. DOS sessions CAN take advantage of all three buttons.  Since this mouse
  911. driver is not involved in these actions, failure of OS/2 in that manner
  912. is probably not caused by this device driver.
  913.  
  914.    Note: The resolution reported by OS/2 is in "mickeys per centimeter".
  915. Therefore, the dots per inch provided to the device driver is divided by
  916. 2.54 and rounded when reporting to OS/2.  This device driver reports the
  917. closest value possible.  For example, 400 dpi reports as 157 mickeys.
  918. Since the value reported to OS/2 is a fixed point number, the result if
  919. multiplied by 2.54 is only 399 (after rounding) instead of the original 400.
  920.  
  921. ---------------------------------- Options -----------------------------------
  922.  
  923.    BAUD=#
  924.  
  925.       This option allows the baud rate to be specified.  It may be one of
  926.  
  927.          150, 300, 600, 1200, 2400, 4800, 9600 or 19200
  928.  
  929.       All mice do not support all baud rates.  To use the lowest baud rate
  930.       supported by the mouse specify:
  931.  
  932.          BAUD=150
  933.  
  934.       and to use the highest baud rate supported by the mouse specify:
  935.  
  936.          BAUD=19200.
  937.  
  938.       The lowest baud rate which gives good performance should be used to
  939.       reduce system load.  If this option is not specified then it defaults
  940.       to a value determined by the protocol in use.  Each protocol has a
  941.       default baud rate based on the default mouse baud rate.  If a baud
  942.       rate is specified which is not supported by the protocol the highest
  943.       baud rate which is less than the specified baud rate will be used, if
  944.       any, and otherwise the lowest baud rate which is higher than the
  945.       specified baud rate will be used.
  946.  
  947.    BUFFERED
  948.  
  949.       This option enables the FIFO buffer if a 16550 uart is detected.  The
  950.       FIFO buffer is NOT enabled by default because some 16550 uarts do not
  951.       function correctly.  All 16550AFN uarts should function correctly, if
  952.       you have a 16550, 16550A or 16550AF uart then it should be replaced by
  953.       a 16550AFN uart.  RODENT.SYS will function correctly if the uart is
  954.       not replaced, but this option can only be used with a 16550AFN or
  955.       equivalent uart (such as 16c552 or 16c554).
  956.  
  957.    BUTTONS=#
  958.  
  959.       This option indicates the number of buttons to be supported.  Many
  960.       protocols support both 2 button and 3 button mice.  This option may
  961.       be specified as:
  962.  
  963.          BUTTONS=2
  964.          BUTTONS=3
  965.  
  966.       If BUTTONS=3 is specified for a 2 button mouse the mouse driver will
  967.       function normally, but will report to OS/2 that there are two buttons
  968.       if RODENT.SYS can obtain the number of buttons from the mouse and
  969.       will otherwise report to OS/2 that there are three buttons.  However,
  970.       events for the third button will simply never occur.  If BUTTONS=3 is
  971.       specified for a 3 button mouse (the default) then all three buttons
  972.       will be returned to OS/2.  OS/2 treats clicking any two or three)
  973.       mouse buttons together as a "chord" click.  It also handles single or
  974.       double clicks and single click and drag from all three buttons.
  975.  
  976.       If BUTTONS=2 is specified for a 3 button mouse then the mouse driver
  977.       will convert a press of the middle button into a press of both left
  978.       and right buttons.  This means that clicking the middle button is
  979.       equivalent to a "chord" click.  However, if PROTOCOL=MI is specified
  980.       for a three button mouse (the default is PROTOCOL=MP) this cannot be
  981.       done because the Microsoft-compatible 2 button protocol is not aware
  982.       of events for the middle button.  In this case the middle button will
  983.       simply be ignored.  The included PM test program will report the number
  984.       of mouse buttons as seen by OS/2.
  985.  
  986.    COM=#
  987.  
  988.       This option allows the serial port to explicitly specified.  This
  989.       option may be specified as:
  990.  
  991.          COM=1
  992.          COM=2
  993.          COM=3
  994.          COM=4
  995.  
  996.       where 1..4 is one of the standard com ports.  So,
  997.  
  998.          COM=1
  999.  
  1000.       is normally equivalent to:
  1001.  
  1002.          PORT=03f8 IRQ=4
  1003.  
  1004.       If both this option and the PORT option are omitted then the mouse
  1005.       driver will scan COM1..COM4 (in order) to find the mouse.  This
  1006.       procedure works and is reasonably reliable, however it is impossible
  1007.       to completely restore the uart state so automatic scanning could
  1008.       potentially cause problems with other devices attached to serial
  1009.       ports.  This mouse driver will restore more of the serial port state
  1010.       than the IBM mouse drivers.  Specifying either this option or the
  1011.       PORT option also reduces the time required to initialize the mouse
  1012.       driver -- by as much as a couple of seconds.  This option can ONLY
  1013.       be specified for serial mice.  It is recommended that either this
  1014.       option or the PORT and IRQ options be used for all serial mice.
  1015.       When the MOUSE option is used either this option or the PORT and IRQ
  1016.       options may be necessary.
  1017.  
  1018.    DPI=#
  1019.  
  1020.       This option allows the mouse resolution to be specified.  This must
  1021.       be in the range 100..640 (inclusive).  The default is approximately
  1022.       DPI=200 (actually the default is 80 mickeys per centimeter).  Most
  1023.       newer mice are higher resolution (and even some of the older mice).
  1024.       The C9 Logitech Buss Mouse has a resolution of 320 dpi and the newer
  1025.       Logitech mice have a resolution of 400 dpi.  The value used should be
  1026.       the HARDWARE resolution, many DOS mouse drivers allow the resolution
  1027.       to be "set" in the software -- this does not affect the actual mouse
  1028.       events but only their reporting by the DOS mouse driver.  This value
  1029.       is reported to OS/2, but at this time, OS/2 does not appear to make
  1030.       a significant use of the value due to a bug in MOUSE.SYS.  The
  1031.       included test program will report the value as set by RODENT.SYS
  1032.       and as seen by OS/2 (but which is ignored by MOUSE.SYS).
  1033.  
  1034.    IRQ=#
  1035.  
  1036.       This option allows the interrupt number to explicitly specified.  Any
  1037.       interrupt from 2..15 may be used, unlike the IBM drivers which are
  1038.       restricted to interrupts 2..7.  If omitted, the interrupt level to
  1039.       be used will be determined from the port address.  This procedure is
  1040.       only reliable for the standard COM1 and COM2 port addresses 3f8 and
  1041.       2f8.  It may work for COM3 and COM4 (depending on the actual port
  1042.       addresses).  The IBM mouse driver has the same (undocumented) problem,
  1043.       but does not provide a mechanism to specify the interrupt number.
  1044.  
  1045.    MARGIN=#
  1046.  
  1047.       This option allows the margin on an absolute pointing device to be
  1048.       specified.  The default is MARGIN=0 since some digitizer tablets have
  1049.       a hardware margin.  Units are in terms of the device resolution.  Most
  1050.       digitizers are programmed for 1000lpi so MARGIN=500 gives a half inch
  1051.       margin on each side of the tablet.  When the cursor is in the margin
  1052.       area button presses will be recognized and the mouse cursor will move
  1053.       in two dimensions but will be "pegged" to the appropriate side and so
  1054.       will not move in that dimension.  Use of a margin prevents a "cliff"
  1055.       effect.  The hardware margins provided by some devices will ONLY
  1056.       recognize button presses.
  1057.  
  1058.    MOUSE=xx
  1059.  
  1060.       This option allows the mouse type to be specified.  This is useful to
  1061.       reduce the time required to load the mouse driver, or if the mouse
  1062.       used responds correctly but the mouse type cannot be auto-determined.
  1063.       If an mouse type is specified that fails to match the hardware in use
  1064.       then the mouse driver may or may not load, and if loads may fail to
  1065.       operate properly.  This option may be specified as:
  1066.  
  1067.          MOUSE=B
  1068.  
  1069.             Buss mouse, can be two button or three button.  Note that an
  1070.             Inport mouse is NOT the same as a buss mouse.
  1071.  
  1072.             Protocols: BS
  1073.                        default: BS
  1074.  
  1075.             Rate: 30, 60
  1076.                   note: set by hardware jumper
  1077.  
  1078.          MOUSE=C
  1079.  
  1080.             Logitech Mouse System's compatible mouse.  DOS mouse drivers
  1081.             frequently operate this mouse using the MM protocol.  When
  1082.             using dual boot or Boot Manager it may be desirable to use
  1083.             the MM protocol.
  1084.  
  1085.             Protocols: 5B, MM, RE
  1086.                        default: 5B
  1087.                        better:  MM
  1088.  
  1089.             Baud Rate: 1200, 2400, 4800, 9600
  1090.                        default: 1200
  1091.  
  1092.          MOUSE=D3
  1093.  
  1094.             CalComp 3300 and newer digitizers -- this is an "absolute"
  1095.             pointing device.  Each point on the digitizer table corresponds
  1096.             exactly to a point on the screen.  This is similar to "touch"
  1097.             screens in operation.  This feature can be awkward to those not
  1098.             used to it, but may be preferred by those who use a digitizer
  1099.             tablet on a regular basis.  This option is required for these
  1100.             digitizers, they cannot be automagically recognized.
  1101.  
  1102.             Protocols: HA, HR
  1103.                        default: HA
  1104.  
  1105.             Baud Rate: 150, 300, 600, 1200, 2400, 4800, 9600, 19200
  1106.                        default: 9600
  1107.  
  1108.             Note: This type mouse cannot be automagically recognized, so
  1109.                   this parameter is required for such mice.  CalComp has
  1110.                   many different styli and pucks available so the use of
  1111.                   the ORDER option is almost essential.  For the 4-button
  1112.                   puck arranged in a diamond, ORDER=2143 is recommended.
  1113.                   For the styli with a tip and double-action button, the
  1114.                   default of ORDER=123 has the tip has the "left" button.
  1115.                   This is much more subject to personal preference so no
  1116.                   recommendation will be made.  There are many other pucks
  1117.                   available from CalComp and trial and error is the only
  1118.                   guide to the best ordering for those.
  1119.  
  1120.          MOUSE=D9
  1121.  
  1122.             CalComp 9x00 digitizers -- this is an "absolute" pointing device.
  1123.             Each point on the digitizer table corresponds exactly to a point
  1124.             on the screen.  This is similar to "touch" screens in operation.
  1125.             This feature can be awkward to those not used to it, but may be
  1126.             preferred by those who use a digitizer tablet on a regular basis.
  1127.             The 9x00 digitizers are older products which do not support full
  1128.             software initialization.  These tablets MUST be set for 9600
  1129.             baud.  The 9100 model tablets must have the hardware switches
  1130.             configured for format 5.  If reconfigured by other applications
  1131.             the tablet must be reset before this driver will function.  This
  1132.             option is required for these digitizers, they cannot be
  1133.             automagically recognized.
  1134.  
  1135.             Protocols: HA, HR
  1136.                        default: HA
  1137.  
  1138.             Baud Rate: 9600
  1139.                        default: 9600
  1140.  
  1141.             Note: This type mouse cannot be automagically recognized, so
  1142.                   this parameter is required for such mice.  CalComp has
  1143.                   many different styli and pucks available so the use of
  1144.                   the ORDER option is almost essential.
  1145.  
  1146.          MOUSE=DW
  1147.  
  1148.             CalComp WIZ and 2x00 digitizers -- these are "absolute" pointing
  1149.             devices.  Each point on the digitizer table corresponds exactly
  1150.             to a point on the screen.  This is similar to "touch" screens in
  1151.             operation.  This feature can be awkward to those not used to it,
  1152.             but may be preferred by those who use a digitizer tablet on a
  1153.             regular basis.  The WIZ and 2x00 digitizers are older products
  1154.             which do not support full software initialization.  These tablets
  1155.             MUST be set for 9600 baud.  If reconfigured by other applications
  1156.             the tablet must be reset to 9600 baud before this driver will
  1157.             function.  This option is required for these digitizers, they
  1158.             cannot be automagically recognized.
  1159.  
  1160.             Protocols: HA, HR
  1161.                        default: HA
  1162.  
  1163.             Baud Rate: 9600
  1164.                        default: 9600
  1165.  
  1166.             Note: This type mouse cannot be automagically recognized, so
  1167.                   this parameter is required for such mice.  CalComp has
  1168.                   many different styli and pucks available so the use of
  1169.                   the ORDER option is almost essential.  For the 4-button
  1170.                   puck arranged in a row, ORDER=1234 is recommended.
  1171.  
  1172.          MOUSE=FX
  1173.  
  1174.             Altra's Felix mouse.  This is an "absolute" pointing device.
  1175.             Each position of the mouse "handle" corresponds exactly to a
  1176.             point on the screen.
  1177.  
  1178.             Protocols: FA, FR
  1179.                        default: FA
  1180.  
  1181.             Baud Rate: 9600
  1182.                        default: 9600
  1183.  
  1184.             Note: This type of mouse allows different baud rates to be set
  1185.                   but the commands used are inconsistent between different
  1186.                   mice with the same internal version number depending on
  1187.                   the cystal used during manufacture of the mouse.  Since
  1188.                   this mouse can function in "delta" mode only the hardware
  1189.                   default baud rate is allowed because this can be set
  1190.                   consistently.
  1191.  
  1192.          MOUSE=I
  1193.  
  1194.             Inport buss mouse, can be two button or three button.  Note
  1195.             that an Inport mouse is NOT the same as a buss mouse.
  1196.  
  1197.             Protocols: IN
  1198.                        default: IN
  1199.  
  1200.             Rate: 30, 50, 100, 200
  1201.                   default: 100
  1202.  
  1203.          MOUSE=M
  1204.  
  1205.             Microsoft compatible serial 2 button mouse, non-programmable
  1206.  
  1207.             Protocols: MI
  1208.                        default: MI
  1209.  
  1210.             Baud Rate: 1200
  1211.                        default: 1200
  1212.  
  1213.          MOUSE=MS
  1214.  
  1215.             Mouse System's compatible serial 3 button mouse
  1216.  
  1217.             Protocols: 5B
  1218.                        default: 5B
  1219.  
  1220.             Baud Rate: 1200
  1221.                        default: 1200
  1222.  
  1223.             Note: This type mouse cannot be automagically recognized, so
  1224.                   this parameter is required for such mice.
  1225.  
  1226.          MOUSE=MW
  1227.  
  1228.             Logitech's Microsoft/Mouse System compatible serial 2 button
  1229.             mouse
  1230.  
  1231.             Protocols: MI, MP, 5B
  1232.                        default: MP
  1233.  
  1234.             Baud Rate: 1200, 9600
  1235.                        default: 1200
  1236.  
  1237.          MOUSE=PS
  1238.  
  1239.             PS/2 port compatible mouse
  1240.  
  1241.             Protocols: PS
  1242.  
  1243.             Rate: 10, 20, 40, 60, 80, 100, 200
  1244.                   default: 100
  1245.  
  1246.          MOUSE=S
  1247.  
  1248.             This causes RODENT.SYS to only check for serial mice.  Any
  1249.             other mice are ignored.  This could be useful if a buss mouse
  1250.             interface is present, but the mouse itself is not present.
  1251.             This option is supplied because some motherboards and video
  1252.             adapters have a buss or Inport mouse interface built-in which
  1253.             should be ignored.
  1254.  
  1255.          MOUSE=SG
  1256.  
  1257.             Summagraphics digitizers -- this is an "absolute" pointing
  1258.             device.  Each point on the digitizer table corresponds exactly
  1259.             to a point on the screen.  This is similar to "touch" screens
  1260.             in operation.  This feature can be awkward to those not used
  1261.             to it, but may be preferred by those who use a digitizer
  1262.             tablet on a regular basis.  This option is required for these
  1263.             digitizers, they cannot be automagically recognized.
  1264.  
  1265.             Protocols: MA, MM, MR
  1266.                        default: MA
  1267.  
  1268.             Baud Rate: 9600
  1269.                        default: 9600
  1270.  
  1271.             Note: This type mouse cannot be automagically recognized, so
  1272.                   this parameter is required for such mice.  Further, if
  1273.                   the stylus is used then "ORDER=132" is recommended as
  1274.                   well.  If the 16-button puck is used then "ORDER=213" is
  1275.                   recommended.  The default "ORDER=123" is suggested for
  1276.                   the 4-button puck.
  1277.  
  1278.          MOUSE=V
  1279.  
  1280.             Logitech compatible serial 3 button mouse, non-programmable.
  1281.             If the MI protocol is used then the middle mouse button cannot
  1282.             be programmed as a chord.
  1283.  
  1284.             Protocols: MI, MP
  1285.                        default: MP
  1286.  
  1287.             Baud Rate: 1200
  1288.                        default: 1200
  1289.  
  1290.          MOUSE=VW
  1291.  
  1292.             Logitech's Microsoft/Mouse System compatible serial 3 button
  1293.             mouse
  1294.  
  1295.             Protocols: MI, MP, 5B
  1296.                        default: MP
  1297.  
  1298.             Baud Rate: 1200, 9600
  1299.                        default: 1200
  1300.  
  1301.          MOUSE=*
  1302.  
  1303.             Unknown mouse.  This option would be used when the mouse is
  1304.             known to communicate with a given protocol, but the mouse type
  1305.             cannot be recognized and the mouse cannot be programmed.  In
  1306.             all cases, the PROTOCOL=xx and either COM=# or PORT=# IRQ=#
  1307.             must also be present.  This is NOT checked for and failure
  1308.             to provide these options will prevent the mouse from being
  1309.             properly initialized.  In some cases it can also cause the
  1310.             system to lockup requiring a reboot.  If an absolute protocol
  1311.             is in use then the X=# and Y=# options must also be used.
  1312.  
  1313.    ORDER=#
  1314.  
  1315.       This option specifies the button ordering.  The default button ordering
  1316.       is usually adequate for all mice.  However, digitizer pucks tend to be
  1317.       inconsistent between logical button numbering and physical button
  1318.       placement and this option is almost always required for a digitizer.
  1319.       Further, while OS/2 allows the left and right buttons to be swapped
  1320.       for left hand users, it doesn't do so correctly for three button mice
  1321.       and the swapping does not function at all for DOS and OS/2 full screen
  1322.       sessions.  Trailing digits may be omitted if they are in order.  At
  1323.       least one digit must be specified.  This mouse driver supports from 2
  1324.       to 7 physical buttons. Any buttons above button 7 will be ignored.
  1325.       This option may be specified as:
  1326.  
  1327.          ORDER=1234567
  1328.  
  1329.       where each digit is the button to be used for the corresponding button
  1330.       position.  Omitted digit positions which be assigned their position
  1331.       index.  It is an error to specify the same button twice, or to fail to
  1332.       specify a button.  Thus:
  1333.  
  1334.          ORDER=1
  1335.          ORDER=12
  1336.          ORDER=123
  1337.          ORDER=1234
  1338.          ORDER=12345
  1339.          ORDER=123456
  1340.          ORDER=1234567
  1341.  
  1342.       all result in the default button ordering.  But:
  1343.  
  1344.          ORDER=122
  1345.          ORDER=124
  1346.  
  1347.       are both errors.  And:
  1348.  
  1349.          ORDER=7654321
  1350.  
  1351.       reverses the button ordering.  So button 1 will be treated the same as
  1352.       button 7, button 2 the same as button 6, and so on.  The most common
  1353.       button orderings for mice are:
  1354.  
  1355.          ORDER=321
  1356.  
  1357.       which reverses the left and right buttons, leaving the middle button
  1358.       unaffected.  Also:
  1359.  
  1360.          ORDER=132
  1361.  
  1362.       which reverses the middle and right buttons.  Thus OS/2 button 1
  1363.       is physical button 1, OS/2 button 2 is physical button 2 and OS/2
  1364.       button 3 is physical button 3.
  1365.  
  1366.       One useful ordering for some digitizer pucks arranged in a "diamond"
  1367.       ordering is:
  1368.  
  1369.          ORDER=2143
  1370.  
  1371.       For mice, the left mouse button is always physical button 1, the right
  1372.       mouse button always physical button 3 and the middle mouse button (if
  1373.       present) is always physical button 2.
  1374.  
  1375.       The general button assignment strategy for two button mice is...
  1376.  
  1377.          Button 1 -- OS/2 button 1 (left button down)
  1378.          Button 2 -- OS/2 button 1+2 (all buttons down)
  1379.          Button 3 -- OS/2 button 2 (right button down)
  1380.          Button 4 -- OS/2 button 1+2 (all buttons down)
  1381.          Button 5 -- OS/2 button 1+2 (all buttons down)
  1382.          Button 6 -- OS/2 button 1+2 (all buttons down)
  1383.          Button 7 -- OS/2 button 1+2 (all buttons down)
  1384.  
  1385.       Notice that for two button mice no more than 3 buttons can be
  1386.       profitably used for OS/2.  The general button assignment strategy for
  1387.       three button mice is...
  1388.  
  1389.          Button 1 -- OS/2 button 1 (left button down)
  1390.          Button 2 -- OS/2 button 3 (middle button down)
  1391.          Button 3 -- OS/2 button 2 (right button down)
  1392.          Button 4 -- OS/2 button 1+2 chord (left + right buttons down)
  1393.          Button 5 -- OS/2 button 1+3 chord (left + middle buttons down)
  1394.          Button 6 -- OS/2 button 2+3 chord (middle + right buttons down)
  1395.          Button 7 -- OS/2 button 1+2+3 chord (all buttons down)
  1396.  
  1397.       While different chord clicks are generated, OS/2 recognizes all
  1398.       multiple button presses as a chord click so any program that wishes
  1399.       to distinguish between chord clicks must examine the primitive button
  1400.       event messages.
  1401.  
  1402.       Notice that for three button mice no more than 7 buttons can be
  1403.       profitably used for OS/2.  Also, many digitizer pucks have the
  1404.       limitation that only one button can be pressed at a time and there
  1405.       are both mice and digitizer pucks which have buttons hard-wired to
  1406.       generate chord clicks of other buttons and where multiple presses
  1407.       of buttons may result in the appearance of some other button being
  1408.       pressed.  These problems cannot be resolved by this driver, but the
  1409.       ORDER option can allow the best setup for a particular mouse or puck.
  1410.       To obtain the best ordering some experimentation may be necessary.
  1411.  
  1412.    PRESSURE=#
  1413.  
  1414.       This option is only effective for digitizer pens which are pressure
  1415.       sensitive.  This option sets the pressure threshold at which a pen
  1416.       tip recognizes a button press.  The pressure must be in the range of
  1417.       1 to 255 inclusive.  The default, and value recommended by CalComp for
  1418.       their pressure pens is 4.
  1419.  
  1420.    PORT=#
  1421.  
  1422.       This option allows the serial port address to explicitly specified,
  1423.       and may be specified as:
  1424.  
  1425.          PORT=xxxx
  1426.  
  1427.       where "xxxx" is the hex address of the port to be used.  If the COM
  1428.       option is also specified, this option takes precedence.
  1429.  
  1430.       Any serial port which is compatible with the 8250 uart may be used.
  1431.       This mouse driver is not restricted to COM1..COM2, unlike the IBM
  1432.       mouse drivers.  If both this option and the COM option are omitted
  1433.       then the mouse driver will scan COM1..COM4 (in order) to find the
  1434.       mouse.  This procedure works and is reasonably reliable, however it
  1435.       is impossible to completely restore the uart state so automatic
  1436.       scanning could potentially cause problems with other devices attached
  1437.       to serial ports.  This mouse driver will restore more of the serial
  1438.       port state than the IBM mouse drivers.  Specifying this option also
  1439.       reduces the time required to initialize the mouse driver -- by as
  1440.       much as a couple of seconds.
  1441.  
  1442.    PROTOCOL=xx
  1443.  
  1444.       This option allows the communications protocol to be specified.  This
  1445.       is useful to select a non-default protocol and when using the MOUSE=*
  1446.       option.  If the mouse type is known and an unsupported protocol is
  1447.       selected the default protocol for that mouse type will be used.  This
  1448.       option may be specified as:
  1449.  
  1450.          PROTOCOL=3B
  1451.  
  1452.             Three byte binary protocol -- this is an experimental protocol
  1453.             which MAY work with some older mice.  If used then MOUSE=* must
  1454.             also be used.  This protocol will work instead of the 5B protocol
  1455.             but the mouse will "slip".  It also supports either a 2 button
  1456.             or 3 button mouse.  Since this is an experimental protocol, the
  1457.             reward does NOT apply to its use.
  1458.  
  1459.          PROTOCOL=5B
  1460.  
  1461.             Five byte binary protocol.  It is the default for Mouse System's
  1462.             compatible mice.  This protocol supports either a 2 button or 3
  1463.             button mouse.
  1464.  
  1465.          PROTOCOL=BS
  1466.  
  1467.             Buss mouse protocol, supports either 2 or 3 buttons.  This
  1468.             protocol is used for buss mice.  Normally using MOUSE=B is
  1469.             preferred to this option, but MOUSE=* PROTOCOL=BS is allowed.
  1470.  
  1471.          PROTOCOL=FA
  1472.  
  1473.             Felix mouse protocol.  This is an "absolute" protocol, i.e. each
  1474.             position of the mouse corresponds exactly to a point on the
  1475.             screen.
  1476.  
  1477.          PROTOCOL=FR
  1478.  
  1479.             Felix mouse protocol.
  1480.  
  1481.          PROTOCOL=HA
  1482.  
  1483.             CalComp high resolution binary digitizer protocol, supports
  1484.             either the 4 button puck (which may actually have 6 buttons, but
  1485.             two of the buttons are hardware-wired as chords of the remaining
  1486.             buttons) or the 16 button puck.  Pens are also supported, but
  1487.             obtaining a "chord" click can be difficult if the middle button
  1488.             is not programmed to generate a chord.  Pressure pens may also
  1489.             have difficultly generating a double click for the tip.  OS/2
  1490.             only supports three buttons so extra buttons are mapped to chord
  1491.             clicks.  This protocol is normally used with digitizers.  This
  1492.             is an "absolute" protocol, i.e. each position on the digitizer
  1493.             tablet corresponds exactly to a point on the screen.
  1494.  
  1495.          PROTOCOL=HR
  1496.  
  1497.             CalComp high resolution binary digitizer protocol, supports
  1498.             either the 4 button puck (which may actually have 6 buttons, but
  1499.             two of the buttons are hardware-wired as chords of the remaining
  1500.             buttons) or the 16 button puck.  Pens are also supported, but
  1501.             obtaining a "chord" click can be difficult if the middle button
  1502.             is not programmed to generate a chord.  Pressure pens may also
  1503.             have difficultly generating a double click for the tip.  OS/2
  1504.             only supports three buttons so extra buttons are mapped to chord
  1505.             clicks.  This protocol is normally used with digitizers.
  1506.  
  1507.          PROTOCOL=IN
  1508.  
  1509.             Inport buss mouse protocol, supports either 2 or 3 buttons.
  1510.             This protocol is used for Inport buss mice.  Normally using
  1511.             MOUSE=I is preferred to this option, but MOUSE=* PROTOCOL=IN
  1512.             is allowed.
  1513.  
  1514.          PROTOCOL=MA
  1515.  
  1516.             Summagraphics digitizer protocol.  OS/2 only supports three
  1517.             buttons so extra buttons are mapped to chord clicks.  This
  1518.             protocol is normally used with digitizers.  This is an
  1519.             "absolute" protocol, i.e. each position on the digitizer
  1520.             tablet corresponds exactly to a point on the screen.
  1521.  
  1522.          PROTOCOL=MI
  1523.  
  1524.             Microsoft compatible 2 button protocol.  Can be used with a 3
  1525.             button mouse, but completely ignores the middle button.
  1526.  
  1527.          PROTOCOL=MM
  1528.  
  1529.             Mouse System's compatible protocol, supports either 2 or 3
  1530.             buttons.  Also available on Summagraphics digitizer tablets.
  1531.  
  1532.          PROTOCOL=MP
  1533.  
  1534.             Extension to MI protocol which supports either 2 or 3 buttons.
  1535.             If only two buttons are present the MI protocol is more
  1536.             efficient.
  1537.  
  1538.          PROTOCOL=MR
  1539.  
  1540.             Summagraphics digitizer protocol.  OS/2 only supports three
  1541.             buttons so extra buttons are mapped to chord clicks.  This
  1542.             protocol is normally used with digitizers.
  1543.  
  1544.          PROTOCOL=RE
  1545.  
  1546.             Relative Bit Pad One protocol, supports either 2 or 3 buttons.
  1547.  
  1548.          PROTOCOL=PS
  1549.  
  1550.             PS/2 port protocol, supports either 2 or 3 buttons.
  1551.  
  1552.    RATE=#
  1553.  
  1554.       This option allows the reporting rate to be specified for those mice
  1555.       which accept this option (currently only Inport mice and PS/2 mice).
  1556.       It may be one of:
  1557.  
  1558.          10, 20, 30, 40, 50, 60, 80, 100 or 200
  1559.  
  1560.       All mice do not support all reporting rates.  To use the lowest
  1561.       reporting rate supported by the mouse specify:
  1562.  
  1563.          RATE=10
  1564.  
  1565.       and to use the highest reporting rate supported by the mouse specify:
  1566.  
  1567.          RATE=200.
  1568.  
  1569.       The lowest reporting rate which gives good performance should be used
  1570.       to reduce system load.  If this option is not specified then it
  1571.       defaults to a value determined by the protocol in use.  Each protocol
  1572.       has a default reporting rate based on the default mouse reporting rate.
  1573.       If a reporting rate is specified which is not supported by the protocol
  1574.       the highest baud rate which is less than the specified rate will be
  1575.       used, if any, and otherwise the lowest rate which is higher than the
  1576.       specified rate will be used.  For some mice the reporting rate is set
  1577.       via hardware jumper.
  1578.  
  1579.    RESPONSE=#
  1580.  
  1581.       This option specifies a divisor to increase or reduce the mouse
  1582.       responsiveness.  If omitted it defaults to 0.  It may be specified as:
  1583.  
  1584.          RESPONSE=-8
  1585.          RESPONSE=-4
  1586.          RESPONSE=-2
  1587.          RESPONSE=-1
  1588.          RESPONSE=0
  1589.          RESPONSE=1
  1590.          RESPONSE=2
  1591.          RESPONSE=4
  1592.          RESPONSE=8
  1593.  
  1594.       and only these values may be used.  If the value is negative then the
  1595.       responsiveness will be reduced by the given factor, and if positive
  1596.       increased by the given factor.  If zero then there will be no change.
  1597.       Since increasing or decreasing the responsiveness by a factor of one
  1598.       has no effect these values are equivalent to zero.
  1599.  
  1600.       This can be useful for very low or very high resolution mice (some
  1601.       digitizers are 1000 dpi which is FAR too sensitive for most people).
  1602.       Further, if a user has difficultly holding the mouse steady (such as
  1603.       Parkinson's victims) this allows the mouse to ignore small movements.
  1604.       Caution: with this option it is possible to slowly move the mouse
  1605.       without moving the mouse cursor at all.  This effect does NOT happen
  1606.       for RESPONSE=-1 or any non-negative value and would be most noticeable
  1607.       for RESPONSE=-8.  Thus, RESPONSE=-8 would effectively make a 200 dpi
  1608.       mouse into a 25 dpi mouse.  As for the ORDER option, OS/2 DOES provide
  1609.       a mouse sensitivity control, but that control is not effective for DOS
  1610.       or OS/2 full screen sessions and frequently the available range is
  1611.       insufficient.  This option does not have effect on absolute protocols
  1612.       since those protocols map mouse positions directly to screen positions.
  1613.  
  1614.    UART=#
  1615.  
  1616.       This option allows the uart type to be specified.  It may be specified
  1617.       as...
  1618.  
  1619.          UART=8250
  1620.          UART=16450
  1621.          UART=16550
  1622.          UART=16550A
  1623.          UART=16552
  1624.  
  1625.       If this option is omitted, the uart type will be determined by testing
  1626.       the uart.  All uart testing will be skipped if this option is present.
  1627.       This option is provided because some mice are sensitive to testing for
  1628.       the uart type.  This sensitivity is very rare and probably also
  1629.       depends on the design of the serial port.  This option should not be
  1630.       specified unless RODENT.SYS fails to work properly.  The symptoms of
  1631.       the only known occurrence of this problem was that RODENT.SYS would
  1632.       load but the mouse pointer would not move.  If this option is specified
  1633.       then either the COM option or the PORT and IRQ options must also be
  1634.       specified.
  1635.  
  1636.    X=[#..]#
  1637.  
  1638.       This option specifies the active horizontal range for a digitizer
  1639.       tablet.  It may be specified as:
  1640.  
  1641.          X=#
  1642.          X=#..#
  1643.  
  1644.       In the first case, the active range is assumed to be 0..#-1 and in the
  1645.       second case the active range is #1..#2-1.  Thus, X=7500 would result
  1646.       in an active range of 0 to 7499, inclusive.  And X=500..7000 would
  1647.       result in an active range of 500 to 6999, inclusive.  If "..#" is
  1648.       present, spaces may NOT surround "..".  However, spaces MAY surround
  1649.       "=" as in all other options.
  1650.  
  1651.       This option is only necessary when it is not possible to determine
  1652.       the digitizer size automatically or when it is not desired to use the
  1653.       entire digitizer surface as the active mouse area.  This option can be
  1654.       used to create nonsymmetrical margins.  Normally the MARGIN parameter
  1655.       is used to specify symmetrical margins.  The MARGIN value is added to
  1656.       the minimum and subtracted from the maximum horizontal range.  However,
  1657.       if the digitizer tablet's physically active area was X=0..7500 then
  1658.       specifying X=1000..4000 would give a left (or right) margin of 1000
  1659.       and a right (or left) margin of 3500 (some tablets may physically
  1660.       reverse left and right).
  1661.  
  1662.    Y=[#..]#
  1663.  
  1664.       This option specifies the active vertical range for a digitizer
  1665.       tablet.  It may be specified as:
  1666.  
  1667.          Y=#
  1668.          Y=#..#
  1669.  
  1670.       In the first case, the active range is assumed to be 0..#-1 and in the
  1671.       second case the active range is #1..#2-1.  Thus, Y=7500 would result
  1672.       in an active range of 0 to 7499, inclusive.  And Y=500..7000 would
  1673.       result in an active range of 500 to 6999, inclusive.  If "..#" is
  1674.       present, spaces may NOT surround "..".  However, spaces MAY surround
  1675.       "=" as in all other options.
  1676.  
  1677.       This option is only necessary when it is not possible to determine
  1678.       the digitizer size automatically or when it is not desired to use the
  1679.       entire digitizer surface as the active mouse area.  This option can be
  1680.       used to create nonsymmetrical margins.  Normally the MARGIN parameter
  1681.       is used to specify symmetrical margins.  The MARGIN value is added to
  1682.       the minimum and subtracted from the maximum horizontal range.  However,
  1683.       if the digitizer tablet's physically active area was Y=0..7500 then
  1684.       specifying Y=1000..4000 would give a bottom (or top) margin of 1000
  1685.       and a top (or bottom) margin of 3500 (some tablets may physically
  1686.       reverse up and down).
  1687.  
  1688. -------------------------------- Testimonials --------------------------------
  1689.  
  1690. RODENT.SYS (with a Logitech at 400 DPI) is a real pleasure to use.  Due
  1691. to a bad SIMM for the last few days I have gone from 20Megs RAM to 4Megs.
  1692. 2.1 is limping, no, crawling along, but is very visibly more responsive
  1693. than with the IBM driver.  You may quote me. -- Allen Koppelman
  1694.  
  1695. --------------------------------- What's New ---------------------------------
  1696.  
  1697. Release  ..Date..  ..........................Changes..........................
  1698.  
  1699.   1.00   93/07/12  First general availability release.  Support added
  1700.                    for PS/2 mice, Inport mice, Felix mice, Summagraphics
  1701.                    digitizers and CalComp digitizers.  Many new PROTOCOL
  1702.                    options added.  The PORT, IRQ, RESPONSE, ORDER, UART,
  1703.                    RATE, X, Y, MARGIN and PRESSURE options were added.
  1704.                    The COM option was split into the COM and PORT/IRQ
  1705.                    options to allow a consistent format for each option.
  1706.                    The MOUSE=X option was replaced by the MOUSE=* option
  1707.                    to avoid a conflict with the X option.
  1708.  
  1709.                    Initialization error fixed which caused the ordering of
  1710.                    statements in CONFIG.SYS to be important for systems
  1711.                    using Lan Server or NetWare.
  1712.  
  1713.                    Uart testing affected some sensitive mice.  This was
  1714.                    not a bug but caused some sensitive (older) mice to
  1715.                    lock up.  The uart testing was changed to reduce the
  1716.                    chances of this problem and the UART option was added
  1717.                    to assist with these mice by completely avoiding uart
  1718.                    testing.
  1719.  
  1720.   0.90   93/04/07  Beta of initial release with digitizer support disabled.
  1721.  
  1722. -------------------------------- Coming Soon ---------------------------------
  1723.  
  1724.    No explicit plans have been made at this time.  However, some new features
  1725. under consideration are...
  1726.  
  1727.    An installation program (sending in the options you use will facilitate
  1728.    this feature by providing the necessary information)
  1729.  
  1730.    A Presentation Manager program to allow changing options "on the fly"
  1731.  
  1732.    Possible support for more than three mouse buttons to "kick off" a program
  1733.    or for a button to automatically generate a single or double click (these
  1734.    features might require a Presentation Manager program to be active at all
  1735.    times)
  1736.  
  1737.    Support for additional mice
  1738.  
  1739.    Better "hot plug" support
  1740.  
  1741.    However, none of these new features will be possible unless RODENT.SYS is
  1742. used by a sufficient number of people who register their copies.  So PLEASE
  1743. register!  If you have features you would like to see please send in your
  1744. suggestions when you register (or at any time, for that matter).
  1745.  
  1746. ------------------------------------------------------------------------------
  1747.