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
73The Zephyr nucleo_f429zi board configuration supports the following hardware features:
74
75+-----------+------------+-------------------------------------+
76| Interface | Controller | Driver/Component                    |
77+===========+============+=====================================+
78| NVIC      | on-chip    | nested vector interrupt controller  |
79+-----------+------------+-------------------------------------+
80| UART      | on-chip    | serial port-polling;                |
81|           |            | serial port-interrupt               |
82+-----------+------------+-------------------------------------+
83| PINMUX    | on-chip    | pinmux                              |
84+-----------+------------+-------------------------------------+
85| GPIO      | on-chip    | gpio                                |
86+-----------+------------+-------------------------------------+
87| ETHERNET  | on-chip    | Ethernet                            |
88+-----------+------------+-------------------------------------+
89| PWM       | on-chip    | pwm                                 |
90+-----------+------------+-------------------------------------+
91| I2C       | on-chip    | i2c                                 |
92+-----------+------------+-------------------------------------+
93| USB       | on-chip    | usb                                 |
94+-----------+------------+-------------------------------------+
95| SPI       | on-chip    | spi                                 |
96+-----------+------------+-------------------------------------+
97| WATCHDOG  | on-chip    | independent watchdog                |
98+-----------+------------+-------------------------------------+
99| ADC       | on-chip    | adc                                 |
100+-----------+------------+-------------------------------------+
101| DAC       | on-chip    | DAC Controller                      |
102+-----------+------------+-------------------------------------+
103| DMA       | on-chip    | Direct Memory Access                |
104+-----------+------------+-------------------------------------+
105| die-temp  | on-chip    | die temperature sensor              |
106+-----------+------------+-------------------------------------+
107| RTC       | on-chip    | rtc                                 |
108+-----------+------------+-------------------------------------+
109
110Other hardware features are not yet supported on this Zephyr port.
111
112The default configuration can be found in
113:zephyr_file:`boards/st/nucleo_f429zi/nucleo_f429zi_defconfig`
114
115
116Connections and IOs
117===================
118
119The Nucleo F429ZI Board has 8 GPIO controllers. These controllers are responsible for pin muxing,
120input/output, pull-up, etc.
121
122Available pins:
123---------------
124.. image:: img/nucleo_f429zi_cn8.jpg
125   :align: center
126   :alt: Nucleo F429ZI ZIO connectors (left)
127.. image:: img/nucleo_f429zi_cn7.jpg
128   :align: center
129   :alt: Nucleo F429ZI ZIO connectors (right)
130.. image:: img/nucleo_f429zi_cn11.jpg
131   :align: center
132   :alt: Nucleo F429ZI Morpho connectors (left)
133.. image:: img/nucleo_f429zi_cn12.jpg
134   :align: center
135   :alt: Nucleo F429ZI Morpho connectors (right)
136
137For more details please refer to `STM32 Nucleo-144 board User Manual`_.
138
139Default Zephyr Peripheral Mapping:
140----------------------------------
141
142The Nucleo F429ZI board features a ST Zio connector (extended Arduino Uno V3)
143and a ST morpho connector. Board is configured as follows
144
145- UART_3 TX/RX : PD8/PD9 (ST-Link Virtual Port Com)
146- UART_6 TX/RX : PG14/PG9 (Arduino Serial)
147- I2C1 SCL/SDA : PB8/PB9 (Arduino I2C)
148- SPI1 NSS/SCK/MISO/MOSI : PD14/PA5/PA6/PA7 (Arduino SPI)
149- PWM_2_CH1 : PE13
150- ETH : PA1, PA2, PA7, PB13, PC1, PC4, PC5, PG11, PG13
151- USER_PB : PC13
152- LD1 : PB0
153- LD2 : PB7
154- LD3 : PB14
155- USB DM : PA11
156- USB DP : PA12
157- ADC1 : PA0
158
159System Clock
160------------
161
162The Nucleo F429ZI System Clock could be driven by an internal or external oscillator,
163as well as by the main PLL clock. By default System clock is driven by PLL clock at 180MHz,
164driven by an 8MHz high speed external clock.
165
166Serial Port
167-----------
168
169The Nucleo F429ZI board has 8 UARTs. The Zephyr console output is assigned to UART3.
170Default settings are 115200 8N1.
171
172
173Programming and Debugging
174*************************
175
176The Nucleo F429ZI board includes an ST-LINK/V2-1 embedded debug tool interface.
177
178Flashing
179========
180
181The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
182so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
183
184Alternatively, OpenOCD or JLink can also be used to flash the board using
185the ``--runner`` (or ``-r``) option:
186
187.. code-block:: console
188
189   $ west flash --runner openocd
190   $ west flash --runner jlink
191
192Flash partitions for MCUBoot bootloader
193***************************************
194
195The on-board STM32F429ZI MCU has 2MBs of internal flash memory. To use `MCUboot`_,
196define a :ref:`Zephyr partition table <flash_map_api>` for the flash memory in
197its devicetree file ``nucleo_f429zi.dts``. As a reference, a partition table for
198MCUBoot is already defined in the devicetree file, with these settings:
199
200- `MCUBoot`_ bootloader partition takes 64K bytes.
201- Zephyr settings partition takes 64K bytes.
202- Application image takes 256K bytes in Slot 0 partition.
203- Updating image takes another 256K bytes in Slot 1 partition.
204- A scratch partition with 128K is required for image swap.
205
206A specific application can adjust each partition size based on its needs.
207
208
209.. _Nucleo F429ZI website:
210   https://www.st.com/en/evaluation-tools/nucleo-f429zi.html
211
212.. _STM32 Nucleo-144 board User Manual:
213   https://www.st.com/resource/en/user_manual/dm00244518.pdf
214
215.. _STM32F429ZI on www.st.com:
216   https://www.st.com/en/microcontrollers/stm32f429zi.html
217
218.. _STM32F429 reference manual:
219   https://www.st.com/resource/en/reference_manual/dm00031020.pdf
220
221.. _STM32F429 datasheet:
222   https://www.st.com/resource/en/datasheet/DM00071990.pdf
223
224.. _MCUBoot:
225   https://github.com/JuulLabs-OSS/mcuboot/blob/master/README.md
226
227.. _STM32CubeProgrammer:
228   https://www.st.com/en/development-tools/stm32cubeprog.html
229