Last edited 2 weeks ago

STM32MP2 Starter Package - images

Applicable for STM32MP21x lines, STM32MP23x lines, STM32MP25x lines


This article provides the following information:

  • How to download and install the latest image (binaries) for STM32MP2 boards
  • Where to find the associated release note
  • Where to find the previous releases (archives)
Warning white.png Warning
To use the image efficiently, read the Starter Package article relative to your board: Category:Starter Package

1. STM32MP2-Ecosystem-v6.1.0 release for A35-TD flavor More info green.png[edit | edit source]

Warning white.png Warning
Only microSD cards SanDisk Class 10 and UHS Speed Class 1 are verified. Others are not recommended.
  • The STM32MP2 image (binaries) is delivered through one tarball file named en.FLASH-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11.tar.gz applicable to STM32MP215F-DK Info.png, STM32MP257F-DK More info green.png for STM32MP23x lines evaluation Info.png, STM32MP257x-DK More info green.png and STM32MP257x-EV1 More info green.png

  • Download and install the STM32MP2 image (binaries):

The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA0048). The detailed content licenses can be found here.

STM32MP2 Starter Package image - STM32MP2-Ecosystem-v6.1.0 release for A35-TD flavor More info green.png
Download
Warning white.png Warning
Check first here, if a minor release based on this ecosystem release v6.1.0 More info.png is already published.
If a minor release exists, replace the name of the STM32MP2 Starter Package file, used below, and in other wiki articles, by the name of file delivered with the minor release.

Go on st.com to download the STM32MP2 Starter Package image, en.FLASH-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11.tar.gz file.

Installation
cd <working directory path>/Starter-Package
  • Download the tarball file in this directory
  • Uncompress the tarball file to get the binaries for the different partitions of the image, and the Flash layout files:
tar xvf en.FLASH-stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11.tar.gz
Release note

Details of the content of this software package are available in the associated STM32 MPU OpenSTLinux release note.
Archive box.png If you are interested in older releases, please have a look into the section Archives

  • The binaries and the Flash layout files are in the <Starter Package installation directory>/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11/images/stm32mp2/ directory. The most important ones are:
