Last edited 3 weeks ago

STM32CubeMP15 Package release note


This article aims to describe the content of the software release included in the STM32CubeMP15 Package / STM32CubeMP1 Package (a.k.a., STM32CubeMP15 firmware / STM32CubeMP1 firmware), version v1.7.0.

1. Delivery purpose and scope

The STM32CubeMP15 Package is a software package running on Arm® Cortex®-M4 processors and is a fundamental part of the STM32MPU Embedded Software distribution.

This release includes:

  • The STM32Cube HAL: STM32 abstraction layer embedded software ensuring maximized portability across the STM32 portfolio. HAL APIs are available for all peripherals.
  • Low-layer APIs (LL APIs) offering a fast lightweight expert-oriented layer that is closer to the hardware than the HAL.
    LL APIs are only available for a limited set of peripherals.
  • A consistent set of middleware components such as FreeRTOSTM and OpenAMP.
  • All embedded software utilities delivered with a full set of examples.

It also includes:

  • BSP for the STM32MP157x-EV1 Evaluation board More info green.png and the STM32MP157x-DK2 Discovery kit More info green.png (button and LEDs only)
  • Multi-core components
  • OpenAMP
  • ResourceManager
  • CoproSync
  • Projects: several projects ( examples, applications and demonstration firmware) are implemented in different IDEs.
  • STM32CubeIDE IDE delivered by ST
  • All the STM32MP157x-DK2 More info green.png and STM32MP157x-EV1 More info green.png projects are available on STM32CubeIDE.
  • EWARM (version 10.60.3 and later)
  • Most of the STM32MP157x-DK2 More info green.png projects are ported on EWARM.
  • MDK-ARM (Pack Keil®.STM32MP1xx_DFP.1.1.0.pack + MDK-ARM v5.40 with C-Compiler 6.22 and later)
  • Most of the STM32MP157x-DK2 More info green.png projects are ported on MDK-ARM.
  • System Workbench for STM32 toolchain (SW4STM32): now deprecated
  • This IDE is no longer supported by STMicroelectronics, the reference is now STM32CubeIDE.
  • All the SW4STM32 projects are removed from this release but these projects were already ported on STM32CubeIDE.

2. Intended Audience

The targeted audience is STM32 MPU customers and partners.

3. Licensing

All licenses applicable to STM32CubeMP1 package are available here.

4. Supported devices

The drivers provided within this package support all STM32MP15x lines More info.png.

5. Supported hardware

The software examples and the drivers delivered in this package are applicable for the following boards:

  • STM32MP157C-EV1 Evaluation board Warning.png and can be easily adapted to any STM32MP157x-EV1 Evaluation board More info green.png, for information about those boards, read the article STM32MP157x-EV1 - hardware description.
  • STM32MP157C-DK2 Discovery kit Warning.png and can be easily adapted to any STM32MP157x-DK2 Discovery kit More info green.png, for information about those boards, read the article STM32MP157x-DKx - hardware description.

6. Release content

6.1. Main changes

6.1.1. HAL, LL and BSP drivers

  • General updates to fix known defects and enhancements implementation.
  • HAL Generic (No API change)
    • Fixed wrong definition of SYSCFG ANA0/ANA1 PA0/PA1 switches open/close.
    • Add interrupt enable line of TIM6_handle
    • Fixed SysTick has a wrong behavior when STGEN is switched to HSE
  • ADC (No API change)
    • Rename ADC register bits:
      • OSR to OSVR,
      • LT1, LT2, LT3 to LTR1, LTR2, LTR3,
      • HT1, HT2, HT3 to HTR1, HTR2, HTR3,
      • VSENSEEN to TSEN,
  • DMA (No API Change)
    • Added STM32MP1 UART + DMA missing interrupts,
  • I2C (No API change)
    • Fixed I2C_WaitOnTXISFlagUntilTimeout() busy wait
  • TIM (No API Change)
    • HAL : add new function HAL_TIM_DMABurst_MultiWrite/ReadStart
    • LL : Fix counter mode tests

6.1.2. CMSIS

  • Update bit definition in header files:
    • ADC : Add missing registers & Update bitfield names
    • DMA : Fix missing interrupts used in UART
  • Fixes in startup and linker files
    • Added default clock values in system files
    • Linker files aligned with GCC12
    • Fixed declaration of g_pfnVectors size in gcc/startup files

