Nuvoton NuMicro series User manual

NuMaker
Mar 29, 2019 Page 1of 31 Rev 1.00
NUMICROPY USER MANUAL
Arm®Cortex®-M
32-bit Microcontroller
NuMicro®Family
NuMicroPy
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

NuMaker
Mar 29, 2019 Page 2of 31 Rev 1.00
NUMICROPY USER MANUAL
Table of Contents
1Overview.............................................................................................4
2NuMicroPy Introduction ...........................................................................5
REPL..................................................................................................... 5
Embedded Flash Partition............................................................................ 5
Modules and I/O Classes Support List ............................................................. 6
3How to Start NuMicroPy...........................................................................9
Nuvoton Nu-Link Driver Download and Install .................................................... 9
Hardware Setup Steps................................................................................ 9
Burn Firmware.........................................................................................10
Python Code Update Steps .........................................................................11
4How to Customize MicroPython Firmware................................................... 13
Packages Requirement..............................................................................13
Install GNU Arm Toolchain..........................................................................13
Build Firmware ........................................................................................13
Enable/Disable Module ..............................................................................13
Enable/Disable I/O Class............................................................................15
5I/O Class Quick Reference ..................................................................... 17
LAN Class..............................................................................................17
Pin Class...............................................................................................17
ADC Class .............................................................................................19
SPI Class...............................................................................................19
I2C Class ...............................................................................................20
RTC Class .............................................................................................21
UART Class............................................................................................21
CAN Class .............................................................................................22
USB HID Class........................................................................................23
USB VCP Class.......................................................................................23
LED Class..............................................................................................24
Switch Class...........................................................................................24
Timer Class............................................................................................24
PWM Class ............................................................................................25
WDT Class.............................................................................................28

NuMaker
Mar 29, 2019 Page 3of 31 Rev 1.00
NUMICROPY USER MANUAL
Accel Class ............................................................................................28
Gyro Class.............................................................................................28
Mag Class..............................................................................................28
6Summary .......................................................................................... 29
7Revision History .................................................................................. 30

NuMaker
Mar 29, 2019 Page 4of 31 Rev 1.00
NUMICROPY USER MANUAL
1 OVERVIEW
NuMicroPy is the port of MicroPython to Nuvoton NuMicro®family microcontrollers (MCUs). The
MicroPython
1
project aims to put an implementation of Python 3.x on the microcontrollers and
small embedded systems. Refer to Table 1-1 for NuMicroPy support status.
MCU
Board
Firmware ROM Size
Firmware RAM Size
M487
NuMaker-PFM-M487
362KB
77KB
M487
NuMaker-IOT-M487
373KB
77KB
Table 1-1 NuMicroPy Support Status
The MicroPython implements Python 3.4 and some selected feature of Python 3.5, but there are
some conflicting results in MicroPython when compared to standard Python. See details
2
.
1
http://micropython.org/
2
http://docs.micropython.org/en/latest/genrst/index.html#

NuMaker
Mar 29, 2019 Page 5of 31 Rev 1.00
NUMICROPY USER MANUAL
2 NUMICROPY INTRODUCTION
The MicroPython divides the code into two parts, python interpreter firmware (firmware.bin) and
the user’s python code. The firmware must be burned into the MCU first. After boot, the firmware
executes the user’s python code.
The execution of the python code supports the REPL mode and/or performs the python code from
storage. The firmware tries to perform the python code from storage first, and finally enter REPL
mode. Uses can test their python code in REPL mode, and finally put the python code into
storage.
The MicroPython defines the I/O classes associated with the MCU peripheral in the pyb module
3
.
NuMicroPy implements these I/O classes according to these definitions.
REPL
REPL stands for Read Evaluate Print Loop, and is the name given to the interactive MicroPython
prompt that you can access on the MCUs. Using the REPL is by far the easiest way to test out
your python code (Figure 2-1).
The REPL is always available on the UART0 serial peripheral. The baud rate of the REPL is
115200. In the NuMaker-PFM-M487 board, Nu-Link-Me has a USB-to-serial converter on it then
you should be able to access the REPL directly from your PC.
To access the prompt over USB-to-serial you need to use a terminal emulator program. On
Windows, Tera Term is a good choice; on Mac you can use the built-in screen program, and
Linux has picocom and minicom.
Figure 2-1 REPL Mode
Embedded Flash Partition
The NuMicroPy divides the MCU’s embedded flash into two partitions, one is the firmware
partition and the other is the data partition.
The firmware partition is used to put the firmware binary code.
The data partition will be a partition of FAT file system. The firmware will attempt to mount the
data partition at the beginning of execution. If mount fails, it will force the data partition to be
formatted into FAT file system and produce two blank python file (main.py and boot.py). You can
3
pyb module: MicroPython board related module.

