View source for STM32MP1 Developer Package - Linux kernel

<noinclude>
This article provides the following information:
* How to download and install the '''latest''' Linux kernel for the STM32 microprocessor Series used
* Where to find the associated release note
* Where to find the previous releases (archives)

{{Warning|To use this package efficiently, please read the Developer Package article relative to your STM32 microprocessors Series: [[:Category:Developer Package]]}}

==STM32MP15-Ecosystem-v3.1.0 release==
</noinclude>
* The STM32MP1 Linux kernel is delivered through a tarball file named '''{{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel package | request=name}}''' for {{Board | type=157x-EV1 | name=short}} and {{Board | type=157x-DKx | name=short}} boards.

<span id="Download"></span>
* Download and install the STM32MP1 Linux kernel
{{SoftwareLicenseAgreement | distribution=OpenSTLinux | chapter=Boot partition:}}
{| class="st-table"
|-
!  !! style="text-align:center;"|STM32MP1 Developer Package Linux kernel - STM32MP15-Ecosystem-v3.1.0 release
|-
| Download || 
You need to be logged on to ''my.st.com'' before accessing the following link <br/>
[{{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel package | request=url}}/{{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel package | request=name}} {{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel package | request=name}}]<br>
|-
| Installation || 
* Go to the host PC directory in which you want to install the Developer Package (''<Developer Package installation directory>''); if you follow the [[Example of directory structure for Packages|proposition to organize the working directory]], this means:
 {{PC$}} cd {{HighlightParam|''<working directory path>''}}/Developer-Package
* Download the tarball file in this directory
* Uncompress the tarball file to get the Linux kernel (Linux kernel source code, ST patches, ST configuration fragments...):

 {{PC$}} tar xvf {{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel package | request=name}}
 {{PC$}} cd {{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel package | request=path}}
* Follow instructions given in {{Orange|README.HOW_TO.txt}} file present in '''Linux kernel installation directory''' as detailed after
|-
| Release note ||
Details of the content of the Linux kernel are available in the '''associated''' [[STM32MP15 OpenSTLinux release note - v3.1.0|STM32MP15 OpenSTLinux release note]].

[[File:Archive_box.png|25px|link=]] If you are interested in older releases, please have a look into the section [[STM32MP1_Developer_Package_-_Linux_kernel#Archives|Archives]].
|}

* The '''Linux kernel installation directory''' is in the  {{HighlightParam|''<Developer Package installation directory>''}}''/stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17/sources/arm-ostl-linux-gnueabi'' directory, and is named ''linux-stm32mp-''{{HighlightParam|''<kernel version>''}}:

 {{Green|linux-stm32mp-5.10.61-r2}}&#9;{{Highlight|'''Linux kernel installation directory'''}}
 ├── [*].patch&#9;&#9;&#9;{{Highlight|ST patches to apply during the Linux kernel preparation (see next chapter)}}
 ├── fragment-[*].config&#9;&#9;{{Highlight|ST configuration fragments to apply during the Linux kernel configuration (see next chapter)}}
 ├── {{EcosystemRelease/Package | revision=3.1.0 | package=Linux kernel source | request=name}}&#9;{{Highlight|Tarball file of the Linux kernel source code}}
 ├── {{Orange|README.HOW_TO.txt}}&#9;&#9;{{Highlight|Helper file for Linux kernel management: '''reference''' for Linux kernel build}}
 └── series&#9;&#9;&#9;{{Highlight|List of all ST patches to apply}}
<noinclude>

==Archives [[File:Archive_box.png|25px|link=]]==
{{EcosystemFlow/Archives}}

<div class="mw-collapsible mw-collapsed">
===STM32MP15-Ecosystem-v3.0.0 release===
<div class="mw-collapsible-content">

* The STM32MP1 Linux kernel is delivered through a tarball file named '''{{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel package | request=name}}''' for {{Board | type=157x-EV1 | name=short}} and {{Board | type=157x-DKx | name=short}} boards.

<span id="Download"></span>
* Download and install the STM32MP1 Linux kernel
{{SoftwareLicenseAgreement | distribution=OpenSTLinux | chapter=Boot partition:}}
{| class="st-table"
|-
!  !! style="text-align:center;"|STM32MP1 Developer Package Linux kernel - STM32MP15-Ecosystem-v3.0.0 release
|-
| Download || 
You need to be logged on to ''my.st.com'' before accessing the following link <br/>
[{{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel package | request=url}}/{{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel package | request=name}} {{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel package | request=name}}]<br>
|-
| Installation || 
* Go to the host PC directory in which you want to install the Developer Package (''<Developer Package installation directory>''); if you follow the [[Example of directory structure for Packages|proposition to organize the working directory]], this means:
 {{PC$}} cd {{HighlightParam|''<working directory path>''}}/Developer-Package
* Download the tarball file in this directory
* Uncompress the tarball file to get the Linux kernel (Linux kernel source code, ST patches, ST configuration fragments...):

 {{PC$}} tar xvf {{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel package | request=name}}
 {{PC$}} cd {{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel package | request=path}}
* Follow instructions given in {{Orange|README.HOW_TO.txt}} file present in '''Linux kernel installation directory''' as detailed after
|-
| Release note ||
Details of the content of the Linux kernel are available in the '''associated''' [[STM32MP15 OpenSTLinux release note - v3.0.0|STM32MP15 OpenSTLinux release note]].

[[File:Archive_box.png|25px|link=]] If you are interested in older releases, please have a look into the section [[STM32MP1_Developer_Package_-_Linux_kernel#Archives|Archives]].
|}

* The '''Linux kernel installation directory''' is in the  {{HighlightParam|''<Developer Package installation directory>''}}''/stm32mp1-openstlinux-5.10-dunfell-mp1-21-03-31/sources/arm-ostl-linux-gnueabi'' directory, and is named ''linux-stm32mp-''{{HighlightParam|''<kernel version>''}}:

 {{Green|linux-stm32mp-5.10.10-r0}}&#9;{{Highlight|'''Linux kernel installation directory'''}}
 ├── [*].patch&#9;&#9;&#9;{{Highlight|ST patches to apply during the Linux kernel preparation (see next chapter)}}
 ├── fragment-[*].config&#9;&#9;{{Highlight|ST configuration fragments to apply during the Linux kernel configuration (see next chapter)}}
 ├── {{EcosystemRelease/Package | revision=3.0.0 | package=Linux kernel source | request=name}}&#9;{{Highlight|Tarball file of the Linux kernel source code}}
 ├── {{Orange|README.HOW_TO.txt}}&#9;&#9;{{Highlight|Helper file for Linux kernel management: '''reference''' for Linux kernel build}}
 └── series&#9;&#9;&#9;{{Highlight|List of all ST patches to apply}}
<noinclude>
</div></div>

{{NoIndex}}
[[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-v2.0.0 release")
* Make the following modifications in the first chapter
** Change the name of the tarball file
** Change the download URLs
** Change the link to the release note
** Change the path and the description of the installation directory
}}
</noinclude>