[PATCH v2 32/33] Documentation: boards: k3: split generic and am62x specific documentation

Sascha Hauer s.hauer at pengutronix.de
Thu Jun 5 05:42:57 PDT 2025


The K3 documentation is currently very specific for the AM62x. Split
this up into a generic part and a AM62x specific part to make space for
other SoC support.

Signed-off-by: Sascha Hauer <s.hauer at pengutronix.de>
---
 Documentation/boards/{ti-k3.rst => ti-k3-am62x.rst} | 21 ++++++---------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/Documentation/boards/ti-k3.rst b/Documentation/boards/ti-k3-am62x.rst
similarity index 81%
rename from Documentation/boards/ti-k3.rst
rename to Documentation/boards/ti-k3-am62x.rst
index 6cb9eb8edab93e6bf7a74bc24748f9ad11609b20..a78fffdb7f4b795ca3fdb560afd7761a5c27d954 100644
--- a/Documentation/boards/ti-k3.rst
+++ b/Documentation/boards/ti-k3-am62x.rst
@@ -1,26 +1,17 @@
-TI K3 based boards
-==================
+.. _ti_k3_am62x:
 
-The TI K3 is a line of 64-bit ARM SoCs.
+TI K3 AM62x based boards
+========================
 
-The boot process of the TI K3 SoCs is a two step process. The first stage boot loader
+The TI AM62x is SoC in the line of TI K3 64-bit ARM SoCs.
+
+The boot process of the TI AM62x SoCs is a two step process. The first stage boot loader
 is loaded by the ROM code and executed on a Cortex-R5 processor. The code on this
 processor is responsible for setting up the initial clocks, power domains and DRAM.
 It then loads the binaries for the A53 cores into DRAM and starts the A53 core. From
 this point on the Cortex-R5 processor is used as a system controller which controls
 clocks and power domains of the SoC.
 
-Prerequisites
--------------
-
-There are several binary blobs required for building barebox for TI K3 SoCs. Find them
-in git://git.ti.com/processor-firmware/ti-linux-firmware.git. The repository is assumed
-to be checked out at ``firmware/ti-linux-firmware``. Alternatively the barebox repository
-has a ti-linux-firmware submodule which checks out at the correct place. The K3 SoCs boot
-from a FAT partition on SD/eMMC cards. During the next steps the files are copied to
-``$TI_BOOT``. This is assumed to be an empty directory. After the build process copy its
-contents to a FAT filesystem on an SD/eMMC card.
-
 The Cortex-R5 is a 32-bit processors whereas the Cortex-A53 are 64-bit processors, so
 both 32-bit and 64-bit toolchains are needed::
 

-- 
2.39.5




More information about the barebox mailing list