dll(1)								  brickOS Utility							    dll(1)

NAME

       dll - A user-program downloader for the RCX.

SYNOPSIS

       dll [options] command | {file}.lx

DESCRIPTION

       This manual page documents the dll user-program download command.

       dll is a program which is used to download user programs written for brickOS to the RCX.

OPTIONS

       This  program  follows  the  usual GNU command line syntax, with long options starting with two dashes (`-').  The options supported by dll
       are:

       (run with no parms)
	      Show built-in help (summary of options)

       -e, --execute
	      Execute program after download.

       -i{0|1}, --irmode={0|1}
	      Set IR mode (on RCX) to near(0) or far(1)

       -p{1-8}, --program={1-8}
	      Download program to program-slot-number {1-8}

	      NOTE: LegOS supports 8 program slots where the Mindstorms original firmware only supports 5.

       -r{hostaddress}, --rcxaddr={hostaddress}
	      Send to RCX LNP at host address {0-15}.  Default is 0. See also --node={hostaddress}

       -s{srcport}, --srcport={srcport}
	      Send to RCX LNP source port {0-15}

       -t{ttydevice} --tty={ttydevice}
	      Specify serial tty device where IR tower is connected.

	      NOTE: The environment variable RCXTTY may be used in place of -tty

       -v, --verbose
	      Enable verbose output

COMMANDS

       -d{1-8}, --delete={1-8}
	      Delete program from program-slot-number {1-8}

       -n{hostaddress}, --node={hostaddress}
	      Set RCX LNP host address to {0-15}

ENVIRONMENT VARIABLES

       dll will respond to the environment variable RCXTTY.  This should be set to the serial device to which the IR tower is connected.   Use	of
       RCXTTY is equivalent the using the -tty command-line option.

EXAMPLES

       dll is a simple command to use.	The following examples show most of the uses.

       Ex1: download demo/robots.lx to the RCX as program 0.

	  $ dll -tty=/dev/ttyS0 demo/robots.lx
	  $

       NOTE: there is no response from dll(1) on a successful download.  You can, however watch the RCX display during the download and see activ-
       ity.

       Ex2: download the demo/linetrack.lx into program-slot 7. (note we are first setting RCXTTY so we don't have  to	keep  specifying  the  tty
       device each download).

	  $ export RCXTTY=/dev/ttyS1
	  $ dll -p7 demo/linetrack.lx
	  $

       Ex3: download demo/rover.lx but we are leaving the RCX powered off (assume RCXTTY is already set).

	  $ dll -p2 demo/rover.lx
	  error deleting program
	  $

       NOTE: dll first deletes the existing program from the specified program slot and then downloads the new one.  This error indicates that the
       first thing dll tried to do did not succeed.

       We'll leave the experiment of running dll with --verbose set as an exercise for you our	reader...  (This  is  actually	a  combination	of
       progress infromation and debug ouput.)

ERROR MESSAGES

       Unfortunately, there is basically only one dll error message, and it applies to most possible errors, including a disconnected IR tower, an
       RCX that is turned off, an RCX that doesn't have brickOS, and an RCX that has brickOS and is already running  a	program.   So,	check  all
       those things when dll fails.

SEE ALSO

       firmdl3(1)

AUTHOR

       dll was written by: Markus L. Noga.

       Addiitonal Contributor(s): everyone discussing LNP at LUGNET

       This manual page was written by Stephen M Moraco <stephen@debian.org>, for the Debian GNU/Linux system (but may be used by others).

brickOS 							   May	12, 2002							    dll(1)