Difference between revisions of "STM32 MPU ecosystem release note - v4.0.0"

[quality revision] [quality revision]
m
m (OpenSTLinux (Cortex®-A7))

This article describes the content of STM32MP1-ecosystem-v4.0.0 release of STM32MPU Embedded Software distribution and its associated ecosystem.

1 Delivery purpose and scope[edit]

The STM32MP1-ecosystem-v4.0.0 release is dedicated to the STM32MP1 Series[1]. It is a major release based on new community components version: Yocto LTS Kirkstone 4.0, Kernel 5.15 LTS, U-Boot v2021.10, TF-A v2.6, OP-TEE v3.16 and OpenAMP 2021.10.

This STM32MP1-ecosystem-v4.0.0 release aims at:

  • providing a full ecosystem for the STM32MP1 Series[1] devices
  • working efficiently with STM32 MPU boards, using one of the packages (Starter Package, Developer Package or Distribution Package) provided by STMicroelectronics: refer to Which Package better suits your needs for more information.

This ecosystem release consists of:

  • STM32CubeIDE
  • STM32CubeMX
  • STM32CubeProgrammer
  • STM32DDRFW-UTIL
  • STM32PROGFW-UTIL
  • Keygen tool
  • Signing tool
  • hosted at the non-browsable URL http://packages.openstlinux.st.com
  • enabled by default in the Starter Package
  • providing regularly updated or additional packages
  • Documentation
  • the present user guide in Wiki format
  • the documentation package (for more details refer to Reference documents chapter below)
  • STM32MP1 boards support
  • STM32MP15 Evaluation boards
  • STM32MP15 Discovery kits
  • STM32MP13 Discovery kits
More details are provided in the Board chapter below.

2 Intended audience[edit]

The targeted audience is STM32 MPU customers and partners.

3 Licensing[edit]

This software package is licensed under a SOFTWARE LICENSE AGREEMENT FOR ST MATERIALS (SLA). Customers should only use this package in compliance with the software license agreement (SLA).

4 Main features / main highlights[edit]

4.1 Boards[edit]

This STM32MP1-ecosystem-v4.0.0 release supports the same boards as previous STM32MP15-ecosystem-v3.1.0 ones, plus STM32MP13 upcoming one.

Boards PCBs list Content Availability
STM32MP157C-EV1 board (board with crypto)
  • MB1263C (daughter)
  • MB1262C (mother)
  • MB1230C (display)
  • MB1379A (camera)
  • STM32MP1 STM32MP157CAA3 Rev.B
  • PMIC STPMIC1APQR cut1.2
  • External oscillator
Jan 2019
STM32MP157A-EV1 board (board without crypto)
  • MB1263C (daughter)
  • MB1262C (mother)
  • MB1230C (display)
  • MB1379A (camera)
  • STM32MP1 STM32MP157AAA3 Rev.B
  • PMIC STPMIC1APQR cut1.2
  • External oscillator
Jan 2019
STM32MP157F-EV1 board (board with crypto ; CPU at 800 MHz)
  • MB1263C (daughter)
  • MB1262C (mother)
  • MB1230C (display)
  • MB1379A (camera)
  • STM32MP1 STM32MP157FAA3 Rev.Z
  • PMIC STPMIC1APQR cut2.0
  • External oscillator
Jun 2020
STM32MP157D-EV1 board (board without crypto ; CPU at 800MHz)
  • MB1263C (daughter)
  • MB1262C (mother)
  • MB1230C (display)
  • MB1379A (camera)
  • STM32MP1 STM32MP157DAA3 Rev.Z
  • PMIC STPMIC1APQR cut2.0
  • External oscillator
Nov 2020
STM32MP157C-DK2 board (board with crypto)
  • MB1272C (mother)
  • MB1407B (display)
  • STM32MP1 STM32MP157CAC3 Rev.B
  • PMIC STPMIC1APQR cut1.2
  • External oscillator
Jan 2019
STM32MP157F-DK2 board (board with Crypto ; CPU at 800MHz)
  • MB1272C (mother)
  • MB1407B (display)
  • STM32MP1 STM32MP157FAC3 Rev.Z
  • PMIC STPMIC1APQR cut2.0
  • External oscillator
Nov 2020
STM32MP157A-DK1 board (board without Crypto)
  • MB1272C (Mother)
  • STM32MP1 STM32MP157AAC3 Rev.B
  • PMIC STPMIC1APQR cut1.2
  • External oscillator
Jan 2019
STM32MP157D-DK1 board (board without Crypto ; CPU at 800MHz)
  • MB1272C (mother)
  • STM32MP1 STM32MP157DAC3 Rev.Z
  • PMIC STPMIC1APQR cut2.0
  • External oscillator
Nov 2020


Info white.png Information
STLINK in EVAL and DISCO Rev.C boards integrates the latest firmware STLINK (V2J32M22) which requires upgraded USB PC drivers - Windows USB driver

4.2 Embedded software[edit]

4.2.1 OpenSTLinux (Cortex®-A7)[edit]

openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15 is the new version delivered with the STM32MP1-ecosystem-v4.0.0 release. This software set consists of the following components:

  • Build process
    • OpenEmbedded LTS Kirkstone(v4.0.1) - NEW
    • GCC version v11.2 - NEW
  • Software components
    • Kernel version LTS v5.15.24 - NEW
    • TF-A version v2.6 - NEW
    • U-Boot version v2021.10 - NEW
    • OP-TEE version v3.16.0 - NEW
    • OpenOCD version v0.11.0
  • Applicative components
    • Weston version v10.0.0 - NEW
    • Wayland version 1.20.0 - NEW
    • GStreamer version v1.20.1 - NEW
    • GCnano version v6.4.7 - NEW
  • Main NEW features of the STM32MP1-ecosystem-v4.0.0 release
    • OP-TEE by default (updated driver model based on DT)
    • New OTP structure exchange between U-Boot / cube Programmer
    • ADC calibration in U-Boot
    • Firmware (FIP) A/B Update (TF-A BL2 only: Firmware Update (FWU) support
    • STM32MP15x lines More info.png updates
      • STM32MP15-EVAL boards: LCD Rocktech RK055MHD042A0-CTG support
    • STM32MP13x lines Warning.png support


Info white.png Information
Basic boot has been removed since STM32MP15-ecosystem-v2.0.0, if using basic boot with U-BOOT-SPL to load U-BOOT and the Kernel, use now the ST reference boot scheme replacing U-BOOT-SPL by TF-A as FSBL as explained in Boot chain overview.
Info white.png Information
At boot time, STM32MP15x lines More info.png internal peripherals are assigned according to one of the following kernel configurations:
  • Configuration 1: all internal peripherals are assigned to the Cortex-A7 for Linux drivers. The Cortex-M4 coprocessing TTY firmware is executed by default.
  • Configuration 2: some internal peripherals are assigned to the Cortex-M4 to execute the delivered examples (on EVAL or DISCO board) see (How to run Cortex-M4 examples).

Configuration 1 is activated by default if "2" is not specified in the U-Boot console. More information is available in the How to assign an internal peripheral to a runtime context article.

4.2.2 Buildroot (Cortex®-A7)[edit]

Under construction.png Delivery for this build system is being prepared

4.2.3 STM32DDRFW-UTIL (Cortex®-A7)[edit]

STM32DDRFW-UTIL-v1.0.0 version - NEW utilities firmware STM32DDRFW-UTIL provides utilities for DDR

  • Functionalities are available in command-line and in STM32CubeMX DDR Tool
  • Features
    • Read/Write DDR registers and DDR info
    • Launch DDR tests

4.2.4 STM32PROGFW-UTIL (Cortex®-A7)[edit]

STM32PROGFW-UTIL-v1.0.0 version - NEW utilities firmware STM32PROGFW-UTIL provides multiple applications to manage the One-time Programmable (OTP) memories.

  • Functionalities are available through 4 applications
  • STM32CubeProgrammer based application
  • Standalone STM32CubeIDE based application
  • 2 other applications for development purpose
    • UART configuration for the Standalone application
    • Run mode for STM32CubeProgrammer application
  • Features
    • STM32CubeProgrammer based application (in Serial boot mode)
      • OTP v2 structure
      • STM32CubeProgrammer UART interface and USB DFU
    • OTP Console based application (in Dev boot mode)
      • OTP CLI implemented based on STM32CubeProgrammer OTP CLI with OTP v2 structure
      • UART and STM32CubeIDE Semihosting interface

4.2.5 STM32CubeMP1 (Cortex®-M4)[edit]

STM32CubeMP1-v1.6.0 version - NEW version versus STM32MP1-ecosystem-v4.0.0 release

Main NEW features of STM32CubeMP1-v1.6.0, delivered within STM32MP1-ecosystem-v4.0.0 release

  • General updates to fix known defects and enhancements implementation for HAL, LL, CMSIS, BSP
    • HAL Generic
      • Implement HAL_GetUIDw{0,1,2} (New API)
      • Add ALIGN_32BYTES definitions
    • SPI
      • Alignment with other STM32 families (No API Change)
    • TIM
      • LL : ONEPULSEMODE defines description are inverted
      • LL : COUNTERMODE defines are inverted for TIM_CR1_CMS
    • EXTI (No API change):
      • Fix some MISRA warnings
      • Optimize Get Config API
    • SMBUS:
      • Alignment with other STM32 families
      • SMBUS Extended files support (API Change)
  • CortexM - CMSIS:
    • New version V5.6.0
  • OPENAMP:
    • New version V2021.10
  • PROJECTS:
    • Examples:
      • Implement new examples for STM32MP15 EVAL Board :
        • Implement ADC_MultiChannelSingleConversion example,
        • Implement ADC AnalogWatchdog example,
        • Implement ADC Oversampler example,
        • Implement LPTIM_PWM_LSE example,
        • Implement TIM_OnePulse example,
        • Implement TIM_PWMOutput example,
        • Implement TIM_Synchronization example,
        • Implement TIM_TimeBase example,
      • Update LPTIM_PulseCounter example (add low power mode)
    • Applications:
      • Update project relying on OpenAMP 2021.10
      • OpenAMP_TTY_echo_wakeup example:
        • Implement the firmware shutdown to force the stop of ADC and DMA
      • Fix include declaration with gcc++ in openamp
      • Implement OpenAMP_for_signed_fw project

4.3 STM32CubeProgrammer, Signing tool, Keygen[edit]

STM32CubeProgrammer v2.11.0 is the new version compatible within the STM32MP1-ecosystem-v4.0.0 release.

Main NEW features of STM32CubeProgrammer-v2.11.0, delivered with STM32MP1-ecosystem-v4.0.0 release

  • Download command verifies all binaries are available before launching the programming.
  • Same version (v2.11) for signing Tool, Key generator, Trusted Package Creator and STM32CubeProgrammer.
  • Support PKCS#11 in Signing tool.


Features already available in previous STM32CubeProgrammer-v2.9.0 version

  • STM32CubeProg installer including STM32CubeProgrammer, Keygen and Signing tools.
  • Flash programming of SD Card, eMMC, NAND, NOR images through USB and UART for STM32MP157C-EV1, STM32MP157A-EV1, STM32MP157A-DK1, STM32MP157C-DK2 boards.
  • Private and public key generation.
  • Image signatures.
  • Flashlayout file format change.
  • STM32MP1 fuse management (with console interface only).
  • PMIC NVM management (with console interface only).
  • SSP (secure secrets provisioning) UI..
Warning white.png Warning
OpenSTLinux generates flashlayout.tsv files only for USB programming mode.
For UART usage, refer to Using_STM32Programmer_over_UART article to modify those files.

4.4 STM32CubeMX[edit]

STM32CubeMX-v6.6.0 is the new version compatible with STM32MP1-ecosystem-v4.0.0 release.

Main NEW features of STM32CubeMX-v6.6.0, delivered with the STM32MP1-ecosystem-v4.0.0 release

  • Device tree (Cortex-A7)
    • New database based on openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15
  • STM32CubeMP1 1.6.0 (Cortex-M4)
    • OpenAMP-2021.10 support

Features already available in previous version

  • Ubuntu 20.04 support
  • I/O muxing and clock tree configuration
  • STM32MP1 contexts management (A7 non-secure, A7 secure, M4)
  • STM32CubeMP1 code generation
  • Tuning of DDR settings
  • Device tree code generation
    • dtsi and header file inclusions
    • pinctrl and clock generation
    • System-on-chip device node positioning
    • multi-core related configurations (ETZPC binding, resources manager binding, peripheral assignment).
    • DMA config generation - DMA nodes
Info white.png Information
Note: The other device tree parameters must be filled manually in user section tags (from /* USER CODE BEGIN <node> */ to /* USER CODE END <node> */)

New features

  • add search feature to ease selectors filters findings
  • LL header file, of the selected IPS, must be copied in the generated project
  • Remove U-Boot SPL generation
  • OpenSTLinux : consider dropping SP_MIN and focus on OP-TEE
  • Device Tree Generation - remove secure-status in TF-A


4.5 STM32CubeIDE[edit]

STM32CubeIDE-v1.10.0 is the new version compatible with STM32MP1-ecosystem-v4.0.0 release

Main NEW features of STM32CubeIDE v1.10.0, delivered with the STM32MP1-ecosystem-v4.0.0 release

  • Bootloaders target update support (TF-A, U-boot, OP-TEE)

Features already available in previous version

  • Ubuntu 20.04 support
  • Application and libraries userland Cortex-A7 support based on OpenSTLinux Developer Package and Yocto SDK.
  • Cortex-M4 STM32CubeMP1 in "Production mode" and "Engineering mode"
  • Cortex-M4 Firmware compilation, loading and debugging
  • PC Linux with ethernet (recommended) or serial link
  • PC Windows with ethernet or ethernet over USB link
  • Cortex-M4 Firmware installation directory configurable.
  • OpenSTLinux Developer Package support with
    • TF-A component project compilation with native dt selected or external dt (for example, generated from CubeMX)
    • U-BOOT component project compilation with native dt selected or external dt (for example, generated from CubeMX)
    • OP-TEE component project compilation with native dt selected or external dt (for example, generated from CubeMX)
    • KERNEL component project compilation with native dt selected or external dt (for example, generated from CubeMX)
    • KERNEL component project artefacts update on running target
    • For more information refer to How to manage OpenSTLinux projects in STM32CubeIDE article

New features

  • Installation of Yocto SDK
  • Installation of OpenSTLinux projects Sources

4.6 Miscellaneous[edit]

Detailed features are available in the release notes of the different components that constitute this delivery.

See sections STM32MPU Embedded Software distribution detailed release notes, Referenced tools release notes and Reference documents

5 Main restrictions[edit]

5.1 Embedded software[edit]

5.1.1 OpenSTLinux (Cortex®-A7)[edit]

None

5.1.2 Buildroot (Cortex®-A7)[edit]

None

5.1.3 STM32CubeMP1 (Cortex®-M4)[edit]

  • 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.

5.2 STM32CubeProgrammer, Signing tool and Keygen[edit]

Key generation is functional with STM32MP_KeyGen_CLI on Linux from Ubuntu 18.04 and upper versions.

5.3 STM32CubeMX[edit]

When opening a previous project built with an older STM32CubeMX version, the migration does not take into account the user section part. This part needs to be updated manually according to the openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15 manifest.

5.4 STM32CubeIDE[edit]

5.5 Miscellaneous[edit]

Restriction lists are available in the sub-components release notes, which are available in the following chapters:

Moreover, the software workarounds implemented to provide solutions to the STM32MPU device errata are listed in STM32MP15 ecosystem errata sheet.

6 Minor release updates[edit]

STMicroelectronics regularly delivers updates through the following github® components: tf-a, u-boot, optee-os, Linux kernel.
Those components can be incorporated the Developer Package (refer to STM32MP1 Developer Package) or Distribution Package.

To update the Distribution Package, proceed as follows:

  1. Switch the Distribution package reference source code to github mode.
  2. Use the devtool modify <recipe name> command to access to the git source code repository used by the build process.
  3. In the freshly cloned source code, check out the required revision to start from via git checkout -b WORK <github® TAG>.

STMicroelectronics also delivers dedicated fixes on layers through github®. These changes can be integrated (via git commands: git checkout -b WORK <github® commit SHA1>) into the local STM32MP1 Distribution Package environment. The github® links corresponding to each layers in the following list:

7 Reference documents[edit]

All the resources for the STM32MP1 Series are located in the Resources area of the STM32MP1 Series web page.

The resources below are referenced in some of the articles of this user guide.

New.png means that the document (or its version) is new compared to what was delivered within the previous ecosystem release.

7.1 STM32 MPU's family documentation[edit]

7.2 STM32MP1 common resources[edit]

Reference Name Link Version
Application notes
AN2834 How to get the best ADC accuracy in STM32 microcontrollers AN2834.pdf v8.0
AN4803 High-speed SI simulations using IBIS and board-level simulations using HyperLynx® SI on STM32 MCUs and MPUs AN4803.pdf v2.0
AN5027 Interfacing PDM digital microphones using STM32 MCUs and MPUs AN5027.pdf v2.0
AN5036 Thermal management guidelines for STM32 applications AN5036.pdf v3.0
AN5109 STM32MP1 Series using low-power modes AN5109.pdf v4.0
AN5122 STM32MP1 Series DDR memory routing guidelines AN5122.pdf v3.0
AN5168 STM32MP1 series DDR configuration AN5168.pdf v2.0
AN5225 USB Type-C™ Power Delivery using STM32xx Series MCUs and STM32xxx Series MPUs AN5225.pdf New.png v6.0
AN5275 USB DFU/USART protocols used in STM32MP1 Series bootloaders AN5275.pdf New.png v3.0
AN5284 STM32MP1 series system power consumption AN5284.pdf v1.0
AN5348 FDCAN peripheral on STM32 devices AN5348.pdf v1.0
AN5475 Migration of applications from STM32MP15x lines to STM32MP13x lines microprocessor AN5475 v0.3
AN5431 The STPMIC1 PCB layout guidlines AN5431.pdf v1.0
AN5438 STM32MP1 Series lifetime estimates AN5438.pdf v1.0
AN5510 Overview of the secure secret provisioning (SSP) on STM32MP1 Series AN5510.pdf v1.0
AN5692 STM32MP1 Series DDR memory routing guidelines AN5692 v0.2
Datasheets
DS12792 STPMIC1 datasheet
DS12792.pdf New.png v10.0
Tools user manuals
UM2563 STM32CubeIDE installation guide UM2563.pdf New.png v4.0
UM2579 Migration guide from System Workbench to STM32CubeIDE UM2579.pdf v1.0
UM2553 STM32CubeIDE quick start guide UM2553.pdf v3.0
AN5360 Getting started with projects based on the STM32MP1 Series in STM32CubeIDE AN5360.pdf v1.0
UM2609 STM32CubeIDE user guide UM2609.pdf v5.0
UM1718 STM32CubeMX user manual UM1718.pdf New.png v37.0
UM2237 STM32CubeProgrammer tool user manual UM2237.pdf New.png v18.0
UM2238 STM32 Trusted Package Creator tool user manual UM2238.pdf New.png v8.0
UM2542 STM32 Series Key Generator tool user manual UM2542.pdf v2.0
UM2543 STM32 Series Signing tool user manual UM2543.pdf v2.0


7.3 STM32MP13 resources[edit]


Info white.png Information
The different STM32MP13 microprocessor part numbers available (with their corresponding internal peripherals, security options and packages) are described in the STM32MP13 microprocessor part numbers.
Warning white.png Warning
STM32MP13 documentation is available only for customers part of STM32MP13 ALPHA program. Access to teamspace private area is required.


Reference Name Link Version
Application notes
AN5474 Getting started with STM32MP13 Series hardware development AN5474 v0.8
AN5565 STM32MP13 lines using low-power modes AN5565 v0.6
AN5587 STM32MP13 lines and STPMIC1D integration on a wall adapter supply AN5587 v0.4
AN5827 STM32MP13 lines Return Material Analysis (RMA) state AN5827 v0.1
Datasheets[2]
DS13483 STM32MP135C/F Datasheet (STM32MP135C/F)
(secure)
DS13483 v0.6
DS13874 STM32MP135A/D Datasheet (STM32MP135A/D)
(non secure)
DS13874 v0.3
DS13875 STM32MP133C/F Datasheet (STM32MP133C/F)
(secure)
DS13875 v0.3
DS13876 STM32MP133A/D Datasheet (STM32MP133A/D)
(non secure)
DS13876 v0.3
DS13877 STM32MP131C/F Datasheet (STM32MP131C/F)
(secure)
DS13877 v0.3
DS13878 STM32MP131A/D Datasheet (STM32MP131A/D)
(non secure)
DS13878 v0.3
Errata sheets
ES0539 STM32MP13x device errata [1] v0.4
Reference manuals[2]
RM0475 STM32MP13x reference manual
(STM32MP135 advanced Arm®-based 32-bit MPUs)
[2] v0.5
Boards schematics
MB1635 schematics STM32MP135F-DK motherboard schematics
MB1635-B03 board schematics (Discovery kit)
[3] vB03
MB1723 schematics Camera daughterboard schematics
MB1723-D01 board schematics (Discovery kit)
[4] vD01
Boards user guides
UGDKMP13 STM32MP135x-DK Discovery kit user guide [5] v0.4


7.4 STM32MP15 resources[edit]

Info white.png Information
The different STM32MP15 microprocessor part numbers available (with their corresponding internal peripherals, security options and packages) are described in the STM32MP15 microprocessor part numbers.

New.png means that the document (or its version) is new compared to what was delivered within the previous ecosystem release.


Reference Name Link Version
Application notes
AN5031 Getting started with STM32MP15 Series hardware development AN5031.pdf New.png v4.0
AN5253 Migration of microcontroller applications from STM32F4x9 lines to STM32MP151, STM32MP153 and STM32MP157 lines microprocessor AN5253.pdf v1.0
AN5256 STM32MP151, STM32MP153 and STM32MP157 discrete power supply hardware integration AN5256.pdf v2.0
AN5260 STM32MP151/153/157 MPU lines and STPMIC1B integration on a battery powered application AN5260.pdf v2.0
Datasheets[3]
DS12505 STM32MP157C/F datasheet
(secure)
DS12505.pdf New.png v7.0
DS12504 STM32MP157A/D datasheet
(basic)
DS12504.pdf New.png v7.0
DS12503 STM32MP153C/F datasheet
(secure)
DS12503.pdf New.png v7.0
DS12502 STM32MP153A/D datasheet
(basic)
DS12502.pdf New.png v7.0
DS12501 STM32MP151C/F datasheet
(secure)
DS12501.pdf New.png v7.0
DS12500 STM32MP151A/D datasheet
(basic)
DS12500.pdf New.png v7.0
Errata sheets
ES0438 STM32MP15xx device errata ES0438.pdf v7.0
Reference manuals[3]
RM0436 STM32MP157 reference manual
(STM32MP157xxx advanced Arm®-based 32-bit MPUs)
RM0436.pdf v6.0
RM0442 STM32MP153 reference manual
(STM32MP153xxx advanced Arm®-based 32-bit MPUs)
RM0442.pdf v6.0
RM0441 STM32MP151 reference manual
(STM32MP151xxx advanced Arm®-based 32-bit MPUs)
RM0441.pdf v6.0
Boards schematics
MB1262 schematics STM32MP157C-EV1 motherboard schematics
MB1262-C01 board schematic (Evaluation board)
MB1262-C01.pdf v1.0
MB1263 schematics STM32MP157F-EV1 daughterboard schematics
MB1263-C04 board schematic (Evaluation board)
MB1263-C04.pdf v4.0
MB1230 schematics DSI 720p LCD display daughterboard schematics
MB1230-C board schematic (Evaluation board)
MB1230-C.pdf v1.1
MB1379 schematics Camera daughterboard schematics
MB1379-A01 board schematic (Evaluation board)
MB1379-A01.pdf v1.0
MB1272 schematics STM32MP157x-DKx motherboard schematics
MB1272-DK2-C01 board schematic (Discovery kit)
MB1272-C01.pdf v1.0
MB1407 schematics STM32MP157x-DKx daughterboard schematics
MB1407-LCD-C01 board schematic (Discovery kit)
MB1407-C01.pdf v1.0
Boards user manuals
UM2535 STM32MP157x-EV1 evaluation board user manual UM2535.pdf v2.0
UM2534 STM32MP157x-DKx discovery board user manual UM2534.pdf v1.0


8 How to download the software and start with this release?[edit]

The list of embedded software packages available for download depends on the selected packages.

The table below provides the available board part numbers as well as information in order to:

  • get started with one of the three available Packages (Starter, Developer or Distribution Package)
  • get started with the board
  • find the associated embedded software distributions
  • download source code
  • build a piece of embedded software.
Board part number Jump to
STM32MP157x-EV1
Evaluation board
STM32MP15 Evaluation boards - getting started, including software download
STM32MP157x-DKx
Discovery kit
STM32MP15 Discovery kits - getting started, including software download
STM32MP135x-DK
Discovery kit
STM32MP13 Discovery kits - getting started, including software download

9 STM32MPU Embedded Software distribution detailed release notes[edit]

The table below lists the software packages available in the STM32MPU Embedded Software distributions, and provides the corresponding release notes.
The release notes give more information and details about the features and content of the packages.
They do not explain how to download the software. Refer to How to get the software and start with this release.

Firmware Release note Version
OpenSTLinux Distribution STM32 MPU OpenSTLinux release note - v4.0.0 openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15
Buildroot Distribution
Under construction.png Coming soon
Previous version compatible with STM32MPU ecosystem V3 flow can be found here STM32MP15 Buildroot release note - v3.1.0
openstlinux-5.10-buildroot-2021.02-mp1-21-11-17
STM32Cube MPU Package STM32CubeMP1 Package release note - v1.6.0 STM32CubeMP1-v1.6.0

10 Referenced tools release notes[edit]

The table below lists the available tools, and provides links to the corresponding release notes.

Each release note gives information on how to install and use the corresponding tool.

The set of tools that can be downloaded depends on the package that is used (double check Which Package better suits your needs article for more information on each package).

Tools Release notes Host PC Which Package may need the tool ?
Linux version Windows version Starter Package Developer Package Distribution Package
STM32CubeIDE STM32CubeIDE_release_note 1.10.0 1.10.0
STM32CubeMX STM32CubeMX release note 6.6.0 6.6.0
STM32CubeProg STM32CubeProgrammer release note 2.11.0 2.11.0
Keygen KeyGen release note 2.11.0 2.11.0
Signing tool Signing tool release note 2.11.0 2.11.0
STM32DDRFW-UTIL STM32DDRFW-UTIL release note 1.0.0 1.0.0
STM32PROGFW-UTIL 1.0.0 1.0.0

11 References[edit]

  1. 1.01.1 The STM32MP1 Series includes the STM32MP13x lines Warning.png and the STM32MP15x lines More info.png
  2. 2.02.1 The part numbers are specified in STM32MP13 microprocessor part numbers
  3. 3.03.1 The part numbers are specified in STM32MP15 microprocessor part numbers


This article describes the content of '''''STM32MP1-ecosystem-v4.0.0''''' release of ''STM32MPU Embedded Software distribution'' and its associated ecosystem.

==Delivery purpose and scope==
The STM32MP1-ecosystem-v4.0.0 release is dedicated to the {{MicroprocessorDevice | device=1}}<ref name="stm32mp1">The {{MicroprocessorDevice | device=1}} includes the {{MicroprocessorDevice | device=13}} and the {{MicroprocessorDevice | device=15}}</ref>. It is a major release based on new community components version: Yocto LTS Kirkstone 4.0, Kernel 5.15 LTS, U-Boot v2021.10, TF-A v2.6, OP-TEE v3.16 and OpenAMP 2021.10.

This STM32MP1-ecosystem-v4.0.0 release aims at:
* providing a full ecosystem for the {{MicroprocessorDevice | device=1}}<ref name="stm32mp1" /> devices
* working efficiently with STM32 MPU boards, using one of the packages (Starter Package, Developer Package or Distribution Package) provided by STMicroelectronics: refer to [[Which Package better suits your needs]] for more information.

This ecosystem release consists of:
* STM32 MPU Embedded Software distribution
* STM32 referenced tools (more details are provided in the [[#Referenced tools release notes |Referenced tools release notes]] chapter below):
:*STM32CubeIDE 
:*STM32CubeMX
:*STM32CubeProgrammer
:*STM32DDRFW-UTIL
:*STM32PROGFW-UTIL
:*Keygen tool
:*Signing tool
* the [[Package_repository_for_OpenSTLinux_distribution|Package Repository Service]]
:* hosted at the non-browsable URL <nowiki>http://packages.openstlinux.st.com</nowiki> 

:* enabled by default in the Starter Package
:* providing regularly updated or additional packages
* Documentation
:* the present user guide in Wiki format 
:* the documentation package (for more details refer to [[#Reference_documents|Reference documents]] chapter below)
* STM32MP1 boards support
:*STM32MP15 Evaluation boards
:*STM32MP15 Discovery kits
:*STM32MP13 Discovery kits
:More details are provided in the [[#Boards|Board]] chapter below.

==Intended audience==
The targeted audience is STM32 MPU customers and partners.

==Licensing==
This software package is licensed under a SOFTWARE LICENSE AGREEMENT FOR ST MATERIALS (SLA). Customers should only use this package in compliance with the [[LegalInformation:OpenSTLinux licenses - v4.0.0#Top Software license agreement (SLA) and third-party licences|software license agreement (SLA)]].

==Main features / main highlights==
=== Boards ===
This STM32MP1-ecosystem-v4.0.0 release supports the same boards as previous STM32MP15-ecosystem-v3.1.0 ones, plus STM32MP13 upcoming one.

{|class="st_table"
!Boards !! PCBs list !! Content !! Availability
|-
| STM32MP157C-EV1 board (board with crypto) || 
*MB1263C (daughter)
*MB1262C (mother)
*MB1230C (display)
*MB1379A (camera)
|| 
*STM32MP1 STM32MP157CAA3 Rev.B
*PMIC STPMIC1APQR cut1.2
* External oscillator
||Jan 2019  
|-
| STM32MP157A-EV1 board (board without crypto) || 
*MB1263C (daughter)
*MB1262C (mother)
*MB1230C (display)
*MB1379A (camera)
|| 
*STM32MP1 STM32MP157AAA3 Rev.B
*PMIC STPMIC1APQR cut1.2
* External oscillator
||Jan 2019  
|-
| STM32MP157F-EV1 board (board with crypto ; CPU at 800 MHz) || 
*MB1263C (daughter)
*MB1262C (mother)
*MB1230C (display)
*MB1379A (camera)
|| 
*STM32MP1 STM32MP157FAA3 Rev.Z
*PMIC STPMIC1APQR cut2.0
* External oscillator
||Jun 2020
|-
| STM32MP157D-EV1 board (board without crypto ; CPU at 800MHz) || 
*MB1263C (daughter)
*MB1262C (mother)
*MB1230C (display)
*MB1379A (camera)
|| 
*STM32MP1 STM32MP157DAA3 Rev.Z
*PMIC STPMIC1APQR cut2.0
* External oscillator
||Nov 2020
|-
| STM32MP157C-DK2 board (board with crypto) || 
*MB1272C (mother)
*MB1407B (display)
||
*STM32MP1 STM32MP157CAC3 Rev.B
*PMIC STPMIC1APQR cut1.2
*External oscillator
 ||Jan 2019 
|-
| STM32MP157F-DK2 board (board with Crypto ; CPU at 800MHz) || 
*MB1272C (mother)
*MB1407B (display)
||
*STM32MP1 STM32MP157FAC3 Rev.Z
*PMIC STPMIC1APQR cut2.0
*External oscillator
 ||Nov 2020
|-
| STM32MP157A-DK1 board (board without Crypto) || 
*MB1272C (Mother)
||
*STM32MP1 STM32MP157AAC3 Rev.B
*PMIC STPMIC1APQR cut1.2
*External oscillator
 ||Jan 2019 
|-
| STM32MP157D-DK1 board (board without Crypto ; CPU at 800MHz) || 
*MB1272C (mother)
||
*STM32MP1 STM32MP157DAC3 Rev.Z
*PMIC STPMIC1APQR cut2.0
*External oscillator
 ||Nov 2020
|}

{{Info|STLINK in EVAL and DISCO Rev.C boards integrates the latest firmware STLINK (V2J32M22) which requires upgraded USB PC drivers - [https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-utilities/stsw-link009.html Windows USB driver]}}

=== Embedded software ===
==== OpenSTLinux (Cortex<sup>&reg;</sup>-A7)  ====
'''{{EcosystemRelease/Package | revision=4.0.0 | package=OpenSTLinux distribution | request=name}}''' is the new version delivered with the STM32MP1-ecosystem-v4.0.0 release. This software set consists of the following components:
*Build process
**OpenEmbedded LTS Kirkstone(v4.0.1) {{STDarkBlue|''''' - NEW''''' }}
**GCC version v11.2 {{STDarkBlue|''''' - NEW''''' }}
*Software components
** Kernel version LTS v5.15.24 {{STDarkBlue|''''' - NEW''''' }}
**TF-A version v2.6 {{STDarkBlue|''''' - NEW''''' }}
**U-Boot version v2021.10 {{STDarkBlue|''''' - NEW''''' }}
**OP-TEE version v3.16.0 {{STDarkBlue|''''' - NEW''''' }}
**OpenOCD version v0.11.0
* Applicative components
** Weston version v10.0.0 {{STDarkBlue|''''' - NEW''''' }}
**Wayland version 1.20.0 {{STDarkBlue|''''' - NEW''''' }}
** GStreamer version v1.20.1  {{STDarkBlue|''''' - NEW''''' }}
** GCnano version v6.4.7 {{STDarkBlue|''''' - NEW''''' }}

*'''Main {{STDarkBlue|NEW}} features of the STM32MP1-ecosystem-v4.0.0 release'''
**OP-TEE by default (updated driver model based on DT)
**New OTP structure exchange between U-Boot / cube Programmer
**ADC calibration in U-Boot
**Firmware (FIP) A/B Update (TF-A BL2 only)TF-A BL2: Firmware Update (FWU) support**{{MicroprocessorDevice | device=15}} updates
***STM32MP15-EVAL boards: LCD Rocktech RK055MHD042A0-CTG support
**{{MicroprocessorDevice | device=13}} support
{{InternalInfo|
{{MicroprocessorDevice | device=13}}:
:*CPU @1GHZ
:*GalaxyCore camera support
:*MP13 board without crypto ( {{Board | type=135D-DK}})
:*EMMC HS200 
:*USB power delivery STM32G0
}}

{{Info| Basic boot has been removed since STM32MP15-ecosystem-v2.0.0, if using basic boot with U-BOOT-SPL to load U-BOOT and the Kernel, use now the ST reference boot scheme replacing U-BOOT-SPL by TF-A as FSBL as explained in [[Boot_chain_overview#STM32MP15_boot_chain|Boot chain overview]].}}

{{Info| At boot time, {{MicroprocessorDevice | device=15}} internal peripherals are assigned according to one of the following kernel configurations:
*Configuration 1: all internal peripherals are assigned to the Cortex-A7 for Linux drivers. The Cortex-M4 coprocessing TTY firmware is executed by default.
*Configuration 2: some internal peripherals are assigned to the Cortex-M4 to execute the delivered examples (on EVAL or DISCO board) see ([[STM32CubeMP1 Package#How to run the examples|How to run Cortex-M4 examples]]).
Configuration 1 is activated by default if "2" is not specified in the U-Boot console. More information is available in the [[How to assign an internal peripheral to a runtime context]] article.}}

==== Buildroot (Cortex<sup>&reg;</sup>-A7)  ====
{{UnderConstruction| Delivery for this build system is being prepared}}

==== STM32DDRFW-UTIL  (Cortex<sup>&reg;</sup>-A7)  ====
'''STM32DDRFW-UTIL-v1.0.0''' version {{STDarkBlue|''''' - NEW''''' utilities firmware}}
STM32DDRFW-UTIL provides utilities for DDR
*Functionalities are available in command-line and in STM32CubeMX DDR Tool
*Features
**Read/Write DDR registers and DDR info
**Launch DDR tests

==== STM32PROGFW-UTIL (Cortex<sup>&reg;</sup>-A7)  ====
'''STM32PROGFW-UTIL-v1.0.0''' version {{STDarkBlue|''''' - NEW''''' utilities firmware}}
STM32PROGFW-UTIL provides multiple applications to manage the One-time Programmable (OTP) memories.
*Functionalities are available through 4 applications
*STM32CubeProgrammer based application
*Standalone STM32CubeIDE based application
*2 other applications for development purpose
**UART configuration for the Standalone application
**Run mode for STM32CubeProgrammer application
*Features
**STM32CubeProgrammer based application (in Serial boot mode)
***OTP v2 structure
***STM32CubeProgrammer UART interface and USB DFU
**OTP Console based application (in Dev boot mode)
***OTP CLI implemented based on STM32CubeProgrammer OTP CLI with OTP v2 structure
***UART and STM32CubeIDE Semihosting interface

==== STM32CubeMP1 (Cortex<sup>&reg;</sup>-M4) ====
'''STM32CubeMP1-v1.6.0''' version {{STDarkBlue|''''' - NEW''''' version versus STM32MP1-ecosystem-v4.0.0 release}}

'''Main {{STDarkBlue|NEW}} features of STM32CubeMP1-v1.6.0, delivered within STM32MP1-ecosystem-v4.0.0 release '''
* General updates to fix known defects and enhancements implementation for HAL, LL, CMSIS, BSP
** '''HAL Generic'''
*** Implement HAL_GetUIDw{0,1,2} (New API)
*** Add ALIGN_32BYTES definitions
** '''SPI'''
*** Alignment with other STM32 families (No API Change)
** '''TIM'''
*** LL : ONEPULSEMODE defines description are inverted
*** LL : COUNTERMODE defines are inverted for TIM_CR1_CMS
** '''EXTI (No API change)''':
*** Fix some MISRA warnings
*** Optimize Get Config API
** '''SMBUS''':
*** Alignment with other STM32 families
*** SMBUS Extended files support (API Change)
* '''CortexM - CMSIS''':
** New version V5.6.0
* '''OPENAMP''':
** New version V2021.10
* '''PROJECTS''':
** '''Examples''':
***Implement new examples for STM32MP15 EVAL Board :
**** Implement ADC_MultiChannelSingleConversion example,
**** Implement ADC AnalogWatchdog example,
**** Implement ADC Oversampler example,
**** Implement LPTIM_PWM_LSE example,
**** Implement TIM_OnePulse example,
**** Implement TIM_PWMOutput example,
**** Implement TIM_Synchronization example,
**** Implement TIM_TimeBase example,
*** Update LPTIM_PulseCounter example (add low power mode)
** '''Applications''':
*** Update project relying on OpenAMP 2021.10
*** OpenAMP_TTY_echo_wakeup example: 
**** Implement the firmware shutdown to force the stop of ADC and DMA
*** Fix include declaration with gcc++ in openamp
*** Implement OpenAMP_for_signed_fw project

=== STM32CubeProgrammer, Signing tool, Keygen ===
'''STM32CubeProgrammer v2.11.0''' is the new version compatible within the STM32MP1-ecosystem-v4.0.0 release. 

'''Main {{STDarkBlue|NEW}} features of STM32CubeProgrammer-v2.11.0, delivered with STM32MP1-ecosystem-v4.0.0 release '''
* Download command verifies all binaries are available before launching the programming.
* Same version (v2.11) for signing Tool, Key generator, Trusted Package Creator and STM32CubeProgrammer.
* Support PKCS#11 in Signing tool.
{{ReviewsComments|-- [[User:Nathalie Sangouard|Nathalie Sangouard]] ([[User talk:Nathalie Sangouard|talk]]) 23:50, 27 June 2022 (CEST)<br />what is Trusted Package Creator  ?}}
{{ReviewsComments|-- [[User:Erwan Le Ray|Erwan Le Ray]] ([[User talk:Erwan Le Ray|talk]]) 23:50, 27 June 2022 (CEST)<br />comes from 3.1.0 RN}}
'''Features already available in previous STM32CubeProgrammer-v2.9.0 version'''
* STM32CubeProg installer including STM32CubeProgrammer, Keygen and Signing tools.
* Flash programming of SD Card, eMMC, NAND, NOR images through USB and UART for STM32MP157C-EV1, STM32MP157A-EV1, STM32MP157A-DK1, STM32MP157C-DK2 boards.
* Private and public key generation.
* Image signatures.
* Flashlayout file format change.
* STM32MP1 fuse management (with console interface only).
* PMIC NVM management (with console interface only).
* SSP (secure secrets provisioning) UI..

{{Warning |OpenSTLinux generates flashlayout.tsv files only for USB programming mode.<br>For UART usage, refer to [[STM32CubeProgrammer_flashlayout#Using_STM32Programmer_over_UART|Using_STM32Programmer_over_UART]] article to modify those files.}}

=== STM32CubeMX===
'''STM32CubeMX-v6.6.0''' is the new version compatible with STM32MP1-ecosystem-v4.0.0 release.

'''Main {{STDarkBlue|NEW}} features of STM32CubeMX-v6.6.0, delivered with the STM32MP1-ecosystem-v4.0.0 release 
* Device tree (Cortex-A7)
** New database based on {{EcosystemRelease/Package | revision=4.0.0 | package=OpenSTLinux distribution | request=name}}
* STM32CubeMP1 1.6.0 (Cortex-M4)
** OpenAMP-2021.10 support

'''Features already available in previous version'''
* Ubuntu 20.04 support
* I/O muxing and clock tree configuration
* STM32MP1 contexts management (A7 non-secure, A7 secure, M4)
* STM32CubeMP1 code generation
* Tuning of DDR settings
* Device tree code generation 
** dtsi and header file inclusions
** pinctrl and clock generation
** System-on-chip device node positioning
** multi-core related configurations (ETZPC binding, resources manager binding, peripheral assignment).
** DMA config generation - DMA nodes
{{Info|Note: The other device tree parameters must be filled manually in user section tags (from /* USER CODE BEGIN <node> */ to /* USER CODE END <node> */)}}

'''New features'''
* add search feature to ease selectors filters findings
* LL header file, of the selected IPS, must be copied in the generated project
* Remove U-Boot SPL generation
* OpenSTLinux : consider dropping SP_MIN and focus on OP-TEE
* Device Tree Generation - remove secure-status in TF-A
{{ReviewsComments|-- [[User:Gerald Baeza|Gerald Baeza]] ([[User talk:Gerald Baeza|talk]]) 10:20, 28 June 2022 (CEST)<br /> "consider dropping SP_MIN and focus on OP-TEE" is not clear : what is new ? we don't need to mention what we considered here, just what we did}}

=== STM32CubeIDE ===
'''STM32CubeIDE-v1.10.0''' is the new version compatible with STM32MP1-ecosystem-v4.0.0 release 

'''Main {{STDarkBlue|NEW}} features of STM32CubeIDE v1.10.0, delivered with the STM32MP1-ecosystem-v4.0.0 release 
* Bootloaders target update support (TF-A, U-boot, OP-TEE)

'''Features already available in previous version'''
* Ubuntu 20.04 support
* Application and libraries userland Cortex-A7 support based on OpenSTLinux Developer Package and Yocto SDK.
* Cortex-M4 STM32CubeMP1 in "Production mode" and "Engineering mode"
* Cortex-M4 Firmware compilation, loading and debugging
* PC Linux with ethernet (recommended) or serial link
* PC Windows with ethernet or ethernet over USB link
* Cortex-M4 Firmware installation directory configurable.
* OpenSTLinux Developer Package support with
** TF-A component project compilation with native dt selected or external dt (for example, generated from CubeMX)
** U-BOOT component project compilation with native dt selected or external dt (for example, generated from CubeMX)
** OP-TEE component project compilation with native dt selected or external dt (for example, generated from CubeMX)
** KERNEL component project compilation with native dt selected or external dt (for example, generated from CubeMX)
** KERNEL component project artefacts update on running target
** For more information refer to [[How to manage OpenSTLinux projects in STM32CubeIDE]] article

'''New features'''
* Installation of Yocto SDK
* Installation of OpenSTLinux projects Sources

=== Miscellaneous ===
Detailed features are available in the release notes of the different components that constitute this delivery.

See sections  [[#STM32MPU Embedded Software distribution detailed release notes|STM32MPU Embedded Software distribution detailed release notes]], [[#Referenced tools release notes | Referenced tools release notes ]] and [[#Reference documents|Reference documents]]

==Main restrictions==
=== Embedded software ===
==== OpenSTLinux (Cortex<sup>&reg;</sup>-A7)  ====
None

==== Buildroot (Cortex<sup>&reg;</sup>-A7)  ====
None

==== STM32CubeMP1 (Cortex<sup>&reg;</sup>-M4) ====
* OpenAMP compilation issue with MDK-ARM when the code is generated through the STM32CubeMx :<br>To avoid compilation errors in OpenAMP when compiling in MDK-ARM IDE, disable the « Use MicroLIB » in « Target » tab.

=== STM32CubeProgrammer, Signing tool and Keygen ===
Key generation is functional with STM32MP_KeyGen_CLI on Linux from Ubuntu 18.04 and upper versions.

=== STM32CubeMX===
When opening a previous project built with an older STM32CubeMX version, the migration does not take into account the user section part. This part needs to be updated manually according to the '''{{EcosystemRelease/Package | revision=4.0.0 | package=OpenSTLinux distribution | request=name}}''' manifest.

=== STM32CubeIDE ===

=== Miscellaneous ===
Restriction lists are available in the sub-components release notes, which are available in the following chapters:
* [[#STM32MPU Embedded Software distribution detailed release notes|STM32MPU Embedded Software distribution detailed release notes]]
* [[#Referenced tools release notes |Referenced tools release notes]]

Moreover, the software workarounds implemented to provide solutions to the STM32MPU device errata are listed in [[STM32MP15 ecosystem errata sheet]].

==Minor release updates ==
STMicroelectronics regularly delivers updates through the following github<sup>&reg;</sup> components:  [https://github.com/STMicroelectronics/arm-trusted-firmware tf-a], [https://github.com/STMicroelectronics/u-boot/ u-boot], [https://github.com/STMicroelectronics/optee_os optee-os],  [https://github.com/STMicroelectronics/linux Linux kernel]. <br>

Those components can be incorporated the Developer Package (refer to [[STM32MP1 Developer Package]]) or Distribution Package.<br/>


To update the Distribution Package, proceed as follows:
:# Switch the Distribution package [[OpenSTLinux_distribution#Reference_source_code|reference source code]] to github mode.
:# Use the ''' [[OpenEmbedded_-_devtool#devtool_modify|devtool modify]] <recipe name>''' command to access to the git source code repository used by the build process.
:# In the freshly cloned source code, check out the required revision to start from via '''git checkout  -b WORK {{HighlightParam|''<github<sup>&reg;</sup> TAG>''}}'''.

STMicroelectronics also delivers dedicated fixes on layers through github<sup>&reg;</sup>. These changes can be integrated (via [[git]] commands: '''git checkout  -b WORK {{HighlightParam|''<github<sup>&reg;</sup> commit SHA1>''}}''') into the local [[STM32MP1 Distribution Package]] environment. The github<sup>&reg;</sup> links corresponding to each layers in the following list:
* [https://github.com/STMicroelectronics/meta-st-stm32mp/ meta-st-stm32mp]
* [https://github.com/STMicroelectronics/meta-st-openstlinux/ meta-st-openstlinux ]
* [https://github.com/STMicroelectronics/meta-st-stm32mp-addons/ meta-st-stm32mp-addons]

==Reference documents==
All the resources for the  {{MicroprocessorDevice | device=1}} are located in the Resources area of the [https://www.st.com/content/st_com/en/products/microcontrollers/stm32-arm-cortex-mpus/stm32mp1-series.html  STM32MP1 Series web page].

The resources below are referenced in some of the articles of this user guide.

[[File:New.png|30px|link=]] means that the document (or its version) is new compared to what was delivered within the previous ecosystem release.

===STM32 MPU's family documentation===
===STM32MP1 common resources===
{{:STM32 MPU resources - v4.0.0}}
<div class="mw-collapsible mw-collapsed">

===STM32MP13 resources===<div class="mw-collapsible-content">

{{:STM32MP13 resources - v4.0.0}}</div>
</div>

===STM32MP15 resources===
{{:STM32MP15 resources - v4.0.0}}

== How to download the software and start with this release? ==
'''The list of embedded software packages available for download depends on the selected packages'''.

The table below provides the available board part numbers as well as information in order to:
*get started with one of the three available Packages (Starter, Developer or Distribution Package)
*get started with the board
*find the associated embedded software distributions 
*'''download''' source code 
*'''build''' a piece of embedded software. 
{| class="st-table"
|-'''Bold text'''
! style="width: 50%;" | Board part number
! style=" width:50%" | Jump to
|-style="text-align: center;"   
| '''STM32MP157x-EV1'''<br>Evaluation board
|| [[STM32MP15 Evaluation boards - getting started|STM32MP15 Evaluation boards - getting started, including software download]]
|-style="text-align: center;"   
| '''STM32MP157x-DKx'''<br>Discovery kit
|| [[STM32MP15 Discovery kits - getting started|STM32MP15 Discovery kits - getting started, including software download]]
|-style="text-align: center;"   
| '''STM32MP135x-DK'''<br>Discovery kit
|| [[STM32MP13 Discovery kits - getting started|STM32MP13 Discovery kits - getting started, including software download]]
|}

==STM32MPU Embedded Software distribution detailed release notes==
The table below lists the software packages available in the STM32MPU Embedded Software distributions, and provides the corresponding release notes.<br>

The release notes give more information and details about the features and content of the packages. <br>

They do not explain how to download the software. Refer to [[#How to get the software and start with this release?|How to get the software and start with this release]].

{|class="st-table" style="width: 98%;" 
|-
| | ''' Firmware ''' </font>

| ''' Release note''' </font>

|''' Version ''' </font>

|-
| | OpenSTLinux Distribution
| | [[STM32 MPU OpenSTLinux release note - v4.0.0]]
| | {{EcosystemRelease/Package | revision=4.0.0 | package=OpenSTLinux distribution | request=name}}
|-
| | Buildroot Distribution
| | {{UnderConstruction}} Previous version compatible with STM32MPU ecosystem V3 flow can be found here  [https://github.com/bootlin/buildroot-external-st/blob/st/2021.02/README.md STM32MP15 Buildroot release note - v3.1.0]
| | openstlinux-5.10-buildroot-2021.02-mp1-21-11-17
|-
| | STM32Cube MPU Package
| | [[STM32CubeMP1 Package release note - v1.6.0]]
| | STM32CubeMP1-v1.6.0
|}

==Referenced tools release notes ==
The table below lists the available tools, and provides links to the corresponding release notes.

Each release note gives information on how to install and use the corresponding tool.

The set of tools that can be downloaded depends on the package that is used (double check [[Which Package better suits your needs]] article for more information on each package).

{|class="st-table" style="text-align:center; width:95%; cellspacing=0"
|-
|| ''' Tools''' 
|| ''' Release notes'''
| colspan='2' | ''' Host PC''' 
| colspan='3' |'''Which Package may need the tool ?'''
|-
|| 
|| 
|| ''' Linux version '''
|| ''' Windows version ''' 
|| ''' Starter Package''' 
|| ''' Developer Package''' 
|| ''' Distribution Package''' 
|-
|| STM32CubeIDE
|| [[STM32CubeIDE_release_note]]
|| 1.10.0
|| 1.10.0
|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|-
|| STM32CubeMX
|| [https://www.st.com/en/development-tools/stm32cubemx.html STM32CubeMX release note] 
|| 6.6.0
|| 6.6.0
||<span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|-
||STM32CubeProg  
|| [[STM32CubeProgrammer release note]] 
|| 2.11.0
|| 2.11.0
|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

||<span style="font-size:21px"></span>

|-
||Keygen
||[[KeyGen release note]]
|| 2.11.0
|| 2.11.0
|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span> 

|-
|| Signing tool
||[[Signing tool release note]]
|| 2.11.0
|| 2.11.0
|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|-
|| STM32DDRFW-UTIL
||[[STM32DDRFW-UTIL release note]]
|| 1.0.0
|| 1.0.0
|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|-
|| STM32PROGFW-UTIL
||
|| 1.0.0
|| 1.0.0
|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|| <span style="font-size:21px"></span>

|}

==References==<references/>

<noinclude>

[[Category:Release notes archives]]
{{PublicationRequestId| 22120 | 2022-01-04| reviewed by Philip S on stm32mpu-v3-  (previous 19667  2021-04-20 AnneJ )}}</noinclude>
Line 148: Line 148:
 
**New OTP structure exchange between U-Boot / cube Programmer
 
**New OTP structure exchange between U-Boot / cube Programmer
 
**ADC calibration in U-Boot
 
**ADC calibration in U-Boot
**Firmware (FIP) A/B Update (TF-A BL2 only)
+
**TF-A BL2: Firmware Update (FWU) support
 
**{{MicroprocessorDevice | device=15}} updates
 
**{{MicroprocessorDevice | device=15}} updates
 
***STM32MP15-EVAL boards: LCD Rocktech RK055MHD042A0-CTG support
 
***STM32MP15-EVAL boards: LCD Rocktech RK055MHD042A0-CTG support