Loadable Projects, Files and Symbols

Use loadable projects and files to combine projects, combine hex files, combine projects and hex files or replace the project hex file. The HEXMATE application is used to merge project or loaded hex files into one file. For more information on using this application, see the "MPLAB® XC8 C Compiler User’s Guide" (DS50002053) in the docs folder of the installed MPLAB® XC8 C compiler. See also HEXMATE Conflict Report Address Error.

Use loadable symbols to load debug symbols during a production build or program, as when using RTDM with DMCI, Motor Control applications, etc.

Loadable projects or files are useful for creating combined bootloader and application code. See Loadable Projects and Files: Bootloaders.

Table 1: Loadable Combinations

Current Project Loadable Caveat
Existing MPLAB IDE v8
Stand-Alone None
Hex file None
COF/ELF file Can debug, but not build.
An error will be displayed in the Output window.
Prebuilt (Hex) Hex file * No auto checking for overlapping memory areas.
* Can debug, but not build.
* Build button will be disabled.
COF/ELF file
Prebuilt (COF/ELF) Hex file
COF/ELF file

Table 2: Loadable Options

Add Loadable Project(s) Load one or more existing projects into your current project.
When you build your current project, all projects will be built and the hex files will be combined into one. All debug files will be combined as well (COFF or ELF).
Add Loadable File(s) Load one or more existing hex files into your current project.
When you build your current project, the hex file will be combined with the other hex files into one file.
Note: You will no longer be able to debug the project that contains hex file(s). Use Loadable Projects for debugging.
Add Alternate File Load an alternate hex file to be used.
This options provides a post-build step where you may copy or move your project hex file to another location, use a tool such as HEXMATE to merge your file with another hex file, and then load the file back into the IDE.

To set up and use loadables, see:

© 2021 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.