Setting Orientation for LCC Display Driver

Set orientation for an LCC Display Driver based UI design. You’ll start by launching MPLABX IDE, launch a quickstart Harmony3 project, launch MHC, launch composer, configure orientation properties, generate, and build and program.

Launch MPLABX IDE

Launch MPLABX on your development PC.

Load Quickstart into IDE

Load the quickstart project. You have the option of loading any MPLABX project. In this example we will load legato_qs_e70_xu_tm4301b.X.

Under File menu, select Open Project.

In the file dialog, select project .X file. In our example, we will use: legato_qs_e70_xu_tm4301b.X.

Launch MHC

Launch MHC from MPLABX. This is an LCC based design. No configuration is needed in the project graph. MHC is launched to enable the launching of MGS Harmony Composer.

MHC can also be launched in stand-alone mode. Go to MHC folder directory (/<Harmonypath>/mhc/) and double click the runmhc.bat file.

Launch Composer

Launch Composer from MPLABX. MHC is launched to enable the opening of Composer. All composer settings are independent of a display driver.

Open Project Settings

Open Project Settings Panel. Select Project, click on Project Settings.

Select Display Settings tab. Set width to 272 and height to 480. See illustration:

Select Library Settings tab. Input Orientation to 90 and **Software Rendering Orientation to 90. See illustration:

Rearrange pre-configured graphics UI design

Reposition the existing landscape UI widgets to align to the new portrait orientation.

Note: The backgroundPanel widget size should be modified as illustrated:

Generate Harmony3 code and project files

Save configuration and generaton project. MHC will generate all required projects files including a skeleton application code. These files are located in the project.

Build Quickstart

Build the quickstart project.

On the MPLABX menu tab, select .

Program Quickstart

Select Run Main Project. This button will build, program, and run the application.

Summary

In this guide, you learned to set a 90 degree orientation using the MPLABX Harmony Graphics Suite Composer tool for an LCC based quickstart project. You started with a 0 degree orientation project, configured it for 90 degree orientation and repositioned the widgets. The steps were to launch MPLABX IDE, launch an existing quickstart LCC Harmony3 project, launch MHC, open Composer and set 90 degree orientation, modify UI design, generate, build and program your project.

---

If you are new to MPLAB® Harmony, you should probably start with these tutorials:

• MPLAB® Harmony v3 software framework
• MPLAB® Harmony v3 Configurator Overview
• Create a New MPLAB® Harmony v3 Project

---