Nuvoton NuEclipse User manual

NuEclipse
Apr. 25, 2022 Page 1 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
NuEclipse
User Manual
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

NuEclipse
Apr. 25, 2022 Page 2 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Table of Contents
1OVERVIEW............................................................................................................5
Supported Chips......................................................................................................5
2REQUIREMENTS ..................................................................................................6
3QUICK START.......................................................................................................7
Installation...............................................................................................................7
3.1.1 Performing the NuEclipse Installer on Microsoft Windows ............................................. 7
3.1.2 Extracting the NuEclipse Tar File on GNU/Linux.............................................................. 8
3.1.3 Verifying the Eclipse Preferences....................................................................................... 9
Running Eclipse.....................................................................................................11
4DEVELOPMENT TUTORIAL...............................................................................12
Select Workspace..................................................................................................12
New Project Wizard...............................................................................................13
Import Existing Projects.........................................................................................15
Build Settings ........................................................................................................16
Debug Configuration..............................................................................................17
4.5.1 Debugger Tab ...................................................................................................................... 18
4.5.2 Startup Tab........................................................................................................................... 19
Debug Views.........................................................................................................20
4.6.1 Registers View..................................................................................................................... 20
4.6.2 Memory View ....................................................................................................................... 21
4.6.3 Disassembly View ............................................................................................................... 22
4.6.4 Peripheral Registers View.................................................................................................. 23
Watchpoints...........................................................................................................29
Debug in RAM.......................................................................................................31
Debug Executable Files Only.................................................................................35
Configuration of Cortex-A, Multi-core SMP and AMP system.................................41
4.10.1 Preliminary Preparation...................................................................................................... 41
4.10.2 Configuration of debugging Single-core Cortex-A ......................................................... 42
4.10.3 Configuration of debugging Dual-core Cortex-A in SMP mode.................................... 45
4.10.4 Configuration of debugging Single-core Cortex-A and Cortex-M in AMP mode ........ 45
4.10.5 Configuration of debugging Dual-core Cortex-A and Cortex-M in AMP mode........... 47
4.10.6 Configuration of debugging Cortex-A Core in AARCH32 mode................................... 48
4.10.7 System Registers Access .................................................................................................. 51
5Q&A .....................................................................................................................52
6REVISION HISTORY ...........................................................................................56

NuEclipse
Apr. 25, 2022 Page 3 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
List of Figures
Figure 3-1 NuEclipse Setup Wizard ............................................................................................. 7
Figure 3-2 Install.sh Script........................................................................................................... 8
Figure 3-3 Preferences for Global Tools Paths............................................................................. 9
Figure 3-4 Preferences for OpenOCD Nu-Link........................................................................... 10
Figure 3-5 Eclipse.exe and Related Folders............................................................................... 11
Figure 4-1 Selecting a Workspace............................................................................................. 12
Figure 4-2 New Project Wizard.................................................................................................. 13
Figure 4-3 Target Processor Settings......................................................................................... 14
Figure 4-4 Importing Projects..................................................................................................... 15
Figure 4-5 Build Settings ........................................................................................................... 16
Figure 4-6 Debug Configuration................................................................................................. 17
Figure 4-7 Configuring the Debugger Tab.................................................................................. 18
Figure 4-8 Configuring the Startup Tab...................................................................................... 19
Figure 4-9 Registers View.......................................................................................................... 20
Figure 4-10 Memory View.......................................................................................................... 21
Figure 4-11 Clicking the Instruction Stepping Mode Button......................................................... 22
Figure 4-12 Disassembly View................................................................................................... 22
Figure 4-13 Opening the Packs Perspective .............................................................................. 23
Figure 4-14 How to Download Packages ................................................................................... 24
Figure 4-15 Locations of Repositories........................................................................................ 25
Figure 4-16 Installing SFR Files................................................................................................. 26
Figure 4-17 Device Selection..................................................................................................... 27
Figure 4-18 Peripheral Registers View....................................................................................... 28
Figure 4-19 Toggle Watchpoint.................................................................................................. 29
Figure 4-20 Properties for C/C++ Watchpoint............................................................................. 30
Figure 4-21 Added Watchpoint in the Breakpoints View ............................................................. 30
Figure 4-22 Memory Layout....................................................................................................... 31
Figure 4-23 Modifying the ld Script............................................................................................. 32
Figure 4-24 Debug Configuration Settings ................................................................................. 33
Figure 4-25 Debugging in RAM.................................................................................................. 34
Figure 4-26 Importing Executable for Debugging ....................................................................... 35
Figure 4-27 Selecting Executable .............................................................................................. 36
Figure 4-28 Choosing GDB Nuvoton Nu-Link Debugging........................................................... 37
Figure 4-29 Locating the GDB Executable ................................................................................. 38
Figure 4-30 Choosing the ELF File to Download........................................................................ 39
Figure 4-31 Adding Source Lookup Path.................................................................................... 40

