Release Notes for STM32CubeH5 Firmware Package
Copyright © 2023 STMicroelectronics
Purpose
STMCube is an STMicroelectronics original initiative to ease developers life by reducing development efforts, time and cost.
STM32Cube covers STM32 portfolio.
STM32Cube Version 1.x includes:
The STM32CubeMX, a graphical software configuration tool that allows to generate C initialization code using graphical wizards.
A comprehensive embedded software platform, delivered per series (such as STM32CubeH5 for STM32H5 series)
The STM32Cube HAL, an STM32 abstraction layer embedded software, ensuring maximized portability across STM32 portfolio
A consistent set of middleware components such as RTOS, USB, TCP/IP, Graphics]
The STM32Cube firmware solution offers a straightforward API with a modular architecture, making it simple to fine tune custom applications and scalable to fit most requirements.
Both the HAL and LL APIs are production–ready, checked with CodeSonar® static analysis tool, and developed in compliance with MISRA C® guidelines, following a process certified according to IEC 61508 systematic capability 2 level (SC2). Reports are available on demand.
The drivers provided within this package support the STM32H573xx / STM32H563xx / STM32H562xx / STM32H503xx lines.
- For quick getting started with the STM32CubeH5 firmware package, refer to UM3065 you can download firmware updates and all the latest documentation from www.st.com/stm32cubeH5
- Below links to the most useful documents:
Update History
Main Changes
- Maintenance Release of STM32CubeH5 Firmware Package
Contents
Features
STM32CubeH5 gathers in one single package all the generic embedded software components required to develop an application on STM32H5 microcontrollers.
- Production–ready HAL and LL API drivers, checked with CodeSonar® static analysis tool, and developed in compliance with MISRA C® guidelines, following a process certified according to IEC 61508 systematic capability 2 level (SC2)
- CMSIS CORE, DSP and RTOS software components
- Consistent set of middleware components (Azure® RTOS USBX, FileX/LevelX, ThreadX, NetX Duo, USB Power Delivery, mcu-boot, mbed-crypto, Secure Manager API, and OpenBootloader).
- Up to 300 examples and applications for easy understanding, all compatible with STM32CubeMX to facilitate the configuration through a graphical tool
STM32H5 devices support Arm® PSA security model.
The STM32CubeH5 reference firmware supports all the different configurations of the SMT32H5, it implements Secure Boot and Secure Firmware Update functions managed into the two iRot (when ST-iRoT not active) and uRot memory areas. It provides an ST proprietary SMAK solution, Arm® PSA API Compliant, and accessible by the non-secure domain. It can be additionally installed on STM32H5 to enable Cryptographic, Secure key management, Platform Attestation, Secure Firmware Update functions. For more details refer to the SMAK application.
Projects
The STM32CubeH5 Firmware package comes with template running on STMicroelectronics boards, organized by board and provided with preconfigured projects for the main supported toolchains. The exhaustive list of projects is provided in this table STM32CubeProjectsList.html
This release contains all HAL drivers and LL drivers, all templates, BSP drivers, advanced set of applications and examples.
| Name | Version | Release notes |
|---|---|---|
| Projects | V1.1.0 | release notes |
Notes
- Make sure to not change the product state level from OPEN to higher product state without having provisioned the Debug Authentication (certificate and permissions). Otherwise, there is a risk to lose the MCU. The provisioning script ensures the provisioning of the Debug Authentication is performed prior modifying the product state , so that it will be possible to reinitialize the device.
Components
The components flagged by “” have changed since the previous release. “” are new.
| Name | Version | Release note |
|---|---|---|
| CMSIS | V5.9.0 | release notes |
| STM32H5xx CMSIS | V1.1.0 | release notes |
| STM32H5xx HAL | V1.1.0 | release notes |
| BSP STM32H5xx NUCLEO | V1.0.1 | release notes |
| BSP STM32H573I-DK | V1.0.1 | release notes |
| BSP Common | V7.2.1 | release notes |
| BSP lan8742 | V1.0.2 | release notes |
| BSP cs42l51 | V2.0.5 | release notes |
| BSP mx25lm51245g | V3.0.2 | release notes |
| BSP ft6x06 | V2.0.3 | release notes |
| BSP st7789h2 | V2.0.4 | release notes |
| BSP tcpp0203 | V1.2.3 | release notes |
| BSP mx_wifi | V2.3.4 | release notes |
| Name | Version | Release note |
|---|---|---|
| STM32 USBPD Core Library | V4.1.1 | release notes |
| STM32 USBPD Device Library | h5_v1.1.1 | release notes |
| secure_manager_api | V2.0.0 | release notes |
| mbed-crypto | mbed-crypto-2.25.0.4 | ST release notes |
| mcuboot | v1.7.2.11.20230609.2 | ST release notes |
| trustedfirmware | tfm/v1.3.0-bl2.7 | ST release notes |
| OpenBootloader | V6.1.1 | release notes |
| ThreadX | threadx-6.2.0.221223 | release notes |
| NetXduo | netxduo-6.2.0.221223 | release notes |
| USBX | usbx-6.2.0.221223 | release notes |
| FileX | filex-6.2.0.221223 | release notes |
| LevelX | levelx-6.2.0.221223 | release notes |
| Name | Version | Release note |
|---|---|---|
| Common | V1.6.1 | release notes |
| Fonts | V2.0.3 | release notes |
| CPU | V1.1.3 | release notes |
| lcd | V2.0.2 | release notes |
| GUI_INTERFACE | GUI_V2.3.0 | release notes |
| TRACER_EMB | V1.10.0 | release notes |
| ITSbuilder | V1.0.0 | release notes |
| Certificates | V1.1.0 | release notes |
| ROT_AppliConfig | V1.0.3 | release notes |
| HASH_HAL_Migrator | V1.0.0 | release notes |
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1 + ST-LINK, patch available here:
- Utilities\PC_Software\IDEs_Patches\EWARM\EWARMv8_STM32H5xx_V1.0.zip
- This patch supports STM32H573/STM32H563/STM32H562/STM32H503 devices
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.37 + ST-LINK, patch available here:
- Utilities\PC_Software\IDEs_Patches\MDK-ARM\Keil.STM32H5xx_DFP.1.0.0.zip
- This patch supports STM32H573/STM32H563/STM32H562/STM32H503 devices
- STM32CubeIDE V1.13.0 (GCC11)
Supported Devices and boards
- Devices:
- STM32H573xx/STM32H563xx/STM32H562xx revX
- STM32H503xx revX
- Boards:
- NUCLEO-H563ZI REV B
- NUCLEO-H503RB REV B
- STM32H573I-DK REV C
Dependencies
- STM32CubeMX V6.9.0
- Projects (Examples and Applications) are generated using STM32CubeMX version V6.9.0
- The SMAK Non-Secure application requires the installation of Secure Manager Package (X-CUBE-SEC-M-H5) delivered outside this package.
- The EMW3080B MXCHIP Wi-Fi module firmware version used is V2.3.4, for more details refer to Wi-Fi example readme files which can be found under Projects/STM32H573I-DK/Applications/NetXDuo.
Known Limitations
- Some project are not generated with STM32CubeMX tool for the exhaustive list please refer to this table STM32CubeProjectsList.html
- The SMAK application rely on postbuild commands based on .bat scripts. Such postbuild .bat scripts are not compatible with host environments different than Windows.
- Comment error in “MX_WIFI BSP Component” Release_Notes : “The EMW3080B MXCHIP Wi-Fi module firmware version has to be V2.3.4 instead of V2.3.4 rc 13”
- The component “USBX/CoreSystem” must be selected alongside either “USBX/UX Host CoreStack” or “USBX/UX Device CoreStack”
- In NetXDuo, some configuration flags, that are not used in the STM32Cube FW package examples, might be non-functional when combined. This limitation will be fixed in upcoming releases
- The following projects are not supported with MDK-ARM toolchain:
- STM32H573I-DK/Demonstration
- NUCLEO-H563ZI/Examples/I3C/I3C_Controller_IBI_Wakeup_IT
- NUCLEO-H563ZI/Examples/I3C/I3C_Target_IBI_Wakeup_IT
- NUCLEO-H563ZI/Examples/I3C/I3C_Controller_Direct_Command_DMA
- NUCLEO-H563ZI/Examples/I3C/I3C_Target_Direct_Command_DMA
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_IT
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_IT
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_Polling
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_Polling
- NUCLEO-H503RB/Examples/I3C/I3C_Sensor_Direct_Command_DMA
- NUCLEO-H503RB/Examples/I3C/I3C_Sensor_Private_Command_IT
- STM32H573I-DK/Examples/DCACHE/DCACHE_Maintenance
- NUCLEO-H563ZI/Examples/I2C/I2C_TwoBoards_RestartAdvComIT
- NUCLEO-H563ZI/Examples/DMA/DMA_LinkedList
- NUCLEO-H563ZI/Examples/DAC/SimpleConversion
- NUCLEO-H563ZI/Examples_LL/I2C/I2C_OneBoard_AdvCommunication_DMAAndIT_Init
- The following projects are not supported with STM32CubeIDE toolchain (Debug and Release):
- NUCLEO-H563ZI/Examples/I3C/I3C_Controller_IBI_Wakeup_IT
- NUCLEO-H563ZI/Examples/I3C/I3C_Target_IBI_Wakeup_IT
- STM32H573I-DK/Examples/DCACHE/DCACHE_Maintenance
- The following projects are not supported with STM32CubeIDE toolchain (Release):
- STM32H573I-DK/Examples/OSPI/OSPI_NOR_ReadWrite_DMA_DTR
Backward Compatibility
- No compatibility break
Main Changes
- Patch release of STM32CubeH5 Firmware Package
- Fix DA obk provisioning failure when TZ disabled on NUCLEO-H563ZI board
Contents
The same contents as for V1.0.0 except modifications done on the following files to fix above issue:
- NUCLEO-H563ZI/ROT_Provisioning/DA/Binary/DA_ConfigWithPassword.obk
- NUCLEO-H563ZI/ROT_Provisioning/DA/Binary/DA_ConfigWithPassword.xml
Main Changes
- First Official Release of STM32CubeH5 Firmware Package
Contents
Features
STM32CubeH5 gathers in one single package all the generic embedded software components required to develop an application on STM32H5 microcontrollers.
- Production–ready HAL and LL API drivers, checked with CodeSonar® static analysis tool, and developed in compliance with MISRA C® guidelines, following a process certified according to IEC 61508 systematic capability 2 level (SC2)
- CMSIS CORE, DSP and RTOS software components
- Consistent set of middleware components (Azure® RTOS USBX, FileX/LevelX, ThreadX, NetX Duo, USB Power Delivery, mcu-boot, mbed-crypto, Secure Manager API, and OpenBootloader).
- Up to 290 examples and applications for easy understanding, all compatible with STM32CubeMX to facilitate the configuration through a graphical tool
STM32H5 devices support Arm® PSA security model.
The STM32CubeH5 reference firmware supports all the different configurations of the SMT32H5, it implements Secure Boot and Secure Firmware Update functions managed into the two iRot (when ST-iRoT not active) and uRot memory areas. It provides an ST proprietary SMAK solution, Arm® PSA API Compliant, and accessible by the non-secure domain. It can be additionally installed on STM32H5 to enable Cryptographic, Secure key management, Platform Attestation, Secure Firmware Update functions. For more details refer to the SMAK application.
Projects
The STM32CubeH5 Firmware package comes with template running on STMicroelectronics boards, organized by board and provided with preconfigured projects for the main supported toolchains. The exhaustive list of projects is provided in this table STM32CubeProjectsList.html
This release contains all HAL drivers and LL drivers, all templates, BSP drivers, advanced set of applications and examples.
| Name | Version | Release notes |
|---|---|---|
| Projects | V1.0.0 | release notes |
Notes
Make sure to not change the product state level from OPEN to higher product state without having provisioned the Debug Authentication (certificate and permissions). Otherwise, there is a risk to lose the MCU. The provisioning script ensures the provisioning of the Debug Authentication is performed prior modifying the product state , so that it will be possible to reinitialize the device.
This firmware package contains examples that run only on the STM32H573I-DK which will be available in June 2023.
Components
| Name | Version | Release note |
|---|---|---|
| CMSIS | V5.6.0_cm33 | release notes |
| STM32H5xx CMSIS | V1.0.0 | release notes |
| STM32H5xx HAL | V1.0.0 | release notes |
| BSP STM32H5xx NUCLEO | V1.0.0 | release notes |
| BSP STM32H573I-DK | V1.0.0 | release notes |
| BSP Common | V7.2.1 | release notes |
| BSP lan8742 | V1.0.2 | release notes |
| BSP cs42l51 | V2.0.5 | release notes |
| BSP mx25lm51245g | V3.0.2 | release notes |
| BSP ft6x06 | V2.0.3 | release notes |
| BSP st7789h2 | V2.0.4 | release notes |
| BSP tcpp0203 | V1.2.3 | release notes |
| BSP mx_wifi | V2.3.4 | release notes |
| Name | Version | Release note |
|---|---|---|
| STM32 USBPD Core Library | V4.1.1 | release notes |
| STM32 USBPD Device Library | h5_v1.1.1 | release notes |
| secure_manager_api | V1.0.0 | release notes |
| mbed-crypto | mbed-crypto-2.25.0 | ST release notes |
| mcuboot | V1.7.2.11 | ST release notes |
| trustedfirmware | tfm/v1.3.0-bl2.6 | ST release notes |
| OpenBootloader | V6.1.1 | release notes |
| ThreadX | threadx-6.2.0.221223 | release notes |
| NetXduo | netxduo-6.2.0.221223 | release notes |
| USBX | usbx-6.2.0.221223 | release notes |
| FileX | filex-6.2.0.221223 | release notes |
| LevelX | levelx-6.2.0.221223 | release notes |
| Name | Version | Release note |
|---|---|---|
| Common | V1.6.1 | release notes |
| Fonts | V2.0.3 | release notes |
| CPU | V1.1.3 | release notes |
| lcd | V2.0.2 | release notes |
| GUI_INTERFACE | GUI_V2.2.1 | release notes |
| TRACER_EMB | V1.7.1 | release notes |
| ROT_AppliConfig | V1.0.0 | release notes |
| HASH_HAL_Migrator | V1.0.0 | release notes |
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1 + ST-LINK, patch available here:
- Utilities\PC_Software\IDEs_Patches\EWARM\EWARMv8_STM32H5xx_V1.0.zip
- This patch supports STM32H573/STM32H563/STM32H562/STM32H503 devices
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.37 + ST-LINK, patch available here:
- Utilities\PC_Software\IDEs_Patches\MDK-ARM\Keil.STM32H5xx_DFP.1.0.0.zip
- This patch supports STM32H573/STM32H563/STM32H562/STM32H503 devices
- STM32CubeIDE V1.12.0 (GCC11)
Supported Devices and boards
- Devices:
- STM32H573xx/STM32H563xx/STM32H562xx revZ
- STM32H503xx revZ
- Boards:
- NUCLEO-H563ZI REV B
- NUCLEO-H503RB REV B
- STM32H573I-DK REV C
Dependencies
- STM32CubeMX V6.8.0
- Projects (Examples and Applications) are generated using STM32CubeMX version V6.8.0.
- The SMAK Non-Secure application requires the installation of Secure Manager Package (X-CUBE-SEC-M-H5) delivered outside this package.
- The EMW3080B MXCHIP Wi-Fi module firmware version used is V2.3.4, for more details refer to Wi-Fi example readme files which can be found under Projects/STM32H573I-DK/Applications/NetXDuo.
Known Limitations
- Some project are not generated with STM32CubeMX tool for the exhaustive list please refer to this table STM32CubeProjectsList.html
- The ROT applications rely on postbuild commands based on .bat scripts. Such postbuild .bat scripts are not compatible with host environments different than Windows.
- Comment error in “MX_WIFI BSP Component” Release_Notes : “The EMW3080B MXCHIP Wi-Fi module firmware version has to be V2.3.4 instead of V2.3.4 rc 13”
- The following projects are not supported with MDK-ARM toolchain:
- ROT applications and ROT Templates on all boards
- STM32H573I-DK/Demonstration
- STM32H573I-DK/Applications/USBPD/SRC
- STM32H573I-DK/Applications/USBPD/SRC_UX_Host_MSC
- STM32H573I-DK/Examples/GTZC/GTZC_MPCWM_IllegalAccess_TrustZone
- NUCLEO-H563ZI/Applications/USBPD/SNK
- NUCLEO-H563ZI/Applications/USBPD/SNK_UX_Device_HID
- NUCLEO-H563ZI/Examples/I2C/I2C_TwoBoards_RestartAdvComIT
- NUCLEO-H563ZI/Examples/DAC/DAC_SimpleConversion
- NUCLEO-H563ZI/Examples/DMA/DMA_LinkedList
- NUCLEO-H563ZI/Examples/FLASH/FLASH_SwapBanks
- NUCLEO-H563ZI/Examples_HAL/I3C/I3C_Controller_Direct_Command_DMA
- NUCLEO-H563ZI/Examples_HAL/I3C/I3C_Target_Direct_Command_DMA
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_IT
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_IT
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_Polling
- NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_Polling
- The following projects are not supported with STM32CubeIDE toolchain (Debug and Release):
- STM32H573I-DK/Demonstration
- STM32H573I-DK/Applications/ROT/OEMiROT_Boot
- STM32H573I-DK/Applications/ROT/OEMiROT_Appli_TrustZone
- STM32H573I-DK/Applications/ROT/STiROT_Appli
- STM32H573I-DK/Applications/ROT/STiROT_Appli_TrustZone
- STM32H573I-DK/Applications/USBPD/SRC
- STM32H573I-DK/Applications/USBPD/SRC_UX_Host_MSC
- STM32H573I-DK/Examples/GTZC/GTZC_MPCWM_IllegalAccess_TrustZone
- NUCLEO-H563ZI/Applications/USBPD/SNK
- NUCLEO-H563ZI/Applications/USBPD/SNK_UX_Device_HID
- NUCLEO-H563ZI/Examples/FLASH/FLASH_SwapBanks
- The following projects are not supported with STM32CubeIDE toolchain (Release):
- STM32H573I-DK/Examples/BSP
- STM32H573I-DK/Examples/OSPI/OSPI_NOR_ReadWrite_DMA_DTR
Backward Compatibility
- Not applicable