Last edited 30 minutes ago

Yocto-based OpenSTLinux ecosystem release note

Applicable for STM32MP13x lines, STM32MP15x lines, STM32MP21x lines, STM32MP23x lines, STM32MP25x lines



This article describes the content of the v6.2.0 release of the Yocto-based OpenSTLinux ecosystem, the flagship of the STM32 MPU Linux®-based ecosystems

1. Ecosystem content[edit | edit source]

The Yocto-based OpenSTLinux-ecosystem releases aim at:

  • providing a full ecosystem for the STM32 Arm® Cortex® MPUs  (STM32MP21x lines  and STM32MP2 series)
  • 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 related to those packages.

The ecosystem releases consist of:

  • Development tools, for all MPUs:
    • STM32CubeIDE,
    • STM32CubeMX,
    • Programming tools
      • STM32CubeProgrammer,
        • Keygen tool,
        • Signing tool,
        • Trusted package creator tool ,
      • STM32PRG-TOOLBOX
        • STM32PRG-TOOLBOX-DFU,
        • STM32PRG-TOOLBOX-FB

2. v6.2.0 scope[edit | edit source]

The Yocto-based OpenSTLinux-ecosystem-v6.2.0 release is dedicated to the STM32MP1 series and STM32MP2 series.

2.1. Main changes[edit | edit source]

It is a major release, based on new Linux community components version, listed in the STM32 MPU OpenSTLinux release note - v6.2.0.

This release brings also the introduction of the M33-TD flavor in mass market version for STM32MP2 series.
You can learn more on the 2 possible boot flavors, for STM32MP2 series, by reading the article How to choose the STM32MP2 boot flavor.

The main changes provided by the release are:

  • OpenSTLinux firmware utilities update
    • STM32DDRFW-UTIL V1.5.0
    • STM32MPUSSP-UTIL V1.1.0 (including STM32MP21 support)
  • OpenSTLinux BSP components update
    • STM32CubeMP2 V1.3.0
    • TF-M v2.1.3 (LTS Update)
    • TF-A v2.10.24 (LTS Update)
    • Linux Kernel 6.6.116 (LTS Update)
    • OP-TEE 4.0.0
    • U-Boot v2023.10
  • STM32MP2 series M33-TD flavor Mass Market features in FwST-M BSP
    • Secure boot
    • System reset (Request by A35)
    • System reset (request by M33)
    • TF-M core watchdog
    • External tamper protection
    • CubeFW Applications using intercommunication
    • Early panel splash screen driven by a M33 NS application
    • Starter application rework to ease porting on customer board

More information is available in detailed release notes referenced in chapters below.

2.2. Main restrictions[edit | edit source]

More information is available in detailed release notes referenced in chapters below.

3. Intended audience[edit | edit source]

The targeted audience is STM32MPU customers and partners.

4. Licensing[edit | edit source]

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), STM32CubeMP15 licenses, and STM32CubeMP2 licenses.

5. Supported development boards[edit | edit source]

This Ecosystem delivery is compatible with the following boards:

STM32MP13 boards
Boards PCBs list Main features Ordering

STM32MP135F-DK Discovery kit
  • MB1635 (motherboard)
  • MB1897 (camera module board)
  • STM32MP135FAF7[1] Rev.Y
    • Arm®-based Cortex®-A7 1 GHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1D
  • 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 Discovery kit
  • MB1272C (motherboard)
  • STM32MP157DAC1[2] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Basic security
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1A cut2.0

Discovery kit with STM32MP157D MPU


STM32MP157F-DK2 Discovery kit
  • MB1272C (motherboard)
  • MB1407B (daughterboard DSI display)
  • STM32MP157FAC1[2] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1A 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-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157DAA1[2] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Basic security
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1A 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


STM32MP157F-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157FAA1[2] Rev.Z
    • Arm®-based dual Cortex®-A7 800 MHz
    • Secure boot and cryptography
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1A 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 Discovery kit
  • MB1272C (motherboard)
  • STM32MP157AAC3[2] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Basic security
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1A cut1.2

Out of production


STM32MP157C-DK2 Discovery kit
  • MB1272C (motherboard)
  • MB1407B (daughterboard DSI display)
  • STM32MP157CAC3[2] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1A 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-EV1 Evaluation board
  • MB1262C (motherboard)
  • MB1263C (daughterboard)
  • MB1230C (daughterboard DSI display)
  • MB1379A (camera)
  • STM32MP157AAA3[2] Rev.B
    • Arm®-based dual Cortex®-A7 650 MHz
    • Basic security
    • 2 × 4-Gbit DDR3L, 16 bits, 533 MHz
  • PMIC STPMIC1A cut1.2
  • 5.5" TFT 720×1280 pixels with LED backlight, and capacitive touch panel
  • 5-megapixel, 8-bit camera

