SPRU513Z August 2001 – October 2023 SM320F28335-EP
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 | Section 12.11.3 |
| --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) | Section 12.11.3 |
| --boot_align_sect | Causes boot table records to be aligned to the section alignment. | Section 12.11.3 | |
| --boot_block_size=size | Sets the desired block size for output from the hex conversion utility. The size may be specified as a hex or decimal value. The default size is 65535 (0xFFFF). For C28x targets, the boot block size refers to 16-bit words. | Section 12.11.3 | |
| --bootorg=addr | -bootorg | Specify the source address of the boot loader table | Section 12.11.3 |
| --cmac=file | Specify a file containing the CMAC key for use with secure flash boot on TMS320F2838x devices. | Section 12.12 | |
| --divsel value | -divsel | Specify the initial value for the DIVSEL register. This is valid only if -xintf8/16 is used. If no value specified, uses 2. | Refer to the boot ROM documentation for your device. |
| --gpio8 | -gpio8 | Specify table source as the GP I/O port, 8-bit mode. (This is aliased by --can8.) | Section 12.11.3 |
| --gpio16 | -gpio16 | Specify table source as the GP I/O port, 16-bit mode | Section 12.11.3 |
| --lospcp=value | -lospcp | Specify the initial value for the LOSPCP register | Section 12.11.3 |
| --pllcr value | -pllcr | Specify the initial value for the PLLCR register. This is valid only if -xintf8/16 is used. If no value specified, uses 0. | Refer to the boot ROM documentation for your device. |
| --sci8 | -sci8 | Specify table source as the SCI-A port, 8-bit mode | Section 12.11.3 |
| --spi8 | -spi8 | Specify table source as the SPI-A port, 8-bit mode | Section 12.11.3 |
| --spibrr=value | -spibrr | Specify the initial value for the SPIBRR register | Section 12.11.3 |
| --xintcnf2 value | -xintcnf2 | Specify the initial value for the XINTCNF2 register. This is valid only if -xintf8/xintf16 is used. | Refer to the boot ROM documentation for your device. |
| --xintf8 | -xintf8 | Indicate use of parallel XINTF stream, 8-bit mode. | Refer to the boot ROM documentation for your device. |
| --xintf16 | -xintf16 | Indicate use of parallel XINTF stream, 16-bit mode. | Refer to the boot ROM documentation for your device. |
| --xtiming value | -xtiming | Specify the initial value for the XTIMINGn register. This is valid only if -xintf8/xintf16 is used. | Refer to the boot ROM documentation for your device. |
| 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 if no output option 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 | Output a file with load image object format | Section 12.6 | |
| --load_image:combine_sections =[true|false] | Specify whether sections should be combined. The default is true. | Section 12.6 | |
| --load_image:endian=[big|little] | Specify the object file endianness. If this option is omitted, the endianness of the first file on the command line is used. | Section 12.6 | |
| --load_image:file_type =[relocatable|executable] | Specify a file type other than object files. Object files can be linked with one another, but addresses are lost. Relocatable files contain the address in the sh_addr field of a section. Executable files maintain address bindings and can be directly loaded. | Section 12.6 | |
| --load_image:format=[coff|elf] | Specify the ABI format of the object file. If this option is omitted, the format is determined from the first file on the command line. | Section 12.6 | |
| --load_image:globalize=string | Do not localize the specified symbol. The default can be set with the --load_image:symbol_binding option. | Section 12.6 | |
| --load_image:localize=string | Make the specified symbol local. The default can be set with the --load_image:symbol_binding option. | Section 12.6 | |
| --load_image:machine=[ARM| C2000|C6000|C7X|MSP430|PRU] | Specify the object file machine type. If this option is omitted, the machine type from the first file on the command line is used. | Section 12.6 | |
| --load_image:output_symbols =[true|false] | Specify whether symbols should be output to the file. The default is false. | Section 12.6 | |
| --load_image:section_addresses =[true|false] | Specify whether the load address should be written in the output file. Applies to relocatable files only. The default is true. | Section 12.6 | |
| --load_image:section_prefix =string | Specify a prefix for section names. The default is "image_". | Section 12.6 | |
| --load_image:symbol_binding =[local|global] | Specify the default binding of symbols in the load image. | Section 12.6 | |
The --section_name_prefix option is deprecated and replaced by --load_image:section_prefix. Undocumented --host_image options have been replaced with --load_image options that are similar in many cases.