Advertisement

Quick Links

Document Information
Abstract
Introduce the steps to build and launch emWin for the NUC126
series microcontroller (MCU).
Apply to
NuMicro
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.
For additional information or questions, please contact: Nuvoton Technology Corporation.
Oct. 18, 2018
NUC126 emWin Quick Start Guide
®
NUC126 series
Nuvoton assumes no responsibility for errors or omissions.
All data and specifications are subject to change without notice.
www.nuvoton.com
Page 1 of 18
NUC126 emWin
Rev 1.00

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the emWin NUC126 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Nuvoton emWin NUC126

  • Page 1 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.
  • Page 2: Table Of Contents

    NUC126 emWin Table of Contents INTRODUCTION ........................3 EMWIN 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) ....................
  • Page 3: Introduction

    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.
  • Page 4: Emwin Bsp Directory Structure

    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.
  • Page 5: Tools (Thirdparty\Emwin\Tool)

    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.
  • Page 6: Emwin Sample Code

    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.
  • Page 7: System Initialization

    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.
  • Page 8: Emwin Initialization

    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);...
  • Page 9: Build Emwin Project

    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) >>...
  • Page 10: Touch Screen

    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.
  • Page 11 NUC126 emWin #define __DEMO_TSFILE_ADDR__ 0x00030000 /* SPI flash 192KB address */ #ifdef __DEMO_160x128__ #define __DEMO_TS_WIDTH__ #define __DEMO_TS_HEIGHT__ #else #define __DEMO_TS_WIDTH__ #define __DEMO_TS_HEIGHT__ #endif int Init_TouchPanel(void); int Read_TouchPanel(int *x, int *y); int Uninit_TouchPanel(void); int Check_TouchPanel(void); #endif If APROM is used to store the calibration parameter, main function will load the parameter from APROM.
  • Page 12 NUC126 emWin ts_readfile(); #endif /* Disable FMC ISP function */ FMC_Close(); /* Lock protected registers */ SYS_LockReg(); Oct. 18, 2018 Page 12 of 18 Rev 1.00...
  • Page 13: Emwin Guibuilder

    NUC126 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.
  • Page 14 NUC126 emWin hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0); EDIT_SetText(hItem, "126"); value = 126; // USER START (Optionally insert additional code for further widget initialization) // USER END break; case WM_NOTIFY_PARENT: = 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)
  • Page 15: Change Display Panel

    NUC126 emWin 5 Change Display Panel 5.1 emWin Display Configuration emWin declares display panel resolution LCDConf.c under 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.
  • Page 16 NUC126 emWin using the EBI interface. For systems connecting display with the SPI or I C interface, spi.c or i2c.c needs to be added to the project. Oct. 18, 2018 Page 16 of 18 Rev 1.00...
  • Page 17 NUC126 emWin Revision History Date Revision Description 2018.10.18 1.00 Initially issued. Oct. 18, 2018 Page 17 of 18 Rev 1.00...
  • Page 18 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.

This manual is also suitable for:

Emwin nuc126 series

Table of Contents