Nuvoton EmWin NUC126 Bedienungsanleitung

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__

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere Nuvoton Mikrocontroller Handbücher

Nuvoton

Nuvoton NuMicro MS51 32K Series Produkthandbuch

Nuvoton

Nuvoton Nu-LB-M051 Bedienungsanleitung

Nuvoton

Nuvoton NuMicro MS51 Series Produkthandbuch

Nuvoton

Nuvoton ARM ARM926EL-S Bedienungsanleitung

Nuvoton

Nuvoton ARM Cortex-M NuMicro NUC472 Series Bedienungsanleitung

Nuvoton

Nuvoton Numicro NuMaker-NUC1311L Bedienungsanleitung

Nuvoton

Nuvoton NuMicro M252 Series Bedienungsanleitung

Nuvoton

Nuvoton NuMicro NUC126 Series Produkthandbuch

Nuvoton

Nuvoton NuMicro series Bedienungsanleitung

Nuvoton

Nuvoton NUTINY-SDK-M058SF Bedienungsanleitung

Nuvoton

Nuvoton NuMicro NUC100 Series Bedienungsanleitung

Nuvoton

Nuvoton Mini51 Series Produkthandbuch

Nuvoton

Nuvoton NuMicro Nu-Link-Gang Bedienungsanleitung

Nuvoton

Nuvoton NuMicro M261 Series Bedienungsanleitung

Nuvoton

Nuvoton NuMicro M2351 Series Bedienungsanleitung

Nuvoton

Nuvoton NuMicro 8051 Series Bedienungsanleitung

Nuvoton

Nuvoton NuMicro series Bedienungsanleitung

Nuvoton

Nuvoton NuTiny-SDK-NUC240 Bedienungsanleitung

Nuvoton

Nuvoton NuMaker-M031TC Bedienungsanleitung

Nuvoton

Nuvoton NuMicro M0A21 Series Produkthandbuch

Nuvoton

Nuvoton NuMaker-MS51PC Bedienungsanleitung

Nuvoton

Nuvoton NuMicro ISP Bedienungsanleitung

Nuvoton

Nuvoton NuMaker-M031SD Bedienungsanleitung

Nuvoton

Nuvoton NUC970 series Produkthandbuch

Beliebte Mikrocontroller Handbücher anderer Marken

AMS

AMS AS7261 Demo Kit Bedienungsanleitung

Novatek

Novatek NT6861 Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266 SDK Einrichtungshandbuch

STMicrolectronics

STMicrolectronics ST7 Assembler Linker Bedienungsanleitung

Texas Instruments

Texas Instruments Chipcon CC2420DK Bedienungsanleitung

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM Bedienungsanleitung

NEC

NEC 78GK0S/K 1+ Series Montage- und Bedienungsanleitung

Mikroe

Mikroe SEMITECH N-PLC Click Montage- und Bedienungsanleitung

Intel

Intel Agilex Bedienungsanleitung

Cypress

Cypress CY4607 HX2VL Bedienungsanleitung

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE Bedienungsanleitung

Texas Instruments

Texas Instruments TMS320F2837 D Series Bedienungsanleitung

CYPRES

CYPRES CY14NVSRAMKIT-001 Bedienungsanleitung

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266EX Betriebsanleitung

Abov

Abov AC33M8128L Bedienungsanleitung

Laird

Laird BL654PA Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F800 Bedienungsanleitung

Nuvoton emWin NUC126 Bedienungsanleitung

Beliebte Mikrocontroller Handbücher anderer Marken