• Medium One

How To Compile Harmony Project for Microchip IoT Ethernet Kit

Date: April 9, 2017

Author: Medium One

This document describes how to set and compile the Microchip IoT Monitoring kit, to generate a hex image file, and to flash the board.  These instructions are for Mac OS. For Windows, please refere to this project and readme https://github.com/medium1/iot-smart-sensing-microchip/tree/master/windows_project.  


  1. MPLab X IDE 3.26 [mac os] [windows]

  2. Harmony 1.07 (not version 1.07.01) [mac os] [windows]

  3. XC32 compiler 1.42 [mac os] [windows]

  4. iot-smart-sensing-microchip-master.zip project file [github]

  5. direct link to project file [here]

Step 1: Install Toolchain

Install the 3 installer files.  Do not update to the latest version.  At the time when this project was created, it is only compatible with this version.  

Note: MPLab and XC are installer in Applications folder.  Harmony is installed in ~ directory.

Make sure you check Add xc32 to path when installer XC compiler




Step 2: Unzip Project

Unzip iot-smart-sensing-microchip-master-04092017.zip in your home directory.  I.e. /Users/demo for mac.



Step 3: Open MPLab and Project

Run MPLab.  

Click File->Open Project.  Select project from the unzipped project from Step 2



After the project loads go to next step.

Step 4: Set Compiler to v1.42

Select “Customize” from the dropdown toolbar

On popup, select XC32 (v1.42).  If you don’t see v1.42 you didn’t do Step 1 properly.

Important: Click Apply then OK.

Step 5: Build the project

From toolbar, click on the icon below and “Clean and Build Project…”

If you have the output window open, you should see the following messages as the project builds…

when completed, you should see “Build Successful..” in green font.

The generated .hex file will be located in your project folder in:


Congrats! You’re done compiling your new hex file. Next, refer to the following tutorial on how to program the newly generated .hex image to the board.

How to program the board:


Quick Start Guide:



© 2018 Medium One   All Rights Reserved

4633 Old Ironsides Dr. #280, Santa Clara, CA  95054                



  • LinkedIn - White Circle
  • Twitter - White Circle
  • YouTube - White Circle
  • Google+ - White Circle