To invoke the hex conversion utility, enter:
| hex2000[options] filename |
| hex2000 | is the command that invokes the hex conversion utility. |
| options |
supplies additional information that controls the hex conversion process. You can use options on the command line or in a command file. Table 12-1 lists the basic options.
|
| filename | names an object file or a command file (for more information, see Section 12.2.2). |
| Option | Alias | Description | See |
|---|---|---|---|
| General Options | |||
| --byte | -byte | Number output locations by bytes rather than by target addressing | -- |
| --entrypoint=addr | -e | Specify the entry point at which to begin execution after boot loading | Table 12-2 |
| --exclude={fname(sname) |
sname} |
-exclude | If the filename (fname) is omitted, all sections matching sname will be excluded. | Section 12.7 |
| --fill=value | -fill | Fill holes with value | Section 12.9.2 |
| --help | -options, -h | Display the syntax for invoking the utility and list available options. If the option is followed by another option or phrase, detailed information about that option or phrase is displayed. For example, to see information about options associated with generating a boot table, use --help boot. | Section 12.2.2 |
| --image | -image | Select image mode | Section 12.9.1 |
| --linkerfill | -linkerfill | Include linker fill sections in images | -- |
| --map=filename | -map | Generate a map file | Section 12.4.2 |
| --memwidth=value | -memwidth | Define the system memory word width (default 16 bits) | Section 12.3.2 |
| --order={LS|MS} | -order | Specify data ordering (endianness) | Section 12.3.4 |
| --outfile=filename | -o | Specify an output filename | Section 12.8 |
| --quiet | -q | Run quietly (when used, it must appear before other options) | Section 12.2.2 |
| --romwidth=value | -romwidth | Specify the ROM device width (default depends on format used). This option is ignored for the TI-TXT, binary, and TI-Tagged formats. | Section 12.3.3 |
| --zero | -zero, -z | Reset the address origin to 0 in image mode | Section 12.9.3 |
| Diagnostic Options | |||
| --diag_error=id | Categorizes the diagnostic identified by id as an error | Section 12.14 | |
| --diag_remark=id | Categorizes the diagnostic identified by id as a remark | Section 12.14 | |
| --diag_suppress=id | Suppresses the diagnostic identified by id | Section 12.14 | |
| --diag_warning=id | Categorizes the diagnostic identified by id as a warning | Section 12.14 | |
| --display_error_number | Displays a diagnostic's identifiers along with its text | Section 12.14 | |
| --issue_remarks | Issues remarks (nonserious warnings) | Section 12.14 | |
| --no_warnings | Suppresses warning diagnostics (errors are still issued) | Section 12.14 | |
| --set_error_limit=count | Sets the error limit to count. The linker abandons linking after this number of errors. (The default is 100.) | Section 12.14 | |
| Boot Options | |||
| --boot | -boot | Convert all sections into bootable form (use instead of a SECTIONS directive) | Table 12-2 |
| --bootorg=addr | -bootorg | Specify the source address of the boot loader table | Table 12-2 |
| --cmac=file | Specify a file containing the CMAC key for use with secure flash boot on TMS320F2838x devices. | Section 12.12 | |
| --gpio8 | -gpio8 | Specify table source as the GP I/O port, 8-bit mode. (Aliased by --can8) | Table 12-2 |
| --gpio16 | -gpio16 | Specify table source as the GP I/O port, 16-bit mode | Table 12-2 |
| --lospcp=value | -lospcp | Specify the initial value for the LOSPCP register | Table 12-2 |
| --sci8 | -sci8 | Specify table source as the SCI-A port, 8-bit mode | Table 12-2 |
| --spi8 | -spi8 | Specify table source as the SPI-A port, 8-bit mode | Table 12-2 |
| --spibrr=value | -spibrr | Specify the initial value for the SPIBRR register | Table 12-2 |
| Output Options | |||
| --array | Select array output format | Section 12.10 | |
| --ascii | -a | Select ASCII-Hex | Section 12.15.1 |
| --binary | -b | Select binary (Must have memory width of 8 bits.) | -- |
| --intel | -i | Select Intel | Section 12.15.2 |
| --motorola=1 | -m1 | Select Motorola-S1 | Section 12.15.3 |
| --motorola=2 | -m2 | Select Motorola-S2 | Section 12.15.3 |
| --motorola=3 | -m3 | Select Motorola-S3 (default -m option) | Section 12.15.3 |
| --tektronix | -x | Select Tektronix (default format when no output option is specified) | Section 12.15.4 |
| --ti_tagged | -t | Select TI-Tagged (Must have memory width of 16 bits.) | Section 12.15.5 |
| --ti_txt | Select TI-Txt (Must have memory width of 8 bits.) | Section 12.15.6 | |
| Load Image Options | |||
| --load_image | Select load image | Section 12.6 | |
| --section_name_prefix=string | Specify the section name prefix for load image object files | Section 12.6 | |