Installing MPLAB® Harmony v2

Choose your operating system from the tabs below:

1

Run Installer

WinInstall.png
Go to the location where you downloaded the installer. Unzip the downloaded file and run the installer:
harmony_vX_XX_windowsinstall-ier.exe.

Depending on your Windows security settings, you may get a window asking if you are sure you want to run this program. AnswerYes.

2

Setup

ClickNext >.

Install-01.png
Click image to enlarge.

3

Accept License Agreement

If you concur, select "I accept the agreement" and clickNext >.

Install-02.png
Click image to enlarge.

4

Select Installation Location

If you wish to choose an installation location other than the default, you may do so here.
ClickNext >.

Install-03.png
Click image to enlarge.

5

Choose Modules to Install

In some instances you may only want to install modules from the MPLAB® Harmony framework that you plan to use. If this is the case, uncheck any module you do not want to install. This will only save space on your PC. Unused modules willNOT be compiled into your application.
ClickNext >.

Install-04.png
Click image to enlarge.

6

Begin Installation

ClickNext >.

Install-05.png
Click image to enlarge.

7

Wait for Installation to Finish

Install-06.png
Click image to enlarge.

8

Finish Part 1 of Installation

Leave the "View Readme File" box checked - it will provide critical instructions to complete the installation.
ClickFinish.

Install-07.png
Click image to enlarge.

9

View Readme File for Further Instructions

The readme file briefly describes the need to install two plugins within MPLAB X IDE to use MPLAB Harmony effectively. The instructions are provided in detail in the steps below.

Install-08.png
Click image to enlarge.

10

Open the MPLAB X IDE Plugin Manager

  1. Run MPLAB X IDE and open theplugin manager by selecting from the main menu:
    Tools ▶ Plugins
  2. Select theDownloaded tab
  3. Click theAdd Plugins… button on the upper left.
Install-09.png
Click image to enlarge.

11

Load the MPLAB Harmony Help Plugin

Install-10b.png
Navigate to the following directory:
C:\microchip\harmony\vX_XX\doc
(whereX.XX represents the version number)
Select the file:
org-microchip-harmony_help.nbm

ClickOpen.
Install-10a.png
Click image to enlarge.

12

Add the Next Plugin

Click theAdd Plugins… button on the upper left.

Install-11.png
Click image to enlarge.

13

Load the MPLAB Harmony Configurator Plugin

Install-11b.png
Navigate to the following directory:
C:\microchip\harmony\vX_XX\utilities\configurator
(whereX.XX represents the version number)
Select the file:
com-microchip-harmonyconfigurator.nbm

ClickOpen.
Install-11a.png
Click image to enlarge.

14

Install the Plugins

Click theInstall button at the bottom left of the plugin manager window.

Install-12.png
Click image to enlarge.

15

Plugin Installer

ClickNext >.

Install-13.png
Click image to enlarge.

16

Accept the License Agreement

If you concur, check the box next to "I accept the terms in all of the license agreements".

ClickNext >.

Install-14.png
Click image to enlarge.

17

Dismiss Security Warning

Although the plugins were created and provided by Microchip, they have not been digitally signed. This will trigger a security warning in Windows.

ClickContinue.

Install-15.png
Click image to enlarge.

18

Plugin Installation Complete

ClickFinish.

Install-16.png
Click image to enlarge.

19

Verify Installation

If you wish to verify the installation of the plugins, select theInstalled tab. You should see the following two plugins somewhere in the list:

  • MPLAB Harmony Help
  • MPLAB Harmony Configurator


ClickClose when done.

Install-17.png
Click image to enlarge.

1

Run Installer

You may need to make the file executable. In a terminal, go to the directory where you downloaded the installer and run the command:

chmod u+x harmony_vX_XX_linuxinstall-ier.run


Then, run the installer (If you plan to install it outside of your home directory, run asroot or usingsudo):

./harmony_vX_XX_linuxinstall-ier.run

2

Setup

ClickNext >.

Install-01.png
Click image to enlarge.

3

Accept License Agreement

If you concur, select "I accept the agreement" and clickNext >.

Install-02.png
Click image to enlarge.

4

Select Installation Location

If you wish to choose an installation location other than the default, you may do so here. Note that you cannot install outside of your home directory unless you have write permissions or run the installer as root or by usingsudo.
ClickNext >.

Install-03.png
Click image to enlarge.

5

Choose Modules to Install

In some instances you may only want to install modules from the MPLAB® Harmony framework that you plan to use. If this is the case, uncheck any module you do not want to install. This will only save space on your PC. Unused modules willNOT be compiled into your application.
ClickNext >.

Install-04.png
Click image to enlarge.

6

Begin Installation

ClickNext >.

Install-05.png
Click image to enlarge.

7

Wait for Installation to Finish

Install-06.png
Click image to enlarge.

8

Finish Part 1 of Installation

Leave the "View Readme File" box checked - it will provide critical instructions to complete the installation.
ClickFinish.

Install-07.png
Click image to enlarge.

9

View Readme File for Further Instructions

The readme file briefly describes the need to install two plugins within MPLAB X IDE to use MPLAB Harmony effectively. The instructions are provided in detail in the steps below.

Install-08.png
Click image to enlarge.

10

Open the MPLAB X IDE Plugin Manager

  1. Run MPLAB X IDE and open theplugin manager by selecting from the main menu:
    Tools ▶ Plugins
  2. Select theDownloaded tab
  3. Click theAdd Plugins… button on the upper left.
