STM32 MPU ecosystem release note

Applicable for STM32MP13x lines, STM32MP15x lines


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

1 Delivery purpose and scope[edit]

The STM32MP1-ecosystem-v5.0.0 release is dedicated to the STM32MP1 series[1]. It is a major release, based on new community components version, listed in the embedded software chapter below.

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

  • providing a full ecosystem for the STM32MP1 series[1]
  • 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
  • STM32DDRFW-UTIL
  • STM32PRGFW-UTIL
  • STM32 referenced tools (more details are provided in the Referenced tools release notes chapter below):
  • STM32CubeIDE
  • STM32CubeMX
  • STM32CubeProgrammer
  • 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 supported hardware 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 Supported hardware[edit]

This software delivery is compatible with the following boards:

STM32MP13 boards
Boards PCBs list Main features Ordering
STM32MP135x-DK.png
STM32MP135F-DK Discovery kit
  • MB1635 (motherboard)
  • MB1897 (camera module board)
  • STM32MP135FAF7[2] Rev.Y
    • Arm®-based Cortex®-A7 1 GHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1
  • 4.3" TFT 480x272 pixels with LED backlight, and capacitive touch panel
  • 2-megapixel dual lane CSI-2 camera module with 15-pin FFC connector
  • Wi-Fi® 802.11b/g/n
  • Bluetooth® Low Energy 4.1

Discovery kit with STM32MP135F MPU


STM32MP15 boards
Boards PCBs list Main features Ordering
STM32MP157D-DK1.jpg
STM32MP157D-DK1 Discovery kit
  • MB1272C (motherboard)
  • STM32MP157DAC1[3] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Basic security
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1APQR cut2.0

Discovery kit with STM32MP157D MPU

STM32MP157F-DK2.jpg
STM32MP157F-DK2 Discovery kit
  • MB1272C (motherboard)
  • MB1407B (daughterboard DSI display)
  • STM32MP157FAC1[3] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1APQR cut2.0
  • 4" TFT 480×800 pixels with LED backlight, and capacitive touch panel
  • Wi-Fi® 802.11b/g/n
  • Bluetooth® Low Energy 4.1

Discovery kit with STM32MP157F MPU

STM32MP157D or F-EV1.jpg
STM32MP157D-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157DAA1[3] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Basic security
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1APQR cut2.0
  • 5.5" TFT 720×1280 pixels with LED backlight, and capacitive touch panel
  • 5-megapixel, 8-bit camera

Evaluation board with STM32MP157D MPU

STM32MP157D or F-EV1.jpg
STM32MP157F-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157FAA1[3] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Secure boot and cryptography
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1APQR cut2.0
  • 5.5" TFT 720×1280 pixels with LED backlight, and capacitive touch panel
  • 5-megapixel, 8-bit camera

Evaluation board with STM32MP157F MPU

STM32MP157A-DK1.jpg
STM32MP157A-DK1 Discovery kit
  • MB1272C (motherboard)
  • STM32MP157AAC3[3] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Basic security
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1APQR cut1.2

Out of production

STM32MP157C-DK2.jpg
STM32MP157C-DK2 Discovery kit
  • MB1272C (motherboard)
  • MB1407B (daughterboard DSI display)
  • STM32MP157CAC3[3] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1APQR cut1.2
  • 4" TFT 480×800 pixels with LED backlight, and capacitive touch panel
  • Wi-Fi® 802.11b/g/n
  • Bluetooth® Low Energy 4.1

Out of production

STM32MP157A or C-EV1.jpg
STM32MP157A-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157AAA3[3] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Basic security
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1APQR cut1.2
  • 5.5" TFT 720×1280 pixels with LED backlight, and capacitive touch panel
  • 5-megapixel, 8-bit camera

Out of production

STM32MP157A or C-EV1.jpg
STM32MP157C-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157CAA3[3] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Secure boot and cryptography
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1APQR cut1.2
  • 5.5" TFT 720×1280 pixels with LED backlight, and capacitive touch panel
  • 5-megapixel, 8-bit camera

Out of production

Info white.png Information
The STLINK embedded on the boards requires upgraded USB PC drivers: see this article

5 Release content[edit]

5.1 Embedded software[edit]

