Quickstart Prebuilt Applications

Quickstart prebuilt applications lets you get started with MPLAB Harmony Graphics Suite in about 30 seconds. These applications should give you a ready-made starting point for writing your own graphics apps with MPLAB Harmony Graphics Suite.

Quickstart Examples

The following table below lists quickstart applications and the development boards on which they run. To find a detailed description of these applications, see Examples and Demonstrations.

Applications	SAM D21N Xplained Pro	SAM C21N Xplained Pro	SAM E54 Xplained Pro	SAM E70 Xplained Ultra	SAM A5D2 Xplained Ultra	Multimedia Expansion Board II	SAM 9x60 Evaluation Kit	Curiosity PIC32MZ EF 2.0
aria_quickstart	x	x	x	x	x	x	x	x
blank_quickstart						x
legato_quickstart			x	x		x	x	x

Before you begin you must install the following tools:

• MPLAB X IDE
• XC32 C compiler
• MPLAB® Harmony v3
• Development board

Step 1: Get the quickstart app

1. Clone the Harmony v3 GFX repository.

git clone https://github.com/Microchip-MPLAB-Harmony/gfx.git

Step 2: Import the quickstart app

1. Open the MPLAB X IDE and select File->Open Project

2. Navigate to the apps/aria_quickstart/firmware and select one of the MPLAB X quickstart projects. Then click Open Project button.
3. Under Projects, right-click project name, select Set as Main Project.

Step 3: Launch MPLAB Harmony Configurator (MHC)

1. After the project opens, start the MPLAB Harmony Configurator. In the MPLAB X IDE, select Tools->Embedded->MPLAB Harmony Configurator.
2. Select the path to the folder containing the MPLAB Harmony framework and click Launch.
3. The Configuration Database Setup window opens. Select [] gfx, then click Launch.
4. After MHC is loaded, observe the Project Graph.

Step 4. Generate Source Code

1. When done, before generating code, click the Save icon as shown below.

2. Save the configuration in its default location when prompted.

3. Click on the Code Generate button as shown below to start generating code.

4. Click on the Generate button in the Generate Project window, keeping the default settings as shown below. If prompted for saving the configuration, click Save.

MHC will include all the MPLAB Harmony library files and generate the code based on the MHC selections. The generated code would add files and folders to your Harmony project.

Step 5. Program Device

1. Clean and build your application by clicking on the Clean and Build button as shown below.

2. Program your application to the device, by clicking on the Make and Program button as shown below.

---

Next Steps

• Build and decompose our feature applications
• Understand our board support facilities
• Learn how to build a new applications

---

If you are new to MPLAB Harmony, you should probably start with these tutorials:

• MPLAB® Harmony v3 software framework
• MPLAB® Harmony v3 Configurator Overview
• Create a New MPLAB® Harmony v3 Project

---

Is this page helpful? Send feedback.