1. Usage[edit source]
This template is used to indicate the URL of any Linux® kernel, U-Boot, TF-A and OP-TEE file used in this user guide.
It takes as first parameter a string that identifies the domain of the file. The possible values are:
- Linux kernel: the file belongs to the Linux kernel domain.
- U-Boot: the file belongs to the U-Boot domain.
- TF-A: the file belongs to the TF-A domain.
- OP-TEE_OS: the file belongs to the OP-TEE domain.
The second parameter is the relative path of the file from the root URL of the domain:
- Kernel.org git repository (Bootlin alternative: Bootlin Elixir Cross Referencer) for the Linux kernel: https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree (Bootlin alternative: https://elixir.bootlin.com/linux/latest/source).
- Das U-Boot git repository (Bootlin alternative: Bootlin Elixir Cross Referencer) for the U-Boot: http://git.denx.de/?p=u-boot.git;a=tree (Bootlin alternative: https://elixir.bootlin.com/u-boot/latest/source).
- ARM Trusted Firmware git repository (Bootlin alternative: Bootlin Elixir Cross Referencer) for the TF-A: https://github.com/ARM-software/arm-trusted-firmware (Bootlin alternative: https://elixir.bootlin.com/arm-trusted-firmware/latest/source).
- Open Portable Trusted Execution Environment git repository for the OP-TEE OS: https://github.com/OP-TEE/optee_os/tree.
If the file is a directory (e.g. "arch/arm/boot/dts" directory for the Linux kernel), the parameter must end with the slash (/) character (e.g. ""arch/arm/boot/dts/").
It takes as optional third parameter, the link text (text that is displayed instead of the URL).
Per default, the URL points to the linux-4.19.y (Bootlin alternative: latest stable) version of the Linux kernel, and to the master (Bootlin alternative: latest stable) version of the U-Boot, TF-A or OP-TEE. The optional fourth parameter of this template is used to specify another Linux kernel, U-Boot, TF-A or OP-TEE version than the default one.
Linux kernel:
Regular file
- {{CodeSource | Linux kernel | Makefile}}
- {{CodeSource | Linux kernel | Makefile | Linux kernel root makefile - Makefile}}
- {{CodeSource | Linux kernel | Makefile | | 4.14.48}}
- {{CodeSource | Linux kernel | Makefile | Linux kernel root makefile - Makefile | 4.14.48}}
Directory
- {{CodeSource | Linux kernel | arch/arm/boot/dts/}}
- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | arch/arm/boot/dts/stm32mp15*}}
- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | | 4.14.48}}
- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | arch/arm/boot/dts/stm32mp15* | 4.14.48 }}
U-Boot::
Regular file
- {{CodeSource | U-Boot | Makefile}}
- {{CodeSource | U-Boot | Makefile | U-Boot root makefile - Makefile}}
- {{CodeSource | U-Boot | Makefile | | 2018.03}}
- {{CodeSource | U-Boot | Makefile | U-Boot root makefile - Makefile | 2018.03}}
Directory
- {{CodeSource | U-Boot | arch/arm/dts/}}
- {{CodeSource | U-Boot | arch/arm/dts/ | arch/arm/dts/stm32mp15*}}
- {{CodeSource | U-Boot | arch/arm/dts/ | | 2018.03}}
- {{CodeSource | U-Boot | arch/arm/dts/ | arch/arm/dts/stm32mp15* | 2018.03}}
TF-A::
Regular file
- {{CodeSource | TF-A | Makefile}}
- {{CodeSource | TF-A | Makefile | TF-A root makefile - Makefile}}
- {{CodeSource | TF-A | Makefile | | 1.4}}
- {{CodeSource | TF-A | Makefile | TF-A root makefile - Makefile | 1.4}}
Directory
- {{CodeSource | TF-A | fdts/}}
- {{CodeSource | TF-A | fdts/ | fdts/stm32mp15*}}
- {{CodeSource | TF-A | fdts/ | | 1.4}}
- {{CodeSource | TF-A | fdts/ | fdts/stm32mp15* | 1.4}}
OP-TEE::
Regular file
- {{CodeSource | OP-TEE_OS | Makefile}}
- {{CodeSource | OP-TEE_OS | Makefile | OP-TEE OS root makefile - Makefile}}
- {{CodeSource | OP-TEE_OS | Makefile | | 3.3.0}}
- {{CodeSource | OP-TEE_OS | Makefile | OP-TEE OS root makefile - Makefile | 3.3.0}}
Directory
- {{CodeSource | OP-TEE_OS | core/arch/arm/fdts/}}
- {{CodeSource | OP-TEE_OS | core/arch/arm/fdts/ | core/arch/arm/fdts/stm32mp15*}}
- {{CodeSource | OP-TEE_OS | core/arch/arm/fdts/ | | 3.3.0}
- {{CodeSource | OP-TEE_OS | core/arch/arm/fdts/ | core/arch/arm/fdts/stm32mp15* | 3.3.0}}
2. Example[edit source]
Linux kernel:
Regular file
- Makefile
- Linux kernel root makefile - Makefile
- Makefile (v4.14.48)
- Linux kernel root makefile - Makefile (v4.14.48)
Directory
- arch/arm/boot/dts/
- arch/arm/boot/dts/stm32mp15*
- arch/arm/boot/dts/ (v4.14.48)
- arch/arm/boot/dts/stm32mp15* (v4.14.48)
U-Boot:
Regular file
- Makefile (master)
- U-Boot root makefile - Makefile (master)
- Makefile (v2018.03)
- U-Boot root makefile - Makefile (v2018.03)
Directory
- arch/arm/dts/ (master)
- arch/arm/dts/stm32mp15* (master)
- arch/arm/dts/ (v2018.03)
- arch/arm/dts/stm32mp15* (v2018.03)
TF-A:
Regular file
- Makefile (master)
- TF-A root makefile - Makefile (master)
- Makefile (v1.4)
- TF-A root makefile - Makefile (v1.4)
Directory
OP-TEE_OS:
Regular file
- Makefile (master)
- OP-TEE OS root makefile - Makefile (master)
- Makefile (v3.3.0)
- OP-TEE OS root makefile - Makefile (v3.3.0)
Directory
- core/arch/arm/fdts/ (master)
- core/arch/arm/fdts/stm32mp15* (master)
- core/arch/arm/fdts/ (v3.3.0)
- core/arch/arm/fdts/stm32mp15* (v3.3.0)
Bad parameters:
- Error (unsupported domain)
3. Code[edit source]
Linux kernel:
- For Kernel.org git
[https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/{{#replace:{{{2|}}}| |}}?h={{#if: {{{4|}}}|v{{#replace:{{{4|}}}||}}|linux-4.19.y}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|(v{{#replace:{{{4|}}}| |}})}}]
- For Bootlin alternative
[https://elixir.bootlin.com/linux/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|latest}}/source/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|latest stable}})]
U-Boot:
- For U-Boot git
[http://git.denx.de/?p=u-boot.git;a={{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}};f={{#ifeq:{{#sub:{{{2}}}|-1}}|/|{{#sub:{{{2}}}|0|-1}}|{{#sub:{{{2}}}|0}}}};hb={{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|master}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|master}})]
- For Bootlin alternative
[https://elixir.bootlin.com/u-boot/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|latest}}/source/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|latest stable}})]
TF-A
- For ARM Trusted Firmware git
[https://github.com/ARM-software/arm-trusted-firmware/blob/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|master}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|master}})]
- For Bootlin alternative
[https://elixir.bootlin.com/arm-trusted-firmware/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|latest}}/source/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|latest stable}})]
OP-TEE_OS
- For OP-TEE OS git
[https://github.com/OP-TEE/optee_os/blob/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|master}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|master}})]
Error (unsupported domain)