Difference between revisions of "Template:EcosystemRelease/Component"

[quality revision] [quality revision]
m
m

1 Usage[edit]

The EcosystemRelease/Component template returns the version of a software component delivered by an ecosystem release revision of the flow associated with this wiki (e.g. v1.y.z ,or v2.y.z, or...).

Usage: {{EcosystemRelease/Component | revision=<revision> | component=<component> | name=<name>}}

Where:

  • <revision> is the mandatory revision of the ecosystem release, for which the version of the software component is requested.
  • <component> is the mandatory software component delivered by the ecosystem release revision, for which the version of the component is requested. The possible values are:
    • Linux kernel
    • U-Boot
    • TF-A
    • OP-TEE
    • STM32CubeMPU
    • OpenEmbedded
    • Android
  • <name> is the optional parameter that allows to select the way the version name is displayed. Per default (if <name> is not set), the long board name (e.g; "Linux kernel vx.y-stm32mp-[...] (vx.y.z)") is displayed. The possible value for <name> is:
    • short: the short version name (e.g. "x.y") is displayed

The returned value is:

  • a string that contains the version of the software component delivered by the ecosystem release revision.
  • an empty string, if the software component is not delivered by the ecosystem release revision.
  • "unknown revision", if <<revision> <revision> is not supported.
  • "unknown component", if <<component> <component> is not supported.

2 Basic examples[edit]

You type You get
All components for the v4.0.0 revision requested

Long version names:<br />
{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=TF-A}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=Android}}<br />
Short version names:<br />
{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel | name=short}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot | name=short}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=TF-A | name=short}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE | name=short}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU | name=short}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded | name=short}}<br />
{{EcosystemRelease/Component | revision=4.0.0| component=Android | name=short}}

Long version names:
Linux kernel v5.15-stm32mp-r1 (v5.15.24 )
U-Boot v2021.10-stm32mp-r1
TF-A v2.6-stm32mp-r1
OP-TEE 3.16.0-stm32mp-r1
STM32CubeMP1 Package v1.6.0
OpenEmbedded v4.0.1 (Kirkstone)

Short version names:
5.15
2021.10
2.6
3.16.0
1.6.0
4.0

All components for the v3.1.0 revision requested

Long version names:<br />
{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=TF-A}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=Android}}<br />
Short version names:<br />
{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel | name=short}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot | name=short}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=TF-A | name=short}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE | name=short}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU | name=short}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded | name=short}}<br />
{{EcosystemRelease/Component | revision=3.1.0| component=Android | name=short}}

Long version names:
unknown revision
unknown revision
unknown revision
unknown revision
unknown revision
unknown revision
unknown revision
Short version names:
unknown revision
unknown revision
unknown revision
unknown revision
unknown revision
unknown revision
unknown revision

Linux kernel version for vx.0.0 revision requested
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}<br />
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel | name=short}}

Linux kernel vx.y (example)
x.y

U-Boot version for vx.0.0 revision requested
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}<br />
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot | name=short}}

U-Boot vx.y (example)
x.y

TF-A version for vx.0.0 revision requested
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}<br />
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A | name=short}}

TF-A vx.y (example)
x.y

OP-TEE version for vx.0.0 revision requested
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}<br />
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE | name=short}}

OP-TEE vx.y (example)
x.y

STM32CubeMPU version for vx.0.0 revision requested
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU}}<br />
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU | name=short}}

STM32CubeMP1 Package vx.y (example)
x.y

OpenEmbedded version for vx.0.0 revision requested
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}<br />
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded | name=short}}

OpenEmbedded vx.y (example)
x.y

Android version for vx.1.0 revision requested
{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}<br />
{{EcosystemRelease/Component | revision=x.1.0 | component=Android | name=short}}

Android vx.y (example)
x.y

3 More examples[edit]

You type You get
Linux kernel version for vx.2.0 revision requested
{{EcosystemRelease/Component | revision=x.2.0 | component=Linux kernel}}

Linux kernel vx.y (example)

Linux kernel version for vx.1.0 revision requested
{{EcosystemRelease/Component | revision=x.1.0 | component=Linux kernel}}

Linux kernel vx.y (example)

Android version for the vx.0.0 revision requested: Android is not supported by this ecosystem release revision
{{EcosystemRelease/Component | revision=x.0.0 | component=Android}}

Android vx.y (example)

