Populate the target and boot the image

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]

This stage explains how to get, install and boot the STM32MP15 Evaluation boards with the Starter Package.

2 Open a terminal[edit]

Open a terminal on the host computer.

Ubuntu terminal

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

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

3 Check the host computer Internet access[edit]

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

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

PC $> 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:

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

Check again the Internet access using the command:

PC $> 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]

4.1 STM32CubeProgrammer[edit]

  • Create your STM32MPU tools directory on the host computer:
PC $> mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools
PC $> mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z
  • Create a temporary directory in your STM32MPU workspace:
PC $> mkdir $HOME/STM32MPU_workspace/tmp
Warning.png ecosystem release ≥ v3.0.0 More info.png requires STM32CubeProgrammer V2.7 or higher.
  • Uncompress the archive file to get the STM32CubeProgrammer installers:
PC $> cd $HOME/STM32MPU_workspace/tmp
PC $> unzip SetupSTM32CubeProgrammer.zip
  • Execute the Linux® installer, which guides you through the installation process. Select "$HOME/STM32MPU-Tools/STM32CubeProgrammer-x.y.z" as installation directory when it is requested by the installer.
PC $> ./SetupSTM32CubeProgrammer-x.y.z.linux

The screenshots below have been obtained with STM32CubeProgrammer V2.7.0. They are provided as examples:

Splash screen
Welcome page
Installation path
  • Add the STM32CubeProgrammer binary path to your PATH environment variable:
export PATH=$HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z/bin:$PATH
  • Check that the STM32CubeProgrammer tool is properly installed and accessible:
PC $> STM32_Programmer_CLI --h
                       STM32CubeProgrammer vx.y.z                  

4.2 USB serial link[edit]

  • Install the libusb on your host computer:
PC $> sudo apt-get install libusb-1.0-0
  • To allow STM32CubeProgrammer to access the USB port through low-level commands, proceed as follows:
PC $> cd $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z/Drivers/rules
PC $> sudo cp *.* /etc/udev/rules.d/

5 Download the image[edit]

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

Warning.png To download a package, it is recommended to be logged in to your "myst" account [1]. If, trying to download, you encounter a “403 error”, you could try to empty your browser cache to workaround the problem. We are working on the resolution of this problem.
We apologize for this inconvenience
Warning.png Only microSD cards SanDisk Class 10 and UHS Speed Class 1 are verified. Others are not recommended.
  • Create your STM32MP15 Starter Package directory on the host computer:
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v3.0.0
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v3.0.0/Starter-Package
PC $> cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v3.0.0/Starter-Package
  • Download the STM32MP15-Ecosystem-v3.0.0 Starter Package to the following directory:
  • Uncompress the tarball file to get the binaries for the different partitions of the image, and the Flash layout files
PC $> tar xvf en.FLASH-stm32mp1-openstlinux-5.10-dunfell-mp1-21-03-31.tar.xz

6 Populate the SDCard[edit]

  • Set the boot switches (located at the back of the board) to the off position :
boot switches position to flash the board
  • Connect USB Type A to Type C cable between PC and CN16/USB_OTG port of the STM32MP157x-EV1 mother board
  • Power up the board
  • Press the reset button to reset the board
  • Launch STM32CubeProgrammer to get the GUI :
STM32CubeProgrammer GUI

  • On the right, select USB (not STLINK, set by default) in the connexion picklist and click on refresh button. Serial Number is displayed if USB is detected.
Select USB for connection with board
  • Click on "Connect"
  • Select "Open File" tab and select the "FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv" file or the "FlashLayout_sdcard_stm32mp157f-ev1-trusted.tsv"" file (depending on the board) in the Starter Package installation folder ("$HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v3.0.0/Starter-Package/stm32mp1-openstlinux-5.10-dunfell-mp1-21-03-31/images/stm32mp1/flashlayout_st-image-weston/trusted")
  • Fill the "Binaries Path" by browsing up to folder $[Starter_Pack_Path]/images/stm32mp1
open .tsv and fill Binaries Path
  • Click on "Download" to start the flashing process.
  • Progress is displayed with progress bar till completion pop-up message.

7 Boot the board[edit]

  • Set the boot switches (located at the back of the board) to the ON position
boot switches position to boot the board
  • Power up the board
  • Press the "Reset" button to reset the board
  • After few seconds, the board starts and automatically goes through the following screens
Warning.png Be patient for very first boot after flash which takes about 2 min. It's less than 20s afterward
UBoot splash screen
Linux splash screen
Weston desktop
GTK demo launcher

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