Getting Started Graphics Application Development on the SAM9X75 Hybrid Curiosity Development Board
Purpose
This lab introduces graphics application development on the SAM9X75 Curiosity Hybrid Development Board using the Microchip Graphics Suite (MGS). The session demonstrates how to integrate and drive a Microchip LVDS WVGA display module using the SAM9X75’s graphics and display capabilities, while following a structured, tool‑driven development flow. You are guided through the complete process of creating, generating, and validating a graphics application using MPLAB® for VS Code®, with real‑time debugging support.
Overview
This lab demonstrates the integration of the LVDS display (AC69T88A) with the SAM9X75 Curiosity Hybrid using MGS and MPLAB Harmony Graphics (GFX) libraries. It focuses on configuring the required graphics components in MPLAB Code Configurator (MCC), launching Microchip Graphics Composer to design a QuickStart UI, and generating the corresponding application code. Debugging and validation are performed using the MPLAB PICkit® 5 in-circuit debugger/programmer, enabling you to observe application execution, graphics rendering, and runtime behavior directly on the target hardware.
Key areas covered include:
- LVDS display interface configuration on SAM9X75
- Graphics application creation using MGS
- Code generation and build using MPLAB for VS Code
- Hardware‑assisted debugging using MPLAB PICkit 5 in-circuit debugger/programmer
Procedure
In this module, you will transition from basic hardware control to developing sophisticated visual interfaces using MGS. This lab focuses on driving a high-performance LVDS WVGA LCD Display Module with maXTouch® Technology Display Board (AC69T88A) display using the SAM9X75 Curiosity Hybrid Development Board, all within the modern MPLAB for VS Code environment.
Task: MGS display application development for WVGA LVDS display.
Hardware Pre-Requisite
- SAM9X75 Curiosity Hybrid Evaluation Board

- Two USB Type-C® cables
- Power the board via a 5V adapter through J14 or J1
- Connect the MPLAB PICkit 5 debugger to J11 to enable debugging
- Jumper settings:
- Close 1-2 pins of J13 for the 5V power selection via FTDI USB (J14)
- Close 2-3 pins of J13 for the 5V power selection via USB-A (J1)
- Close jumper J3 to enable VDDBU
- Connect the LVDS display with the SAM9X75 Curiosity Hybrid board using the ribbon cable as shown in the accompanying image

Procedure
Part 1: Creating a Graphics Application Using MPLAB for VS Code
This tutorial serves as a direct continuation of the previous module, "Getting Started With Application Development Using MPLAB® for VS Code® Extensions".
We will begin by using MCC to integrate the Graphics (GFX) peripheral into our existing project.
Go to the MCC tab in VS Code if it’s already open, or launch MCC. To launch MCC, go to View > Command Palette > MPLAB MCC: Launch and open the MCC configuration.

In addition to the required packages (csp), download the optional packages gfx.
To do this, click on Device Resource, then Content Manager, choose gfx and then click Select Latest Version. The content download will take some time, so be patient and wait until all contents are downloaded. Then click Apply.

From Device Resource > Graphics > Templates, add Legato Graphics w/ AC69T88A Display to Project Graph. You will be prompted to allow auto-connection and auto-activation of several components. Click on Yes for all of them except FreeRTOS™.

From the Project Graph tab Plugins drop-down, select Pin Configuration.

You can see that PA24 and PA25 are set to FLEXCOM6. Other LVDS display pin interfaces are configured as per the SAM9X75 Curiosity Hybrid user guide.

The next step is MGS quick-start graphics. To do this, launch the Microchip Graphics Composer and click Create New Project.

In the Display Configuration window, choose WVGA (800x480) for Display Preset and click Apply. You will see that the width and height are updated. For Color Mode, select RGB_565. Click Next. For Memory Profile, select MPU. Click Next. In the Templates window, select the QuickStart 800 x 400 px to draw graphics on a WVGA LVDS display. Click Next and Create.

You will see the following screen generated by the composer.

You can save the design files by clicking on File from the main menu and selecting Save As. Provide a filename with <your_MCC_Config_name>_design, save it in your MCC Configuration folder (so that the next time MGS is launched, the design file opens automatically), and click Save.
Generate the code and wait till the code generation is complete. You can then exit Microchip Graphics Composer by clicking on Exit from File in the main menu.

From MCC, click on Generate. This will generate code for the QuickStart template for a WVGA LVDS display designed using Microchip Graphics Composer. This completes the QuickStart graphics application development using MPLAB for VS Code on the SAM9X75 Curiosity Hybrid development board.

Part 2: Build and Debug the Application on the Target
To debug the project on MPLAB X IDE using the MPLAB PICkit 5 in-circuit debugger/programmer, follow these steps.
Make sure the board is powered and the external debugger is connected. Ensure LVDS display is connected to the SAM9X75 Curiosity Hybrid board.
Before debugging, confirm the compiler details. To do this, go to Command Palette and launch MPLAB: Edit project properties (UI). Go to Toolchain and confirm that XC32 compiler is chosen.

Configure the debug interface of PICkit 5 as shown in the accompanying image:

By default, MPLAB X IDE only generates ELF and HEX format output files. To generate application output in binary format, a post-build step needs to be added to the project properties.
To do this, go to Overview > Post-build Steps > Add Item. Then add the following command:

If you click User Variables in the UI now, it will be empty. Update the user variables as follows to give the at91bootstrap (second-stage bootloader) path to the project.
The uservariables properties should be updated with the bootloader information in the<project_name>.mplab.json file. To edit this JSON file, go to View > Command Palette > MPLAB Edit Project Properties JSON file and add the bootloader properties under uservariables.
{
"name": "default-uservariables",
"type": "uservariables",
"properties": {
"boot.load_adr": "",
"boot.use": "true",
"boot.entry_adr": "",
"boot.path": "./binaries/at91bootstrap.elf ",
"boot.prj": ""
}
},

Once the JSON file is updated, it will be automatically reflected in the project properties, as shown in the accompanying image:

Clean and build the project. You will see a message on the output console that the project was successfully built. This completes the building of the MPLAB Harmony application.
To resolve "unable to find header file" errors, if any, update your project configuration. Select View > Command Palette > MPLAB: Edit Project Properties (UI) > Compiler > Global > Include Directories > Add Path (your project configuration path).

Now starting to debug. Go to View > Command Palette > Debug: Start Debugging when prompted choose MPLAB for VS Code debugger.

Now start debugging the project by step in, step out, halt, or run.

If any issues with debugging, try changing the compiler and linker optimization level to 0.

Now observe the developed MGS graphics application getting displayed on the LVDS display.

Users can observe the debug console messages as well. For SAM9X75 Curiosity Hybrid, channel C of the FT4232H is connected to Universal Asynchronous Receiver Transmitter (UART).
Find the Channel C - COM port number from device manager as shown in the accompanying image:


Results
You have successfully:
- Generated and built a graphics‑enabled MPLAB Harmony application targeting a Microchip LVDS WVGA display
- Verified correct LVDS display initialization and rendering on the SAM9X75 Curiosity Hybrid board
- Debugged the graphics application using the MPLAB PICkit 5 debugger, confirming stable application execution and graphics output
- Observed real‑time system behavior through debugger and console messages, validating end‑to‑end graphics integration