Embedded software STM32MP13x lines More info.png STM32MP15x lines More info.png
OpenSTLinux (Arm® Cortex®-A7) Yes Yes
STM32CubeMP1 (Arm® Cortex®-M4) No Yes
Buildroot (Arm® Cortex®-A7) Yes Yes
STM32DDRFW-UTIL (Arm® Cortex®-A7) Yes Yes
STM32PRGFW-UTIL (Arm® Cortex®-A7) Yes Yes

5.1.1 OpenSTLinux (Arm® Cortex®-A7)[edit]

openstlinux-6.1-yocto-mickledore-mp1-v23.06.21 is the new version delivered with the STM32MP1-ecosystem-v5.0.0 release. This software set consists of the following components:

  • Build process
    • OpenEmbedded v4.2.1 (Mickledore) - Updated
    • GCC version v12.2.0 - Updated
  • Embedded software components
    • Linux kernel v6.1-stm32mp-r1 (v6.1.28) - Updated
    • TF-A v2.8-stm32mp-r1 - Updated
    • U-Boot v2022.10-stm32mp-r1 - Updated
    • OP-TEE 3.19.0-stm32mp-r1 - Updated
    • OpenOCD version v0.11.0
  • Applicative components
    • Weston version v11.0.1 - Updated
    • Wayland version 1.21.0 - Updated
    • GStreamer version v1.22.0 - Updated
    • GCnano version v6.4.13 - Updated
5.1.1.1 Main changes[edit]

Linux® kernel

  • Storage
    • SDMMC: Implement "SDIO In band interrupt Mode"
    • NAND: "EDO mode" removed from driver
  • Visual
    • GPU: library v6.4.13 integration
    • [DCMI/OV5640] : supported without DMA-MDMA chaining
    • [GC2145]  : more raw Bayer formats camera sensor supported
  • LSI
    • SmartCard support
  • HSI
    • USB gadget : remove RNDIS and enable NCM
    • Enable OnBoard HUB feature
  • Security
    • OP-TEE SCMI: Add thread provisioning
    • SCMI: Move mailbox to Linux memory
    • Firewall bus for peripheral access control (ETZPC)
  • Coprocessor
    • Authenticated coprocessor firmware: Improve load, by suppressing one extra copy of the firmware image.
  • Core
    • Watchdog switch to "ARM SMC watchdog" by default (IWDG2 no more used)

U-Boot

  • Use U-Boot device tree to configure MTD partitions and remove usage of "mtdparts" function
  • Use" op-tee shm" for OP-TEE SCMI communication
  • Add "Arm SMC" watchdog driver
  • Add ETZPC system bus
  • Add USB onboard HUB driver for ST boards
  • Improve ENV in MMC support
  • Update stm32prog command to suport new GUID types

TF-A

  • Remove SP_MIN as secure world runtime service firmware. Those services are provided from ecosystem release v5.0.0 More info.png through OP-TEE
  • Default build with OP-TEE in DDR for STM32MP15
  • Always boot at 650MHz in BL2
  • Clear and lock the fip-edmk fuse when outing BL2
  • Manage quad enable bit on SPI NAND
  • MISRA corrections
  • Several bug fixes in low-power, RCC, BSEC, NAND, device tree, UART, watchdog & SSP

OP-TEE

  • Implementation of a secure watchdog
  • Use of watchdog framework
  • Fix IWDG early-interrupt
  • Allow device-tree RNG configuration + fixes
  • Move SCMI mailbox to Linux/U-Boot memory
  • New SCMI thread provisioning
  • Low-power fixes
  • Full clock tree is applied in OP-TEE to allow clock tree update over FOTA
  • Support bit offset for NVMEM
  • Reworked OCALL to OCALL2
  • For STM32MP15x lines More info.png:
    • OP-TEE build by default in DDR (pager mecanism OFF):
      • Replace the previous TF-A SP_MIN system services configuration by default
      • Pager configuration can be restored using pager (refer to OP-TEE core configuration) for a full set of secure services
  • Minor Fixes

6 Release change notification[edit]

OpenSTLinux attention points to switch from ecosystem release v4.1.0 to ecosystem release v5.0.0 More info.png are documented in STM32 MPU OpenSTLinux release changes notification – v5.0.0 article.

7 Recommendations for use[edit]

