14
2.4.8 DN - Download Network
DN
Usage:
DN <-c> <-e> <-i> <-s> <-o offset> <filename>
The DN command downloads code from the network. The DN command handle files which are either S-
record, COFF or ELF formats. The DN command uses Trivial File Transfer Protocol, TFTP, to transfer
files from a network host. This command only works with 100% NE2000 compatible boards.
In general, the type of file to be downloaded and the name of the file must be specified to the DN command.
The -c option indicates a COFF download, the -e option indicates an ELF download, -I option indicates an
image fownload, and the -s indicates an S-record download. The -o option works only in conjunction with
the -s option to indicate and optional offset for S-record download. The filename is passed directly to the
TFTP server and, therefore, must be a valid filename on the server.
If neither of the -c, -e, -i, -s or filename options are specified, then a default filename and filetype will be
used. Default filename and filetype parameters are manipulated using the set and show commands.
The DN command checks the destination address for validity. If the destination is an address below the
defined user space, then an error message is displayed and downloading aborted.
For ELF and COFF files which contain symbolic debug information, the symbol tables are extracted from
the file during download and used by dBUG. Only global symbols are kept in dBUG. The dBUG symbol
table is not cleared prior to downloading, so it is the user’s responsibility to clear the symbol table as
necessary prior to downloading.
If an entry point address is specified in the S-record, COFF or ELF file, the program counter is set
accordingly.
Examples:
To download an S-record file with the name “srec.out”, the command is:
dn -s srec.out
To download a COFF file with the name “coff.out”, the command is:
dn -c coff.out
To download a file using the default filetype with the name “bench.out”, the command is:
dn bench.out
To download a file using the default filename and filetype, the command is:
dn
This command requires proper Network address and parameter setup. Refer to Appendix A for this
procedure. Also refer to “SET” command to setup the base address and the IRQ for the card.