Nuvoton NuMicro MA35D1 RTP User manual

MA35D1
May 30, 2022 Page 1of 31 Rev 1.01
MA35D1 RTP USER MANUAL
NuMicro®Family
Arm®Cortex®-A35- based Microprocessor
NuMicro®Family
MA35D1 RTP
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 microprocessor 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

MA35D1
May 30, 2022 Page 2of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Table of Contents
1OVERVIEW......................................................................................................4
2DEVELOPMENT ENVIRONMENT...................................................................5
2.1 Preliminary Preparation................................................................................................ 5
2.2 Keil uVision..................................................................................................................... 5
2.3 IAR Embedded Workbench ......................................................................................... 7
2.4 NuEclipse...................................................................................................................... 10
3DIRECTORY STRUCTURE ...........................................................................16
3.1 First Level Directory Information ............................................................................... 16
3.2 Document ..................................................................................................................... 16
3.3 Library ........................................................................................................................... 16
3.4 SampleCode................................................................................................................. 16
3.4.1 Wormhole Controller (WHC).........................................................................................17
3.4.2 Hardware Semaphore (HWSEM).................................................................................17
3.4.3 External Bus Interface (EBI) .........................................................................................17
3.4.4 General Purpose I/O (GPIO) ........................................................................................17
3.4.5 PDMA Controller (PDMA)..............................................................................................17
3.4.6 Timer Controller (TIMER) ..............................................................................................18
3.4.7 Watchdog Timer (WDT).................................................................................................19
3.4.8 Window Watchdog Timer (WWDT)..............................................................................19
3.4.9 Real Time Clock (RTC)..................................................................................................19
3.4.10Enhanced PWM Generator and Capture Timer (EPWM).........................................19
3.4.11 Enhanced Input Capture Timer (ECAP)......................................................................20
3.4.12Quadrature Encoder Interface (QEI) ...........................................................................20
3.4.13UART Interface Controller (UART) ..............................................................................20
3.4.14Smartcard Host Interface (SC) .....................................................................................21
3.4.15Quad Serial Peripheral Interface (QSPI).....................................................................21
3.4.16Serial Peripheral Interface (SPI) ..................................................................................21
3.4.17I2C Serial Interface Controller (I2C)..............................................................................22
3.4.18I2S Controller (I2S) ..........................................................................................................22
3.4.19M-Controller Area Network (MCAN) ............................................................................23
3.4.20Enhanced 12-bit Analog-to-Digital Converter (EADC) ..............................................23
3.4.21Analog-to-Digital Converter (ADC) ..............................................................................24
3.4.22Keypad Interface (KPI) ..................................................................................................24
3.5 ThirdParty ..................................................................................................................... 24
4LOAD FIRMWARE FOR EXECUTION ..........................................................25
5RESOURCE MANAGEMENT........................................................................26
5.1 SSMCC ......................................................................................................................... 26

MA35D1
May 30, 2022 Page 3of 31 Rev 1.01
MA35D1 RTP USER MANUAL
5.1.1 DDR..................................................................................................................................26
5.2 SSPCC.......................................................................................................................... 26
5.2.1 SRAM ...............................................................................................................................26
5.3 WHC .............................................................................................................................. 26
5.4 HWSEM ........................................................................................................................ 27
6OPENAMP .....................................................................................................28
6.1 remoteproc ................................................................................................................... 28
6.2 RPMsg........................................................................................................................... 28
7REVISION HISTORY .....................................................................................29