7.1 Safe use[edit]

  • Flash programming and boot from all supported flash devices: SDCard, eMMC, ONFI NAND and NOR flash memories.
  • Develop Linux® applications, libraries, kernel modules based on OpenSTLinux delivery.
  • Develop coprocessor Cube applications based on STM32CubeMP1 delivery.
  • Develop boards based on STM32MP1 series.
  • Prototype applications based on ST boards.

7.2 Non-recommended use[edit]

  • None

8 Restrictions[edit]

  • Camera resolution limited to 320*240 / 15 fps on STM32MP157F-EV1 Evaluation board More info green.png: limitation when using DCMI configuration, correction under implementation and will be delivered soon
  • The partition layout always keeps the Firmware Update related partitions even if machine feature fw-update is disabled. To optimize the partition layout without Firmware Update feature, modifications are needed on flashlayout file generation and also on U-Boot source code in case of MTD partitions (storage mapping is hardcoded for MTD partitions, see How_to_configure_U-Boot_for_your_board#MTD_partitions)

9 Minor release updates[edit]

STMicroelectronics regularly delivers corrections through github® components which are U-Boot, OP-TEE, TF-A, Linux kernel.
The corrections can be incorporated into the Developer Package (refer to STM32MP1 Developer Package) or Distribution Package (see below).

Two possibilities exist to update a Distribution Package:

  • Update your existing Distribution Package:
Switch your Distribution Package to # github® mode .
  1. Use the devtool modify <recipe name> command to set up an environment. It fetches and unpacks the source code.
  2. In the extracted source code, use a git command such as git checkout -b WORK <github® TAG> to point to a new revision of the component.
More rarely, STMicroelectronics also delivers 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. See below the github® links of the quoted layers :
  • Get a new Distribution Package:
Refer to Installing_the_OpenSTLinux_distribution page for installing instructions, and use the repo command given for the minor version below, if it exists.

10 How to get started with openstlinux-6.1-yocto-mickledore-mp1-v23.06.21[edit]

Refer to How to download the software and start with this release?

11 Associated tools[edit]

Refer to the Referenced tools release notes .

12 Yocto features enabled in the delivery[edit]

OpenEmbedded[4] build framework engine is named OE-Core.
OpenSTLinux distribution is based on the build framework OpenEmbedded, and can be configured thanks to a mechanism named "features" (machine features, distribution features, ...).

Depending on the features enabled, the resulting distribution can have more capabilities or software embedded.
For example, if the Wifi is enabled then the Wifi software and drivers are present on the filesystem and the Wifi can be used.

12.1 Machine features[edit]

The variable MACHINE_FEATURES specifies the list of hardware features the machine is capable of supporting.
These features (MACHINE_FEATURES) are defined inside the machine configuration .

Machine feature Purpose
alsa Include ALSA support (OSS compatibility kernel modules installed if available).
autoresize Add support of autoresize through InitRD
bluetooth Add Broadcom43430 (Bluetooth) firmware to the filesystem
(STM32MP135x-DK Discovery kit More info green.png and STM32MP157x-DKx Discovery kit More info green.png)
ext2 Add Second Extended File System support
fip Enable Firmware In Package (FIP) packaging format
fw-update Enable Firmware update feature
gpu Add GPU support (if EULA is accepted) (STM32MP157 line More info.png only)
initrd Enable Intial ramdisk building
m4copro Add m4projects to userfs (STM32MP15x lines More info.png only)
optee Add OP-TEE Secure part
pci Add Peripheral Component Interconnect peripheral support
rtc Add Real Time Clock peripheral support
screen Add display screen peripheral support
splashscreen Add splashscreen to U-Boot
tpm2 Add Trusted Platform Module peripheral support
usbg0 Add G0 Firmware for USB support
usbgadget Enable USB Gadget feature
usbhost Enable USB Host feature
watchdog Add watchdog support and binaries
wifi Add Broadcom43430 (wifi) firmware to the filesystem
(STM32MP135x-DK Discovery kit More info green.png and STM32MP157x-DKx Discovery kit More info green.png)

12.2 Distribution features[edit]

The variable DISTRO_FEATURES specifies the list of software features present in the distribution.
These features (DISTRO_FEATURES) are defined inside the distribution configuration .

Distribution feature Purpose
alsa Include ALSA support (OSS compatibility kernel modules installed if available).
argp
autoresize Add support of userfs auto resize feature in OpenSTLinux
bluetooth Include Bluetooth support
bluez5 Add Bluetooth stack
efi Add userland EFI tools
ext2 Add Second Extended File System support
ext4 Add Fourth Extended File System support
gobject-introspection-data Enable GObject Introspection, project for providing machine readable introspection data of the API of C libraries.
gplv3 Add gplv3 binaries in OpenSTLinux
gstreamer Add gstreamer tools in filesystem
initrd Add ramdisk
ipv4 Add ipv4 support
ipv6 Add ipv6 support
kde Add several tools (e.g. cups, fontconfig, ...) to the filesystem
largefile Enable large file support
ldconfig Include support for ldconfig and ld.so.conf on the target
multiarch Enable 64 bits BFD (Binary File Descriptor)
nfs Include NFS client support (for mounting NFS exports on device).
opengl Include the Open Graphics Library
optee Install tee service on the filesystem
pam Enable Pluggable Authentication Module
pci Add pci support
pulseaudio Network-capable sound server program
splashscreen Add U-Boot splashscreen
systemd Use systemd as init service
usbgadget USB Gadget Device support (for USB networking/serial/storage)
usbhost USB Host support (allows to connect external keyboard, mouse, storage, network etc)
wayland Add Wayland support
wifi WiFi support
xattr Add "Extended Attributes" support for filesystem
zeroconf Add zeroconf package to set up a ad-hoc network

12.3 Bootscheme labels[edit]

The variable BOOTSCHEME_LABELS defines which kind of boot is supported on the board.
These settings (BOOTSCHEME_LABELS) are defined inside the machine configuration .

Bootscheme label Purpose
optee Add op-tee in bootscheme

12.4 Bootdevice labels[edit]

The variable BOOTDEVICE_LABELS defines which kind of mass storage OpenSTLinux can programmed.
These settings (BOOTDEVICE_LABELS ) are defined inside the machine configuration .

Bootdevice label Purpose
emmc Add boot on emmc device
nand-4-256 Add boot on NAND device
nor-sdcard Add boot stage on NOR device and the filesystem on SD-Card
sdcard Add boot on SD-Card


OpenSTLinux layers

  • Rebase on Yocto Release 4.2.1 (Mickledore)
  • "EFI boot" support (not enabled by default)
  • BSP adaptation for GCC version v12.2.0
  • MACHINE: split device tree file by supported storages
  • "GTKWayland sink" usage for Gstreamer
  • Manage new Ethernet device name (eth0 to end0)
  • "USB OTG": Switch from RNDIS to NCM
  • Add "CVE Summary" generation
  • SDK: add native gcc and symlinks
Warning white.png Important
More information about the changes are available through the detailed release note
12.4.1 Restrictions[edit]
  • Camera resolution limited to 320*240 / 15 fps on STM32MP157F-EV1 Evaluation board More info green.png: limitation when using DCMI configuration, correction under implementation and will be delivered soon
  • The partition layout always keeps the Firmware Update related partitions even if machine feature fw-update is disabled. To optimize the partition layout without Firmware Update feature, modifications are needed on flashlayout file generation and also on U-Boot source code in case of MTD partitions (storage mapping is hardcoded for MTD partitions, see How_to_configure_U-Boot_for_your_board#MTD_partitions)


12.4.2 STM32CubeMP1 (Arm® Cortex®-M4)[edit]

STM32CubeMP1 Package v1.6.0 version - same version as the one delivered for the STM32MP1-ecosystem-v4.0.0 release.

  • Applicative components
    • OpenAMP v2021.10.0

12.4.3 Buildroot (Arm® Cortex®-A7)[edit]

Under construction.png Coming soon



Puzzle partner program.png Partner program
Bootlin.png Bootlin has developed specific support, demonstration configurations and documentation to help ST customers use Buildroot on STM32MP1 platforms.

See https://www.st.com/content/st_com/en/partner/partner-program/partnerpage/Bootlin.html


12.4.4 STM32DDRFW-UTIL (Arm® Cortex®-A7)[edit]

STM32DDRFW-UTIL-v1.0.1 version is the new version delivered with the STM32MP1-ecosystem-v5.0.0 release. STM32DDRFW-UTIL provides utilities for DDR.

Features available in this version

  • Support of STM32MP135C-DK, STM32MP157C-DK2 and STM32MP157C-EV1 boards
  • Improve board customization capability
  • Add imageheader to generate stm32 files with STM32CubeIDE.

12.4.5 STM32PRGFW-UTIL (Arm® Cortex®-A7)[edit]

STM32PRGFW-UTIL-v1.0.2 version.

Warning white.png Warning
It is mandatory to use STM32PRGFW-UTIL version 1.0.2, instead of using version 1.0.0, as a major correction has been done in the new version to avoid potential device bricking.
Info white.png Information
This new version has some dependencies with STM32CubeIDE v1.11.0 (and further versions) and STM32CubeProgrammer v1.12.0 (and further versions) , it is then highly recommended to update also those 2 other ST tools

STM32PRGFW-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.
12.4.5.1 Main changes[edit]
  • Documentation update
  • STM32MP15 Semihosting mode issue fixed,
  • STM32MP15 USB reconnection issue fixed,

Features already available in previous version

  • 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
12.4.5.2 Restrictions[edit]

Semihosting mode is not functional on Windows PC.

12.5 Tools[edit]

12.5.1 STM32CubeProgrammer, Signing tool, Keygen[edit]

STM32CubeProgrammer v2.14.0 version - Updated .

12.5.1.1 Main changes[edit]
  • Bug fixes
  • No new feature for STM32 MPU

Features already available in previous 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)
12.5.1.2 Supported operating systems and architectures[edit]

• Windows® 7, 8, 10, and 11: 32 bits (x86) and 64 bits (x64) • Linux® 64 bits (tested on Ubuntu® 64 bits) • macOS® (minimum version OS X® Yosemite)

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.
12.5.1.3 Restrictions[edit]
  • None

12.5.2 STM32CubeMX[edit]

STM32CubeMX-v6.9.0 version - Updated .

12.5.2.1 Main changes[edit]
  • Upgrade the JDK11 with Adoptium™ Termurin™ 17.0.6

Features already available in previous version

  • 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> */)
