Last edited 4 years ago

STM32MP1 Distribution Package - OpenSTLinux distribution: Difference between revisions

Registered User
mNo edit summary
Registered User
mNo edit summary
 
(14 intermediate revisions by 4 users not shown)
Line 6: Line 6:
{{Warning|For more specific information, go through the Distribution Package article relative to your STM32 microprocessors Series: [[:Category:Distribution Package]]}}
{{Warning|For more specific information, go through the Distribution Package article relative to your STM32 microprocessors Series: [[:Category:Distribution Package]]}}


==STM32MP15-Ecosystem-v1.1.0 release==
==STM32MP15-Ecosystem-v2.1.0 release==
<onlyinclude>
<onlyinclude>
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.19-thud-mp1-19-10-09''').
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''{{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}''').
* The installation relies on the ''repo'' command. In case the Repo tool (a Google-built repository management tool that runs on top of Git) is not yet installed and configured on the host PC, refer to the [[PC prerequisites]] article.
* The installation relies on the ''repo'' command. In case the Repo tool (a Google-built repository management tool that runs on top of git) is not yet installed and configured on the host PC, refer to the [[PC prerequisites]] article.
* The OpenSTLinux distribution is massively using open source software (OSS) packages that are downloaded from a variety of open source repositories; so it is required that the IT infrastructure proxies do not forbid such accesses. If some proxy-related issues are suspected, refer to the [[How to avoid proxy issues]] article.
* The OpenSTLinux distribution is massively using open source software (OSS) packages that are downloaded from a variety of open source repositories; so it is required that the IT infrastructure proxies do not forbid such accesses. If some proxy-related issues are suspected, refer to the [[How to avoid proxy issues]] article.


