-----------------------------------------------------------------------------
TMS320C30 COFF LOADER FOR C30EVM AND XDS500

May 7, 1992
-----------------------------------------------------------------------------
Texas Instruments Incorporated
-----------------------------------------------------------------------------

This document describes how to build a COFF loader that can operate with the
TMS320C30 EVM and XDS500 using the emulation interface.

The software supplied has been built and tested on an IBM PC/AT compatible
machine with DOS 3.3 using the Microsoft 5.1 C compiler tools.  The software
may work in other environments and with other compiler tools but is not
guaranteed or supported.  The loader software is provided on the XDS500 and
EVM debugger product disks.

Files include are listed below:

Generic Files (both disks)
       ld_main.c       - Loader applications interface
       readme.lod      - Basic loader information (this file)

XDS500 Disk:
       dbload.lib      - TMS320C30 XDS500 compatible library
       dbmake.bat      - Batch file to build the TMS320C30 XDS500 loader
       dbload.lnk      - XDS500 link command file
       dbload.exe      - Loader for the XDS500

C30EVM Disk:
       evmload.lib     - TMS320C30 EVM compatible library
       evmmake.bat     - Batch file to build the TMS320C30 EVM loader
       evmload.lnk     - C30 EVM link command file
       evmload.exe     - Loader for the TMS320C30 EVM

The two libraries supplied provide all the necessary emulation interface
functions required to support a loader.  The application of the functions is
shown in the file main.c.  Using these functions in a manner other than
shown in main.c may result in erroneous behavior.   Again the libraries were
compiled and built using the Microsoft 5.1 C compiler tools with the large
model and 286 mode.  The libraries require and Intel 286, 386 or 486
processor.  The Intel 8088, and 8086 are not supported.

To build the loaders create a directory and copy all the files from the
diskette to a directory on your hard disk.  Go to the directory on the hard
disk that contains the loader files.

To build the TMS320C30 XDS500 loader enter the following:

       dbmake <return>

To build the TMS320C30 EVM loader enter the following:

       evmmake <return>

To test the TMS320C30 XDS500 loader enter the following:

       dbload -p 220 -n sample <return>

This assumes that the XDS500 is located at PC I/O address 0x220 and that the
emulator is connected to a functional target.  The -n switch will keep the
loader from running the code.  To see if the code really did get loaded get
into the debugger (db30) and do a symbol load on sample (sload sample).  You
should be able to execute the sample program from this point.  The same
test can be run on the TMS320C30 EVM using the EVM version of the loader.

The files resvct.xxx (where xxx is the revision) must be in the current
directory or in the directory pointed to by the D_OPTIONS environment
variable.  See the TMS320C30 C Source Debugger User's Guide for details on
setting this environment variable.
