1.. zephyr:board:: nucleo_f429zi
2
3Overview
4********
5
6The Nucleo F429ZI board features an ARM Cortex-M4 based STM32F429ZI MCU
7with a wide range of connectivity support and configurations. Here are
8some highlights of the Nucleo F429ZI board:
9
10- STM32 microcontroller in LQFP144 package
11- LSE crystal: 32.768 kHz crystal oscillator
12- USB OTG
13- Ethernet compliant with IEEE-802.3-2002
14- Two types of extension resources:
15
16  - ST Zio connector including: support for Arduino* Uno V3 connectivity
17    (A0 to A5, D0 to D15) and additional signals exposing a wide range of
18    peripherals
19  - ST morpho extension pin headers for full access to all STM32 I/Os
20
21- On-board ST-LINK/V2-1 debugger/programmer with SWD connector
22- Flexible board power supply:
23
24  - 5 V from ST-LINK/V2-1 USB VBUS
25  - External power sources: 3.3 V and 7 - 12 V on ST Zio or ST morpho
26    connectors, 5 V on ST morpho connector
27
28- Three user LEDs
29- Two push-buttons: USER and RESET
30
31More information about the board can be found at the `Nucleo F429ZI website`_.
32
33Hardware
34********
35
36The Nucleo F429ZI provides the following hardware components:
37
38- STM32F429ZIT6 in LQFP144 package
39- ARM |reg| 32-bit Cortex |reg| -M4 CPU with FPU
40- 180 MHz max CPU frequency
41- VDD from 1.8 V to 3.6 V
42- 2 MB Flash
43- 256+4 KB SRAM including 64-Kbyte of core coupled memory
44- GPIO with external interrupt capability
45- 3x12-bit ADC with 24 channels
46- 2x12-bit D/A converters
47- RTC
48- Advanced-control Timer
49- General Purpose Timers (17)
50- Watchdog Timers (2)
51- USART/UART (4/4)
52- I2C (3)
53- SPI (6)
54- SDIO
55- 2xCAN
56- USB 2.0 OTG FS with on-chip PHY
57- USB 2.0 OTG HS/FS with dedicated DMA, on-chip full-speed PHY and ULPI
58- 10/100 Ethernet MAC with dedicated DMA
59- 8- to 14-bit parallel camera
60- CRC calculation unit
61- True random number generator
62- DMA Controller
63
64More information about STM32F429ZI can be found here:
65
66- `STM32F429ZI on www.st.com`_
67- `STM32F429 reference manual`_
68- `STM32F429 datasheet`_
69
70Supported Features
71==================
72
73.. zephyr:board-supported-hw::
74
75Connections and IOs
76===================
77
78The Nucleo F429ZI Board has 8 GPIO controllers. These controllers are responsible for pin muxing,
79input/output, pull-up, etc.
80
81Available pins:
82---------------
83.. image:: img/nucleo_f429zi_cn8.jpg
84   :align: center
85   :alt: Nucleo F429ZI ZIO connectors (left)
86.. image:: img/nucleo_f429zi_cn7.jpg
87   :align: center
88   :alt: Nucleo F429ZI ZIO connectors (right)
89.. image:: img/nucleo_f429zi_cn11.jpg
90   :align: center
91   :alt: Nucleo F429ZI Morpho connectors (left)
92.. image:: img/nucleo_f429zi_cn12.jpg
93   :align: center
94   :alt: Nucleo F429ZI Morpho connectors (right)
95
96For more details please refer to `STM32 Nucleo-144 board User Manual`_.
97
98Default Zephyr Peripheral Mapping:
99----------------------------------
100
101The Nucleo F429ZI board features a ST Zio connector (extended Arduino Uno V3)
102and a ST morpho connector. Board is configured as follows
103
104- UART_3 TX/RX : PD8/PD9 (ST-Link Virtual Port Com)
105- UART_6 TX/RX : PG14/PG9 (Arduino Serial)
106- I2C1 SCL/SDA : PB8/PB9 (Arduino I2C)
107- SPI1 NSS/SCK/MISO/MOSI : PD14/PA5/PA6/PA7 (Arduino SPI)
108- PWM_2_CH1 : PE13
109- ETH : PA1, PA2, PA7, PB13, PC1, PC4, PC5, PG11, PG13
110- USER_PB : PC13
111- LD1 : PB0
112- LD2 : PB7
113- LD3 : PB14
114- USB DM : PA11
115- USB DP : PA12
116- ADC1 : PA0
117
118System Clock
119------------
120
121The Nucleo F429ZI System Clock could be driven by an internal or external oscillator,
122as well as by the main PLL clock. By default System clock is driven by PLL clock at 180MHz,
123driven by an 8MHz high speed external clock.
124
125Serial Port
126-----------
127
128The Nucleo F429ZI board has 8 UARTs. The Zephyr console output is assigned to UART3.
129Default settings are 115200 8N1.
130
131
132Programming and Debugging
133*************************
134
135.. zephyr:board-supported-runners::
136
137The Nucleo F429ZI board includes an ST-LINK/V2-1 embedded debug tool interface.
138
139Flashing
140========
141
142The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
143so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
144
145Alternatively, OpenOCD or JLink can also be used to flash the board using
146the ``--runner`` (or ``-r``) option:
147
148.. code-block:: console
149
150   $ west flash --runner openocd
151   $ west flash --runner jlink
152
153Flash partitions for MCUBoot bootloader
154***************************************
155
156The on-board STM32F429ZI MCU has 2MBs of internal flash memory. To use `MCUboot`_,
157define a :ref:`Zephyr partition table <flash_map_api>` for the flash memory in
158its devicetree file ``nucleo_f429zi.dts``. As a reference, a partition table for
159MCUBoot is already defined in the devicetree file, with these settings:
160
161- `MCUBoot`_ bootloader partition takes 64K bytes.
162- Zephyr settings partition takes 64K bytes.
163- Application image takes 256K bytes in Slot 0 partition.
164- Updating image takes another 256K bytes in Slot 1 partition.
165- A scratch partition with 128K is required for image swap.
166
167A specific application can adjust each partition size based on its needs.
168
169
170.. _Nucleo F429ZI website:
171   https://www.st.com/en/evaluation-tools/nucleo-f429zi.html
172
173.. _STM32 Nucleo-144 board User Manual:
174   https://www.st.com/resource/en/user_manual/dm00244518.pdf
175
176.. _STM32F429ZI on www.st.com:
177   https://www.st.com/en/microcontrollers/stm32f429zi.html
178
179.. _STM32F429 reference manual:
180   https://www.st.com/resource/en/reference_manual/dm00031020.pdf
181
182.. _STM32F429 datasheet:
183   https://www.st.com/resource/en/datasheet/DM00071990.pdf
184
185.. _MCUBoot:
186   https://github.com/JuulLabs-OSS/mcuboot/blob/master/README.md
187
188.. _STM32CubeProgrammer:
189   https://www.st.com/en/development-tools/stm32cubeprog.html
190