Nuvoton NuMicro M032 Series User manual

Oct. 03, 2019 Page 1of 17 Rev 1.00
M032 emWin
Document Information
Abstract
Introduce the steps to build and launch emWin for the M032 series
microcontroller (MCU).
Apply to
NuMicro®M032 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
M032 emWin Quick Start Guide

Oct. 03, 2019 Page 2of 17 Rev 1.00
M032 emWin
Table of Contents
1INTRODUCTION.................................................................................................................... 3
2EMWIN BSP DIRECTORY STRUCTURE...................................................................... 4
2.1 Sample Codes (SampleCode\NuMaker)...................................................................................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).................................................................................................5
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........................................................................................................12
4.1 Create Widget.............................................................................................................................12
4.2 Handle Widget Event.................................................................................................................12
5CHANGE DISPLAY PANEL.............................................................................................14
5.1 emWin Display Configuration..................................................................................................14
5.2 Display Driver.............................................................................................................................14
6SUPPORTING RESOURCES..........................................................................................15

Oct. 03, 2019 Page 3of 17 Rev 1.00
M032 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 M032 series microcontroller (MCU)
supporting up to 320x240 (16 bpp) resolution. The emWin platform can be implemented on HMI
for industrial, machines, appliances, etc.

Oct. 03, 2019 Page 4of 17 Rev 1.00
M032 emWin
2 emWin BSP Directory Structure
This chapter introduces emWin related files and directories in the M032 BSP.
2.1 Sample Codes (SampleCode\NuMaker)
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 emWin 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.
Release.html
emWin release notes
UM_Font_Architect_
EN_Rev1.02.pdf
Nuvoton font tool “FontArchitect.exe” user guide and reference
manual in English.
UM_Font_Architect_
TC_Rev1.02.pdf
Nuvoton font tool “FontArchitect.exe” user guide and reference
manual in Chinese.
Changelog.pdf
Nuvoton emWin change log.
2.4 Include Files (ThirdParty\emWin\Include)
This directory contains header files for emWin project.

Oct. 03, 2019 Page 5of 17 Rev 1.00
M032 emWin
2.5 Library (ThirdParty\emWin\Lib)
NUemWin_CM0_Keil.lib
emWin library Keil for M032 series MCU.
libNUemWin_CM0_GNU.a
emWin library GNU for M032 series MCU.
NUemWin_CM0_IAR.a
emWin library IAR for M032 series MCU.
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.
FontArchitect.exe
A Nuvoton tool for creating emWin bitmap font format.
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. 03, 2019 Page 6of 17 Rev 1.00
M032 emWin
3 emWin Sample Code
There are two emWin sample codes in the M032 BSP SampleCode\NuMaker 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 project contains two targets:
emWin_SimpleDemo_ILI9341: utilizes 240 x 320 LCD;
emWin_SimpleDemo_ST7735:utilizes 128 x 160 LCD.
The Libraries group contains low level driver and system startup code. 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. The lcm group is the display driver. The User group contains the main file.

