Populate the target and boot the image

Applicable for STM32MP15x lines

STM32MP157X-DK2.png
Let's start Develop on Arm® Cortex®-A7
Step category in.png Unpack the board Step.png Populate the target and boot the image Step.png Execute basic commands Step.png Use the demo launcher Step category out.png


1. Overview[edit | edit source]

This step explains how to get the Starter Package, then install and boot the STM32MP15 Discovery kit with the Starter Package.


2. Open a terminal[edit | edit source]

Open a terminal on the host computer.

Ubuntu terminal

All the commands preceded by have to be executed from the host computer terminal.

  • Create your STM32MPU workspace directory on the host computer:
 mkdir $HOME/STM32MPU_workspace
 cd $HOME/STM32MPU_workspace

3. Check the host computer Internet access[edit | edit source]

  • An Internet access through http and https protocols must be provided.

The command below enables checking for Internet access through http/https protocols:

 wget -q www.google.com && echo "Internet access over HTTP/HTTPS is OK !" || echo "No internet access over HTTP/HTTPS ! You may need to set up a proxy."

If an 'OK' message is returned, the network is correctly configured.
In this case, skip the rest of this section.

Otherwise, a proxy for http/https protocols is required.
The best solution is to set this proxy through the shell variables http_proxy and https_proxy:

 export http_proxy=http://<MyProxyLogin>:<MyProxyPassword>@<MyProxyServerUrl>:<MyProxyPort>
 export https_proxy=http://<MyProxyLogin>:<MyProxyPassword>@<MyProxyServerUrl>:<MyProxyPort>

Check again the Internet access using the command:

 wget -q www.google.com && echo "Internet access over HTTP/HTTPS is OK !" || echo "No internet access over HTTP/HTTPS ! You may need to set up a proxy."

4. Install the tools[edit | edit source]

4.1. STM32CubeProgrammer[edit | edit source]

  • Create your "STM32MPU tools" directory on the host computer:
 mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools
 mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z
  • Create a temporary directory in your STM32MPU workspace:
 mkdir $HOME/STM32MPU_workspace/tmp
 cd $HOME/STM32MPU_workspace/tmp


4.2. Installing the STM32CubeProgrammer tool[edit | edit source]

STM32CubeProgrammer for Linux® host PC STM32CubeProgrammer for Windows® host PC
Download
  • Go on st.com to download the STM32CubeProgrammer software

Version v2.17.0

  • Download the archive file on your host PC in a temporary directory
  • Uncompress the archive file to get the STM32CubeProgrammer installers:


unzip en.stm32cubeprog.zip

Installation
  • Execute the Linux installer, which guides you through the installation process.
$> ./SetupSTM32CubeProgrammer-2.17.0.linux
  • The path to the STM32CubeProgrammer binary must be added to the PATH environment variable
    • either in each Terminal program in which the STM32CubeProgrammer binary needs to be used, using the following command:
$> export PATH=<my STM32CubeProgrammer install directory>/bin:$PATH
  • or once for all by creating a link to the STM32CubeProgrammer binary in a directory already present in PATH. For example, if "/home/bin" is in the PATH environment variable, run the following command:
$> ln -s <my STM32CubeProgrammer install directory>/bin/STM32_Programmer_CLI /home/bin/STM32_Programmer_CLI
  • Execute the Windows installer, which guides you through the installation process.
User manual
Detailed release note
  • Details about the content of this tool version are available from ST web site at Release Note .


4.3. Preparing the USB serial link for flashing[edit | edit source]

It is recommended to use the USB (in DFU mode) for flashing rather than the UART, which is too slow.

Below indications on how to install the USB in DFU mode under Linux and Windows OS, respectively.

  • For Linux host PC or Windows host PC with VMWare:

The libusb1.0 package (including USB DFU mode) must be installed to be able to connect to the board via the USB port. This is achieved by typing the following command from the host PC terminal:

 sudo apt-get install libusb-1.0-0

To allow STM32CubeProgrammer to access the USB port through low-level commands, proceed as follows:

 cd <your STM32CubeProgrammer install directory>/Drivers/rules 
sudo cp *.* /etc/udev/rules.d/
  • For Windows host PC:

Run the “STM32 Bootloader.bat” file to install the STM32CubeProgrammer DFU driver and activate the STM32 microprocessor device in USB DFU mode. This driver (installed by STM32 Bootloader.bat) is provided within the STM32CubeProgrammer release package. It is located in the DFU driver folder, \Drivers\DFU_Driver.

