1.1.2.1.2 Populate the target and boot the image

This message will disappear after all relevant tasks have been resolved.

Semantic MediaWiki

There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.


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

Overview[edit source]

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

Open a terminal[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 your host computer

 mkdir $HOME/STM32MPU_workspace
 cd $HOME/STM32MPU_workspace

Check the host computer Internet access[edit source]

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

The command below allows to check 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 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:

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

Check again the Internet access with 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."

Install the tools[edit source]

STM32CubeProgrammer[edit source]

Information

STM32CubeProgrammer requires 1.8 version of the Java platform.

sudo apt-get install openjdk-8-jre-headless

sudo update-alternatives --config java

Select the java-8-openjdk configuration.

Install OpenJFX for Ubuntu®18.04

sudo apt purge openjfx

sudo apt install openjfx=8u161-b12-1ubuntu2 libopenjfx-jni=8u161-b12-1ubuntu2 libopenjfx-java=8u161-b12-1ubuntu2

sudo apt-mark hold openjfx libopenjfx-jni libopenjfx-java

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

Download last STM32CubeProgrammer in the following directory
$HOME/STM32MPU_workspace/tmp
Uncompress the archive file to get the STM32CubeProgrammer installers

 cd $HOME/STM32MPU_workspace/tmp
 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

 ./SetupSTM32CubeProgrammer-x.y.z.linux

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

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

 STM32_Programmer_CLI --h
     -------------------------------------------------------------------
                       STM32CubeProgrammer vx.y.z                  
     -------------------------------------------------------------------

USB serial link[edit source]

Install the libusb on your host computer

 sudo apt-get install libusb-1.0-0

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

 cd $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z/Drivers/rules
 sudo cp *.* /etc/udev/rules.d/

Download the image[edit source]

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

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 v1.2.0 [edit source]

Create your STM32MP15 Starter Package directory on your host computer

 mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0
 mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0/Starter-Package
 cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0/Starter-Package

Download the STM32MP15-Ecosystem-v1.2.0 Starter Package to the following directory:
$HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0/Starter-Package
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-20-02-19.tar.xz

For ecosystem release v1.1.0 [edit source]

Create your STM32MP15 Starter Package directory on your host computer

 mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0
 mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package
 cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package

Download the STM32MP15-Ecosystem-v1.1.0 Starter Package to the following directory:
$HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package
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-4.19-thud-mp1-19-10-09.tar.xz

For ecosystem release v1.0.0 [edit source]

Create your STM32MP15 Starter Package directory on your host computer

 mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0
 mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package
 cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package

Download the STM32MP15-Ecosystem-v1.0.0 Starter Package to the following directory:
$HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package
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-4.19-thud-mp1-19-02-20.tar.xz

Populate the SDCard[edit source]

Set the boot switches (located at the back of the board) to the off position

boot switches position to flash the board

Power up the board
Press the reset button to reset the board
Go to the Starter Package directory that contains the binaries and the Flash layout files

For ecosystem release v1.1.0 :

 cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package/stm32mp1-openstlinux-4.19-thud-mp1-19-10-09/images/stm32mp1

For ecosystem release v1.0.0 :

 cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package/stm32mp1-openstlinux-4.19-thud-mp1-19-02-20/images/stm32mp1

Get the device port location for the USB link

 STM32_Programmer_CLI -l usb
      -------------------------------------------------------------------
                        STM32CubeProgrammer v2.2.0                  
      -------------------------------------------------------------------

=====  DFU Interface   =====

Total number of available STM32 device in DFU mode: 1

  Device Index           : USB1
  USB Bus Number         : 003
  USB Address Number     : 002
  Product ID             : DFU in HS Mode @Device ID /0x500, @Revision ID /0x0000
  Serial number          : 004800233338511634383330
  Firmware version       : 0x0110
  Device ID              : 0x0500

Flash the microSD card with the image for the trusted boot chain

 STM32_Programmer_CLI -c port=usb1 -w flashlayout_st-image-weston/FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv

This operation takes several minutes (mainly depending of the rootfs size). A successful flashing should be terminated by this following log information

Flashing service completed successfully

Boot the board[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 up the board
Press the reset button to reset the board
After few seconds, the board starts and automatically go through the following screens

UBoot splash screen

Linux splash screen

Weston desktop

GTK demo launcher