Component

< Template:EcosystemRelease

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> is not supported.
  • "unknown component", if <<component> is not supported.

2 Basic examples[edit]

You type You get
All components for the v2.1.0 revision requested
Long version names:<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=Linux kernel}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=U-Boot}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=TF-A}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=OP-TEE}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=STM32CubeMPU}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=OpenEmbedded}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=Android}}
Short version names:<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=Linux kernel | name=short}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=U-Boot | name=short}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=TF-A | name=short}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=OP-TEE | name=short}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=STM32CubeMPU | name=short}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=OpenEmbedded | name=short}}<br />
{{EcosystemRelease/Component | revision=2.1.0 | component=Android | name=short}}

Long version names:
Linux kernel v5.4-stm32mp-r2 (v5.4.56)
U-Boot v2020.01-stm32mp-r2
TF-A v2.2-stm32mp-r2
OP-TEE v3.9.0-stm32mp-r2
STM32CubeMP1 Package v1.3.0
OpenEmbedded v3.1.3 (Dunfell)

Short version names:
5.4
2020.01
2.2
3.9.0
1.3.0
3.1

All components for the v2.0.0 revision requested
Long version names:<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=Linux kernel}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=U-Boot}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=TF-A}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=OP-TEE}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=STM32CubeMPU}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=OpenEmbedded}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=Android}}
Short version names:<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=Linux kernel | name=short}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=U-Boot | name=short}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=TF-A | name=short}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=OP-TEE | name=short}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=STM32CubeMPU | name=short}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=OpenEmbedded | name=short}}<br />
{{EcosystemRelease/Component | revision=2.0.0 | component=Android | name=short}}

Long version names:
Linux kernel v5.4-stm32mp-r1 (v5.4.31)
U-Boot v2020.01-stm32mp-r1
TF-A v2.2-stm32mp-r1
OP-TEE v3.9.0-stm32mp-r1
STM32CubeMP1 Package v1.2.0
OpenEmbedded v3.1 (Dunfell)

Short version names:
5.4
2020.01
2.2
3.9.0
1.2.0
3.1

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}}
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