U-Boot version for an unspecified revision requested
{{EcosystemRelease/Component | component=U-Boot}}

unknown revision

TF-A version for an unknown revision requested
{{EcosystemRelease/Component | revision=10.20.30 | component=TF-A}}

unknown revision

Unspecified component
{{EcosystemRelease/Component | revision=x.0.0}}

unknown component

Unknown component
{{EcosystemRelease/Component | revision=x.0.0 |  component=not supported}}

unknown component

4 Code[edit]

unknown component

<noinclude>

==Usage==
The [[Template:EcosystemRelease/Component|EcosystemRelease/Component]] template returns '''the version of a software component''' delivered by an ecosystem release revision of the flow associated with this wiki (e.g. v1.y.z ,or v2.y.z, or...).

 Usage: <nowiki>{{</nowiki>EcosystemRelease/Component | revision={{HighlightParam|<revision>}} | component={{HighlightParam|<component>}}}} | name={{HighlightParam|<name>}}}}

Where:
* {{HighlightParam|<revision>}} is the '''mandatory''' revision of the ecosystem release, for which the version of the software component is requested.
** The possible values for this parameter are available in the [[Template:EcosystemRelease/Revision|EcosystemRelease/Revision]] template.
* {{HighlightParam|<component>}} is the '''mandatory''' software component delivered by the ecosystem release revision, for which the version of the component is requested. The possible values are:
** '''Linux kernel'''
** '''U-Boot'''
** '''TF-A'''
** '''OP-TEE'''
** '''STM32CubeMPU'''
** '''OpenEmbedded'''
** '''Android'''

The * {{HighlightParam|<name>}} is the '''optional''' parameter that allows to select the way the version name is displayed. Per default (if {{HighlightParam|<name>}} is not set), the long board name (e.g; "Linux kernel vx.y-stm32mp-[...] (vx.y.z)") is displayed. The possible value for {{HighlightParam|<name>}} is:
** '''short''': the short version name (e.g. "x.y") is displayed

The returned value is:
* a string that contains the version of the software component delivered by the ecosystem release revision.
* an empty string, if the software component is not delivered by the ecosystem release revision.
* "unknown revision", if {{HighlightParam|<<revision>}} is not supported.
* "unknown component", if {{HighlightParam|<<component>}} is not supported.

==Basic examples==
{| class="st-table"
! style="width: 50%;" | You type !! You get
|-
| Linux kernel version for All components for the v4.0.0 revision requested<pre style="white-space: pre-wrap;">

Long version names:<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=TF-A}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Android}}<br />

Short version names:<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=TF-A | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Android | name=short}}</pre>

|
Long version names:<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=TF-A}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Android}}<br />

Short version names:<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=TF-A | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded | name=short}}<br />

{{EcosystemRelease/Component | revision=4.0.0| component=Android | name=short}}
|-
| All components for the v3.1.0 revision requested<pre style="white-space: pre-wrap;">

Long version names:<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=TF-A}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Android}}<br />

Short version names:<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=TF-A | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Android | name=short}}</pre>

|
Long version names:<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=TF-A}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Android}}<br />

Short version names:<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel | name=short}}<br />

{{EcosystemRelease/Component | revision=3..0| component=U-Boot | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=TF-A | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded | name=short}}<br />

{{EcosystemRelease/Component | revision=3.1.0| component=Android | name=short}}
|-
| Linux kernel version for vx.0.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}
<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}

|<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel | name=short}}
|-
| U-Boot version for vx.0.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}
<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}

|-
| <br />

{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot | name=short}}
|-
| TF-A version for vx.0.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}
<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}

|-
| <br />

{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A | name=short}}
|-
| OP-TEE version for vx.0.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}
<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}

|-
| <br />

{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE | name=short}}
|-
| STM32CubeMPU version for vx.0.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU }}<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU }}<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU | name=short}}
|-
| OpenEmbedded version for vx.0.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}
<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}

|<br />

{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded | name=short}}
|-
| Android version for vx.1.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}
<br />

{{EcosystemRelease/Component | revision=x.1.0 | component=Android | name=short}}</pre>

|
{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}

|}
<br />

{{EcosystemRelease/Component | revision=x.1.0 | component=Android | name=short}}
|}
==More examples==
{| class="st-table"
! style="width: 50%;" | You type !! You get
|-
| Linux kernel version for vx.2.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.2.0 | component=Linux kernel}}</pre>

