4.6 Upgrading MPLABX Projects to MCC v5.6.2

If your application code is currently running MCC v5.5.2, please follow this section to upgrade the application code to MCC v5.6.2.

Version v5.6.2 of MCC introduces a new file structure for managing projects and environments. This updated structure utilizes .yml files and the .mc4 format to store information about MCC components and settings, replacing the previous single .mc3 file approach.

The following steps guide you through creating a new environment for MCC v5.6.2 and upgrading existing projects to use this environment.

1. Install MPLABX IDE v6.25
2. Within MPLABX IDE v6.25, install or update MCC v5.6.2.
   1. Navigate to Tools > Plugins.
      
   2. If MCC is already installed, check the “Updates” tab. If an update is available, install it and restart the IDE.
      
   3. If MCC is not installed, locate it under the “Available Plugins” tab, install it, and restart the IDE.
   4. After restarting, verify that MCC v5.6.2 is active under the “Installed” tab:
      
3. Create a new empty folder for the Harmony MCC environment.
   1. Example: C:\MCC_5_6_2.
      
4. Set the MCC Content Path to the newly created folder in Tools > Options > Plugins > Content.
   
5. Restart the IDE.
6. Use the IDE ribbon to launch the Content Manager.
   
7. Use the Content Manager to install the Harmony dependencies.
   1. Refer to Installing Harmony 3 Dependencies for the suggested versions.
8. Open the existing project to be upgraded in the IDE.
9. Use the IDE ribbon to launch MCC.
   
   1. The below warnings will popup after launching MCC. They are expected, select “Yes” or “OK” to proceed.
      
10. The MCC window will be shown:
    
    Review the configuration settings to ensure all MCC components have been properly converted.
11. Generate the code to reflect the updated versions.
    
12. Test and validate the generated code.
13. To upgrade additional projects, repeat steps 8-12. The MCC environment only needs to be created once.