In case of issue, refer to How to proceed when the DFU driver installation fails on Windows host PC.

To validate the installation, the DFU driver functionality can be verified by following the FAQ instructions provided in how to check if the DFU driver is functional.


5. Test[edit | edit source]

  • Check that the STM32CubeProgrammer tool is properly installed and accessible:
 STM32_Programmer_CLI --h
     -------------------------------------------------------------------
                       STM32CubeProgrammer vx.y.z                  
     -------------------------------------------------------------------

6. Download the image[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 STM32MP1 image (binaries) is delivered through one tarball file named
    • en.FLASH-stm32mp1-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26.tar.gz for STM32MP135x-DK More info green.png, STM32MP157x-DKx More info green.png and STM32MP157x-EV1 More info green.png

  • Download and install the STM32MP1 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.

STM32MP1 Starter Package image - STM32MP1-Ecosystem-v5.1.0 release
Download
  • Go on st.com to download the STM32MP1 Starter Package image, en.FLASH-stm32mp1-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26.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-stm32mp1-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26.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>/stm32mp1-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26/images/stm32mp1/ directory:
stm32mp1
├── arm-trusted-firmware                       TF-A binaries for FSBL partitions and supported boot chains
│   ├── metadata.bin                           Meta data binary for METADATA partition for the supported boards
│   ├── tf-a-stm32mp135f-dk-optee-sdcard.stm32       TF-A binary for FSBL partition (microSD card boot device) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── tf-a-stm32mp135f-dk-uart.stm32         TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── tf-a-stm32mp135f-dk-usb.stm32          TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── tf-a-stm32mp157a-dk1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157a-dk1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157a-dk1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157a-ev1-optee-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-optee-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-optee-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-optee-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157a-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-dk2-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157c-dk2-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157c-dk2-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157c-ed1-optee-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ed1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ed1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ed1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157c-ev1-optee-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-optee-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-optee-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157c-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-dk1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157d-dk1-uart.stm32        TF-A binary for serial boot mode (STM32CubeProgrammer) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157d-dk1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157d-ev1-optee-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-optee-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157d-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-dk2-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157f-dk2-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157f-dk2-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── tf-a-stm32mp157f-ed1-optee-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ed1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ed1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ed1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── tf-a-stm32mp157f-ev1-optee-emmc.stm32        TF-A binary for FSBL partition (eMMC boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-optee-nand.stm32        TF-A binary for FSBL partition (NAND boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-optee-nor.stm32         TF-A binary for FSBL partition (NOR boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-optee-sdcard.stm32      TF-A binary for FSBL partition (microSD card boot device) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   ├── tf-a-stm32mp157f-ev1-uart.stm32        TF-A binary for uart serial boot mode (STM32CubeProgrammer) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│   └── tf-a-stm32mp157f-ev1-usb.stm32         TF-A binary for usb serial boot mode (STM32CubeProgrammer) for STM32MP157F-EV1 → STM32MP15 Evaluation boards
├── fip                                     FIP binaries for FIP partitions and supported boot chains
│   ├── fip-stm32mp135f-dk-fastboot-sdcard.bin        FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── fip-stm32mp135f-dk-optee-sdcard.bin           FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP135F-DK → STM32MP13 Discovery kits
│   ├── fip-stm32mp157a-dk1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157a-dk1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157a-ev1-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157a-ev1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157a-ev1-optee-emmc.bin            FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157a-ev1-optee-nand.bin            FIP binary for FIP partition (optee boot chain for nand) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157a-ev1-optee-nor.bin             FIP binary for FIP partition (optee boot chain for nor) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157a-ev1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-dk2-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157c-dk2-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157c-dk2-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157c-ed1-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157c-ed1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157c-ed1-optee-emmc.bin            FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157c-ed1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157c-ev1-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-ev1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-ev1-optee-emmc.bin            FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-ev1-optee-nand.bin            FIP binary for FIP partition (optee boot chain for nand) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-ev1-optee-nor.bin             FIP binary for FIP partition (optee boot chain for nor) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157c-ev1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-dk1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157d-dk1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157d-ev1-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-ev1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-ev1-optee-emmc.bin            FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-ev1-optee-nand.bin            FIP binary for FIP partition (optee boot chain for nand) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-ev1-optee-nor.bin             FIP binary for FIP partition (optee boot chain for nor) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157d-ev1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│   ├── fip-stm32mp157f-dk2-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157f-dk2-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── fip-stm32mp157f-ed1-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ed1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ed1-optee-emmc.bin            FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ed1-optee-nand.bin            FIP binary for FIP partition (optee boot chain for nand) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ed1-optee-nor.bin             FIP binary for FIP partition (optee boot chain for nor) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ed1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ev1-fastboot-emmc.bin         FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ev1-fastboot-sdcard.bin       FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ev1-optee-emmc.bin            FIP binary for FIP partition (optee boot chain for emmc) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ev1-optee-nand.bin            FIP binary for FIP partition (optee boot chain for nand) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   ├── fip-stm32mp157f-ev1-optee-nor.bin             FIP binary for FIP partition (optee boot chain for nor) for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│   └── fip-stm32mp157f-ev1-optee-sdcard.bin          FIP binary for FIP partition (optee boot chain for sdcard) for STM32MP157F-EV1 → STM32MP15 Evaluation daughter boards
├── 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_stm32mp135f-dk-optee.tsv         (recommended setup for package repository service) microSD card boot device for STM32MP135F-DK → STM32MP13 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157a-dk1-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157A-DK1 → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157c-dk2-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157C-DK2 → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157d-dk1-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157D-DK1 → STM32MP15 Discovery kits
│   │   └── FlashLayout_sdcard_stm32mp157f-dk2-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP157F-DK2 → STM32MP15 Discovery kits
│   ├── fastboot                                      Flash layout files for flashing via fastboot
│   │   ├── FlashLayout_emmc_stm32mp157a-ev1-fastboot.tsv       eMMC boot device for STM32MP157A-EV1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_emmc_stm32mp157c-ed1-fastboot.tsv       eMMC boot device for STM32MP157C-ED1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_emmc_stm32mp157c-ev1-fastboot.tsv       eMMC boot device for STM32MP157C-ED1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_emmc_stm32mp157d-ev1-fastboot.tsv       eMMC boot device for STM32MP157D-ED1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_emmc_stm32mp157f-ed1-fastboot.tsv       eMMC boot device for STM32MP157F-ED1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_emmc_stm32mp157f-ev1-fastboot.tsv       eMMC boot device for STM32MP157F-EV1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp135f-dk-fastboot.tsv      microSD card boot device for STM32MP135F-DK → → STM32MP13 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157a-dk1-fastboot.tsv     microSD card boot device for STM32MP157F-DK1 → → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157a-ev1-fastboot.tsv     microSD card boot device for STM32MP157A-EV1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp157c-dk2-fastboot.tsv     microSD card boot device for STM32MP157C-DK2 → → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157c-ed1-fastboot.tsv     microSD card boot device for STM32MP157C-ED1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp157c-ev1-fastboot.tsv     microSD card boot device for STM32MP157C-EV1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp157d-dk1-fastboot.tsv     microSD card boot device for STM32MP157D-DK1 → → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157d-ev1-fastboot.tsv     microSD card boot device for STM32MP157D-ED1 → → STM32MP15 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp157f-dk2-fastboot.tsv     microSD card boot device for STM32MP157F-DK2 → → STM32MP15 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp157f-ed1-fastboot.tsv     microSD card boot device for STM32MP157F-ED1 → → STM32MP15 Evaluation kits
│   │   └── FlashLayout_sdcard_stm32mp157f-ev1-fastboot.tsv     microSD card boot device for STM32MP157F-EV1 → → STM32MP15 Evaluation kits
│   └── optee                                                   Flash layout files for optee boot chain
│       ├── FlashLayout_emmc_stm32mp157a-ev1-optee.tsv          eMMC boot device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_emmc_stm32mp157c-ed1-optee.tsv          eMMC boot device for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│       ├── FlashLayout_emmc_stm32mp157c-ev1-optee.tsv          eMMC boot device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_emmc_stm32mp157d-ev1-optee.tsv          eMMC boot device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_emmc_stm32mp157f-ed1-optee.tsv          eMMC boot device for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│       ├── FlashLayout_emmc_stm32mp157f-ev1-optee.tsv          eMMC boot device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157a-ev1-optee.tsv    NAND boot device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv    NAND boot device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157d-ev1-optee.tsv    NAND boot device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nand-4-256_stm32mp157f-ev1-optee.tsv    NAND boot device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157a-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157d-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp157f-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp135f-dk-optee.tsv         (recommended setup) microSD card boot device for STM32MP135F-DK → STM32MP13 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv        microSD card boot device for STM32MP157A-DK1 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157a-ev1-optee.tsv        microSD card boot device for STM32MP157A-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv        microSD card boot device for STM32MP157C-DK2 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157c-ed1-optee.tsv        microSD card boot device for STM32MP157C-ED1 → STM32MP15 Evaluation daughter boards
│       ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv        microSD card boot device for STM32MP157C-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp157d-dk1-optee.tsv        microSD card boot device for STM32MP157D-DK1 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157d-ev1-optee.tsv        microSD card boot device for STM32MP157D-EV1 → STM32MP15 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp157f-dk2-optee.tsv        microSD card boot device for STM32MP157F-DK2 → STM32MP15 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp157f-ed1-optee.tsv        microSD card boot device for STM32MP157F-ED1 → STM32MP15 Evaluation daughter boards
│       └── FlashLayout_sdcard_stm32mp157f-ev1-optee.tsv        microSD card boot device for STM32MP157F-EV1 → STM32MP15 Evaluation boards
├── scripts
│   └── create_sdcard_from_flashlayout.sh
├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4                            Binary for bootfs partition on eMMC and microSD card devices
├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
├── st-image-userfs-openstlinux-weston-stm32mp1.ext4                            Binary for userfs partition on eMMC and microSD card devices
├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
├── st-image-vendorfs-openstlinux-weston-stm32mp1.ext4                          Binary for vendorfs partition on eMMC and microSD card devices
├── st-image-vendorfs-openstlinux-weston-stm32mp1.manifest
├── st-image-weston-openstlinux-weston-stm32mp1.ext4                            Binary for rootfs partition on eMMC and microSD card devices
├── st-image-weston-openstlinux-weston-stm32mp1.license
├── st-image-weston-openstlinux-weston-stm32mp1-license_content.html            License summary for all packages needed to feed all partitions
├── st-image-weston-openstlinux-weston-stm32mp1.manifest
└── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi      Binary for bootfs, vendorfs, rootfs and userfs partitions on NAND device


7. Populate the SD card[edit | edit source]

  • Set the boot switches (located at the back of the board) to the OFF position.
boot switches position to flash the board
  • Connect the PC to the CN7/USB_OTG port of the STM32MP157x-DK2 board through the USB Type A to Type C cable.
  • Power on the board.
  • Press the reset button to reset the board.
  • Launch STM32CubeProgrammer to get the GUI:
STM32CubeProgrammer GUI
  • On the right of the window, select USB (instead of STLINK, set by default) in the connection picklist and click the "Refresh" button. The serial number is displayed if the USB is detected. Then click "Connect".
Select USB for connection with board


  • Select the "Open File" tab and choose the "FlashLayout_sdcard_stm32mp157x-dk2-optee.tsv" file in the Starter Package installation folder ("$HOME/STM32MPU_workspace/STM32MPU-Ecosystem-v5.1.0/Starter-Package/stm32mp1-openstlinux-6.1-yocto-mickledore-mpu-v24.06.26/images/stm32mp1/flashlayout_st-image-weston/optee"")


  • Fill the "Binaries Path" by browsing to the $[Starter_Pack_Path]/images/stm32mp1 folder.
open .tsv and fill Binaries Path
  • Click "Download" to start the flashing process.
  • A progress bar indicates the process progress until a completion pop-up message is displayed.

8. Boot the board[edit | edit source]

  • Set the boot switches (located at the back of the board) to the ON position:
boot switches position to boot the board
  • Power on the board.
  • Press the "Reset "button to reset the board.
  • After few seconds, the board starts and automatically goes through the following screens
Warning white.png Warning
The very first boot after flashing takes about 2 minutes so be patient. It takes less than 20 seconds afterwards.
UBoot splash screen
Linux splash screen
Weston desktop
GTK demo launcher
  • If the board power supply does not supply enough current (3A), the red LED indicates the issue following the rules below:
LED blinking mode Console message Boot process
Twice WARNING 500mA power supply detected

Current too low, use a 3A power supply!

Continue and red LED stays ON
3 times WARNING 1500mA power supply detected

Current too low, use a 3A power supply!

Continue and red LED stays ON
forever ERROR USB TYPE-C connection in unattached mode

Check that USB TYPE-C cable is correctly plugged

stop
forever USB TYPE-C charger not compliant with USB specification stop


Back button.png Overview button.png Next button.png