Line 15: Line 15:
{| class="st-table"
{| class="st-table"
|-
|-
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v1.1.0 release
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v2.1.0 release
|-
|-
| Installation || <span id="Download"></span>
| Installation || <span id="Download"></span>
Line 22: Line 22:


* Create the OpenSTLinux distribution installation sub-directory:
* Create the OpenSTLinux distribution installation sub-directory:
<pre>
 
$ mkdir openstlinux-4.19-thud-mp1-19-10-09
$ mkdir {{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}
$ cd openstlinux-4.19-thud-mp1-19-10-09
$ cd {{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}
</pre>


* Initialize repo in the current directory (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).
* Initialize repo in the current directory (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).
<pre>
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.19-thud-mp1-19-10-09
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/{{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}
</pre>
 


'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>


* Synchronize the local project directories with the remote repositories specified in the manifest (more details on 'repo sync' [https://source.android.com/setup/develop/repo#sync here])<br>
* Synchronize the local project directories with the remote repositories specified in the manifest (more details on 'repo sync' [https://source.android.com/setup/develop/repo#sync here])<br>
<pre>
 
$ repo sync
$ repo sync
</pre>
 


'''Note:''' ''Distribution package'' needs  around 140MB to be installed (and around 25GB once ''distribution package'' is compiled).<br>
'''Note:''' ''Distribution package'' needs  around 140MB to be installed (and around 25GB once ''distribution package'' is compiled).<br>
Line 43: Line 42:
|-
|-
| Release note ||
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - v1.1.0|STM32MP15 ecosystem release note]].
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - v2.1.0|STM32MP15 ecosystem release note]].


[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MP1_Distribution_Package_-_OpenSTLinux_distribution#Archives| archives]] of the ecosystem release note.
[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MP1_Distribution_Package_-_OpenSTLinux_distribution#Archives| archives]] of the ecosystem release note.
|}
|}


* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''openstlinux-4.19-thud-mp1-19-10-09'':
* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''{{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}'':


  {{Green|openstlinux-4.19-thud-mp1-19-10-09}}  {{Highlight|OpenSTLinux distribution}}
  {{Green|{{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}}}  {{Highlight|OpenSTLinux distribution}}
  ├── {{Green|layers}}  
  ├── {{Green|layers}}  
  │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
  │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
Line 90: Line 89:


==Archives [[File:Archive_box.png|25px|link=]]==
==Archives [[File:Archive_box.png|25px|link=]]==
{{EcosystemFlow/Archives}}
<div class="mw-collapsible mw-collapsed">
<div class="mw-collapsible mw-collapsed">
===STM32MP15-Ecosystem-v1.0.0 release===
===STM32MP15-Ecosystem-v2.0.0 release===
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.19-thud-mp1-19-02-20''').
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''{{EcosystemRelease/Package | revision=2.0.0 | package=OpenSTLinux distribution | request=name}}''').
* The installation relies on the ''repo'' command. In case the Repo tool (a Google-built repository management tool that runs on top of Git) is not yet installed and configured on the host PC, refer to the [[PC prerequisites]] article.
* The installation relies on the ''repo'' command. In case the Repo tool (a Google-built repository management tool that runs on top of Git) is not yet installed and configured on the host PC, refer to the [[PC prerequisites]] article.
* The OpenSTLinux distribution is massively using open source software (OSS) packages that are downloaded from a variety of open source repositories; so it is required that the IT infrastructure proxies do not forbid such accesses. If some proxy-related issues are suspected, refer to the [[How to avoid proxy issues]] article.
* The OpenSTLinux distribution is massively using open source software (OSS) packages that are downloaded from a variety of open source repositories; so it is required that the IT infrastructure proxies do not forbid such accesses. If some proxy-related issues are suspected, refer to the [[How to avoid proxy issues]] article.
Line 100: Line 100:
{| class="st-table"
{| class="st-table"
|-
|-
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v1.0.0 release
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v2.0.0 release
|-
|-
| Installation || <span id="Download"></span>
| Installation || <span id="Download"></span>
Line 107: Line 107:


* Create the OpenSTLinux distribution installation sub-directory:
* Create the OpenSTLinux distribution installation sub-directory:
<pre>
$ mkdir openstlinux-4.19-thud-mp1-19-02-20
$ cd openstlinux-4.19-thud-mp1-19-02-20
</pre>


* Initialize repo in the current directory.
$ mkdir {{EcosystemRelease/Package | revision=2.0.0 | package=OpenSTLinux distribution | request=name}}
<div class="mw-collapsible mw-collapsed">
$ cd {{EcosystemRelease/Package | revision=2.0.0 | package=OpenSTLinux distribution | request=name}}
Details:
 
<div class="mw-collapsible-content">
* Initialize repo in the current directory (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).
The below command downloads (in the ''.repo'' directory) the latest repo source code and a manifest file (''default.xml'')) that describes the directory structure of the repositories for OpenSTLinux.
{{Highlight| For Ubuntu 16.04 you should use the legacy repo, procedure to install [https://source.android.com/setup/build/downloading#old-repo-python2 here]}}
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/{{EcosystemRelease/Package | revision=2.0.0 | package=OpenSTLinux distribution | request=name}}


The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.
</div>
</div>
<pre>
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.19-thud-mp1-19-02-20
</pre>


'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>


* Synchronize the local project directories with the remote repositories specified in the manifest
* Synchronize the local project directories with the remote repositories specified in the manifest (more details on 'repo sync' [https://source.android.com/setup/develop/repo#sync here])<br>
<div class="mw-collapsible mw-collapsed">
 
Details:
$ repo sync
<div class="mw-collapsible-content">
 
If a local project does not yet exist, the command clones a new local directory from the remote repository and sets up tracking branches as specified in the manifest.
 
'''Note:''' ''Distribution package'' needs  around 140MB to be installed (and around 25GB once ''distribution package'' is compiled).<br>


If the local project already exists, the command updates the remote branches and rebases any new local changes on top of the new remote changes.
</div>
</div>
<pre>
$ repo sync
</pre>
|-
|-
| Release note ||
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - v1.0.0|STM32MP15 ecosystem release note]].
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - v2.0.0|STM32MP15 ecosystem release note]].
 
[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MP1_Distribution_Package_-_OpenSTLinux_distribution#Archives| archives]] of the ecosystem release note.
|}
|}


* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''openstlinux-4.19-thud-mp1-19-02-20'':
* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''{{EcosystemRelease/Package | revision=2.0.0 | package=OpenSTLinux distribution | request=name}}'':


  {{Green|openstlinux-4.19-thud-mp1-19-02-20}}  {{Highlight|OpenSTLinux distribution}}
  {{Green|{{EcosystemRelease/Package | revision=2.0.0 | package=OpenSTLinux distribution | request=name}}}}  {{Highlight|OpenSTLinux distribution}}
  ├── {{Green|layers}}  
  ├── {{Green|layers}}  
  │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
  │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
Line 159: Line 148:
  │    │  │  │  └── {{Green|u-boot}}              {{Highlight|Recipes for U-Boot}}
  │    │  │  │  └── {{Green|u-boot}}              {{Highlight|Recipes for U-Boot}}
  │    │  │  ├── {{Green|recipes-extended}}
  │    │  │  ├── {{Green|recipes-extended}}
  │    │  │  │  ├── {{Green|m4projects}}          {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
  │    │  │  │  ├── {{Green|linux-examples}}      {{Highlight|Recipes for Linux examples for STM32 MPU devices}}
  │    │  │  │  └── {{Green|stlink}}               {{Highlight|Recipes for STLink}}
│    │  │  │  ├── {{Green|m4coredump}}          {{Highlight|Recipes for script to manage coredump of cortexM4}}
  │    │  │  │  └── {{Green|m4projects}}           {{Highlight|Recipes for firmware examples for Cortex M4}}
  │    │  │  ├── {{Green|recipes-graphics}}
  │    │  │  ├── {{Green|recipes-graphics}}
  │    │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
  │    │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
Line 182: Line 172:
└── st-hands-on  STMicroelectronics layer that contains the reference source code for the hands-on
└── st-hands-on  STMicroelectronics layer that contains the reference source code for the hands-on
}}
}}
</div></div>


{{NoIndex}}
[[Category:Sub-articles]]
[[Category:Sub-articles]]
{{UpdateNeededForNewRelease|
{{UpdateNeededForNewRelease|

Latest revision as of 18:45, 12 November 2020

This article aims to give the following information:

  • How to download and install the latest OpenSTLinux distribution for the STM32 microprocessors Series
  • Where to find the associated release note
  • Where to find the previous releases (archives)
Warning white.png Warning
For more specific information, go through the Distribution Package article relative to your STM32 microprocessors Series: Category:Distribution Package

1. STM32MP15-Ecosystem-v2.1.0 release[edit source]

  • The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision (openstlinux-5.4-dunfell-mp1-20-11-12).
  • The installation relies on the repo command. In case the Repo tool (a Google-built repository management tool that runs on top of git) is not yet installed and configured on the host PC, refer to the PC prerequisites article.
  • The OpenSTLinux distribution is massively using open source software (OSS) packages that are downloaded from a variety of open source repositories; so it is required that the IT infrastructure proxies do not forbid such accesses. If some proxy-related issues are suspected, refer to the How to avoid proxy issues article.
  • Install the STM32MP1 OpenSTLinux distribution
STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v2.1.0 release
Installation
$ cd <working directory path>/Distribution-Package
  • Create the OpenSTLinux distribution installation sub-directory:
$ mkdir openstlinux-5.4-dunfell-mp1-20-11-12 
$ cd openstlinux-5.4-dunfell-mp1-20-11-12
  • Initialize repo in the current directory (More details on 'repo init' here).
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-5.4-dunfell-mp1-20-11-12


Note: "ERROR 404" may appear during "repo init" command without any impact on the process

  • Synchronize the local project directories with the remote repositories specified in the manifest (more details on 'repo sync' here)
$ repo sync


Note: Distribution package needs around 140MB to be installed (and around 25GB once distribution package is compiled).

Release note

Details about the content of this software package are available in the associated STM32MP15 ecosystem release note.

Archive box.png If interested in previous releases, go through the archives of the ecosystem release note.

  • The OpenSTLinux distribution installation directory is in the <Distribution Package installation directory>, and is named openstlinux-5.4-dunfell-mp1-20-11-12:
openstlinux-5.4-dunfell-mp1-20-11-12  OpenSTLinux distribution
├── layers 
│    ├── meta-openembedded                Collection of layers for the OpenEmbedded-Core universe (OpenEmbedded standard)
│    ├── meta-qt5                         QT5 layer for OpenEmbedded (standard)
│    ├── meta-st
│    │   ├── meta-st-openstlinux          STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution
│    │   ├── meta-st-stm32mp              STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices
│    │   │   ├── recipes-bsp
│    │   │   │   ├── alsa                 Recipes for ALSA control configuration
│    │   │   │   ├── drivers              Recipes for Vivante GCNANO GPU kernel drivers
│    │   │   │   ├── trusted-firmware-a   Recipes for TF-A
│    │   │   │   └── u-boot               Recipes for U-Boot
│    │   │   ├── recipes-extended
│    │   │   │   ├── linux-examples       Recipes for Linux examples for STM32 MPU devices
│    │   │   │   ├── m4coredump           Recipes for script to manage coredump of cortexM4
│    │   │   │   └── m4projects           Recipes for firmware examples for Cortex M4
│    │   │   ├── recipes-graphics
│    │   │   │   ├── gcnano-userland      Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)
│    │   │   │   └── [...]
│    │   │   ├── recipes-kernel
│    │   │   │   ├── linux                Recipes for Linux kernel
│    │   │   │   └── linux-firmware       Recipes for Linux firmwares (example, Bluetooth firmware)
│    │   │   ├── recipes-security
│    │   │   │   └── optee                Recipes for OPTEE
│    │   │   ├── recipes-st
│    │   │   │   └── images               Recipes for the bootfs and userfs partitions binaries
│    │   │   └── [...]
│    │   ├── meta-st-stm32mp-addons       STMicroelectronics layer that helps managing the STM32CubeMX integration
│    │   └── scripts
│    │       ├── envsetup.sh              Environment setup script for Distribution Package
│    │       └── [...]
│    ├── meta-timesys                     Timesys layer for OpenEmbedded (standard)
│    └── openembedded-core                Core metadata for current versions of OpenEmbedded (standard)



2. Archives Archive box.png[edit source]

This wiki is for the v2 ecosystem releases. For information about the previous ecosystem releases, please go through the Wiki archives.

2.1. STM32MP15-Ecosystem-v2.0.0 release[edit source]

  • The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision (openstlinux-5.4-dunfell-mp1-20-06-24).
  • The installation relies on the repo command. In case the Repo tool (a Google-built repository management tool that runs on top of Git) is not yet installed and configured on the host PC, refer to the PC prerequisites article.
  • The OpenSTLinux distribution is massively using open source software (OSS) packages that are downloaded from a variety of open source repositories; so it is required that the IT infrastructure proxies do not forbid such accesses. If some proxy-related issues are suspected, refer to the How to avoid proxy issues article.
  • Install the STM32MP1 OpenSTLinux distribution
STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v2.0.0 release
Installation
$ cd <working directory path>/Distribution-Package
  • Create the OpenSTLinux distribution installation sub-directory:
$ mkdir openstlinux-5.4-dunfell-mp1-20-06-24 
$ cd openstlinux-5.4-dunfell-mp1-20-06-24
  • Initialize repo in the current directory (More details on 'repo init' here).
 For Ubuntu 16.04 you should use the legacy repo, procedure to install here

$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-5.4-dunfell-mp1-20-06-24


Note: "ERROR 404" may appear during "repo init" command without any impact on the process

  • Synchronize the local project directories with the remote repositories specified in the manifest (more details on 'repo sync' here)
$ repo sync


Note: Distribution package needs around 140MB to be installed (and around 25GB once distribution package is compiled).

Release note

Details about the content of this software package are available in the associated STM32MP15 ecosystem release note.

Archive box.png If interested in previous releases, go through the archives of the ecosystem release note.

  • The OpenSTLinux distribution installation directory is in the <Distribution Package installation directory>, and is named openstlinux-5.4-dunfell-mp1-20-06-24:
openstlinux-5.4-dunfell-mp1-20-06-24  OpenSTLinux distribution
├── layers 
│    ├── meta-openembedded                Collection of layers for the OpenEmbedded-Core universe (OpenEmbedded standard)
│    ├── meta-qt5                         QT5 layer for OpenEmbedded (standard)
│    ├── meta-st
│    │   ├── meta-st-openstlinux          STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution
│    │   ├── meta-st-stm32mp              STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices
│    │   │   ├── recipes-bsp
│    │   │   │   ├── alsa                 Recipes for ALSA control configuration
│    │   │   │   ├── drivers              Recipes for Vivante GCNANO GPU kernel drivers
│    │   │   │   ├── trusted-firmware-a   Recipes for TF-A
│    │   │   │   └── u-boot               Recipes for U-Boot
│    │   │   ├── recipes-extended
│    │   │   │   ├── linux-examples       Recipes for Linux examples for STM32 MPU devices
│    │   │   │   ├── m4coredump           Recipes for script to manage coredump of cortexM4
│    │   │   │   └── m4projects           Recipes for firmware examples for Cortex M4
│    │   │   ├── recipes-graphics
│    │   │   │   ├── gcnano-userland      Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)
│    │   │   │   └── [...]
│    │   │   ├── recipes-kernel
│    │   │   │   ├── linux                Recipes for Linux kernel
│    │   │   │   └── linux-firmware       Recipes for Linux firmwares (example, Bluetooth firmware)
│    │   │   ├── recipes-security
│    │   │   │   └── optee                Recipes for OPTEE
│    │   │   ├── recipes-st
│    │   │   │   └── images               Recipes for the bootfs and userfs partitions binaries
│    │   │   └── [...]
│    │   ├── meta-st-stm32mp-addons       STMicroelectronics layer that helps managing the STM32CubeMX integration
│    │   └── scripts
│    │       ├── envsetup.sh              Environment setup script for Distribution Package
│    │       └── [...]
│    ├── meta-timesys                     Timesys layer for OpenEmbedded (standard)
│    └── openembedded-core                Core metadata for current versions of OpenEmbedded (standard)