Open an Existing MPLAB® Harmony v3 Project

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, click here.


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 the MPLAB Harmony Configurator. 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.

The last window will open asking if you want to 'open the default saved state file.' This file is used to save all selections made in the MPLAB Harmony Configurator (MHC) for the project you are opening. Click Open to open this.


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 this folder

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

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

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