Out of production


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

Out of production


STM32MP21 boards
Boards PCBs list Main features Ordering

STM32MP215F-DK Discovery kit
  • MB2059 (main board)
  • STM32MP215FAN3[3] Rev.Z
    • Arm®-based Cortex®-A35 1500 MHz
    • Secure boot and cryptography
    • 16-Gbit LPDDR4, 16 bits, 800 MHz
  • PMIC STPMIC2L Cut1.2
  • Optional expansion boards

Discovery kit with STM32MP215F MPU


STM32MP23 boards
Important
To help you get started with the evaluation of the STM32MP23x product lines, you can rely on the STM32MP257F-DK Discovery kit, and the applicable STM32 MPU embedded software, running with the STM32MP23 software configuration (peripherals, features, and performance).


STM32MP25 boards
Boards PCBs list Main features Ordering

STM32MP257F-EV1 Evaluation board
  • MB1936 (main board)
  • STM32MP257FAI3[4] Rev.Y
    • Arm®-based dual Cortex®-A35 1500 MHz
    • Secure boot and cryptography
    • 2 x 16-Gbit DDR4, 32 bits, 1200 MHz
  • PMIC STPMIC25 Cut1.1
  • Optional expansion boards
    • LVDS WSVGA display B-LVDS7-WSVGA board
    • 5-megapixel image sensor raw Bayer B-CAMS-IMX board
    • DSI to HDMI adapter Full HD 30fps B-LCDAD-HDMI1 board

Evaluation board with STM32MP257F MPU


STM32MP257F-DK Discovery kit
  • MB1605 (main board)
  • STM32MP257FAK3[4] Rev.Y
    • Arm®-based dual Cortex®-A35 1500 MHz
    • Secure boot and cryptography
    • 32-Gbit LPDDR4, 32 bits, 1200 MHz
  • PMIC STPMIC25 Cut1.1
  • Optional expansion boards
    • LVDS WSVGA display B-LVDS7-WSVGA board
    • 5-megapixel image sensor raw Bayer B-CAMS-IMX board

Discovery kit with STM32MP257F MPU


Information
The STLINK, embedded on the boards, requires upgraded USB PC drivers: see ST-LINK article

6. Embedded software[edit | edit source]

In the table below, for each STM32 MPU device, you can find on which Cortex® the embedded software are running.

Embedded software STM32MP13x lines  STM32MP15x lines  STM32MP21x lines  STM32MP23x lines  STM32MP25x lines 
OpenSTLinux for Arm® Cortex®-A Yes Cortex®-A7 Yes Cortex®-A7 Yes Cortex®-A35 Yes Cortex®-A35 Yes Cortex®-A35
FwST-M for Arm® Cortex®-M No Not applicable Yes Cortex®-M4 Yes Cortex®-M33 Yes Cortex®-M33 Yes Cortex®-M33
Yes Cortex®-M0
STM32DDRFW-UTIL for Arm® Cortex®-A Yes Cortex®-A7 Yes Cortex®-A7 Yes Cortex®-A35 Yes Cortex®-A35 Yes Cortex®-A35
STM32PRGFW-UTIL for Arm® Cortex®-A Yes Cortex®-A7 Yes Cortex®-A7 Yes Cortex®-A35 Yes Cortex®-A35 Yes Cortex®-A35
STM32MPUSSP-UTIL for Arm® Cortex®-A Yes Cortex®-A7 Yes Cortex®-A7 Yes Cortex®-A35 Yes Cortex®-A35 Yes Cortex®-A35

6.1. Yocto-based OpenSTLinux embedded software[edit | edit source]

The Yocto-based OpenSTLinux embedded software is part of the STM32 MPU embedded software offer.
It is a set of software (see architecture overview), system build and development tools created to ease the development to be done on top of STM32 MPU devices.

Yocto-based OpenSTLinux embedded software includes:

  • a Linux® distribution, running on the Arm® Cortex®-A processor(s): OpenSTLinux distribution
  • firmwares, running on the Arm® Cortex®-M processor: FwST-M Packages (only for STM32MP15x lines  and STM32MP2 series)
  • and enriched OpenSTLinux expansion packages that can be applied on the top of the Yocto-based OpenSTLinux embedded software to enable the use of additional components for a specific feature (such as AI-based computer vision).


OpenSTLinux expansion packagesOpenSTLinux distributionFwST-M PackagesYocto-based Linux embedded software


