rcxutil Readme
--------------

The rcxutil package is actually four separate utility programs:

rcxdis - a simple disassembler that will produce a listing from an RCX
file. This listing is identical to that produced from nqcc.

rcxdl - downloads an RCX file to the RCX.  This procedure is identical
to the built in download feature of nqcc.  The RCX_PORT environment
varaible can be used to specify a serial port other than the default
(COM1 for PC, modem port for mac).  Its value should be the port name
(the mac printer port's name is "b").

rcxfirm - downloads a firmware file (in S-Record format) to the RCX.
Just type "rcxfirm <filename>" to download the file.  You'll need to
supply appropriate firmware yourself (it can be found on the Mindstorms
CD).

rcxlog - upload a datalog from the RCX to your host computer.

Send bug reports and/or suggestions to dbaum@enteract.com.


version 1.0 b4
--------------

rcxfirm - better error messages

rcxdl - During download, the program detects a missing (or off) RCX much faster.

rcxdi - Prior to download, any running tasks are stopped on the RCX.  This prevents
problems associated with downloading new code that overwrites the running
code (thus halting the RCX interpreter).


version 1.0 b3
--------------

Adaptive timeouts added.

rcxlog added.

All commands return -1 to shell on error.

Verbose mode turned off for rcxdl (this was a bug introduced in 1.0 b2).

The -r options was added to rcxdl - it causes a program to start running immediately
after download.

An error is reported in rcxdl if download fails due to insufficient free memory in
the target.



version 1.0 b2
--------------

rcxfirm (a tool to download firmware) was added to the set of supported
utilities.

Retry algorithm was adjusted for improved reliability.

CyberMaster mode (-c) was added to rcxdl.  This allows programs to be
downloaded to a CyberMaster.  Due to hardware limitations, this option
does not work on a Macintosh.


verison 1.0 b1
--------------

Macintosh version now runs on 68K macs.

rcxdl uses a simple retry algorithm for communicating with the RCX.

Minor bug fixes to disassembly listing from rcxdis.



version 0.1 b1
--------------

initial version
