[PATCH v2 01/11] doc: board: renesas: Document SH/Aarch32/Aarch64 toolchain setup
Marek Vasut
marek.vasut+renesas at mailbox.org
Tue Jun 23 03:38:27 CEST 2026
Add documents which briefly outline how to set up the SH4/Aarch32/Aarch64
toolchains, for future use in Renesas documentation. Reference all these
documents in the renesas list of boards "Arch" column.
Signed-off-by: Marek Vasut <marek.vasut+renesas at mailbox.org>
---
Cc: Heinrich Schuchardt <xypron.glpk at gmx.de>
Cc: Nobuhiro Iwamatsu <iwamatsu at nigauri.org>
Cc: Tom Rini <trini at konsulko.com>
Cc: u-boot at lists.denx.de
---
V2: Add "a" and "the"
---
doc/board/renesas/build-env-aarch32.rst | 25 +++++++
doc/board/renesas/build-env-aarch64.rst | 25 +++++++
doc/board/renesas/build-env-sh.rst | 25 +++++++
doc/board/renesas/index.rst | 3 +
doc/board/renesas/renesas.rst | 86 ++++++++++++-------------
5 files changed, 121 insertions(+), 43 deletions(-)
create mode 100644 doc/board/renesas/build-env-aarch32.rst
create mode 100644 doc/board/renesas/build-env-aarch64.rst
create mode 100644 doc/board/renesas/build-env-sh.rst
diff --git a/doc/board/renesas/build-env-aarch32.rst b/doc/board/renesas/build-env-aarch32.rst
new file mode 100644
index 00000000000..5120a042ccb
--- /dev/null
+++ b/doc/board/renesas/build-env-aarch32.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+Renesas 32-bit ARM SoC build environment setup
+==============================================
+
+In order to cross-compile U-Boot for the ARM 32-bit target, it is necessary
+to install a suitable toolchain. The toolchain is available in various
+distribution repositories as ``arm-linux-gnueabi-*`` or similar package.
+
+Debian example:
+
+.. code-block:: console
+
+ $ apt install binutils-arm-linux-gnueabi cpp-arm-linux-gnueabi gcc-arm-linux-gnueabi
+
+Alternatively, it is possible to download prebuilt toolchain from
+kernel.org cross-development toolchains page
+https://www.kernel.org/pub/tools/crosstool/ .
+
+Once the toolchain is installed, add toolchain into ``PATH`` variable:
+
+.. code-block:: console
+
+ $ export PATH=$PATH:<path/to/arm32/toolchain/bin/>
+ $ export CROSS_COMPILE=arm-linux-gnueabi-
diff --git a/doc/board/renesas/build-env-aarch64.rst b/doc/board/renesas/build-env-aarch64.rst
new file mode 100644
index 00000000000..979b599e951
--- /dev/null
+++ b/doc/board/renesas/build-env-aarch64.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+Renesas 64-bit ARM SoC build environment setup
+==============================================
+
+In order to cross-compile U-Boot for the aarch64 target, it is necessary
+to install a suitable toolchain. The toolchain is available in various
+distribution repositories as ``aarch64-linux-gnu-*`` or similar package.
+
+Debian example:
+
+.. code-block:: console
+
+ $ apt install binutils-aarch64-linux-gnu cpp-aarch64-linux-gnu gcc-aarch64-linux-gnu
+
+Alternatively, it is possible to download prebuilt toolchain from
+kernel.org cross-development toolchains page
+https://www.kernel.org/pub/tools/crosstool/ .
+
+Once the toolchain is installed, add toolchain into ``PATH`` variable:
+
+.. code-block:: console
+
+ $ export PATH=$PATH:<path/to/arm64/toolchain/bin/>
+ $ export CROSS_COMPILE=aarch64-linux-gnu-
diff --git a/doc/board/renesas/build-env-sh.rst b/doc/board/renesas/build-env-sh.rst
new file mode 100644
index 00000000000..52f5cff8198
--- /dev/null
+++ b/doc/board/renesas/build-env-sh.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+Renesas 32-bit SH4 SoC build environment setup
+==============================================
+
+In order to cross-compile U-Boot for the SH4 32-bit target, it is necessary
+to install a suitable toolchain. The toolchain is available in various
+distribution repositories as ``sh4-linux-gnu-*`` or similar package.
+
+Debian example:
+
+.. code-block:: console
+
+ $ apt install binutils-sh4-linux-gnu cpp-sh4-linux-gnu gcc-sh4-linux-gnu
+
+Alternatively, it is possible to download prebuilt toolchain from
+kernel.org cross-development toolchains page
+https://www.kernel.org/pub/tools/crosstool/ .
+
+Once the toolchain is installed, add toolchain into ``PATH`` variable:
+
+.. code-block:: console
+
+ $ export PATH=$PATH:<path/to/sh4/toolchain/bin/>
+ $ export CROSS_COMPILE=sh4-linux-gnu-
diff --git a/doc/board/renesas/index.rst b/doc/board/renesas/index.rst
index fb6558ec11b..ef2b856a77c 100644
--- a/doc/board/renesas/index.rst
+++ b/doc/board/renesas/index.rst
@@ -7,4 +7,7 @@ Renesas
:maxdepth: 2
renesas
+ build-env-sh
+ build-env-aarch32
+ build-env-aarch64
rzn1
diff --git a/doc/board/renesas/renesas.rst b/doc/board/renesas/renesas.rst
index fcfd51aa19c..132605b0c33 100644
--- a/doc/board/renesas/renesas.rst
+++ b/doc/board/renesas/renesas.rst
@@ -27,241 +27,241 @@ Renesas is a SoC solutions provider for automotive and industrial applications.
* - R2D
- R2D-PLUS
- SH7751
- - sh
+ - :doc:`sh <build-env-sh>`
- r2dplus_defconfig
* - RZ/A1
- GR-PEACH
- R7S72100 (RZ/A1H)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- grpeach_defconfig
* - R-Car Gen2
- Lager
- R8A7790 (H2)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- lager_defconfig
* -
- Stout
- R8A7790 (H2)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- stout_defconfig
* -
- Koelsch
- R8A7791 (M2-W)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- koelsch_defconfig
* -
- Porter
- R8A7791 (M2-W)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- porter_defconfig
* -
- Blanche
- R8A7792 (V2H)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- blanche_defconfig
* -
- Gose
- R8A7793 (M2-N)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- gose_defconfig
* -
- Alt
- R8A7794 (E2)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- alt_defconfig
* -
- Silk
- R8A7794 (E2)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- silk_defconfig
* - R-Car Gen3
- - Salvator-X(S)
+ - :doc:`Salvator-X(S) <rcar-gen3-salvator-x>`
- R8A77951 (H3)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rcar3_salvator-x_defconfig
* -
- ULCB
- R8A77951 (H3)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rcar3_ulcb_defconfig
* -
- - Salvator-X(S)
+ - :doc:`Salvator-X(S) <rcar-gen3-salvator-x>`
- R8A77960 (M3-W)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rcar3_salvator-x_defconfig
* -
- ULCB
- R8A77960 (M3-W)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rcar3_ulcb_defconfig
* -
- - Salvator-X(S)
+ - :doc:`Salvator-X(S) <rcar-gen3-salvator-x>`
- R8A77965 (M3-N)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rcar3_salvator-x_defconfig
* -
- ULCB
- R8A77965 (M3-N)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rcar3_ulcb_defconfig
* -
- Geist
- R8A779MD (M3Le)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779md_geist_defconfig
* -
- Eagle
- R8A77970 (V3M)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a77970_eagle_defconfig
* -
- V3MSK
- R8A77970 (V3M)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a77970_v3msk_defconfig
* -
- Condor
- R8A77980 (V3H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a77980_condor_defconfig
* -
- V3HSK
- R8A77980 (V3H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a77980_v3hsk_defconfig
* -
- Ebisu
- R8A77990 (E3)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a77990_ebisu_defconfig
* -
- Draak
- R8A77995 (D3)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a77995_draak_defconfig
* - R-Car Gen4
- Falcon
- R8A779A0 (V3U)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779a0_falcon_defconfig
* -
- Spider
- R8A779F0 (S4)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779f0_spider_defconfig
* -
- S4SK
- R8A779F4 (S4)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779f4_s4sk_defconfig
* -
- White Hawk
- R8A779G0 (V4H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779g0_whitehawk_defconfig
* -
- Sparrow Hawk
- R8A779G3 (V4H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779g3_sparrowhawk_defconfig
* -
- Gray Hawk
- R8A779H0 (V4M)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a779h0_grayhawk_defconfig
* - R-Car Gen5
- Ironhide (Cortex-A720AE application core)
- R8A78000 (X5H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a78000_ironhide_defconfig
* -
- Ironhide (Cortex-M33 RSIP boot core)
- R8A78000 (X5H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- r8a78000_ironhide_cm33_defconfig
* - RZ/G2 Family
- Beacon EmbeddedWorks RZ/G2M SoM
- R8A774A1 (RZ/G2M)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rzg2_beacon_defconfig
* -
- HopeRun HiHope RZ/G2M
- R8A774A1 (RZ/G2M)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- hihope_rzg2_defconfig
* -
- Beacon EmbeddedWorks RZ/G2N SoM
- R8A774B1 (RZ/G2N)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rzg2_beacon_defconfig
* -
- HopeRun HiHope RZ/G2N
- R8A774B1 (RZ/G2N)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- hihope_rzg2_defconfig
* -
- Silicon Linux RZ/G2E evaluation kit (EK874)
- R8A774C0 (RZ/G2E)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- silinux_ek874_defconfig
* -
- Beacon EmbeddedWorks RZ/G2H SoM
- R8A774E1 (RZ/G2H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- rzg2_beacon_defconfig
* -
- HopeRun HiHope RZ/G2H
- R8A774E1 (RZ/G2H)
- - arm64
+ - :doc:`arm64 <build-env-aarch64>`
- hihope_rzg2_defconfig
* - :doc:`RZ/N1 Family <rzn1>`
- Schneider RZ/N1D board
- R9A06G032 (RZ/N1D)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- rzn1_snarc_defconfig
* -
- Schneider RZ/N1S board
- R9A06G033 (RZ/N1S)
- - arm
+ - :doc:`arm <build-env-aarch32>`
- rzn1_snarc_defconfig
Build
--
2.53.0
More information about the U-Boot
mailing list