1.. zephyr:board:: numaker_pfm_m487
2
3Overview
4********
5
6The NuMaker PFM M487 is an Internet of Things (IoT) application focused platform
7specially developed by Nuvoton. The PFM-M487 is based on the NuMicro® M487
8Ethernet series MCU with ARM® -Cortex®-M4F core.
9
10Features:
11=========
12- 32-bit Arm Cortex®-M4 M487JIDAE MCU
13- Core clock up to 192 MHz
14- 512 KB embedded Dual Bank Flash and 160 KB SRAM
15- Audio codec (NAU88L25) with Microphone In and Headphone Out
16- Ethernet (IP101GR) for network application
17- USB 2.0 High-Speed OTG / Host / Device
18- USB 1.1 Full-Speed OTG / Host / Device
19- External SPI Flash (Winbond W25Q20) which can be regarded as ROM module
20- MicroSD Card slot for T-Flash
21- M487 extended interface 4 connector with 36 pins each
22- Arduino UNO compatible interface
23- Three push-buttons: one is for reset and the other two are for user-defined
24- Four LEDs: one is for power indication and the other three are for user-defined
25- On-board NU-Link-Me ICE debugger/programmer with SWD connector
26
27More information about the board can be found at the `PFM M487 User Manual`_.
28
29Supported Features
30==================
31
32* The on-board 12-MHz crystal allows the device to run at its maximum operating speed of 192MHz.
33
34The development board configuration supports the following hardware features:
35
36+-----------+------------+-----------------------+
37| Interface | Controller | Driver/Component      |
38+===========+============+=======================+
39| NVIC      | on-chip    | nested vectored       |
40|           |            | interrupt controller  |
41+-----------+------------+-----------------------+
42| SYSTICK   | on-chip    | system clock          |
43+-----------+------------+-----------------------+
44| UART      | on-chip    | serial port           |
45+-----------+------------+-----------------------+
46
47Other hardware features are not yet supported on Zephyr porting.
48
49More details about the supported peripherals are available in `M480 TRM`_
50Other hardware features are not currently supported by the Zephyr kernel.
51
52Building and Flashing
53*********************
54Flashing
55========
56
57Here is an example for the :zephyr:code-sample:`hello_world` application.
58
59On board debugger Nu-link-Me can emulate UART0 as a virtual COM port over usb,
60To enable this, set ISW1 DIP switch 1-3 (TXD RXD VOM) to ON.
61Connect the PFM M487 IoT to your host computer using the USB port, then
62run a serial host program to connect with your board. For example:
63
64.. code-block:: console
65
66   $ minicom -D /dev/ttyACM0
67
68.. zephyr-app-commands::
69   :zephyr-app: samples/hello_world
70   :board: numaker_pfm_m487
71   :goals: flash
72
73Debugging
74=========
75
76Here is an example for the :zephyr:code-sample:`hello_world` application.
77
78.. zephyr-app-commands::
79   :zephyr-app: samples/hello_world
80   :board: numaker_pfm_m487
81   :goals: debug
82
83Step through the application in your debugger.
84
85References
86**********
87
88.. target-notes::
89
90.. _PFM M487 User Manual:
91   https://www.nuvoton.com/export/resource-files/UM_NuMaker-PFM-M487_User_Manual_EN_Rev1.01.pdf
92.. _M480 TRM:
93   https://www.nuvoton.com/export/resource-files/TRM_M480_Series_EN_Rev2.02.pdf
94