Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 ユーザーズマニュアル

®

DS52053B-page 304

 2012 Microchip Technology Inc.

HEXMATE

HEXMATE

 is automatically called by the command line driver, xc8. This is primarily to 

merge in HEX files with the output generated by the source files; however, there are 
some xc8 options which directly map to HEXMATE options, and so other functionality 
can be requested without having to run HEXMATE explicitly on the command line. For 
other functionality, the following details the options available when running this 
application.

If HEXMATE is to be run directly, its usage is:

HEXMATE

 [specs,]file1.HEX [[specs,]file2.HEX ... [specs,]fileN.HEX] 

[options]

Where file1.HEX through to fileN.HEX form a list of input Intel HEX files to merge 
using HEXMATE. If only one HEX file is specified, then no merging takes place, but other 
functionality is specified by additional options. Table 8-8 lists the command line options 
that HEXMATE accepts.

The input parameters to HEXMATE are now discussed in greater detail. Note that any 
integral values supplied to the HEXMATE options should be entered as hexadecimal 
values without leading 0x or trailing h characters. Note also that any address fields 
specified in these options are to be entered as byte addresses, unless specified 
otherwise in the -ADDRESSING option.

HEXMATE

-ADDRESSING

Set address fields in all 

HEXMATE

 options to use word 

addressing or other

-BREAK

Break continuous data so that a new record begins at a set 
address

-CK

Calculate and store a checksum value

-FILL

Program unused locations with a known value

-FIND

Search and notify if a particular code sequence is detected

-FIND...,DELETE

Remove the code sequence if it is detected (use with caution)

-FIND...,REPLACE

Replace the code sequence with a new code sequence

-FORMAT

Specify maximum data record length or select INHX variant

-HELP

Show all options or display help message for specific option

-LOGFILE

Save 

HEXMATE

 analysis of output and various results to a file

-O

Specify the name of the output file

-SERIAL

Store a serial number or code sequence at a fixed address

-SIZE

Report the number of bytes of data contained in the resultant 
HEX image.

-STRING

Store an ASCII string at a fixed address

-STRPACK

Store an ASCII string at a fixed address using string packing

-W

Adjust warning sensitivity

+

Prefix to any option to overwrite other data in its address range 
if necessary