1.. zephyr:board:: nucleo_h753zi
2
3Overview
4********
5
6The STM32 Nucleo-144 boards offer combinations of performance and power that
7provide an affordable and flexible way for users to build prototypes and try
8out new concepts. For compatible boards, the SMPS (Switched-Mode Power Supply)
9significantly reduces power consumption in Run mode.
10
11The Arduino-compatible ST Zio connector expands functionality of the Nucleo
12open development platform, with a wide choice of specialized Arduino* Uno V3
13shields.
14
15The STM32 Nucleo-144 board does not require any separate probe as it integrates
16the ST-LINK/V2-1 debugger/programmer.
17
18The STM32 Nucleo-144 board comes with the STM32 comprehensive free software
19libraries and examples available with the STM32Cube MCU Package.
20
21Key Features
22
23- STM32 microcontroller in LQFP144 package
24- Ethernet compliant with IEEE-802.3-2002 (depending on STM32 support)
25- USB OTG or full-speed device (depending on STM32 support)
26- 3 user LEDs
27- 2 user and reset push-buttons
28- 32.768 kHz crystal oscillator
29- Board connectors:
30
31 - USB with Micro-AB
32 - SWD
33 - Ethernet RJ45 (depending on STM32 support)
34 - ST Zio connector including Arduino* Uno V3
35 - ST morpho
36
37- Flexible power-supply options: ST-LINK USB VBUS or external sources.
38- On-board ST-LINK/V2-1 debugger/programmer with USB re-enumeration
39- capability: mass storage, virtual COM port and debug port.
40- Comprehensive free software libraries and examples available with the
41  STM32Cube MCU package.
42- Arm* Mbed Enabled* compliant (only for some Nucleo part numbers)
43
44More information about the board can be found at the `Nucleo H753ZI website`_.
45
46Hardware
47********
48
49Nucleo H753ZI provides the following hardware components:
50
51- STM32H753ZI in LQFP144 package
52- ARM 32-bit Cortex-M7 CPU with FPU
53- Chrom-ART Accelerator
54- Hardware JPEG Codec
55- 480 MHz max CPU frequency
56- VDD from 1.62 V to 3.6 V
57- 2 MB Flash
58- 1 MB SRAM
59- High-resolution timer (2.1 ns)
60- 32-bit timers(2)
61- 16-bit timers(12)
62- SPI(6)
63- I2C(4)
64- I2S (3)
65- USART(4)
66- UART(4)
67- USB OTG Full Speed and High Speed(1)
68- USB OTG Full Speed(1)
69- CAN FD(2)
70- SAI(2)
71- SPDIF_Rx(4)
72- HDMI_CEC(1)
73- Dual Mode Quad SPI(1)
74- Camera Interface
75- GPIO (up to 114) with external interrupt capability
76- 16-bit ADC(3) with 36 channels / 3.6 MSPS
77- 12-bit DAC with 2 channels(2)
78- True Random Number Generator (RNG)
79- 16-channel DMA
80- LCD-TFT Controller with XGA resolution
81- Cryptographic acceleration: AES 128, 192, 256, TDES, HASH (MD5, SHA-1, SHA-2), HMAC
82- Secure firmware upgrade support, Secure access mode
83
84Supported Features
85==================
86
87The Zephyr nucleo_h753zi board configuration supports the following hardware
88features:
89
90+-----------+------------+-------------------------------------+
91| Interface | Controller | Driver/Component                    |
92+===========+============+=====================================+
93| NVIC      | on-chip    | nested vector interrupt controller  |
94+-----------+------------+-------------------------------------+
95| UART      | on-chip    | serial port                         |
96+-----------+------------+-------------------------------------+
97| PINMUX    | on-chip    | pinmux                              |
98+-----------+------------+-------------------------------------+
99| GPIO      | on-chip    | gpio                                |
100+-----------+------------+-------------------------------------+
101| RTC       | on-chip    | counter                             |
102+-----------+------------+-------------------------------------+
103| I2C       | on-chip    | i2c                                 |
104+-----------+------------+-------------------------------------+
105| PWM       | on-chip    | pwm                                 |
106+-----------+------------+-------------------------------------+
107| ADC       | on-chip    | adc                                 |
108+-----------+------------+-------------------------------------+
109| RNG       | on-chip    | True Random number generator        |
110+-----------+------------+-------------------------------------+
111| ETHERNET  | on-chip    | ethernet                            |
112+-----------+------------+-------------------------------------+
113| SPI       | on-chip    | spi                                 |
114+-----------+------------+-------------------------------------+
115| USB       | on-chip    | usb_device                          |
116+-----------+------------+-------------------------------------+
117| CAN/CANFD | on-chip    | canbus                              |
118+-----------+------------+-------------------------------------+
119
120Other hardware features are not yet supported on this Zephyr port.
121
122The default configuration can be found in the defconfig file:
123:zephyr_file:`boards/st/nucleo_h753zi/nucleo_h753zi_defconfig`
124
125For more details please refer to `STM32 Nucleo-144 board User Manual`_.
126
127Default Zephyr Peripheral Mapping:
128----------------------------------
129
130The Nucleo H753ZI board features a ST Zio connector (extended Arduino Uno V3)
131and a ST morpho connector. Board is configured as follows:
132
133- UART_3 TX/RX : PD8/PD9 (ST-Link Virtual Port Com)
134- USER_PB : PC13
135- LD1 : PB0
136- LD2 : PE1
137- LD3 : PB14
138- I2C : PB8, PB9
139- ADC1_INP15 : PA3
140- ETH : PA1, PA2, PA7, PB13, PC1, PC4, PC5, PG11, PG13
141- SPI1 NSS/SCK/MISO/MOSI : PD14/PA5/PA6/PB5 (Arduino SPI)
142- CAN/CANFD : PD0, PD1
143
144System Clock
145------------
146
147Nucleo H753ZI System Clock could be driven by an internal or external
148oscillator, as well as the main PLL clock. By default, the System clock is
149driven by the PLL clock at 96MHz, driven by an 8MHz high-speed external clock.
150
151Serial Port
152-----------
153
154Nucleo H753ZI board has 4 UARTs and 4 USARTs. The Zephyr console output is
155assigned to UART3. Default settings are 115200 8N1.
156
157CAN, CANFD
158----------
159
160Requires an external CAN or CANFD transceiver.
161
162Programming and Debugging
163*************************
164
165Nucleo H753ZI board includes an ST-LINK/V3 embedded debug tool interface.
166
167Applications for the ``nucleo_h753zi`` board configuration can be built and
168flashed in the usual way (see :ref:`build_an_application` and
169:ref:`application_run` for more details).
170
171Flashing
172========
173
174The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
175so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
176
177Alternatively, OpenOCD or JLink can also be used to flash the board using
178the ``--runner`` (or ``-r``) option:
179
180.. code-block:: console
181
182   $ west flash --runner openocd
183   $ west flash --runner jlink
184
185Flashing an application to Nucleo H753ZI
186----------------------------------------
187
188Here is an example for the :zephyr:code-sample:`hello_world` application.
189
190Run a serial host program to connect with your Nucleo board.
191
192.. code-block:: console
193
194   $ minicom -b 115200 -D /dev/ttyACM0
195
196Build and flash the application:
197
198.. zephyr-app-commands::
199   :zephyr-app: samples/hello_world
200   :board: nucleo_h753zi
201   :goals: build flash
202
203You should see the following message on the console:
204
205.. code-block:: console
206
207   $ Hello World! nucleo_h753zi
208
209Debugging
210=========
211
212You can debug an application in the usual way.  Here is an example for the
213:zephyr:code-sample:`hello_world` application.
214
215.. zephyr-app-commands::
216   :zephyr-app: samples/hello_world
217   :board: nucleo_h753zi
218   :maybe-skip-config:
219   :goals: debug
220
221.. _Nucleo H753ZI website:
222   https://www.st.com/en/evaluation-tools/nucleo-h753zi.html
223
224.. _STM32 Nucleo-144 board User Manual:
225   https://www.st.com/resource/en/user_manual/dm00244518.pdf
226
227.. _STM32H753ZI on www.st.com:
228   https://www.st.com/content/st_com/en/products/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus/stm32-high-performance-mcus/stm32h7-series/stm32h743-753/stm32h753zi.html
229
230.. _STM32H753 reference manual:
231   https://www.st.com/resource/en/reference_manual/dm00314099.pdf
232
233.. _STM32CubeProgrammer:
234   https://www.st.com/en/development-tools/stm32cubeprog.html
235