Nuvoton emWin NUC126 User manual

Oct. 18, 2018 Page 1of 18 Rev 1.00
NUC126 emWin
Document Information
Abstract
Introduce the steps to build and launch emWin for the NUC126
series microcontroller (MCU).
Apply to
NuMicro®NUC126 series
The information described in this document is the exclusive intellectual property of
Nuvoton Technology Corporation and shall not be reproduced without permission from Nuvoton.
Nuvoton is providing this document only for reference purposes of NuMicro microcontroller based system design.
Nuvoton assumes no responsibility for errors or omissions.
All data and specifications are subject to change without notice.
For additional information or questions, please contact: Nuvoton Technology Corporation.
www.nuvoton.com
NUC126 emWin Quick Start Guide

Oct. 18, 2018 Page 2of 18 Rev 1.00
NUC126 emWin
Table of Contents
1INTRODUCTION...................................................................................................................... 3
2EMWIN BSP DIRECTORY STRUCTURE ....................................................................... 4
2.1 Sample Codes (sampleCode\NuEdu)....................................................................................... 4
2.2 Configuration Files (ThirdParty\emWin\Config)..................................................................... 4
2.3 Documents (ThirdParty\emWin\Doc)........................................................................................ 4
2.4 Include Files (ThirdParty\emWin\Include) ............................................................................... 4
2.5 Library (ThirdParty\emWin\Lib)................................................................................................. 4
2.6 Tools (ThirdParty\emWin\Tool) ................................................................................................. 5
3EMWIN SAMPLE CODE ....................................................................................................... 6
3.1 Project Structure.......................................................................................................................... 6
3.2 System Initialization.................................................................................................................... 7
3.3 emWin Initialization ..................................................................................................................... 8
3.4 Build emWin Project.................................................................................................................... 9
3.5 Download and Run ...................................................................................................................... 9
3.6 Touch Screen.............................................................................................................................. 10
4EMWIN GUIBUILDER..........................................................................................................13
4.1 Create Widget............................................................................................................................. 13
4.2 Handle Widget Event................................................................................................................. 13
5CHANGE DISPLAY PANEL...............................................................................................15
5.1 emWin Display Configuration.................................................................................................. 15
5.2 Display Driver............................................................................................................................. 15

Oct. 18, 2018 Page 3of 18 Rev 1.00
NUC126 emWin
1 Introduction
emWin is a graphic library with graphical user interface (GUI) designed to provide an efficient,
processor and display controller-independent GUI for any application that operates with a
graphical display.
Nuvoton provides emWin GUI library for free with the NUC126 series microcontroller (MCU)
supporting up to 320x240 (16 bpp) resolution. The emWin platform can be implemented on
HMI for industrial, machines, appliances, etc.

Oct. 18, 2018 Page 4of 18 Rev 1.00
NUC126 emWin
2 emWin BSP Directory Structure
This chapter introduces emWin related files and directories in the NUC126 BSP.
2.1 Sample Codes (sampleCode\NuEdu)
emWin_GUIDemo
Utilize emWin library to demonstrate widgets feature.
emWin_SimpleDemo
Utilize emWin library to demonstrate interactive feature.
2.2 Configuration Files (ThirdParty\emWin\Config)
GUI_X.c
Configuration and system dependent code for GUI.
GUIConf.c
Display controller initialization source code.
GUIConf.h
A header file configures emWins features, fonts, etc.
LCDConf.c
Display controller configuration source code.
LCDConf.h
Display driver configuration header file.
2.3 Documents (ThirdParty\emWin\Doc)
AN03002_Custom_
Widget_Type.pdf
emWin custom widget type creation guide.
UM03001_emWin5.pdf
emWin user guide and reference manual.
2.4 Include Files (ThirdParty\emWin\Include)
This directory contains header files for emWin project.
2.5 Library (ThirdParty\emWin\Lib)
NUemWin_CM0_Keil.lib
emWin library for NUC126 series MCU.

Oct. 18, 2018 Page 5of 18 Rev 1.00
NUC126 emWin
2.6 Tools (ThirdParty\emWin\Tool)
BmpCvtNuvoton.exe
The Bitmap Converter is designed for converting common image
file formats like BMP, PNG or GIF into the desired emWin bitmap
format.
emWinPlayer.exe
This tool can show the previously created emWin Movie File (EMF)
on a Computer with a Windows operating system.
GUIBuilder.exe
A tool for creating dialogs by drag and drop operation.
JPEG2Movie.exe
A tool to convert JPEG files to an EMF file.

