Last edited 2 days ago

Yocto-based OpenSTLinux ecosystem release note

(Redirected from STM32 MPU ecosystem release note)
Applicable for STM32MP13x lines, STM32MP15x lines, STM32MP21x lines, STM32MP23x lines, STM32MP25x lines


This article describes the content of the v6.2.1 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 
  • 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.1 scope[edit | edit source]

The Yocto-based OpenSTLinux-ecosystem-v6.2.1 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.1.

This release brings mainly fixes and improvements for M33-TD flavor 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:

  • STM32MP2 series M33-TD flavor features in FwST-M BSP
    • New low power modes support (standby2, LPLV stop2)
    • Platform shutdown
    • A35 independent reboot (in case of crash)
    • Single boot device firmware update
    • Dual boot device firmware update
    • CES / EWC demonstrations
    • SBOM in cycloneDX format, available at Starter package root and also under github (https://github.com/STMicroelectronics/oe-manifest.git)
    • Various fixes


  • OpenSTLinux BSP components updates
    • Linux kernel v6.6-stm32mp-r3.1 (LTS v6.6.129)
    • TF-A v2.10-stm32mp-r3.1 (LTS v2.10.24)
    • U-Boot v2023.10-stm32mp-r3.1
    • OP-TEE 4.0.0-stm32mp-r3.1
    • External DT v6-stm32mp-r3.1
    • STM32CubeMP2 Package v1.3.1
    • TF-M v2.1.4-stm32mp-r2.1 (LTS v2.1.4)
  • OpenSTLinux build process components updates
    • OpenEmbedded v5.0.17 (Scarthgap)
    • GCC version v13.4.0
  • OpenSTLinux firmware utilities update
    • STM32DDRFW-UTIL V1.6.0
      • Add DMA stress tests
      • Add VREF print command
      • Various fixes
  • Development tools updates
    • STM32CubeIDE 2.2.0 (alignment with OpenSTLinux v6.2.1)
    • STM32CubeMX 6.18 (alignment with OpenSTlinux v6.2.1)
    • STM32CubeProgrammer v2.23 (alignment with OpenSTlinux v6.2.1)
    • STM32PRG-TOOLBOX-DFU 2.2.0 (fixes and feature enhancements)
    • STM32PRG-TOOLBOX-FB 2.2.0 (fixes and feature enhancements)

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

2.2. Main restrictions[edit | edit source]

No major restriction. 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


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.06.10 is the version delivered with the Yocto-based OpenSTLinux-ecosystem-v6.2.1.

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.1 openstlinux-6.6-yocto-scarthgap-mpu-v26.06.10

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.1 STM32CubeMP2 Package v1.3.1
STM32CubeMP15 Package STM32CubeMP15 Package release note - v1.7.0 STM32CubeMP1 Package v1.7.0
TF-M Package TF-M release note - v2.1.4 TF-M v2.1.4

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.6.0 1.6.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.2.0 v2.2.0 ☐ ☑ ☐
STM32CubeMX STM32CubeMX release note v6.18 v6.18 ☐ ☑ ☑
STM32CubeProg STM32CubeProgrammer release note v2.23 v2.23 ☑ ☐ ☑
STM32PRG-TOOLBOX-DFU STM32PRG-TOOLBOX-DFU release note v2.2.0 v2.2.0 ☑ ☑ ☑
STM32PRG-TOOLBOX-FB STM32PRG-TOOLBOX-FB release note v2.2.0 v2.2.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]

  1. ↑ STM32MP13 microprocessor part numbers
  2. ↑ 2.0 2.1 2.2 2.3 STM32MP15 microprocessor part numbers
  3. ↑ STM32MP21 microprocessor part numbers
  4. ↑ 4.0 4.1 STM32MP25 microprocessor part numbers

13. Archives [edit | edit source]

Yocto-based OpenSTLinux ecosystem release Ecosystem release note
Yocto-based OpenSTLinux ecosystem-v6.2.0 Yocto-based OpenSTLinux ecosystem release note - v6.2.0
Yocto-based OpenSTLinux ecosystem-v6.1.0 STM32 MPU ecosystem release note - v6.1.0
Yocto-based OpenSTLinux 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)


Microprocessor unit

Linux® is a registered trademark of Linus Torvalds.

Arm® is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

Cortex®

Open portable trusted execution environment

Trusted firmware for Arm® Cortex®-A (see TF-A)

Das U-Boot -- the universal boot loader (see U-Boot)

Trusted firmware for Arm® Cortex®-M (see TF-M) - NEW

Device firmware upgrade

Frame buffer (could be the Kernel framebuffer linked to the display, a GPU framebuffer, an imaging framebuffer...)

Arm® Cortex®-M33 trusted domain

Board support package

Device tree

Direct memory access

Power management integrated circuit

Light-emitting diode

MIPI camera serial interface 2 (MIPI® Alliance standard)

Flexible flat cable

Technology for wireless local area networking with devices based on the IEEE 802.11 standards

Display serial interface (MIPI® Alliance standard)

Low-voltage differential signaling (related to display interfaces) - NEW

High-definition multimedia interface (HDMI standard)

Artificial intelligence

Advanced package tool (see https://wiki.debian.org/Apt)

Microprocessor unit

Linux® is a registered trademark of Linus Torvalds.

Arm® is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

Cortex®

Open portable trusted execution environment

Trusted firmware for Arm® Cortex®-A (see TF-A)

Das U-Boot -- the universal boot loader (see U-Boot)

Trusted firmware for Arm® Cortex®-M (see TF-M) - NEW

Device firmware upgrade

Frame buffer (could be the Kernel framebuffer linked to the display, a GPU framebuffer, an imaging framebuffer...)

Arm® Cortex®-M33 trusted domain

Board support package

Device tree

Direct memory access

Power management integrated circuit

Light-emitting diode

MIPI camera serial interface 2 (MIPI® Alliance standard)

Flexible flat cable

Technology for wireless local area networking with devices based on the IEEE 802.11 standards

Display serial interface (MIPI® Alliance standard)

Low-voltage differential signaling (related to display interfaces) - NEW

High-definition multimedia interface (HDMI standard)

Artificial intelligence

Advanced package tool (see https://wiki.debian.org/Apt)

Graphics processing units

Mobile industry processor interface, open membership organization that includes leading companies in the mobile industry that share the objective of defining and promoting open specifications for interfaces inside mobile terminals, see MIPI® Alliance standard web site https://www.mipi.org

Retrieved from "https://wiki.st.com/stm32mpu/index.php?title=Yocto-based_OpenSTLinux_ecosystem_release_note&oldid=127542"