Revision as of 18:27, 10 June 2020 by Registered User

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, 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 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)
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)

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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=Images | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Images | request=path}}

Name: en.FLASH-stm32mp1-openstlinux-20-02-19.tar.xz
URL: [1]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=SDK | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK | request=path}}

Name: en.SDK-x86_64-stm32mp1-openstlinux-20-02-19.tar.xz
URL: [2]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=SDK installation script | request=url}}]<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
URL: []
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=SDK setup script | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=SDK setup script | request=path}}

Name: environment-setup-cortexa7hf-neon-vfpv4-ostl-linux-gnueabi
URL: []
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel package | request=url}}]<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
URL: [3]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel source | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel source | request=path}}

Name: linux-4.19.94.tar.xz
URL: []
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot package | request=url}}]<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
URL: [4]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot source | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=U-Boot source | request=path}}

Name: v2018.11.tar.gz
URL: []
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=TF-A package | request=url}}]<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
URL: [5]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=TF-A source | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A source | request=path}}

Name: v2.0.tar.gz
URL: []
Path: arm-trusted-firmware-2.0

"TF-A-SSP package" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A-SSP package | request=name}}<br>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=TF-A-SSP package | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A-SSP package | request=path}}

Name:
URL: []
Path:

"TF-A-SSP source" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A-SSP source | request=name}}<br>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=TF-A-SSP source | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=TF-A-SSP source | request=path}}

Name:
URL: []
Path:

"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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE package | request=url}}]<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
URL: [6]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE source | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=OP-TEE source  | request=path}}

Name: 3.3.0.tar.gz
URL: []
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=STM32CubeMP1 | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=STM32CubeMP1 | request=path}}

Name: en.stm32cubemp1_v1-2-0.zip
URL: [7]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=Debug symbol files | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=Debug symbol files | request=path}}

Name: en.DEBUG-stm32mp1-openstlinux-20-02-19.tar.xz
URL: [8]
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>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=OpenSTLinux distribution | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=OpenSTLinux distribution | request=path}}

Name: openstlinux-20-02-19
URL: [9]
Path:

"GDB" name and path for v1.2.0 revision requested
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=GDB | request=name}}<br>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=GDB | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=GDB | request=path}}

Name: arm-ostl-linux-gnueabi-gdb
URL: []
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>
URL: [{{EcosystemRelease/Package | revision=latest | package=Images | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=latest | package=Images | 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-20-02-19.tar.xz
URL: [10]
Path: openstlinux-20-02-19/images/stm32mp1
Name: environment-setup-cortexa7hf-neon-vfpv4-ostl-linux-gnueabi
URL: []
Path:
Name: en.SOURCES-kernel-stm32mp1-openstlinux-20-02-19.tar.xz
URL: [11]
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>
URL: [{{EcosystemRelease/Package | revision=2.0.0 | package=Images | request=url}}]<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>
URL: [{{EcosystemRelease/Package | revision=2.0.0 | package=SDK setup script | request=url}}]<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>
URL: [{{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=2.0.0 | package=Linux kernel package | request=path}}

Name: TBC.tar.xz
URL: [TBC]
Path: TBC
Name: environment-setup-TBC
URL: []
Path:
Name: TBC.tar.xz
URL: [TBC]
Path: TBC

"Linux kernel package" name 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
URL: [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>
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
URL: [unknown revision]
Path: unknown revision

Unspecified package
Name: {{EcosystemRelease/Package | revision=1.2.0 | request=name}}<br>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | request=path}}

Name: unknown package
URL: [unknown package]
Path: unknown package

Unknown package
Name: {{EcosystemRelease/Package | revision=1.2.0 | package=not supported | request=name}}<br>
URL: [{{EcosystemRelease/Package | revision=1.2.0 | package=not supported | request=url}}]<br>
Path: {{EcosystemRelease/Package | revision=1.2.0 | package=not supported | request=path}}

Name: unknown package
URL: [unknown package]
Path: unknown package

Unspecified request
{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel package}}

unknown request

Unknown request
{{EcosystemRelease/Package | revision=1.2.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=1.2.0 | package=Linux kernel package | request=name}}AFTER<br>
BEFORE[{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel package | request=url}}]AFTER<br>
BEFORE{{EcosystemRelease/Package | revision=1.2.0 | package=Linux kernel package | request=path}}AFTER

BEFOREen.SOURCES-kernel-stm32mp1-openstlinux-20-02-19.tar.xzAFTER
BEFORE[12]AFTER
BEFOREstm32mp1-openstlinux-20-02-19/sources/arm-ostl-linux-gnueabi/linux-stm32mp-4.19-r0AFTER

4. Code[edit source]

unknown revisionunknown request