Oct. 18, 2018 Page 6of 18 Rev 1.00
NUC126 emWin
3 emWin Sample Code
There are two emWin sample code in the NUC126 BSP SampleCode\NuEdu directory:
emWin_GUIDemo: utilizes the emWin library to demonstrate widgets feature;
emWin_SimpleDemo: utilizes the emWin library to demonstrate interactive feature.
3.1 Project Structure
The following uses emWin_SimpleDemo as a sample to explain the emWin project structure
in BSP. This sample contains a frame window, four buttons, a text and a text editor. User can
update the number shown in the text field by clicking four buttons shown on the display panel.
The project structure is shown in the following figure. The CMSIS group contains system
startup code. The user group contains the main file. The Libraries group contains low level
driver. The emWin group contains emWin library and panel configuration for the NuMicro®
family. The Application group contains the C code generated by emWin GUIBuilder. The tslib
group is the touch screen library.

Oct. 18, 2018 Page 7of 18 Rev 1.00
NUC126 emWin
The project contains two targets:
emWin_SimpleDemo_ILI9341: use ILI9341 touch panel;
emWin_SimpleDemo_ST7735:use ST7735 touch panel.
User can switch between different targets using the pull down menu marked in the red
rectangle shown below.
3.2 System Initialization
The system initialization code is located in main function, including peripheral clock
preparation, multi- function pin configuration, and UART debug port setting. Also, a 1000Hz
timer is configured to keep track of time elapsed.
int main(void)
{

Oct. 18, 2018 Page 8of 18 Rev 1.00
NUC126 emWin
// Init System, IP clock and multi-function I/O
_SYS_Init();
//
// Init UART to 115200-8n1 for print message
//
UART_Open(UART0, 115200);
// Enable Timer0 clock and select Timer0 clock source
//
CLK_EnableModuleClock(TMR0_MODULE);
CLK_SetModuleClock(TMR0_MODULE, CLK_CLKSEL1_TMR0SEL_HXT, 0);
//
// Initial Timer0 to periodic mode with 1000Hz
//
TIMER_Open(TIMER0, TIMER_PERIODIC_MODE, 1000);
//
// Enable Timer0 interrupt
//
TIMER_EnableInt(TIMER0);
NVIC_EnableIRQ(TMR0_IRQn);
//
// Start Timer0
//
TIMER_Start(TIMER0);
//
// multi- function pin configuration
//
GPIO_SetMode(PB, BIT13, GPIO_MODE_INPUT);
GPIO_SetMode(PB, BIT14, GPIO_MODE_INPUT);
GPIO_SetMode(PC, BIT9, GPIO_MODE_INPUT);
GPIO_SetMode(PC, BIT12, GPIO_MODE_INPUT);
GPIO_SetMode(PC, BIT10, GPIO_MODE_INPUT);
GPIO_SetMode(PC, BIT11, GPIO_MODE_INPUT);
GPIO_SetMode(PC, BIT13, GPIO_MODE_INPUT);
MainTask();
while(1);
}
3.3 emWin Initialization
To initialize emWin GUI, the application needs to call GUI_Init() and CreatFramewin()

Oct. 18, 2018 Page 9of 18 Rev 1.00
NUC126 emWin
function. The code is in MainTask() in main.c.
void MainTask(void)
{
extern GUI_CONST_STORAGE GUI_BITMAP bmnuvoton_logo;
WM_HWIN hWin;
char acVersion[40] = "Nuvoton NUC126";
GUI_Init();
GUI_SetBkColor(GUI_WHITE);
GUI_Clear();
#ifdef __DEMO_160x128__
GUI_DrawBitmap(&bmnuvoton_logo, 1, 55);
#else
GUI_DrawBitmap(&bmnuvoton_logo, (320 - bmnuvoton_logo.XSize) >> 1, (240 -
bmnuvoton_logo.YSize) >> 1);
#endif
GUI_Delay(3000);
GUI_SetBkColor(GUI_BLACK);
GUI_Clear();
hWin = CreateFramewin();
FRAMEWIN_SetText(hWin, acVersion);
while(1)
{
GUI_Delay(1000);
}
}
3.4 Build emWin Project
To build the emWin project in Keil MDK, click the rebuild icon as shown below or press F7
function key.
3.5 Download and Run

Oct. 18, 2018 Page 10 of 18 Rev 1.00
NUC126 emWin
Press Ctrl + F5 to download the application and start a debug session or click start/stop
debug session icon as shown below.
After entering debug session, press F5 to start code execution.
The following figure shows the application halts in main() function after starting a debug
session.
3.6 Touch Screen
To support resistive touch screen, use ADC to convert the voltage of X axis and Y axis, and
then use the open source tslib to map the ADC conversion result into the coordination. The
conversion result can be affected by power noise, mechanical misalignment, etc. To
overcome this issue, the tslib supports calibration function, and the calibration parameter is
stored in APROM offset 0x00030000.
The touch resolution and the APROM offset store calibration parameters in the TouchPanel.h.
#ifndef __NUC126TOUCHPANEL_H__
#define __NUC126TOUCHPANEL_H__