[PATCH v4 3/3] board: toradex: add verdin am62 support
Nishanth Menon
nm at ti.com
Thu Aug 3 00:54:51 CEST 2023
On 22:54-20230728, Marcel Ziswiler wrote:
> From: Marcel Ziswiler <marcel.ziswiler at toradex.com>
[...]
> diff --git a/doc/board/toradex/verdin-am62.rst b/doc/board/toradex/verdin-am62.rst
> new file mode 100644
> index 00000000000..2ece3757a41
> --- /dev/null
> +++ b/doc/board/toradex/verdin-am62.rst
> @@ -0,0 +1,169 @@
> +.. SPDX-License-Identifier: GPL-2.0-or-later
> +.. sectionauthor:: Marcel Ziswiler <marcel.ziswiler at toradex.com>
> +
> +Verdin AM62 Module
> +==================
> +
> +Quick Start
> +-----------
> +
> +- Get the binary-only SYSFW
> +- Get binary-only TI Linux firmware
> +- Build the ARM trusted firmware binary
> +- Build the OPTEE binary
> +- Build U-Boot for the R5
> +- Build U-Boot for the A53
> +- Flash to eMMC
> +- Boot
> +
> +For an overview of the TI AM62 SoC boot flow please head over to:
> +.. file:: ../ti/am62x_sk.rst
> +
> +Get the SYSFW
> +-------------
> +
> +.. code-block:: bash
> +
> + $ echo "Downloading SYSFW..."
> + $ git clone git://git.ti.com/k3-image-gen/k3-image-gen.git
we dont need k3-image-gen anymore..
> +
> +Get the TI Linux Firmware
> +-------------
Umm..
https://u-boot.readthedocs.io/en/latest/build/documentation.html?highlight=htmldocs#html-documentation
make htmldocs:
u-boot/doc/board/toradex/verdin-am62.rst:31:Title underline too short.
If you like, please consider the following diff to your changes - as I
had setup am62x doc to be a bit re-usable to help keep things sane and
central:
diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
index 637985cb096e..4646bc0f5257 100644
--- a/doc/board/ti/am62x_sk.rst
+++ b/doc/board/ti/am62x_sk.rst
@@ -54,7 +54,7 @@ Below is the pictorial representation of boot flow:
Sources:
--------
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_boot_sources
:end-before: .. k3_rst_include_end_boot_sources
@@ -62,17 +62,17 @@ Build procedure:
----------------
0. Setup the environment variables:
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_common_env_vars_desc
:end-before: .. k3_rst_include_end_common_env_vars_desc
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_board_env_vars_desc
:end-before: .. k3_rst_include_end_board_env_vars_desc
Set the variables corresponding to this platform:
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_common_env_vars_defn
:end-before: .. k3_rst_include_end_common_env_vars_defn
.. code-block:: bash
@@ -89,14 +89,14 @@ Set the variables corresponding to this platform:
1. Trusted Firmware-A:
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_build_steps_tfa
:end-before: .. k3_rst_include_end_build_steps_tfa
2. OP-TEE:
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_build_steps_optee
:end-before: .. k3_rst_include_end_build_steps_optee
@@ -104,13 +104,13 @@ Set the variables corresponding to this platform:
* 4.1 R5:
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_build_steps_spl_r5
:end-before: .. k3_rst_include_end_build_steps_spl_r5
* 4.2 A53:
-.. include:: k3.rst
+.. include:: ../ti/k3.rst
:start-after: .. k3_rst_include_start_build_steps_uboot
:end-before: .. k3_rst_include_end_build_steps_uboot
.. am62x_evm_rst_include_end_build_steps
diff --git a/doc/board/ti/k3.rst b/doc/board/ti/k3.rst
index 74fdc6b41c9b..02cfd9316883 100644
--- a/doc/board/ti/k3.rst
+++ b/doc/board/ti/k3.rst
@@ -31,6 +31,7 @@ K3 Based SoCs
:maxdepth: 1
am62x_sk
+ ../toradex/verdin-am62
am64x_evm
am65x_evm
j7200_evm
diff --git a/doc/board/toradex/index.rst b/doc/board/toradex/index.rst
index ead5efbb9551..7728b9db6629 100644
--- a/doc/board/toradex/index.rst
+++ b/doc/board/toradex/index.rst
@@ -11,3 +11,4 @@ Toradex
colibri-imx8x
verdin-imx8mm
verdin-imx8mp
+ verdin-am62
diff --git a/doc/board/toradex/verdin-am62.rst b/doc/board/toradex/verdin-am62.rst
index 2ece3757a410..f5ff6638df35 100644
--- a/doc/board/toradex/verdin-am62.rst
+++ b/doc/board/toradex/verdin-am62.rst
@@ -17,79 +17,44 @@ Quick Start
- Boot
For an overview of the TI AM62 SoC boot flow please head over to:
-.. file:: ../ti/am62x_sk.rst
+:doc:`../ti/am62x_sk`
-Get the SYSFW
--------------
-
-.. code-block:: bash
-
- $ echo "Downloading SYSFW..."
- $ git clone git://git.ti.com/k3-image-gen/k3-image-gen.git
-
-Get the TI Linux Firmware
--------------
-
-.. code-block:: bash
-
- $ echo "Downloading TI Linux Firmware..."
- $ git clone -b ti-linux-firmware git://git.ti.com/processor-firmware/ti-linux-firmware.git
-
-Get and Build the ARM Trusted Firmware (Trusted Firmware A)
------------------------------------------------------------
-
-.. code-block:: bash
-
- $ echo "Downloading and building TF-A..."
- $ git clone https://github.com/ARM-software/arm-trusted-firmware.git
- $ cd arm-trusted-firmware
+Sources:
+--------
+.. include:: ../ti/k3.rst
+ :start-after: .. k3_rst_include_start_boot_sources
+ :end-before: .. k3_rst_include_end_boot_sources
-Then build ATF (TF-A):
+Build procedure:
+----------------
+0. Setup the environment variables:
-.. code-block:: bash
-
- $ export ARCH=aarch64
- $ export CROSS_COMPILE=aarch64-none-linux-gnu-
- $ make PLAT=k3 TARGET_BOARD=lite SPD=opteed
-
-Get and Build OPTEE
--------------------
-
-.. code-block:: bash
-
- $ echo "Downloading and building OPTEE..."
- $ git clone https://github.com/OP-TEE/optee_os.git
- $ cd optee_os
-
-Then build OPTEE:
-
-.. code-block:: bash
-
- $ export CROSS_COMPILE=arm-none-linux-gnueabihf-
- $ export CROSS_COMPILE64=aarch64-none-linux-gnu-
- $ make PLATFORM=k3 CFG_ARM64_core=y
-
-Build U-Boot for R5
--------------------
-
-.. code-block:: bash
+.. include:: ../ti/k3.rst
+ :start-after: .. k3_rst_include_start_common_env_vars_desc
+ :end-before: .. k3_rst_include_end_common_env_vars_desc
- $ export ARCH=arm
- $ export CROSS_COMPILE=arm-none-linux-gnueabihf-
- $ make verdin-am62_r5_defconfig
- $ make BINMAN_INDIRS=<path/to/ti-linux-firmware>
+.. include:: ../ti/k3.rst
+ :start-after: .. k3_rst_include_start_board_env_vars_desc
+ :end-before: .. k3_rst_include_end_board_env_vars_desc
-Build U-Boot for A53
---------------------
+Set the variables corresponding to this platform:
+.. include:: ../ti/k3.rst
+ :start-after: .. k3_rst_include_start_common_env_vars_defn
+ :end-before: .. k3_rst_include_end_common_env_vars_defn
.. code-block:: bash
- $ export ARCH=arm64
- $ export CROSS_COMPILE=aarch64-none-linux-gnu-
- $ make verdin-am62_a53_defconfig
- $ make BL31=<path to ATF dir>/build/k3/lite/release/bl31.bin \
- TEE=<path to OPTEE OS dir>/out/arm-plat-k3/core/tee-pager_v2.bin \
- BINMAN_INDIRS=<path/to/ti-linux-firmware>
+ $ export UBOOT_CFG_CORTEXR=verdin-am62_r5_defconfig
+ $ export UBOOT_CFG_CORTEXA=verdin-am62_a53_defconfig
+ $ export TFA_BOARD=lite
+ $ # we dont use any extra TFA parameters
+ $ unset TFA_EXTRA_ARGS
+ $ export OPTEE_PLATFORM=k3-am62x
+ $ export OPTEE_EXTRA_ARGS="CFG_WITH_SOFTWARE_PRNG=y"
+
+.. include:: ../ti/am62x_sk.rst
+ :start-after: .. am62x_evm_rst_include_start_build_steps
+ :end-before: .. am62x_evm_rst_include_end_build_steps
Flash to eMMC
-------------
--
Regards,
Nishanth Menon
Key (0xDDB5849D1736249D) / Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D
More information about the U-Boot
mailing list