1. Select File > New Project from the main IDE menu.

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 selection is not displayed, Download MPLAB® Harmony Framework.

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.
   • Folder: Indicates the name of the MPLABX .X folder. Enter “same70” to create a same70.X folder.
   • Name: Enter the project’s logical name as “my_board”. This is the name that will be shown from within the MPLAB® X IDE.
   • Click Next to proceed to Configuration Settings.

NOTE: Folder must be a valid directory name for your operating system. The Path box is read-only. It will update as you make changes to the other entries.

5. Follow the steps below to set the project’s Configuration Settings.

   • Name: Enter the configuration name as “same70”.
   • Target Device: Select “ATSAME70Q21B” as the target device.
   • Click Finish to launch the MHC.

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.

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.

6. While the MHC tool launches, it will ask for the packages to be loaded. In the Load checkboxes list, select the gfx, core, and bsp packages and unselect all other packages.

Click Launch to launch the MHC Configurator tool with the selected packages.

• Launching MPLAB® Harmony Configurator. The following message will be displayed while the project is loaded into MPLAB® X.

7. The MHC plugin’s main window for the project will be displayed. This is the initial project graph.

8. Before proceeding, set up the compiler toolchain. Click on the Projects tab on the top left pane. Right click on the project name my_board and go to Properties.

Make sure that XC32 (v2.20) is selected as the Compiler Toolchain for XC32. Click on Apply and then click on OK.

1. Launch Clock Diagram by going to MHC tab in MPLABX IDE and then select Tools > Clock Configuration.

A new tab, Clock Diagram, is opened in the project’s main window.

2. Click on the Clock Diagram tab, scroll to the right and verify that the Processor Clock (HCLK) and Master Clock (MCK) is set to 300 MHz and 150 MHz, respectively.

A Board Support Package Component automatically adds to the Pin Settings table:

NOTE: When the project is generated, MHC will add bsp.h and bsp.c to the project. The add LED and SWITCH macros as well as BSP_Initialize() API. When called, BSP_Initialize() switch off LEDs.

1. Under the bottom left Available Components tab, expand Board Support Packages. Double click or drag and drop SAM E70 Xplained Ultra BSP to add the board support component the SAM E70 development kit to the project graph.

A Graphics Template Component automatically adds subtending graphics components specific to a display module to the project graph. Just like the SAM E70 Xplainded Ultra BSP, the activities can be performed automatically or manually. The display module we will use Aria Graphics w/PDA TM4301B.

Under the bottom left tab, Available Components, expand Graphics. Double click or drag and drop Aria Graphics w/PDS TM4301B Display to add the Harmony Core Service to the project graph. When prompted to activate these components, click Yes. When prompted to activate FreeRTOS, click No. When prompted to automatically make these connections, click Yes. When prompted to deactivate these components, click Yes. When prompted to activate these components, click Yes.

1. When pin configuration is done, before generating code, click Save MHC State 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. If prompted for saving the configuration, click Save.

5. As the code is generated, the MPLAB® Harmony Configurator (MHC) displays the progress as shown below.

6. Examine the generated code .

The 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.

7. Navigate to the Projects tab to view the project tree structure.

8. Build the code by clicking on the Clean and Build icon and verify that the project builds successfully. At this point, you are ready to start implementing your application code.

1. Select File > New Project from the main IDE menu.

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 selection is not displayed, Download MPLAB® Harmony Framework.

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.
   • Folder: Indicates the name of the MPLABX .X folder. Enter “same70” to create a same70.X folder.
   • Name: Enter the project’s logical name as “my_board”. This is the name that will be shown from within the MPLAB® X IDE.
   • Click Next to proceed to Configuration Settings.

NOTE: Folder must be a valid directory name for your operating system. The Path box is read-only. It will update as you make changes to the other entries.

5. Follow the steps below to set the project’s Configuration Settings.

   • Name: Enter the configuration name as “same70”.
   • Target Device: Select “ATSAME70Q21B” as the target device.
   • Click Finish to launch the MHC.

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.

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.

6. While the MHC tool launches, it will ask for the packages to be loaded. In the Load checkboxes list, select the gfx, core, and bsp packages and unselect all other packages.

Click Launch to launch the MHC Configurator tool with the selected packages.

• Launching MPLAB® Harmony Configurator. The following message will be displayed while the project is loaded into MPLAB® X.

7. The MHC plugin’s main window for the project will be displayed. This is the initial project graph.

8. Before proceeding, set up the compiler toolchain. Click on the Projects tab on the top left pane. Right click on the project name my_board and go to Properties.

