Texas Instruments TMS320C3 Series, User Manual, Page: 63 / 166

Host Software
LF
4-29 Functional Overview
Host communications object routines
Using the low-level driver routines, the DSK software provides several high-
level routines that allow the loading of programs or data from dsk3a files or
COFF (Common Object File Format), that move binary data from the host to
the DSK, and that initialize the DSK system. These routines assume an active
communications kernel resident on the ’C31 to send and receive packets of
data. See Appendix A of the
TMS320 Floating-Point Assembly Language
Tools User’s Guide for a detailed description of the COFF format.
Load File
LF
Syntax Load_File (char *file, TASK task)
Description The Load_File function performs several tasks depending on the enumerated
TASK given to it. DSK and COFF file formats are distinguished by the exten-
sion of the file. The enumerated TASK list is defined in the file DSK_COFF.H.
An ASCII hexadecimal file format that contains the bootloader header informa-
tion and raw data is also supported. Since the header information defines
where and how long a section is, this file format can be used to either bootload
or load files. This file format is easily converted to ROM files with a user-de-
fined post processor.
TASK Task to perform
LOAD Loads a DSK or COFF file into the DSK target.
BOOT Boots a DSK or COFF file into the DSK target.
FILE2HEX Creates loadable/bootloadable ascii .HEX file.
BOOTHEX Bootloads FILE.HEX into the DSK.
LOADHEX Loads (using kernel) FILE.HEX into the DSK
DSK2COFF Convert DSK file to COFF file.
SLOAD
Loads symbols from the file.
Arguments *file Pointer to the name of the file to load
task Task to perform
Return Value NO_ERR Successful transmission
OPEN_ERR Cannot open file
ACCESS_ERR File not found
INV_COFF_MGC COFF file not created for a TMS320C31
MAX_SECTN More than 64 sections
BAD_OPTN_HDR Incorrect optional COFF header
COM_ERR Communication failure