Create a Prebuilt Project (HEX File) in MPLAB® X IDE

Last modified by Microchip on 2024/06/24 06:33


Because MPLAB® X IDE is project-based, it is not possible to simply import a HEX file as was done in MPLAB 8. However, the same result may be achieved by creating a pre-built project. This will create a project "wrapper" around the HEX file so that it may be used the same way as a HEX file built from within a project. The main difference is that you will be able to program a target without being required to build the project since the HEX file already exists.

While MPLAB X IDE fully supports prebuilt projects, the preferred method to program from a HEX file is to use the MPLAB X IPE application.


Launch New Project Wizard

Launch the New Project Wizard by using one of the following methods:

  • Toolbar: new project icon
  • Keyboard: CTRL + SHIFT + N
  • Menu: File > New Project...


Select Project Type

  • Select Microchip Embedded from the Categories list.
  • Select Prebuilt (Loadable Image) Project from the Projects list.
  • Click Next >
Selecting Prebuilt Project in the New Project Wizard
Click image to enlarge.

Select File, Device, and Tool

  • Click the Browse button, locate, and select the Prebuilt .hex file from your computer.
  • Select your microcontroller from the Device drop drop-down.
  • Finally, select the Hardware Tool you will use to program the microcontroller.
  • Click Next >
Selecting device and hardware tool
Click image to enlarge.

Select Project Name and Folder

  • Select a Project Name for your project.
  • Select the Project Location on your computer.
  • Click Finish>

Once you click Finish the project has been created. It will now be open in the project tree.

Select Project Name and Folder
Click image to enlarge.