Difference between revisions of "STM32MP1 Distribution Package - OpenSTLinux distribution"

[quality revision] [quality revision]
m
 
(STM32MP15-Ecosystem-v1.2.0 release)
 

Template:ArticleMainWriter Template:ReviewersList Template:ArticleApprovedVersion

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 Beta1 STM32MP15-Ecosystem-v1.2.0 release[edit]

  • The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision (openstlinux-4.1420-rocko-mp1-18-11-2602-19).
  • 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 -
Beta1
STM32MP15-Ecosystem-v1.2.0 release
Installation
$ cd <working directory path>/Distribution-Package

  • Create the OpenSTLinux distribution installation sub-directory:

$ mkdir openstlinux-
4.14
20-
rocko-mp1-18-11-26
02-19 
$ cd openstlinux-
4.14
20-
rocko-mp1-18-11-26
02-19

  • Initialize repo in the current directory
. Template:STdotcomInfo Note1:
machine github.com
login "github login"
password "github password"

  • (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-20-02-19

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

Note2: repo command will go to several github projects. It is convenient to indicate in your $HOME/.netrc your github credentials like below:
  • Synchronize the local project directories with the remote repositories specified in the manifest

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.

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.
  • (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-4.1420-rocko-mp1-18-11-2602-19:
openstlinux-4.1420-rocko-mp1-18-11-2602-19  OpenSTLinux distribution
├── layers 
│    ├── meta-openembedded                Collection of layers for the OpenEmbedded-Core universe (OpenEmbedded standard)
├── meta-qt5                         QT5 layer for OpenEmbedded (standard)
├── meta-timesys                     Timesys 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 │   │   ├── m4projects  ├── linux-examples        Recipes for STM32Cube Linux examples for STM32 MPU Packagedevices
within the OpenSTLinux distribution │   │   │   └──├── stlinkm4coredump           Recipes for script to manage coredump of cortexM4
│    │   │   │   └── m4projects           Recipes for STLink
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]

2.1

Alpha2

STM32MP15-Ecosystem-v1.1.0 release[edit]

  • The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision (openstlinux-4.
14
  • 19-
rocko
  • thud-mp1-
18
  • 19-
07
  • 10-
03
  • 09).
  • 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 -
Alpha2
STM32MP15-Ecosystem-v1.1.0 release
Installation
$ cd <working directory path>/Distribution-Package

  • Create the OpenSTLinux distribution installation sub-directory:

$ mkdir openstlinux-4.
14
19-
rocko
thud-mp1-
18
19-
07
10-
03
09 
$ cd openstlinux-4.
14
19-
rocko
thud-mp1-
18
19-
07
10-
03
09

  • Initialize repo in the current directory
. Template:STdotcomInfo Note1:
machine github.com
login "github login"
password "github password"

  • (More details on 'repo init' here).

$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.19-thud-mp1-19-10-09

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

Note2: repo command will go to several github projects. It is convenient to indicate in your $HOME/.netrc your github credentials like below:
  • Synchronize the local project directories with the remote repositories specified in the manifest

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.

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.
  • (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-4.
14
  • 19-
rocko
  • thud-mp1-
18
  • 19-
07
  • 10-
03
  • 09:
openstlinux-4.
14
19-
rocko
thud-mp1-
18
19-
07
10-
03
09  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 │   │   
├──
 
m4projects
  ├── linux-examples       
Recipes for 
STM32Cube
Linux examples for STM32 MPU 
Package
devices

within
 
the
 
OpenSTLinux
 
distribution
 │   │   │   ├── 
openocd
m4coredump           Recipes for script 
Recipes
to 
for
manage 
Open
coredump 
On-Chip
of 
Debugging
cortexM4

(OpenOCD)
 
on
 
Cortex-A
 
or
 
Cortex-M
│   │   │   └── 
stlink
m4projects           Recipes for firmware examples 
Recipes
for 
STLink
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.2

Alpha1

STM32MP15-Ecosystem-v1.0.0 release[edit]

  • The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision (openstlinux-4.
14
  • 19-
rocko
  • thud-mp1-
18
  • 19-
01
  • 02-
23
  • 20).
  • 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 -
Alpha1
STM32MP15-Ecosystem-v1.0.0 release
Installation
$ cd <working directory path>/Distribution-Package

  • Create the OpenSTLinux distribution installation sub-directory:

$ mkdir openstlinux-4.
14
19-
rocko
thud-mp1-
18
19-
01
02-
23
20 
$ cd openstlinux-4.
14
19-
rocko
thud-mp1-
18
19-
01
02-
23
20

  • Initialize repo in the current directory.

Details:

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.

The -u option specifies the manifest repository location, while the -b option specifies its branch.

Template:STdotcomInfo


$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.19-thud-mp1-19-02-20

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

Details:

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.

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.


$ repo sync

Release note

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

If interested in former 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-4.
14
  • 19-
rocko
  • thud-mp1-
18
  • 19-
01
  • 02-
23
  • 20:
openstlinux-4.
14
19-
rocko
thud-mp1-
18
19-
01
02-
23
20  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 │   │   ├── 
atf
alsa                 
Recipes for 
ATF
ALSA control configuration
 │   │   ├── drivers              Recipes for Vivante GCNANO GPU kernel drivers │   │   
└──
 
u-boot
  ├── trusted-firmware-a   Recipes for TF-A
      
Recipes
 
for U-Boot
│   │   
├──
└── 
recipes
u-
extended
boot 
   
   
   
├──
 
m4projects
    Recipes for U-Boot
    
Recipes
 
for
 
STM32Cube
 
MPU
 
Package
 
within
 
the
├── 
OpenSTLinux
recipes-extended

distribution
 │   │   
├──
 
openocd
  ├── m4projects           Recipes for 
Open
STM32Cube 
On-Chip
MPU 
Debugging
Package 
(OpenOCD)
within 
on
the 
Cortex-A
OpenSTLinux 
or
distribution

Cortex-M
│   │   │   └── stlink               Recipes for STLink ├── 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       └── [...]

└── openembedded-core
│    ├── meta-timesys                
Layer
 
containing
 
the core
   Timesys layer for OpenEmbedded (standard)
│    └── openembedded-core                Core metadata for current versions of OpenEmbedded (standard)


<noinclude>

{{ArticleMainWriter | DenisH}}
{{ReviewersList | NathalieS, BernardP, RomualdJ, Jean-ChristopheT}}
{{ArticleApprovedVersion | DenisH | Jean-ChristopheT(Passed, 29Nov'18) | Jean-ChristopheT - 17Sep'18 | BrunoB - 04Jul'18 - 8080 | 05Dec'18}}

[[Category:Sub-articles]]
{{UpdateNeededForNewRelease|
* Copy the current release (first chapter) in the "Archives" chapter
* Make the following modifications in this copy:
** Change the "Download" span id to "Download <name of the old release>" (example: "Download Alpha1")
* Make the following modifications in the first chapter:
** Change the name of the manifest file
** Change the link to the release note
** Change the path and the description of the installation directory
}}
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|For more specific information, go through the Distribution Package article relative to your STM32 microprocessors Series: [[:Category:Distribution Package]]}}

==Beta1 release==</noinclude>STM32MP15-Ecosystem-v1.2.0 release==<onlyinclude>

* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.14-rocko-mp1-18-11-2620-02-19''').
* 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
{| class="wikitable"
|-
!  !! st-table"
|-
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - Beta1STM32MP15-Ecosystem-v1.2.0 release
|-
| Installation || <span id="Download"></span>

* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 $ cd <working directory path>/Distribution-Package

* Create the OpenSTLinux distribution installation sub-directory:<pre>

$ mkdir openstlinux-4.14-rocko-mp1-18-11-26 
$ cd openstlinux-4.14-rocko-mp1-18-11-2620-02-19 
$ cd openstlinux-20-02-19
</pre>


* Initialize repo in the current directory. <div class="NavFrame collapsed">
<div class="NavHead">Details:</div>
<div class="NavContent">

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.

The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.</div>
</div>

{{InternalInfo|<pre>

$ repo init -u ssh://gerrit.st.com:29418/mpupubdv/manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-11-26</pre>

}}
{{STdotcomInfo|
* '''A ''github.com'' account is required, with specific access rights (to the ''OpenSTLinux'' repository): please request these rights to your ST support contact'''
* One needs to be logged on ''github.com'' before executing the following command (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).
 {{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]}}<pre>

$ repo init -u https://github.com/OpenSTLinuxSTMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-11-26</pre>


}}
'''Note120-02-19</pre>


'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
'''Note2:''' repo command will go to several github projects. It is convenient to indicate in your $HOME/.netrc your github credentials like below:
 machine github.com
 login "github login"
 password "github password"

* Synchronize the local project directories with the remote repositories specified in the manifest <div class="NavFrame collapsed">
<div class="NavHead">Details:</div>
<div class="NavContent">

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.

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>
(more details on 'repo sync' [https://source.android.com/setup/develop/repo#sync here])<br>
<pre>

$ repo sync</pre>


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

|-
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - Beta1v1.2.0|STM32MP15 ecosystem release note]].
[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MP15 ecosystem release note#ArchivesSTM32MP1_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.14-rocko-mp1-18-11-26'':

 {{Green|openstlinux-4.14-rocko-mp1-18-11-2620-02-19'':

 {{Green|openstlinux-20-02-19}}  {{Highlight|OpenSTLinux distribution}}
 ├── {{Green|layers}} 
 │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}├── {{Green|meta-qt5}}                         {{Highlight|QT5 layer for OpenEmbedded (standard)}}├── {{Green|meta-timesys}}                     {{Highlight|Timesys layer for OpenEmbedded (standard)}}├── {{Green|meta-st}}
 │   ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
 │   ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
 │    ├── {{Green|recipes-bsp}}
 │    │   │   ├── {{Green|alsa}}                 {{Highlight|Recipes for ALSA control configuration}}
 │    │   │   ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
 │    │   │   ├── {{Green|trusted-firmware-a}}   {{Highlight|Recipes for TF-A}}
 │    │   │   └── {{Green|u-boot}}               {{Highlight|Recipes for U-Boot}}
 │    ├── {{Green|recipes-extended}}
 │    │   │   ├── {{Green|m4projects}}           {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
 │   │   │   └── {{Green|stlink}}               {{Highlight|Recipes for STLink}}
 │   │   linux-examples}}       {{Highlight|Recipes for Linux examples for STM32 MPU devices}}
 │    │   │   │   ├── {{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|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
 │    │   │   └── [...]
 │    ├── {{Green|recipes-kernel}}
 │    │   │   ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
 │    │   │   └── {{Green|linux-firmware}}       {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
 │    ├── {{Green|recipes-security}}
 │    │   │   └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
 │    ├── {{Green|recipes-st}}
 │    │   │   └── {{Green|images}}               {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
 │    └── [...]
 │   ├── {{Green|meta-st-stm32mp-addons}}       {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
 │   └── {{Green|scripts}}
 │       ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
 │       └── [...]│       └── [...]
 │    ├── {{Green|meta-timesys}}                     {{Highlight|Timesys layer for OpenEmbedded (standard)}}
 │    └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}

{{InternalInfo| Additional layer for internal usage
└── {{Green|st-hands-on}}  {{Highlight|  STMicroelectronics layer that contains the reference source code for the hands-on}}
}}<noinclude>


==Archives==
{{InternalInfo|Please copy the content of the older release here when delivering a new release<pre>

===XXX release===<div class="NavFrame collapsed">
<div class="NavHead">Details</div>
<div class="NavContent">

  ...</div>
</div>
</pre>

}}

===Alpha2 release===

}}</onlyinclude>


==Archives [[File:Archive_box.png|25px|link=]]==<div class="mw-collapsible mw-collapsed">

===STM32MP15-Ecosystem-v1.1.0 release===<div class="mw-collapsible-content">
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.14-rocko19-thud-mp1-18-07-0319-10-09''').
* 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
{| class="wikitable"
|-
!  !! st-table"
|-
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - Alpha2STM32MP15-Ecosystem-v1.1.0 release
|-
| Installation || <span id="Download Alpha2"></span>

* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 $ cd <working directory path>/Distribution-Package

* Create the OpenSTLinux distribution installation sub-directory:<pre>

$ mkdir openstlinux-4.14-rocko19-thud-mp1-18-07-0319-10-09 

$ cd openstlinux-4.14-rocko19-thud-mp1-18-07-0319-10-09
</pre>


* Initialize repo in the current directory. <div class="NavFrame collapsed">
<div class="NavHead">Details:</div>
<div class="NavContent">

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.

The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.</div>
</div>

{{InternalInfo|<pre>

$ repo init -u ssh://gerrit.st.com:29418/mpupubdv/manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-07-03</pre>

}}
{{STdotcomInfo|
* '''A ''github.com'' account is required, with specific access rights (to the ''OpenSTLinux'' repository): please request these rights to your ST support contact'''
* One needs to be logged on ''github.com'' before executing the following command (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).<pre>

$ repo init -u https://github.com/OpenSTLinuxSTMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko19-thud-mp1-18-07-0319-10-09
</pre>

}}
'''Note1'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
'''Note2:''' repo command will go to several github projects. It is convenient to indicate in your $HOME/.netrc your github credentials like below:
 machine github.com
 login "github login"
 password "github password"

* Synchronize the local project directories with the remote repositories specified in the manifest <div class="NavFrame collapsed">
<div class="NavHead">Details:</div>
<div class="NavContent">

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.

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>
(more details on 'repo sync' [https://source.android.com/setup/develop/repo#sync here])<br>
<pre>

$ repo sync</pre>


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

|-
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - Alpha2v1.1.0|STM32MP15 ecosystem release note]].
[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MP15 ecosystem release note#ArchivesSTM32MP1_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.14-rocko19-thud-mp1-18-07-0319-10-09'':

 {{Green|openstlinux-4.14-rocko19-thud-mp1-18-07-0319-10-09}}  {{Highlight|OpenSTLinux distribution}}
 ├── {{Green|layers}} 
 │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}├── {{Green|meta-qt5}}                         {{Highlight|QT5 layer for OpenEmbedded (standard)}}├── {{Green|meta-st}}
 │   ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
 │   ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
 │    ├── {{Green|recipes-bsp}}
 │    │   │   ├── {{Green|alsa}}                 {{Highlight|Recipes for ALSA control configuration}}
 │    │   │   ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
 │    │   │   ├── {{Green|trusted-firmware-a}}   {{Highlight|Recipes for TF-A}}
 │    │   │   └── {{Green|u-boot}}               {{Highlight|Recipes for U-Boot}}
 │    ├── {{Green|recipes-extended}}
 │    │   │   ├── {{Green|m4projects}}           {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
 │   │   │   ├── {{Green|openocd}}              {{Highlight|Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M}}
 │   │   │   └── {{Green|stlink}}               {{Highlight|Recipes for STLink}}
 │   │   linux-examples}}       {{Highlight|Recipes for Linux examples for STM32 MPU devices}}
 │    │   │   │   ├── {{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|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
 │    │   │   └── [...]
 │    ├── {{Green|recipes-kernel}}
 │    │   │   ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
 │    │   │   └── {{Green|linux-firmware}}       {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
 │    ├── {{Green|recipes-security}}
 │    │   │   └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
 │    ├── {{Green|recipes-st}}
 │    │   │   └── {{Green|images}}               {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
 │    └── [...]
 │   ├── {{Green|meta-st-stm32mp-addons}}       {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
 │   └── {{Green|scripts}}
 │       ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
 │       └── [...]│       └── [...]
 │    ├── {{Green|meta-timesys}}                     {{Highlight|Timesys layer for OpenEmbedded (standard)}}
 │    └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}

{{InternalInfo| Additional layer for internal usage
└── {{Green|st-hands-on}}  {{Highlight|  STMicroelectronics layer that contains the reference source code for the hands-on}}
}}

===Alpha1 release===

}}</div></div>

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

===STM32MP15-Ecosystem-v1.0.0 release===<div class="mw-collapsible-content">
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.14-rocko19-thud-mp1-18-01-2319-02-20''').
* 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
{| class="wikitable"
|-
!  !! st-table"
|-
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution- Alpha1 - STM32MP15-Ecosystem-v1.0.0 release
|-
| Installation || <span id="Download Alpha1"></span>

* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 $ cd <working directory path>/Distribution-Package

* Create the OpenSTLinux distribution installation sub-directory:<pre>

$ mkdir openstlinux-4.14-rocko19-thud-mp1-18-01-2319-02-20 

$ cd openstlinux-4.14-rocko19-thud-mp1-18-01-2319-02-20
</pre>


* Initialize repo in the current directory. <div class="NavFrame mw-collapsible mw-collapsed">
  <div class="NavHead">Details:</div>

<div class="NavContentmw-collapsible-content">

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.

The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.  </div>
</div>
{{InternalInfo|<pre>

$ repo init -u ssh://gerrit.st.com:29418/mpupubdv/https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko19-thud-mp1-18-01-2319-02-20
</pre>
}}
{{STdotcomInfo|
* '''A ''github.com'' account is required, with specific access rights (to the ''OpenSTLinux'' repository): please request these rights to your ST support contact'''
* One needs to be logged on ''github.com'' before executing the following command<pre>

$ repo init -u https://github.com/OpenSTLinux/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-01-23</pre>


}}


'''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<div class="NavFrame mw-collapsible mw-collapsed">
  <div class="NavHead">Details:</div>

<div class="NavContentmw-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.

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 ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - Alpha1v1.0.0|STM32MP15 ecosystem release note]].

If interested in former releases, go through the [[STM32MP15 ecosystem release note#Archives| archives]] of the ecosystem release note.
||}

* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''openstlinux-4.14-rocko19-thud-mp1-18-01-2319-02-20'':

 {{Green|openstlinux-4.14-rocko19-thud-mp1-18-01-2319-02-20}}  {{Highlight|OpenSTLinux distribution}}
 ├── {{Green|layers}} 
 │    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}├── {{Green|meta-qt5}}                         {{Highlight|QT5 layer for OpenEmbedded (standard)}}├── {{Green|meta-st}}
 │   ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
 │   ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
 │    ├── {{Green|recipes-bsp}}
 │    │   │   ├── {{Green|atf}}                  {{Highlight|Recipes for ATF}}
 │   │   │   alsa}}                 {{Highlight|Recipes for ALSA control configuration}}
 │    │   │   │   ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
 │    │   │   │   ├── {{Green|trusted-firmware-a}}   {{Highlight|Recipes for TF-A}}
 │    │   │   │   └── {{Green|u-boot}}               {{Highlight|Recipes for U-Boot}}
 │    ├── {{Green|recipes-extended}}
 │    │   │   ├── {{Green|m4projects}}           {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
 │    │   │   ├── {{Green|openocd}}              {{Highlight|Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M}}
 │   │   │   └── {{Green|stlink}}               {{Highlight|Recipes for STLink}}
 │   │   ├── {{Green|recipes-graphics}}
 │   │   │   ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
 │   │   │   └── [...]
 │   │   ├── {{Green|recipes-kernel}}
 │   │   │   └── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
 │   │   │   └── {{Green|stlink}}               {{Highlight|Recipes for STLink}}
 │    │   │   ├── {{Green|recipes-graphics}}
 │    │   │   │   ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
 │    │   │   │   └── [...]
 │    │   │   ├── {{Green|recipes-kernel}}
 │    │   │   │   ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
 │    │   │   │   └── {{Green|linux-firmware}}       {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
 │    │   │   ├── {{Green|recipes-security}}
 │    │   │   │   └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
 │    │   │   ├── {{Green|recipes-st}}
 │    │   │   └── {{Green|images}}               {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
 │    └── [...]
 │    │   ├── {{Green|meta-st-stm32mp-addons}}       {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
 │    │   └── {{Green|scripts}}
 │       ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
 │       └── [...]
 └── {{Green|openembedded-core}}                {{Highlight|Layer containing the core │       └── [...]
 │    ├── {{Green|meta-timesys}}                     {{Highlight|Timesys layer for OpenEmbedded (standard)}}
 │    └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}</noinclude>

{{InternalInfo| Additional layer for internal usage
└── st-hands-on  STMicroelectronics layer that contains the reference source code for the hands-on
}}</div></div>


[[Category:Sub-articles]]
{{UpdateNeededForNewRelease|
* Copy the current release (first chapter) in the "Archives" chapter
* Make the following modifications in this copy:
** Change the "Download" span id to "Download <name of the old release>" (example: "Download STM32MP15-Ecosystem-v1.0.0 release")
* Make the following modifications in the first chapter:
** Change the name of the manifest file
** Change the link to the release note
** Change the path and the description of the installation directory
}}
(41 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<noinclude>
 
{{ArticleMainWriter | DenisH}}
 
{{ReviewersList | NathalieS, BernardP, RomualdJ, Jean-ChristopheT}}
 
{{ArticleApprovedVersion | DenisH | Jean-ChristopheT(Passed, 29Nov'18) | Jean-ChristopheT - 17Sep'18 | BrunoB - 04Jul'18 - 8080 | 05Dec'18}}
 
 
[[Category:Sub-articles]]
 
{{UpdateNeededForNewRelease|
 
* Copy the current release (first chapter) in the "Archives" chapter
 
* Make the following modifications in this copy:
 
** Change the "Download" span id to "Download <name of the old release>" (example: "Download Alpha1")
 
* Make the following modifications in the first chapter:
 
** Change the name of the manifest file
 
** Change the link to the release note
 
** Change the path and the description of the installation directory
 
}}
 
 
 
This article aims to give the following information:
 
This article aims to give the following information:
 
* How to download and install the '''latest''' OpenSTLinux distribution for the STM32 microprocessors Series
 
* How to download and install the '''latest''' OpenSTLinux distribution for the STM32 microprocessors Series
Line 22: 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]]}}
   
==Beta1 release==
+
==STM32MP15-Ecosystem-v1.2.0 release==
</noinclude>
+
<onlyinclude>
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.14-rocko-mp1-18-11-26''').
+
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-20-02-19''').
 
* 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.
   
 
* Install the STM32MP1 OpenSTLinux distribution
 
* Install the STM32MP1 OpenSTLinux distribution
{| class="wikitable"
+
{| class="st-table"
 
|-
 
|-
!  !! STM32MP1 Distribution Package OpenSTLinux distribution - Beta1 release
+
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v1.2.0 release
 
|-
 
|-
 
| Installation || <span id="Download"></span>
 
| Installation || <span id="Download"></span>
Line 39: Line 23:
 
* Create the OpenSTLinux distribution installation sub-directory:
 
* Create the OpenSTLinux distribution installation sub-directory:
 
<pre>
 
<pre>
$ mkdir openstlinux-4.14-rocko-mp1-18-11-26
+
$ mkdir openstlinux-20-02-19
$ cd openstlinux-4.14-rocko-mp1-18-11-26
+
$ cd openstlinux-20-02-19
 
</pre>
 
</pre>
   
* Initialize repo in the current directory.
+
* Initialize repo in the current directory (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).
<div class="NavFrame collapsed">
+
{{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]}}
  <div class="NavHead">Details:</div>
 
  <div class="NavContent">
 
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.
 
 
 
The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.
 
  </div>
 
</div>
 
{{InternalInfo|
 
<pre>
 
$ repo init -u ssh://gerrit.st.com:29418/mpupubdv/manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-11-26
 
</pre>
 
}}
 
{{STdotcomInfo|
 
* '''A ''github.com'' account is required, with specific access rights (to the ''OpenSTLinux'' repository): please request these rights to your ST support contact'''
 
* One needs to be logged on ''github.com'' before executing the following command
 
 
<pre>
 
<pre>
$ repo init -u https://github.com/OpenSTLinux/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-11-26
+
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-20-02-19
 
</pre>
 
</pre>
   
}}
+
'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
'''Note1:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
 
'''Note2:''' repo command will go to several github projects. It is convenient to indicate in your $HOME/.netrc your github credentials like below:
 
machine github.com
 
login "github login"
 
password "github password"
 
   
 
+
* 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
 
<div class="NavFrame collapsed">
 
  <div class="NavHead">Details:</div>
 
  <div class="NavContent">
 
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.
 
 
 
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>
 
<pre>
 
$ repo sync
 
$ repo sync
 
</pre>
 
</pre>
  +
  +
'''Note:''' ''Distribution package'' needs  around 140MB to be installed (and around 25GB once ''distribution package'' is compiled).<br>
  +
 
|-
 
|-
 
| Release note ||
 
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - Beta1|STM32MP15 ecosystem release note]].
+
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - v1.2.0|STM32MP15 ecosystem release note]].
   
If interested in previous releases, go through the [[STM32MP15 ecosystem release note#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.14-rocko-mp1-18-11-26'':
+
* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''openstlinux-20-02-19'':
   
  {{Green|openstlinux-4.14-rocko-mp1-18-11-26}}  {{Highlight|OpenSTLinux distribution}}
+
  {{Green|openstlinux-20-02-19}}  {{Highlight|OpenSTLinux distribution}}
  ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
+
  ├── {{Green|layers}}
  ├── {{Green|meta-qt5}}                        {{Highlight|QT5 layer for OpenEmbedded (standard)}}
+
│    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
  ├── {{Green|meta-timesys}}                    {{Highlight|Timesys layer for OpenEmbedded (standard)}}
+
  │    ├── {{Green|meta-qt5}}                        {{Highlight|QT5 layer for OpenEmbedded (standard)}}
├── {{Green|meta-st}}
+
  │    ├── {{Green|meta-st}}
  │  ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
+
  │    │  ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
  │  ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
+
  │    │  ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
  │  │  ├── {{Green|recipes-bsp}}
+
  │    │  │  ├── {{Green|recipes-bsp}}
  │  │  │  ├── {{Green|alsa}}                {{Highlight|Recipes for ALSA control configuration}}
+
  │    │  │  │  ├── {{Green|alsa}}                {{Highlight|Recipes for ALSA control configuration}}
  │  │  │  ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
+
  │    │  │  │  ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
  │  │  │  ├── {{Green|trusted-firmware-a}}  {{Highlight|Recipes for TF-A}}
+
  │    │  │  │  ├── {{Green|trusted-firmware-a}}  {{Highlight|Recipes for TF-A}}
  │  │  │  └── {{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|recipes-graphics}}
+
  │    │  │  │  └── {{Green|m4projects}}           {{Highlight|Recipes for firmware examples for Cortex M4}}
  │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
+
  │    │  │  ├── {{Green|recipes-graphics}}
  │  │  │  └── [...]
+
  │    │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
  │  │  ├── {{Green|recipes-kernel}}
+
  │    │  │  │  └── [...]
  │  │  │  ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
+
  │    │  │  ├── {{Green|recipes-kernel}}
  │  │  │  └── {{Green|linux-firmware}}      {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
+
  │    │  │  │  ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
  │  │  ├── {{Green|recipes-security}}
+
  │    │  │  │  └── {{Green|linux-firmware}}      {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
  │  │  │  └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
+
  │    │  │  ├── {{Green|recipes-security}}
  │  │  ├── {{Green|recipes-st}}
+
  │    │  │  │  └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
  │  │  │  └── {{Green|images}}              {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
+
  │    │  │  ├── {{Green|recipes-st}}
  │  │  └── [...]
+
  │    │  │  │  └── {{Green|images}}              {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
  │  ├── {{Green|meta-st-stm32mp-addons}}      {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
+
  │    │  │  └── [...]
  │  └── {{Green|scripts}}
+
  │    │  ├── {{Green|meta-st-stm32mp-addons}}      {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
  │      ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
+
  │    │  └── {{Green|scripts}}
  │      └── [...]
+
  │    │      ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
  └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
+
  │    │      └── [...]
  +
  │    ├── {{Green|meta-timesys}}                    {{Highlight|Timesys layer for OpenEmbedded (standard)}}
  +
│    └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
   
 
{{InternalInfo| Additional layer for internal usage
 
{{InternalInfo| Additional layer for internal usage
└── {{Green|st-hands-on}} {{Highlight|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
 
}}
 
}}
<noinclude>
+
</onlyinclude>
   
==Archives==
+
==Archives [[File:Archive_box.png|25px|link=]]==
{{InternalInfo|Please copy the content of the older release here when delivering a new release
+
<div class="mw-collapsible mw-collapsed">
<pre>
+
===STM32MP15-Ecosystem-v1.1.0 release===
===XXX release===
+
<div class="mw-collapsible-content">
<div class="NavFrame collapsed">
+
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.19-thud-mp1-19-10-09''').
  <div class="NavHead">Details</div>
 
  <div class="NavContent">
 
  ...
 
  </div>
 
</div>
 
</pre>
 
}}
 
 
 
===Alpha2 release===
 
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.14-rocko-mp1-18-07-03''').
 
 
* 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.
   
 
* Install the STM32MP1 OpenSTLinux distribution
 
* Install the STM32MP1 OpenSTLinux distribution
{| class="wikitable"
+
{| class="st-table"
 
|-
 
|-
!  !! STM32MP1 Distribution Package OpenSTLinux distribution - Alpha2 release
+
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v1.1.0 release
 
|-
 
|-
| Installation || <span id="Download Alpha2"></span>
+
| Installation || <span id="Download"></span>
 
* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 
* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 
  $ cd <working directory path>/Distribution-Package
 
  $ cd <working directory path>/Distribution-Package
Line 159: Line 109:
 
* Create the OpenSTLinux distribution installation sub-directory:
 
* Create the OpenSTLinux distribution installation sub-directory:
 
<pre>
 
<pre>
$ mkdir openstlinux-4.14-rocko-mp1-18-07-03
+
$ mkdir openstlinux-4.19-thud-mp1-19-10-09
$ cd openstlinux-4.14-rocko-mp1-18-07-03
+
$ cd openstlinux-4.19-thud-mp1-19-10-09
 
</pre>
 
</pre>
   
* Initialize repo in the current directory.
+
* Initialize repo in the current directory (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]).
<div class="NavFrame collapsed">
 
  <div class="NavHead">Details:</div>
 
  <div class="NavContent">
 
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.
 
 
 
The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.
 
  </div>
 
</div>
 
{{InternalInfo|
 
 
<pre>
 
<pre>
$ repo init -u ssh://gerrit.st.com:29418/mpupubdv/manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-07-03
+
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.19-thud-mp1-19-10-09
 
</pre>
 
</pre>
}}
 
{{STdotcomInfo|
 
* '''A ''github.com'' account is required, with specific access rights (to the ''OpenSTLinux'' repository): please request these rights to your ST support contact'''
 
* One needs to be logged on ''github.com'' before executing the following command
 
<pre>
 
$ repo init -u https://github.com/OpenSTLinux/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-07-03
 
</pre>
 
 
}}
 
'''Note1:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
 
'''Note2:''' repo command will go to several github projects. It is convenient to indicate in your $HOME/.netrc your github credentials like below:
 
machine github.com
 
login "github login"
 
password "github password"
 
 
   
* Synchronize the local project directories with the remote repositories specified in the manifest
+
'''Note:''' "ERROR 404" may appear during "repo init" command without any impact on the process <br>
<div class="NavFrame collapsed">
 
  <div class="NavHead">Details:</div>
 
  <div class="NavContent">
 
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.
 
   
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.
+
* 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>
 
</div>
 
 
<pre>
 
<pre>
 
$ repo sync
 
$ repo sync
 
</pre>
 
</pre>
  +
  +
'''Note:''' ''Distribution package'' needs  around 140MB to be installed (and around 25GB once ''distribution package'' is compiled).<br>
  +
 
|-
 
|-
 
| Release note ||
 
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - Alpha2|STM32MP15 ecosystem 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]].
   
