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

 

The legato_adventure application uses the Legato Graphics Library to render graphics to the display. The Legato graphics library draws the updated sections of the frame to an internal scratch buffer. The contents of the scratch buffer are used to update the contents of the LCD display. 

In this configuration, the SSD1963 display controller is used to send the display data and timing to a WQVGA display. The SSD1963 is connected to the SAM E70 thru the SMC peripheral and GPIOs which are used to send 16-bit parallel data/commands and to bit-bang control signals to the SSD1963 controller, respectively. The frame buffer is stored externally in the SSD1963 controller. 

 

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 “SAM E70 XPlained Ultra BSP” and “Legato Graphics w/ PDA TM5000 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. 

By default, the template is configured to use the Low-Cost Controller-less (LCC) interface to the display. 

To configure the project for an SSD1963, set the Display Interface setting for the Aria component from LCC to SSD1963. 

 

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_e70_xu_tm5000_ssd1963.X project file. 

 

The following table lists configuration properties:

Project Name 
BSP Used 
Graphics Template Used 
Description 
legato_adv_e70_xu_tm5000_ssd1963.X 
sam_e70_xplained_ultra 
Legato Graphics w/ PDA TM5000 Display 
Legato GFX on SAM E70 Xplained Ultra board with PDA TM5000 Display and SSD1963 display driver 

 

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

 

The final hardware set-up 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