Texas Instruments TMS320C54x, User Manual

Page: 307 / 469

Command File
10-7 Hex Conversion Utility Description
10.3 Command File
A command file is useful if you plan to invoke the utility more than once with
the same input files and options. It is also useful if you want to use the ROMS
and SECTIONS hex conversion utility directives to customize the conversion
process.
Command files are ASCII files that contain one or more of the following:
-
Options and filenames. These are specified in a command file in exactly
the same manner as on the command line.
-
ROMS directive. The ROMS directive defines the physical memory con-
figuration of your system as a list of address-range parameters. (For more
information about the ROMS directive, see Section 10.5,
The ROMS
Directive, on page 10-16.)
-
SECTIONS directive. The SECTIONS directive specifies which sections
from the COFF object file should be selected. (For more information about
the SECTIONS directive, see Section 10.6,
The SECTIONS Directive, on
page 10-22.)
You can also use this directive to identify specific sections that will be
initialized by an on-chip boot loader. (For more information on the on-chip
boot loader, see Section 10.9.3,
Building a Table for an On-Chip Boot
Loader, on page 10-29.)
-
Comments. You can add comments to your command file by using the /*
and */ delimiters. For example:
/* This is a comment */
To invoke the utility and use the options you defined in a command file, enter:
hex500 command_filename
You can also specify other options and files on the command line. For exam-
ple, you could invoke the utility by using both a command file and command
line options:
hex500 firmware.cmd –map firmware.mxp
The order in which these options and file names appear is not important. The
utility reads all input from the command line and all information from the
command file before starting the conversion process. However, if you are
using the –q option,
it must appear as the first option on the command line or
in a command file.
The –q option suppresses the utility’s normal banner and progress informa-
tion.