Nuvoton NuMicro M2351 Series Quick Start Manual
  1. Manuals
  2. Brands
  3. Nuvoton Manuals
  4. Microcontrollers
  5. NuMicro M2351 Series
  6. Quick start manual

Nuvoton NuMicro M2351 Series Quick Start Manual

For emwin
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Document Information
Abstract
Introduce the steps to build and launch emWin for the M2351
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
M2351 emWin Quick Start Guide
®
M2351 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
M2351 emWin
Rev 1.00

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the NuMicro M2351 Series and is the answer not in the manual?

Questions and answers

Related Manuals for Nuvoton NuMicro M2351 Series

Summary of Contents for Nuvoton NuMicro M2351 Series

  • 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

    M2351 emWin Table of Contents INTRODUCTION ........................3 EMWIN 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) ....................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 M2351 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

    M2351 emWin 2 emWin BSP Directory Structure This chapter introduces emWin related files and directories in the M2351 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.

  • Page 5: Tools (Thirdparty\Emwin\Tool)

    M2351 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

    M2351 emWin 3 emWin Sample Code There are two emWin sample code in the M2351 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.

  • Page 7: System Initialization

    M2351 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 M2351 emWin 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 UART_Open(UART0, 115200); // Enable Timer0 clock and select Timer0 clock source CLK_EnableModuleClock(TMR0_MODULE);...

  • Page 9: 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) extern GUI_CONST_STORAGE GUI_BITMAP bmM2351_320x240; WM_HWIN hWin; char *acVersion = "Nuvoton M2351"; int32_t i32Scale; GUI_Init(); GUI_SetBkColor(GUI_BLACK); GUI_Clear(); #ifdef __DEMO_160x128__ i32Scale = 500;...

  • Page 10: Download And Run

    M2351 emWin 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.
  • Page 11 M2351 emWin 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 0x0007F800. The touch resolution and the APROM offset store calibration parameters in the M2351TouchPanel.h.
  • Page 12 M2351 emWin ts_writefile(); FMC_DISABLE_AP_UPDATE(); else ts_readfile(); /* 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

    M2351 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 M2351 emWin hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0); EDIT_SetText(hItem, “2351”); value = 2351; // 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

    M2351 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 M2351TouchPanel.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 M2351 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 M2351 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.

Table of Contents