title: Harmony 3 Configurator Package nav_order: 1 has_children: true

MPLAB® Harmony 3 Configurator

MPLAB® Harmony 3 is an extension of the MPLAB® ecosystem for creating embedded firmware solutions for Microchip 32-bit SAM and PIC® microcontroller and microprocessor devices. Refer to the following links for more information.

This repository contains the implementation of the MPLAB® Harmony 3 Configurator (MHC) tool. The MHC is an easy to use development tool with a Graphical User Interface (GUI) that simplifies device setup, library selection, and configuration, and application development. The MHC is available as a plugin that directly integrates with the MPLAB® X IDE or as a separate Java executable for standalone use with other development environments.

MHC includes a downloader tool that reads an online catalog of MPLAB Harmony 3 library packages so that the developers can select and download the libraries in which the they are interested. The configurator functionality provides a convenient, but powerful, development tool for choosing library components from downloaded packages and configuring them for the developer’s application. And, the built-in code generator produces the libraries and application starter code (usually in source form), based on the options chosen.

Getting started with MHC
Release Notes

Contents Summary

File/Folder	Description
doc	Help documentation and licenses for libraries used
np_templates	New Project templates for supported toolchains
databases	Device databases for supported toolchains
scripts	Python scripts used for project generation
*.jar	Java implementations of MHC modules.
mhc.jar	Main Java executable (run: java -jar mhc.jar -h)
harmony-database.jar	internal sub module to hold all symbols
databaseUI.jar	internal sub module to show database
mhc_utils.jar	internal sub module for harmony utility
mplx_launcher.jar	internal sub module used with MPLABX platform
runmhc.bat	Windows cmd batch file to run standalone MHC GUI

Open source Libraries

Harmony 3 configurator and Content manager uses following open sources libraries:

Library Name	Version	License
picocli-1.0.1.jar	1.0.1	Apache License 2.0 https://github.com/remkop/picocli/blob/v1.0.1/LICENSE
docking-frames-common-1.1.3p1.jar	1.1.3p1	GNU Lesser General Public License, version 2.1 http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
docking-frames-core-1.1.3p1.jar	1.1.3p1	GNU Lesser General Public License, version 2.1 http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
freemarker-2.3.23.jar	2.3.23	Apache License Version 2.0 https://freemarker.apache.org/docs/app_license.html
jython-standalone-2.7.2.jar	2.7.2	PSF License v2 https://github.com/jythontools/jython/blob/master/LICENSE.txt
simple-xml-2.7.1.jar	2.7.1	The Apache Software License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0.txt
jinja2	2.10.3	BSD 3-Clause "New" or "Revised" License https://github.com/pallets/jinja/blob/master/LICENSE.rst
markupsafe	1.1.1	BSD 3-Clause "New" or "Revised" License https://github.com/pallets/markupsafe/blob/master/LICENSE.rst
jsch-0.1.54.jar	0.1.54	Revised BSD http://www.jcraft.com/jsch/LICENSE.txt
org.eclipse.jgit-4.11.0.201803080745-r.jar	4.11.0.201803080745-r	Eclipse Distribution License (New BSD License)
slf4j-api-1.7.25.jar	1.7.25	MIT License http://www.opensource.org/licenses/mit-license.php
slf4j-simple-1.7.25.jar	1.7.25	MIT License http://www.opensource.org/licenses/mit-license.php
jfoenix-8.0.10.jar	8.0.10	Apache Version 2.0 http://www.apache.org/licenses/LICENSE-2.0.txt
fontawesomefx-8.9.jar	8.9	Apache License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0
controlsfx-8.40.18.jar	8.40.18	The 3-Clause BSD License http://www.opensource.org/licenses/bsd-license.php
reactfx-2.0-M5.jar	2.0-M5	The BSD 2-Clause License http://opensource.org/licenses/BSD-2-Clause