				    SeaIoTst
		    Automated test utility for SeaI/O cards

DESCRIPTION:
    SeaIoTst was written, as a simple test utility for our line 
of digital I/O cards.  It may be operated in either interactive or batch 
mode.  It makes use of a C++ class, SIODevice, which may be trimmed or 
extended by the end user for inclusion in other software products.  The 
SIODevice class is basically a C++ wrapper for the existing SeaI/O API. 

INSTALLATION:
    Ensure that your SeaI/O device has been properly installed in the
computer.  
    
USAGE:
SeaIoTst [ConfigFile]

  Batch Mode:
    If [ConfigFile] is specified on the command line, SeaIoTst will try to
  start up in Batch Processing Mode.  If it cannot find the file, it will
  enter Interactive Mode (see below).
    The Config File is a simple text file with a list of <CR><LF>-
  delimeted commands to be processed in the order they are specified in the
  file.  The commands must all be in the condensed format specified below.
  See the EXAMPLES section for a sample ConfigFile.

  Interactive Mode:
    If no [ConfigFile] is specified on the command line, SeaIoTst will
  automatically start up in Interactive Mode.  A simple menu will be presented
  to the user, specifying a number of single-letter commands which may be used
  to control the SeaI/O adapter.  To invoke one of these commands, the user
  may either enter just the letter representing the command, or specify a full
  condensed-format parameterized command (see below).
    If the single-letter command is used, and that command needs more
  parameters to be specified, the user will be prompted for the extra
  parameter(s).  After entering the appropriate parameters, the command will
  be executed, any relevant output will be displayed on the console, and the
  system will be ready to accept another command (condensed-format or
  otherwise).

CONDENSED FORMAT:
    If, for example, the user wishes to write a value to a port in
interactive mode, there are two ways of going about it.  In the first, Long
Format, the user would press 'w' (for "Write a byte to a port"), followed by
<CR>.  The user would then be prompted for the port to write (for the sake of
argument, let's say it was port 1) and the value to write (again, for the sake
of argument, imagine the desired value is 64).  There is a quicker way of
doing this. 

Instead of pressing the following key sequence:

  w<CR>
  1<CR>
  64<CR>
    
the user may simply enter all the parameters on one line like so:

  w 1 64<CR>


EXAMPLES:
To start SeaIoTst in batch mode, running a command config file named
TestSeq.txt:
  c:\>SeaIoTst TestSeq.txt

The contents of TestSeq.txt may look something like the following:
-------TestSeq.txt-------- (this line would not be in the actual file)
o 0                        # Open port 0
e 2500 15                  # sEt sample interval to 2500, Mode Control Word=15
w 0 24                     # Write the value 24 to port 0
w 1 48                     # Write the value 48 to port 1
r 0                        # Read the value at port 0
r 1                        # Read the value at port 1
s 10 10                    # Scan 10 times with a 10ms interval
-----End TestSeq.txt------ (this line would not be in the actual file)

**************Note*************
that comments in configuration files are not supported at this time;
everything after the # symbols is not meant to go in the actual TestSeq.txt
file.
