1. Overview[edit | edit source]
This step explains how to get the Starter Package, then install and boot the STM32MP25 Discovery kit boards with the Starter Package.
For A35-TD flavor 
- 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
, STM32MP257F-DK for STM32MP23x lines evaluation , STM32MP257x-DK and STM32MP257x-EV1
- 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
| |
|---|---|
| Download |
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
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. |
If you are interested in older releases, please have a look into the section - 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. Populate the SD card[edit | edit source]
- Set the boot switches (located on the MB1605) to the OFF position "Boot from UART/USB":
- Connect the PC to CN15/USB_DRD port of the STM32MP257F-DK mother board through the USB Type A to Type C cable.
- Power up the board.
- Press the reset button to reset the board.
- Launch STM32CubeProgrammer to get the GUI :
- On the right of the window, select USB (instead of STLINK, set by default) from the connection picklist, and click the "Refresh" button. The serial number is displayed if the USB has been detected.
- Click
Connect
For STM32MP23x lines 
- Select the
Open Filetab and choose theFlashLayout_sdcard_stm32mp235f-dk-optee.tsvin the Starter Package installation folder ($HOME/STM32MPU_workspace/STM32MPU-Ecosystem-v6.1.0/Starter-Package/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11/images/stm32mp2/flashlayout_st-image-weston/optee)
For STM32MP25x lines
- Select the
Open Filetab and choose theFlashLayout_sdcard_stm32mp257f-dk-ca35tdcid-ostl-m33-examples-optee.tsvin the Starter Package installation folder ($HOME/STM32MPU_workspace/STM32MPU-Ecosystem-v6.1.0/Starter-Package/stm32mp2-openstlinux-6.6-yocto-scarthgap-mpu-v25.06.11/images/stm32mp2/flashlayout_st-image-weston/optee)
- Fill the
Binaries Pathby browsing to the $[Starter_Pack_Path]/images/stm32mp2 folder.
- Click
Downloadto launch the flashing process. - A progress bar indicates the process progress until a completion pop-up message is displayed.
3. Boot the board[edit | edit source]
- Set the boot switches to the microSD card boot position.
- Power on the board.
- Press the
Resetbutton to reset the board. - After few seconds, the board starts and automatically goes through the following screens:
- If the board power supply does not supply enough current (< 1500 mA, with a PC USB-A typically), the power LED indicates the issue following the rules below:
Power LED status Display connected Console message Boot process Red LVDS Console stuck at : No EFI system partition Failed to persist EFI variables
Stop before autoboot Orange HDMI No particular warning Continue and orange LED stays on Orange No display No particular warning Continue and orange LED stays on
Arm® is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere. 