5.9.6 .incbin “file”[,skip[,count]]
The .incbin
directive includes
file
verbatim at the current location. The file is
assumed to contain binary data. The search paths used can be specified with the
-I
command-line option (see Assembler Command Line Options). Quotation marks are
required around file
.
The skip
argument skips a number of
bytes from the start of the file. The count
argument
indicates the maximum number of bytes to read. Note that the data is not aligned in any
way, so it is the user's responsibility to make sure that proper alignment is provided both
before and after the .incbin
directive.
When used in an executable section, all bytes are filled on PIC32A devices.