boards/st/nucleo_h745zi_q/doc/index.rst
.. zephyr:board:: nucleo_h745zi_q
Overview
The STM32 Nucleo-144 board provides an affordable and flexible way for users to try out new concepts and build prototypes by choosing from the various combinations of performance and power consumption features, provided by the STM32 microcontroller. For the compatible boards, the internal or external SMPS significantly reduces power consumption in Run mode.
The ST Zio connector, which extends the ARDUINO® Uno V3 connectivity, and the ST morpho headers provide an easy means of expanding the functionality of the Nucleo open development platform with a wide choice of specialized shields. The STM32 Nucleo-144 board does not require any separate probe as it integrates the ST-LINK V3 debugger/programmer.
The STM32 Nucleo-144 board comes with the STM32 comprehensive free software libraries and examples available with the STM32Cube MCU Package.
Key Features
STM32 microcontroller in LQFP144 package
Ethernet compliant with IEEE-802.3-2002 (depending on STM32 support)
USB OTG or full-speed device (depending on STM32 support)
3 user LEDs
2 user and reset push-buttons
32.768 kHz crystal oscillator
Board connectors:
USB with Micro-AB
Ethernet RJ45 (depending on STM32 support)
SWDST Zio connector including Arduino* Uno V3ST
ST morpho expansion
Flexible power-supply options: ST-LINK USB VBUS or external sources
External or internal SMPS to generate Vcore logic supply
On-board ST-LINK/V3 debugger/programmer with USB re-enumeration
capability: mass storage, virtual COM port and debug port
USB OTG full speed or device only
Comprehensive free software libraries and examples available with the STM32Cube MCU package.
Arm* Mbed Enabled* compliant (only for some Nucleo part numbers)
More information about the board can be found at the Nucleo H745ZI-Q website_.
Hardware
Nucleo H745ZI-Q provides the following hardware components:
.. zephyr:board-supported-hw::
For more details please refer to STM32 Nucleo-144 board User Manual_.
The Nucleo H745ZI board features a ST Zio connector (extended Arduino Uno V3) and a ST morpho connector. Board is configured as follows:
Nucleo H745ZI-Q System Clock could be driven by an internal or external oscillator, as well as the main PLL clock. By default, the System clock is driven by the PLL clock at 480MHz, driven by an 8MHz high-speed external clock.
Nucleo H745ZI-Q board has 4 UARTs and 4 USARTs. The Zephyr console output is assigned to UART3. Default settings are 115200 8N1.
The dual core nature of STM32H745 SoC requires sharing HW resources between the two cores. This is done in 3 ways:
Programming and Debugging
.. zephyr:board-supported-runners::
Nucleo H745ZI-Q board includes an ST-LINK/V3 embedded debug tool interface.
Applications for the nucleo_h745zi_q board should be built per core target,
using either nucleo_h745zi_q/stm32h745xx/m7 or nucleo_h745zi_q/stm32h745xx/m4
as the target (see :ref:build_an_application and :ref:application_run for more details).
.. note::
Check if the board's ST-LINK V3 has the newest FW version. It can be updated
using STM32CubeProgrammer_.
Flashing operation will depend on the target to be flashed and the SoC option bytes configuration.
The board is configured to be flashed using west STM32CubeProgrammer_ runner
for both cores, so its :ref:installation <stm32cubeprog-flash-host-tools> is required.
The target core is detected automatically.
Alternatively, OpenOCD or JLink can also be used to flash the board using
the --runner (or -r) option:
.. code-block:: console
$ west flash --runner openocd $ west flash --runner jlink
It is advised to use STM32CubeProgrammer_ to check and update option bytes
configuration.
By default:
Also, default out of the box board configuration enables CM7 and CM4 boot when
board is powered (Option bytes BCM7 and BCM4 are checked).
In that configuration, Kconfig boot option STM32H7_BOOT_CM4_CM7 should be selected.
Zephyr flash configuration has been set to meet these default settings.
First, connect the NUCLEO-H745ZI-Q to your host computer using the USB port to prepare it for flashing. Then build and flash your application.
Here is an example for the :zephyr:code-sample:hello_world application.
Run a serial host program to connect with your NUCLEO-H745ZI-Q board.
.. code-block:: console
$ minicom -b 115200 -D /dev/ttyACM0
or use screen:
.. code-block:: console
$ screen /dev/ttyACM0 115200
Build and flash the application:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_h745zi_q/stm32h745xx/m7 :goals: build flash
You should see the following message on the console:
.. code-block:: console
$ Hello World! nucleo_h745zi_q_m7
.. note:: Sometimes, flashing is not working. It is necessary to erase the flash (with STM32CubeProgrammer for example) to make it work again.
Similarly, you can build and flash samples on the M4 target. For this, please take care of the resource sharing (UART port used for console for instance).
Here is an example for the :zephyr:code-sample:blinky application on M4 core.
.. zephyr-app-commands:: :zephyr-app: samples/basic/blinky :board: nucleo_h745zi_q/stm32h745xx/m4 :goals: build flash
.. note::
Flashing both M4 and M7 and pushing RESTART button on the board leads to LD1 and LD2 flashing simultaneously.
You can debug an application on Cortex M7 side in the usual way. Here is an example
for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_h745zi_q/stm32h745xx/m7 :maybe-skip-config: :goals: debug
Debugging a Zephyr application on Cortex M4 side with west is currently not available.
As a workaround, you can use STM32CubeIDE_.
.. _Nucleo H745ZI-Q website: https://www.st.com/en/evaluation-tools/nucleo-h745zi-q.html
.. _STM32 Nucleo-144 board User Manual: https://www.st.com/resource/en/user_manual/dm00499171-stm32h7-nucleo144-boards-mb1363-stmicroelectronics.pdf
.. _STM32H745ZI on www.st.com: https://www.st.com/en/microcontrollers-microprocessors/stm32h745zi.html
.. _STM32H745 reference manual: https://www.st.com/resource/en/reference_manual/dm00176879-stm32h745755-and-stm32h747757-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
.. _OpenOCD installing Debug Version: https://github.com/zephyrproject-rtos/openocd
.. _OpenOCD installing with ST-LINK V3 support: https://mbd.kleier.net/integrating-st-link-v3.html
.. _STM32CubeIDE: https://www.st.com/en/development-tools/stm32cubeide.html
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html