boards/st/nucleo_u5a5zj_q/doc/index.rst
.. zephyr:board:: nucleo_u5a5zj_q
Overview
The Nucleo U5A5ZJ Q board, featuring an ARM Cortex-M33 based STM32U5A5ZJ MCU, 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. Here are some highlights of the Nucleo U5A5ZJ Q board:
STM32U5A5ZJ microcontroller in LQFP144 package
Internal SMPS to generate V core logic supply
Two types of extension resources:
On-board ST-LINK/V3E debugger/programmer
Flexible board power supply:
Three users LEDs
Two push-buttons: USER and RESET
USB Type-C ™ Sink device FS
Hardware
The STM32U5A5xx devices are an ultra-low-power microcontrollers family (STM32U5 Series) based on the high-performance Arm® Cortex®-M33 32-bit RISC core. They operate at a frequency of up to 160 MHz.
Includes ST state-of-the-art patented technology
Ultra-low-power with FlexPowerControl:
Core:
Power management:
Benchmarks:
Memories:
Rich graphic features:
General-purpose input/outputs:
Clock management:
Security and cryptography:
Up to 17 timers, 2 watchdogs and RTC:
Up to 25 communication peripherals:
Mathematical coprocessor:
Rich analog peripherals (independent supply):
ECOPACK2 compliant packages
More information about STM32U5A5ZJ can be found here:
STM32U5A5ZJ on www.st.com_STM32U5A5 reference manual_.. zephyr:board-supported-hw::
Nucleo U5A5ZJ Q Board has 10 GPIO controllers. These controllers are responsible for pin muxing, input/output, pull-up, etc.
For more details please refer to STM32 Nucleo-144 board User Manual_.
Nucleo U5A5ZJ Q System Clock could be driven by internal or external oscillator, as well as main PLL clock. By default System clock is driven by PLL clock at 160MHz, driven by the 16MHz high speed oscillator.
Nucleo U5A5ZJ Q board has 6 U(S)ARTs. The Zephyr console output is assigned to USART1. Default settings are 115200 8N1.
In order to test backup SRAM you may want to disconnect VBAT from VDD. You can
do it by removing SB50 jumper on the back side of the board.
USB 2.0 high speed (HS) operation requires the HSE clock source to be populated and enabled. The Nucleo U5A5ZJ-Q includes the 16MHz oscillator and required jumper settings.
Programming and Debugging
.. zephyr:board-supported-runners::
Nucleo U5A5ZJ-Q board includes an ST-LINK/V3 embedded debug tool interface. This probe allows to flash the board using various tools.
The board is configured to be flashed using west STM32CubeProgrammer_ runner,
so its :ref:installation <stm32cubeprog-flash-host-tools> is required.
Alternatively, OpenOCD, JLink, or pyOCD 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 $ west flash --runner pyocd
For pyOCD, additional target information needs to be installed. This can be done by executing the following commands.
.. code-block:: console
$ pyocd pack --update $ pyocd pack --install stm32u5
Connect the Nucleo U5A5ZJ Q to your host computer using the USB port.
Then build and flash an application. Here is an example for the
:zephyr:code-sample:hello_world application.
Run a serial host program to connect with your Nucleo board:
.. code-block:: console
$ minicom -D /dev/ttyACM0
Then build and flash the application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_u5a5zj_q :goals: build flash
You should see the following message on the console:
.. code-block:: console
Hello World! arm
Default flasher for this board is openocd. It could be used in the usual way.
Here is an example for the :zephyr:code-sample:blinky application.
.. zephyr-app-commands:: :zephyr-app: samples/basic/blinky :board: nucleo_u5a5zj_q :goals: debug
Note: Check the build/tfm directory to ensure that the commands required by these scripts
(readlink, etc.) are available on your system. Please also check STM32_Programmer_CLI
(which is used for initialization) is available in the PATH.
.. _STM32 Nucleo-144 board User Manual: https://www.st.com/resource/en/user_manual/um2861-stm32u5-nucleo144-board-mb1549-stmicroelectronics.pdf
.. _STM32U5A5ZJ on www.st.com: https://www.st.com/en/microcontrollers/stm32u5a5zj.html
.. _STM32U5A5 reference manual: https://www.st.com/resource/en/reference_manual/rm0456-stm32u5-series-armbased-32bit-mcus-stmicroelectronics.pdf
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html
.. _STMicroelectronics customized version of OpenOCD: https://github.com/STMicroelectronics/OpenOCD