RoombaComm: Roomba Control & Communications API, release 0
Copyright (c) 2005   Tod E. Kurt, tod@todbot.com

Quick Start for Java
--------------------
If you have a Roomba Serial Interface built and the 'roombacomm-java.zip'
library, you can quickly try both out by unzipping this file and running 
one of the examples:

% unzip roombacomm-java.zip
% cd roombacomm
% ./run-it.sh roombacomm.SimpleTest /dev/cu.KeySerial1

Assuming you have a serial device called "/dev/cu.KeySerial1", which you 
probably do if you have a Keyspan USA-19HS USB serial adapter.


Quick Start for Processing
--------------------------
If you have a Roomba Serial Interface built and the 'roombacomm-processing.zip'
library, you can quickly try out both by unzipping this file and running
one of the examples:

1. Unzip the 'roombacomm-processing.zip' file inside of Processing's
    'libraries' directory.  This will create a directory called 'roombacomm'.
2. Start Processing (or Restart if already running)
3. Create a New Sketch
3. Choose "Sketch->Import Library->roombacomm" menu item
4. Copy one of the Processing examples in the 'examples' directory of the
    roombacomm library (zipfile)




Compatibility
-------------
This library has only been tested on Mac OS X 10.4, but everything is in place
(particularly the RXTX native libraries) for it to work on Windows and Linux.



Platform-specific Notes
-----------------------
Mac OS X:
---------
If you've never used RXTX before on your Mac OS X box, run the command:

% ./macosx_setup.command

And then shutdown (not just log out) and log back in again.
And read this faq from Processing: http://processing.org/faq/bugs.html#serial
 


(And yes, I know the build, configuration, and release of this library 
is a little goofball, but I wanted to get something out so others can play)

-eof-