|
{{EcosystemRelease/Component | revision=x.2.0 | component=Linux kernel}}
|-
| Linux kernel version for vx.1.0 revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.1.0 | component=Linux kernel}}</pre>

|
{{EcosystemRelease/Component | revision=x.1.0 | component=Linux kernel}}
|-
| Android version for the vx.0.0 revision requested: Android is not supported by this ecosystem release revision<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 | component=Android}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 | component=Android}}
|-
| U-Boot version for an unspecified revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | component=U-Boot}}</pre>

|
{{EcosystemRelease/Component | component=U-Boot}}
|-
| TF-A version for an unknown revision requested<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=10.20.30 | component=TF-A}}</pre>

|
{{EcosystemRelease/Component | revision=10.20.30 | component=TF-A}}
|-
| Unspecified component<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0}}

|-
| Unknown component<pre style="white-space: pre-wrap;">

{{EcosystemRelease/Component | revision=x.0.0 |  component=not supported}}</pre>

|
{{EcosystemRelease/Component | revision=x.0.0 |  component=not supported}}
|}

==Code=={{UpdateNeededForNewRelease|Check and update if needed the software component version for each ecosystem release}}</noinclude>{{#switch: {{{component|}}}
| Linux kernel =
  {{#switch: {{{revision|}}}
  | x4.0.0 | x.1.0 | x.2.0 = Linux kernel vx.y (example)
  | 2.0.0 = Linux kernel (version to be defined)= {{#ifeq: {{{name}}} | short | 5.15  | Linux kernel v5.15-stm32mp-r1 (v5.15.24 )}}
  | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | Linux kernel vx.y (example)}}

  | #default = {{Highlight|unknown revision}}
  }}
| U-Boot =
  {{#switch: {{{revision|}}}
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 2021.10| U-Boot v2021.10-stm32mp-r1 }}
  | x.0.0 | x.1.0 | x.2.0 = U-Boot vx.y (example)
  | 2.0.0 = U-Boot (version to be defined){{#ifeq: {{{name}}} | short | x.y | U-Boot vx.y (example)}}

  | #default = {{Highlight|unknown revision}}
  }}
| TF-A =
  {{#switch: {{{revision|}}}
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 2.6 | TF-A v2.6-stm32mp-r1 }}
  | x.0.0 | x.1.0 | x.2.0 = TF-A vx.y (example)
  | 2.0.0 = TF-A (version to be defined){{#ifeq: {{{name}}} | short | x.y | TF-A vx.y (example)}}

  | #default = {{Highlight|unknown revision}}
  }}
| OP-TEE =
  {{#switch: {{{revision|}}}
  | x4.0.0 | x.1.0 | x.2.0 = OP-TEE vx.y (example)
  | 2.0.0 = OP-TEE (version to be defined)= {{#ifeq: {{{name}}} | short | 3.16.0 | OP-TEE 3.16.0-stm32mp-r1}}
  | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | OP-TEE vx.y (example)}}

  | #default = {{Highlight|unknown revision}}
  }}
| STM32CubeMPU =
  {{#switch: {{{revision|}}}
  | 4.0.0 = {{#ifeq: {{{name}}} | short |1.6.0 |STM32CubeMP1 Package v1.6.0}}  
  | x.0.0 | x.1.0 | x.2.0 = STM32CubeMP1 Package vx.y (example)
  | 2.0.0 = STM32CubeMP1 Package (version to be defined){{#ifeq: {{{name}}} | short | x.y | STM32CubeMP1 Package vx.y (example)}}

  | #default = {{Highlight|unknown revision}}
  }}
| OpenEmbedded =
  {{#switch: {{{revision|}}}
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 4.0 |OpenEmbedded v4.0.1 (Kirkstone) }}
  | x.0.0 | x.1.0 | x.2.0 = OpenEmbedded vx.y (example)
  | 2.0.0 = OpenEmbedded (version to be defined){{#ifeq: {{{name}}} | short | x.y | OpenEmbedded vx.y (example)}}

  | #default = {{Highlight|unknown revision}}
  }}
| Android =
  {{#switch: {{{revision|}}}
  | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | Android vx.y (example)

  | x.0.0 | 2.0.0 }}
  | 4.0.0 =
  | #default = {{Highlight|unknown revision}}
  }}
| #default = {{Highlight|unknown component}}
}}
(31 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
The [[Template:EcosystemRelease/Component|EcosystemRelease/Component]] template returns '''the version of a software component''' delivered by an ecosystem release revision of the flow associated with this wiki (e.g. v1.y.z ,or v2.y.z, or...).
 
The [[Template:EcosystemRelease/Component|EcosystemRelease/Component]] template returns '''the version of a software component''' delivered by an ecosystem release revision of the flow associated with this wiki (e.g. v1.y.z ,or v2.y.z, or...).
   
  Usage: <nowiki>{{</nowiki>EcosystemRelease/Component | revision={{HighlightParam|<revision>}} | component={{HighlightParam|<component>}}}}
+
  Usage: <nowiki>{{</nowiki>EcosystemRelease/Component | revision={{HighlightParam|<revision>}} | component={{HighlightParam|<component>}} | name={{HighlightParam|<name>}}}}
 
Where:
 
Where:
 
* {{HighlightParam|<revision>}} is the '''mandatory''' revision of the ecosystem release, for which the version of the software component is requested.
 
* {{HighlightParam|<revision>}} is the '''mandatory''' revision of the ecosystem release, for which the version of the software component is requested.
Line 15: Line 15:
 
** '''OpenEmbedded'''
 
** '''OpenEmbedded'''
 
** '''Android'''
 
** '''Android'''
  +
* {{HighlightParam|<name>}} is the '''optional''' parameter that allows to select the way the version name is displayed. Per default (if {{HighlightParam|<name>}} is not set), the long board name (e.g; "Linux kernel vx.y-stm32mp-[...] (vx.y.z)") is displayed. The possible value for {{HighlightParam|<name>}} is:
  +
** '''short''': the short version name (e.g. "x.y") is displayed
   
 
The returned value is:
 
The returned value is:
 
* a string that contains the version of the software component delivered by the ecosystem release revision.
 
* a string that contains the version of the software component delivered by the ecosystem release revision.
 
* an empty string, if the software component is not delivered by the ecosystem release revision.
 
* an empty string, if the software component is not delivered by the ecosystem release revision.
* "unknown revision", if {{HighlightParam|<<revision>}} is not supported.
+
* "unknown revision", if {{HighlightParam|<revision>}} is not supported.
* "unknown component", if {{HighlightParam|<<component>}} is not supported.
+
* "unknown component", if {{HighlightParam|<component>}} is not supported.
   
 
==Basic examples==
 
==Basic examples==
 
{| class="st-table"
 
{| class="st-table"
 
! style="width: 50%;" | You type !! You get
 
! style="width: 50%;" | You type !! You get
  +
|-
  +
| All components for the v4.0.0 revision requested
  +
<pre style="white-space: pre-wrap;">
  +
Long version names:<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=TF-A}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Android}}<br />
  +
Short version names:<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=TF-A | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Android | name=short}}
  +
