Component

1. Usage

The STM32CubeRelease/Component template returns the version of a software/tool component delivered by an STM32Cube release revision.

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

Where:

<revision> is the mandatory revision of the STM32Cube release, for which the version of the software/tool component is requested.
- The possible values for this parameter are available in the STM32CubeRelease/Revision template.
<component> is the mandatory software/tool component delivered by the STM32Cube release revision, for which the version of the component is requested. The possible values are:
- STM32CubeMP13
- STM32CubeMP1
- STM32CubeIDE
- STM32CubeMX
- STM32CubeProgrammer

<name> is the optional parameter that allows to select the way the version is displayed. Per default (if <name> is not set), the software/tool component full name is displayed. The possible values for <name> are:
- tag: the software/tool component tag (e.g., "x.y.z") is displayed
- release: the software/tool component release (e.g., "x.y.z") is displayed

Important

Use the value latest for <revision> with caution: be aware that the returned string will vary depending on the latest ecosystem release.

The returned value is:

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

2. Basic examples

2.1. Cube-1.17.0

You type

You get

All components for the v1.17.0 revision requested

Full names:<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMP1}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMP13}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeIDE}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeProgrammer}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMX}}<br />
Tag names:<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMP1 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMP13 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeIDE | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeProgrammer | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMX | name=tag}}<br />
Release names:<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMP1 | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMP13 | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeIDE | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeProgrammer | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.17.0 | component=STM32CubeMX | name=release}}<br />

Full names:
STM32CubeMP1 Package v1.6.0
STM32CubeMP13 Package v1.1.0
STM32CubeIDE-1.16.0
STM32CubeProgrammer-2.17.0
STM32CubeMX-6.12.0
Tag names:
1.6.0
1.1.0
1.16.0
2.17.0
6.12.0
Release names:
1.6.0
1.1.0
1.16.0
2.17.0
6.12.0

All components for the latest revision requested

{{STM32CubeRelease/Component | revision=latest| component=STM32CubeMP1}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMP13}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeIDE}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeProgrammer}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMX}}<br />
Tag names:<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMP1 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMP13 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeIDE | name=tag}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeProgrammer | name=tag}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMX | name=tag}}<br />
Release names:<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMP1 | name=release}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMP13 | name=release}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeIDE | name=release}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeProgrammer | name=release}}<br />
{{STM32CubeRelease/Component | revision=latest | component=STM32CubeMX | name=release}}<br />

STM32CubeMP1 Package v1.6.0
STM32CubeMP13 Package v1.1.0
STM32CubeIDE-1.16.0
STM32CubeProgrammer-2.17.0
STM32CubeMX-6.12.0
Tag names:
1.6.0
1.1.0
1.16.0
2.17.0
6.12.0
Release names:
1.6.0
1.1.0
1.16.0
2.17.0
6.12.0

2.2. Cube-1.16.0

You type

You get

All components for the v1.16.0 revision requested

Full names:<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMP1}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMP13}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeIDE}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeProgrammer}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMX}}<br />
Tag names:<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMP1 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMP13 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeIDE | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeProgrammer | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMX | name=tag}}<br />
Release names:<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMP1 | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMP13 | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeIDE | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeProgrammer | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.16.0 | component=STM32CubeMX | name=release}}<br />

Full names:
STM32CubeMP1 Package v1.6.0
STM32CubeMP13 Package v1.1.0
STM32CubeIDE-1.15.0
STM32CubeProgrammer-2.16.0
STM32CubeMX-6.11.0
Tag names:
1.6.0
1.1.0
1.15.0
2.16.0
6.11.0
Release names:
1.6.0
1.1.0
1.15.0
2.16.0
6.11.0

2.3. Cube-1.15.0

You type

You get

All components for the v1.15.0 revision requested

Full names:<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMP1}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMP13}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeIDE}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeProgrammer}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMX}}<br />
Tag names:<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMP1 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMP13 | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeIDE | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeProgrammer | name=tag}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMX | name=tag}}<br />
Release names:<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMP1 | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMP13 | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeIDE | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeProgrammer | name=release}}<br />
{{STM32CubeRelease/Component | revision=1.15.0 | component=STM32CubeMX | name=release}}<br />

