
This is Roboctl, a suite of communication tools for Robotics controllers.
Author: Jason W. Bacon
Created: Nov 2007
Supported controllers:
    Lego NXT
    Vex

========================================================================
Installation
========================================================================

FreeBSD
-------
Install from ports:
    cd /usr/ports/devel/roboctl[-devel]
    make install

Mac
---
Install from MacPorts:
    port install roboctl[-devel]

Debian-based Linux systems
--------------------------
See the debian-install script.

Other
-----
The requirements should be similar to those for Linux.


========================================================================
General build instructions
========================================================================

To build, run

make depend
make install

The Makefiles default to a PREFIX of /usr/local.  They will expect to
find add-on libraries such as libusb in ${PREFIX}/lib, and headers in
${PREFIX}/include.

If your PREFIX is not /usr/local, run

make PREFIX=your-prefix

Examples:

If you've installed prerequisites from MacPorts:

make PREFIX=/opt/local

If you've installed prerequisites from Fink:

make PREFIX=/sw

========================================================================
Communication ports
========================================================================

Users must have write access to the generic serial, USB or Bluetooth
device(s) to which the controller is connected.

Run "man legoctl", "man vexctl", or "man roboctl" after installing
for more information.

========================================================================
Notes
========================================================================

This software is developed on FreeBSD and Mac OS X.  Porting to other
POSIX platforms with a working libusb should not be difficult.

Please send bug reports and patches to: jwbacon@tds.net