6.1.3. Middleware

  • OPENAMP
    • New version for Libmetal : ST modified _20241213
  • Free RTOS
    • New version 10.6.2 - Supporting RTOS V2 and CVE fixes.

6.1.4. Projects

  • Applications
    • Update project relying on OpenAMP 2021.10
    • OpenAMP_TTY_echo & OpenAMP_for_signed_fw examples
      • fix HSEM timeout on BSP_LED_Init
      • OpenAMP_FreeRTOS_echo updated with Free RTOS v10.6.2
    • FreeRTOS_ThreadCreation updated with Free RTOS v10.6.2
  • All Projects
    • GCC version update for all examples, applications and templates - GCC12.3.rel1 (STM32CubeIDE 1.17.0 version and further versions)
    • MDK-ARM version update for all examples, applications and templates - v5.40 with C-Compiler 6.22
    • IAR version update for all examples, applications and templates - v9.60.3

6.2. Released components

6.2.1. Drivers

Component Version Notes
Cortex-M CMSIS V5.6.0 -
STM32MP1xx CMSIS V1.7.0 -
STM32MP1xx HAL V1.7.0 -
BSP STM32MP15xx_EVAL V1.7.0 -
BSP STM32MP15xx_DISCO V1.7.0 -

Find here the list of available HAL , LL and BSP drivers.


6.2.2. Middleware

Component Version Notes
FreeRTOSTM V10.6.2 -
OpenAMP v2021.10 ST modified 20241213 -

6.2.3. Utilities

Component Version Notes
Resourcemanager V1.11.0 -

6.3. Released projects

The STM32CubeMP15 Package comes with a rich set of examples running on STMicroelectronics boards, organized by board and provided with preconfigured projects. The main supported development environment is STM32CubeIDE (works on Multiple OS's) and uses the GNU toolchain.

  • Most of the STM32MP157x-DK2 More info green.png projects are available with 3 IDEs ( STM32CubeIDE, IARTM, KEIL®)
  • All STM32MP157x-EV1 More info green.png projects are available with STM32CubeIDE.

IDE ready projects:

STM32MP157x-DK2 STM32MP157x-EV1
Number of projects 29 38

Find in this article STM32CubeMP15_Package#Projects, the exhaustive list of available projects for STM32MP157x-EV1 Evaluation board More info green.png and STM32MP157x-DK2 Discovery kit More info green.png:

The recommended supported toolchain for STM32MP15 is now STM32CubeIDE (All-in-one multi-OS development tool).
Moreover, other toolchains are compliant with STM32CubeMP15 Package:

  • IARTM Embedded Workbench for ARM® (EWARM) toolchain
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain

7. Restrictions

OpenAMP compilation issue with MDK-ARM when the code is generated through the STM32CubeMX:

  • To avoid compilation errors in OpenAMP when compiling in MDK-ARM IDE, disable the « Use MicroLIB » in « Target » tab.

8. Minor release updates

STMicroelectronics regularly delivers corrections through github® components. The corrections can be incorporated them into your developer package or distribution package.

Refer to STM32MPU Developer Package or How to switch to github® mode in Distribution Package.

9. How to get started with STM32CubeMP15 Package

Refer to How to get software and start with this release article.

10. Associated tools

List of associated tools is available in the STM32 MPU ecosystem release note.

11. References



12. Archives Archive box.png

STM32MP15 release Release note
STM32MP15-Ecosystem-v5.1.0 STM32CubeMP1_Package_release_note_-_v1.6.0 page for the v5 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v5.0.0 STM32CubeMP1_Package_release_note_-_v1.6.0 page for the v5 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v4.1.0 STM32CubeMP1_Package_release_note_-_v1.6.0 page for the v4 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v4.0.0 STM32CubeMP1_Package_release_note_-_v1.6.0 page for the v4 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v3.1.0 STM32CubeMP1_Package_release_note_-_v1.5.0 page for the v3 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v3.0.0 STM32CubeMP1_Package_release_note_-_v1.4.0 page for the v3 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v2.1.0 STM32CubeMP1_Package_release_note_-_v1.3.0 page for the v2 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v2.0.0 STM32CubeMP1_Package_release_note_-_v1.2.0 page for the v2 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v1.2.0 STM32CubeMP1_Package_release_note_-_v1.2.0 page for the v1 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v1.1.0 STM32CubeMP1_Package_release_note_-_v1.1.0 page for the v1 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v1.0.0 STM32CubeMP1_Package_release_note_-_v1.0.0 page for the v1 ecosystem releases (in archived wiki)