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 configuration of your system as a list of address-range parameters. (See Section 13.5.)
• SECTIONS directive. The hex conversion utility SECTIONS directive specifies which sections from the object file are selected. (See Section 13.6.)
• 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:

hex2000 command_filename

You can also specify other options and files on the command line. For example, you could invoke the utility by using both a command file and command line options:

hex2000 firmware.cmd --map=firmware.mxp

The order in which these options and filenames 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 --help option displays the syntax for invoking the compiler and lists available options. If the --help option is followed by another option or phrase, detailed information about the option or phrase is displayed. For example, to see information about options associated with generating a boot table use --help boot.

The --quiet option suppresses the hex conversion utility's normal banner and progress information.

• Assume that a command file named firmware.cmd contains these lines:

      firmware.out         /* input file  */
      --ti-tagged          /* TI-Tagged   */
      --outfile=firm.lsb   /* output file */
      --outfile=firm.msb   /* output file */

  You can invoke the hex conversion utility by entering:

   hex2000 firmware.cmd

• This example shows how to convert a file called appl.out into eight hex files in Intel format. Each output file is one byte wide and 4K bytes long.

      appl.out          /* input file   */
      --intel           /* Intel format */
      --map=appl.mxp    /* map file     */
      ROMS
      {
         ROW1: origin=0x00000000 len=0x4000 romwidth=8
               files={ appl.u0 appl.u1 app1.u2 appl.u3 }
         ROW2: origin=0x00004000 len=0x4000 romwidth=8
               files={ app1.u4 appl.u5 appl.u6 appl.u7 }
      }
      SECTIONS
      {   .text, .data, .cinit, .sect1, .vectors, .econst:
      }