6.1.1. OpenSTLinux Distribution for Arm® Cortex®-A[edit | edit source]

Updated openstlinux-6.6-yocto-scarthgap-mpu-v26.02.18 is the version delivered with the Yocto-based OpenSTLinux-ecosystem-v6.2.0.

The release note gives information and details about the features / content / restrictions of the OpenSTLinux Distribution.
It does not explain how to download the software. For that, refer to How to download the software and start with this release chapter.

Firmware Release note Version
OpenSTLinux Distribution STM32 MPU OpenSTLinux release note - v6.2.0 openstlinux-6.6-yocto-scarthgap-mpu-v26.02.18

6.1.2. FwST-M packages for Arm® Cortex®-M[edit | edit source]

The release notes give information and details about the features / content / restrictions of the Packages.
They do not explain how to download the software. For that, refer to How to download the software and start with this release chapter.

Firmware Release note Version
STM32CubeMP2 Package STM32CubeMP2 Package release note - v1.3.0 STM32CubeMP2 Package v1.3.0
STM32CubeMP15 Package STM32CubeMP15 Package release note - v1.7.0 STM32CubeMP1 Package v1.7.0
TF-M Package TF-M release note - v2.1.3 TF-M v2.1.3

6.1.3. OpenSTLinux expansion packages[edit | edit source]

OpenSTLinux expansion packages are delivered on top of OpenSTLinux releases. The detailed status of OpenSTLinux expansion packages is described in OpenSTLinux expansion packages article.

6.2. Embedded software utilities[edit | edit source]

The release notes give information and details about the features / content / restrictions of the Utilities.
Each release note gives information on how to flash and to use the corresponding embedded software utility/tool.

The versions mentioned in the table below are the ones with which the full ecosystem has been tested and validated.

Tools Release notes Host PC
Linux® version Windows version
STM32DDRFW-UTIL (for Arm® Cortex®-A) STM32DDRFW-UTIL release note 1.5.0 1.5.0
STM32PRGFW-UTIL (for Arm® Cortex®-A) STM32PRGFW-UTIL release note 1.2.0 1.2.0
STM32MPUSSP-UTIL (for Arm® Cortex®-A) STM32MPUSSP-UTIL_release_note 1.1.0 1.1.0

7. Development tools[edit | edit source]

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

Each release note gives information about features / content / restrictions and on how to install and use the corresponding tool.

The versions mentioned in the table below are the ones with which the full ecosystem has been tested and validated. It is highly recommended to stay on those versions even if more recent versions are available.

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 v2.1.0 v2.1.0
STM32CubeMX STM32CubeMX release note v6.17 v6.17
STM32CubeProg STM32CubeProgrammer release note v2.21 v2.21
STM32PRG-TOOLBOX-DFU STM32PRG-TOOLBOX-DFU release note v2.1.0 v2.1.0
STM32PRG-TOOLBOX-FB STM32PRG-TOOLBOX-FB release note v2.1.0 v2.1.0

8. Documentation[edit | edit source]

  • The present user guide in Wiki format provides many articles related to software,
  • The Category:STM32 MPU technical literature references all technical document provided by ST and mainly used in this wiki.

9. How to download the software and start with this release[edit | edit source]

Refer to Yocto-based OpenSTLinux embedded software article.

10. Package repository service[edit | edit source]

The package repository for the OpenSTLinux distribution contains standard Linux APT packages compatible with the OSTL distribution. This service makes it easy to enrich or update the starter packages uploaded to ST boards using standard APT commands from the board console.

  • The Package Repository Service
    • hosted at the nonbrowsable URL http://packages.openstlinux.st.com,
    • enabled by default in the Starter Package,
    • providing regularly updated or additional packages.

11. Minor release updates[edit | edit source]

STMicroelectronics regularly delivers corrections through github® components which are U-Boot, OP-TEE, TF-A , Linux kernel .


The corrections can be incorporated into the STM32MPU 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 STM32MPU 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.


12. References[edit | edit source]


13. Archives [edit | edit source]

STM32 MPU ecosystem release Ecosystem release note
STM32MPU-ecosystem-v6.1.0 STM32 MPU ecosystem release note - v6.1.0
STM32MPU-ecosystem-v6.0.0 STM32 MPU ecosystem release note - v6.0.0
STM32MPU-ecosystem-v5.1.0 STM32 MPU ecosystem release note - v5.1.0 page for the v5 ecosystem releases (in archived wiki)
STM32MP1-ecosystem-v5.0.0 STM32 MPU ecosystem release note - v5.0.0 page for the v5 ecosystem releases (in archived wiki)
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)