NuEclipse
Apr. 25, 2022 Page 4 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Figure 4-32 Configuring the Startup Tab for MA35D1................................................................. 42
Figure 4-33 How to Disable Command Timeout......................................................................... 43
Figure 4-34 Disable CPU1 Setting............................................................................................. 44
Figure 4-35 Configuring the Debugger Tab for Single-core Debugging on MA35D1 ................... 44
Figure 4-36 Configuring the Debugger Tab for Multi-core Debugging on M4 core....................... 45
Figure 4-37 Configuring the Launch Group ................................................................................ 46
Figure 4-38 How to Disable SMP............................................................................................... 47
Figure 4-39 Multi-core Debugging.............................................................................................. 47
Figure 4-40 Locating the AARCH64 GDB Executable ................................................................ 49
Figure 4-41 The First Time to Enter the Debug Mode Settings................................................... 49
Figure 4-42 The Second Time to Enter the Debug Mode Settings.............................................. 50
Figure 4-43 AARCH32 Program Debugging............................................................................... 50
Figure 4-44 System Register View............................................................................................. 51
Figure 4-45 Use Command to Access System Registers ........................................................... 51
Figure 5-1 Adding Udev Rules................................................................................................... 53
Figure 5-2 Preferences for String Substitution............................................................................ 54
Figure 5-3 More Options for NuLink2......................................................................................... 55

NuEclipse
Apr. 25, 2022 Page 5 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
1 OVERVIEW
The NuEclipse is designed for cross-platform embedded ARM development. It includes a series of
Eclipse plug-ins and tools. The plug-ins allow the user to create, build, and debug ARM-based projects
within the Eclipse framework. Its features are listed below:
Creating projects by the New Project Wizard: The New Project Wizard provides several
templates for different target chips.
Building projects by the GNU ARM Toolchain: The toolchain contains the ARM Embedded
GCC compiler. The user can use it to build projects without restriction.
Debugging projects by GDB: The user can halt, step, run, and monitor target chips.
Accessing memory and flash is allowed. Setting hardware breakpoints and watchpoints is
supported. In addition, the user can erase target chips and program the user
configuration.
Through the NuEclipse, the user can develop projects of the NuMicro®Family within the Eclipse
framework.
Supported Chips
To see the list of supported chips, please refer to Supported_chips.htm in the folder of user manual.

NuEclipse
Apr. 25, 2022 Page 6 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
2 REQUIREMENTS
The following table lists system requirements for the user to run the NuEclipse.
Minimum Requirements
Recommended Specifications
Operating System
Windows® 7 x64 or GNU/Linux
Windows® 10 x64 or Ubuntu 18.04 LTS
GNU ARM Embedded Toolchain
6-2017-q1-major
The latest version
Note: To have a fully usable and pleasant experience on Linux, the recommended Linux distribution is
Ubuntu 18.04 LTS (64-bit).

NuEclipse
Apr. 25, 2022 Page 7 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
3 QUICK START
Installation
To make the NuEclipse ready for work, perform the following steps based on your operating system:
1. Performing the NuEclipse installer on Microsoft Windows.
2. Extracting the NuEclipse tar file on GNU/Linux.
3.1.1 Performing the NuEclipse Installer on Microsoft Windows
On Windows, it is very easy to install the NuEclipse only by performing the NuEclipse installer. The
installer will ask the user to install the GNU ARM Eclipse Windows Build Tools and GNU ARM
Embedded Toolchain because they are required by NuEclipse.
Figure 3-1 NuEclipse Setup Wizard

NuEclipse
Apr. 25, 2022 Page 8 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
3.1.2 Extracting the NuEclipse Tar File on GNU/Linux
On GNU/Linux, it is very easy to install the NuEclipse only by extracting the NuEclipse tar file. After that,
run the install.sh script to complete the installation process. Please do not use the sudo command to
run the script.
Figure 3-2 Install.sh Script
.

NuEclipse
Apr. 25, 2022 Page 9 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
3.1.3 Verifying the Eclipse Preferences
After the installation, the Eclipse preferences are automatically written on Windows. To verify them, click
Window > Preferences, the Preferences wizard appears. Go to C/C++ > Build > Global Tools Paths
and make sure the Build tools and Toolchain folder be correctly configured to what the installer has
installed in the previous step. Click the Apply button to take effect. On GNU/Linux, Build tools folder
path is not required. The path should be empty.
Figure 3-3 Preferences for Global Tools Paths

NuEclipse
Apr. 25, 2022 Page 10 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Subsequently, go to Run/Debug > OpenOCD Nu-Link and make sure the OpenOCD folder be
configured to where the installer has put the OpenOCD executable. On Microsoft Windows, for example,
the path of OpenOCD folder could be C:/Program Files (x86)/Nuvoton Tools/OpenOCD. Similarly, on
GNU/Linux it could be /usr/local/OpenOCD. The OpenOCD executable provided by Nuvoton is
customized for Nu-Link. If the user tries to use other OpenOCD executable, OpenOCD and Nu-Link may
not cooperate well. Click the Apply button to take effect.
Figure 3-4 Preferences for OpenOCD Nu-Link

