Install the MPLAB^® Harmony Configurator (MHC)

Before you create a new MPLAB^® Harmony project, you must install the MPLAB Harmony Configurator (MHC) graphical user interface. This GUI enables easy addition and configuration of the Harmony library files needed for your application. It also allows MPLAB X IDE to create a new MPLAB Harmony project.

Instructions for installing the MHC plugin

Create a New MPLAB Harmony Project

1. In the MPLAB X IDE, select File > New Project
   (or click in the toolbar).
2. Select the Microchip Embedded category if it is not already selected.
3. From the Projects list, select MPLAB Harmony Project.
4. Click Next >.

The next window should have the default Harmony Path, Project Location, and Project Path already selected for you. Remember the MPLAB Harmony framework expects to find specific files in specific locations. Do not change these default paths because the project may not build.

1. Set the Harmony installation path.
2. Set the project location.
3. Enter the project name you would like to use.
4. Change the project configuration name or just use default (optional).
5. Select the target device from the drop-down window (Which PIC32 is on my board?).
6. Click Finish.

After you click Finish, your new project will be opened.

Open the MPLAB^® Harmony Configurator by clicking:
Tools ▶ Embedded ▶ MPLAB^® Harmony Configurator

Expand the "Device and Project Configuration" and "PIC32… Device Configuration" menus to see the Device Configuration Register menus.

Expand the DEVCFG1 register menu and change the setting as shown in this graphic.


DEVCFG1:
Watchdog Timer Enable:
FWDTEN = OFF

Click on the MPLAB^® Harmony Clock Configuration tab.

Modify the clock configuration as shown:


System PLL Input Divider:
FPLLIDIV = DIV_2
System PLL Multiplier:
FPLLMULT = MUL_20
System PLL Output Clock Divider:
FPLLODIV = DIV_1



Primary Oscillator Configuration:
POSCMOD = XT
Secondary Oscillator Enable:
FSOSCEN = OFF
Oscillator Selection Bits:
FNOSC = PRIPLL
Peripheral Bus Divider Selection Bits:
FPBDIV = DIV_1

Click on the MPLAB^® Harmony Pin Diagram and MPLAB^® Harmony Pin Table tabs.

Click on the "Flags" button to open the "Pin Flags" window.

Click on the buttons in this window to configure the PIC32 I/O Port pins per the table below.

Note: If a pin has analog capability (default configuration), it must be configured as digital to use as general purpose I/O.