NuMaker
Mar 29, 2019 Page 6of 31 Rev 1.00
NUMICROPY USER MANUAL
force the firmware into USB mass storage mode and then write your python code to these files.
Table 2-1 shows the default embedded Flash partition status.
MCU
Embedded
Flash Size
Firmware
Partition Start
Address
Firmware
Partition Size
Data
Partition
Start
Address
Data
Partition
Size
M487
512KB
0x0
384KB
0x60000
128KB
Table 2-1 Default Embedded Flash Partition Status
Modules and I/O Classes Support List
Table 2-2 and Table 2-3 show the M487 support status on the modules and I/O classes of
MicroPython.
Module
Description
M487
array
Arrays of numeric data

cmath
Mathematical function for complex numbers

gc
Control the garbage collector

math
Mathematical functions

sys
System specific functions

ubinascii
Binary/ASCII conversions

ucollections
Collection and container types

uerrno
System error codes

uhashlib
Hashing algorithms

uheapq
Heap queue algorithm

uio
Input/output streams

ujson
JSON encoding and decoding

uos
Basic “operating system”service

ure
Simple regular expressions

uselect
Wait for events on a set of streams

usocket
Socket module

ussl
SSL/TLS module

ustruct
Pack and unpack primitive data types


NuMaker
Mar 29, 2019 Page 7of 31 Rev 1.00
NUMICROPY USER MANUAL
utime
Time related functions

uzlib
zlib decompression

_thread
Multithreading support

network
Network configuration

uctypes
Access binary data in a structured way

Machine
Functions related to the hardware

ucryptolib
Cryptographic ciphers

Table 2-2 Default Supported Modules
I/O Class
Description
M487
ADC
Analog to digital conversion

CAN
Controller area network communication bus

I2C
A two-wire serial protocol

LED
LED object

Pin
Control I/O pins

PinAF
Pin alternate functions

RTC
Real time clock

SPI
A master-driven serial protocol

Switch
Switch button object

Timer
Control internal timers

TimerChannel
Setup a channel for a timer

UART
Duplex serial communication bus

USB_HID
USB Human Interface Device

USB_VCP
USP virtual com port

PWM
BPWM/EPWM generator and capture timer

WDT
Watchdog timer

Accel
Accelerometer control (Bosch BMX055)
Only for
NuMaker-IOT-
M487

NuMaker
Mar 29, 2019 Page 8of 31 Rev 1.00
NUMICROPY USER MANUAL
Gyro
Gyroscope control (Bosch BMX055)
Only for
NuMaker-IOT-
M487
Mag
Magnetometer control (Bosch BMX055)
Only for
NuMaker-IOT-
M487
Table 2-3 Default Supported I/O Classes

NuMaker
Mar 29, 2019 Page 9of 31 Rev 1.00
NUMICROPY USER MANUAL
3 HOW TO START NUMICROPY
The following uses the NuMaker-PFM-M487 board to show how to burn firmware into the
NuMicro®MCU and how to update your python code.
Nuvoton Nu-Link Driver Download and Install
Please visit the Nuvoton software download website to download “Nu-Link_Command_Tool” file.
When the Nu-Link command tool has been downloaded successfully, please unzip the file and
execute the “NuMicro NuLink Command Tool.exe” to install the driver.
Hardware Setup Steps
1. Turn on ICE function switch pin 1, 2, 3 and 4.
2. Connect USB ICE and USB1.1 to PC (Figure 3-1).
3. Set up your terminal program (Figure 3-2 and Figure 3-3).
Figure 3-1 NuMaker-PFM-M487 Board
Figure 3-2 Create a Serial Connection