Oct. 03, 2019 Page 7of 17 Rev 1.00
M032 emWin
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)
{
// Init System, IP clock and multi-function I/O
_SYS_Init();
//
// Init UART to 115200-8n1 for print message
//

Oct. 03, 2019 Page 8of 17 Rev 1.00
M032 emWin
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);
printf("\n\nCPU @ %d Hz\n", SystemCoreClock);
MainTask();
while(1);
}
3.3 emWin Initialization
To initialize emWin GUI, the application needs to call GUI_Init() and CreatFramewin() function.
The code is in MainTask() in main.c.
void MainTask(void)
{
WM_HWIN hWin;
Char acVersion[40] = "Framewin: Version of emWin: ";
printf("Main Task -> \n");
GUI_Init();
strcat(acVersion, GUI_GetVersionString());
hWin = CreateFramewin();
FRAMEWIN_SetText(hWin, acVersion);

Oct. 03, 2019 Page 9of 17 Rev 1.00
M032 emWin
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
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.

Oct. 03, 2019 Page 10 of 17 Rev 1.00
M032 emWin
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 ether
in APROM.
emWin_SimpleDemo uses the calibration parameter in the APROM offset 0x00030000.
The touch resolution and the APROM offset store calibration parameters in the TouchPanel.h.
#ifndef __M032TOUCHPANEL_H__
#define __M032TOUCHPANEL_H__
#define __DEMO_TSFILE_ADDR__ 0x00030000 /* SPI flash 192KB address */
#ifdef __DEMO_160x128__
#define __DEMO_TS_WIDTH__ 160
#define __DEMO_TS_HEIGHT__ 128
#else
#define __DEMO_TS_WIDTH__ 320
#define __DEMO_TS_HEIGHT__ 240
#endif
#endif
If APROM is used to store the calibration parameter, main function will load the parameter from
APROM. If the parameter doesn’t exist, main function will call ts_calibrate() to generate a copy.
/* Unlock protected registers */
SYS_UnlockReg();
/* Enable FMC ISP function */
FMC_Open();
/* If calibration parameter exists, call ts_calibrate to generate a copy */
if (FMC_Read(__DEMO_TSFILE_ADDR__ + 0x1C) != 0x55AAA55A)
{
FMC_ENABLE_AP_UPDATE();
ts_calibrate(__DEMO_TS_WIDTH__, __DEMO_TS_HEIGHT__);
// Erase page
FMC_Erase(__DEMO_TSFILE_ADDR__);
ts_writefile();

Oct. 03, 2019 Page 11 of 17 Rev 1.00
M032 emWin
FMC_DISABLE_AP_UPDATE();
}
else
{
ts_readfile();
}
/* Disable FMC ISP function */
FMC_Close();
/* Lock protected registers */
SYS_LockReg();

Oct. 03, 2019 Page 12 of 17 Rev 1.00
M032 emWin
4 emWin GUIBuilder
4.1 Create Widget
Segger provides a Windows tool GUIBuilder to create application with drag and drop interface.
The tool is located under the ThirdParty\emWin\Tool\ directory. This tool can generate a file
named FramewinDLG.c for the widget of target application. Please refer to chapter 20 of
UM03001_emWin5.pdf for the usage of GUIBuilder.
4.2 Handle Widget Event
FramewinDLG.c is only the framework of widget and programmers still need to add their desired
widget event handler in this file after copying the FramewinDLG.c file into the project directory.
Below is the event handling code of emWin_SimpleDemo.
......
switch (pMsg->MsgId)
{
case WM_INIT_DIALOG:
//
// Initialization of 'Edit'
//
value = 32;

Oct. 03, 2019 Page 13 of 17 Rev 1.00
M032 emWin
sprintf(sBuf,"%d ", value);
hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0);
EDIT_SetText(hItem, sBuf);
// USER START (Optionally insert additional code for further widget initialization)
// USER END
break;
case WM_NOTIFY_PARENT:
Id = WM_GetId(pMsg->hWinSrc);
NCode = pMsg->Data.v;
switch(Id)
{
case ID_BUTTON_0: // Notifications sent by '+ 1'
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
// USER START (Optionally insert code for reacting on notification message)
// USER END
value += 1;
sprintf(sBuf,"%d ", value);
hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0);
EDIT_SetText(hItem, sBuf);
break;
case WM_NOTIFICATION_RELEASED:
// USER START (Optionally insert code for reacting on notification message)
// USER END
break;
// USER START (Optionally insert additional code for further notification
handling)
// USER END
break;
......

Oct. 03, 2019 Page 14 of 17 Rev 1.00
M032 emWin
5 Change Display Panel
5.1 emWin Display Configuration
emWin declares its display panel resolution in LCDConf.c under the ThirdParty\emWin\Config\
directory. The resolution is different from the touch panel resolution defined in the
TouchPanel.h. This is because the panel is a portrait display and data is swapped before output
for a landscape view by LCD driver IC.
......
// Physical display size
#define XSIZE_PHYS 240
#define YSIZE_PHYS 320
In the LCDConf.c file, the panel orientation and control functions are also defined. These
settings need to be modified according to the display panel attached to the system.
......
void LCD_X_Config(void)
{
......
// Orientation
Config.Orientation = GUI_MIRROR_Y | GUI_SWAP_XY;
GUIDRV_FlexColor_Config(pDevice, &Config);
// Set controller and operation mode
PortAPI.pfWrite8_A0 = _Write0;
PortAPI.pfWrite8_A1 = _Write1;
PortAPI.pfWriteM8_A1 = _WriteM1;
PortAPI.pfReadM8_A1 = _ReadM1; /* FIXME if panel supports read back feature */
GUIDRV_FlexColor_SetFunc(pDevice,
&PortAPI,
GUIDRV_FLEXCOLOR_F66709,
GUIDRV_FLEXCOLOR_M16C0B8);
......
5.2 Display Driver
The project file includes the usci_spi.c driver since demo system is connected to a MPU display
using the SPI interface. For systems connecting display with the SPI interface, usci_spi.c needs
to be added to the project.

Oct. 03, 2019 Page 15 of 17 Rev 1.00
M032 emWin
6 Supporting Resources
Segger provides an emWin supportingforum. Questions regarding emWin usage are discussed
at: https://forum.segger.com/index.php/Board/12-emWin-related/.
The M032 system related issues can be posted in Nuvoton’s HMI/GUI forum at:
http://forum.nuvoton.com/viewforum.php?f=31.

Oct. 03, 2019 Page 16 of 17 Rev 1.00
M032 emWin
Revision History
Date
Revision
Description
2019.10.03
1.00
1. Initially issued.

Oct. 03, 2019 Page 17 of 17 Rev 1.00
M032 emWin
Important Notice
Nuvoton Products are neither intended nor warranted for usage in systems or equipment, any malfunction
or failure of which may cause loss of human life, bodily injury or severe property damage. Such
applications are deemed, “Insecure Usage”.
Insecure usage includes, but is not limited to: equipment for surgical implementation, atomic energy
control instruments, airplane or spaceship instruments, the control or operation of dynamic, brake or
safety systems designed for vehicular use, traffic signal instruments, all types of safety devices, and other
applications intended to support or sustain life.
All Insecure Usage shall be made at customer’s risk, and in the event that third parties lay claims to
Nuvoton as a result of customer’s Insecure Usage, customer shall indemnify the damages and liabilities
thus incurred by Nuvoton.