----------------------------------------------------------
 RealScan - Real-Mode scancode reader for Elm32x devices.
----------------------------------------------------------

Version 0.96
Copyright (c) 2004 Brent Harris
Free for non-commercial use


---------------
Version History
---------------

Ver 0.90 (10-22-02)
-------------------
 * First public beta release.

Ver 0.92 (12-18-02)
-------------------
 * Fixed a problem in the Elm32x scantool detection routine.
 * Fixed a problem in the GamePad Pro detection routine.
 * Fixed a timing bug which was causing erroneous "Timeout while waiting for
    response from the Elm32x device." errors
 * Gamepad Pro detection is now disabled by default.  Use the /GPP command
    switch to enable it, if needed.

Ver 0.93 (06-04-03)
-------------------
 * Fixed some serious problems in the error handling/reporting routines.
 * Fixed a bug which may cause scancodes to be read improperly.
 * Improved "debug mode".

Ver 0.94 (06-13-03)
-------------------
 * Bugfix: Com port buffer wasn't being cleared before trying to detect the
            ELM32x chip.

Ver 0.95 (07-06-03)
-------------------
 * Bugfix: Elm32x chip detection failed, in previous versions, when using
            an ELM32x V2.0 chip, with echo enabled.

Ver 0.96 (01-03-04)
-------------------
 * Bugfix: Minor display bug when using an LCD character display connected
            to COM2

----------
Disclaimer
----------
The author is not responible for any problems that arise from using this beta
software.  End-Users agree to use the software at their own risk.

--------------------------------
Files included with this release
--------------------------------
REALSCAN.EXE    The code reading/clearing application
README.TXT      Documentation

---------------------
Software Requirements
---------------------
* 8088 processor or later (tested on Athlon XP 1600+, 486SLC-50)
* MSDOS 3.0 or later (tested on DOS 6.22, DOS 7.1)
* 256K memory
* Elm 320/322/323 based OBD-II scantool (tested on ElmScan VPW, [Elm322])
* Mono/CGA/EGA/VGA or SVGA display
   -OR- Matrix Orbital 2041 20X4 serial LCD connected to COM1 or COM2
* AT or PS/2 Keyboard
   -OR- Gravis GamePad Pro connected to the PC Gameport (in GrIP mode)
   -OR- Standard PC Joystick/Gamepad connected to the PC Gameport

------------
Installation
------------
* Make a directory for RealScan (e.g. c:\realscan).
* Unzip RealScan to this directory

-----
Usage
-----
In many cases the program can be run as is (e.g. OBD-II device connected to
 COM1, standard color or mono display.)  For all other configurations command
 switches will need to be specified. 

 REALSCAN [/COM2] [/LCD] [/LCDBAUD=b] [/DEBUG] [/?]
  /COM2       Specifies that the Elm32x device is connected to COM2.  The
               default is COM1.
  /LCD        Show data on a Matrix Orbital 2041 Display.  Default: PC monitor
               The LCD display is assigned to the first unused COM port.
  /LCDBAUD=b  Specifies the transmission rate to the optional optional LCD
               display, in bits per second.
                The following are valid values for b:
                 1200      *1200 baud
                 2400      *2400 baud
                 9600      *9600 baud
                 19200     *19200 baud (default)
  /GPP        Enable input from Gravis Gamepad Pro joystick
  /DEBUG      Logs data received from the Elm32x device to "obd.log".
               Used primarily for debugging purposes.
  /?          Displays the help screen.


-----------
Limitations
-----------
The is no realtime monitoring or logging in this software


------
Issues
------
No known issues at this time.

----------
On the web
----------
http://techworld.dyndns.org


Last updated on Saturday, January 3, 2004.
Copyright (c) 2004, Brent Harris
