brickOS for Debian
------------------

To start with brickOS on Debian:

- Utilities, libraries, brickOS kernel and demos have all been installed
  by this package.
- Copy the /usr/share/doc/brickos/examples/demo/ directory contents to
  a directory of your choosing. (If you wish to use c++ copy the files 
  from the demo/c++ subdirectory, instead.)
  NOTE: you may have to uncompress some of the example files.  Simply do 
  a one-time:  gzip -d *.gz  
- Type 'make' in this new directory to compile the demos.
- The utilities are already in your PATH. Set RCXTTY if you use a non-
  standard port for the IR tower.  [example: 'export RCXTTY=/dev/ttyS1']
- Use firmdl3 to download /usr/lib/brickos/brickOS.srec to your RCX.
- Type "dll demo/helloworld.lx" (where demo is the directory in which you
  just made the demos). If all is well, it should be automatically
  relocated and  transmitted to program slot 0. Press the RUN key to 
  run. The program stops automatically.
- Type "dll -p1 demo/rover.lx" to transmit another demo to program slot 1.
  Use the PRGM key to select the desired program. Try RUN.
- NOTE: A 'make realclean' will remove all built files.

- Stop your program with the RUN or ON/OFF key. Programs are preserved over
  ON/OFF now.  Press ON/OFF and PRGM simultaneously to erase brickOS.
  

If things don't quite work, work at it.


For your own projects,

- Make a directory in a location of your choosing (you may wish to make
  a ~/brickOS directory and place your projects below there).
- Copy 'Makefile' from the /usr/share/doc/brickos/examples directory to this
  new directory.
- Put your main routine into myproject.c. (or myproject.C if using C++)
- If you need more source files, add them in the Makefile.
- type "make myproject.lx && dll myproject.lx" to build and then download 
  your new code.

In case anyone is wondering, dll is short for dynamic linker and loader.

For more documentation, look in /usr/share/doc/brickos/ and on the web at 
http://brickos.sourceforge.net/

You can also pose questions, and get good help 
at: http://lugnet.com/robotics/rcx/legos/

------------------------------------------------------------------------
brickOS Copyright (C) 1998-2002 by Markus L. Noga <markus@noga.de>
