Skip to content

Improve AM62X U-Boot documentation #711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
maybe-yiyi wants to merge 3 commits into
base: master
Choose a base branch
from
+44 −14
Open

Improve AM62X U-Boot documentation #711

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1157977
refactor(linux): reorganize AM62X U-Boot build instructions
maybe-yiyi May 20, 2026
89b7535
feat(linux): add BeaglePlay U-Boot build instructions
maybe-yiyi May 20, 2026
ecc5e6e
feat(linux): clarify U-Boot Target Images subsection usage
maybe-yiyi May 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 37 additions & 14 deletions source/linux/Foundational_Components/U-Boot/BG-Build-K3.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -286,6 +286,9 @@ All of these binaries are available in the SDK at :file:`<path to tisdk>/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::

Expand All @@ -308,34 +311,54 @@ All of these binaries are available in the SDK at :file:`<path to tisdk>/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
.. rubric:: AM62X

.. code-block:: console

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

For AM62X LP
A53
$ 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
Comment on lines +318 to +326
Copy link
Copy Markdown
Author

@maybe-yiyi maybe-yiyi May 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is structured the same way as other sections across different architectures.


.. 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

For AM62SIP
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

.. 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
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" 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

For AM62X LP
$ 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
.. rubric:: BeaglePlay

For AM62SIP
$ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am6254atl_evm_a53_defconfig O=$UBOOT_DIR/out/a53
.. 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


Expand Down
7 changes: 7 additions & 0 deletions source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
******
Expand Down