</pre>
  +
|
  +
Long version names:<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=TF-A}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Android}}<br />
  +
Short version names:<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Linux kernel | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=U-Boot | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=TF-A | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OP-TEE | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=STM32CubeMPU | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=OpenEmbedded | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=4.0.0| component=Android | name=short}}
  +
|-
  +
| All components for the v3.1.0 revision requested
  +
<pre style="white-space: pre-wrap;">
  +
Long version names:<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=TF-A}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Android}}<br />
  +
Short version names:<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=TF-A | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Android | name=short}}
  +
</pre>
  +
|
  +
Long version names:<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=U-Boot}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=TF-A}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Android}}<br />
  +
Short version names:<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Linux kernel | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3..0| component=U-Boot | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=TF-A | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OP-TEE | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=STM32CubeMPU | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=OpenEmbedded | name=short}}<br />
  +
{{EcosystemRelease/Component | revision=3.1.0| component=Android | name=short}}
 
|-
 
|-
 
| Linux kernel version for vx.0.0 revision requested
 
| Linux kernel version for vx.0.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=Linux kernel | name=short}}
 
|-
 
|-
 
| U-Boot version for vx.0.0 revision requested
 
| U-Boot version for vx.0.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=U-Boot | name=short}}
 
|-
 
|-
 
| TF-A version for vx.0.0 revision requested
 
| TF-A version for vx.0.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=TF-A | name=short}}
 
|-
 
|-
 
