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

 

This configuration runs on the SAM E54 Curiosity Ultra board with a 24-bit passthrough GFX interface card and a maXTouch Curiosity Pro display. The maXTouch Curiosity Pro display has an ILI9488 display controller that is connected to the SAM E54 thru the port/GPIO peripheral using an 8-bit 8080/Parallel interface, boosted with a combination of DMA and CCL peripherals. The Legato graphics library draws the updated sections of the frame to an internal scratch buffer which is used by the ILI9488 display driver to update the ILI9488 display controller. 

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 

• ILI9488 display 8-bit parallel mode driver (DMA-CCL boosted) 

• 16-bit RGB565 color depth (8-bit palettized double buffering) 

• Port/GPIO peripheral 

• I2C peripheral library and driver 

• Images and Fonts for user interface stored in internal flash 

 

Creating the Project Graph

 

Adding the “SAM E54 Curiosity Ultra BSP” and “Legato Graphics w/ MXT Curiosity Pro Display” Graphics Template component into the project graph. 

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

For the DMA-CCL boosted setup, components TC4, CCL needs to be added. 

Some of these components are fine with default settings, while other require some changes. The following is a list of all the components that required custom settings. 

 

 

 

 

 

To setup the CCL to clock the pixel data, make sure PB09 is set to CCL_OUT2 

 

 

 

Instead of write strobe, make sure PB17 is setup as RSDC instead 

 

 

 

Building the Application

 

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

 

The following table lists configuration properties:

Project Name 
BSP Used 
Graphics Template Used 
Description 
legato_adv_e54_cu_cpro_parallel.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 24-bit pass through card to the GFX Connector on the SAM E54 Curiosity Ultra board. 

• Connect the ribbon cable from the maXTouch Curiosity Pro Display to the ribbon connector on the 24-bit pass through card. Make sure that the S1 switch on the 24-bit pass through card is set to 2. 

• On the backside of the maXTouch Curiosity Pro display, set the IM[2:0] switches to ‘011’ for 8-bit MCU mode. 

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

• Connect 5.5V power supply to the SAM E54 Curiosity Ultra board is optional 

 

The final hardware set-up should be:

 

Power up the board by connecting the power adapter to power connector or a powered USB cable to the DEBUG USB port on the board. 

 

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