From 11579773f308bb94660d5847f8e6109789523c6c Mon Sep 17 00:00:00 2001 From: Yiyoung Liu Date: Wed, 20 May 2026 09:11:59 -0500 Subject: [PATCH 1/3] refactor(linux): reorganize AM62X U-Boot build instructions The previous build structure, split by R5/A53 followed by device, meant your eyes had to jump around to find the instructions for the one device you were compiling. Instead, a better way would be to first split by device, so that users can follow one contiguous set of instructions, since they need to build both R5 and A53. Signed-off-by: Yiyoung Liu --- .../U-Boot/BG-Build-K3.rst | 38 +++++++++++-------- 1 file changed, 23 insertions(+), 15 deletions(-) diff --git a/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst b/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst index 40db13c0a..6970bf1dd 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst @@ -308,33 +308,41 @@ All of these binaries are available in the SDK at :file:`/board-s $ cd $UBOOT_DIR - R5 - To build tiboot3.bin. Saved in $UBOOT_DIR/out/r5. + R5 builds :file:`tiboot3.bin` to :file:`$UBOOT_DIR/out/r5`. A53 builds :file:`tispl.bin` and :file:`u-boot.img` to :file:`$UBOOT_DIR/out/a53` (requires :file:`bl31.bin` and :file:`tee-pager_v2.bin`). - For AM62X - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62x_evm_r5_defconfig O=$UBOOT_DIR/out/r5 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=$UBOOT_DIR/out/r5 BINMAN_INDIRS=$TI_LINUX_FW_DIR + .. rubric:: AM62X - For AM62X LP - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62x_lpsk_r5_defconfig O=$UBOOT_DIR/out/r5 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=$UBOOT_DIR/out/r5 BINMAN_INDIRS=$TI_LINUX_FW_DIR + .. code-block:: console - For AM62SIP - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am6254atl_evm_r5_defconfig O=$UBOOT_DIR/out/r5 + R5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62x_evm_r5_defconfig O=$UBOOT_DIR/out/r5 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=$UBOOT_DIR/out/r5 BINMAN_INDIRS=$TI_LINUX_FW_DIR A53 - To build tispl.bin and u-boot.img. Saved in $UBOOT_DIR/out/a53. Requires bl31.bin, tee-pager_v2.bin - - For AM62X $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am62x_evm_a53_defconfig O=$UBOOT_DIR/out/a53 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=$TFA_DIR/build/k3/lite/release/bl31.bin TEE=$OPTEE_DIR/out/arm-plat-k3/core/tee-pager_v2.bin O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR - For AM62X LP + .. rubric:: AM62X LP + + .. code-block:: console + + R5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62x_lpsk_r5_defconfig O=$UBOOT_DIR/out/r5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=$UBOOT_DIR/out/r5 BINMAN_INDIRS=$TI_LINUX_FW_DIR + + A53 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am62x_lpsk_a53_defconfig O=$UBOOT_DIR/out/a53 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=$TFA_DIR/build/k3/lite/release/bl31.bin TEE=$OPTEE_DIR/out/arm-plat-k3/core/tee-pager_v2.bin O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR - For AM62SIP + .. rubric:: AM62SIP + + .. code-block:: console + + R5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am6254atl_evm_r5_defconfig O=$UBOOT_DIR/out/r5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=$UBOOT_DIR/out/r5 BINMAN_INDIRS=$TI_LINUX_FW_DIR + + A53 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am6254atl_evm_a53_defconfig O=$UBOOT_DIR/out/a53 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=$TFA_DIR/build/k3/lite/release/bl31.bin TEE=$OPTEE_DIR/out/arm-plat-k3/core/tee-pager_v2.bin O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR From 89b7535937f38816dab7e86425cc2de85af549b3 Mon Sep 17 00:00:00 2001 From: Yiyoung Liu Date: Wed, 20 May 2026 09:18:38 -0500 Subject: [PATCH 2/3] feat(linux): add BeaglePlay U-Boot build instructions BeaglePlay has custom defconfigs (am62x_beagleplay_a53_defconfig and am62x_beagleplay_r5_defconfig) just like other community boards already documented (e.g. BeagleBadge), so it should be included in the build guide. Signed-off-by: Yiyoung Liu --- .../U-Boot/BG-Build-K3.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst b/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst index 6970bf1dd..ab5eb38d6 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst @@ -286,6 +286,9 @@ All of these binaries are available in the SDK at :file:`/board-s | AM62SIP SK | ``am6254atl_evm_r5_defconfig`` | ``am6254atl_evm_r5_defconfig am62x_r5_usbdfu.config`` | ``am6254atl_evm_r5_defconfig am62x_r5_usbmsc.config`` | | | ``am6254atl_evm_a53_defconfig`` | ``am6254atl_evm_a53_defconfig`` | ``am6254atl_evm_a53_defconfig`` | +---------------+------------------------------------+----------------------------------------------------------+----------------------------------------------------------+ + | BeaglePlay | ``am62x_beagleplay_r5_defconfig`` | ``am62x_beagleplay_r5_defconfig am62x_r5_usbdfu.config`` | ``am62x_beagleplay_r5_defconfig am62x_r5_usbmsc.config`` | + | | ``am62x_beagleplay_a53_defconfig`` | ``am62x_beagleplay_a53_defconfig`` | ``am62x_beagleplay_a53_defconfig`` | + +---------------+------------------------------------+----------------------------------------------------------+----------------------------------------------------------+ .. note:: @@ -346,6 +349,18 @@ All of these binaries are available in the SDK at :file:`/board-s $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am6254atl_evm_a53_defconfig O=$UBOOT_DIR/out/a53 $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=$TFA_DIR/build/k3/lite/release/bl31.bin TEE=$OPTEE_DIR/out/arm-plat-k3/core/tee-pager_v2.bin O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR + .. rubric:: BeaglePlay + + .. code-block:: console + + R5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62x_beagleplay_r5_defconfig O=$UBOOT_DIR/out/r5 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=$UBOOT_DIR/out/r5 BINMAN_INDIRS=$TI_LINUX_FW_DIR + + A53 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am62x_beagleplay_a53_defconfig O=$UBOOT_DIR/out/a53 + $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=$TFA_DIR/build/k3/lite/release/bl31.bin TEE=$OPTEE_DIR/out/arm-plat-k3/core/tee-pager_v2.bin O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR + .. ifconfig:: CONFIG_part_variant in ('AM62AX') From ecc5e6e32298306b36c5a3ef360218c3aa3e29d7 Mon Sep 17 00:00:00 2001 From: Yiyoung Liu Date: Wed, 20 May 2026 09:40:46 -0500 Subject: [PATCH 3/3] feat(linux): clarify U-Boot Target Images subsection usage Since the first subsection is build/boot related, while the second subsection is technical information relating to binary layouts, a user may be confused if the first subsection is necessary for them to read at all (it is!) if no clarification is provided. Signed-off-by: Yiyoung Liu --- .../Foundational_Components/U-Boot/BG-Target-Images-K3.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst b/source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst index d0c661919..930ab66d5 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst @@ -4,6 +4,13 @@ Target Images ############# +This page describes the boot images produced by U-Boot builds for K3-based SoCs. + +See the :ref:`k3-images` section for which files to copy to your SD card. +The :ref:`k3-image-formats` section provides technical details on binary layouts for reference. + +.. _k3-images: + ****** Images ******