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

[quality revision] [quality revision]
(STM32CubeProgrammer)
(STM32CubeProgrammer)
 

1 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 your host computer
PC $> mkdir $HOME/STM32MPU_workspace
PC $> 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 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."

3 Install the tools[edit]

3.1 STM32CubeProgrammer[edit]

Info.png 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 last STM32CubeProgrammer in the following directory
    $HOME/STM32MPU_workspace/tmp
  • 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.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
PC $> STM32_Programmer_CLI --h
     -------------------------------------------------------------------
                       STM32CubeProgrammer vx.y.z                  
     -------------------------------------------------------------------

3.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/

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

4.1 For ecosystem release v1.2.0 More info.png[edit]
  • Create your STM32MP15 Starter Package directory on your host computer
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0/Starter-Package
PC $> 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
PC $> tar xvf en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz
4.2 For ecosystem release v1.1.0 More info.png[edit]
  • Create your STM32MP15 Starter Package directory on your host computer
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package
PC $> 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
PC $> tar xvf en.FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-10-09.tar.xz
4.3 For ecosystem release v1.0.0 More info.png[edit]
  • Create your STM32MP15 Starter Package directory on your host computer
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0
PC $> mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package
PC $> 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
PC $> tar xvf en.FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-02-20.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 your 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 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.<br>

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

Any other likely situation indicates the need for a proxy for http/https protocols.<br>

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

==Install the tools==
===STM32CubeProgrammer===
{{Info|

* STM32CubeProgrammer requires 1.8 version of the Java platform.

:<br><br>
{{PC$}} sudo apt-get install openjdk-8-jre-headless<br/>

:
{{PC$}} sudo update-alternatives --config java<br/>

:
Select the java-8-openjdk configuration.<br/>

* Install OpenJFX for Ubuntu®18.04
:{{PC$}} sudo apt purge openjfx<br/>

:{{PC$}} sudo apt install openjfx&#61;8u161-b12-1ubuntu2 libopenjfx-jni&#61;8u161-b12-1ubuntu2 libopenjfx-java&#61;8u161-b12-1ubuntu2<br/>

:{{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 last [https://www.st.com/en/development-tools/stm32cubeprog.html#getsoftware-scroll STM32CubeProgrammer] in the following directory<br> '''$HOME/STM32MPU_workspace/tmp'''
* 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 {{Highlight|STM32CubeProgrammer V2.2.0}}, are given {{Highlight|as examples}} below:
[[File: STM32CubeProgrammer_installation_splashscreen.png|frame|center|link=|Splash screen]]
[[File: STM32CubeProgrammer_installation_welcome.png|frame|center|link=|Welcome page]]
[[File: STM32CubeProgrammer_installation_path.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
* 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==

{{SoftwareLicenseAgreement | distribution=OpenSTLinux}}

======For {{EcosystemRelease | revision=1.2.0}}======

* Create your STM32MP15 Starter Package directory on your host computer 
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0/Starter-Package
 {{PC$}} cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.2.0/Starter-Package
* Download the [https://www.st.com/content/ccc/resource/technical/software/firmware/group0/21/4c/cd/61/9e/dd/45/5e/STM32MP15_OpenSTLinux_Starter_Package/files/FLASH-stm32mp1-openstlinux-20-02-19.tar.xz/jcr:content/translations/en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz STM32MP15-Ecosystem-v1.2.0 Starter Package] to the following directory:<br> '''$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
 {{PC$}} tar xvf en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz
<div class="mw-collapsible mw-collapsed">


======For {{EcosystemRelease | revision=1.1.0}}======<div class="mw-collapsible-content">


* Create your STM32MP15 Starter Package directory on your host computer 
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package
 {{PC$}} cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.1.0/Starter-Package
* Download the [https://www.st.com/content/ccc/resource/technical/software/firmware/group0/f3/aa/58/10/63/f1/42/2d/STM32MP15_OpenSTLinux_Starter_Package/files/FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-10-09.tar.xz/jcr:content/translations/en.FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-10-09.tar.xz STM32MP15-Ecosystem-v1.1.0 Starter Package] to the following directory:<br> '''$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
 {{PC$}} tar xvf en.FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-10-09.tar.xz</div></div>

<div class="mw-collapsible mw-collapsed">

======For {{EcosystemRelease | revision=1.0.0}}======<div class="mw-collapsible-content">


* Create your STM32MP15 Starter Package directory on your host computer 
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0
 {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package
 {{PC$}} cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v1.0.0/Starter-Package
* Download the [https://www.st.com/content/ccc/resource/technical/software/firmware/group0/e6/64/d6/f2/90/f9/4c/12/stm32mp1starter_ST_Distribution_Image_OpenSTLinux/files/FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-02-20.tar.xz/jcr:content/translations/en.FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-02-20.tar.xz STM32MP15-Ecosystem-v1.0.0 Starter Package] to the following directory:<br> '''$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
 {{PC$}} tar xvf en.FLASH-stm32mp1-openstlinux-4.19-thud-mp1-19-02-20.tar.xz</div></div>

<noinclude>

[[Category:Sub-articles]]
__NOTOC__
{{PublicationRequestId | Auto}}</noinclude>
Line 26: Line 26:
 
==Install the tools==
 
==Install the tools==
 
===STM32CubeProgrammer===
 
===STM32CubeProgrammer===
{{Info|STM32CubeProgrammer requires 1.8 version of the Java platform.<br><br>
+
{{Info|
{{PC$}} sudo apt-get install openjdk-8-jre
+
* STM32CubeProgrammer requires 1.8 version of the Java platform.
{{PC$}} sudo update-alternatives --config java
+
:{{PC$}} sudo apt-get install openjdk-8-jre-headless<br/>
Select the java-8-openjdk configuration.}}
+
:{{PC$}} sudo update-alternatives --config java<br/>
  +
:Select the java-8-openjdk configuration.<br/>
  +
* Install OpenJFX for Ubuntu®18.04
  +
:{{PC$}} sudo apt purge openjfx<br/>
  +
:{{PC$}} sudo apt install openjfx&#61;8u161-b12-1ubuntu2 libopenjfx-jni&#61;8u161-b12-1ubuntu2 libopenjfx-java&#61;8u161-b12-1ubuntu2<br/>
  +
:{{PC$}} sudo apt-mark hold openjfx libopenjfx-jni libopenjfx-java
  +
}}
 
* Create your STM32MPU tools directory on your host computer
 
* Create your STM32MPU tools directory on your host computer
 
  {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools
 
  {{PC$}} mkdir $HOME/STM32MPU_workspace/STM32MPU-Tools

Attachments

Discussions