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 <[email protected]> --- Cc: Heinrich Schuchardt <[email protected]> Cc: Nobuhiro Iwamatsu <[email protected]> Cc: Tom Rini <[email protected]> Cc: [email protected] --- 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
