Setting Orientation GLCD Display Driver
Setting Orientation for GLCD Display DriverSet orientation for an GLCD Display Driver based UI design. The guide steps through the changing of a 0 degree orientation reference demo to a 90 degree orientation. You’ll start by launching MPLABX IDE, launch a quickstart Harmony v3 project, launch MHC, launch composer, configure orientation properties, generate, and build and program.
Launch MPLABX on your development PC.
Load the quickstart project. You have the option of loading any MPLABX project. In this example we will load legato_qs_mzda_cu_tm4301b.X.
Under File menu, select Open Project.
In the file dialog, select project .X file. In our example, we will use: legato_qs_mzda_cu_tm4301b.X.
Launch MHC from MPLABX. This is an GLCD 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 from MPLABX. MHC is launched to enable the opening of Composer. All composer settings are independent of a display driver.
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:
Reposition the existing landscape UI widgets to align to the new portrait orientation.
Note: The backgroundPanel widget size should be modified as illustrated:
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 the quickstart workspace.
Under Project menu, select Rebuild All.
Select Run Main Project. This button will build, program, and run the application.
In this guide, you learned to set a 90 degree orientaion for a GLCD based design. 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 GLCD Harmony v3 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
