https://microchip.my.site.com/s/article/MPLAB-X-MCC-plugin--MCC-Core-and-MCC-Harmony-Core-versions-and-compatibility
Aug 17, 2023•Knowledge
rticle Number: 000014642
Title: MPLAB X MCC plugin, MCC Core and MCC Harmony Core versions and compatibility
Article URL: https://microchipsupport.force.com/s/article/MPLAB-X-MCC-plugin--MCC-Core-and-MCC-Harmony-Core-versions-and-compatibility
Question: What is the relation between the MCC (MPLAB Code Configurator) plugin, the MCC Core and MCC Harmony Core versions?
How to resolve potential incompatibilities?
Answer
-
MCC Plugin(MPLAB Code Configurator)
The MCC Plugin is preinstalled starting with MPLAB X v6.05.
Previously, it had to be manually installed from the Plugin repository. The version can be checked through command menu Tools -> Plugins -> Installed tab:
-
MCC Project Configuration
The MCC Core and Harmony Core versions are stored in the .mc3 file (MCC Project Configuration file):
To update MCC Core and Harmony Core versions, the** .mc3 file can be manually edited when the project is closed**.
Is recommended to backup the project before.
-
MCC Core
The MCC plugin is linked to the MCC Core version.
When starting MCC, the current MCC Core version is logged to the console.
The MCC Core is stored in ~/.mcc/cores folder.
-
Harmony Core
-
The Harmony Core links to the MCC Core and provides a GUI(Graphical User Interface) inside MPLAB X IDE.
It is downloaded to the ".mcc" directory (full path ~/.mcc) when the first 32bit MCC Harmony project is created.
-
The Harmony Core requires a compatible MCC Core version.
The** compatible MCC Core version** is defined in the configuration file ~/.mcc/libraries/Harmony3Library_v1.x.x/.meta/main.json: -
The Harmony Core version can be switched from the Content Manager inside the project:
-
Potential issues
A common cause for issues when creating a New 32-bit MCC Harmony Project,
or to launch MCC in an existing 32-bit MCC Harmony project,
is an incompatible combination of the 3 parts (MCC Core, Harmony Core and MCC Project Configuration), either due to wrong settings, **missing updates **or through an incomplete file download. For example, when creating a New 32-bit MCC Harmony project with MCC plugin v5.2.1, MCC Core v5.4.14 and Harmony Core v1.3.1, the following error message will be shown: "Unable to load project: Incompatible with core: Harmony V3 v1.3.1".
Resetting a MPLAB X installation
- Sometimes fixing incompatibilities is difficult, and to start from scratch is a better and faster approach. Reinstalling MPLAB X will not be sufficient to achieve this.
- To completely reset a MPLAB X installation including cached settings and downloaded plugins, follow these steps:
- Close MPLAB X
- Delete MPLAB X v6.10 - User folder. The typical path can be checked at MPLAB X --> Help --> About for exact location.
- Delete MPLAB X v6.10 - Cache folder. The typical path can be checked at MPLAB X --> Help --> About for exact location).
- Delete the .mcc folder located in ~
/.mcc - Restart MPLAB X, do not import settings from an older installation
- Update all plugins to latest versions when prompted. This installs MCC v5.5.7, which is compatible with the Harmony Core version 1.3.2
- Set the path to a new/empty Harmony Framework folder in Tools --> Options --> Plugins