stm32mp2
├── arm-trusted-firmware                                                               TF-A binaries for FSBL partitions and supported boot chains
│   ├── bl2                                                                            TF-A BL2 binary for FIP binaries creation
│   │   ├── tf-a-<board name>-<hardware security>-<boot chain>-<storage>.bin
│   │   └── [...]
│   ├── bl31                                                                           TF-A BL31 binary for FIP binaries creation
│   │   ├── debug                                                                      Debug binaries for BL31
│   │   │   ├── tf-a-bl31-<board name>-<hardware security>-<boot chain>-<storage>.elf      Debug symbol file for TF-A BL31
│   │   │   └── [...]
│   │   ├── <board name>-<hardware security>-<boot chain>-<storage>.dtb                TF-A BL31 device tree for FIP binaries creation
│   │   ├── tf-a-bl31-<board name>-<hardware security>-<boot chain>-<storage>.bin      TF-A BL31 binary for FIP binaries creation
│   │   └── [...]
│   ├── ddr                                                                            Trained DDR binary for FIP binaries creation
│   │   ├── ddr_pmu-<board name>-<hardware security>-<boot chain>-<storage>.bin
│   │   └── [...]
│   ├── debug                                                                          Debug binaries for TF-A
│   │   ├── debug-tf-a-<board name>-<hardware security>-<boot chain>-<storage>.stm32   Debug file for FSBL
│   │   ├── tf-a-bl2-<soc name>-<boot chain>-<storage>.elf                             Debug symbol file for TF-A
│   │   └── [...]
│   ├── fwconfig                                                                       TF-A device tree for FIP binaries creation
│   │   ├── <board name>-<hardware security>-fwconfig-<boot chain>-<storage>.dtb
│   │   └── [...]
│   ├── metadata.bin                                                                   Meta data binary for METADATA partition for the supported boards
│   ├── tf-a-<board name>-<hardware security>-<boot chain>-<storage>.stm32             TF-A binary for FSBL partition
│   └── [...]
├── arm-trusted-firmware-m                                                             TF-M binaries
│   ├── debug                                                                          Debug binaries for TF-M
│   │   ├── tfm-<board name>-<hardware security>_s.elf                                 Debug symbol file for TF-M
│   │   └── [...]
│   ├── tfm-<board name>-<hardware security>_s.bin                                    TF-M binary for m33 firmware as copro
│   └── [...]
├── fip                                                                                FIP binaries for FIP partitions and supported boot chains
│   ├── fip-<board name>-<hardware security>-ddr-<boot chain>-<storage>.bin            FIP binary for FIP DDR partition
│   ├── fip-<board name>-<hardware security>-<boot chain>-<storage>.bin                FIP binary for FIP partition
│   └── [...]
├── flashlayout_st-image-weston                                                        Flash layout files (description of the partitions) for the supported boot chains on supported boot devices and boards
│   ├── [...]
│   ├── extensible                                                                     Flash layout files for microSD card boot device with no userfs partition but a rootfs partition extended to microSD card size
│   │   ├── FlashLayout_sdcard_<board name>-<hardware security>-extensible.tsv         (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size
│   │   └── [...]
│   ├── fastboot                                                                       Flash layout files for flashing via fastboot with optee boot chain
│   │   ├── FlashLayout_<boot device>_<board name>-<hardware security>-fastboot.tsv   
│   │   └── [...]
│   ├── fastboot-opteemin                                                              Flash layout files for flashing via fastboot with opteemin boot chain
│   │   ├── FlashLayout_<boot device>_<board name>-<hardware security>-fastboot-opteemin.tsv   
│   │   └── [...]
│   ├── optee                                                                          Flash layout files for optee boot chain
│   │   ├── FlashLayout_<boot device>_<board name>-<hardware security>-optee.tsv
│   │   └── [...]
│   └── opteemin                                                                       Flash layout files for opteemin boot chain
│       ├── FlashLayout_<boot device>_<board name>-<hardware security>-opteemin.tsv
│       └── [...]
├── Kernel                                                                             Debug binaries for Linux kernel
│   ├── config-6.6.78                                                              Reference config file for Linux kernel
│   └── vmlinux                                                                        Image of the Linux kernel
├── optee                                                                              OPTEE-OS binaries
│   ├── debug                                                                          Debug binaries for OPTEE-OS
│   │   ├── tee-<board name>-<hardware security>-<boot chain>.elf                      Debug symbol file for OPTEE-OS
│   │   ├── tee-<board name>-<hardware security>-<boot chain>-programmer.elf           Debug symbol file for OPTEE-OS configured for usb/serial
│   │   └── [...]
│   ├── tee-header_v2-<board name>-<hardware security>-<boot chain>.bin              OPTEE-OS binary for FIP binaries creation (FIP partition)
│   ├── tee-header_v2-<board name>-<hardware security>-<boot chain>-programmer.bin   OPTEE-OS binary for FIP binaries creation (FIP-BOOT partition)
│   ├── tee-pageable_v2-<board name>-<hardware security>-<boot chain>.bin            OPTEE-OS binary for FIP binaries creation (FIP partition)
│   ├── tee-pageable_v2-<board name>-<hardware security>-<boot chain>-programmer.bin OPTEE-OS binary for FIP binaries creation (FIP-BOOT partition)
│   ├── tee-pager_v2-<board name>-<hardware security>-<boot chain>.bin               OPTEE-OS binary for FIP binaries creation (FIP partition)
│   ├── tee-pager_v2-<board name>-<hardware security>-<boot chain>-programmer.bin    OPTEE-OS binary for FIP binaries creation (FIP-BOOT partition)
│   └── [...]
├── scripts
│   └── create_sdcard_from_flashlayout.sh
├── u-boot                                                                             U-BOOT binaries
│   ├── debug                                                                          Debug binaries for U-BOOT
│   │   ├── u-boot-<soc name>-<u-boot config>.elf                                      Debug symbol file for U-BOOT
│   │   └── [...]
│   ├── configuration-<soc name>-<u-boot config>_defconfig                             Reference configuration file for U-Boot
│   ├── u-boot-nodtb-<soc name>-<u-boot config>.bin                                  U-BOOT binary for FIP binaries creation
│   ├── u-boot-<board name>-<hardware security>-<u-boot config>.dtb                    U-BOOT device tree for FIP binaries creation
│   └── [...]
├── st-image-bootfs-openstlinux-weston-stm32mp2.bootfs.ext4                            Binary for bootfs partition on eMMC and microSD card devices
├── st-image-bootfs-openstlinux-weston-stm32mp2.bootfs.manifest
├── st-image-bootfs-efi-openstlinux-weston-stm32mp2.bootfs.vfat                        Binary for bootfs for EFI partition on eMMC and microSD card devices
├── st-image-bootfs-efi-openstlinux-weston-stm32mp2.bootfs.manifest
├── st-image-userfs-openstlinux-weston-stm32mp2.userfs.ext4                            Binary for userfs partition on eMMC and microSD card devices
├── st-image-userfs-openstlinux-weston-stm32mp2.userfs.manifest
├── st-image-vendorfs-openstlinux-weston-stm32mp2.vendorfs.ext4                        Binary for vendorfs partition on eMMC and microSD card devices
├── st-image-vendorfs-openstlinux-weston-stm32mp2.vendorfs.manifest
├── st-image-weston-openstlinux-weston-stm32mp2.rootfs.ext4                            Binary for rootfs partition on eMMC and microSD card devices
├── st-image-weston-openstlinux-weston-stm32mp2.rootfs.license
├── st-image-weston-openstlinux-weston-stm32mp2.rootfs-license_content.html            License summary for all packages needed to feed all partitions
├── st-image-weston-openstlinux-weston-stm32mp2.rootfs.manifest
└── [...]

Description:

<soc name>:
* stm32mp21
* stm32mp23
* stm32mp25
<board name>:
* stm32mp215-df, stm32mp235f-dk, stm32mp257f-dk, stm32mp257f-ev1
<hardware security>:
* if nothing declared then there is a minimal hardware configuration for RIFF profile OPEN
* ca35tdcid-ostl                 custom hardware configuration (can be different following use-case and hardware) for RIFF profile  CUSTOM (CLOSED)
* ca35tdcid-ostl-m33-examples    custom hardware configuration (can be different following use-case and hardware) for RIFF profile CUSTOM (CLOSED)
<boot chain>:
* fastboot                  optee boot chain for flashing via fastboot
* fastboot-opteemin         opteemin boot chain for flashing via fastboot
* optee                     optee boot chain
* opteemin                  opteemin boot chain
<storage>:
* emmc                            eMMC storage
* nand                            NAND storage
* nor                             NOR storage
* programmer-uart                 storage programmation via UART
* programmer-usb                  storage programmation via USB
* sdcard                          microSD card storage
<boot device>:
* emmc                            boot via emmc storage
* nand-4-256-1024 (nand-x-y-z)    boot via nand storage
* nand-4-256-1024-sdcard          boot via nand storage for first stage (fsbl, fip) and files system are located on sdcard
* nor                             boot via nor storage
* nor-sdcard                      boot via nor storage for first stage (fsbl, fip) and files system are located on sdcard
* sdcard                          boot via sdcard storage
* sdcard-EFI                      boot via sdcard but bootfs is configurated on EFI
<u-boot config>:
* default
* fastboot-emmc             Fastboot config enabled with MMC_DEV Id for emmc
* fastboot-sdcard           Fastboot config enabled with MMC_DEV Id for sdcard
* programmer                Programmer config enabled


2. STM32MP2-Ecosystem-v6.1.0 release for M33-TD flavor More info green.png[edit | edit source]

Warning white.png Warning
Only microSD cards SanDisk Class 10 and UHS Speed Class 1 are verified. Others are not recommended.
  • The STM32MP2 image (binaries) is delivered through one tarball file named en.FLASH-stm32mp2-m33td-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11.tar.gz applicable to STM32MP215F-DK Info.png and STM32MP257x-EV1 More info green.png

  • Download and install the STM32MP2 image (binaries):

The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA0048). The detailed content licenses can be found here.