12.5.2.2 Supported operating systems and architectures[edit]
  • Windows® 10 and 11, 64 bits (x64)(b)
  • Linux®: Ubuntu® LTS 20.04 and LTS 22.04, and Fedora® 36(c) (d) (e)
  • macOS® 12 (Monterey), macOS® 13 (Ventura)(f)
12.5.2.3 Supported toolchains[edit]

STM32CubeMX generates project files for the following toolchains:

  • STM32CubeIDE by STMicroelectronics
  • IAR Embedded Workbench® for Arm® (EWARM) by IAR systems®
  • Microcontroller Development kit for Arm® by Keil®: MDK-ARM V4 or V5 (minimum

required version V4.73)

12.5.2.4 Restrictions[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-6.1-yocto-mickledore-mp1-v23.06.21 manifest.

12.5.3 STM32CubeIDE[edit]

STM32CubeIDE-v1.13.0 version - Updated .

12.5.3.1 Main changes[edit]
  • Ubuntu 22.04 support
  • Upgrade Java 17 + Eclipse 2023-03
  • TCP console for Semihosting output for Arm® Cortex®-M
  • GCC update enabled (updates GCC 11.3)



Features already available in previous version

  • Ubuntu 20.04 support
  • Application and libraries userland Arm® Cortex®-A7 support based on OpenSTLinux Developer Package and Yocto SDK.
  • Arm® Cortex®-M4 STM32CubeMP1 in "Production mode" and "Engineering mode"
  • Arm® Cortex®-M4 Firmware compilation, loading and debugging
  • PC Linux® with ethernet (recommended) or serial link
  • PC Windows with ethernet or ethernet over USB link
  • Arm® 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
    • Installation of Yocto SDK
    • Installation of OpenSTLinux projects Sources
Warning white.png Warning
A compilation issue occurs with STM32CubeMP1 Package v1.6.0. STM32CubeMP1 Package v1.6.0 is compliant with 10.3 GCC toolchain whereas STM32CubeIDE-v1.13.0 is embedded by default 11.3 GCC toolchain. The toolchain has to be updated to 10.3 with Toolchain manager tool to compile STM32CubeMP1 Package v1.6.0, See UM2609 - STM32CubeIDE user manual, section 2.1.1 for details.

12.6 Miscellaneous[edit]

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

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

13 Minor release updates[edit]

  • None


14 Reference documents[edit]

14.1 STM32MP13 resources[edit]


All the resources for the STM32MP1 series are located in the STM32MP1 series web page.

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.


Reference Name Link
Application notes
AN2834 How to get the best ADC accuracy in STM32 microcontrollers AN2834.pdf
AN4803 High-speed SI simulations using IBIS and board-level simulations using HyperLynx® SI on STM32 MCUs and MPUs AN4803.pdf
AN5027 Interfacing PDM digital microphones using STM32 MCUs and MPUs AN5027.pdf
AN5036 Thermal management guidelines for STM32 applications AN5036.pdf
AN5168 How to configure DDR on STM32MP1 MPUs AN5168.pdf
AN5225 USB Type-C® Power Delivery using STM32 MCUs and MPUs AN5225.pdf
AN5275 USB DFU/USART protocols used in STM32MP1 series bootloaders AN5275.pdf
AN5284 STM32MP1 series system power consumption AN5284.pdf
AN5348 Introduction to FDCAN peripherals for STM32 product classes AN5348.pdf
AN5431 The STPMIC1 PCB layout guidlines AN5431.pdf
AN5438 STM32MP1 series lifetime estimates AN5438.pdf
AN5510 Overview of the secure secret provisioning (SSP) on STM32MP1 series AN5510.pdf
AN5827 Guidelines for entering RMA state on STM32MP1 series MPUs AN5827.pdf
AN4879 USB hardware and PCB guidelines using STM32 MCUs AN4879.pdf
AN5474 Getting started with STM32MP13 series hardware development AN5474.pdf
AN5475 Migration of applications from STM32MP15x lines to STM32MP13x lines microprocessor AN5475.pdf
AN5478 Camera-CSI (DCMI-PP) in STM32MP13x microprocessors AN5478.pdf
AN5565 STM32MP13 lines using low-power modes AN5565.pdf
AN5586 STM32MP13x MPU product line discrete power supply hardware integration AN5586.pdf
AN5587 STM32MP13x MPU product lines and STPMIC1D / STPMIC1A integration on a wall adapter supply AN5587.pdf
AN5692 DDR memory routing guidelines for STM32MP13x product lines AN5692.pdf
AN5787 Thermal management guidelines for STM32 applications AN5787.pdf

Datasheets[5]
DS12792 STPMIC1 datasheet
DS12792.pdf
DS13483 STM32MP135C/F Datasheet (STM32MP135C/F)
(secure)
DS13483.pdf
DS13874 STM32MP135A/D Datasheet (STM32MP135A/D)
(non secure)
DS13874.pdf
DS13875 STM32MP133C/F Datasheet (STM32MP133C/F)
(secure)
DS13875.pdf
DS13876 STM32MP133A/D Datasheet (STM32MP133A/D)
(non secure)
DS13876.pdf
DS13877 STM32MP131C/F Datasheet (STM32MP131C/F)
(secure)
DS13877.pdf
DS13878 STM32MP131A/D Datasheet (STM32MP131A/D)
(non secure)
DS13878.pdf

Errata sheets
ES0539 STM32MP13x device errata ES0539.pdf

Reference manuals[5]
RM0475 STM32MP13x reference manual
(STM32MP135 advanced Arm®-based 32-bit MPUs)
RM0475.pdf

Boards schematics
MB1635 schematics STM32MP135F-DK motherboard schematics
MB1635-E02 board schematics (Discovery kit)
MB1635-E02.pdf

Boards user manuals
UM2993 STM32MP135F-DK discovery board user manual UM2993.pdf

Tools user manuals
UM2563 STM32CubeIDE installation guide UM2563.pdf
UM2579 Migration guide from System Workbench to STM32CubeIDE UM2579.pdf
UM2553 STM32CubeIDE quick start guide UM2553.pdf
AN5360 Getting started with projects based on the STM32MP1 series in STM32CubeIDE AN5360.pdf
UM2609 STM32CubeIDE user guide UM2609.pdf
UM1718 STM32CubeMX user manual UM1718.pdf
UM2237 STM32CubeProgrammer tool user manual UM2237.pdf
UM2238 STM32 Trusted Package Creator tool user manual UM2238.pdf
UM2542 STM32 series Key Generator tool user manual UM2542.pdf
UM2543 STM32 series Signing tool user manual UM2543.pdf

14.2 STM32MP15 resources[edit]


All the resources for the STM32MP1 series are located in the STM32MP1 series web page.

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.



Reference Name Link
Application notes
AN2834 How to get the best ADC accuracy in STM32 microcontrollers AN2834.pdf
AN4803 High-speed SI simulations using IBIS and board-level simulations using HyperLynx® SI on STM32 MCUs and MPUs AN4803.pdf
AN5027 Interfacing PDM digital microphones using STM32 MCUs and MPUs AN5027.pdf
AN5036 Thermal management guidelines for STM32 applications AN5036.pdf
AN5168 How to configure DDR on STM32MP1 MPUs AN5168.pdf
AN5225 USB Type-C® Power Delivery using STM32 MCUs and MPUs AN5225.pdf
AN5275 USB DFU/USART protocols used in STM32MP1 series bootloaders AN5275.pdf
AN5284 STM32MP1 series system power consumption AN5284.pdf
AN5348 Introduction to FDCAN peripherals for STM32 product classes AN5348.pdf
AN5431 The STPMIC1 PCB layout guidlines AN5431.pdf
AN5438 STM32MP1 series lifetime estimates AN5438.pdf
AN5510 Overview of the secure secret provisioning (SSP) on STM32MP1 series AN5510.pdf
AN5827 Guidelines for entering RMA state on STM32MP1 series MPUs AN5827.pdf
AN5031 Getting started with STM32MP15 Series hardware development AN5031.pdf
AN5109 STM32MP15x lines using low-power modes AN5109.pdf
AN5122 STM32MP1 series DDR memory routing guidelines AN5122.pdf
AN5253 Migration of microcontroller applications from STM32F4x9 lines to STM32MP151, STM32MP153 and STM32MP157 lines microprocessor AN5253.pdf
AN5256 STM32MP151, STM32MP153 and STM32MP157 discrete power supply hardware integration AN5256.pdf
AN5260 STM32MP151/153/157 MPU lines and STPMIC1B integration on a battery powered application AN5260.pdf
AN5284 STM32MP1 series system power consumption AN5284.pdf

Datasheets[6]
DS12792 STPMIC1 datasheet
DS12792.pdf
DS12505 STM32MP157C/F datasheet
(secure)
DS12505.pdf
DS12504 STM32MP157A/D datasheet
(basic)
DS12504.pdf
DS12503 STM32MP153C/F datasheet
(secure)
DS12503.pdf
DS12502 STM32MP153A/D datasheet
(basic)
DS12502.pdf
DS12501 STM32MP151C/F datasheet
(secure)
DS12501.pdf
DS12500 STM32MP151A/D datasheet
(basic)
DS12500.pdf

Errata sheets
ES0438 STM32MP15xx device errata ES0438.pdf

Reference manuals[6]
RM0436 STM32MP157 reference manual
(STM32MP157xxx advanced Arm®-based 32-bit MPUs)
RM0436.pdf
RM0442 STM32MP153 reference manual
(STM32MP153xxx advanced Arm®-based 32-bit MPUs)
RM0442.pdf
RM0441 STM32MP151 reference manual
(STM32MP151xxx advanced Arm®-based 32-bit MPUs)
RM0441.pdf

Boards schematics
MB1262 schematics STM32MP157C-EV1 motherboard schematics
MB1262-C01 board schematic (Evaluation board)
MB1262-C01.pdf
MB1263 schematics STM32MP157F-EV1 daughterboard schematics
MB1263-C04 board schematic (Evaluation board)
MB1263-C04.pdf
MB1230 schematics DSI 720p LCD display daughterboard schematics
MB1230-C02 board schematic (Evaluation board)
MB1230-C02.pdf
MB1379 schematics Camera daughterboard schematics
MB1379-A01 board schematic (Evaluation board)
MB1379-A01.pdf
MB1272 schematics STM32MP157x-DKx motherboard schematics
MB1272-DK2-C02 board schematic (Discovery kit)
MB1272-C02.pdf
STM32MP157x-DKx motherboard schematics
MB1272-DK2-C03 board schematic (Discovery kit)
MB1272-C03.pdf
MB1407 schematics STM32MP157x-DKx daughterboard schematics
MB1407-LCD-C01 board schematic (Discovery kit)
MB1407-C01.pdf
STM32MP157x-DKx daughterboard schematics
MB1407-LCD-C02 board schematic (Discovery kit)
MB1407-C02.pdf

Boards user manuals
UM2534 STM32MP157A-DK1 and STM32MP157C-DK2 Discovery kits user manual UM2534.pdf
UM2535 STM32MP157C-EV1 and STM32MP157A-EV1 Evaluation boards user manual UM2535.pdf
UM2637 STM32MP157D-DK1 and STM32MP157F-DK2 Discovery kits user manual UM2637.pdf
UM2648 STM32MP157F-EV1 and STM32MP157D-EV1 Evaluation boards user manual UM2648.pdf

Tools user manuals
UM2563 STM32CubeIDE installation guide UM2563.pdf
UM2579 Migration guide from System Workbench to STM32CubeIDE UM2579.pdf
UM2553 STM32CubeIDE quick start guide UM2553.pdf
AN5360 Getting started with projects based on the STM32MP1 series in STM32CubeIDE AN5360.pdf
UM2609 STM32CubeIDE user guide UM2609.pdf
UM1718 STM32CubeMX user manual UM1718.pdf
UM2237 STM32CubeProgrammer tool user manual UM2237.pdf
UM2238 STM32 Trusted Package Creator tool user manual UM2238.pdf
UM2542 STM32 series Key Generator tool user manual UM2542.pdf
UM2543 STM32 series Signing tool user manual UM2543.pdf

15 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.
Supported board Jump to
STM32MP157x-EV1 Evaluation board More info green.png STM32MP15 Evaluation boards - getting started, including software download
STM32MP157x-DKx Discovery kit More info green.png STM32MP15 Discovery kits - getting started, including software download
STM32MP135x-DK Discovery kit More info green.png STM32MP13 Discovery kits - getting started, including software download

16 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 download the software and start with this release.


Firmware Release note Version
OpenSTLinux Distribution STM32 MPU OpenSTLinux release note - v5.0.0 openstlinux-6.1-yocto-mickledore-mp1-v23.06.21
Buildroot Distribution
Under construction.png Coming soon
Under construction.png Coming soon
STM32Cube MPU Package STM32CubeMP1 Package release note - v1.6.0 STM32CubeMP1 Package v1.6.0

17 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.13.0 1.13.0
STM32CubeMX STM32CubeMX release note 6.9.0 6.9.0
STM32CubeProg STM32CubeProgrammer release note 2.14.0 2.14.0
Keygen KeyGen release note 2.14.0 2.14.0
Signing tool Signing tool release note 2.14.0 2.14.0
STM32DDRFW-UTIL STM32DDRFW-UTIL release note 1.0.1 1.0.1
STM32PRGFW-UTIL STM32PRGFW-UTIL release note 1.0.2 1.0.2

18 References[edit]

  1. 1.01.1 The STM32MP1 series includes the STM32MP13x lines More info.png and the STM32MP15x lines More info.png
  2. STM32MP13 microprocessor part numbers
  3. 3.03.13.23.33.43.53.63.7 STM32MP15 microprocessor part numbers
  4. https://www.openembedded.org
  5. 5.05.1 The part numbers are specified in STM32MP13 microprocessor part numbers
  6. 6.06.1 The part numbers are specified in STM32MP15 microprocessor part numbers


19 Archives Archive box.png[edit]

STM32 MPU ecosystem release Ecosystem release note
STM32MP1-ecosystem-v4.1.0 STM32 MPU ecosystem release note - v4.1.0 page for the v4 ecosystem releases (in archived wiki)
STM32MP1-ecosystem-v4.0.0 STM32 MPU ecosystem release note - v4.0.0 page for the v4 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v3.1.0 STM32MP15 ecosystem release note - v3.1.0 page for the v3 ecosystem releases (in archived wiki)
STM32MP15-Ecosystem-v3.0.0 STM32MP15 ecosystem release note - v3.0.0 page for the v3 ecosystem releases (in archived wiki)