NuMaker
Mar 29, 2019 Page 10 of 31 Rev 1.00
NUMICROPY USER MANUAL
Figure 3-3 Serial Port Setup
Burn Firmware
The Nu-Link-Me exports a MBED disk, just Copy and Paste your firmware.bin into MBED disk
(Figure 3-4). After firmware burning, you can see MicroPython prompt on your terminal screen as
Figure 2-1.
You can get prebuilt firmware from NuMicroPy repository
4
.
Figure 3-4 Copy and Paste Firmware
4
https://github.com/OpenNuvoton/NuMicroPy

NuMaker
Mar 29, 2019 Page 11 of 31 Rev 1.00
NUMICROPY USER MANUAL
Python Code Update Steps
1. Connect USB1.1 to PC
2. Press the SW2 and RESET button at the same time. The firmware will export a PYBFLASH
disk (Figure 3-5).
3. Update your python code to boot.py or main.py (Figure 3-6).
4. Press the RESET button (Figure 3-7).
Figure 3-5 PYBFLASH Disk
Figure 3-6 Write Switch Button Example Code

NuMaker
Mar 29, 2019 Page 12 of 31 Rev 1.00
NUMICROPY USER MANUAL
Figure 3-7 Execute Switch Button Example Code

NuMaker
Mar 29, 2019 Page 13 of 31 Rev 1.00
NUMICROPY USER MANUAL
4 HOW TO CUSTOMIZE MICROPYTHON FIRMWARE
The development of MicroPython firmware is in the Unix-like environment. The description below
uses Ubuntu 16.04.
Packages Requirement
The following packages will need to be installed before you can compile and run MicroPython.
build-essential
libreadline-dev
libffi-dev
git
pkg-config
To install these packages, use the following command.
1. sudo apt-get install build-essential libreadline-dev libffi-dev git pkg-config
Install GNU Arm Toolchain
Download GNU Arm toolchain linux 64-bit version 7-2018-q2 update from Arm Developer
5
website.
Next, use the tar command to extract the file to your favor directory (ex. /usr/local)
1. mv gcc-arm-none-eabi-7-2018-q2-update-linux.tar.bz2 /usr/local/
2. cd /usr/local
3. tar -xjvf gcc-arm-none-eabi-7-2018-q2-update-linux.tar.bz2
Now, modify your PATH environment variable to access the bin directory of toolchain
Build Firmware
To build MicroPython firmware for M487, use the following command.
1. git clone --recursive https://github.com/OpenNuvoton/NuMicroPy.git
2. cd patch
3. ./run_patch.sh
4. cd ../M48x
5. make V=1
Enable/Disable Module
Default modules support list as Table 2-2. You can enable/disable the built-in modules of
MicroPython by modifying the options of mpconfigport.h. It should be noted that some options may
have dependencies, which may cause compiling failure. Below is part of M48x/mpconfigport.h.
1. #include <stdint.h>
2.
3. #include "mpconfigboard.h"
4. #include "mpconfigboard_common.h"
5. #include "NuMicro.h"
6. // options to control how MicroPython is built
7.
8. // You can disable the built-in MicroPython compiler by setting the following
9. // config option to 0. If you do this then you won't get a REPL prompt, but you
10. // will still be able to execute pre-compiled scripts, compiled with mpy-cross.
11. #define MICROPY_ENABLE_COMPILER (1)
12.
5
https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads

NuMaker
Mar 29, 2019 Page 14 of 31 Rev 1.00
NUMICROPY USER MANUAL
13. #define MICROPY_QSTR_BYTES_IN_HASH (1)
14. #define MICROPY_QSTR_EXTRA_POOL mp_qstr_frozen_const_pool
15. #define MICROPY_ALLOC_PATH_MAX (256)
16. #define MICROPY_ALLOC_PARSE_CHUNK_INIT (16)
17. #define MICROPY_EMIT_X64 (0)
18. #define MICROPY_EMIT_THUMB (0)
19. #define MICROPY_EMIT_INLINE_THUMB (0)
20. #define MICROPY_COMP_MODULE_CONST (0)
21. #define MICROPY_COMP_CONST (0)
22. #define MICROPY_COMP_DOUBLE_TUPLE_ASSIGN (0)
23. #define MICROPY_COMP_TRIPLE_TUPLE_ASSIGN (0)
24. #define MICROPY_MEM_STATS (0)
25. #define MICROPY_DEBUG_PRINTERS (0)
26. #define MICROPY_GC_ALLOC_THRESHOLD (0)
27. #define MICROPY_REPL_EVENT_DRIVEN (0)
28. #define MICROPY_HELPER_LEXER_UNIX (0)
29. #define MICROPY_ENABLE_SOURCE_LINE (0)
30. #define MICROPY_ENABLE_DOC_STRING (0)
31. #define MICROPY_ERROR_REPORTING (MICROPY_ERROR_REPORTING_TERSE)
32. #define MICROPY_BUILTIN_METHOD_CHECK_SELF_ARG (0)
33. #define MICROPY_PY_ASYNC_AWAIT (0)
34. #define MICROPY_PY___FILE__ (0)
35. #define MICROPY_PY_GC (1)
36. #define MICROPY_PY_ARRAY (1)
37. #define MICROPY_PY_ATTRTUPLE (1)
38. #define MICROPY_PY_COLLECTIONS (1)
39. #define MICROPY_PY_COLLECTIONS_DEQUE (1)
40. #define MICROPY_PY_COLLECTIONS_ORDEREDDICT (1)
41. #define MICROPY_PY_MATH (1)
42. #define MICROPY_PY_CMATH (1)
43. #define MICROPY_PY_IO (1)
44. #define MICROPY_PY_IO_FILEIO (1)
45. #define MICROPY_PY_STRUCT (1)
46. //#define MICROPY_PY_SYS (0)
47. #define MICROPY_PY_SYS_MAXSIZE (1)
48. #define MICROPY_PY_SYS_EXIT (1)
49. #define MICROPY_PY_SYS_STDFILES (1)
50. #define MICROPY_PY_SYS_STDIO_BUFFER (1)
51. #ifndef MICROPY_PY_SYS_PLATFORM // let boards override it if they want
52. #define MICROPY_PY_SYS_PLATFORM "pyboard"
53. #endif
54.
55. #define MICROPY_MODULE_FROZEN_MPY (1)
56. #define MICROPY_CPYTHON_COMPAT (0)
57. #define MICROPY_LONGINT_IMPL (MICROPY_LONGINT_IMPL_NONE)
58. #define MICROPY_FLOAT_IMPL (MICROPY_FLOAT_IMPL_FLOAT)
59. #define MICROPY_PY_UERRNO (1)
60.
61. // control over Python builtins
62. #define MICROPY_PY_BUILTINS_BYTEARRAY (1)
63. #define MICROPY_PY_BUILTINS_MEMORYVIEW (1)
64. #define MICROPY_PY_BUILTINS_ENUMERATE (0)
65. #define MICROPY_PY_BUILTINS_FILTER (0)
66. #define MICROPY_PY_BUILTINS_FROZENSET (0)
67. #define MICROPY_PY_BUILTINS_REVERSED (0)
68. #define MICROPY_PY_BUILTINS_SET (0)
69. #define MICROPY_PY_BUILTINS_SLICE (0)
70. #define MICROPY_PY_BUILTINS_PROPERTY (0)
71. #define MICROPY_PY_BUILTINS_MIN_MAX (0)
72.
73.
74.

