boards/st/stm32h5f5j_dk/doc/index.rst
.. zephyr:board:: stm32h5f5j_dk
Overview
The STM32H5F5J-DK Discovery kit is designed as a complete demonstration and development platform for STMicroelectronics Arm® Cortex®‑M33 core-based STM32H5F5LJH7Q microcontroller with TrustZone®. Here are some highlights of the STM32H5F5J-DK Discovery board:
STM32H5F5LJH7Q microcontroller featuring 4 Mbytes of Flash memory and 1.5 Mbytes of SRAM in TFBGA225 package
4.3" RGB 480X572pixels TFT colored LCD module and touch panel
USB Type-C® Full-Speed device with USB power-delivery sink only controller
SAI Audio DAC stereo with one audio jacks for input/output,
ST MEMS digital microphone with PDM interface
Octo-SPI interface connected to 512Mbit Octo-SPI NORFlash memory device (MX25LM51245GXDI00 from MACRONIX)
Octo-SPI interface connected to 64Mbit Octo-SPI SRAM memory.
10/100-Mbit Ethernet,
microSD™
A Wi‑Fi® add-on board
Board connectors
Flexible power-supply options
On-board STLINK-V3E debugger/programmer with USB re-enumeration capability:
4 user LEDs
User and reset push-buttons
More information about the board can be found at the STM32H5F5J-DK Discovery website_.
Hardware
The STM32H5F5xx devices are an high-performance microcontrollers family (STM32H5 Series) based on the high-performance Arm® Cortex®‑M33 32-bit RISC core. They operate at a frequency of up to 250 MHz.
Core: Arm® 32-bit Cortex®-M33 CPU with TrustZone® and FPU.
Performance benchmark:
Security
Clock management:
Power management
RTC with HW calendar, alarms and calibration
Up to 178 fast I/Os, most 5 V-tolerant, up to 10 I/Os with independent supply down to 1.08 V
Up to 24 timers and 2 watchdogs
Memories
Rich analog peripherals (independent supply)
37x communication interfaces
CORDIC for trigonometric functions acceleration
FMAC (filter mathematical accelerator)
CRC calculation unit
Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell™
More information about STM32H5F5 can be found here:
STM32H5F5 on www.st.com_STM32H5F5 reference manual_.. zephyr:board-supported-hw::
STM32H5F5J-DK Discovery Board has 9 GPIO controllers. These controllers are responsible for pin muxing, input/output, pull-up, etc.
For more details please refer to STM32H5F5J-DK Discovery board User Manual_.
STM32H5F5J-DK 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 250MHz, driven by 48MHz external oscillator (HSE).
STM32H5F5J-DK Discovery board has 3 U(S)ARTs. The Zephyr console output is assigned to USART2. Default settings are 115200 8N1.
The TFT LCD screen and touch panel are supported for the STM32H5F5J-DK Discovery board.
They can be tested using :zephyr:code-sample:lvgl sample:
.. zephyr-app-commands:: :zephyr-app: samples/subsys/display/lvgl :board: stm32h5f5j_dk :goals: build
Programming and Debugging
.. zephyr:board-supported-runners::
STM32H5F5J-DK Discovery board includes an ST-LINK/V3E embedded debug tool interface.
Applications for the stm32h5f5j_dk board configuration can be built and
flashed in the usual way (see :ref:build_an_application and
:ref:application_run for more details).
For now, OpenOCD support for STM32H5 is not available on upstream OpenOCD.
You can check OpenOCD official Github mirror.
In order to use it though, you should clone from the customized
STMicroelectronics OpenOCD Github and compile it following usual README guidelines.
Once it is done, you can set the OPENOCD and OPENOCD_DEFAULT_PATH variables in
:zephyr_file:boards/st/stm32h5f5j_dk/board.cmake to point the build
to the paths of the OpenOCD binary and its scripts, before including the
common openocd.board.cmake file:
.. code-block:: none
set(OPENOCD "<path_to_openocd_repo>/src/openocd" CACHE FILEPATH "" FORCE)
set(OPENOCD_DEFAULT_PATH <path_to_opneocd_repo>/tcl)
include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)
The board is configured to be flashed using west STM32CubeProgrammer_ runner,
so its :ref:installation <stm32cubeprog-flash-host-tools> is required.
Connect the STM32H5F5J-DK Discovery 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: stm32h5f5j_dk :goals: build flash
You should see the following message on the console:
.. code-block:: console
Hello World! stm32h5f5j_dk/stm32h5f5xx
You can debug an application 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: stm32h5f5j_dk :maybe-skip-config: :goals: debug
.. _STM32H5F5J-DK Discovery website: https://www.st.com/en/evaluation-tools/stm32h5f5j-dk.html
.. _STM32H5F5J-DK Discovery board User Manual: https://www.st.com/en/evaluation-tools/stm32h5f5j-dk.html
.. _STM32H5F5 on www.st.com: https://www.st.com/en/microcontrollers-microprocessors/stm32h5f5lj.html
.. _STM32H5F5 reference manual: https://www.st.com/resource/en/reference_manual/DM01023297.pdf
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html
.. _OpenOCD official Github mirror: https://github.com/openocd-org/openocd/
.. _STMicroelectronics OpenOCD Github: https://github.com/STMicroelectronics/OpenOCD/tree/openocd-cubeide-r6