If interested in previous releases, go through the [[STM32MP15 ecosystem release note#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.14-rocko-mp1-18-07-03'':
+
* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''openstlinux-4.19-thud-mp1-19-10-09'':
   
  {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|OpenSTLinux distribution}}
+
  {{Green|openstlinux-4.19-thud-mp1-19-10-09}}  {{Highlight|OpenSTLinux distribution}}
  ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
+
  ├── {{Green|layers}}
  ├── {{Green|meta-qt5}}                        {{Highlight|QT5 layer for OpenEmbedded (standard)}}
+
│    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
  ├── {{Green|meta-st}}
+
  │    ├── {{Green|meta-qt5}}                        {{Highlight|QT5 layer for OpenEmbedded (standard)}}
  │  ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
+
  │    ├── {{Green|meta-st}}
  │  ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
+
  │    │  ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
  │  │  ├── {{Green|recipes-bsp}}
+
  │    │  ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
  │  │  │  ├── {{Green|alsa}}                {{Highlight|Recipes for ALSA control configuration}}
+
  │    │  │  ├── {{Green|recipes-bsp}}
  │  │  │  ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
+
  │    │  │  │  ├── {{Green|alsa}}                {{Highlight|Recipes for ALSA control configuration}}
  │  │  │  ├── {{Green|trusted-firmware-a}}  {{Highlight|Recipes for TF-A}}
+
  │    │  │  │  ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
  │  │  │  └── {{Green|u-boot}}              {{Highlight|Recipes for U-Boot}}
+
  │    │  │  │  ├── {{Green|trusted-firmware-a}}  {{Highlight|Recipes for TF-A}}
  │  │  ├── {{Green|recipes-extended}}
+
  │    │  │  │  └── {{Green|u-boot}}              {{Highlight|Recipes for U-Boot}}
  │  │  │  ├── {{Green|m4projects}}           {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
+
  │    │  │  ├── {{Green|recipes-extended}}
  │  │  │  ├── {{Green|openocd}}             {{Highlight|Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M}}
+
  │    │  │  │  ├── {{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|recipes-graphics}}
+
  │    │  │  │  └── {{Green|m4projects}}           {{Highlight|Recipes for firmware examples for Cortex M4}}
  │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
+
  │    │  │  ├── {{Green|recipes-graphics}}
  │  │  │  └── [...]
+
  │    │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
  │  │  ├── {{Green|recipes-kernel}}
+
  │    │  │  │  └── [...]
  │  │  │  ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
+
  │    │  │  ├── {{Green|recipes-kernel}}
  │  │  │  └── {{Green|linux-firmware}}      {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
+
  │    │  │  │  ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
  │  │  ├── {{Green|recipes-security}}
+
  │    │  │  │  └── {{Green|linux-firmware}}      {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
  │  │  │  └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
+
  │    │  │  ├── {{Green|recipes-security}}
  │  │  ├── {{Green|recipes-st}}
+
  │    │  │  │  └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
  │  │  │  └── {{Green|images}}              {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
+
  │    │  │  ├── {{Green|recipes-st}}
  │  │  └── [...]
+
  │    │  │  │  └── {{Green|images}}              {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
  │  ├── {{Green|meta-st-stm32mp-addons}}      {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
+
  │    │  │  └── [...]
  │  └── {{Green|scripts}}
+
  │    │  ├── {{Green|meta-st-stm32mp-addons}}      {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
  │      ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
+
  │    │  └── {{Green|scripts}}
  │      └── [...]
+
  │    │      ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
  └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
+
  │    │      └── [...]
  +
  │    ├── {{Green|meta-timesys}}                    {{Highlight|Timesys layer for OpenEmbedded (standard)}}
  +
│    └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
   
 
{{InternalInfo| Additional layer for internal usage
 
{{InternalInfo| Additional layer for internal usage
└── {{Green|st-hands-on}} {{Highlight|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>
   
===Alpha1 release===
+
<div class="mw-collapsible mw-collapsed">
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision ('''openstlinux-4.14-rocko-mp1-18-01-23''').
+
===STM32MP15-Ecosystem-v1.0.0 release===
  +
<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 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.
   
 
* Install the STM32MP1 OpenSTLinux distribution
 
* Install the STM32MP1 OpenSTLinux distribution
{| class="wikitable"
+
{| class="st-table"
 
|-
 
|-
!  !! STM32MP1 Distribution Package OpenSTLinux distribution- Alpha1 release
+
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-Ecosystem-v1.0.0 release
 
|-
 
|-
| Installation || <span id="Download Alpha1"></span>
+
| Installation || <span id="Download"></span>
 
* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 
* Go to the host PC directory where to install the Distribution Package (''<Distribution Package installation directory>''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]:
 
  $ cd <working directory path>/Distribution-Package
 
  $ cd <working directory path>/Distribution-Package
Line 265: Line 193:
 
* Create the OpenSTLinux distribution installation sub-directory:
 
* Create the OpenSTLinux distribution installation sub-directory:
 
<pre>
 
<pre>
$ mkdir openstlinux-4.14-rocko-mp1-18-01-23
+
$ mkdir openstlinux-4.19-thud-mp1-19-02-20
$ cd openstlinux-4.14-rocko-mp1-18-01-23
+
$ cd openstlinux-4.19-thud-mp1-19-02-20
 
</pre>
 
</pre>
   
 
* Initialize repo in the current directory.  
 
* Initialize repo in the current directory.  
<div class="NavFrame collapsed">
+
<div class="mw-collapsible mw-collapsed">
  <div class="NavHead">Details:</div>
+
Details:
  <div class="NavContent">
+
<div class="mw-collapsible-content">
 
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.
 
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.
   
 
The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.
 
The ''-u'' option specifies the manifest repository location, while the ''-b'' option specifies its branch.
  </div>
 
 
</div>
 
</div>
{{InternalInfo|
+
</div>
<pre>
 
$ repo init -u ssh://gerrit.st.com:29418/mpupubdv/manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-01-23
 
</pre>
 
}}
 
{{STdotcomInfo|
 
* '''A ''github.com'' account is required, with specific access rights (to the ''OpenSTLinux'' repository): please request these rights to your ST support contact'''
 
* One needs to be logged on ''github.com'' before executing the following command
 
 
<pre>
 
<pre>
$ repo init -u https://github.com/OpenSTLinux/oe-manifest.git -b refs/tags/openstlinux-4.14-rocko-mp1-18-01-23
+
$ repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-4.19-thud-mp1-19-02-20
 
</pre>
 
</pre>
   
}}
+
'''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
<div class="NavFrame collapsed">
+
<div class="mw-collapsible mw-collapsed">
  <div class="NavHead">Details:</div>
+
Details:
  <div class="NavContent">
+
<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.
 
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.
   
 
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.
 
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>
 
</div>
 
</div>
 
<pre>
 
<pre>
Line 306: Line 226:
 
|-
 
|-
 
| Release note ||
 
| Release note ||
Details about the content of this software package are available in the '''associated''' [[STM32MP15 ecosystem release note - Alpha1|STM32MP15 ecosystem 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]].
  +
|}
   
If interested in former releases, go through the [[STM32MP15 ecosystem release note#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'':
|}
+
 
  +
{{Green|openstlinux-4.19-thud-mp1-19-02-20}}  {{Highlight|OpenSTLinux distribution}}
  +
├── {{Green|layers}}
  +
│    ├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
  +
│    ├── {{Green|meta-qt5}}                        {{Highlight|QT5 layer for OpenEmbedded (standard)}}
  +
│    ├── {{Green|meta-st}}
  +
│    │  ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
  +
│    │  ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
  +
│    │  │  ├── {{Green|recipes-bsp}}
  +
│    │  │  │  ├── {{Green|alsa}}                {{Highlight|Recipes for ALSA control configuration}}
  +
│    │  │  │  ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
  +
│    │  │  │  ├── {{Green|trusted-firmware-a}}  {{Highlight|Recipes for TF-A}}
  +
│    │  │  │  └── {{Green|u-boot}}              {{Highlight|Recipes for U-Boot}}
  +
│    │  │  ├── {{Green|recipes-extended}}
  +
│    │  │  │  ├── {{Green|m4projects}}          {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
  +
│    │  │  │  └── {{Green|stlink}}              {{Highlight|Recipes for STLink}}
  +
│    │  │  ├── {{Green|recipes-graphics}}
  +
│    │  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
  +
│    │  │  │  └── [...]
  +
│    │  │  ├── {{Green|recipes-kernel}}
  +
│    │  │  │  ├── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
  +
│    │  │  │  └── {{Green|linux-firmware}}      {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
  +
│    │  │  ├── {{Green|recipes-security}}
  +
│    │  │  │  └── {{Green|optee}}                {{Highlight|Recipes for OPTEE}}
  +
│    │  │  ├── {{Green|recipes-st}}
  +
│    │  │  │  └── {{Green|images}}              {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
  +
│    │  │  └── [...]
  +
│    │  ├── {{Green|meta-st-stm32mp-addons}}      {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
  +
│    │  └── {{Green|scripts}}
  +
│    │      ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
  +
│    │      └── [...]
  +
│    ├── {{Green|meta-timesys}}                    {{Highlight|Timesys layer for OpenEmbedded (standard)}}
  +
│    └── {{Green|openembedded-core}}                {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
   
* The '''OpenSTLinux distribution installation directory''' is in the ''<Distribution Package installation directory>, and is named ''openstlinux-4.14-rocko-mp1-18-01-23'':
+
{{InternalInfo| Additional layer for internal usage
  +
└── st-hands-on  STMicroelectronics layer that contains the reference source code for the hands-on
  +
}}
  +
</div></div>
   
{{Green|openstlinux-4.14-rocko-mp1-18-01-23}}  {{Highlight|OpenSTLinux distribution}}
+
[[Category:Sub-articles]]
├── {{Green|meta-openembedded}}                {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
+
{{UpdateNeededForNewRelease|
├── {{Green|meta-qt5}}                        {{Highlight|QT5 layer for OpenEmbedded (standard)}}
+
* Copy the current release (first chapter) in the "Archives" chapter
├── {{Green|meta-st}}
+
* Make the following modifications in this copy:
│  ├── {{Green|meta-st-openstlinux}}          {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}}
+
** Change the "Download" span id to "Download <name of the old release>" (example: "Download STM32MP15-Ecosystem-v1.0.0 release")
│  ├── {{Green|meta-st-stm32mp}}              {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
+
* Make the following modifications in the first chapter:
│  │  ├── {{Green|recipes-bsp}}
+
** Change the name of the manifest file
│  │  │  ├── {{Green|atf}}                  {{Highlight|Recipes for ATF}}
+
** Change the link to the release note
│  │  │  ├── {{Green|drivers}}              {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
+
** Change the path and the description of the installation directory
│  │  │  └── {{Green|u-boot}}              {{Highlight|Recipes for U-Boot}}
+
}}
│  │  ├── {{Green|recipes-extended}}
 
│  │  │  ├── {{Green|m4projects}}          {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
 
│  │  │  ├── {{Green|openocd}}              {{Highlight|Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M}}
 
│  │  │  └── {{Green|stlink}}              {{Highlight|Recipes for STLink}}
 
│  │  ├── {{Green|recipes-graphics}}
 
│  │  │  ├── {{Green|gcnano-userland}}      {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
 
│  │  │  └── [...]
 
│  │  ├── {{Green|recipes-kernel}}
 
│  │  │  └── {{Green|linux}}                {{Highlight|Recipes for Linux kernel}}
 
│  │  ├── {{Green|recipes-st}}
 
│  │  │  └── {{Green|images}}              {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}}
 
│  │  └── [...]
 
│  └── {{Green|scripts}}
 
│      ├── envsetup.sh              {{Highlight|'''Environment setup script''' for Distribution Package}}
 
│      └── [...]
 
└── {{Green|openembedded-core}}                {{Highlight|Layer containing the core metadata for current versions of [[OpenEmbedded]] (standard)}}
 
</noinclude>