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 activity.

       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 information and debug output.)

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).