NuEclipse
Apr. 25, 2022 Page 11 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Running Eclipse
To run NuEclipse, double-click the eclipse.exe. Note that the .exe file and the related folders, such as
the OpenOCD folder, should stay in the same directory; otherwise, the application will not work properly.
Figure 3-5 Eclipse.exe and Related Folders

NuEclipse
Apr. 25, 2022 Page 12 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
4 DEVELOPMENT TUTORIAL
Select Workspace
When Eclipse launches, we have to select a workspace which groups a set of related projects together
that usually make up an application. In addition, some configuration settings for Eclipse and projects are
stored here, too. For different computers, the configuration settings may change. We should create our
own workspace rather than copying another user’s workspace. Only one workspace can be active at
one time. The current workspace for Eclipse can be switched by clicking File->Switch Workspace.
Figure 4-1 Selecting a Workspace

NuEclipse
Apr. 25, 2022 Page 13 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
New Project Wizard
As a beginner, the fastest way to create a C/C++ project is using the New Project Wizard. For instance,
to create a C project, click File > New > C Project. The New Project Wizard appears. Here we choose
Hello World Nuvoton Cortex-M C Project for Project type. Input the project name and click the Next
> button to continue.
Figure 4-2 New Project Wizard

NuEclipse
Apr. 25, 2022 Page 14 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Based on the actual target chip, we select the corresponding chip series. For some chip series, e.g.,
M2351_NonSecure, we need to input the additional library path. If not, the build process may fail. In
addition, input the real values to Flash and RAM size. If not, the default values will be used. When all
the settings are done, click the Next > buttons until clicking the Finish button.
Figure 4-3 Target Processor Settings

NuEclipse
Apr. 25, 2022 Page 15 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Import Existing Projects
When BSP projects are available, we can import them into the workspace using the following steps:
1. From the main menu bar, select File > Import. The Import wizard shows up.
2. Select General > Existing Project into Workspace and click Next.
3. Choose either Select root directory or Select archive file and click the
associated Browse to locate the directory or file containing the projects. In the Nuvoton BSP, the
Eclipse projects are stored in the GCC folder.
4. Under Projects select the project or projects which you would like to import and click Finish.
Figure 4-4 Importing Projects

NuEclipse
Apr. 25, 2022 Page 16 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Build Settings
After projects have been created, we still have a chance to alter the build settings by clicking Project >
Properties. The Properties wizard shows up. Then go to C/C++ Build > Settings. From there, we can
alter the build settings according to the actual target chip. Then click the Apply button to take effect.
After applying build settings, we should be able to build projects successfully.
Figure 4-5 Build Settings

NuEclipse
Apr. 25, 2022 Page 17 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Debug Configuration
Before launching an application into the debug mode, we have to prepare a debug configuration, which
contains all the necessary information about the debug mode. Click Run > Debug Configuration…to
open the debug configuration dialog. Double click on the GDB Nuvoton Nu-Link Debugging group.
The Nuvoton Nu-Link debug configuration appears on the right-hand side. In the Main tab, the name of
Project should coincide with the project name. The C/C++ Application should point to the elf application
generated by the build process. If the project name or C/C++ Application is incorrect, please select the
expected project first in the project view, build the project to generate the executable, and expand the
tree to make sure the existence of the generated executable. Then repeat the former operations again.
Figure 4-6 Debug Configuration

NuEclipse
Apr. 25, 2022 Page 18 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
4.5.1 Debugger Tab
The Debugger tab is used to provide the OpenOCD and GDB Client setup. OpenOCD requires correct
configuration files to know how to work with adapters and target chips. The configuration files are
specified in the Config options field. Nuvoton’s adapter is Nu-Link, which uses the interface
configuration file named nulink.cfg. In addition, Nuvoton has three different ARM families, such as M0,
M4, and M23. The corresponding target configuration files are numicroM0.cfg, numicroM4.cfg, and
numicroM23.cfg. For M23 2nd development, the target configuration file would be
numicroM23_NS.cfg. For MA35D1 development, see Section 4.10.
Figure 4-7 Configuring the Debugger Tab

NuEclipse
Apr. 25, 2022 Page 19 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
4.5.2 Startup Tab
As the first step, we should choose the right Chip Series in the Startup tab. When done, the
corresponding target configuration file will be automatically written in the Config options field of the
Debugger tab. To load executable to flash, we need to select the Load executable to flash checkbox.
To load executable to RAM, we need to select the Load executable to SRAM checkbox. When all the
settings are done, click the Apply button to take effect. To launch the application into the debug mode,
click the Debug button.
Figure 4-8 Configuring the Startup Tab

NuEclipse
Apr. 25, 2022 Page 20 of 57 Rev 1.02.019
NUECLIPSE USER MANUAL
Debug Views
Eclipse provides many debug views. Each of them contains specific information for debugging.
4.6.1 Registers View
When entering the debug mode, we can open the Registers view in the bottom of Debug perspective.
The Registers view lists information about the registers in a selected stack frame.
Figure 4-9 Registers View