Getting started/STM32MP1 boards/STM32MP157x-DK2/Let's start/Populate the target and boot the image

Applicable for

STM32MP15x lines

---

Let's start				Develop on Arm® Cortex®-A7
	Unpack the board		Populate the target and boot the image		Execute basic commands		Use the demo launcher

1. Overview

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

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 your host computer

PC $> mkdir $HOME/STM32MPU_workspace
PC $> cd $HOME/STM32MPU_workspace

3. Check the host computer Internet access

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

The command below allows to check 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 well configured.
In such case, skip the rest of this section.

Any other likely situation indicates the need for a proxy for http/https protocols.
The best solution to set a proxy for http/https protocols is via 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 with 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

4.1. STM32CubeProgrammer

STM32CubeProgrammer requires 1.8 version of the Java platform. PC $> sudo apt-get install openjdk-8-jre-headless PC $> sudo update-alternatives --config java Select the java-8-openjdk configuration. Install OpenJFX for Ubuntu®18.04 PC $> sudo apt purge openjfx PC $> sudo apt install openjfx=8u161-b12-1ubuntu2 libopenjfx-jni=8u161-b12-1ubuntu2 libopenjfx-java=8u161-b12-1ubuntu2 PC $> sudo apt-mark hold openjfx libopenjfx-jni libopenjfx-java

• Create your STM32MPU tools directory on your 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

• Download latest STM32CubeProgrammer in the following directory
  $HOME/STM32MPU_workspace/tmp

ecosystem release v2.0.0 require STM32CubeProgrammer V2.4 or upper

• 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 the installation directory, when it's requested by the installer

PC $> ./SetupSTM32CubeProgrammer-x.y.z.linux

Screenshots, done with STM32CubeProgrammer V2.5.0, are given as examples below:

Splash screen

File:STM32CubeProgrammer installation welcome 25.png

Welcome page

File:STM32CubeProgrammer installation path 25.png

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

• 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

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.

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

For ecosystem release v2.0.0

Only microSD card SanDisk Class 10 and UHS Speed Class 1 are verified. Others are not recommended.

• Create your STM32MP15 Starter Package directory on your host computer

PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0/Starter-Package
PC $> cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0/Starter-Package

• Download the STM32MP15-Ecosystem-v2.0.0 Starter Package to the following directory:
  $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0/Starter-Package
• 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-4-dunfell-mp1-20-06-24.tar.xz

6. Populate the SDCard

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

• 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 the "Open File" tab and choose the "FlashLayout_sdcard_stm32mp157x-dk2-optee.tsv" file in the Starter Package installation folder ("$HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package/stm32mp1-openstlinux-5.4-dunfell-mp1-20-06-24/images/stm32mp1/flashlayout_st-image-weston/optee")

• Fill the "Binaries Path" by browsing to the $[Starter_Pack_Path]/images/stm32mp1 folder.

• Click "Download" to start the flashing process.
• A progress bar indicates the process progress until a completion pop-up message is displayed.

7. Boot the board

• 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

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

Linux^® is a registered trademark of Linus Torvalds.

Flash memory shortened to gain space in titles, tables and block diagrams

USB on-the-go (Capability/type of USB port, acting primarily as USB device, to also act as USB host. Also known as USB OTG.)

Graphical user interface

Light-emitting diode