| OP-TEE version for vx.0.0 revision requested
 
| OP-TEE version for vx.0.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=OP-TEE | name=short}}
 
|-
 
|-
 
| STM32CubeMPU version for vx.0.0 revision requested
 
| STM32CubeMPU version for vx.0.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU }}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU }}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=STM32CubeMPU | name=short}}
 
|-
 
|-
 
| OpenEmbedded version for vx.0.0 revision requested
 
| OpenEmbedded version for vx.0.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}
+
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded}}<br />
  +
{{EcosystemRelease/Component | revision=x.0.0 | component=OpenEmbedded | name=short}}
 
|-
 
|-
 
| Android version for vx.1.0 revision requested
 
| Android version for vx.1.0 revision requested
 
<pre style="white-space: pre-wrap;">
 
<pre style="white-space: pre-wrap;">
{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}
+
{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}<br />
  +
{{EcosystemRelease/Component | revision=x.1.0 | component=Android | name=short}}
 
</pre>
 
</pre>
 
|
 
|
{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}
+
{{EcosystemRelease/Component | revision=x.1.0 | component=Android}}<br />
  +
{{EcosystemRelease/Component | revision=x.1.0 | component=Android | name=short}}
 
|}
 
|}
   
Line 132: Line 222:
   
 
==Code==
 
==Code==
{{UpdateNeededForNewRelease|Check and update if needed the software component version for each ecosystem release}}
 
 
</noinclude>{{#switch: {{{component|}}}
 
</noinclude>{{#switch: {{{component|}}}
 
| Linux kernel =
 
| Linux kernel =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.0.0 | x.1.0 | x.2.0 = Linux kernel vx.y (example)
+
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 5.15  | Linux kernel v5.15-stm32mp-r1 (v5.15.24 )}}
  | 2.0.0 = Linux kernel (version to be defined)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | Linux kernel vx.y (example)}}
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| U-Boot =
 
| U-Boot =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.0.0 | x.1.0 | x.2.0 = U-Boot vx.y (example)
+
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 2021.10| U-Boot v2021.10-stm32mp-r1 }}
  | 2.0.0 = U-Boot (version to be defined)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | U-Boot vx.y (example)}}
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| TF-A =
 
| TF-A =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.0.0 | x.1.0 | x.2.0 = TF-A vx.y (example)
+
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 2.6 | TF-A v2.6-stm32mp-r1 }}
  | 2.0.0 = TF-A (version to be defined)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | TF-A vx.y (example)}}
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| OP-TEE =
 
| OP-TEE =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.0.0 | x.1.0 | x.2.0 = OP-TEE vx.y (example)
+
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 3.16.0 | OP-TEE 3.16.0-stm32mp-r1}}
  | 2.0.0 = OP-TEE (version to be defined)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | OP-TEE vx.y (example)}}
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| STM32CubeMPU =
 
| STM32CubeMPU =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.0.0 | x.1.0 | x.2.0 = STM32CubeMP1 Package vx.y (example)
+
  | 4.0.0 = {{#ifeq: {{{name}}} | short |1.6.0 |STM32CubeMP1 Package v1.6.0}} 
  | 2.0.0 = STM32CubeMP1 Package (version to be defined)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | STM32CubeMP1 Package vx.y (example)}}
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| OpenEmbedded =
 
| OpenEmbedded =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.0.0 | x.1.0 | x.2.0 = OpenEmbedded vx.y (example)
+
  | 4.0.0 = {{#ifeq: {{{name}}} | short | 4.0 |OpenEmbedded v4.0.1 (Kirkstone) }}
  | 2.0.0 = OpenEmbedded (version to be defined)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | OpenEmbedded vx.y (example)}}
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| Android =
 
| Android =
 
   {{#switch: {{{revision|}}}
 
   {{#switch: {{{revision|}}}
   | x.1.0 | x.2.0 = Android vx.y (example)
+
   | x.0.0 | x.1.0 | x.2.0 = {{#ifeq: {{{name}}} | short | x.y | Android vx.y (example)}}
   | x.0.0 | 2.0.0 =
+
   | 4.0.0 =
 
   | #default = {{Highlight|unknown revision}}
 
   | #default = {{Highlight|unknown revision}}
 
   }}
 
   }}
 
| #default = {{Highlight|unknown component}}
 
| #default = {{Highlight|unknown component}}
 
}}
 
}}