Install-09.png
Click image to enlarge.

11

Load the MPLAB Harmony Help Plugin

Install-10b.png
Navigate to the following directory:
/home/user/microchip/harmony/vX_XX/doc
(whereX.XX represents the version number)
Select the file:
org-microchip-harmony_help.nbm

ClickOpen.
Install-10a.png
Click image to enlarge.

12

Add the Next Plugin

Click theAdd Plugins… button on the upper left.

Install-11.png
Click image to enlarge.

13

Load the MPLAB Harmony Configurator Plugin

Install-11b.png
Navigate to the following directory:
/home/user/microchip/harmony/vX_XX/utilities/configurator
(whereX.XX represents the version number)
Select the file:
com-microchip-harmonyconfigurator.nbm

ClickOpen.
Install-11a.png
Click image to enlarge.

14

Install the Plugins

Click theInstall button at the bottom left of the plugin manager window.

Install-12.png
Click image to enlarge.

15

Plugin Installer

ClickNext >.

Install-13.png
Click image to enlarge.

16

Accept the License Agreement

If you concur, check the box next to "I accept the terms in all of the license agreements".

ClickNext >.

Install-14.png
Click image to enlarge.

17

Dismiss Security Warning

Although the plugins were created and provided by Microchip, they have not been digitally signed. This will trigger a security warning.

ClickContinue.

Install-15.png
Click image to enlarge.

18

Plugin Installation Complete

ClickFinish.

Install-16.png
Click image to enlarge.

19

Verify Installation

If you wish to verify the installation of the plugins, select theInstalled tab. You should see the following two plugins somewhere in the list:

  • MPLAB Harmony Help
  • MPLAB Harmony Configurator


ClickClose when done.

Install-17.png
Click image to enlarge.

1

Run Installer

WinInstall.png
Go to the location where you downloaded the installer. Unzip the downloaded file and run the installer:
harmony_vX_XX_osxinstall-ier.app.

Depending on your security settings, you may get a window asking if you are sure you want to open this file. AnswerOpen.
Install-00.png

2

Setup

ClickNext >.

Install-01.png
Click image to enlarge.

3

Accept License Agreement

If you concur, select "I accept the agreement" and clickNext >.

Install-02.png
Click image to enlarge.

4

Select Installation Location

If you wish to choose an installation location other than the default, you may do so here.
ClickNext >.

Install-03.png
Click image to enlarge.

5

Choose Modules to Install

In some instances you may only want to install modules from the MPLAB® Harmony framework that you plan to use. If this is the case, uncheck any module you do not want to install. This will only save space on your PC. Unused modules willNOT be compiled into your application.
ClickNext >.

Install-04.png
Click image to enlarge.

6

Begin Installation

ClickNext >.

Install-05.png
Click image to enlarge.

7

Wait for Installation to Finish

Install-06.png
Click image to enlarge.

8

Finish Part 1 of Installation

Leave the "View Readme File" box checked - it will provide critical instructions to complete the installation.
ClickFinish.

Install-07.png
Click image to enlarge.

9

View Readme File for Further Instructions

The readme file briefly describes the need to install two plugins within MPLAB X IDE to use MPLAB Harmony effectively. The instructions are provided in detail in the steps below.

Install-08.png
Click image to enlarge.

10

Open the MPLAB X IDE Plugin Manager

  1. Run MPLAB X IDE and open theplugin manager by selecting from the main menu:
    Tools ▶ Plugins
  2. Select theDownloaded tab
  3. Click theAdd Plugins… button on the upper left.
Install-09.png
Click image to enlarge.

11

Load the MPLAB Harmony Help Plugin

Navigate to the following directory:
../Users/<yourusername>/microchip/harmony/vX_XX/doc
(whereX.XX represents the version number)
Select the file:
org-microchip-harmony_help.nbm

ClickOpen.

Install-10a.png
Click image to enlarge.

12

Add the Next Plugin

Click theAdd Plugins… button on the upper left.

Install-11.png
Click image to enlarge.

13

Load the MPLAB Harmony Configurator Plugin

Navigate to the following directory:
../Users/<yourusername>/microchip/harmony/vX_XX/utilities/configurator
(whereX.XX represents the version number)
Select the file:
com-microchip-harmonyconfigurator.nbm

ClickOpen.

Install-11a.png
Click image to enlarge.

14

Install the Plugins

Click theInstall button at the bottom left of the plugin manager window.

Install-12.png
Click image to enlarge.

15

Plugin Installer

ClickNext >.

Install-13.png
Click image to enlarge.

16

Accept the License Agreement

If you concur, check the box next to "I accept the terms in all of the license agreements".

ClickNext >.

Install-14.png
Click image to enlarge.

17

Dismiss Security Warning

Although the plugins were created and provided by Microchip, they have not been digitally signed. This might trigger a security warning.

ClickContinue.

Install-15.png
Click image to enlarge.

18

Plugin Installation Complete

ClickFinish.

Install-16.png
Click image to enlarge.

19

Verify Installation

If you wish to verify the installation of the plugins, select theInstalled tab. You should see the following two plugins somewhere in the list:

  • MPLAB Harmony Help
  • MPLAB Harmony Configurator


ClickClose when done.

Install-17.png
Click image to enlarge.