Step 1.1: Install the MPLAB® Harmony Configurator (MHC) Plug-in in the MPLAB® X IDE
1
Verify that MHC is installed.
• Launch MPLAB X IDE from the Windows® Start Menu. Close any projects and files that are currently open.
• Go to Tools > Embedded .
• You will see MPLAB® Harmony 3 Configurator in the menu.
If you don't see it in the menu, install MHC.
Step 1.2: Create MPLAB Harmony v3 Project using MPLAB X IDE
1
Select File > New Project from the main IDE menu.
Note: Close all existing opened projects before you start creating a new project.
2
In the Categories pane of the New Project dialog, select Microchip Embedded. In the Projects pane, select 32-bit MPLAB Harmony 3 Project, then click Next.
Note: If “32-Bit MPLAB Harmony 3 Project” is not displayed, install MHC.
3
In the Framework Path edit box, browse to the folder you downloaded the framework to. If you haven't done this, or want to download it to a different folder, click the Launch Framework Downloader button, then click Next.
Note: For more information on the framework downloader, see the "Download MPLAB Harmony Framework" section of the "MPLAB® Harmony Configurator Overview" page.
4
In the Project Settings window, apply the following settings:
- Location: Indicates the path to the root folder of the new project. All project files will be placed inside this folder. The project location can be any valid path, for example: C:\microchip\harmony\v3\training\dev.
- Folder: Indicates the name of the MPLABX .X folder. Enter “sam_c21n_xpro” to create a sam_c21n_xpro.X folder.
Note: This must be a valid directory name for your operating system.
- Name: Enter the project’s logical name as “getting_started_sam_c21n_xpro”. This is the name that will be shown from within the MPLAB X IDE.
Note: The Path box is read-only. It will update as you make changes to the other entries.
- Click Next to proceed to Configuration Settings.
Note: Clicking on the Show Visual Help button will open a help window providing a detailed description of the various fields in the Project Settings window.
5
Follow the steps below to set the project’s Configuration Settings.
- Name: Enter the configuration name as “sam_c21n_xpro”.
- Target Device: Select ATSAMC21N18A as the target device.
Note: You can select the Device Family or enter a partial device name to filter the list in Target Device in order to make it easier to locate the desired device.
- After selecting the target device, click Finish to launch MHC.
Note: The New Project Wizard opens a Configuration Database Setup window to allow you to review the packages that will be used by the current project.
8
Before proceeding, set up the compiler toolchain. Click on the Projects tab on the top left pane. Right click on the project name getting_started_sam_c21n_xpro and go to Properties.
Make sure that XC32 (v2.20) is selected as the Compiler Toolchain for XC32. Click Apply and then click OK.
Tool Tip: If you closed MHC accidently, and would like to open it again, go to Tools > Embedded > MPLAB Harmony 3 Configurator.