1. Usage[edit source]
This template is used to indicate the URL of any Linux® kernel, U-Boot, TF-A, OP-TEE OS and STM32CubeMP1 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 OS domain.
- STM32CubeMP1: the file belongs to the STM32CubeMP1 domain.
The second parameter is the relative path of the file from the root URL of the domain:
- STMicroelectronics Linux kernel git repository for the Linux kernel: https://github.com/STMicroelectronics/linux
- Alternatives that would be possible:
- Kernel.org git repository: https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree
- Bootlin Elixir Cross Referencer: https://elixir.bootlin.com/linux/latest/source
- Alternatives that would be possible:
- STMicroelectronics U-Boot git repository for the U-Boot: https://github.com/STMicroelectronics/u-boot
- Alternatives that would be possible:
- Das U-Boot git repository: http://git.denx.de/?p=u-boot.git;a=tree
- Bootlin Elixir Cross Referencer: https://elixir.bootlin.com/u-boot/latest/source
- Alternatives that would be possible:
- STMicroelectronics TF-A git repository for the TF-A: https://github.com/STMicroelectronics/arm-trusted-firmware
- Alternatives that would be possible:
- ARM Trusted Firmware git repository: https://github.com/ARM-software/arm-trusted-firmware
- Bootlin Elixir Cross Referencer: https://elixir.bootlin.com/arm-trusted-firmware/latest/source
- Alternatives that would be possible:
- STMicroelectronics OP-TEE git repository for the OP-TEE OS: https://github.com/STMicroelectronics/optee_os
- Alternative that would be possible:
- Open Portable Trusted Execution Environment git repository: https://github.com/OP-TEE/optee_os
- Alternative that would be possible:
- STMicroelectronics STM32CubeMP1 git repository for the STM32CubeMP1: https://github.com/STMicroelectronics/STM32CubeMP1
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 v4.19-stm32mp version of the Linux kernel (Kernel.org alternative: linux-4.19.y / Bootlin alternative: latest stable)
- the v2018.11-stm32mp version of the U-Boot (Das U-Boot alternative: master / Bootlin alternative: latest stable)
- the v2.0-stm32mp version of the TF-A (ARM Trusted Firmware alternative: master / Bootlin alternative: latest stable)
- the 3.3.0-stm32mp version of the OP-TEE OS (Open Portable Trusted Execution Environment alternative: master)
- the 1.0.0 version of the STM32CubeMP1
2. Example[edit source]
Linux kernel:
Regular file
- {{CodeSource | Linux kernel | Makefile}}
- {{CodeSource | Linux kernel | Makefile | Linux kernel root makefile - Makefile}}
- {{CodeSource | Linux kernel | Makefile | | 4.20}}
- {{CodeSource | Linux kernel | Makefile | Linux kernel root makefile - Makefile | 4.20}}
- Makefile
- Linux kernel root makefile - Makefile
- Makefile (v4.20)
- Linux kernel root makefile - Makefile (v4.20)
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.20}}
- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | arch/arm/boot/dts/stm32mp15* | 4.20}}
- arch/arm/boot/dts/
- arch/arm/boot/dts/stm32mp15*
- arch/arm/boot/dts/ (v4.20)
- arch/arm/boot/dts/stm32mp15* (v4.20)
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}}
- Makefile
- U-Boot root makefile - Makefile
- Makefile (v2018.03)
- U-Boot root makefile - Makefile (v2018.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}}
- arch/arm/dts/
- arch/arm/dts/stm32mp15*
- arch/arm/dts/ (v2018.03)
- arch/arm/dts/stm32mp15* (v2018.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}}
- Makefile
- TF-A root makefile - Makefile
- Makefile (v1.4)
- TF-A root makefile - Makefile (v1.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}}
- fdts/
- fdts/stm32mp15*
- fdts/ (v1.4)
- fdts/stm32mp15* (v1.4)
OP-TEE_OS:
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}}
- Makefile
- OP-TEE OS root makefile - Makefile
- Makefile (3.3.0)
- OP-TEE OS root makefile - Makefile (3.3.0)
Directory
- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/}}
- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/ | core/arch/arm/kernel/*}}
- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/ | | 3.3.0}
- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/ | core/arch/arm/kernel/* | 3.3.0}}
- core/arch/arm/kernel/
- core/arch/arm/kernel/*
- core/arch/arm/kernel/ (3.3.0)
- core/arch/arm/kernel/* (3.3.0)
STM32CubeMP1:
Regular file
- {{CodeSource | STM32CubeMP1 | Readme.md}}
- {{CodeSource | STM32CubeMP1 | Readme.md | STM32CubeMP1 readme}}
- {{CodeSource | STM32CubeMP1 | Readme.md | | master}}
- {{CodeSource | STM32CubeMP1 | Readme.md | STM32CubeMP1 readme | master}}
- Readme.md
- STM32CubeMP1 readme
- Readme.md (master)
- STM32CubeMP1 readme (master)
Directory
- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/}}
- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/ | Drivers/STM32MP1xx_HAL_Driver/Src/*}}
- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/ | | master}
- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/ | Drivers/STM32MP1xx_HAL_Driver/Src/* | master}}
- Drivers/STM32MP1xx_HAL_Driver/Src/
- Drivers/STM32MP1xx_HAL_Driver/Src/*
- Drivers/STM32MP1xx_HAL_Driver/Src/ (master)
- Drivers/STM32MP1xx_HAL_Driver/Src/* (master)
Bad parameters:
- Error (unsupported domain)
3. Code[edit source]
Linux kernel:
- For STM STMicroelectronics git
[https://github.com/STMicroelectronics/linux/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|v4.19-stm32mp}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|(v{{#replace:{{{4|}}}| |}})}}]
- 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 STM STMicroelectronics git
[https://github.com/STMicroelectronics/u-boot/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|v2018.11-stm32mp}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|(v{{#replace:{{{4|}}}| |}})}}]
- For U-Boot git alternative
[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 STM STMicroelectronics git
[https://github.com/STMicroelectronics/arm-trusted-firmware/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|v2.0-stm32mp}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|(v{{#replace:{{{4|}}}| |}})}}]
- For ARM Trusted Firmware git alternative
[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 STM STMicroelectronics git
[https://github.com/STMicroelectronics/optee_os/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|3.3.0-stm32mp}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|({{#replace:{{{4|}}}| |}})}}]
- For OP-TEE OS git alternative
[https://github.com/OP-TEE/optee_os/blob/{{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|master}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} ({{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|master}})]
STM32CubeMP1
- For STM STMicroelectronics git
[https://github.com/STMicroelectronics/STM32CubeMP1/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|1.0.0}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|({{#replace:{{{4|}}}| |}})}}]
Error (unsupported domain)