Combining Projects in the MPLAB® X IDE

Last modified by Microchip on 2023/11/09 09:12

For the current project, open its project properties (File > Project Properties) and click on Loading.

Step-by-Step

Add Loadable Project

Click Add Loadable Project to open the Add Loadable Project dialog. Browse to a project and select it.

Find and select a project
Click image to enlarge.

Back to Top


Select Configuration

Under Configurations select a build configuration to use for this project. If you have not added different configurations to this project, you will only see default.

Back to Top


Select Storage Option

Under Store path as select how to store information about the path to the loadable project. Choose from:

  • Auto – allow MPLAB® IDE to determine whether the loadable project path should be relative or absolute based upon its location. If the main project directory contains the loadable project, the reference is a relative path. Otherwise, the reference is an absolute path.
  • Relative – reference the loadable project with a relative (to the main project) path. This is the preferred way to add paths.
  • Absolute – reference the loadable project with an absolute path. There are cases when this mode is useful, but these paths often require correction when a project is moved from one system to another.

Back to Top


Close Add Loadable Project

Click Add to close the Add Loadable Project dialog and add one project to another.

Back to Top


Specify Loadable Build Options

In the Project Properties window, ensure the Include checkbox is checked if you want to build the added project when you build the current project.

If you have added more than one project, the order shown here will determine the order in which the hex files will be added to the current project’s hex file. Use Up and Down to change the order.

Projects selected to build
Click image to enlarge.

Back to Top


Apply Loadable Selections

Click Apply or OK to accept the changes.

The next time you build the current project, the projects listed here will also be built (if “Include” is checked) and their hex files will be combined with the current project’s hex file to create a single output hex file. Any debug files will also be combined.

Back to Top