Revision as of 08:53, 5 June 2020 by Registered User

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
Path: openstlinux-20-02-19/images/stm32mp1

"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
Path:

"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
Path: stm32mp1-openstlinux-20-02-19/sdk

"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
Path:

"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
Path: stm32mp1-openstlinux-20-02-19/sources/arm-ostl-linux-gnueabi/linux-stm32mp-4.19-r0

"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
Path: linux-4.19.94

"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
Path: stm32mp1-openstlinux-20-02-19/sources/arm-ostl-linux-gnueabi/u-boot-stm32mp-2018.11-r0

"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
Path: u-boot-2018.11

"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
Path: stm32mp1-openstlinux-20-02-19/sources/arm-ostl-linux-gnueabi/tf-a-stm32mp-2.0-r0

"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
Path: arm-trusted-firmware-2.0

"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
Path: stm32mp1-openstlinux-20-02-19/sources/arm-ostl-linux-gnueabi/optee-os-stm32mp-3.3.0-r0

"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
Path: optee_os-3.3.0

"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
Path: STM32Cube_FW_MP1_V1.2.0

"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
Path: stm32mp1-openstlinux-20-02-19/images/stm32mp1

"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
Path:

"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: arm-ostl-linux-gnueabi-gdb
Path: usr/bin/arm-ostl-linux-gnueabi

Names and paths for the latest revision of the ecosystem release (i.e. 1.2.0): few examples
Name: {{EcosystemRelease/Package | revision=latest | package=Images | request=name}}<br>
Path: {{EcosystemRelease/Package | revision=latest | package=Images | request=path}}<br>
Name: {{EcosystemRelease/Package | revision=latest | package=SDK setup script | request=name}}<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>
Path: {{EcosystemRelease/Package | revision=latest | package=Linux kernel package | request=path}}

Name: en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz
Path: openstlinux-20-02-19/images/stm32mp1
Name: environment-setup-cortexa7hf-neon-vfpv4-ostl-linux-gnueabi
Path:
Name: en.SOURCES-kernel-stm32mp1-openstlinux-20-02-19.tar.xz
Path: stm32mp1-openstlinux-20-02-19/sources/arm-ostl-linux-gnueabi/linux-stm32mp-4.19-r0

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
Path: TBC
Name: environment-setup-TBC
Path:
Name: TBC.tar.xz
Path: TBC

"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
Path: 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
Path: 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
Path: 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
Path: 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
BEFOREunknown packageAFTER

4. Code[edit source]

unknown revisionunknown request