Full names:
STM32CubeMP1 Package v1.6.0
STM32CubeMP13 Package v1.0.0
STM32CubeIDE-1.14.0
STM32CubeProgrammer-2.15.0
STM32CubeMX-6.10.0
Tag names:
1.6.0
1.0.0
1.14.0
2.15.0
6.10.0
Release names:
1.6.0
1.0.0
1.14.0
2.15.0
6.10.0

3. More examples

You type	You get
STM32CubeMP13 version for the vx.0.0 revision (legacy) requested Full names:<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| component=STM32CubeMP13}}<br /> Tag names:<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| component=STM32CubeMP13 \| name=tag}}<br /> Release names:<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| component=STM32CubeMP13 \| name=release}}<br />	Full names: STM32CubeMP13 Package vx.y.z Tag names: x.y.z Release names: x.y.z
STM32CubeMP13 version for vx.1.0 revision (latest) requested {{STM32CubeRelease/Component \| revision=x.1.0 \| component=STM32CubeMP13}}<br /> {{STM32CubeRelease/Component \| revision=x.1.0 \| component=STM32CubeMP13 \| name=tag}}<br /> {{STM32CubeRelease/Component \| revision=x.1.0 \| component=STM32CubeMP13 \| name=release}}	STM32CubeMP13 Package vx.y.z x.y.z x.y.z
STM32CubeMP13 version for vx.2.0 revision (next) requested {{STM32CubeRelease/Component \| revision=x.2.0 \| component=STM32CubeMP13}}<br /> {{STM32CubeRelease/Component \| revision=x.2.0 \| component=STM32CubeMP13 \| name=tag}}<br /> {{STM32CubeRelease/Component \| revision=x.2.0 \| component=STM32CubeMP13 \| name=release}}	STM32CubeMP13 Package vx.y.z x.y.z x.y.z
STM32CubeMP13 version for v0.y.0 revision (former) requested {{STM32CubeRelease/Component \| revision=0.y.0 \| component=STM32CubeMP13}}<br /> {{STM32CubeRelease/Component \| revision=0.y.0 \| component=STM32CubeMP13 \| name=tag}}<br /> {{STM32CubeRelease/Component \| revision=0.y.0 \| component=STM32CubeMP13 \| name=release}}	unknown revision unknown revision unknown revision
STM32CubeMP13 version for an unspecified revision requested Full names:<br /> {{STM32CubeRelease/Component \| component=STM32CubeMP13}}<br /> Tag names:<br /> {{STM32CubeRelease/Component \| component=STM32CubeMP13 \| name=tag}}<br /> Release names:<br /> {{STM32CubeRelease/Component \| component=STM32CubeMP13 \| name=release}}<br />	Full names: unknown revision Tag names: unknown revision Release names: unknown revision
STM32CubeMP13 version for an unknown revision requested Full names:<br /> {{STM32CubeRelease/Component \| revision=10.20.30 \| component=STM32CubeMP13}}<br /> Tag names:<br /> {{STM32CubeRelease/Component \| revision=10.20.30 \| component=STM32CubeMP13 \| name=tag}}<br /> Release names:<br /> {{STM32CubeRelease/Component \| revision=10.20.30 \| component=STM32CubeMP13 \| name=release}}<br />	Full names: unknown revision Tag names: unknown revision Release names: unknown revision
Unspecified component {{STM32CubeRelease/Component \| revision=x.0.0}}<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| name=tag}}<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| name=release}}	unknown component unknown component unknown component
Unknown component {{STM32CubeRelease/Component \| revision=x.0.0 \| component=not supported}}<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| component=not supported \| name=tag}}<br /> {{STM32CubeRelease/Component \| revision=x.0.0 \| component=not supported \| name=release}}	unknown component unknown component unknown component
Unknown value for name: the full name is displayed {{STM32CubeRelease/Component \| revision=x.0.0 \| component=STM32CubeMP13 \| name=version}}	STM32CubeMP13 Package vx.y.z

4. Code

unknown component