MA35D1
May 30, 2022 Page 4of 31 Rev 1.01
MA35D1 RTP USER MANUAL
1 OVERVIEW
MA35D1 is a heterogeneous microprocessor contains a dual-core Corex-A35 and a Cortex-M4.
Although MA35D1 is a powerful microprocessor, executing Linux is not that suitable for handling real
time event such as motor control. The Cortex-M4 becomes quite handy as a real time processor to
process real time events in such scenario.
Another scenario is to use Cortax-A35 for data processing and can stay in power down mode most of
the time and wake up to process the data periodically. While Cortex-A35 is in power down mode, Cortex-
M4 is still capable for control some peripherals for data collecting, so the system can keep functioning
with minimum power consumption.
Chapter 2 describes the development of RTP, chapter 3 describes the software directory structure.
Chapter 4 introduces different method to load and execute RTP firmware. Chapter 5 and 6 describes
the method Cortex-A35 and Cortex-M4 communicate with each other.

MA35D1
May 30, 2022 Page 5of 31 Rev 1.01
MA35D1 RTP USER MANUAL
2 DEVELOPMENT ENVIRONMENT
The RTP software package supports using Keil uVision, IAR Embedded Workbench, and NuEclipse as
firmware development environment. Every sample code contains three directories holding the project
file for these tools.
2.1 Preliminary Preparation
Before debugging, we have to use a Nu-Link2-Pro and enable the CMSIS-DAP feature by the following
steps:
1. Upgrade the Nu-Link2-Pro firmware whose version is higher than v7174.
2. Open NU_CFG.txt file located in the NuMicro MCU disk folder.
3. Set CMSIS-DAP=1 and re-plug the Nu-Link2-Pro.
Figure 2-1 Enable CMSIS-DAP feature
2.2 Keil uVision
To open the Keil project, double click the uvproj file under the Keil/ directory, or open the uvproj file from
the “Project” pull down menu after launch the Keil uVision as shown in Figure 2-2.
Figure 2-2 Open Keil Project

MA35D1
May 30, 2022 Page 6of 31 Rev 1.01
MA35D1 RTP USER MANUAL
In “Options for Target –Linker” tab, modify “R/O Base”and “R/W Base”value shown in Figure 2-3.
Figure 2-3 Linker Configuration
To build the project click the “Build” icon shown in Figure 2-4.
Figure 2-4 Build Keil Project
In “Options for Target –Debug” tab, select CMSIS-DAP Debugger Driver shown in Figure 2-5 and
click settings.
Figure 2-5 Select Debugger Driver

MA35D1
May 30, 2022 Page 7of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Select SW adapter “Nu-Link 2 CMSIS-DAP”and check IDCODE for device connection and set AP to
0x02 shown in Figure 2-6.
Figure 2-6 CMSIS-DAP Debug Settings
In “Options for Target –Utilities” tab, uncheck “Update Target before Debugging” option shown in
Figure 2-7.
Figure 2-7 CMSIS-DAP Utilities Settings
uVision will load the built image and enter debug mode after click the “Start/Stop Debug Session” icon
as shown in Figure 2-8.
Figure 2-8 Debug Keil Project
2.3 IAR Embedded Workbench
To open the IAR workspace, double click the eww file under IAR/ directory or open the eww file from
the “File” pull down menu after launch the IAR Embedded Workbench as shown in Figure 2-9.

MA35D1
May 30, 2022 Page 8of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Figure 2-9 Open IAR Workspace
Open Options to modify setting shown in Figure 2-10.
Figure 2-10 Workspace Options
Select Cortex-M4F or Cortex-M4 with floating point option shown in Figure 2-11.
Figure 2-11 General Options

MA35D1
May 30, 2022 Page 9of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Click “Override default” option to edit linker configuration for debugging on SRAM address shown in
Figure 2-12.
Figure 2-12 Linker Options
Select CMSIS-DAP driver and uncheck “Use flash loader” option shown in Figure 2-13.
Figure 2-13 Debugger Options
Select SWD interface for CMSIS-DAP setting shown in Figure 2-14.Figure 2-13
Figure 2-14 CMSIS-DAP Interface Setting
To build the workspace click the “Make” icon on shown in Figure 2-15.
Figure 2-15 Build IAR Workspace

