1. Usage[edit source]
The EcosystemRelease/Package template returns either the name, 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 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 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, 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, or the installation path, of the software package or script (see the below table for details).
- an empty string, if the software component is not delivered by the ecosystem release revision.
- "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 | name | Name of the tarball file that contains the binaries (Starter Package) |
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) |
path | Nothing is returned (not applicable) | |
SDK installation script | name | Name of the SDK installation script (Developer Package) |
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) |
path | Nothing is returned (not applicable) | |
Linux kernel package | name | Name of the tarball file that contains the Linux kernel package (Developer 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 |
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) |
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 |
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) |
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 |
path | Path to the directory that contains the TF-A source code (from the TF-A installation directory) | |
OP-TEE package | name | Name of the tarball file that contains the OP-TEE package (Developer 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 |
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) |
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) |
path | Path to the directory that contains the debug symbol files (once the debug symbol files package archive file is uncompressed) | |
OpenSTLinux distribution | name | Name of the manifest |
path | Nothing is returned (not applicable) | |
GDB | name | Name of the GDB executable file |
path | Path to the GDB executable file (from $OECORE_NATIVE_SYSROOT )
|
2. Basic examples[edit source]
You type | You get |
---|---|
"Images" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=Images | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Images | request=path}} |
Name: en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz |
"SDK package" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK | request=path}} |
Name: en.SDK-x86_64-stm32mp1-openstlinux-20-02-19.tar.xz |
"SDK installation script" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK installation script | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK installation script | request=path}} |
Name: st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-2.6-openstlinux-20-02-19.sh |
"SDK setup script" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK setup script | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK setup script | request=path}} |
Name: environment-setup-cortexa7hf-neon-vfpv4-ostl-linux-gnueabi |
"Linux kernel package" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel package | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel package | request=path}} |
Name: en.SOURCES-kernel-stm32mp1-openstlinux-20-02-19.tar.xz |
"Linux kernel source" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel source | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel source | request=path}} |
Name: linux-4.19.94.tar.xz |
"U-Boot package" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot package | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot package | request=path}} |
Name: en.SOURCES-u-boot-stm32mp1-openstlinux-20-02-19.tar.xz |
"U-Boot source" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot source | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot source | request=path}} |
Name: v2018.11.tar.gz |
"TF-A package" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A package | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A package | request=path}} |
Name: en.SOURCES-tf-a-stm32mp1-openstlinux-20-02-19.tar.xz |
"TF-A source" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A source | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A source | request=path}} |
Name: v2.0.tar.gz |
"OP-TEE package" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE package | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE package | request=path}} |
Name: en.SOURCES-optee-stm32mp1-openstlinux-20-02-19.tar.xz |
"OP-TEE source" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE source | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE source | request=path}} |
Name: 3.3.0.tar.gz |
"STM32CubeMP1" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=STM32CubeMP1 | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=STM32CubeMP1 | request=path}} |
Name: en.stm32cubemp1_v1-2-0.zip |
"Debug symbol files" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=Debug symbol files | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Debug symbol files | request=path}} |
Name: en.DEBUG-stm32mp1-openstlinux-20-02-19.tar.xz |
"OpenSTLinux distribution" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=OpenSTLinux distribution | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=OpenSTLinux distribution | request=path}} |
Name: openstlinux-20-02-19 |
"GDB" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=GDB | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=GDB | request=path}} |
Name: usr/bin/arm-ostl-linux-gnueabi |
3. More examples[edit source]
You type | You get |
---|---|
Names and paths are not yet defined: few examples
Name: {{EcosystemRelease/Package | revision=2.0.0 | package=Images | request=name}}<br> Path: {{EcosystemRelease/Package | revision=2.0.0 | package=Images | request=path}}<br> Name: {{EcosystemRelease/Package | revision=2.0.0 | package=SDK setup script | request=name}}<br> Path: {{EcosystemRelease/Package | revision=2.0.0 | package=SDK setup script | request=path}}<br> Name: {{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=name}}<br> Path: {{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=path}} |
Name: TBC.tar.xz |
"Linux kernel package" name and path for an unspecified revision requested
Name: {{EcosystemRelease/Package | package=Linux kernel package | request=name}}<br> Path: {{EcosystemRelease/Package | package=Linux kernel package | request=path}} |
Name: unknown revision |
Linux kernel package name and path for an unknown revision requested
Name: {{EcosystemRelease/Package | revision=10.20.30 | package=Linux kernel package | request=name}}<br> Path: {{EcosystemRelease/Package | revision=10.20.30 | package=Linux kernel package | request=path}} |
Name: unknown revision |
Unspecified package
Name: {{EcosystemRelease/Package | revision=1.2.0 | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | request=path}} |
Name: unknown package |
Unknown package
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=not supported | request=name}}<br> Path: {{EcosystemRelease/Package | revision=1.2.0 | package=not supported | request=path}} |
Name: unknown package |
Unspecified request
{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel}}
|
unknown packageunknown request |
Unknown request
{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel | request=not supported}}
|
unknown packageunknown request |
Check that there's no space before and after the text
BEFORE{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel | request=name}}AFTER<br> BEFORE{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel | request=path}}AFTER |
BEFOREunknown packageAFTER |
4. Code[edit source]
unknown revisionunknown request