NuMaker
Mar 29, 2019 Page 15 of 31 Rev 1.00
NUMICROPY USER MANUAL
75. // Python internal features
76. #define MICROPY_ENABLE_GC (1)
77. #define MICROPY_READER_VFS (1)
78. #define MICROPY_HELPER_REPL (1)
Enable/Disable I/O Class
The MicroPython defines I/O classes in pyb and machine modules. User can modify
mpconfigboard.h to enable/disable I/O classes or modify the pin definitions for individual I/O class.
The I/O class support is disabled if the definition of I/O pin is deleted. When modifying the
individual I/O pin, it needs to be consistent with the pin alternatives function definition file
(xxx_af.csv). Below are some contents of M48x/mpconfigboard.h and M48x/board/m487_af.csv.
mpconfigboard.h
1. // I2C busses
2. #define MICROPY_HW_I2C0_SCL (pin_A5)
3. #define MICROPY_HW_I2C0_SDA (pin_A4)
4. #define MICROPY_HW_I2C1_SCL (pin_A3)
5. #define MICROPY_HW_I2C1_SDA (pin_A2)
6.
7.
8. // SPI busses
9. #define MICROPY_HW_SPI0_NSS (pin_A3) //D10
10. #define MICROPY_HW_SPI0_SCK (pin_A2) //D13
11. #define MICROPY_HW_SPI0_MISO (pin_A1) //D12
12. #define MICROPY_HW_SPI0_MOSI (pin_A0) //D11
13.
14. #define MICROPY_HW_SPI3_NSS (pin_C9) //D2
15. #define MICROPY_HW_SPI3_SCK (pin_C10) //D3
16. #define MICROPY_HW_SPI3_MISO (pin_B9) //A3
17. #define MICROPY_HW_SPI3_MOSI (pin_B8) //A2
18.
19. //ADC(using EADC pin to implement ADC class)
20. #define MICROPY_HW_EADC0_CH0 (pin_B0) //10
21. #define MICROPY_HW_EADC0_CH1 (pin_B1) // 9
22. #define MICROPY_HW_EADC0_CH2 (pin_B2) // 4
23. #define MICROPY_HW_EADC0_CH3 (pin_B3) // 3
24. //#define MICROPY_HW_EADC0_CH4 (pin_B0)//not implement yet
25. //#define MICROPY_HW_EADC0_CH5 (pin_B0)//not implement yet
26. #define MICROPY_HW_EADC0_CH6 (pin_B6)//144
27. #define MICROPY_HW_EADC0_CH7 (pin_B7)//143
28. #define MICROPY_HW_EADC0_CH8 (pin_B8)//142 //A2
29. #define MICROPY_HW_EADC0_CH9 (pin_B9)//141 //A3
30. //#define MICROPY_HW_EADC0_CH10 (pin_B0)//
31. //#define MICROPY_HW_EADC0_CH11 (pin_B0)//
32. //#define MICROPY_HW_EADC0_CH12 (pin_B0)//
33. //#define MICROPY_HW_EADC0_CH13 (pin_B0)//
34. //#define MICROPY_HW_EADC0_CH14 (pin_B0)//
m487_af.csv
1. #Port,Pin,MFPL/MFPH,SPIM,,,,,,,,,,,,,,,,,,,,,,,EVENTOUT,
2. PortA,PA0,MFPL,SPIM0_MOSI,QSPI0_MOSI0,SPI0_MOSI,SD1_DAT0,SC0_CLK,UART0_RXD,UART1_nRT
S,I2C2_SDA,BPWM0_CH0,EPWM0_CH5,DAC0_ST,EVENTOUT,
3. PortA,PA1,MFPL,SPIM0_MISO,QSPI0_MISO0,SPI0_MISO,SD1_DAT1,SC0_DAT,UART0_TXD,UART1_nCT
S,I2C2_SCL,BPWM0_CH1,EPWM0_CH4,DAC1_ST,EVENTOUT,
4. PortA,PA2,MFPL,SPIM0_CLK,QSPI0_CLK,SPI0_CLK,SD1_DAT2,SC0_RST,UART4_RXD,UART1_RXD,I2C
1_SDA,BPWM0_CH2,EPWM0_CH3,EVENTOUT,
5. PortA,PA3,MFPL,SPIM0_SS,QSPI0_SS,SPI0_SS,SD1_DAT3,SC0_PWR,UART4_TXD,UART1_TXD,I2C1_S
CL,BPWM0_CH3,EPWM0_CH2,QEI0_B,EVENTOUT,
6. PortA,PA4,MFPL,SPIM0_D3,QSPI0_MOSI1,SPI0_I2SMCLK,SD1_CLK,SC0_nCD,UART0_nRTS,UART5_RX
D,I2C0_SDA,CAN0_RXD,BPWM0_CH4,EPWM0_CH1,QEI0_A,EVENTOUT,

