Module 4: Creating and Building a New Project With MPLAB® Code Configurator (MCC) Harmony

Select File > Close Folder to close the current project.

Click the Manage gear button and then hover over Profile (name). To the right, you should see a list of existing profiles and, at the bottom, a link to the Profiles window. Click this link.

In the Profiles window, click on New Profile. The new profile will be named "Untitled 1". On the right, change the Name to "mcc-harmony". Then view the options below and determine if you want to make any selections. Finally, close and save the changes.

Return to Module 2 to install MPLAB for VS Code^® extensions for this profile.

Click on the Explorer icon  on the Activity bar.

When no project is open in VS Code, you will see buttons under Explorer. Click on Create MPLAB Project.

Other options to create an MPLAB X IDE project are:

• In the Command Palette (Ctrl + Shift + P), enter MPLAB:Create Project
• In the Command Palette (Ctrl + Shift + P), enter MPLAB: Welcome to open the Get Started with MPLAB walkthrough tab. Then under Welcome, click on Create or Import MPLAB Project and in the drop-down, click on Create New Project.

Give the project a name. Select a name that will identify the project, for example, "pic32cm-mc00-cnano-flash-led" instead of "Project1".

Select the Project Location. Choose the default location for this example.

Choose a device. For the PIC32CM MC00 Curiosity Nano board, the project device is the PIC32CM1216MC00032.

Select the Project Type. Application is the most common and will be used in this example.

Select the compiler. Choose the latest version of the MPLAB XC32 C/C++ Compiler.

In the Command Palette (Ctrl + Shift + P), enter MPLAB MCC: Launch.

Then, use the Quick Pick UI to complete the MCC setup:

MCC Harmony interface will open for developing the project configuration.

Begin by clicking on Device Resource to display this section.

Look in the MCC Harmony Libraries for a timer peripheral. For the project device, this would be a timer/counter (TC).

Click on the help button  for TC0 to open documentation that explains how to set up the TC.

In the MPLAB Harmony Peripheral Libraries documentation:

Under the "Basic Timer/Counter" section, see the different operating modes available. Notice that there are also code examples for each.

Timer Mode will be used with the callback method so as not to have to poll continuously.

Click on the (+) next to TC0 to add it to the Project Graph. Then click on Expand All to see all the TC0 options.

The current timer is 1 ms. To get to 100 ms, a prescaler of GCLK_TC/256 will be used. Ensure that Enable Timer Period Interrupt is selected. Then click the Generate button .

View the project for added content.

Under config.mcc > src > config/default > peripheral, related peripherals are now added.

In the config.mcc > src directory, a new main file generated by Harmony has been added.

Note that Harmony does not automatically delete previous main files. The original main file does not have any content that needs to be moved to the new file, so this file can be deleted.

Click on the new main file to open it in an editor window.

Return to the timer/counter documentation. If you closed it, click on the (?) for TC0 to open it again. Under the "Basic Timer/Counter (TC)" section, find the example code for the Callback method and copy it.

In the editor window, select the code for the main() function, int main (void), and replace it with what you copied. The copied code is for TC3, not TC0, so change it by selecting Edit > Replace and Replace All.

Go to the "PIC32CM MC00 Curiosity Nano Evaluation Kit" webpage. In the "Documentation" section, click on the "PIC32CM MC00 Curiosity Nano Users Guide" to download it.

Go to the "Schematics" section of the document. Find the pin associated with the User LED.

Now set up the pin for LED0 by selecting Plugins > Pin Configuration.

In the Harmony Configurators window under Pin Settings, find pin PA23. Select the Function as GPIO and the Direction as Out.

You can also enter a Custom Name (but don't use spaces). This name will be used to generate pin macros in plib-port.h.

For this example, the name LED was used. But if User_LED was used, it would produce #define User_LED_Toggle().

Close the window and then click the Generate button .

Now the editor no longer marks LED_Toggle() as an error.

Ensure that the PIC32CM MC00 Curiosity Nano board is connected to the PC via a USB cable. See Module 2 for details.

In the Command Palette (Ctrl + Shift + P), enter "MPLAB CMake: Build" or click the build hammer icon . If you want details on the CMake Runner, in the Command Palette enter "Preferences: Open Settings (UI)".