Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 User Manual
Product codes
SW006021-1
Utilities
2012 Microchip Technology Inc.
DS52053B-page 309
8.6.1.10
-FORMAT
The -FORMAT option can be used to specify a particular variant of INHX format or
adjust maximum record length. The usage of this option is:
adjust maximum record length. The usage of this option is:
-FORMAT=Type [,Length]
where:
• Type specifies a particular INHX format to generate.
• Length is optional and sets the maximum number of bytes per data record. A
valid length is between 1 and 16, with 16 being the default.
Consider the case of a bootloader trying to download an INHX32 file which fails
because it cannot process the extended address records which are part of the INHX32
standard. You know that this bootloader can only program data addressed within the
range 0 to 64k, and that any data in the HEX file outside of this range can be safely
disregarded. In this case, by generating the HEX file in INHX8M format the operation
might succeed. The HEXMATE option to do this would be -FORMAT=INHX8M.
because it cannot process the extended address records which are part of the INHX32
standard. You know that this bootloader can only program data addressed within the
range 0 to 64k, and that any data in the HEX file outside of this range can be safely
disregarded. In this case, by generating the HEX file in INHX8M format the operation
might succeed. The HEXMATE option to do this would be -FORMAT=INHX8M.
Now consider if the same bootloader also required every data record to contain eight
bytes of data, no more, no less. This is possible by combining the -FORMAT with -FILL
options. Appropriate use of -FILL can ensure that there are no gaps in the data for the
address range being programmed. This will satisfy the minimum data length require-
ment. To set the maximum length of data records to eight bytes, just modify the
previous option to become -FORMAT=INHX8M,8.
bytes of data, no more, no less. This is possible by combining the -FORMAT with -FILL
options. Appropriate use of -FILL can ensure that there are no gaps in the data for the
address range being programmed. This will satisfy the minimum data length require-
ment. To set the maximum length of data records to eight bytes, just modify the
previous option to become -FORMAT=INHX8M,8.
The possible types that are supported by this option are listed in Table 8-10. Note that
INHX032 is not an actual INHX format. Selection of this type generates an INHX32 file
but will also initialize the upper address information to zero. This is a requirement of
some device programmers.
INHX032 is not an actual INHX format. Selection of this type generates an INHX32 file
but will also initialize the upper address information to zero. This is a requirement of
some device programmers.
8.6.1.11
-HELP
Using -HELP will list all HEXMATE options. By entering another HEXMATE option as a
parameter of -HELP will show a detailed help message for the given option. For
example:
parameter of -HELP will show a detailed help message for the given option. For
example:
-HELP=string
will show additional help for the -STRING HEXMATE option.
8.6.1.12
-LOGFILE
The -LOGFILE option saves HEX file statistics to the named file. For example:
-LOGFILE=output.log
will analyze the HEX file that HEXMATE is generating and save a report to a file named
output.log
output.log
.
TABLE 8-10:
INHX TYPES USED IN -FORMAT OPTION
Type
Description
INHX8M
Cannot program addresses beyond 64K
INHX32
Can program addresses beyond 64K with extended linear address records
INHX032
INHX32 with initialization of upper address to zero