STM32MP2 Starter Package image - STM32MP2-Ecosystem-v6.1.0 release for M33-TD flavor More info green.png
Download
Warning white.png Warning
Check first here, if a minor release based on this ecosystem release v6.1.0 More info.png is already published.
If a minor release exists, replace the name of the STM32MP2 Starter Package file, used below, and in other wiki articles, by the name of file delivered with the minor release.

Go on st.com to download the STM32MP2 Starter Package image, en.FLASH-stm32mp2-m33td-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11.tar.gz file.

Installation
cd <working directory path>/Starter-Package
  • Download the tarball file in this directory
  • Uncompress the tarball file to get the binaries for the different partitions of the image, and the Flash layout files:
tar xvf en.FLASH-stm32mp2-m33td-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11.tar.gz
Release note

Details of the content of this software package are available in the associated STM32 MPU OpenSTLinux release note.
Archive box.png If you are interested in older releases, please have a look into the section Archives

  • The binaries and the Flash layout files are in the <Starter Package installation directory>/stm32mp2-m33td-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11/images/stm32mp2-m33td/ directory. The most important ones are:


stm32mp2-m33td
├── arm-trusted-firmware                                                                    TF-A binaries for FSBLa partitions and supported boot chains
│   ├── bl2                                                                                 TF-A BL2 binary for FIP binaries creation
│   │   ├── tf-a-<board name>-<hardware security>-<boot chain>-<storage>.bin
│   │   └── [...]
│   ├── bl31                                                                                TF-A BL31 binary for FIP binaries creation
│   │   ├── debug                                                                           Debug binaries for BL31
│   │   │   ├── tf-a-bl31-<board name>-<hardware security>-<boot chain>-<storage>.elf           Debug symbol file for TF-A BL31
│   │   │   └── [...]
│   │   ├── <board name>-<hardware security>-<boot chain>-<storage>.dtb                     TF-A BL31 device tree for FIP binaries creation
│   │   ├── tf-a-bl31-<board name>-<hardware security>-<boot chain>-<storage>.bin           TF-A BL31 binary for FIP binaries creation
│   │   └── [...]
│   ├── ddr                                                                                 Trained DDR binary for FIP binaries creation
│   │   ├── ddr_pmu-<board name>-<hardware security>-<boot chain>-<storage>.bin
│   │   └── [...]
│   ├── debug                                                                               Debug binaries for TF-A
│   │   ├── debug-tf-a-<board name>-<hardware security>-<boot chain>-<storage>.stm32        Debug file for FSBL
│   │   ├── tf-a-bl2-<soc name>-<boot chain>-<storage>.elf                                  Debug symbol file for TF-A
│   │   └── [...]
│   ├── fwconfig                                                                            TF-A device tree for FIP binaries creation
│   │   ├── <board name>-<hardware security>-fwconfig-<boot chain>-<storage>.dtb
│   │   └── [...]
│   ├── metadata.bin                                                                        Meta data binary for METADATA partition for the supported boards
│   ├── tf-a-<board name>-<hardware security>-<boot chain>-<storage>.stm32                  TF-A binary for FSBL partition
│   └── [...]
├── arm-trusted-firmware-m                                                                  TF-M binaries for FSBLm partitions and supported boot chains
│   ├── debug                                                                               Debug binaries for TF-M
│   │   ├── debug-bl2-<board name>-<hardware security>.stm32                                Debug file for FSBLm
│   │   ├── tfm-<board name>-<hardware security>-<storage m33>-<storage a35>_s.elf          Debug symbol file for TF-M
│   │   └── [...]
│   ├── key                                                                                 Security key used by TF-M
│   │   ├── image_ns_signing_public_key-<board name>-<hardware security>-<storage m33>.pem
│   │   ├── image_s_signing_private_key-<board name>-<hardware security>-<storage m33>.pem
│   │   ├── image_s_signing_public_key-<board name>-<hardware security>-<storage m33>.pem
│   │   └── [...]
│   ├── bl2-<board name>-<hardware security>-<storage m33>.stm32                            TF-M binary for FSBLm partition
│   ├── ddr_phy_signed-<board name>-<hardware security>-<storage m33>.bin                   TF-M binary for M33ddr partition
│   └── [...]
├── arm-trusted-firmware-m-cube                                                             TF-M/CubeMp2 binaries for M33FW partitions and supported boot chains
│   ├── debug                                                                               Debug binaries for TF-M/CubeMp2
│   │   ├── tfm-starterapp-<board name>-<hardware security>-<storage m33>-<storage a35>_CM33_NonSecure.elf                                       Debug symbol file for TF-m/CubeMp2
│   │   └── [...]
│   ├── tf-m-starterapp-<board name>-<hardware security>-<storage m33>-<storage a35>_s_ns.bin  TF-M/CubeMP2 binary for M33FW partition
│   └── [...]
├── fip                                                                                     FIP binaries for FIP partitions and supported boot chains
│   ├── fip-<board name>-<hardware security>-ddr-<boot chain>-<storage>.bin                 FIP binary for FIP DDR partition
│   ├── fip-<board name>-<hardware security>-<boot chain>-<storage>.bin                     FIP binary for FIP partition
│   └── [...]
├── flashlayout_st-image-weston                                                             Flash layout files (description of the partitions) for the supported boot chains on supported boot devices and boards
│   ├── [...]
│   ├── extensible                                                                          Flash layout files for microSD card boot device with no userfs partition but a rootfs partition extended to microSD card size
│   │   ├── FlashLayout_sdcard_<board name>-<hardware security>-extensible.tsv              (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size
│   │   └── [...]
│   └── optee                                                                               Flash layout files for optee boot chain
│       ├── FlashLayout_<boot device>_<board name>-<hardware security>-optee.tsv
│       └── [...]
├── Kernel                                                                                   Debug binaries for Linux kernel
│   ├── config-6.6.78                                                                    Reference config file for Linux kernel
│   └── vmlinux                                                                              Image of the Linux kernel
├── optee                                                                                    OPTEE-OS binaries
│   ├── debug                                                                                Debug binaries for OPTEE-OS
│   │   ├── tee-<board name>-<hardware security>-<boot chain>.elf                            Debug symbol file for OPTEE-OS
│   │   ├── tee-<board name>-<hardware security>-<boot chain>-programmer.elf                 Debug symbol file for OPTEE-OS configured for usb/serial
│   │   └── [...]
│   ├── tee-header_v2-<board name>-<hardware security>-<boot chain>.bin                    OPTEE-OS binary for FIP binaries creation (FIP partition)
│   ├── tee-header_v2-<board name>-<hardware security>-<boot chain>-programmer.bin         OPTEE-OS binary for FIP binaries creation (FIP-BOOT partition)
│   ├── tee-pageable_v2-<board name>-<hardware security>-<boot chain>.bin                  OPTEE-OS binary for FIP binaries creation (FIP partition)
│   ├── tee-pageable_v2-<board name>-<hardware security>-<boot chain>-programmer.bin       OPTEE-OS binary for FIP binaries creation (FIP-BOOT partition)
│   ├── tee-pager_v2-<board name>-<hardware security>-<boot chain>.bin                     OPTEE-OS binary for FIP binaries creation (FIP partition)
│   ├── tee-pager_v2-<board name>-<hardware security>-<boot chain>-programmer.bin          OPTEE-OS binary for FIP binaries creation (FIP-BOOT partition)
│   └── [...]
├── scripts
│   └── create_sdcard_from_flashlayout.sh
├── u-boot                                                                                   U-BOOT binaries
│   ├── debug                                                                                Debug binaries for U-BOOT
│   │   ├── u-boot-<soc name>-<u-boot config>.elf                                            Debug symbol file for U-BOOT
│   │   └── [...]
│   ├── configuration-<soc name>_defconfig                                                   Reference configuration file for U-Boot
│   ├── u-boot-nodtb-<soc name>-<u-boot config>.bin                                        U-BOOT binary for FIP binaries creation
│   ├── u-boot-<board name>-<hardware security>-<u-boot config>.dtb                          U-BOOT device tree for FIP binaries creation
│   └── [...]
├── st-image-bootfs-openstlinux-weston-stm32mp2-m33td.bootfs.ext4                            Binary for bootfs partition on eMMC and microSD card devices
├── st-image-bootfs-openstlinux-weston-stm32mp2-m33td.bootfs.manifest
├── st-image-userfs-openstlinux-weston-stm32mp2-m33td.userfs.ext4                            Binary for userfs partition on eMMC and microSD card devices
├── st-image-userfs-openstlinux-weston-stm32mp2-m33td.userfs.manifest
├── st-image-vendorfs-openstlinux-weston-stm32mp2-m33td.vendorfs.ext4                        Binary for vendorfs partition on eMMC and microSD card devices
├── st-image-vendorfs-openstlinux-weston-stm32mp2-m33td.vendorfs.manifest
├── st-image-weston-openstlinux-weston-stm32mp2-m33td.rootfs.ext4                            Binary for rootfs partition on eMMC and microSD card devices
├── st-image-weston-openstlinux-weston-stm32mp2-m33td.rootfs.license
├── st-image-weston-openstlinux-weston-stm32mp2-m33td.rootfs-license_content.html            License summary for all packages needed to feed all partitions
├── st-image-weston-openstlinux-weston-stm32mp2-m33td.rootfs.manifest
└── [...]

Description:

<soc name>:
* stm32mp21
* stm32mp25
<board name>:
* stm32mp215-df, stm32mp257f-ev1
<hardware security>:
* if nothing declared then there is a minimal hardware configuration for RIFF profile OPEN
* cm33tdcid-ostl                     custom hardware configuration (can be different following use-case and hardware) for RIFF profile  CUSTOM (CLOSED)
* cm33tdcid-ostl-serial-ca35tdcid    specific configuration used for programmation
<boot chain>:
* optee                     optee boot chain
<storage>:
* emmc                            eMMC storage
* nor                             NOR storage
* programmer-uart                 storage programmation via UART
* programmer-usb                  storage programmation via USB
* sdcard                          microSD card storage
<storage a35>:
* emmc                            eMMC storage
* nor                             NOR storage
* sdcard                          microSD card storage
<storage m33>:
* emmc                            eMMC storage
* nor                             NOR storage
* sdcard                          microSD card storage
<boot device>:
* emmc                            boot Cortex M33 via emmc storage and Cortex A35 via emmc storage
* nor-emmc                        boot Cortex M33 via nor storage and Cortex A35 via emmc storage
* nor-nor-sdcard                  boot Cortex M33 via nor storage and Cortex A35 via nor storage for first stage (fsbl, fip) and files system are located on sdcard storage
* nor-sdcard                      boot Cortex M33 via nor storage and Cortex A35 via sdcard
* sdcard                          boot Cortex M33 via sdcard storage and Cortex A35 via sdcard storage
<u-boot config>:
* default
* programmer                Programmer config enabled



3. Archives Archive box.png[edit | edit source]

This wiki is for the v6 ecosystem releases. For information about the previous ecosystem releases, go through the Wiki archives.