MPLAB Harmony Graphics Suite Applications > Examples and Demonstrations > Legato Applications > legato_adventure > legato_adv_mzef_cu_tm4301b.X
MPLAB® Harmony Graphics Suite Applications
legato_adv_mzef_cu_tm4301b.X
Defining the Architecture

This configuration runs on the PIC32MZ EF Curiosity 2.0 with RGB565 GFX Interface board and WQVGA display. A 16-bit RGB565 frame buffer is stored in the internal SRAM, and the Low Cost Controller-less (LCC) display driver is used to manage the DMA that transfers the framebuffer contents to the display via the EBI peripheral. 

User touch input on the display panel is received thru the PCAP capacitive touch controller, which sends a notification to the Touch Input Driver. The Touch Input Driver reads the touch information over I2C and sends the touch event to the Graphics Library thru the Input System Service. 

 

Demonstration Features 

• Legato Graphics Library 

• Input system service and touch driver 

• Time system service, timer-counter peripheral library and driver 

• Low-Cost Controller-less (LCC) display driver 

• 16-bit RGB565 color depth support (65535 unique colors) 

• EBI peripheral library and driver 

• I2C peripheral library and driver 

• JPEG image stored in internal flash 

 

Creating the Project Graph

The Project Graph diagram shows the Harmony components that are included in this application. Lines between components are drawn to satisfy components that depend on a capability that another component provides. 

 

Adding the “PIC32MZ EF Curiosity 2.0 BSP” and “Aria Graphics w/ PDA TM4301B Display” Graphics Template component into the project graph will automatically add the components needed for a graphics project and resolve their dependencies. It will also configure the pins needed to drive the external peripherals like the display and the touch controller. 

 

Building the Application

 

The parent directory for this application is gfx/apps/aria_adventure. To build this application, use MPLAB X IDE to open the gfx/apps/aria_adventure/firmware/legato_adv_mzef_cu_tm4301b.X project file. 

 

The following table lists configuration properties:

Project Name 
BSP Used 
Graphics Template Used 
Description 
legato_adv_mzef_cu_tm4301b.X 
PIC32MZ EF Curiosity 2.0 
Legato Graphics w/ PDA TM4301B Display 
PIC32MZ EF Curiosity 2.0 with RGB565 GFX Interface and 4.3” WQVGA PCAP Touch display 

 

Important! 
This application may contain custom code that is marked by the comments // START OF CUSTOM CODE ... and // END OF CUSTOM CODE. When using the MPLAB Harmony Configurator to regenerate the application code, use the "ALL" merging strategy and do not remove or replace the custom code. 

 

Configuring the Hardware

 

Configure the hardware as follows: 

• Attach the RGB565 GFX Interface Card to the J601 connector on the PIC32MZ EF Curiosity 2.0 board. 

• Connect the ribbon cable from the WQVGA display to the J2 connector on the RGB565 GFX Interface card. 

• Connect a USB cable from the host computer to the DEBUG USB port on the PIC32MZ EF Curiosity 2.0 board. This USB connection is used for power, code download and debugging. 

The final hardware setup should be:

 

 

Running the Demonstration

 

The application first boots to an animated Splash Screen. Once the Splash Screen animation completes, the application boots to a Main Screen. 

 

When at rest, the demo will cycle through idle sprite animations. Various areas of the screen are touch interactive. 

 

 

 

If initiated to run, the lamb sprite will run to the end of the screen, and play out a sequence of smacking into a wall, hurt and dizzy animations. 

 

 

 

Tap Jump and the lamb will play out a jump animation. 

 

 

 

 

Info Screen describes the features supported by this demo 

 

 

MPLAB® Harmony Graphics Suite Applications