NuMaker
Mar 29, 2019 Page 16 of 31 Rev 1.00
NUMICROPY USER MANUAL
7. PortA,PA5,MFPL,SPIM0_D2,QSPI0_MISO1,SPI1_I2SMCLK,SD1_CMD,SC2_nCD,UART0_nCTS,UART5_TX
D,I2C0_SCL,CAN0_TXD,BPWM0_CH5,EPWM0_CH0,QEI0_INDEX,EVENTOUT,
8.
9. PortB,PB0,MFPL,SPI0_I2SMCLK,SD0_CMD,UART2_RXD,I2C1_SDA,EPWM0_CH5,EPWM1_CH5,EPWM0_BRA
KE1,OPA0_P,EBI0_ADR9,EADC0_CH0,EVENTOUT,
10. PortB,PB1,MFPL,EADC0_CH1,OPA0_N,EBI0_ADR8,SD0_CLK,EMAC0_RMII_RXERR,SPI1_I2SMCLK,SPI3
_I2SMCLK,UART2_TXD,USCI1_CLK,I2C1_SCL,I2S0_LRCK,EPWM0_CH4,EPWM1_CH4,EPWM0_BRAKE0,EVE
NTOUT,

NuMaker
Mar 29, 2019 Page 17 of 31 Rev 1.00
NUMICROPY USER MANUAL
5 I/O CLASS QUICK REFERENCE
The MicroPython provides the document
6
to describe how to access MCU’s I/O by python
language, and, has description
7
to introduce how to add a module written in C. This document
only provides the NuMicro®MCU’s I/O quick reference for you reference.
LAN Class
The NuMicroPy implements a LAN class to network module according to the network class
definitions of MicroPython. The LAN class is based on lwIP TCP/IP stack and associated with
EMAC hardware.
Once the network is established, the usocket module can be used to create and use TCP/UDP
sockets as usual.
1. import network
2.
3. lan = network.LAN() # create lan interface
4. lan.isconnected() # check if the lan is connected and up
5. lan.active(True) # Activate the lan interface
6. lan.ifconfig(('192.168.0.4', '255.255.255.0', '192.168.0.1', '8.8.8.8')) #set IP
address, subnet mask, gateway and DNS
7. lan.ifconfig() # get IP address, subnet mask, gateway and DNS
8. lan.ifconfig('dhcp') # set dynamic IP
Pin Class
All board pins are predefined as pyb.Pin.board.name. CPU pins corresponding to the board pins
are available as pyb.Pin.cpu.Name. For example, on the NuMaker_PFM_M487 board,
pyb.Pin.board.D0 corresponds to pyb.Pin.cpu.B2. Table 5-1 is the board pin name and CPU pin
name mapping table.
Board
Board Pin Name
CPU Pin Name
NuMaker_PFM_M487
D0
B2
D1
B3
D2
C9
D3
C10
D4
C11
D5
C12
D6
E4
D7
E5
D8
A5
D9
A4
6
http://docs.micropython.org/en/latest/library/index.html
7
https://micropython-dev-docs.readthedocs.io/en/latest/adding-module.html

NuMaker
Mar 29, 2019 Page 18 of 31 Rev 1.00
NUMICROPY USER MANUAL
D10
A3
D11
A0
D12
A1
D13
A2
A0
B6
A1
B7
A2
B8
A3
B9
A4
B0
A5
B1
SW2
G15
SW3
F11
LEDR
H0
LEDY
H1
LEDG
H2
Table 5-1 Board Pin Name and CPU Pin Name Mapping
1. from pyb import Pin
2.
3. p_d0 = Pin(Pin.board.D0, Pin.OUT) # create output pin on GPIO B2
4. p_d0.value(1) # set pin to on/high
5.
6. p_d1 = Pin(Pin.board.D1, Pin.IN) # create input pin on GPIO B3
7. print(p_d1.value()) # get value, 0 or 1
8.
9. Pin.board.D2.af_list() # list available alternate functions on GPIO C9
10.
11. def sw2_callback(pin): # define sw2 (switch button 2) callback
12. print(pin)
13.
14. sw2 = Pin.board.SW2
15. sw2.irq(handler=sw2_callback, trigger=Pin.IRQ_RISING) # configure sw2 to interrupt
Pin(id, mode, [pull=Pin.PUL_NONE, alt=-1])
mode can be one of:
Pin.IN –configure the pin for input
Pin.OUT –configure the pin for output, with push-pull control
Pin.OPEN_DRAIN –configure the pin for output, with open-drain control
Pin.QUASI –configure the pin for output, with quasi control
Pin.ALT –configure the pin for alternate function, push-pull

