
            Raton 1.2
            ---------

            German A. Gonzalez
            bnll4@usa.net
            http://members.xoom.com/bnll4



CONTENTS
--------

        1. Introduction
                1.1 Copyright and Disclaimer
                1.2 The Raton Library

        2. Installing and Removing the Raton Library
                2.1 Installing the Library
                2.2 Universal Font Library (UFL)
                2.3 Bytes and Checksum
                2.5 Removing the Library

        3. Usage
                3.1 Commands
                3.2 Explanation of Keys

        4. Resources and References



1. Introduction
---------------

1.1  Copyright and Disclaimer
-----------------------------
All files in the Raton package are copyrighted(c) by German Gonzalez
unless otherwise noted.

The software contained in this package is provided as free of charge
and therefore contains no warranty of any kind.  Should the Software
prove defective, you and not the author assume the entire cost of any
service and repair.  This disclaimer of warranty constitutes an
essential part of the agreement.


1.2 The Raton Library
---------------------
Raton is a microsoft serial mouse replacement which can be used
in windows 3.11 95 98 and ms-dos, although it's have been test
only with win95 and ms-dos.

PC serial mouse uses tipically DRT and RTS lines for generating
+5V power for microcontroller circuit in the mouse and the hp cable's pins
does not uses those pins then the hp48 is not going to suffer any damage,
however READ THE DISCLAIMER!.



2. Installing and Removing the Raton Library
----------------------------------------------
The Raton library requires at least ~6kb to install and an
auxiliary library called the Universal Font Library (UFL) must be present.


2.1 Installing
--------------
a) send the library to the HP48
b) put a copy of the library on the stack
c) enter the port number to store the library (0-33 GX, 0-2 SX)
d) here is an example of the stack setup so far:

   --------------------------
   4:
   3:
   2:   Library 1238:  Rat...
   1:                      0
   |   |   |   |   |   |   |

e) at this point, press [STO]
f) perform a warmstart with [ON][C] or turn on and off the HP48
g) erase the variable containing the library.  eg. 'RATON10.LIB' PURGE
h) read the next section for the Universal Font Library (UFL)
   requirements


2.2 Universal Font Library (UFL)
--------------------------------
The Raton library requires the UFL to be present.  Read the UFL
documentation from the UFL package (not included) for more information
From the UFL package, one of two libraries must be present.  Either
ufl1.lib or ufl3.lib and not ufl2.lib because the Raton library
requires FNT1.

If you have not installed one of the UFL libraries, install it now:

a) send the library(ufl1.lib or ufl3.lib) to the HP48
b) put a copy of the library on the stack
c) enter the port number to store the library (0-33 GX, 0-2 SX)
d) here is an example of the stack setup so far:

   --------------------------
   4:
   3:
   2:    Library 257: UFL...
   1:                      0
   |   |   |   |   |   |   |

e) at this point, press [STO]
f) perform a warmstart with [ON][C] or turn on and off the HP48
g) erase the variable containing the library.
h) The Raton library is ready for use.


2.3 Bytes and Checksum
----------------------
Bytes: 2798.5
Checksum: # 2704h



2.4  Removing the Library
-------------------------
a) :0: 1238 DETACH
b) :0: 1238 PURGE

Depending on which port number the library was stored, :0: in the
above can be replaced by the appropriate port number.




3. Usage
--------

3.1 Commands
------------

  Raton  - This is the only command pressing down it will appear
           a screen that say "press any key when pc has recognized
           hp as mouse".

           PC toggles the DTR line to identify any mouse connected
           so you have to wait in the first screen to appears
           the desktop (if using win95) to press a key.

           A good way is to wait till the following window appears
           (see window.gif)

       +-------------------------------------------------------------------+
       |      Windows did not detect a mouse attached to the computer      |
       |  !   You can safely attach a serial mouse now.                    |
       |                                                                   |
       |      To attach a mouse to a PS/2 mouse port, you must first turn  |
       |      the computer off.                                            |
       |                                                                   |
       |                                                                   |
       |       Do not show this message in the future.                     |
       |                                                                   |
       |                       +-------------------+                       |
       |                       |        OK         |                       |
       |                       +-------------------+                       |
       +-------------------------------------------------------------------+


           run Raton program then press any key from pc keyboard
           then press any key from hp keyboard.




3.2 Explanation of keys
-----------------------


     [F]     change delta, which is the number to advance certain way
             the range is beetwen 0 and 127 (with 0 it doesnt move at all)

     [MTH]   left button
     [']     left button and drag (use arrow keys to move)

     [PRG]   right button
     [STO]   right button and drag (use arrow keys to move)


     [DROP]  quit

     Move the cursor with the arrow keys





4. Resources and References
---------------------------
HPTools - PC based System RPL and Assembly Language compiler
          ftp://hpcvbbs.external.hp.com/dist/

Jazz - HP48 based System RPL and Assembly Language development tools
BZ 1.2 - Best compressor
       http://www.hut.fi/~mheiskan/

UFL - Universal Font Library
      http://www.engr.uvic.ca/~aschoorl/ufl/

Bnll4 - email: bnll4@usa.net
        www: http://members.xoom.com/bnll4/hp48.htm

