--- title: Microchip Graphics Suite Harmony Package nav_order: 1

Microchip Graphics Suite Harmony Package

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:

• Microchip 32-bit MCUs
• Microchip 32-bit MPUs
• Microchip MPLAB® X IDE
• Microchip MPLAB® Harmony
• Microchip MPLAB® Harmony Pages
• MPLAB® Discover

This repository contains the MPLAB® Harmony 3 Support Package for Microchip Graphics Suite (MGS). The suite supports a free fast to market, graphics software development environment for Microchip MPLAB® 32-bit SAM and PIC® microcontroller and microprocessor devices. Refer to the following graphics links for release notes, home page, training materials, framework and application help.

For feature-rich, professional Microchip Graphics Suite demonstrations and demonstrations from third-party graphics libaries, refer to user guides on Microchip Developer Help or search for "Microchip Graphcis Suite" on MPLAB® Discover.

Examples for display bring-up can be found at various device-family specific repositories

• Release Notes
• MPLAB® Harmony License
• User Guides on Microchip Graphics Suite Harmony
• Professional Designs on Microchip Graphics Suite Development Kits

Features

The key features of the Microchip Graphics Suite (MGS) are the following:

• Hardware optimized for use with Microchip 32-bit SAM and PIC® devices
• Compatible component for use with MPLAB Code Configurator (MCC)
• MGS Harmony Composer WYSWYG UI designer tool for Windows, Linux and Mac
• MGS Simulator A tool to generate simulated GUI designs to run on Windows, Linux and Mac
• Written in C with MISRA C (Mandatory) compliancy
• RTOS (FreeRTOS, ThreadX) and non-RTOS support
• Configurable widget building blocks buttons, labels, lists, sliders, and images
• Rich tool set: Heap Estimator, Event Manager, Palette generator, Asset Manager, String and Font interface, DDR memory organizer
• Hardware integrated for Microchip GPU and display controller peripherals
• Support for single and double frame buffers
• Multi-language font support
• External input support for use with capacitive, resistive and other devices
• Fluid-UI support for alpha-blending, animations, scaling
• Pixel format support for RGBA8888, RGB888, RGB565, RGB5551, RGB332, GS8, YrBrCr
• Multi-image support for industry standard formats, compression choices, external memory accessibility
• Fully functional demonstrations and quick-starts to enable new development
• Low memory and low power configurable
• Segmented LCD support
• LVDS-interface display support
• MIPI-DSI display support
• 3rd-Party Graphics Vendor support

Contents Summary

MGS Harmony Composer

MGS Harmony Composer is a software tool that helps users create and manage GUI elements for their applications. It is part of MGS, which is a comprehensive, easy-to-use set of graphics tools for developing GUIs for Microchip's 32-bit microcontrollers (MCUs) and microprocessors (MPUs).

For additional information, visit the MGS Harmony Composer User Guide at Microchip Develop Help.

MGS Simulator

MGS Harmony Simulator allows developers to prototype and debug graphics applications on a PC, before deploying them on the actual hardware. It emulates the graphics controller of an MCU/MPU, allowing you to see the output of your code in real-time.

For information on how to download and use the Simulator as a productivity tools to shorten development time and reduce the overall cost of your embedded GUI designs, visit the MGS Simulator User Guide at Microchip Develop Help.

MGS Harmony Library (also known as Legato)

The bare-metal graphics library for Microchip Graphics Suite. Supports Microchip PIC32 and SAM microcontrollers and microprocessors

Category	Item	Description	Release Status
drivers	glcd	Driver for the GLCD display controller peripheral
	2dgpu	Driver for the 2DGPU graphics processor
	lcc	Driver for the LCC software display controller
	gfx2d	Driver for the GFX2D graphics processor
	lcdc	Driver for the LCDC display controller peripheral
	external controller	Driver generator for external display controllers
	ssd1963	Driver for the ssd1963 display controller
	ili9488	Display Driver for the ili9488 controller
	parallel_ebi	Interface to the parallel EBI registers
	parallel_portgroup	Inteface to the parallel portgroup registers
	parallel_smc	Interface to the parallel smc registers
	spi	Interface to the spi registers
	xlcdc	Driver for the XLCDC display controller peripheral
	dsi	Driver for the MIPI-DSI display interface
	lvdsc	Driver for the LVDS display interface
library	legato	MGS Harmony library
designer	MGC Harmony	MGS Harmony Composer

NOTE: ssd1963 and the ili9488 drivers are deprecated. Their functionality are replaced by external controller driver. All applications using these drivers must transition to external controller driver.

Blank Library Interface

Blank Library Interface - the library interface which easily allows a third-party graphics library direct access to the display framebuffer. Blank library applications are available at various device-family specific repositories.

3rd-Party Graphics Vendor Support

LVGL - demonstrations interfacing with LVGL are available for the SAM 9x60 Family, the SAM 9x7 Family, the SAM D5x/E5x Family, and the PIC32MZ DA Family.

Tara Embedded Wizard - demonstrations interfacing with Tara Embedded Wizard are available for the SAM A5D2 Family, the SAM 9x60 Family, and the SAM 9x7 Family

Image Sensor Support

Image Sensor Controller Drivers for SAM microprocessors and Image Sensor Drivers

NOTE: Starting from Harmony 3 Graphics release v3.14.0 and over the next several releases, image sensor support will be gradually removed from the Graphics release and repositioned in releases of Harmony 3 Vision Package.

This chart shows which drivers are located in which repository.

Category	Item	Description	Release Status	Repository
drivers	isi	Driver for the Image Sensor Interface peripheral
	cam	Driver for the OV5640 image sensor module for ISI
	isc	Driver for the Image Sensor Controller peripheral

Segmented LCD Support

Controller Drivers for Segemented LCDs for SAM microcontrollers

Category	Item	Description	Release Status
drivers	slcc	Low-Cost Controllerless Driver for the Segmented LCD displays
	slcd	Driver for the SAM L22 Segmented LCD display controller peripheral
	slcdc	Driver for the PIC32CX MT Segmented LCD display controller peripheral

Aria Graphics

The legacy graphics facilities for MPLAB® Harmony Graphics Suite. Supports Microchip PIC32 and SAM microcontrollers.

As of Graphics release v3.8.0, Aria Graphics has been deprecated and removed from this repository. A snapshot of all previously published applications, tools, middleware and drivers related to Harmony 3 Aria Graphics are available at this archive repository.