NuMaker
Mar 29, 2019 Page 19 of 31 Rev 1.00
NUMICROPY USER MANUAL
Pin.ALT_OPEN_DRAIN –configure the pin for alternate function, open-drain
pull can be one of:
Pin.PULL_NONE –no pull up or down resistors
Pin.PULL_UP –enable the pull-up resistor
Pin.PULL –enable the pull-down resister
When the mode is Pin.ALT or Pin.ALT_OPEN_DRAIN, alt can be the name of one of
the alternate functions associated with a pin. You can use af_list() to query available
alternate functions for this pin.
pin.irq([handler=None, trigger=Pin.IRQ_FALLING|Pin.IRQ_RIGING])
Configure GPIO pins to interrupt on external. If a falling or rising edge seen on this pin, the
handler will be called.
ADC Class
The NuMicroPy uses EADC0 to implement ADC class. Table 5-2 is ADC channel support list by
the board.
Board
Channel Number
Board Pin Name
CPU Pin Name
NuMaker_PFM_M487
CH0
A4
B0
CH1
A5
B1
CH2
D0
B2
CH3
D1
B3
CH6
A0
B6
CH7
A1
B7
CH8
A2
B8
CH9
A3
B9
Table 5-2 ADC Support List
1. from pyb import ADC, Pin
2.
3. adc0 = ADC(Pin.board.A4) # create an analog object from a pin
4. val = adc0.read() # read an analog value
5.
6. adc_all = ADCALL(12, 0x00003) # 12 bit resolution, internal channels 0 and 1
7. val = adc.read_channel(1) # read analog value of channel 1
8. val = adc.read_core_temp() # read MCU's temperature
9. val = adc.read_core_vbat() # read MCU's VBAT
SPI Class
In the MicroPython, there are two SPI drivers. One is implemented in software and works on all
pins, and is accessed via the machine.SPI class. The other is implemented in hardware and
accessed via the pyb.SPI class. Table 5-3 is hardware SPI support list by the board.
Board
SPI Pin Name
Board Pin Name
CPU Pin Name
NuMaker_PFM_M487
SPI0_NSS
D10
A3
SPI0_SCK
D13
A2

NuMaker
Mar 29, 2019 Page 20 of 31 Rev 1.00
NUMICROPY USER MANUAL
SPI0_MISO
D12
A1
SPI0_MOSI
D11
A0
SPI3_NSS
D2
C9
SPI3_SCK
D3
C10
SPI3_MISO
A3
B9
SPI3_MOSI
A2
B8
Table 5-3 SPI Support List
1. from pyb import SPI
2.
3. # construct an SPI bus on the SPI0
4. # mode is Master
5. # polarity is the idle state of SCK
6. # phase=0 means sample on the first edge of SCK, phase=1 means the second
7. spi = SPI(0, SPI.MASTER, baudrate=100000, polarity=1, phase=0)
8.
9. spi.read(10) # read 10 bytes on MISO
10. spi.read(10, 0xff) # read 10 bytes while outputing 0xff on MOSI
11.
12. buf = bytearray(50) # create a buffer
13. spi.readinto(buf) # read into the given buffer (reads 50 bytes in this case)
14. spi.readinto(buf, 0xff) # read into the given buffer and output 0xff on MOSI
15.
16. spi.write(b'12345') # write 5 bytes on MOSI
17.
18. buf = bytearray(4) # create a buffer
19. spi.write_readinto(b'1234', buf) # write 4 bytes to MOSI and read from MISO into the
buffer
SPI(bus, mode, [ baudrate=328125, polarity=1, phase=0, bits=8, firstbit=SPI.MSB])
mode must be either SPI.MASTER ore SPI.SLAVE
baudrate is the SCK clock rate(only sensible for master)
polarity can be 0 or 1, and is the level the idle clock line sits at.
pahse can be 0 or 1 to sample date on the first or second clock edge respectively.
bits can be 8 or 16 or 32
firstbit can be SPI.MSB or SPI.LSB
I2C Class
Table 5-4 is hardware I2C support list by the board.
Board
I2C Pin Name
Board Pin Name
CPU Pin Name
NuMaker_PFM_M487
I2C0_SCL
D8
A5
I2C0_SDA
D9
A4
I2C1_SCL
D10
A3
I2C1_SDA
D13
A2
Table 5-4 I2C Support List