Difference between revisions of "Populate the target and boot the image"

[unchecked revision] [quality revision]
m (Download the image)
m (Download the image)

1 Open a terminal[edit]

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[edit]

  • 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[edit]

3.1 STM32CubeProgrammer[edit]

  • 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

STM32CubeProgrammer V2.11 is recommended for ecosystem release v4.0.0 More info.png

  • 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[edit]

  • 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[edit]

  • Create your STM32MP1 Starter Package directory on the host computer:
 mkdir $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0
 mkdir $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package
 cd $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package
  • Download the STM32MP1-Ecosystem-v4.0.0 Starter Package to the following directory:
    $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.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 FLASH-stm32mp1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15.tar.xz


==Open a terminal==
Open a terminal on the host computer.
[[File: Ubuntu_terminal.png|frame|center|link=|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

==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:
 {{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.<br>

In this case, skip the rest of this section.<br>
<br>

Otherwise, a proxy for http/https protocols is required.<br>

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

==Install the tools==
===STM32CubeProgrammer===

* 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
* Download [https://www.st.com/en/development-tools/stm32cubeprog.html#getsoftware-scroll STM32CubeProgrammer] in the following directory<br> '''$HOME/STM32MPU_workspace/tmp'''

STM32CubeProgrammer V2.11 is recommended for {{EcosystemRelease | revision=4.0.0| range= }} 

* Uncompress  the archive file to get the STM32CubeProgrammer installers:
 {{PC$}} cd $HOME/STM32MPU_workspace/tmp
 {{PC$}} unzip SetupSTM32CubeProgrammer.zip
* Execute the Linux<sup>&reg;</sup> 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 old {{Highlight|STM32CubeProgrammer V2.7.0}}. They are provided {{Highlight| as examples}} still valid for higher version :
[[File: STM32CubeProgrammer_installation_splashscreen.png|frame|center|link=|Splash screen]]
[[File: STM32CubeProgrammer_installation_welcome_27.png|frame|center|link=|Welcome page]]
[[File: STM32CubeProgrammer_installation_path_25.png|frame|center|link=|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:
 {{PC$}} cd $HOME/STM32MPU_workspace/STM32MPU-Tools/STM32CubeProgrammer-x.y.z/bin/
{{ReviewsComments|-- [[User:Kevin Huber|Kevin Huber]] ([[User talk:Kevin Huber|talk]]) 14:59, 13 December 2021 (CET)<br />I added this part because we are currently facing a bug if the CubeProgrammer is not launched from its binary folder. Ticket: 115167 }}

* Check that the STM32CubeProgrammer tool is properly installed and accessible:
 {{PC$}} STM32_Programmer_CLI --h
      -------------------------------------------------------------------
                        STM32CubeProgrammer vx.y.z                  
      -------------------------------------------------------------------

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

==Download the image==

* Create your STM32MP1 Starter Package directory on the  host computer: 
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package
 {{PC$}} cd $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package
{{ReviewsComments|-- [[User:Kevin Huber|Kevin Huber]] ([[User talk:Kevin Huber|talk]]) 16:10, 17 June 2022 (CEST)<br />Check that path is correct after TBD update }}* Download the [{{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=url}}/{{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=name}} STM32MP1-Ecosystem-v4.0.0 Starter Package] to the following directory:<br> '''$HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.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 {{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=name}}
<noinclude>

{{NoIndex}}
__NOTOC__
[[Category:Sub-articles]]
{{PublicationRequestId | 19647 | 2021-04-19}}</noinclude>
Line 73: Line 73:
 
  {{PC$}} cd $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package
 
  {{PC$}} cd $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package
   
{{ReviewsComments|-- [[User:Kevin Huber|Kevin Huber]] ([[User talk:Kevin Huber|talk]]) 16:10, 17 June 2022 (CEST)<br />Check that path is correct after TBD update }}
 
 
* Download the [{{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=url}}/{{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=name}} STM32MP1-Ecosystem-v4.0.0 Starter Package] to the following directory:<br> '''$HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package'''
 
* Download the [{{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=url}}/{{EcosystemRelease/Package | revision=4.0.0| package=Images package | request=name}} STM32MP1-Ecosystem-v4.0.0 Starter Package] to the following directory:<br> '''$HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Starter-Package'''
 
* Uncompress the tarball file to get the binaries for the different partitions of the image, and the Flash layout files
 
* Uncompress the tarball file to get the binaries for the different partitions of the image, and the Flash layout files