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