Make sure that XC32 (v2.20) is selected as the Compiler Toolchain for XC32. Click on Apply and then click on OK.

1. Launch Clock Diagram by going to MHC tab in MPLABX IDE and then select Tools > Clock Configuration.

A new tab, Clock Diagram, is opened in the project’s main window.

2. Click on the Clock Diagram tab, scroll to the right and verify that the Processor Clock (HCLK) and Master Clock (MCK) is set to 300 MHz and 150 MHz, respectively.

1. Configure SWITCH Button.

In MPLAB® Harmony Configurator (MHC), select the Pin Settings tab and then scroll down to 64 in the Pin Number column and configure the PORT pin PA11 as a Parallel Input/Output (PIO) interrupt pin for switch functionality as shown below. The internal pull-up is enabled to avoid false edge detection as there is no external pull-up on the SAM E70 Xplained Ultra Evaluation Kit.

2. Configure LED PIN

Select the MHC Pin Settings tab and then scroll down to 73 in the Pin Number column. Configure the PORT pin PA5 as an output pin for LED functionality as shown below.

NOTE: The LED on the SAM E70 Xplained Pro board is active low. Configure the LED in default OFF state by configuring the latch value to logic "High".

1. This is a Harmony based application, therefore, you will need to use the Harmony Core Service Component.

Under the bottom left tab, Available Components, expand Harmony. Double click or drag and drop Core to add the Harmony Core Service to the project graph. When prompted to activate FreeRTOS, click No.

2. You will also need the Time System Service.

NOTE: Harmony components lists Current Consumers and Available Consumers when a right click occurs on the circle icons.

• On the Harmony Core Service component, right click the Core Service icon on Harmony Core Service component, select Available Consumers, then select TIME.

• On the Time System Service component, right click the TMR icon, select CORE_TIMER(core_timer).

Because this is a GFX enabled application, you will need to select a graphics library. For this tutorial, we will use Aria.

3. Under the bottom left tab, Available Components, expand Graphics>Middleware. Double click or drag and drop Aria to add the Aria graphics library to the project graph.

4. On the Aria component, right click the GFX HAL, select Satisfiers, and select GFX Core.

5. On the GFX Core component, right click the Display Driver icon, select Satisfiers, and select LCC.

6. On the LCC component, right click SMC_CS diamond icon, select Satisfiers, and select SMC.

7. On the GFX Core component, right click Graphics Display diamond icon, select Satisfiers, and select PDA TM4301B (gfx_disp_pdatm4301b_480x272).

8. On the PDA TM4301B component, right click Touch Panel diamond icon, select Consumers, and select MaXTouch Controller (gfx_maxtouch_controller).

9. On the MaXTouch Controller component, right click DRV_I2C diamond icon, select Satisfiers, and select I2C (drv_i2c).

10. On the MaXTouch Controller component, right click Input System Service circle icon, select Available Satisfiers, and select Input System Service (sys_input).

11. On the I2C Driver component, right click Input I2C diamond icon, select Satisfiers, and select TWIHS0.

On completion, your Project Graph window should look similar to the following image:

If the display needs to be configured, then you will need to launch Display Manager. For this tutorial, Display Managing is not required. See Getting started with Display Manager for more information.

In this step, you will need to connect the SAME70 to the external touch controller and display modules.

If you are using the SAME70 Xplained Pro Evaluation Kit, please reference the Curiosity SAME70 Xplained Pro Evaluation Kit schematic obtained from the SAM E70 Xplained Ultra User's Guide.

NOTE: If you are using a schematic for your custom board, map the required graphics pins to your board.

NOTE: the drv_maxtouch and drv_gfx_lcc drivers require specific names for its pins. If you do not have the correct pin names a compiler output will display an error along with the expected name.

The pin mapping table below is made available for convenience.

1. Open the Pin Configuration tabs by clicking MHC > Tools > Pin Configuration.

2. Select the MHC Pin Settings tab and sort the entries by Port names as shown below.

3. Use the table above to establish your Pin Settings.

1. When pin configuration is done, before generating code, click Save MHC State 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. If prompted for saving the configuration, click Save.

5. As the code is generated, the MPLAB® Harmony Configurator (MHC) displays the progress as shown below.

6. Examine the generated code .

The 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.

7. Navigate to the Projects tab to view the project tree structure.

8. Build the code by clicking on the Clean and Build icon and verify that the project builds successfully. At this point, you are ready to start implementing your application code.