Yocto-based OpenSTLinux ecosystem release note - v6.2.0

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

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:

• Supported development boards
• Yocto-based OpenSTLinux Embedded Software
  • OpenSTLinux for all MPUs,
    • OP-TEE
    • TF-A
    • U-Boot
    • Linux kernel
  • FwST-M
    • STM32CubeMP1 (Arm® Cortex®-M4) for STM32MP15x lines ,
    • STM32CubeMP2 (Arm® Cortex®-M33 and Arm® Cortex®-M0+) for STM32MP2 series,
    • TF-M (Arm® Cortex®-M33) for STM32MP2 series

• Embedded software utilities, for all MPUs:
  • STM32DDRFW-UTIL,
  • STM32PRGFW-UTIL,
  • STM32MPUSSP-UTIL,

• 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

• Documentation
• Package repository service for OpenSTLinux distribution

2. v6.2.0 scope

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

2.1. Main changes

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

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

3. Intended audience

The targeted audience is STM32MPU customers and partners.

4. 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 software license agreement (SLA), STM32CubeMP15 licenses, and STM32CubeMP2 licenses.

5. Supported development boards

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 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 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 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 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 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 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 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 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 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 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 5-megapixel image sensor B-CAMS-IMX board Standalone Display available at distribution with Module P/N: RK043FN78H-CT661C	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 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 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

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	Cortex®-A7	Cortex®-A7	Cortex®-A35	Cortex®-A35	Cortex®-A35
FwST-M for Arm® Cortex®-M	Not applicable	Cortex®-M4	Cortex®-M33	Cortex®-M33	Cortex®-M33 Cortex®-M0
STM32DDRFW-UTIL for Arm® Cortex®-A	Cortex®-A7	Cortex®-A7	Cortex®-A35	Cortex®-A35	Cortex®-A35
STM32PRGFW-UTIL for Arm® Cortex®-A	Cortex®-A7	Cortex®-A7	Cortex®-A35	Cortex®-A35	Cortex®-A35
STM32MPUSSP-UTIL for Arm® Cortex®-A	Cortex®-A7	Cortex®-A7	Cortex®-A35	Cortex®-A35	Cortex®-A35

6.1. Yocto-based OpenSTLinux embedded software

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

6.1.1. OpenSTLinux Distribution for Arm^® Cortex^®-A

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

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

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

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

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

• 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

Refer to Yocto-based OpenSTLinux embedded software article.

10. Package repository service

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

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 :

• meta-st-stm32mp
• meta-st-openstlinux
• meta-st-stm32mp-addons

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

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

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

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