1. Usage[edit source]
The EcosystemRelease/Package template returns either the name, the URL, or the installation path, of a software package or script 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/Package | revision=<revision> | package=<package> | request=<request>}}
Where:
- <revision> is the mandatory revision of the ecosystem release, for which the name, the URL, or the installation path of the software package or script is requested.
- The possible values for this parameter are available in the EcosystemRelease/Revision template.
- latest is also a possible value: the latest revision of the ecosystem release is then considered.
- <package> is the mandatory software package or script delivered by the ecosystem release revision, for which the name, the URL, or the installation path is requested. The possible values are listed in the below table.
- <request> is the mandatory request, i.e. either the name, the "url", or the installation path, of the software package or script. The possible values are listed in the below table.
The returned value is:
- a string that contains either the name, the URL or the installation path, of the software package or script (see the below table for details).
- an empty string, if the request is not applicable (e.g. requesting the URL of the SDK environment script makes no sense).
- "unknown revision", if <revision> is not supported.
- "unknown package or script", if <package> is not supported.
- "unknown request", if <request> is not supported.
<package> | <request> | Description of the returned value |
---|---|---|
Images package | name | Name of the tarball file that contains the binaries (Starter Package) |
url | URL (st.com) to the tarball file that contains the binaries | |
path | Path to the directory that contains the binaries (once the binaries tarball file is uncompressed) | |
SDK package | name | Name of the tarball file that contains the SDK installation script (Developer Package) |
url | URL (st.com) to the tarball file that contains the SDK installation script | |
path | Nothing is returned (not applicable) | |
SDK installation script | name | Name of the SDK installation script (Developer Package) |
url | Nothing is returned (not applicable) | |
path | Path to the directory that contains the SDK installation script (once the SDK package tarball file is uncompressed) | |
SDK setup script | name | Name of the SDK setup script (Developer Package) |
url | Nothing is returned (not applicable) | |
path | Nothing is returned (not applicable) | |
Linux kernel package | name | Name of the tarball file that contains the Linux kernel package (Developer Package) |
url | URL (st.com) to the tarball file that contains the Linux kernel package | |
path | Path to the Linux kernel installation directory (once the Linux kernel package tarball file is uncompressed) | |
Linux kernel source | name | Name of the tarball file that contains the Linux kernel source code |
url | Nothing is returned (not applicable) | |
path | Path to the directory that contains the Linux kernel source code (from the Linux kernel installation directory) | |
U-Boot package | name | Name of the tarball file that contains the U-Boot package (Developer Package) |
url | URL (st.com) to the tarball file that contains the U-Boot package | |
path | Path to the U-Boot installation directory (once the U-Boot package tarball file is uncompressed) | |
U-Boot source | name | Name of the tarball file that contains the U-Boot source code |
url | Nothing is returned (not applicable) | |
path | Path to the directory that contains the U-Boot source code (from the U-Boot installation directory) | |
TF-A package | name | Name of the tarball file that contains the TF-A package (Developer Package) |
url | URL (st.com) to the tarball file that contains the TF-A package | |
path | Path to the TF-A installation directory (once the TF-A package tarball file is uncompressed) | |
TF-A source | name | Name of the tarball file that contains the TF-A source code |
url | Nothing is returned (not applicable) | |
path | Path to the directory that contains the TF-A source code (from the TF-A installation directory) | |
TF-A-SSP package | name | Name of the tarball file that contains the TF-A-SSP package (Developer Package) |
url | URL (st.com) to the tarball file that contains the TF-A-SSP package | |
path | Path to the TF-A-SSP installation directory (once the TF-A-SSP package tarball file is uncompressed) | |
TF-A-SSP source | name | Name of the tarball file that contains the TF-A-SSP source code |
url | Nothing is returned (not applicable) | |
path | Path to the directory that contains the TF-A-SSP source code (from the TF-A-SSP installation directory) | |
OP-TEE package | name | Name of the tarball file that contains the OP-TEE package (Developer Package) |
url | URL (st.com) to the tarball file that contains the OP-TEE package | |
path | Path to the OP-TEE installation directory (once the OP-TEE package tarball file is uncompressed) | |
OP-TEE source | name | Name of the tarball file that contains the OP-TEE source code |
url | Nothing is returned (not applicable) | |
path | Path to the directory that contains the OP-TEE source code (from the OP-TEE installation directory) | |
STM32CubeMP1 | name | Name of the archive file that contains the STM32CubeMP1 package (Developer Package) |
url | URL (st.com) to the tarball file that contains the STM32CubeMP1 package | |
path | Path to the directory that contains the STM32CubeMP1 source code (once the STM32CubeMP1 package archive file is uncompressed) | |
Debug symbol files | name | Name of the tarball file that contains the debug symbol files package (Developer Package) |
url | URL (st.com) to the tarball file that contains the debug symbol files package | |
path | Path to the directory that contains the debug symbol files (once the debug symbol files package archive file is uncompressed) | |
Licenses package | name | Name of the tarball file that contains the licenses package (for the OpenSTLinux distribution) |
url | URL (st.com) to the tarball file that contains the licenses package | |
path | Nothing is returned (not applicable) | |
OpenSTLinux distribution | name | Name of the manifest (Distribution Package) |
url | URL (st.com) to the manifest | |
path | Nothing is returned (not applicable) | |
GDB | name | Name of the GDB executable file |
url | Nothing is returned (not applicable) | |
path | Path to the GDB executable file (from $OECORE_NATIVE_SYSROOT )
|
Please read carefully the below information about the use of this template in preformatted text blocks. |
- It is not possible to use this template (as any template) in preformatted text blocks made with with
<pre>...</pre>
: use preformatted text blocks made with space at the beginning of the line. - If needed (especially in tables), limit the width of the blocks with
(adjust the value)
Do not use <pre>...</pre>
| |
---|---|
You type |
<pre> tar xvf {{EcosystemRelease/Package | revision=latest | package=Images package | request=name}} </pre> |
You get |
tar xvf {{EcosystemRelease/Package | revision=latest | package=Images package | request=name}} |
Use space at the beginning of the line | |
You type |
tar xvf {{EcosystemRelease/Package | revision=latest | package=Images package | request=name}} |
You get |
tar xvf en.FLASH-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
Limit the width of the block | |
You type |
<div style="max-width:60em;"> This is a very long command that uses the template (tar xvf {{EcosystemRelease/Package | revision=latest | package=Images package | request=name}}) and its width might be a problem </div> |
You get |
This is a very long command that uses the template (tar xvf en.FLASH-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz) and its width might be a problem |
2. Basic examples[edit source]
You type | You get |
---|---|
"Images package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=name}}] |
Name: en.FLASH-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"SDK package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=SDK package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=SDK package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=SDK package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=SDK package | request=name}}] |
Name: en.SDK-x86_64-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"SDK installation script" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK installation script | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=SDK installation script | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK installation script | request=path}} |
Name: st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-3.1-openstlinux-5-4-dunfell-mp1-20-11-12.sh |
"SDK setup script" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK setup script | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=SDK setup script | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK setup script | request=path}} |
Name: environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi |
"Linux kernel package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=name}}] |
Name: en.SOURCES-kernel-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"Linux kernel source" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel source | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel source | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel source | request=path}} |
Name: linux-5.4.56.tar.xz |
"U-Boot package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot package | request=name}}] |
Name: en.SOURCES-u-boot-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"U-Boot source" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot source | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot source | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=U-Boot source | request=path}} |
Name: u-boot-stm32mp-2020.01.r2-r0.tar.gz |
"TF-A package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A package | request=name}}] |
Name: en.SOURCES-tf-a-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"TF-A source" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A source | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A source | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A source | request=path}} |
Name: tf-a-stm32mp-2.2.r2-r0.tar.gz |
"TF-A-SSP package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP package | request=name}}] |
Name: en.SOURCES-tf-a-ssp-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"TF-A-SSP source" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP source | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP source | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=TF-A-SSP source | request=path}} |
Name: tf-a-stm32mp-ssp-2.2.r2-r0.tar.gz |
"OP-TEE package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE package | request=name}}] |
Name: en.SOURCES-optee-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"OP-TEE source" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE source | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE source | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=OP-TEE source | request=path}} |
Name: optee-os-stm32mp-3.9.0.r2-r0.tar.gz |
"STM32CubeMP1" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=STM32CubeMP1 | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=STM32CubeMP1 | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=STM32CubeMP1 | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=STM32CubeMP1 | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=STM32CubeMP1 | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=STM32CubeMP1 | request=name}}] |
Name: en.STM32Cube_FW_MP1_V1.3.0.zip |
"Debug symbol files" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Debug symbol files | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Debug symbol files | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Debug symbol files | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=Debug symbol files | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=Debug symbol files | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=Debug symbol files | request=name}}] |
Name: en.DEBUG-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"Licenses package" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Licenses package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Licenses package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Licenses package | request=path}}<br> URL + name: [{{EcosystemRelease/Package | revision=2.1.0 | package=Licenses package | request=url}}/{{EcosystemRelease/Package | revision=2.1.0 | package=Licenses package | request=name}} {{EcosystemRelease/Package | revision=2.1.0 | package=Licenses package | request=name}}] |
Name: en.LICENSES-world-openstlinux-weston-stm32mp1.tar.xz |
"OpenSTLinux distribution" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=OpenSTLinux distribution | request=path}} |
Name: openstlinux-5.4-dunfell-mp1-20-11-12 |
"GDB" name, URL and path for v2.1.0 revision requested
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=GDB | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=GDB | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=GDB | request=path}} |
Name: arm-ostl-linux-gnueabi-gdb |
Names, URLs and paths for the latest revision of the ecosystem release (i.e. 2.1.0): few examples
Name: {{EcosystemRelease/Package | revision=latest | package=Images package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=latest | package=Images package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=latest | package=Images package | request=path}}<br> Name: {{EcosystemRelease/Package | revision=latest | package=SDK setup script | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=latest | package=SDK setup script | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=latest | package=SDK setup script | request=path}}<br> Name: {{EcosystemRelease/Package | revision=latest | package=Linux kernel package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=latest | package=Linux kernel package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=latest | package=Linux kernel package | request=path}} |
Name: en.FLASH-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
3. More examples[edit source]
You type | You get |
---|---|
Names, URLs and paths are not yet defined: few examples
Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Images package | request=path}}<br> Name: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK setup script | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=SDK setup script | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=SDK setup script | request=path}}<br> Name: {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.1.0 | package=Linux kernel package | request=path}} |
Name: en.FLASH-stm32mp1-openstlinux-5-4-dunfell-mp1-20-11-12.tar.xz |
"Linux kernel package" name, URL and path for an unspecified revision requested
Name: {{EcosystemRelease/Package | package=Linux kernel package | request=name}}<br> URL: [{{EcosystemRelease/Package | package=Linux kernel package | request=url}}]<br> Path: {{EcosystemRelease/Package | package=Linux kernel package | request=path}} |
Name: unknown revision |
Linux kernel package name, URL and path for an unknown revision requested
Name: {{EcosystemRelease/Package | revision=10.20.30 | package=Linux kernel package | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=10.20.30 | package=Linux kernel package | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=10.20.30 | package=Linux kernel package | request=path}} |
Name: unknown revision |
Unspecified package
Name: {{EcosystemRelease/Package | revision=2.0.0 | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.0.0 | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.0.0 | request=path}} |
Name: unknown package |
Unknown package
Name: {{EcosystemRelease/Package | revision=2.0.0 | package=not supported | request=name}}<br> URL: [{{EcosystemRelease/Package | revision=2.0.0 | package=not supported | request=url}}]<br> Path: {{EcosystemRelease/Package | revision=2.0.0 | package=not supported | request=path}} |
Name: unknown package |
Unspecified request
{{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package}}
|
unknown request |
Unknown request
{{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=not supported}}
|
unknown request |
Check that there's no space before and after the text
BEFORE{{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=name}}AFTER<br> BEFORE[{{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=url}}]AFTER<br> BEFORE{{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=path}}AFTER |
BEFOREen.SOURCES-kernel-stm32mp1-openstlinux-5-4-dunfell-mp1-20-06-24.tar.xzAFTER |
4. Code[edit source]
unknown revisionunknown request