MA35D1
May 30, 2022 Page 10 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Modify “CMSIS-DAP Memory Configuration” base on SRAM address range shown in
Figure 2-16.
Figure 2-16 CMSIS-DAP Memory Configuration
IAR will load the built image and enter debug mode after click the “Download and Debug” icon as shown
in Figure 2-17.

MA35D1
May 30, 2022 Page 11 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Figure 2-17 Debug IAR Project
2.4 NuEclipse
To use open the NuEclipse project, first launch the NuEclipse tool, select “Import…” from the File menu
as shown in Figure 2-18.
Figure 2-18 NuEclipse Import Project
The next step is to select import existing project to workspace and click “Next >” button as shown in
Figure 2-19.

MA35D1
May 30, 2022 Page 12 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Figure 2-19 NuEclipse Import Existing Project
And the last step is to select the project file, and then click “Finish” button.

MA35D1
May 30, 2022 Page 13 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Figure 2-20 NuEclipse Select Project
To Build NuEclipse project, click the build icon as shown in Figure 2-21 or use the Ctrl + B hotkey.
Figure 2-21 Build NuEclipse Project
Click “Debug Configuration” menu item shown in Figure 2-22.
Figure 2-22 Debug Configuration

MA35D1
May 30, 2022 Page 14 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Double click on the “GDB Nuvoton Nu-Link Debugging”group. The Nuvoton Nu-Link debug
configuration appears on the right-hand side.
Figure 2-23 GDB Nuvoton Nu-Link Debugging

MA35D1
May 30, 2022 Page 15 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
The value of GDB client port is set to 3334.
Figure 2-24 GDB Client Port

MA35D1
May 30, 2022 Page 16 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
Check the startup debug setting shown in Figure 2-25, and then click “Debug” button. NuEclipse will
load the built image and enter debug mode.
Figure 2-25 Startup Debug Setting

MA35D1
May 30, 2022 Page 17 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
3 DIRECTORY STRUCTURE
This chapter describes the directory structure of RTP software package.
3.1 First Level Directory Information
Directory
Description
Document
Driver reference guide and revision history.
Library
Driver header and source files.
SampleCode
Driver sample code.
ThirdParty
Library from third party, including FreeRTOS™, and OpenAMP.
Table 3-1 First Level Directory
3.2 Document
Directory
Description
CMSIS.html
Document of CMSIS version 4.5.0.
NuMicro MA35D1 RTP
Driver Reference Guide.html
This document describes the usage of drivers in MA35D1 RTP
software package.
Table 3-2 Document Directory
3.3 Library
Directory
Description
CMSIS
Cortex®Microcontroller Software Interface Standard (CMSIS) V4.5.0
definitions by Arm®Corp.
Device
CMSIS compliant device header file.
SmartcardLib
Smartcard library binary and header file.
StdDriver
All peripheral driver header and source files.
Table 3-3 Library Directory
3.4 SampleCode
Here is the complete standard driver sample code list and the description.

MA35D1
May 30, 2022 Page 18 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
3.4.1 Wormhole Controller (WHC)
Sample Name
Description
WHC_TxRx
Demonstrate send and receive function through wormhole channel.
Table 3-4 WHC Samples
3.4.2 Hardware Semaphore (HWSEM)
Sample Name
Description
HWSEM_LockUnlock
Demonstrate hardware semaphore lock and unlock function.
Table 3-5 HWSEM Samples
3.4.3 External Bus Interface (EBI)
Sample Name
Description
EBI_NOR
Configure EBI interface to access NOR Flash connected to EBI
interface.
EBI_SRAM
Configure EBI interface to access SRAM connected to EBI
interface.
Table 3-6 EBI Samples
3.4.4 General Purpose I/O (GPIO)
Sample Name
Description
GPIO_EINTAndDebounce
Show the usage of GPIO external interrupt function and de-bounce
function.
GPIO_INT
Show the usage of GPIO interrupt function.
GPIO_OutputInput
Show how to set GPIO pin mode and use pin data input/output
control.
GPIO_PowerDown
Show how to wake up system from Power-down mode by GPIO
interrupt.
Table 3-7 GPIO Samples
3.4.5 PDMA Controller (PDMA)
Sample Name
Description
PDMA_BasicMode
Use PDMA2 channel 2 to demonstrate memory to memory transfer.

