User manual

Utilities
 2012 Microchip Technology Inc. DS52053B-page 307
8.6.1.6 -FILL
The -FILL option is used for filling unused memory locations with a known value. The
usage of this option is:
-FILL=[const_width:]fill_expr[@address[:end_address]]
where:
• const_width has the form wn and signifies the width (n bytes) of each constant
in fill_expr. If const_width is not specified, the default value is the native
width of the architecture. That is, -
FILL=w1:1 with fill every byte with the value
0x01.
• fill_expr can use the syntax (where const and increment are n-byte
constants):
- const fill memory with a repeating constant; i.e., -
FILL=0xBEEF becomes
0xBEEF, 0xBEEF, 0xBEEF, 0xBEEF
- const+=increment fill memory with an incrementing constant; i.e.,
-
FILL=0xBEEF+=1 becomes 0xBEEF, 0xBEF0, 0xBEF1, 0xBEF2
- const-=increment fill memory with a decrementing constant; i.e.,
-
FILL=0xBEEF-=0x10 becomes 0xBEEF, 0xBEDF, 0xBECF, 0xBEBF
- const,const,...,const fill memory with a list of repeating constants; i.e.,
-
FILL=0xDEAD,0xBEEF becomes 0xDEAD,0xBEEF,0xDEAD,0xBEEF
• The options following fill_expr result in the following behavior:
- @address fill a specific address with fill_expr; i.e.,
-
FILL=0xBEEF@0x1000 puts 0xBEEF at address 1000h
- @address:end_address fill a range of memory with fill_expr; i.e.,
-
FILL=0xBEEF@0:0xFF puts 0xBEEF in unused addresses between 0 and
255
All constants can be expressed in (unsigned) binary, octal, decimal or hexadecimal, as
per normal C syntax, for example, 1234 is a decimal value, 0xFF00 is hexadecimal and
FF00 is illegal.
8.6.1.7 -FIND
This option is used to detect and log occurrences of an opcode or partial code
sequence. The usage of this option is:
-FIND=Findcode [mMask]@Start-End [/Align][w][t”Title”]
where:
• Findcode is the hexadecimal code sequence to search for and is entered in little
endian byte order.
• Mask is optional. It specifies a bit mask applied over the Findcode value to allow
a less restrictive search. It is entered in little endian byte order.
• Start and End limit the address range to search.
• Align is optional. It specifies that a code sequence can only match if it begins on
an address which is a multiple of this value.
• w, if present, will cause HEXMATE to issue a warning whenever the code sequence
is detected.
• Title is optional. It allows a title to be given to this code sequence. Defining a
title will make log-reports and messages more descriptive and more readable. A
title will not affect the actual search results.