View source for STM32MP1 Distribution Package - OpenSTLinux distribution

==STM32MP15-Ecosystem-v1.2.0 release==
<onlyinclude>
* 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 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="st-table"
|-
!  !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP15-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-20-02-19 
$ cd openstlinux-20-02-19
</pre>

* Initialize repo in the current directory (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/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-20-02-19
</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 (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 - v1.2.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-20-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-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|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
└── st-hands-on  STMicroelectronics layer that contains the reference source code for the hands-on
}}
</onlyinclude>