SPRUI03E June 2015 – January 2023
To invoke the hex conversion utility, enter:
| hex6x [options] filename |
| hex6x | 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 11-1 lists the basic options.
|
| filename | names an object file or a command file (for more information, see Section 11.3.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 address or global symbol at which to begin execution after boot loading | |
| --exclude={fname(sname) | sname} |
-exclude | If the filename (fname) is omitted, all sections matching sname will be excluded. | Section 11.8 |
| --fill=value | -fill | Fill holes with value | Section 11.10.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 11.3.2 |
| --image | -image | Select image mode | Section 11.10.1 |
| --linkerfill | -linkerfill | Include linker fill sections in images | -- |
| --map=filename | -map | Generate a map file | Section 11.5.2 |
| --memwidth=value | -memwidth | Define the system memory word width (default 32 bits) | Section 11.4.2 |
| --order={L|M} | -order | Specify data ordering (endianness) | Section 11.4.4 |
| --outfile=filename | -o | Specify an output filename | Section 11.9 |
| --quiet | -q | Run quietly (when used, it must appear before other options) | Section 11.3.2 |
| --romwidth=value | -romwidth | Specify the ROM device width (default depends on format used). This option is ignored for the TI-TXT and TI-Tagged formats. | Section 11.4.3 |
| --zero | -zero, -z | Reset the address origin to 0 in image mode | Section 11.10.3 |
| Diagnostic Options | |||
| --diag_error=id | Categorizes the diagnostic identified by id as an error | Section 11.13 | |
| --diag_remark=id | Categorizes the diagnostic identified by id as a remark | Section 11.13 | |
| --diag_suppress=id | Suppresses the diagnostic identified by id | Section 11.13 | |
| --diag_warning=id | Categorizes the diagnostic identified by id as a warning | Section 11.13 | |
| --display_error_number | Displays a diagnostic's identifiers along with its text | Section 11.13 | |
| --issue_remarks | Issues remarks (nonserious warnings) | Section 11.13 | |
| --no_warnings | Suppresses warning diagnostics (errors are still issued) | Section 11.13 | |
| --set_error_limit=count | Sets the error limit to count. The linker abandons linking after this number of errors. (The default is 100.) | Section 11.13 | |
| Boot Table Options | |||
| --boot | -boot | Convert all initialized sections into bootable form (use instead of a SECTIONS directive) | |
| --bootorg=addr | -bootorg | Specify origin address of the boot loader table | |
| --bootsection=section | -bootsection | Specify which section contains the boot routine and where it should be placed | |
| Output Options | |||
| --array | Select array output format | Section 11.11 | |
| --ascii | -a | Select ASCII-Hex | Section 11.14.1 |
| --intel | -i | Select Intel | Section 11.14.2 |
| --motorola=1 | -m1 | Select Motorola-S1 | Section 11.14.3 |
| --motorola=2 | -m2 | Select Motorola-S2 | Section 11.14.3 |
| --motorola=3 | -m3 | Select Motorola-S3 (default -m option) | Section 11.14.3 |
| --tektronix | -x | Select Tektronix (default format if no output option specified) | Section 11.14.4 |
| --ti_tagged | -t | Select TI-Tagged (Must have memory width of 16 bits.) | Section 11.14.5 |
| --ti_txt | Select TI-Txt (Must have memory width of 8 bits.) | Section 11.14.6 | |
| Load Image Options | |||
| --load_image | Output a file with load image object format | Section 11.7 | |
| --load_image:combine_sections =[true|false] | Specify whether sections should be combined. The default is true. | Section 11.7 | |
| --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 11.7 | |
| --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 11.7 | |
| --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 11.7 | |
| --load_image:globalize=string | Do not localize the specified symbol. The default can be set with the --load_image:symbol_binding option. | Section 11.7 | |
| --load_image:localize=string | Make the specified symbol local. The default can be set with the --load_image:symbol_binding option. | Section 11.7 | |
| --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 11.7 | |
| --load_image:output_symbols =[true|false] | Specify whether symbols should be output to the file. The default is false. | Section 11.7 | |
| --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 11.7 | |
| --load_image:section_prefix =string | Specify a prefix for section names. The default is "image_". | Section 11.7 | |
| --load_image:symbol_binding =[local|global] | Specify the default binding of symbols in the load image. | Section 11.7 | |
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.