Populate the target and boot the image

1. Open a terminal

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

2. Check the host computer Internet access

• 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."

3. Install the tools

3.1. STM32CubeProgrammer

• 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

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

STM32CubeProgrammer V2.9 recommended for ecosystem release v3.1.0

STM32CubeProgrammer V2.8 recommended for ecosystem release v3.0.0

• 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 installation directory when it is requested by the installer.

 ./SetupSTM32CubeProgrammer-x.y.z.linux

The screenshots below have been obtained with old STM32CubeProgrammer V2.7.0. They are provided as examples still valid for higher version :

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

• Go inside the binary folder:

 cd $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z/bin/

• Check that the STM32CubeProgrammer tool is properly installed and accessible:

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

3.2. USB serial link

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

4. 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.

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

Warning

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

For ecosystem release v3.1.0

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

• Download the STM32MP15-Ecosystem-v3.1.0 Starter Package to the following directory:
  $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v3.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-5-10-dunfell-mp1-21-11-17_tar.xz

For ecosystem release v3.0.0

• Create your STM32MP15 Starter Package directory on the host computer:

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

• Download the STM32MP15-Ecosystem-v3.0.0 Starter Package to the following directory:
  $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v3.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-5.10-dunfell-mp1-21-03-31.tar.xz

Linux^® is a registered trademark of Linus Torvalds.

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

Linux^® is a registered trademark of Linus Torvalds.

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

Flash memories combine high density and cost effectiveness of EPROMs with the electrical erasability of EEPROMs. For this reason, the Flash memory market is one of the most exciting areas of the semiconductor industry today and new applications requiring in system reprogramming, such as cellular telephones, automotive engine management systems, hard disk drives, PC BIOS software for Plug & Play, digital TV, set top boxes, fax and other modems, PC cards and multimedia CD-ROMs, offer the prospect of very high volume demand.