- Last edited 13 days ago
STM32MP15 ecosystem release note
The objective of this article is to describe the content of STM32MP15-ecosystem-v2.0.0 release of STM32MPU Embedded Software distributions and its associated ecosystem.
- 1 Delivery purpose and scope
- 2 Delivery important note
- 3 Intended audience
- 4 Licensing
- 5 Main features / main highlights
- 6 Main restrictions
- 7 Minor release updates
- 8 Reference documents
- 9 How to download the software and start with this release?
- 10 STM32MPU Embedded Software distribution detailed release notes
- 11 Referenced tools release notes
- 12 References
- 13 Archives
1 Delivery purpose and scope
The new STM32MP15-ecosystem-v2.0.0 release is dedicated to STM32MP15 microprocessors. It is an evolutive maintenance release based on new communities components version (Yocto LTS Dunfell, Kernel 5.4 LTS, U-BOOT v2020-01, TF-A 2.2, OP-TEE 3.9).
As previous release, STM32MP15-Ecosystem-v2.0.0 aims at
- providing a full ecosystem for STM32MP15x devices
- working efficiently with STM32MP15 boards, using one of the packages (Starter Package, Developer Package or Distribution Package) developed by STMicroelectronics for STM32 MPUs.
Refer to Which Package better suits your needs for more information on these packages.
This ecosystem release consists of:
- the STM32MPU Embedded Software distribution
- STM32 referenced tools (will be delivered on the 26th of July 2020, see Delivery important note)
- Keygen tool
- Signing tool
- For more details refer to Referenced tools release notes chapter below.
- The present user guide in wiki format
- Documentation package (for more details refer to Reference documents chapter below)
- Supported STM32MP15 boards
- STM32MP15 Evaluation board ( for "STM32MPU Embedded Software distribution" and "STM32MPU Embedded Software distribution for Android")
- STM32MP15 Discovery kit (for STM32MPU Embedded Software distribution)
- More details can be found in Board chapter below.
2 Delivery important note
3 Intended audience
The targeted audience is STMicroelectronics customers.
This software package is licensed under a SOFTWARE LICENSE AGREEMENT FOR ST MATERIALS (SLA). The customers may not use this package except in compliance with the software license agreement (SLA).
5 Main features / main highlights
This STM32MP15-ecosystem-v2.0.0 release supports the same boards as STM32MP15-ecosystem-v1.0.0 + 1 new board STM32MP157F-EV1.
|STM32MP157C-EV1 board (board with Crypto)||
|STM32MP157A-EV1 board (board without Crypto)||
|NEW STM32MP157F-EV1 board (board with Crypto and MP15 at 800MHz)||
|STM32MP157C-DK2 board (board with Crypto)||
|STM32MP157A-DK1 board (board without Crypto)||
|STLINK in EVAL and DISCO Rev.C boards integrates the latest firmware STLINK (V2J32M22) which requires upgraded USB PC drivers - Windows USB driver|
5.2 Embedded software
5.2.1 OpenSTLinux (Cortex®-A7)
Openstlinux-5.4-dunfell-mp1-20-06-24 is the new version delivered with STM32MP15-ecosystem-v2.0.0 release. This software set consists of the following components:
- Build process
- OpenEmbedded LTS Dunfell (v3.1) - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- GCC version v9.3 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- Software components
- Kernel version LTS v5.4.x - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- TF-A version v2.2 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- U-Boot version v2020.01 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- OP-TEE version v3.9.0 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- OpenOCD version v0.10.0-r9 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- Applicative components
- Weston version v8.0.0 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- GStreamer version v1.16.2 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- GCnano version v6.4.1 - NEW version versus STM32MP15-ecosystem-v1.2.0 release
- Main NEW features coming with STM32MP15-ecosystem-v2.0.0 release
- Added support for new 800 MHz Boards STM32MP157F-EV1
- SCMI - SCMI support for clocks and resets
- The system control and management interface (SCMI) is an OS independent interface proposed by ARM implemented in the secure monitor (TF-A sp_min or OP-TEE) and called by the application (U-Boot, Linux) for clock and reset management. It allows a centralized control of those system resources, with filtering possibilities.
- Support DVFS 800 MHz - 400 MHz
- Operating points DT management wiki article - refer to How_to_change_the_CPU_frequency article
- SNAND - Full SPI Nand support including boot and flash
- SoC and Boards device tree new split
- 1 device tree per board CPN, dtsi device trees splitted between SoC Product lines, SoC extensions (security and Cortex A frequency) and SoC package types - refer to STM32MP15_device_tree article
- OpenSTLinux debug with gdb management
- Basic boot removed except for DDR tuning tool
- ST boot reference is the Trusted with TF-A=>U-BOOT=>Kernel
- UART RS485 support
- Yocto build process
- SSP feature (Secure Secrets Provisonning) delivered with a specific TF-A branch managed with a dedicated Yocto recipe tf-a-stm32mp-ssp_2.2.bb
- A dedicated Yocto recipe is also added to manage the TF-A for serial boot tf-a-stm32mp-serialboot_2.2.bb additionally to tf-a-stm32mp_2.2.bb. The 2 recipes are included in ST yocto images. It allows to use a dedicated TF-A binary for serial boot with STM32CubeProgrammer tool and to save size for the TF-A binary used for the product
- Internal peripheral assignment at boot time
- At boot time, you can select two kernel configurations:
- Configuration 1: all internal peripherals are assigned to Cortex-A7 for Linux drivers. Cortex-M4 coprocessing firmware TTY is executed by default.
- Configuration 2: some internal peripherals are assigned to Cortex-M4 to execute Cortex-M4 delivered examples on the board (EVAL or DISCO) see (How to run Cortex-M4 examples).
- Configuration 1 is activated by default if you do not specify "2" in the U-Boot console.
- More information can be found in How to assign an internal peripheral to a runtime context article.
5.2.2 STM32CubeMP1 (Cortex®-M4)
- STM32CubeMP1-v1.2.0 version same as STM32MP15-ecosystem-v1.2.0 release
5.3 STM32CubeProgrammer, Signing tool, Keygen
| To be delivered on to 26th of July 2020,
In between, please note that STM32CubeProgrammer V2.4 from STM32MP15-Ecosystem-v1.2.0 release is compliant with V2.0.0 Emb. SW delivery
STM32CubeProgrammer v2.5.0 is the version delivered within STM32MP15-ecosystem-v2.0.0 release. This is an evolutive maintenance release for STM32CubeProgrammer.
- Main NEW features coming with STM32CubeProgrammer-v2.5.0 version, delivered within STM32MP15-ecosystem-v2.0.0 release
- Flashload UART
- SSP (Secure Secrets Provisonning) UI
- Support STM32MP157F-EV1 board
- Features already available in previous version
- STM32CubeProg installer includes STM32CubeProgrammer, Keygen and Signing tools
- Flashload SDCard, eMMC, NAND, NOR images through USB and UART for STM32MP157C-EV1, STM32MP157A-EV1, STM32MP157A-DK1, STM32MP157C-DK2 boards
- Private and public keys generation
- Images signature
- Flashlayout file format change
- STM32MP1 fuses management (with console interface only)
- PMIC NVM management (with console interface only)
STM32CubeMX-v6.0 is the version delivered within STM32MP15-ecosystem-v2.0.0 release
- Main NEW features coming with STM32CubeMX-v6.0 version, delivered within STM32MP15-ecosystem-v2.0.0 release
- New Boards 800 MHz support - STM32MP157F-EV1
- Device tree (A7)
- DMA config generation - DMA nodes
- Device tree compliance with Openstlinux-5.4-dunfell-mp1-20-06-24 tag
- Features already available in previous version
- STM32CubeMP1 (M4): Compliance with STM32CubeMP1 V1.2.0
- I/O muxing and clock tree configuration
- STM32MP1 contexts management (A7 non-secure, A7 secure, M4)
- ST32MP1Cube 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).
|Note: The other device tree parameters must be filled in manually through user section tags (from /* USER CODE BEGIN <node> */ to /* USER CODE END <node> */)|
- Main NEW features coming with STM32CubeIDE V1.4.0 version, delivered within STM32MP15-ecosystem-v2.0.0 release
- New Boards 800 MHz support - STM32MP157F-EV1
- OpenSTLinux developer package support with
- TF-A component project with native dt selected or external dt (ex : generated from CubeMX)
- U-BOOT component project with native dt selected or external dt (ex : generated from CubeMX)
- OP-TEE component project with native dt selected or external dt (ex : generated from CubeMX)
- KERNEL component project with native dt selected or external dt (ex : generated from CubeMX)
- KERNEL artefacts update on running target
- Features already available in previous version
- STM32CubeMP1 V1.2.0 M4 support as STM32MP15-ecosystem-v1.2.0 release
- 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
- Detailed features are available in the release notes of the different components of this delivery.
- See sections STM32MPU Embedded Software distribution detailed release notes, Referenced tools release notes and Reference documents
6 Main restrictions
6.1 Embedded software
6.1.1 OpenSTLinux (Cortex®-A7)
6.1.2 STM32CubeMP1 (Cortex®-M4)
- To avoid errors in OpenAMP when compiling in MDK-ARM IDE, disable the « Use MicroLIB » in « Target » tab.
- Please use HAL RTC with caution since this driver is also used by Linux. To remove any risk of contention between Linux and the HAL, proceed as follows:
- The write protect (wpr) must be disabled by default and it must never be enabled in any driver (Linux nor HAL).
- The HAL must use only Alarm B, since Linux uses Alarm A.
- The RTC interrupt must be shared between Linux and the HAL to be able to receive alarm notifications on both sides.
6.2 STM32CubeProgrammer, Signing tool and Keygen
- Key generation is not functional with STM32MP_KeyGen_CLI on Linux under Ubuntu 16.04 (functional with Ubuntu 18.04)
- Warning: when opening a previous project built with STM32CubeMX version older than V6.0, the migration does not take into account the user section part. This part needs to be updated manually according the Openstlinux-5.4-dunfell-mp1-20-06-24 manifest.
- Using OpenOCD with ST-LINK does not check and force ST-LINK firmware update at debug launch. It is therefore recommended to manually update to the latest ST-LINK firmware for the best debug experience. Use the Help > ST-LINK Upgrade menu"
Restriction lists are available in each subcomponent release note. They are available in the following chapters in the present article:
Moreover, the software workarounds implemented in the ecosystem to provide solutions to the STM32MPU device errata are listed in STM32MP15 ecosystem errata sheet.
7 Minor release updates
STMicroelectronics regularly delivers updates through the following github® components: tf-a, u-boot, optee-os, Linux kernel.
You can decide to incorporate them into your Developer Package (refer to STM32MP1 Developer Package or Distribution Package below).
To update the Distribution package, proceed as follows:
- Switch your Distribution package reference source code to github mode.
- Use the devtool modify <recipe name> command to have direct access to the source code git repository used by the build process.
- In the freshly cloned source code, check out the revision you want 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) into your local STM32MP1 Distribution Package environment. Below the github® links corresponding to each layers:
8 Reference documents
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.
|The different STM32MP15 microprocessor part numbers available (with their corresponding internal peripherals, security options and packages) are described in the STM32MP15 microprocessor part numbers.|
|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|
|AN5031||Getting started with STM32MP15 Series hardware development||AN5031.pdf||v2.0|
|AN5036||Thermal management guidelines for STM32 applications||AN5036.pdf||v3.0|
|AN5109||STM32MP1 Series using low-power modes||AN5109.pdf||v3.0|
|AN5122||STM32MP1 Series DDR memory routing guidelines||AN5122.pdf||v3.0|
|AN5168||STM32MP1 series DDR configuration||AN5168.pdf||v1.0|
|AN5225||USB Type-C™ Power Delivery using STM32xx Series MCUs and STM32xxx Series MPUs||AN5225.pdf||v2.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||v1.0|
|AN5275||USB DFU/USART protocols used in STM32MP1 Series bootloaders||AN5275.pdf||v1.0|
|AN5284||STM32MP1 series system power consumption||AN5284.pdf||v1.0|
|AN5348||FDCAN peripheral on STM32 devices||AN5348.pdf||v1.0|
|AN5431||The STPMIC1 PCB layout guidlines||AN5431.pdf||v1.1|
|AN5438||STM32MP1 Series lifetime estimates||AN5438.pdf||v1.0|
|ES0438||STM32MP15xx device errata||ES0438.pdf||v5.0|
|RM0436||STM32MP157 reference manual
(STM32MP157xxx advanced Arm®-based 32-bit MPUs)
|RM0442||STM32MP153 reference manual
(STM32MP153xxx advanced Arm®-based 32-bit MPUs)
|RM0441||STM32MP151 reference manual
(STM32MP151xxx advanced Arm®-based 32-bit MPUs)
|MB1262 schematics||STM32MP157C-EV1 motherboard schematics
MB1262-C01 board schematic (Evaluation board)
|MB1263 schematics||STM32MP157C-EV1 daughterboard schematics
MB1263-C01 board schematic (Evaluation board)
|MB1230 schematics||DSI 720p LCD display daughterboard schematics
MB1230-C board schematic (Evaluation board)
|MB1379 schematics||Camera daughterboard schematics
MB1379-A01 board schematic (Evaluation board)
|MB1272 schematics||STM32MP157x-DKx motherboard schematics
MB1272-DK2-C01 board schematic (Discovery kit)
|MB1407 schematics||STM32MP157x-DKx daughterboard schematics
MB1407-LCD-C01 board schematic (Discovery kit)
|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|
|Tools user manuals|
|UM2563||STM32CubeIDE installation guide||UM2563.pdf||v1.0|
|UM2579||Migration guide from System Workbench to STM32CubeIDE||UM2579.pdf||v1.0|
|UM2553||STM32CubeIDE quick start guide||UM2553.pdf||v1.0
|UM1718||STM32CubeMX user manual||UM1718.pdf||v31.0|
|UM2237||STM32CubeProgrammer tool user manual||UM2237.pdf||v11.0|
|UM2238||STM32 Trusted Package Creator tool user manual||UM2238.pdf||v6.0|
|UM2542||STM32 Series Key Generator tool user manual||UM2542.pdf||v1.0|
|UM2543||STM32 Series Signing tool user manual||UM2543.pdf||v1.0|
9 How to download the software and start with this release?
The list of embedded software packages available for download depends on the selected package.
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 an embedded software
|Board part number||Jump to|
|STM32MP15 Evaluation boards - getting started, including software download|
|STM32MP15 Discovery kits - getting started, including software download|
10 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.
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 .
|OpenSTLinux Distribution||STM32MP15 OpenSTLinux release note - v2.0.0||openstlinux-5.4-dunfell-mp1-20-06-24|
|STM32Cube MPU Package||STM32CubeMP1 Package release note - v1.2.0||STM32CubeMP1-v1.2.0|
11 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).
|Tools||Release notes||Host PC||Which Package may need the tool ?|
|STM32MPU Ecosystem V2.0.0 Release||Availability on ST.com targeted on 26th July 2020||Linux version||Windows version||Starter Package||Developer Package||Distribution Package|
|STM32CubeMX||STM32CubeMX release note||from 6.0||from 6.0||☐||☑||☑|
|STM32CubeProg||STM32CubeProgrammer release note||2.5.0||2.5.0||☑||☐||☑|
|Keygen||KeyGen release note||1.0.0||1.0.0||☑||☑||☑|
|Signing tool||Signing tool release note||1.0.0||1.0.0||☑||☑||☑|
- The part numbers are specified in STM32MP15 microprocessor part numbers
13 Archives 
|STM32MP15 release||Ecosystem release note|
|STM32MP15-Ecosystem-v1.2.0||STM32MP15 ecosystem release note - v1.2.0 page for the v1 ecosystem releases (in archived wiki)|
|STM32MP15-Ecosystem-v1.1.0||STM32MP15 ecosystem release note - v1.1.0 page for the v1 ecosystem releases (in archived wiki)|
|STM32MP15-Ecosystem-v1.0.0||STM32MP15 ecosystem release note - v1.0.0 page for the v1 ecosystem releases (in archived wiki)|