Registered User mNo edit summary |
Registered User mNo edit summary Tag: 2017 source edit |
||
(40 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
<noinclude>{{ApplicableFor | <noinclude>{{ApplicableFor | ||
|MPUs list=STM32MP13x, STM32MP15x | |MPUs list=STM32MP13x, STM32MP15x, STM32MP25x | ||
|MPUs checklist=STM32MP13x, STM32MP15x | |MPUs checklist=STM32MP13x, STM32MP15x, STM32MP25x | ||
}}</noinclude> | }} | ||
</noinclude> | |||
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 | * 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 associated release note | ||
* Where to find the previous releases (archives) | * Where to find the previous releases (archives) | ||
{{Warning|For more specific information, go through the Distribution Package article relative to your STM32 microprocessors | {{Warning|For more specific information, go through the Distribution Package article relative to your STM32 microprocessors series: [[:Category:Distribution Package]]}} | ||
== | ==STM32MPU-Ecosystem-v5.1.0 release== | ||
<onlyinclude> | <onlyinclude> | ||
* The STM32MPU OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision. | |||
* 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 STM32MPU OpenSTLinux distribution: '''{{EcosystemRelease/Package | revision=5.1.0 | package=OpenSTLinux distribution | request=name}}''' | |||
{{UpdateNeededForNewRelease| this warning must be added when a new minor release is done : | |||
{{Warning|Check first if {{Highlight|a minor release}} based on this {{EcosystemRelease | revision=5.1.0}} is already published [[STM32_MPU_OpenSTLinux_release_note_-_v5.1.0#Minor_release_updates | here]]}}}} | |||
{{Important|Yocto is using absolute directory path to give names to intermediate files. If the path is too long, Yocto build fails because file names exceed the maximum size supported by the file system. In that case, installation directory path should be renamed to reduce the overall absolute path name.}} | |||
{| class="st-table" | |||
|- | |||
! !! style="text-align:center;max-width:70em;" |STM32MPU Distribution Package OpenSTLinux distribution - STM32MPU-Ecosystem-5.1.0 release | |||
|- | |||
| Installation | |||
|style="max-width:70em;"| <span id="Download"></span> | |||
* Go to the host PC directory where to install the Distribution Package (''{{STLightGreen|<Distribution Package installation directory>}}''). Example, if following the [[Example of directory structure for Packages|proposition to organize the working directory]]: | |||
{{PC$}}cd {{STLightGreen|''<working directory path>''}}/Distribution-Package | |||
* Initialize repo in the current directory (More details on 'repo init' [https://source.android.com/setup/develop/repo#init here]). | |||
{{Warning|Check first [[STM32_MPU_OpenSTLinux_release_note_-_v5.1.0#Minor_release_updates | here]], if {{Highlight|a minor release}} based on this {{EcosystemRelease | revision=5.1.0}} is already published. <br>If a minor release exists, replace the ''tag'' used below, and in other wiki articles, by the tag provided with [[STM32_MPU_OpenSTLinux_release_note_-_v5.1.0#Minor_release_updates |the minor release]].}} | |||
{{PC$}}repo init -u {{EcosystemRelease/Package | revision=5.1.0 | package=OpenSTLinux distribution | request=url}} -b refs/tags/{{EcosystemRelease/Package | revision=5.1.0 | package=OpenSTLinux distribution | request=name}} | |||
'''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> | |||
{{PC$}}repo sync | |||
'''Note:''' ''Distribution package'' needs around 140MB to be installed (and around 25GB once ''distribution package'' is compiled).<br> | |||
|- | |||
| Release note | |||
| style="max-width:70em;"| | |||
Details about the content of this software package are available in the '''associated''' [[STM32 MPU ecosystem release note - v5.1.0|STM32 MPU ecosystem release note]]. | |||
[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MPU Distribution Package - OpenSTLinux distribution#Archives| archives]] of the ecosystem release note. | |||
|} | |||
* When installed, the '''OpenSTLinux Distribution Package''' is available with following tree structure: | |||
{{STLightGreen|Distribution-Package}} {{Highlight|OpenSTLinux distribution}} | |||
├── {{STLightGreen|layers}} | |||
│ ├── {{STLightGreen|meta-openembedded}} {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}} | |||
│ ├── {{STLightGreen|meta-st}} | |||
│ │ ├── {{STLightGreen|meta-st-openstlinux}} {{Highlight|STMicroelectronics layer that contains the frameworks and images settings for the OpenSTLinux distribution}} | |||
│ │ ├── {{STLightGreen|meta-st-stm32mp}} {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}} | |||
│ │ │ ├── {{STLightGreen|recipes-bsp}} | |||
│ │ │ │ ├── {{STLightGreen|alsa}} {{Highlight|Recipes for ALSA control configuration}} | |||
│ │ │ │ ├── {{STLightGreen|ddr-firmware}} {{Highlight|Firmware for DDR PHY on STM32MP}} | |||
│ │ │ │ ├── {{STLightGreen|drivers}} {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}} | |||
│ │ │ │ ├── {{STLightGreen|fip-stm32mp}} {{Highlight|FIP generation}} | |||
│ │ │ │ ├── {{STLightGreen|trusted-firmware-a}} {{Highlight|Recipes for TF-A}} | |||
│ │ │ │ ├── {{STLightGreen|trusted-firmware-m}} {{STLightBlue|'''For {{MicroprocessorDevice | device=25}} only'''}}{{Highlight| - Recipes for TF-M}} | |||
│ │ │ │ └── {{STLightGreen|u-boot}} {{Highlight|Recipes for U-Boot}} | |||
│ │ │ ├── {{STLightGreen|recipes-connectivity}} | |||
│ │ │ │ ├── {{STLightGreen|bluetooth}} {{Highlight|Systemd service to suspend/resume correctly bluetooth}} | |||
│ │ │ │ ├── {{STLightGreen|openssl}} {{Highlight|bbappend recipe to add openssl environment setup to SDK}} | |||
│ │ │ ├── {{STLightGreen|recipes-extended}} | |||
│ │ │ │ ├── {{STLightGreen|external-dt}} {{Highlight|Recipes for providing device tree files for STM32 MPU devices outside of BSP components}} | |||
│ │ │ │ ├── {{STLightGreen|linux-examples}} {{Highlight|Recipes for Linux examples for STM32 MPU devices}} | |||
│ │ │ │ ├── {{STLightGreen|libb64}} {{STLightBlue|'''For {{MicroprocessorDevice | device=25}} only'''}} {{Highlight|- Library for base64 encoding/decoding data}} | |||
│ │ │ │ ├── {{STLightGreen|m33projects}} {{STLightBlue|'''For {{MicroprocessorDevice | device=25}} only'''}}{{Highlight| - Recipes for firmware examples for Cortex M33}} | |||
│ │ │ │ ├── {{STLightGreen|m4coredump}} {{STLightBlue|'''For {{MicroprocessorDevice | device=15}} only'''}}{{Highlight| - Recipes for script to manage coredump of cortexM4}} | |||
│ │ │ │ ├── {{STLightGreen|m4projects}} {{STLightBlue|'''For {{MicroprocessorDevice | device=15}} only'''}}{{Highlight| - Recipes for firmware examples for Cortex M4}} | |||
│ │ │ │ └── {{STLightGreen|stm32mp-g0}} {{STLightBlue|'''For {{MicroprocessorDevice | device=13}} only'''}}{{Highlight| - Recipes for G0 USB firmware}} | |||
│ │ │ ├── {{STLightGreen|recipes-graphics}} | |||
│ │ │ │ ├── {{STLightGreen|gcnano-userland}} {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}} | |||
│ │ │ │ └── [...] | |||
│ │ │ ├── {{STLightGreen|recipes-kernel}} | |||
│ │ │ │ ├── {{STLightGreen|linux}} {{Highlight|Recipes for Linux kernel}} | |||
│ │ │ │ └── {{STLightGreen|linux-firmware}} {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}} | |||
│ │ │ │ └── [...] | |||
│ │ │ ├── {{STLightGreen|recipes-security}} | |||
│ │ │ │ ├── {{STLightGreen|optee}} {{Highlight|Recipes for OPTEE}} | |||
│ │ │ ├── {{STLightGreen|recipes-st}} | |||
│ │ │ │ └── {{STLightGreen|images}} {{Highlight|Recipes for the ''bootfs'' and ''userfs'' partitions binaries}} | |||
│ │ │ │ └── [...] | |||
│ │ │ └── [...] | |||
│ │ ├── {{STLightGreen|meta-st-stm32mp-addons}} {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}} | |||
│ │ └── {{STLightGreen|scripts}} | |||
│ │ ├── envsetup.sh {{Highlight|'''Environment setup script''' for Distribution Package}} | |||
│ │ └── [...] | |||
│ └── {{STLightGreen|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> | |||
==Archives [[File:Archive_box.png|25px|link=]]== | |||
{{EcosystemFlow/Archives}} | |||
<div class="mw-collapsible mw-collapsed"> | |||
===STM32MPU-Ecosystem-v5.0.0 release=== | |||
<div class="mw-collapsible-content"> | |||
* The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision. | * The STM32MP1 OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision. | ||
* 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: '''{{EcosystemRelease/Package | revision= | * Install the STM32MP1 OpenSTLinux distribution: '''{{EcosystemRelease/Package | revision=5.0.0 | package=OpenSTLinux distribution | request=name}}''' | ||
{{Important|Yocto is using absolute directory path to give names to intermediate files. If the path is too long, Yocto build fails because file names exceed the maximum size supported by the file system. In that case, installation directory path should be renamed to reduce the overall absolute path name.}} | {{Important|Yocto is using absolute directory path to give names to intermediate files. If the path is too long, Yocto build fails because file names exceed the maximum size supported by the file system. In that case, installation directory path should be renamed to reduce the overall absolute path name.}} | ||
Line 24: | Line 120: | ||
{| class="st-table" | {| class="st-table" | ||
|- | |- | ||
! !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP1-Ecosystem- | ! !! style="text-align:center;" |STM32MP1 Distribution Package OpenSTLinux distribution - STM32MP1-Ecosystem-5.0.0 release | ||
|- | |- | ||
| Installation || <span id="Download"></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]]: | ||
{{PC$}} cd {{HighlightParam|''<working directory path>''}}/Distribution-Package | {{PC$}} cd {{HighlightParam|''<working directory path>''}}/Distribution-Package | ||
* 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]). | ||
{{PC$}} repo init -u {{EcosystemRelease/Package | revision= | {{Warning|Check first if {{Highlight|a minor release}} based on this {{EcosystemRelease | revision=5.0.0}} is already published [[STM32_MPU_OpenSTLinux_release_note_-_v5.0.0#Minor_release_updates | here]]}} | ||
{{PC$}} repo init -u {{EcosystemRelease/Package | revision=5.0.0 | package=OpenSTLinux distribution | request=url}} -b refs/tags/{{EcosystemRelease/Package | revision=5.0.0 | package=OpenSTLinux distribution | request=name}} | |||
'''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> | ||
Line 47: | Line 140: | ||
|- | |- | ||
| Release note || | | Release note || | ||
Details about the content of this software package are available in the '''associated''' [[STM32 MPU ecosystem release note - | Details about the content of this software package are available in the '''associated''' [[STM32 MPU ecosystem release note - v5.0.0|STM32 MPU ecosystem release note]]. | ||
[[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[ | [[File:Archive_box.png|25px|link=]] If interested in previous releases, go through the [[STM32MPU_Distribution_Package_-_OpenSTLinux_distribution#Archives| archives]] of the ecosystem release note. | ||
|} | |} | ||
{{Green| | * When installed, the '''OpenSTLinux Distribution Package''' is available with following tree structure: | ||
{{Green|Distribution-Package}} {{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 91: | Line 185: | ||
└── 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> | ||
<noinclude> | |||
{{NoIndex}} | {{NoIndex}} | ||
[[Category:Sub-articles]] | [[Category:Sub-articles]] | ||
Line 107: | Line 198: | ||
** Change the path and the description of the installation directory | ** Change the path and the description of the installation directory | ||
}} | }} | ||
</noinclude> |
Latest revision as of 12:25, 6 December 2024
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)
1. STM32MPU-Ecosystem-v5.1.0 release
- The STM32MPU OpenSTLinux distribution is delivered through a manifest repository location and a manifest revision.
- 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 STM32MPU OpenSTLinux distribution: unknown revision- Package
STM32MPU Distribution Package OpenSTLinux distribution - STM32MPU-Ecosystem-5.1.0 release | |
---|---|
Installation |
<working directory path>/Distribution-Packagecd
unknown revision- Package -b refs/tags/unknown revision- Packagerepo init -u Note: "ERROR 404" may appear during "repo init" command without any impact on the process
repo sync
|
Release note |
Details about the content of this software package are available in the associated STM32 MPU ecosystem release note.
|
- When installed, the OpenSTLinux Distribution Package is available with following tree structure:
Distribution-Package OpenSTLinux distribution ├── layers │ ├── meta-openembedded Collection of layers for the OpenEmbedded-Core universe (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 │ │ │ │ ├── ddr-firmware Firmware for DDR PHY on STM32MP │ │ │ │ ├── drivers Recipes for Vivante GCNANO GPU kernel drivers │ │ │ │ ├── fip-stm32mp FIP generation │ │ │ │ ├── trusted-firmware-a Recipes for TF-A │ │ │ │ ├── trusted-firmware-m For STM32MP25 unknown microprocessor device only - Recipes for TF-M │ │ │ │ └── u-boot Recipes for U-Boot │ │ │ ├── recipes-connectivity │ │ │ │ ├── bluetooth Systemd service to suspend/resume correctly bluetooth │ │ │ │ ├── openssl bbappend recipe to add openssl environment setup to SDK │ │ │ ├── recipes-extended │ │ │ │ ├── external-dt Recipes for providing device tree files for STM32 MPU devices outside of BSP components │ │ │ │ ├── linux-examples Recipes for Linux examples for STM32 MPU devices │ │ │ │ ├── libb64 For STM32MP25 unknown microprocessor device only - Library for base64 encoding/decoding data │ │ │ │ ├── m33projects For STM32MP25 unknown microprocessor device only - Recipes for firmware examples for Cortex M33 │ │ │ │ ├── m4coredump For STM32MP15x linesonly - Recipes for script to manage coredump of cortexM4 │ │ │ │ ├── m4projects For STM32MP15x lines
only - Recipes for firmware examples for Cortex M4 │ │ │ │ └── stm32mp-g0 For STM32MP13x lines
only - Recipes for G0 USB firmware │ │ │ ├── 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 Core metadata for current versions of OpenEmbedded (standard)
2. Archives 
This wiki is for the v4 ecosystem releases. For information about the previous ecosystem releases, go through the Wiki archives.
2.1. STM32MPU-Ecosystem-v5.0.0 release