CodeSource

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 and 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.
- 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
- Google Android <repo> git repository for the Android domain: https://android.googlesource.com/<repo>

<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 if the default one doesn't fit. 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.2.0 version of the STM32CubeMP1
- the android-10.0.0_r22 version 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 2- arch/arm/boot/dts/
U-Boot 1- {{CodeSource \| U-Boot \| Makefile}} 2- {{CodeSource \| U-Boot \| arch/arm/dts/}}	1- Makefile 2- arch/arm/dts/
TF-A 1- {{CodeSource \| TF-A \| Makefile}} 2- {{CodeSource \| TF-A \| fdts/}}	1- Makefile 2- fdts/
OP-TEE_OS 1- {{CodeSource \| OP-TEE_OS \| Makefile}} 2- {{CodeSource \| OP-TEE_OS \| core/arch/arm/kernel/}}	1- Makefile 2- core/arch/arm/kernel/
STM32CubeMP1 1- {{CodeSource \| STM32CubeMP1 \| Readme.md}} 2- {{CodeSource \| STM32CubeMP1 \| Drivers/STM32MP1xx_HAL_Driver/Src/}}	1- Readme.md 2- Drivers/STM32MP1xx_HAL_Driver/Src/
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 2- platform/packages/apps/Settings/src/com/android/settings/

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.20}} 4- {{CodeSource \| Linux kernel \| Makefile \| Linux kernel root makefile - Makefile \| 4.20}} 5- {{CodeSource \| Linux kernel \| repo=ignored \| Makefile \| Linux kernel root makefile - Makefile \| 4.20}}	1- Makefile 2- Linux kernel root makefile - Makefile 3- Makefile (v4.20) 4- Linux kernel root makefile - Makefile (v4.20) 5- Linux kernel root makefile - Makefile (v4.20)
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.20}} 4- {{CodeSource \| Linux kernel \| arch/arm/boot/dts/ \| arch/arm/boot/dts/stm32mp15 \| 4.20}} 5- {{CodeSource \| Linux kernel \| arch/arm/boot/dts/ \| repo=ignored \| arch/arm/boot/dts/stm32mp15* \| 4.20}}	1- arch/arm/boot/dts/ 2- arch/arm/boot/dts/stm32mp15* 3- arch/arm/boot/dts/ (v4.20) 4- arch/arm/boot/dts/stm32mp15* (v4.20) 5- arch/arm/boot/dts/stm32mp15* (v4.20)
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 2- U-Boot root makefile - Makefile 3- Makefile (v2018.03) 4- U-Boot root makefile - Makefile (v2018.03) 5- U-Boot root makefile - Makefile (v2018.03)
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/ 2- arch/arm/dts/stm32mp15* 3- arch/arm/dts/ (v2018.03) 4- arch/arm/dts/stm32mp15* (v2018.03) 5- arch/arm/dts/stm32mp15* (v2018.03)
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 2- TF-A root makefile - Makefile 3- Makefile (v1.4) 4- TF-A root makefile - Makefile (v1.4) 5- 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/ 2- fdts/stm32mp15* 3- fdts/ (v1.4) 4- fdts/stm32mp15* (v1.4) 5- fdts/stm32mp15*
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.3.0}} 4- {{CodeSource \| OP-TEE_OS \| Makefile \| OP-TEE OS root makefile - Makefile \| 3.3.0}} 5- {{CodeSource \| OP-TEE_OS \| Makefile \| \| 3.3.0 \| repo=ignored}}	1- Makefile 2- OP-TEE OS root makefile - Makefile 3- Makefile (3.3.0) 4- OP-TEE OS root makefile - Makefile (3.3.0) 5- Makefile (3.3.0)
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.3.0}} 4- {{CodeSource \| OP-TEE_OS \| core/arch/arm/kernel/ \| core/arch/arm/kernel/ \| 3.3.0}} 5- {{CodeSource \| OP-TEE_OS \| repo=ignored \| core/arch/arm/kernel/ \| \| 3.3.0}}	1- core/arch/arm/kernel/ 2- core/arch/arm/kernel/* 3- core/arch/arm/kernel/ (3.3.0) 4- core/arch/arm/kernel/* (3.3.0) 5- core/arch/arm/kernel/ (3.3.0)
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 2- STM32CubeMP1 readme 3- Readme.md (master) 4- STM32CubeMP1 readme (master) 5- STM32CubeMP1 readme (master)
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/ 2- Drivers/STM32MP1xx_HAL_Driver/Src/* 3- Drivers/STM32MP1xx_HAL_Driver/Src/ (master) 4- Drivers/STM32MP1xx_HAL_Driver/Src/* (master) 5- Drivers/STM32MP1xx_HAL_Driver/Src/
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 2- Main configuration 3- platform/build/core/main.mk (android-8.1.0_r66) 4- Main configuration (android-8.1.0_r66) 5- /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/ 2- platform/build/target/product/* 3- platform/build/target/product/ (android-8.1.0_r66) 4- platform/build/target/product/* (android-8.1.0_r66) 5- /target/product/
Unsupported domain {{CodeSource \| Unsupported domain \| Makefile}}	Unsupported domain!

4. 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.2.0}}/{{#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!