MA35D1
May 30, 2022 Page 19 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
PDMA_ScatterGather
Use PDMA2 channel 5 to demonstrate memory to memory transfer
by scatter-gather mode.
PDMA_ScatterGather_
PingPongBuffer
Use PDMA to implement Ping-Pong buffer by scatter-gather mode
(memory to memory).
PDMA_Stride
Use PDMA2 channel 2 to transfer data from memory to memory
with stride.
PDMA_Stride_Repeat
Use PDMA2 channel 0 to transfer data from memory to memory
with stride and repeat.
PDMA_TimeOut
Demonstrate PDMA timeout feature.
Table 3-8 PDMA Samples
3.4.6 Timer Controller (TIMER)
Sample Name
Description
TIMER_CaptureCounter
Show how to use the timer2 capture function to capture timer2
counter value.
TIMER_Delay
Demonstrate the usage of TIMER_Delay() API to generate a 1
second delay.
TIMER_EventCounter
Use pin PJ.12 to demonstrate timer event counter function.
TIMER_FreeCountingMode
Use the timer pin PJ.13 to demonstrate timer free counting mode
function. And displays the measured input frequency to UART
console.
TIMER_InterTimerTrigger
Mode
Use the timer pin PJ.12 to demonstrate inter-timer trigger mode
function. Also display the measured input frequency to UART
console.
TIMER_Periodic
Use the timer periodic mode to generate timer interrupt every 1
second.
TIMER_PeriodicINT
Implement timer counting in periodic mode.
TIMER_PWM_Brake
Demonstrate how to use Timer PWM brake function.
TIMER_PWM_ChangeDuty
Change duty cycle and period of output waveform by Timer PWM
Double Buffer function.
TIMER_PWM_DeadTime
Demonstrate how to use Timer PWM Dead Time function.
TIMER_PWM_Output
Waveform
Enable 4 Timer PWM output channels with different frequency and
duty ratio.
TIMER_TimeoutWakeup
Use Timer to wake up system from Power-down mode periodically.

MA35D1
May 30, 2022 Page 20 of 31 Rev 1.01
MA35D1 RTP USER MANUAL
TIMER_ToggleOut
Demonstrate the timer 2 toggle out function on pin PJ.12.
Table 3-9 TIMER Samples
3.4.7 Watchdog Timer (WDT)
Sample Name
Description
WDT_TimeoutWakeup
AndReset
Implement WDT time-out interrupt event to wake up system and
generate time-out reset system event while WDT time-out reset
delay period expired.
Table 3-10 WDT Samples
3.4.8 Window Watchdog Timer (WWDT)
Sample Name
Description
WWDT_CompareINT
Show how to reload the WWDT counter value.
Table 3-11 WWDT Samples
3.4.9 Real Time Clock (RTC)
Sample Name
Description
RTC_Alarm_Test
Demonstrate the RTC alarm function. It sets an alarm 10 seconds
after execution.
RTC_Alarm_Wakeup
Use RTC alarm interrupt event to wake up system.
RTC_Time_Display
Demonstrate the RTC function and displays current time to the
UART console.
Table 3-12 RTC Samples
3.4.10 Enhanced PWM Generator and Capture Timer (EPWM)
Sample Name
Description
EPWM_AccumulatorINT_
TriggerPDMA
Demonstrate EPWM accumulator interrupt trigger PDMA.
EPWM_AccumulatorStop
Mode
Demonstrate EPWM accumulator stop mode.
EPWM_Brake
Demonstrate how to use EPWM brake function.