Open an Existing MPLAB® Harmony v3 Project

This tutorial shows instructions with MHC as the GUI tool. MPLAB Harmony v3 is now configurable through MPLAB Code Configurator (MCC). Click here to visit the same tutorial page with instructions using MCC as the GUI tool

This page shows you how to open one of the many demonstration application projects that are included in the MPLAB® Harmony framework.

Before doing this, you'll need to do the following:

If you would rather learn how to create an MPLAB Harmony project from scratch, visit the "Create a New MPLAB® Harmony v3 Project" page.


In the MPLAB X IDE, select File > Open Project.



Demonstration applications come with most of the libraries. These can be found in each library's apps folder. Browse to the firmware folder (as shown below) to find all evaluation boards that support the application. Select your evaluation board and click Open Project.



After the project opens, start MHC. In the MPLAB X IDE, select Tools > Embedded > MPLAB® Harmony 3 Configurator.



Select the path to the folder containing the MPLAB Harmony framework and click Launch.



The Configuration Database Setup window opens. You shouldn't have to change anything in this window. Click Launch.

Please be patient while waiting for the last window to open. It will ask if you want to open the default saved state file. This file is used to save all selections made in MHC for the project you are opening. Click Open.

You can now use the MPLAB Harmony Configurator. Please see the MHC Wiki for instructions on how to use it.


Note: You can save or load an MHC configuration at any time. The default name of the MHC state file is:
<MPLAB X project configuration name>.xml

  • It can be found in the following folder:

…\<project name>\firmware\src\config\<project configuration name>\.

  • If you are not using MPLAB X Project Configurations, the MHC state file can be found in the following folder:

…\<project name>\firmware\src\config\default\default.xml

© 2024 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.