1. Usage[edit source]
The CodeSource template is used to indicate the URL of any Linux® kernel, U-Boot, TF-A, OP-TEE OS, STM32CubeMP1, stm32mp BSP layer, openstlinux framework layer, or Android file used in this wiki.
Usage: {{CodeSource | <domain> | repo=<repo> | <path> | <link text> | <version>}}
- Where:
- <domain> is the mandatory 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.
- meta-st-stm32mp: the file belongs to the meta-st-stm32mp BSP layer domain.
- meta-st-openstlinux: the file belongs to the meta-st-openstlinux framework layer domain.
- Android: the file belongs to the Android domain.
- <path> is the mandatory relative path of the file from the root URL of the domain; 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/"). The root URLs are:- STMicroelectronics Linux kernel git repository for the Linux kernel domain: 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
- STMicroelectronics U-Boot git repository for the U-Boot domain: 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
- STMicroelectronics TF-A git repository for the TF-A domain: 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
- STMicroelectronics OP-TEE git repository for the OP-TEE OS domain: 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
- STMicroelectronics STM32CubeMP1 git repository for the STM32CubeMP1 domain: https://github.com/STMicroelectronics/STM32CubeMP1
- STMicroelectronics meta-st-stm32mp git repository for the meta-st-stm32mp layer domain: https://github.com/STMicroelectronics/meta-st-stm32mp
- STMicroelectronics meta-st-openstlinux git repository for the meta-st-openstlinux layer domain: https://github.com/STMicroelectronics/meta-st-openstlinux
- Google Android <repo> git repository for the Android domain: https://android.googlesource.com/<repo>
- STMicroelectronics Linux kernel git repository for the Linux kernel domain: https://github.com/STMicroelectronics/linux. Alternatives that would be possible:
- <repo> is the mandatory repository in the Google Android git. This named parameter is ignored for all other domains than Android.
- <link text> is an optional link text (text that is displayed instead of the URL).
- <version> is an optional version number (branch or tag) if the default one doesn't fit. Per default, the URL points to:
- the v5.4-stm32mp branch of the Linux kernel (Kernel.org alternative: linux-5.4.y / Bootlin alternative: latest stable)
- the v2020.01-stm32mp branch of the U-Boot (Das U-Boot alternative: master / Bootlin alternative: latest stable)
- the v2.2-stm32mp branch of the TF-A (ARM Trusted Firmware alternative: master / Bootlin alternative: latest stable)
- the 3.9.0-stm32mp branch of the OP-TEE OS (Open Portable Trusted Execution Environment alternative: master)
- the 1.3.0 tag of the STM32CubeMP1
- the dunfell branch of the meta-st-stm32mp layer
- the dunfell branch of the meta-st-openstlinux layer
- the android-10.0.0_r22 tag of Android
2. Basic examples[edit source]
You type | You get |
---|---|
Linux kernel
1- {{CodeSource | Linux kernel | Makefile}} 2- {{CodeSource | Linux kernel | arch/arm/boot/dts/}} |
1- Makefile |
U-Boot
1- {{CodeSource | U-Boot | Makefile}} 2- {{CodeSource | U-Boot | arch/arm/dts/}} |
1- Makefile |
TF-A
1- {{CodeSource | TF-A | Makefile}} 2- {{CodeSource | TF-A | fdts/}} |
|
OP-TEE_OS
1- {{CodeSource | OP-TEE_OS | Makefile}} 2- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/}} |
|
STM32CubeMP1
1- {{CodeSource | STM32CubeMP1 | Readme.md}}
2- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/}}
|
|
meta-st-stm32mp
1- {{CodeSource | meta-st-stm32mp | README.md}} 2- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/}} |
|
meta-st-openstlinux
1- {{CodeSource | meta-st-openstlinux | README.md}} 2- {{CodeSource | meta-st-openstlinux | recipes-multimedia/gstreamer/gstreamer1.0-plugins-bad/}} |
1- README.md |
Android
1- {{CodeSource | Android | repo=platform/build | README.md}} 2- {{CodeSource | Android | repo=platform/packages/apps/Settings | src/com/android/settings/}} |
1- platform/build/README.md |
3. More examples[edit source]
You type | You get |
---|---|
Linux kernel: regular file
1- {{CodeSource | Linux kernel | Makefile}} 2- {{CodeSource | Linux kernel | Makefile | Linux kernel root makefile - Makefile}} 3- {{CodeSource | Linux kernel | Makefile | | 4.19}} 4- {{CodeSource | Linux kernel | Makefile | Linux kernel root makefile - Makefile | 4.19}} 5- {{CodeSource | Linux kernel | repo=ignored | Makefile | Linux kernel root makefile - Makefile | 4.19}} |
1- Makefile |
Linux kernel: directory
1- {{CodeSource | Linux kernel | arch/arm/boot/dts/}} 2- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | arch/arm/boot/dts/stm32mp15*}} 3- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | | 4.19}} 4- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | arch/arm/boot/dts/stm32mp15* | 4.19}} 5- {{CodeSource | Linux kernel | arch/arm/boot/dts/ | repo=ignored | arch/arm/boot/dts/stm32mp15* | 4.19}} |
1- arch/arm/boot/dts/ |
U-Boot: regular file
1- {{CodeSource | U-Boot | Makefile}} 2- {{CodeSource | U-Boot | Makefile | U-Boot root makefile - Makefile}} 3- {{CodeSource | U-Boot | Makefile | | 2018.03}} 4- {{CodeSource | U-Boot | Makefile | U-Boot root makefile - Makefile | 2018.03}} 5- {{CodeSource | U-Boot | Makefile | U-Boot root makefile - Makefile | repo=ignored | 2018.03}} |
1- Makefile |
U-Boot: directory
1- {{CodeSource | U-Boot | arch/arm/dts/}} 2- {{CodeSource | U-Boot | arch/arm/dts/ | arch/arm/dts/stm32mp15*}} 3- {{CodeSource | U-Boot | arch/arm/dts/ | | 2018.03}} 4- {{CodeSource | U-Boot | arch/arm/dts/ | arch/arm/dts/stm32mp15* | 2018.03}} 5- {{CodeSource | repo=ignored | U-Boot | arch/arm/dts/ | arch/arm/dts/stm32mp15* | 2018.03}} |
1- arch/arm/dts/ |
TF-A: regular file
1- {{CodeSource | TF-A | Makefile}} 2- {{CodeSource | TF-A | Makefile | TF-A root makefile - Makefile}} 3- {{CodeSource | TF-A | Makefile | | 1.4}} 4- {{CodeSource | TF-A | Makefile | TF-A root makefile - Makefile | 1.4}} 5- {{CodeSource | TF-A | repo=ignored | Makefile}} |
1- Makefile |
TF-A: directory
1- {{CodeSource | TF-A | fdts/}} 2- {{CodeSource | TF-A | fdts/ | fdts/stm32mp15*}} 3- {{CodeSource | TF-A | fdts/ | | 1.4}} 4- {{CodeSource | TF-A | fdts/ | fdts/stm32mp15* | 1.4}} 5- {{CodeSource | TF-A | repo=ignored | fdts/ | fdts/stm32mp15*}} |
1- fdts/ |
OP-TEE_OS: regular file
1- {{CodeSource | OP-TEE_OS | Makefile}} 2- {{CodeSource | OP-TEE_OS | Makefile | OP-TEE OS root makefile - Makefile}} 3- {{CodeSource | OP-TEE_OS | Makefile | | 3.0.0}} 4- {{CodeSource | OP-TEE_OS | Makefile | OP-TEE OS root makefile - Makefile | 3.0.0}} 5- {{CodeSource | OP-TEE_OS | Makefile | | 3.0.0 | repo=ignored}} |
1- Makefile |
OP-TEE_OS: directory
1- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/}} 2- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/ | core/arch/arm/kernel/*}} 3- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/ | | 3.0.0}} 4- {{CodeSource | OP-TEE_OS | core/arch/arm/kernel/ | core/arch/arm/kernel/* | 3.0.0}} 5- {{CodeSource | OP-TEE_OS | repo=ignored | core/arch/arm/kernel/ | | 3.0.0}} |
1- core/arch/arm/kernel/ |
STM32CubeMP1: regular file
1- {{CodeSource | STM32CubeMP1 | Readme.md}} 2- {{CodeSource | STM32CubeMP1 | Readme.md | STM32CubeMP1 readme}} 3- {{CodeSource | STM32CubeMP1 | Readme.md | | master}} 4- {{CodeSource | STM32CubeMP1 | Readme.md | STM32CubeMP1 readme | master}} 5- {{CodeSource | STM32CubeMP1 | Readme.md | STM32CubeMP1 readme | repo=ignored | master}} |
1- Readme.md |
STM32CubeMP1: directory
1- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/}} 2- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/ | Drivers/STM32MP1xx_HAL_Driver/Src/*}} 3- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/ | | master}} 4- {{CodeSource | STM32CubeMP1 | Drivers/STM32MP1xx_HAL_Driver/Src/ | Drivers/STM32MP1xx_HAL_Driver/Src/* | master}} 5- {{CodeSource | STM32CubeMP1 | repo=ignored | Drivers/STM32MP1xx_HAL_Driver/Src/}} |
1- Drivers/STM32MP1xx_HAL_Driver/Src/ |
meta-st-stm32mp: regular file
1- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/README.HOW_TO.txt}} 2- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/README.HOW_TO.txt | Helper file for Linux build}} 3- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/README.HOW_TO.txt | | openstlinux-4.19-thud-mp1-19-02-20}} 4- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/README.HOW_TO.txt | Helper file for Linux build | openstlinux-4.19-thud-mp1-19-02-20}} 5- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/README.HOW_TO.txt | Helper file for Linux build | repo=ignored | openstlinux-4.19-thud-mp1-19-02-20}} |
1- recipes-kernel/linux/linux-stm32mp/README.HOW_TO.txt |
meta-st-stm32mp: directory
1- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/}} 2- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/ | recipes-kernel/linux/linux-stm32mp/}} 3- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/ | | openstlinux-4.19-thud-mp1-19-02-20}} 4- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/ | recipes-kernel/linux/linux-stm32mp/ | openstlinux-4.19-thud-mp1-19-02-20}} 5- {{CodeSource | meta-st-stm32mp | recipes-kernel/linux/linux-stm32mp/ | recipes-kernel/linux/linux-stm32mp/ | repo=ignored | openstlinux-4.19-thud-mp1-19-02-20}} |
1- recipes-kernel/linux/linux-stm32mp/ |
meta-st-openstlinux: regular file
1- {{CodeSource | meta-st-openstlinux | README.md}} 2- {{CodeSource | meta-st-openstlinux | README.md | meta-st-openstlinux readme}} 3- {{CodeSource | meta-st-openstlinux | README.md | | openstlinux-4.19-thud-mp1-19-02-20}} 4- {{CodeSource | meta-st-openstlinux | README.md | meta-st-openstlinux readme | openstlinux-4.19-thud-mp1-19-02-20}} 5- {{CodeSource | meta-st-openstlinux | README.md | meta-st-openstlinux readme | repo=ignored | openstlinux-4.19-thud-mp1-19-02-20}} |
1- README.md |
meta-st-openstlinux: directory
1- {{CodeSource | meta-st-openstlinux | recipes-multimedia/gstreamer/}} 2- {{CodeSource | meta-st-openstlinux | recipes-multimedia/gstreamer/ | GStreamer recipes}} 3- {{CodeSource | meta-st-openstlinux | recipes-multimedia/gstreamer/ | | openstlinux-4.19-thud-mp1-19-02-20}} 4- {{CodeSource | meta-st-openstlinux | recipes-multimedia/gstreamer/ | GStreamer recipes | openstlinux-4.19-thud-mp1-19-02-20}} 5- {{CodeSource | meta-st-openstlinux | recipes-multimedia/gstreamer/ | GStreamer recipes | repo=ignored | openstlinux-4.19-thud-mp1-19-02-20}} |
1- recipes-multimedia/gstreamer/ |
Android: regular file
1- {{CodeSource | Android | repo=platform/build | core/main.mk}} 2- {{CodeSource | Android | repo=platform/build | core/main.mk | Main configuration}} 3- {{CodeSource | Android | repo=platform/build | core/main.mk | | android-8.1.0_r66}} 4- {{CodeSource | Android | repo=platform/build | core/main.mk | Main configuration | android-8.1.0_r66}} 5- {{CodeSource | Android | core/main.mk}} |
1- platform/build/core/main.mk |
Android: directory
1- {{CodeSource | Android | repo=platform/build | target/product/}} 2- {{CodeSource | Android | repo=platform/build | target/product/ | platform/build/target/product/*}} 3- {{CodeSource | Android | repo=platform/build | target/product/ | | android-8.1.0_r66}} 4- {{CodeSource | Android | repo=platform/build | target/product/ | platform/build/target/product/* | android-8.1.0_r66}} 5- {{CodeSource | Android | target/product/}} |
1- platform/build/target/product/ |
Unsupported domain
{{CodeSource | Unsupported domain | Makefile}} |
Unsupported domain! |
4. Code[edit source]
Linux kernel:
- For STMicroelectronics git
[https://github.com/STMicroelectronics/linux/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|v{{#replace:{{{4|}}}| |}}|v5.4-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-5.4.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|}}}| |}}|v2020.01-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.2-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.9.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.3.0}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|({{#replace:{{{4|}}}| |}})}}]
meta-st-stm32mp
- For STM STMicroelectronics git
[https://github.com/STMicroelectronics/meta-st-stm32mp/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|dunfell}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|({{#replace:{{{4|}}}| |}})}}]
meta-st-openstlinux
- For STM STMicroelectronics git
[https://github.com/STMicroelectronics/meta-st-openstlinux/{{#ifeq:{{#sub:{{{2}}}|-1}}|/|tree|blob}}/{{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|dunfell}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{2}}}}} {{#if: {{{4|}}}|({{#replace:{{{4|}}}| |}})}}]
Android
- For Google Android git
[https://android.googlesource.com/{{{repo|}}}/+/refs/tags/{{#if: {{{4|}}}|{{#replace:{{{4|}}}| |}}|android-10.0.0_r22}}/{{#replace:{{{2|}}}| |}} {{#if: {{{3|}}}|{{{3}}}|{{{repo|}}}/{{#replace:{{{2|}}}| |}}}} {{#if: {{{4|}}}|({{#replace:{{{4|}}}| |}})}}]
Unsupported domain!