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

Sept. 23, 1991
-----------------------------------------------------------------------------
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 kit supplied provides source for
the generic loader, loader applications interface, libraries for the
TMS320C30 EVM and XDS500, batch files to build a loader for each platform,
documentation and various header and support files.

Files include are listed below:

       main.c          - Loader applications interface
       c30emu.lib      - TMS320C30 XDS500 compatible library
       c30evm.lib      - TMS320C30 EVM compatible library
       bemu.bat        - Batch file to build the TMS320C30 XDS500 loader
       bevm.bat        - Batch file to build the TMS32C30 EVM loader
       x5load.cmd      - XDS500 link command file
       evmload.cmd     - TMS320C30 EVM link command file
       x5load.exe      - Loader for the XDS500
       evmload.exe     - Loader for the TMS320C30 EVM
       readme.lod      - Basic loader information (this file)
       resvct.xxx      - Reset vector files for the loader
       sample.c        - Sample program source
       sample.out      - Sample program output file

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:

       bemu <return>

To build the TMS320C30 EVM loader enter the following:

       bevm <return>

To test the TMS320C30 XDS500 loader enter the following:

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