1<!DOCTYPE html> 2<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> 3<head> 4 <meta charset="utf-8" /> 5 <meta name="generator" content="pandoc" /> 6 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" /> 7 <title>Release Notes for STM32CubeH5 Firmware Package</title> 8 <style type="text/css"> 9 code{white-space: pre-wrap;} 10 span.smallcaps{font-variant: small-caps;} 11 span.underline{text-decoration: underline;} 12 div.column{display: inline-block; vertical-align: top; width: 50%;} 13 </style> 14 <link rel="stylesheet" href="_htmresc/mini-st_2020.css" /> 15 <!--[if lt IE 9]> 16 <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script> 17 <![endif]--> 18 <link rel="icon" type="image/x-icon" href="_htmresc/favicon.png" /> 19</head> 20<body> 21<div class="row"> 22<div class="col-sm-12 col-lg-4"> 23<center> 24<h1 id="release-notes-for-stm32cubeh5-firmware-package">Release Notes for <mark> STM32CubeH5 Firmware Package </mark></h1> 25<p>Copyright © 2023 STMicroelectronics<br /> 26</p> 27<a href="https://www.st.com" class="logo"><img src="_htmresc/st_logo_2020.png" alt="ST logo" /></a> 28</center> 29<h1 id="purpose">Purpose</h1> 30<p><span style="font-weight: bold;">STMCube is an STMicroelectronics original initiative to ease developers life by reducing development efforts, time and cost.</span></p> 31<p>STM32Cube covers STM32 portfolio.</p> 32<p>STM32Cube Version 1.x includes:</p> 33<ul> 34<li><p>The STM32CubeMX, a graphical software configuration tool that allows to generate C initialization code using graphical wizards.</p></li> 35<li><p>A comprehensive embedded software platform, delivered per series (such as STM32CubeH5 for STM32H5 series)</p> 36<ul> 37<li><p>The STM32Cube HAL, an STM32 abstraction layer embedded software, ensuring maximized portability across STM32 portfolio</p></li> 38<li><p>A consistent set of middleware components such as RTOS, USB, TCP/IP, Graphics]</p></li> 39</ul></li> 40</ul> 41<p>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.</p> 42<p>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.</p> 43<figure> 44<img src="_htmresc/STM32Cube.bmp" alt="STM32Cube" /><figcaption>STM32Cube</figcaption> 45</figure> 46<p>The <strong>drivers</strong> provided within this package <strong>support</strong> the <strong>STM32H573xx / STM32H563xx / STM32H562xx / STM32H503xx lines.</strong></p> 47<ul> 48<li>For quick getting started with the STM32CubeH5 firmware package, refer to <a href="https://www.st.com/resource/en/user_manual/dm00906547.pdf">UM3065</a> you can download firmware updates and all the latest documentation from <a href="https://www.st.com/en/embedded-software/stm32cubeh5.html">www.st.com/stm32cubeH5</a></li> 49<li>Below links to the most useful documents: 50<ul> 51<li><a href="https://www.st.com/resource/en/user_manual/dm00906547.pdf">UM3065: Getting started with STM32CubeH5 for STM32H5 Series</a></li> 52<li><a href="https://www.st.com/resource/en/user_manual/dm00948527.pdf">UM3132: Description of STM32H5 HAL and low-layer driver</a></li> 53<li><a href="https://www.st.com/resource/en/user_manual/dm00440740.pdf">UM2298: STM32Cube BSP drivers development guidelines</a></li> 54<li><a href="https://wiki.st.com/stm32mcu/wiki/Security:Getting_started_with_STM32H5_security">Getting_started_with_STM32H5_security</a></li> 55<li><a href="https://wiki.st.com/stm32mcu/wiki/Security:Security_with_STM32H5">Security_with_STM32H5</a></li> 56</ul></li> 57</ul> 58</div> 59<div class="col-sm-12 col-lg-8"> 60<h2 id="update-history"><strong>Update History</strong></h2> 61<div class="collapse"> 62<input type="checkbox" id="collapse-section3" checked aria-hidden="true"> <label for="collapse-section3" checked aria-hidden="true"><strong>V1.1.0 / 09-June-2023</strong></label> 63<div> 64<h2 id="main-changes">Main Changes</h2> 65<ul> 66<li>Maintenance Release of <span style="font-weight: bold;">STM32CubeH5</span> Firmware Package</li> 67</ul> 68<h2 id="contents">Contents</h2> 69<h3 id="features"><strong>Features</strong></h3> 70<p>STM32CubeH5 gathers in one single package all the generic embedded software components required to develop an application on STM32H5 microcontrollers.</p> 71<ul> 72<li>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)</li> 73<li>CMSIS CORE, DSP and RTOS software components</li> 74<li>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).</li> 75<li>Up to 300 examples and applications for easy understanding, all compatible with STM32CubeMX to facilitate the configuration through a graphical tool</li> 76</ul> 77<p>STM32H5 devices support Arm® PSA security model.<br /> 78The 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.</p> 79<h3 id="projects"><strong>Projects</strong></h3> 80<p>The <strong>STM32CubeH5</strong> 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 <a href="Projects/STM32CubeProjectsList.html">STM32CubeProjectsList.html</a></p> 81<p>This release contains all HAL drivers and LL drivers, all templates, BSP drivers, advanced set of applications and examples.</p> 82<table> 83<thead> 84<tr class="header"> 85<th style="text-align: left;">Name</th> 86<th style="text-align: center;">Version</th> 87<th style="text-align: center;">Release notes</th> 88</tr> 89</thead> 90<tbody> 91<tr class="odd"> 92<td style="text-align: left;">Projects</td> 93<td style="text-align: center;">V1.1.0 <span class="icon-st-update"></span></td> 94<td style="text-align: center;"><a href="Projects/Release_Notes.html">release notes</a></td> 95</tr> 96</tbody> 97</table> 98<p><strong>Notes</strong></p> 99<ul> 100<li>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.</li> 101</ul> 102<h3 id="components"><strong>Components</strong></h3> 103<p><small>The components flagged by “<span class="icon-st-update"></span>” have changed since the previous release. “<span class="icon-st-add"></span>” are new.</small></p> 104<table> 105<caption><strong>Drivers</strong></caption> 106<thead> 107<tr class="header"> 108<th style="text-align: left;">Name</th> 109<th style="text-align: center;">Version</th> 110<th style="text-align: center;">Release note</th> 111</tr> 112</thead> 113<tbody> 114<tr class="odd"> 115<td style="text-align: left;">CMSIS</td> 116<td style="text-align: center;">V5.9.0 <span class="icon-st-update"></span></td> 117<td style="text-align: center;"><a href="Drivers/CMSIS/documentation/index.html">release notes</a></td> 118</tr> 119<tr class="even"> 120<td style="text-align: left;">STM32H5xx CMSIS</td> 121<td style="text-align: center;">V1.1.0 <span class="icon-st-update"></span></td> 122<td style="text-align: center;"><a href="Drivers/CMSIS/Device/ST/STM32H5xx/Release_Notes.html">release notes</a></td> 123</tr> 124<tr class="odd"> 125<td style="text-align: left;">STM32H5xx HAL</td> 126<td style="text-align: center;">V1.1.0 <span class="icon-st-update"></span></td> 127<td style="text-align: center;"><a href="Drivers/STM32H5xx_HAL_Driver/Release_Notes.html">release notes</a></td> 128</tr> 129<tr class="even"> 130<td style="text-align: left;">BSP STM32H5xx NUCLEO</td> 131<td style="text-align: center;">V1.0.1 <span class="icon-st-update"></span></td> 132<td style="text-align: center;"><a href="Drivers/BSP/STM32H5xx_Nucleo/Release_Notes.html">release notes</a></td> 133</tr> 134<tr class="odd"> 135<td style="text-align: left;">BSP STM32H573I-DK</td> 136<td style="text-align: center;">V1.0.1 <span class="icon-st-update"></span></td> 137<td style="text-align: center;"><a href="Drivers/BSP/STM32H573I-DK/Release_Notes.html">release notes</a></td> 138</tr> 139<tr class="even"> 140<td style="text-align: left;">BSP Common</td> 141<td style="text-align: center;">V7.2.1</td> 142<td style="text-align: center;"><a href="Drivers/BSP/Components/Common/Release_Notes.html">release notes</a></td> 143</tr> 144<tr class="odd"> 145<td style="text-align: left;">BSP lan8742</td> 146<td style="text-align: center;">V1.0.2</td> 147<td style="text-align: center;"><a href="Drivers/BSP/Components/lan8742/Release_Notes.html">release notes</a></td> 148</tr> 149<tr class="even"> 150<td style="text-align: left;">BSP cs42l51</td> 151<td style="text-align: center;">V2.0.5</td> 152<td style="text-align: center;"><a href="Drivers/BSP/Components/cs42l51/Release_Notes.html">release notes</a></td> 153</tr> 154<tr class="odd"> 155<td style="text-align: left;">BSP mx25lm51245g</td> 156<td style="text-align: center;">V3.0.2</td> 157<td style="text-align: center;"><a href="Drivers/BSP/Components/mx25lm51245g/Release_Notes.html">release notes</a></td> 158</tr> 159<tr class="even"> 160<td style="text-align: left;">BSP ft6x06</td> 161<td style="text-align: center;">V2.0.3</td> 162<td style="text-align: center;"><a href="Drivers/BSP/Components/ft6x06/Release_Notes.html">release notes</a></td> 163</tr> 164<tr class="odd"> 165<td style="text-align: left;">BSP st7789h2</td> 166<td style="text-align: center;">V2.0.4</td> 167<td style="text-align: center;"><a href="Drivers/BSP/Components/st7789h2/Release_Notes.html">release notes</a></td> 168</tr> 169<tr class="even"> 170<td style="text-align: left;">BSP tcpp0203</td> 171<td style="text-align: center;">V1.2.3</td> 172<td style="text-align: center;"><a href="Drivers/BSP/Components/tcpp0203/Release_Notes.html">release notes</a></td> 173</tr> 174<tr class="odd"> 175<td style="text-align: left;">BSP mx_wifi</td> 176<td style="text-align: center;">V2.3.4</td> 177<td style="text-align: center;"><a href="Drivers/BSP/Components/mx_wifi/Release_Notes.html">release notes</a></td> 178</tr> 179</tbody> 180</table> 181<table> 182<caption><strong>Middlewares</strong></caption> 183<thead> 184<tr class="header"> 185<th style="text-align: left;">Name</th> 186<th style="text-align: center;">Version</th> 187<th style="text-align: center;">Release note</th> 188</tr> 189</thead> 190<tbody> 191<tr class="odd"> 192<td style="text-align: left;">STM32 USBPD Core Library</td> 193<td style="text-align: center;">V4.1.1</td> 194<td style="text-align: center;"><a href="Middlewares/ST/STM32_USBPD_Library/Core/Release_Notes.html">release notes</a></td> 195</tr> 196<tr class="even"> 197<td style="text-align: left;">STM32 USBPD Device Library</td> 198<td style="text-align: center;">h5_v1.1.1</td> 199<td style="text-align: center;"><a href="Middlewares/ST/STM32_USBPD_Library/Devices/STM32H5XX/Release_Notes.html">release notes</a></td> 200</tr> 201<tr class="odd"> 202<td style="text-align: left;">secure_manager_api</td> 203<td style="text-align: center;">V2.0.0 <span class="icon-st-update"></span></td> 204<td style="text-align: center;"><a href="Middlewares/ST/secure_manager_api/Release_Notes.html">release notes</a></td> 205</tr> 206<tr class="even"> 207<td style="text-align: left;">mbed-crypto</td> 208<td style="text-align: center;">mbed-crypto-2.25.0.4 <span class="icon-st-update"></span></td> 209<td style="text-align: center;"><a href="Middlewares/Third_Party/mbed-crypto/st_readme.txt">ST release notes</a></td> 210</tr> 211<tr class="odd"> 212<td style="text-align: left;">mcuboot</td> 213<td style="text-align: center;">v1.7.2.11.20230609.2 <span class="icon-st-update"></span></td> 214<td style="text-align: center;"><a href="Middlewares/Third_Party/mcuboot/st_readme.txt">ST release notes</a></td> 215</tr> 216<tr class="even"> 217<td style="text-align: left;">trustedfirmware</td> 218<td style="text-align: center;">tfm/v1.3.0-bl2.7 <span class="icon-st-update"></span></td> 219<td style="text-align: center;"><a href="Middlewares/Third_Party/trustedfirmware/st_readme.txt">ST release notes</a></td> 220</tr> 221<tr class="odd"> 222<td style="text-align: left;">OpenBootloader</td> 223<td style="text-align: center;">V6.1.1</td> 224<td style="text-align: center;"><a href="Middlewares/ST/OpenBootloader/Release_Notes.html">release notes</a></td> 225</tr> 226<tr class="even"> 227<td style="text-align: left;">ThreadX</td> 228<td style="text-align: center;">threadx-6.2.0.221223</td> 229<td style="text-align: center;"><a href="https://github.com/azure-rtos/threadx/releases/tag/v6.2.0_rel">release notes</a></td> 230</tr> 231<tr class="odd"> 232<td style="text-align: left;">NetXduo</td> 233<td style="text-align: center;">netxduo-6.2.0.221223</td> 234<td style="text-align: center;"><a href="https://github.com/azure-rtos/netxduo/releases/tag/v6.2.0_rel">release notes</a></td> 235</tr> 236<tr class="even"> 237<td style="text-align: left;">USBX</td> 238<td style="text-align: center;">usbx-6.2.0.221223</td> 239<td style="text-align: center;"><a href="https://github.com/azure-rtos/usbx/releases/tag/v6.2.0_rel">release notes</a></td> 240</tr> 241<tr class="odd"> 242<td style="text-align: left;">FileX</td> 243<td style="text-align: center;">filex-6.2.0.221223</td> 244<td style="text-align: center;"><a href="https://github.com/azure-rtos/filex/releases/tag/v6.2.0_rel">release notes</a></td> 245</tr> 246<tr class="even"> 247<td style="text-align: left;">LevelX</td> 248<td style="text-align: center;">levelx-6.2.0.221223</td> 249<td style="text-align: center;"><a href="https://github.com/azure-rtos/levelx/releases/tag/v6.2.0_rel">release notes</a></td> 250</tr> 251</tbody> 252</table> 253<table> 254<caption><strong>Utilities</strong></caption> 255<thead> 256<tr class="header"> 257<th style="text-align: left;">Name</th> 258<th style="text-align: center;">Version</th> 259<th style="text-align: center;">Release note</th> 260</tr> 261</thead> 262<tbody> 263<tr class="odd"> 264<td style="text-align: left;">Common</td> 265<td style="text-align: center;">V1.6.1</td> 266<td style="text-align: center;"><a href="Utilities/Common/Release_Notes.html">release notes</a></td> 267</tr> 268<tr class="even"> 269<td style="text-align: left;">Fonts</td> 270<td style="text-align: center;">V2.0.3</td> 271<td style="text-align: center;"><a href="Utilities/Fonts/Release_Notes.html">release notes</a></td> 272</tr> 273<tr class="odd"> 274<td style="text-align: left;">CPU</td> 275<td style="text-align: center;">V1.1.3</td> 276<td style="text-align: center;"><a href="Utilities/CPU/Release_Notes.html">release notes</a></td> 277</tr> 278<tr class="even"> 279<td style="text-align: left;">lcd</td> 280<td style="text-align: center;">V2.0.2</td> 281<td style="text-align: center;"><a href="Utilities/lcd/Release_Notes.html">release notes</a></td> 282</tr> 283<tr class="odd"> 284<td style="text-align: left;">GUI_INTERFACE</td> 285<td style="text-align: center;">GUI_V2.3.0 <span class="icon-st-update"></span></td> 286<td style="text-align: center;"><a href="Utilities/GUI_INTERFACE/Release_Notes.html">release notes</a></td> 287</tr> 288<tr class="even"> 289<td style="text-align: left;">TRACER_EMB</td> 290<td style="text-align: center;">V1.10.0 <span class="icon-st-update"></span></td> 291<td style="text-align: center;"><a href="Utilities/TRACER_EMB/Release_Notes.html">release notes</a></td> 292</tr> 293<tr class="odd"> 294<td style="text-align: left;">ITSbuilder</td> 295<td style="text-align: center;">V1.0.0 <span class="icon-st-add"></span></td> 296<td style="text-align: center;"><a href="Utilities/PC_Software/ITSbuilder/Release_Notes.html">release notes</a></td> 297</tr> 298<tr class="even"> 299<td style="text-align: left;">Certificates</td> 300<td style="text-align: center;">V1.1.0 <span class="icon-st-add"></span></td> 301<td style="text-align: center;"><a href="Utilities/Certificates/Release_Notes.html">release notes</a></td> 302</tr> 303<tr class="odd"> 304<td style="text-align: left;">ROT_AppliConfig</td> 305<td style="text-align: center;">V1.0.3 <span class="icon-st-update"></span></td> 306<td style="text-align: center;"><a href="Utilities/PC_Software/ROT_AppliConfig/Release_Notes.html">release notes</a></td> 307</tr> 308<tr class="even"> 309<td style="text-align: left;">HASH_HAL_Migrator</td> 310<td style="text-align: center;">V1.0.0</td> 311<td style="text-align: center;"><a href="Utilities/PC_Software/HASH_HAL_Migrator/Release_Notes.html">release notes</a></td> 312</tr> 313</tbody> 314</table> 315<h2 id="development-toolchains-and-compilers">Development Toolchains and Compilers</h2> 316<ul> 317<li>IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1 + ST-LINK, patch available here: 318<ul> 319<li><a href="Utilities\PC_Software\IDEs_Patches\EWARM\EWARMv8_STM32H5xx_V1.0.zip">Utilities\PC_Software\IDEs_Patches\EWARM\EWARMv8_STM32H5xx_V1.0.zip</a></li> 320<li>This patch supports <strong>STM32H573/STM32H563/STM32H562/STM32H503</strong> devices</li> 321</ul></li> 322<li>RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.37 + ST-LINK, patch available here: 323<ul> 324<li><a href="Utilities\PC_Software\IDEs_Patches\MDK-ARM\Keil.STM32H5xx_DFP.1.0.0.zip">Utilities\PC_Software\IDEs_Patches\MDK-ARM\Keil.STM32H5xx_DFP.1.0.0.zip</a></li> 325<li>This patch supports <strong>STM32H573/STM32H563/STM32H562/STM32H503</strong> devices</li> 326</ul></li> 327<li>STM32CubeIDE V1.13.0 (GCC11)</li> 328</ul> 329<h2 id="supported-devices-and-boards">Supported Devices and boards</h2> 330<ul> 331<li>Devices: 332<ul> 333<li>STM32H573xx/STM32H563xx/STM32H562xx revX</li> 334<li>STM32H503xx revX</li> 335</ul></li> 336<li>Boards: 337<ul> 338<li>NUCLEO-H563ZI REV B</li> 339<li>NUCLEO-H503RB REV B</li> 340<li>STM32H573I-DK REV C</li> 341</ul></li> 342</ul> 343<h2 id="dependencies">Dependencies</h2> 344<ul> 345<li>STM32CubeMX V6.9.0 346<ul> 347<li>Projects (Examples and Applications) are generated using STM32CubeMX version V6.9.0</li> 348</ul></li> 349<li>The SMAK Non-Secure application requires the installation of Secure Manager Package (<a href="https://www.st.com/content/st_com/en/ecosystems/stm32trust.html">X-CUBE-SEC-M-H5</a>) delivered outside this package.</li> 350<li>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.</li> 351</ul> 352<h2 id="known-limitations">Known Limitations</h2> 353<ul> 354<li>Some project are not generated with STM32CubeMX tool for the exhaustive list please refer to this table <a href="Projects/STM32CubeProjectsList.html">STM32CubeProjectsList.html</a></li> 355<li>The SMAK application rely on postbuild commands based on .bat scripts. Such postbuild .bat scripts are not compatible with host environments different than Windows.</li> 356<li>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”</li> 357<li>The component “USBX/CoreSystem” must be selected alongside either “USBX/UX Host CoreStack” or “USBX/UX Device CoreStack”</li> 358<li>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</li> 359<li>The following projects are not supported with MDK-ARM toolchain: 360<ul> 361<li>STM32H573I-DK/Demonstration</li> 362<li>NUCLEO-H563ZI/Examples/I3C/I3C_Controller_IBI_Wakeup_IT</li> 363<li>NUCLEO-H563ZI/Examples/I3C/I3C_Target_IBI_Wakeup_IT</li> 364<li>NUCLEO-H563ZI/Examples/I3C/I3C_Controller_Direct_Command_DMA</li> 365<li>NUCLEO-H563ZI/Examples/I3C/I3C_Target_Direct_Command_DMA</li> 366<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_IT</li> 367<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_IT</li> 368<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_Polling</li> 369<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_Polling</li> 370<li>NUCLEO-H503RB/Examples/I3C/I3C_Sensor_Direct_Command_DMA</li> 371<li>NUCLEO-H503RB/Examples/I3C/I3C_Sensor_Private_Command_IT<br /> 372</li> 373<li>STM32H573I-DK/Examples/DCACHE/DCACHE_Maintenance</li> 374<li>NUCLEO-H563ZI/Examples/I2C/I2C_TwoBoards_RestartAdvComIT</li> 375<li>NUCLEO-H563ZI/Examples/DMA/DMA_LinkedList</li> 376<li>NUCLEO-H563ZI/Examples/DAC/SimpleConversion</li> 377<li>NUCLEO-H563ZI/Examples_LL/I2C/I2C_OneBoard_AdvCommunication_DMAAndIT_Init</li> 378</ul></li> 379<li>The following projects are not supported with STM32CubeIDE toolchain (<strong>Debug and Release</strong>): 380<ul> 381<li>NUCLEO-H563ZI/Examples/I3C/I3C_Controller_IBI_Wakeup_IT</li> 382<li>NUCLEO-H563ZI/Examples/I3C/I3C_Target_IBI_Wakeup_IT</li> 383<li>STM32H573I-DK/Examples/DCACHE/DCACHE_Maintenance</li> 384</ul></li> 385<li>The following projects are not supported with STM32CubeIDE toolchain (<strong>Release</strong>): 386<ul> 387<li>STM32H573I-DK/Examples/OSPI/OSPI_NOR_ReadWrite_DMA_DTR</li> 388</ul></li> 389</ul> 390<h2 id="backward-compatibility">Backward Compatibility</h2> 391<ul> 392<li>No compatibility break</li> 393</ul> 394</div> 395</div> 396<div class="collapse"> 397<input type="checkbox" id="collapse-section2" aria-hidden="true"> <label for="collapse-section2" checked aria-hidden="true"><strong>V1.0.1 / 31-March-2023</strong></label> 398<div> 399<h2 id="main-changes-1">Main Changes</h2> 400<ul> 401<li>Patch release of <span style="font-weight: bold;">STM32CubeH5</span> Firmware Package</li> 402<li>Fix DA obk provisioning failure when TZ disabled on NUCLEO-H563ZI board</li> 403</ul> 404<h2 id="contents-1">Contents</h2> 405<p>The same contents as for V1.0.0 except modifications done on the following files to fix above issue:</p> 406<ul> 407<li>NUCLEO-H563ZI/ROT_Provisioning/DA/Binary/DA_ConfigWithPassword.obk</li> 408<li>NUCLEO-H563ZI/ROT_Provisioning/DA/Binary/DA_ConfigWithPassword.xml</li> 409</ul> 410</div> 411</div> 412<div class="collapse"> 413<input type="checkbox" id="collapse-section1" aria-hidden="true"> <label for="collapse-section1" checked aria-hidden="true"><strong>V1.0.0 / 10-February-2023</strong></label> 414<div> 415<h2 id="main-changes-2">Main Changes</h2> 416<ul> 417<li>First Official Release of <span style="font-weight: bold;">STM32CubeH5</span> Firmware Package</li> 418</ul> 419<h2 id="contents-2">Contents</h2> 420<h3 id="features-1"><strong>Features</strong></h3> 421<p>STM32CubeH5 gathers in one single package all the generic embedded software components required to develop an application on STM32H5 microcontrollers.</p> 422<ul> 423<li>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)</li> 424<li>CMSIS CORE, DSP and RTOS software components</li> 425<li>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).</li> 426<li>Up to 290 examples and applications for easy understanding, all compatible with STM32CubeMX to facilitate the configuration through a graphical tool</li> 427</ul> 428<p>STM32H5 devices support Arm® PSA security model.<br /> 429The 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.</p> 430<h3 id="projects-1"><strong>Projects</strong></h3> 431<p>The <strong>STM32CubeH5</strong> 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 <a href="Projects/STM32CubeProjectsList.html">STM32CubeProjectsList.html</a></p> 432<p>This release contains all HAL drivers and LL drivers, all templates, BSP drivers, advanced set of applications and examples.</p> 433<table> 434<thead> 435<tr class="header"> 436<th style="text-align: left;">Name</th> 437<th style="text-align: center;">Version</th> 438<th style="text-align: center;">Release notes</th> 439</tr> 440</thead> 441<tbody> 442<tr class="odd"> 443<td style="text-align: left;">Projects</td> 444<td style="text-align: center;">V1.0.0</td> 445<td style="text-align: center;"><a href="Projects/Release_Notes.html">release notes</a></td> 446</tr> 447</tbody> 448</table> 449<p><strong>Notes</strong></p> 450<ul> 451<li><p>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.</p></li> 452<li><p>This firmware package contains examples that run only on the STM32H573I-DK which will be available in June 2023.</p></li> 453</ul> 454<h3 id="components-1"><strong>Components</strong></h3> 455<table> 456<caption><strong>Drivers</strong></caption> 457<thead> 458<tr class="header"> 459<th style="text-align: left;">Name</th> 460<th style="text-align: center;">Version</th> 461<th style="text-align: center;">Release note</th> 462</tr> 463</thead> 464<tbody> 465<tr class="odd"> 466<td style="text-align: left;">CMSIS</td> 467<td style="text-align: center;">V5.6.0_cm33</td> 468<td style="text-align: center;"><a href="Drivers/CMSIS/docs/General/html/index.html">release notes</a></td> 469</tr> 470<tr class="even"> 471<td style="text-align: left;">STM32H5xx CMSIS</td> 472<td style="text-align: center;">V1.0.0</td> 473<td style="text-align: center;"><a href="Drivers/CMSIS/Device/ST/STM32H5xx/Release_Notes.html">release notes</a></td> 474</tr> 475<tr class="odd"> 476<td style="text-align: left;">STM32H5xx HAL</td> 477<td style="text-align: center;">V1.0.0</td> 478<td style="text-align: center;"><a href="Drivers/STM32H5xx_HAL_Driver/Release_Notes.html">release notes</a></td> 479</tr> 480<tr class="even"> 481<td style="text-align: left;">BSP STM32H5xx NUCLEO</td> 482<td style="text-align: center;">V1.0.0</td> 483<td style="text-align: center;"><a href="Drivers/BSP/STM32H5xx_Nucleo/Release_Notes.html">release notes</a></td> 484</tr> 485<tr class="odd"> 486<td style="text-align: left;">BSP STM32H573I-DK</td> 487<td style="text-align: center;">V1.0.0</td> 488<td style="text-align: center;"><a href="Drivers/BSP/STM32H573I-DK/Release_Notes.html">release notes</a></td> 489</tr> 490<tr class="even"> 491<td style="text-align: left;">BSP Common</td> 492<td style="text-align: center;">V7.2.1</td> 493<td style="text-align: center;"><a href="Drivers/BSP/Components/Common/Release_Notes.html">release notes</a></td> 494</tr> 495<tr class="odd"> 496<td style="text-align: left;">BSP lan8742</td> 497<td style="text-align: center;">V1.0.2</td> 498<td style="text-align: center;"><a href="Drivers/BSP/Components/lan8742/Release_Notes.html">release notes</a></td> 499</tr> 500<tr class="even"> 501<td style="text-align: left;">BSP cs42l51</td> 502<td style="text-align: center;">V2.0.5</td> 503<td style="text-align: center;"><a href="Drivers/BSP/Components/cs42l51/Release_Notes.html">release notes</a></td> 504</tr> 505<tr class="odd"> 506<td style="text-align: left;">BSP mx25lm51245g</td> 507<td style="text-align: center;">V3.0.2</td> 508<td style="text-align: center;"><a href="Drivers/BSP/Components/mx25lm51245g/Release_Notes.html">release notes</a></td> 509</tr> 510<tr class="even"> 511<td style="text-align: left;">BSP ft6x06</td> 512<td style="text-align: center;">V2.0.3</td> 513<td style="text-align: center;"><a href="Drivers/BSP/Components/ft6x06/Release_Notes.html">release notes</a></td> 514</tr> 515<tr class="odd"> 516<td style="text-align: left;">BSP st7789h2</td> 517<td style="text-align: center;">V2.0.4</td> 518<td style="text-align: center;"><a href="Drivers/BSP/Components/st7789h2/Release_Notes.html">release notes</a></td> 519</tr> 520<tr class="even"> 521<td style="text-align: left;">BSP tcpp0203</td> 522<td style="text-align: center;">V1.2.3</td> 523<td style="text-align: center;"><a href="Drivers/BSP/Components/tcpp0203/Release_Notes.html">release notes</a></td> 524</tr> 525<tr class="odd"> 526<td style="text-align: left;">BSP mx_wifi</td> 527<td style="text-align: center;">V2.3.4</td> 528<td style="text-align: center;"><a href="Drivers/BSP/Components/mx_wifi/Release_Notes.html">release notes</a></td> 529</tr> 530</tbody> 531</table> 532<table> 533<caption><strong>Middlewares</strong></caption> 534<thead> 535<tr class="header"> 536<th style="text-align: left;">Name</th> 537<th style="text-align: center;">Version</th> 538<th style="text-align: center;">Release note</th> 539</tr> 540</thead> 541<tbody> 542<tr class="odd"> 543<td style="text-align: left;">STM32 USBPD Core Library</td> 544<td style="text-align: center;">V4.1.1</td> 545<td style="text-align: center;"><a href="Middlewares/ST/STM32_USBPD_Library/Core/Release_Notes.html">release notes</a></td> 546</tr> 547<tr class="even"> 548<td style="text-align: left;">STM32 USBPD Device Library</td> 549<td style="text-align: center;">h5_v1.1.1</td> 550<td style="text-align: center;"><a href="Middlewares/ST/STM32_USBPD_Library/Devices/STM32H5XX/Release_Notes.html">release notes</a></td> 551</tr> 552<tr class="odd"> 553<td style="text-align: left;">secure_manager_api</td> 554<td style="text-align: center;">V1.0.0</td> 555<td style="text-align: center;"><a href="Middlewares/ST/secure_manager_api/Release_Notes.html">release notes</a></td> 556</tr> 557<tr class="even"> 558<td style="text-align: left;">mbed-crypto</td> 559<td style="text-align: center;">mbed-crypto-2.25.0</td> 560<td style="text-align: center;"><a href="Middlewares/Third_Party/mbed-crypto/st_readme.txt">ST release notes</a></td> 561</tr> 562<tr class="odd"> 563<td style="text-align: left;">mcuboot</td> 564<td style="text-align: center;">V1.7.2.11</td> 565<td style="text-align: center;"><a href="Middlewares/Third_Party/mcuboot/st_readme.txt">ST release notes</a></td> 566</tr> 567<tr class="even"> 568<td style="text-align: left;">trustedfirmware</td> 569<td style="text-align: center;">tfm/v1.3.0-bl2.6</td> 570<td style="text-align: center;"><a href="Middlewares/Third_Party/trustedfirmware/st_readme.txt">ST release notes</a></td> 571</tr> 572<tr class="odd"> 573<td style="text-align: left;">OpenBootloader</td> 574<td style="text-align: center;">V6.1.1</td> 575<td style="text-align: center;"><a href="Middlewares/ST/OpenBootloader/Release_Notes.html">release notes</a></td> 576</tr> 577<tr class="even"> 578<td style="text-align: left;">ThreadX</td> 579<td style="text-align: center;">threadx-6.2.0.221223</td> 580<td style="text-align: center;"><a href="https://github.com/azure-rtos/threadx/releases/tag/v6.2.0_rel">release notes</a></td> 581</tr> 582<tr class="odd"> 583<td style="text-align: left;">NetXduo</td> 584<td style="text-align: center;">netxduo-6.2.0.221223</td> 585<td style="text-align: center;"><a href="https://github.com/azure-rtos/netxduo/releases/tag/v6.2.0_rel">release notes</a></td> 586</tr> 587<tr class="even"> 588<td style="text-align: left;">USBX</td> 589<td style="text-align: center;">usbx-6.2.0.221223</td> 590<td style="text-align: center;"><a href="https://github.com/azure-rtos/usbx/releases/tag/v6.2.0_rel">release notes</a></td> 591</tr> 592<tr class="odd"> 593<td style="text-align: left;">FileX</td> 594<td style="text-align: center;">filex-6.2.0.221223</td> 595<td style="text-align: center;"><a href="https://github.com/azure-rtos/filex/releases/tag/v6.2.0_rel">release notes</a></td> 596</tr> 597<tr class="even"> 598<td style="text-align: left;">LevelX</td> 599<td style="text-align: center;">levelx-6.2.0.221223</td> 600<td style="text-align: center;"><a href="https://github.com/azure-rtos/levelx/releases/tag/v6.2.0_rel">release notes</a></td> 601</tr> 602</tbody> 603</table> 604<table> 605<caption><strong>Utilities</strong></caption> 606<thead> 607<tr class="header"> 608<th style="text-align: left;">Name</th> 609<th style="text-align: center;">Version</th> 610<th style="text-align: center;">Release note</th> 611</tr> 612</thead> 613<tbody> 614<tr class="odd"> 615<td style="text-align: left;">Common</td> 616<td style="text-align: center;">V1.6.1</td> 617<td style="text-align: center;"><a href="Utilities/Common/Release_Notes.html">release notes</a></td> 618</tr> 619<tr class="even"> 620<td style="text-align: left;">Fonts</td> 621<td style="text-align: center;">V2.0.3</td> 622<td style="text-align: center;"><a href="Utilities/Fonts/Release_Notes.html">release notes</a></td> 623</tr> 624<tr class="odd"> 625<td style="text-align: left;">CPU</td> 626<td style="text-align: center;">V1.1.3</td> 627<td style="text-align: center;"><a href="Utilities/CPU/Release_Notes.html">release notes</a></td> 628</tr> 629<tr class="even"> 630<td style="text-align: left;">lcd</td> 631<td style="text-align: center;">V2.0.2</td> 632<td style="text-align: center;"><a href="Utilities/lcd/Release_Notes.html">release notes</a></td> 633</tr> 634<tr class="odd"> 635<td style="text-align: left;">GUI_INTERFACE</td> 636<td style="text-align: center;">GUI_V2.2.1</td> 637<td style="text-align: center;"><a href="Utilities/GUI_INTERFACE/Release_Notes.html">release notes</a></td> 638</tr> 639<tr class="even"> 640<td style="text-align: left;">TRACER_EMB</td> 641<td style="text-align: center;">V1.7.1</td> 642<td style="text-align: center;"><a href="Utilities/TRACER_EMB/Release_Notes.html">release notes</a></td> 643</tr> 644<tr class="odd"> 645<td style="text-align: left;">ROT_AppliConfig</td> 646<td style="text-align: center;">V1.0.0</td> 647<td style="text-align: center;"><a href="Utilities/PC_Software/ROT_AppliConfig/Release_Notes.html">release notes</a></td> 648</tr> 649<tr class="even"> 650<td style="text-align: left;">HASH_HAL_Migrator</td> 651<td style="text-align: center;">V1.0.0</td> 652<td style="text-align: center;"><a href="Utilities/PC_Software/HASH_HAL_Migrator/Release_Notes.html">release notes</a></td> 653</tr> 654</tbody> 655</table> 656<h2 id="development-toolchains-and-compilers-1">Development Toolchains and Compilers</h2> 657<ul> 658<li>IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1 + ST-LINK, patch available here: 659<ul> 660<li><a href="Utilities\PC_Software\IDEs_Patches\EWARM\EWARMv8_STM32H5xx_V1.0.zip">Utilities\PC_Software\IDEs_Patches\EWARM\EWARMv8_STM32H5xx_V1.0.zip</a></li> 661<li>This patch supports <strong>STM32H573/STM32H563/STM32H562/STM32H503</strong> devices</li> 662</ul></li> 663<li>RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.37 + ST-LINK, patch available here: 664<ul> 665<li><a href="Utilities\PC_Software\IDEs_Patches\MDK-ARM\Keil.STM32H5xx_DFP.1.0.0.zip">Utilities\PC_Software\IDEs_Patches\MDK-ARM\Keil.STM32H5xx_DFP.1.0.0.zip</a></li> 666<li>This patch supports <strong>STM32H573/STM32H563/STM32H562/STM32H503</strong> devices</li> 667</ul></li> 668<li>STM32CubeIDE V1.12.0 (GCC11)</li> 669</ul> 670<h2 id="supported-devices-and-boards-1">Supported Devices and boards</h2> 671<ul> 672<li>Devices: 673<ul> 674<li>STM32H573xx/STM32H563xx/STM32H562xx revZ</li> 675<li>STM32H503xx revZ</li> 676</ul></li> 677<li>Boards: 678<ul> 679<li>NUCLEO-H563ZI REV B</li> 680<li>NUCLEO-H503RB REV B</li> 681<li>STM32H573I-DK REV C</li> 682</ul></li> 683</ul> 684<h2 id="dependencies-1">Dependencies</h2> 685<ul> 686<li>STM32CubeMX V6.8.0 687<ul> 688<li>Projects (Examples and Applications) are generated using STM32CubeMX version V6.8.0.</li> 689</ul></li> 690<li>The SMAK Non-Secure application requires the installation of Secure Manager Package (<a href="https://www.st.com/content/st_com/en/ecosystems/stm32trust.html">X-CUBE-SEC-M-H5</a>) delivered outside this package.</li> 691<li>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.</li> 692</ul> 693<h2 id="known-limitations-1">Known Limitations</h2> 694<ul> 695<li>Some project are not generated with STM32CubeMX tool for the exhaustive list please refer to this table <a href="Projects/STM32CubeProjectsList.html">STM32CubeProjectsList.html</a></li> 696<li>The ROT applications rely on postbuild commands based on .bat scripts. Such postbuild .bat scripts are not compatible with host environments different than Windows.</li> 697<li>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”</li> 698<li>The following projects are not supported with MDK-ARM toolchain: 699<ul> 700<li>ROT applications and ROT Templates on all boards</li> 701<li>STM32H573I-DK/Demonstration</li> 702<li>STM32H573I-DK/Applications/USBPD/SRC</li> 703<li>STM32H573I-DK/Applications/USBPD/SRC_UX_Host_MSC</li> 704<li>STM32H573I-DK/Examples/GTZC/GTZC_MPCWM_IllegalAccess_TrustZone<br /> 705</li> 706<li>NUCLEO-H563ZI/Applications/USBPD/SNK</li> 707<li>NUCLEO-H563ZI/Applications/USBPD/SNK_UX_Device_HID</li> 708<li>NUCLEO-H563ZI/Examples/I2C/I2C_TwoBoards_RestartAdvComIT</li> 709<li>NUCLEO-H563ZI/Examples/DAC/DAC_SimpleConversion</li> 710<li>NUCLEO-H563ZI/Examples/DMA/DMA_LinkedList<br /> 711</li> 712<li>NUCLEO-H563ZI/Examples/FLASH/FLASH_SwapBanks<br /> 713</li> 714<li>NUCLEO-H563ZI/Examples_HAL/I3C/I3C_Controller_Direct_Command_DMA</li> 715<li>NUCLEO-H563ZI/Examples_HAL/I3C/I3C_Target_Direct_Command_DMA</li> 716<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_IT</li> 717<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_IT</li> 718<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Controller_Direct_Command_Polling</li> 719<li>NUCLEO-H503RB/Examples_LL/I3C/I3C_Target_Direct_Command_Polling</li> 720</ul></li> 721<li>The following projects are not supported with STM32CubeIDE toolchain (<strong>Debug and Release</strong>): 722<ul> 723<li>STM32H573I-DK/Demonstration</li> 724<li>STM32H573I-DK/Applications/ROT/OEMiROT_Boot</li> 725<li>STM32H573I-DK/Applications/ROT/OEMiROT_Appli_TrustZone</li> 726<li>STM32H573I-DK/Applications/ROT/STiROT_Appli</li> 727<li>STM32H573I-DK/Applications/ROT/STiROT_Appli_TrustZone</li> 728<li>STM32H573I-DK/Applications/USBPD/SRC</li> 729<li>STM32H573I-DK/Applications/USBPD/SRC_UX_Host_MSC<br /> 730</li> 731<li>STM32H573I-DK/Examples/GTZC/GTZC_MPCWM_IllegalAccess_TrustZone</li> 732<li>NUCLEO-H563ZI/Applications/USBPD/SNK</li> 733<li>NUCLEO-H563ZI/Applications/USBPD/SNK_UX_Device_HID</li> 734<li>NUCLEO-H563ZI/Examples/FLASH/FLASH_SwapBanks</li> 735</ul></li> 736<li>The following projects are not supported with STM32CubeIDE toolchain (<strong>Release</strong>): 737<ul> 738<li>STM32H573I-DK/Examples/BSP</li> 739<li>STM32H573I-DK/Examples/OSPI/OSPI_NOR_ReadWrite_DMA_DTR</li> 740</ul></li> 741</ul> 742<h2 id="backward-compatibility-1">Backward Compatibility</h2> 743<ul> 744<li>Not applicable</li> 745</ul> 746</div> 747</div> 748</div> 749</div> 750<footer class="sticky"> 751<p>For complete documentation on STM32 Microcontrollers </mark> , visit: <span style="font-color: blue;"><a href="http://www.st.com/stm32">www.st.com/stm32</a></span></p> 752</footer> 753</body> 754</html> 755