From 1521d6317b2ec34b1f24fd47fb8de8017efae7b4 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Tue, 21 Oct 2025 19:13:44 -0500 Subject: [PATCH 1/6] fix(u-boot): remove duplicate section Remove duplicate and unreachable omap content from the k3 bootflow document. Remove unused labels and associated duplicate sections. Fixes: 68145409 ("refactor(U-Boot): Split K3 and OMAP Build Guide") Signed-off-by: Randolph Sapp --- .../U-Boot/BG-Bootflow-K3.rst | 879 ++++++++---------- .../U-Boot/BG-Bootflow-OMAP.rst | 10 +- 2 files changed, 400 insertions(+), 489 deletions(-) diff --git a/source/linux/Foundational_Components/U-Boot/BG-Bootflow-K3.rst b/source/linux/Foundational_Components/U-Boot/BG-Bootflow-K3.rst index f9e1963c1..935bb53d2 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Bootflow-K3.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Bootflow-K3.rst @@ -1,499 +1,416 @@ -.. _u-boot-build-guide-bootflow-k3: - -######## -Bootflow -######## - .. _Boot-Flow-label: -********* +######### Boot Flow -********* - -.. ifconfig:: CONFIG_part_family in ('AM335X_family', 'AM437X_family') - - Booting the Linux kernel on an embedded platform is not as simple as simply - pointing a program counter to the kernel location and letting the processor - run. This section will review the four bootloader software stages that must - be run before the kernel can be booted and run on the device. - - Application processors such as the the AM335x are complex pieces of hardware, - but have limited internal RAM (e.g., 128KB). Because of this limited amount - of RAM, multiple bootloader stages are needed. These bootloader stages - systematically unlock the full functionality of the device so that all - complexities of the device are available to the kernel. - - There are four distinct bootloader stages: - - .. Image:: /images/U-Boot_Boot_Order_32bit.png - - 1. ROM Code - - The first stage bootloader is housed in ROM on the device. The ROM code is - the first block of code that is automatically run on device start-up or - after power-on reset (POR). The ROM bootloader code is hardcoded into the - device and cannot be changed by the user. Because of this, it is important - to get an understanding of what exactly the ROM code is doing. - - The ROM code has two main functions: - - * Configuration of the device and initialization of primary peripherals - such as stack setup, configuring the Watchdog Timer (see TRM for details) - as well as the PLL and system clocks configuration - * Readies the device for next bootloader by checking boot sources for next - stage of bootloader (SPL) as well as loading the actual next stage - bootloader code into memory and starting it - - The list of booting devices that the ROM code will search through for the - second stage bootloader is configured by the voltage levels set on the - devices SYSBOOT pins on startup. These pins also set other boot parameters - (i.e. expected crystal frequency, bus width of external memory). For more - information on the SYSBOOT pins and associated boot parameters see the - device TRM. - - 2. SPL or MLO - - The second stage bootloader is known as the SPL (Secondary Program Loader), - but is sometimes referred to as the MLO (MMC Card Loader). The SPL is the - first stage of U-Boot, and must be loaded from one of the boot sources into - internal RAM. The SPL has very limited configuration or user interaction, - and mainly serves to initialize the external DDR memory and set-up the boot - process for the next bootloader stage: U-Boot. - - 3. U-Boot +######### - U-Boot allows for powerful command-based control over the kernel boot - environment via a serial terminal. The user has control over a number of - parameters such as boot arguments and the kernel boot command. In addition, - U-Boot environment variables can be configured. These environment variables - are stored in the **uEnv.txt** file on your storage medium or directly in - a Flash-based memory if configured such. These environment variables can be - viewed, modified, and saved using the **env print**, **env set**, and - **env save** commands, respectively. U-Boot is also a very useful tool to - program and manipulate a wide range of external memory devices as well as - a helpful aid during custom board bringup. +On K3 architecture based devices, ROM supports boot only via MCU(R5). This means that +bootloader has to run on R5 core. In order to meet this constraint, keeping +safety in picture and to have faster boot time, the software boot architecture +is designed as below: - 4. Linux Kernel +.. ifconfig:: CONFIG_part_family not in ('J7_family', 'AM64X_family', 'AM62X_family', 'AM62AX_family') - **zImage** is the compressed kernel image wrapped with header info that - describes the kernel. This header includes the target architecture, the - operating system, kernel size, entry points, etc. The loading of the kernel - image is typically performed through the use of scripts stored in the U-Boot - environment (all starting with the **bootcmd** ENV variable that gets - executed after the autoboot countdown expires or manually by entering the - **boot** command at the U-Boot prompt). This also involves passing a board- - specific device tree blob (DTB) as an argument to U-Boot's **bootz** - command that will extract and start the actual kernel. - -.. ifconfig:: CONFIG_part_family not in ('AM335X_family', 'AM437X_family', 'AM62LX_family') - - On K3 architecture based devices, ROM supports boot only via MCU(R5). This means that - bootloader has to run on R5 core. In order to meet this constraint, keeping - safety in picture and to have faster boot time, the software boot architecture - is designed as below: - - .. ifconfig:: CONFIG_part_family not in ('J7_family', 'AM64X_family', 'AM62X_family', 'AM62AX_family') - - .. code-block:: text - - +------------------------------------------------------------------------+ - | DMSC | R5 | ARM64 | - +------------------------------------------------------------------------+ - | +--------+ | | | - | | Reset | | | | - | +--------+ | | | - | : | | | - | +--------+ | +-----------+ | | - | | *ROM* |----------|-->| Reset rls | | | - | +--------+ | +-----------+ | | - | | | | : | | - | | ROM | | : | | - | |services| | : | | - | | | | +-------------+ | | - | | | | | *R5 ROM* | | | - | | | | +-------------+ | | - | | |<---------|---|Load and auth| | | - | | | | | tiboot3.bin | | | - | | | | +-------------+ | | - | | | | : | | - | | | | : | | - | | | | : | | - | | | | +-------------+ | | - | | | | | *R5 SPL* | | | - | | | | +-------------+ | | - | | | | | Load | | | - | | | | | sysfw.itb | | | - | | Start | | +-------------+ | | - | | System |<---------|---| Start | | | - | |Firmware| | | SYSFW | | | - | +--------+ | +-------------+ | | - | : | | | | | - | +---------+ | | Load | | | - | | *SYSFW* | | | system | | | - | +---------+ | | Config data | | | - | | |<--------|---| | | | - | | | | +-------------+ | | - | | | | | | | | - | | | | | DDR | | | - | | | | | config | | | - | | | | +-------------+ | | - | | | | | | | | - | | |<--------|---| Start A53 | | | - | | | | | and Reset | | | - | | | | +-------------+ | | - | | | | | +-----------+ | - | | |---------|-----------------------|---->| Reset rls | | - | | | | | +-----------+ | - | | DMSC | | | : | - | |Services | | | +-----------+ | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<--------|-----------------------|---->| *A53 SPL* | | - | | | | | +-----------+ | - | | | | | | Load | | - | | | | | | u-boot.img| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<--------|-----------------------|---->| *U-Boot* | | - | | | | | +-----------+ | - | | | | | | prompt | | - | | | | | +-----------+ | - | +---------+ | | | - | | | | - +------------------------------------------------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J721E') - - .. code-block:: text - - +------------------------------------------------------------------------+-----------------------+ - | DMSC | MCU R5 | A72 | MAIN R5/C66x/C7x | - +------------------------------------------------------------------------+-----------------------+ - | +--------+ | | | | - | | Reset | | | | | - | +--------+ | | | | - | : | | | | - | +--------+ | +-----------+ | | | - | | *ROM* |----------|-->| Reset rls | | | | - | +--------+ | +-----------+ | | | - | | | | : | | | - | | ROM | | : | | | - | |services| | : | | | - | | | | +-------------+ | | | - | | | | | *R5 ROM* | | | | - | | | | +-------------+ | | | - | | |<---------|---|Load and auth| | | | - | | | | | tiboot3.bin | | | | - | | | | +-------------+ | | | - | | | | : | | | - | | | | : | | | - | | | | : | | | - | | | | +-------------+ | | | - | | | | | *R5 SPL* | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | sysfw.itb | | | | - | | Start | | +-------------+ | | | - | | System |<---------|---| Start | | | | - | |Firmware| | | SYSFW | | | | - | +--------+ | +-------------+ | | | - | : | | | | | | - | +---------+ | | Load | | | | - | | *SYSFW* | | | system | | | | - | +---------+ | | Config data | | | | - | | |<--------|---| | | | | - | | | | +-------------+ | | | - | | | | | DDR | | | | - | | | | | config | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | tispl.bin | | | | - | | | | +-------------+ | | | - | | | | | Load R5 | | | | - | | | | | firmware | | | | - | | | | +-------------+ | | | - | | |<--------|---| Start A72 | | | | - | | | | | and jump to | | | | - | | | | | DM fw image | | | | - | | | | +-------------+ | | | - | | | | | +-----------+ | | - | | |---------|-----------------------|---->| Reset rls | | | - | | | | | +-----------+ | | - | | TIFS | | | : | | - | |Services | | | +-----------+ | | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *A72 SPL* | | | - | | | | | +-----------+ | | - | | | | | | Load | | | - | | | | | | u-boot.img| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *U-Boot* | | | - | | | | | +-----------+ | | - | | | | | | prompt | | | - | | | | | +-----------+ | | - | | | | | | Load R5 | | | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | - | | | | | | Load C6 | | +-----------+ | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start C6 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| C6 starts | | - | | | | | | Load C7 | | +-----------+ | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start C7 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| C7 starts | | - | +---------+ | | | +-----------+ | - | | | | | - +------------------------------------------------------------------------+-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J7200', 'J721S2', 'J784S4','J742S2') + .. code-block:: text - .. code-block:: text + +------------------------------------------------------------------------+ + | DMSC | R5 | ARM64 | + +------------------------------------------------------------------------+ + | +--------+ | | | + | | Reset | | | | + | +--------+ | | | + | : | | | + | +--------+ | +-----------+ | | + | | *ROM* |----------|-->| Reset rls | | | + | +--------+ | +-----------+ | | + | | | | : | | + | | ROM | | : | | + | |services| | : | | + | | | | +-------------+ | | + | | | | | *R5 ROM* | | | + | | | | +-------------+ | | + | | |<---------|---|Load and auth| | | + | | | | | tiboot3.bin | | | + | | | | +-------------+ | | + | | | | : | | + | | | | : | | + | | | | : | | + | | | | +-------------+ | | + | | | | | *R5 SPL* | | | + | | | | +-------------+ | | + | | | | | Load | | | + | | | | | sysfw.itb | | | + | | Start | | +-------------+ | | + | | System |<---------|---| Start | | | + | |Firmware| | | SYSFW | | | + | +--------+ | +-------------+ | | + | : | | | | | + | +---------+ | | Load | | | + | | *SYSFW* | | | system | | | + | +---------+ | | Config data | | | + | | |<--------|---| | | | + | | | | +-------------+ | | + | | | | | | | | + | | | | | DDR | | | + | | | | | config | | | + | | | | +-------------+ | | + | | | | | | | | + | | |<--------|---| Start A53 | | | + | | | | | and Reset | | | + | | | | +-------------+ | | + | | | | | +-----------+ | + | | |---------|-----------------------|---->| Reset rls | | + | | | | | +-----------+ | + | | DMSC | | | : | + | |Services | | | +-----------+ | + | | |<--------|-----------------------|---->|*ATF/OPTEE*| | + | | | | | +-----------+ | + | | | | | : | + | | | | | +-----------+ | + | | |<--------|-----------------------|---->| *A53 SPL* | | + | | | | | +-----------+ | + | | | | | | Load | | + | | | | | | u-boot.img| | + | | | | | +-----------+ | + | | | | | : | + | | | | | +-----------+ | + | | |<--------|-----------------------|---->| *U-Boot* | | + | | | | | +-----------+ | + | | | | | | prompt | | + | | | | | +-----------+ | + | +---------+ | | | + | | | | + +------------------------------------------------------------------------+ + +.. ifconfig:: CONFIG_part_variant in ('J721E') - +------------------------------------------------------------------------+-----------------------+ - | SMS | MCU R5 | A72 | MAIN R5/C7x | - +------------------------------------------------------------------------+-----------------------+ - | +--------+ | | | | - | | Reset | | | | | - | +--------+ | | | | - | : | | | | - | +--------+ | +-----------+ | | | - | | *ROM* |----------|-->| Reset rls | | | | - | +--------+ | +-----------+ | | | - | | | | : | | | - | | ROM | | : | | | - | |services| | : | | | - | | | | +-------------+ | | | - | | | | | *R5 ROM* | | | | - | | | | +-------------+ | | | - | | |<---------|---|Load and auth| | | | - | | | | | tiboot3.bin | | | | - | | Start | | +-------------+ | | | - | | TIFS |<---------|---| Start | | | | - | | | | | TIFS | | | | - | +--------+ | +-------------+ | | | - | : | | | | | | - | +---------+ | | Load | | | | - | | *TIFS* | | | system | | | | - | +---------+ | | Config data | | | | - | | |<--------|---| | | | | - | | | | +-------------+ | | | - | | | | : | | | - | | | | : | | | - | | | | : | | | - | | | | +-------------+ | | | - | | | | | *R5 SPL* | | | | - | | | | +-------------+ | | | - | | | | | DDR | | | | - | | | | | config | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | tispl.bin | | | | - | | | | +-------------+ | | | - | | | | | Load R5 | | | | - | | | | | firmware | | | | - | | | | +-------------+ | | | - | | |<--------|---| Start A72 | | | | - | | | | | and jump to | | | | - | | | | | DM fw image | | | | - | | | | +-------------+ | | | - | | | | | +-----------+ | | - | | |---------|-----------------------|---->| Reset rls | | | - | | | | | +-----------+ | | - | | TIFS | | | : | | - | |Services | | | +-----------+ | | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *A72 SPL* | | | - | | | | | +-----------+ | | - | | | | | | Load | | | - | | | | | | u-boot.img| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *U-Boot* | | | - | | | | | +-----------+ | | - | | | | | | prompt | | | - | | | | | +-----------+ | | - | | | | | | Load R5 | | | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | - | | | | | | Load C7 | | +-----------+ | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start C7 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| C7 starts | | - | | | | | | +-----------+ | - | | | | | | | - | +---------+ | | | | - | | | | | - +------------------------------------------------------------------------+-----------------------+ + .. code-block:: text - .. ifconfig:: CONFIG_part_variant in ('AM64X') + +------------------------------------------------------------------------+-----------------------+ + | DMSC | MCU R5 | A72 | MAIN R5/C66x/C7x | + +------------------------------------------------------------------------+-----------------------+ + | +--------+ | | | | + | | Reset | | | | | + | +--------+ | | | | + | : | | | | + | +--------+ | +-----------+ | | | + | | *ROM* |----------|-->| Reset rls | | | | + | +--------+ | +-----------+ | | | + | | | | : | | | + | | ROM | | : | | | + | |services| | : | | | + | | | | +-------------+ | | | + | | | | | *R5 ROM* | | | | + | | | | +-------------+ | | | + | | |<---------|---|Load and auth| | | | + | | | | | tiboot3.bin | | | | + | | | | +-------------+ | | | + | | | | : | | | + | | | | : | | | + | | | | : | | | + | | | | +-------------+ | | | + | | | | | *R5 SPL* | | | | + | | | | +-------------+ | | | + | | | | | Load | | | | + | | | | | sysfw.itb | | | | + | | Start | | +-------------+ | | | + | | System |<---------|---| Start | | | | + | |Firmware| | | SYSFW | | | | + | +--------+ | +-------------+ | | | + | : | | | | | | + | +---------+ | | Load | | | | + | | *SYSFW* | | | system | | | | + | +---------+ | | Config data | | | | + | | |<--------|---| | | | | + | | | | +-------------+ | | | + | | | | | DDR | | | | + | | | | | config | | | | + | | | | +-------------+ | | | + | | | | | Load | | | | + | | | | | tispl.bin | | | | + | | | | +-------------+ | | | + | | | | | Load R5 | | | | + | | | | | firmware | | | | + | | | | +-------------+ | | | + | | |<--------|---| Start A72 | | | | + | | | | | and jump to | | | | + | | | | | DM fw image | | | | + | | | | +-------------+ | | | + | | | | | +-----------+ | | + | | |---------|-----------------------|---->| Reset rls | | | + | | | | | +-----------+ | | + | | TIFS | | | : | | + | |Services | | | +-----------+ | | + | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | + | | | | | +-----------+ | | + | | | | | : | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|---->| *A72 SPL* | | | + | | | | | +-----------+ | | + | | | | | | Load | | | + | | | | | | u-boot.img| | | + | | | | | +-----------+ | | + | | | | | : | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|---->| *U-Boot* | | | + | | | | | +-----------+ | | + | | | | | | prompt | | | + | | | | | +-----------+ | | + | | | | | | Load R5 | | | + | | | | | | Firmware | | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | + | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | + | | | | | | Load C6 | | +-----------+ | + | | | | | | Firmware | | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|-----| Start C6 | | +-----------+ | + | | |---------|-----------------------|-----+-----------+-----|----->| C6 starts | | + | | | | | | Load C7 | | +-----------+ | + | | | | | | Firmware | | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|-----| Start C7 | | +-----------+ | + | | |---------|-----------------------|-----+-----------+-----|----->| C7 starts | | + | +---------+ | | | +-----------+ | + | | | | | + +------------------------------------------------------------------------+-----------------------+ + +.. ifconfig:: CONFIG_part_variant in ('J7200', 'J721S2', 'J784S4','J742S2') - .. code-block:: text + .. code-block:: text - +------------------------------------------------------------------------+-----------------------+ - | DMSC | MAIN R50 | A53 | MAIN R51 | - +------------------------------------------------------------------------+-----------------------+ - | +--------+ | | | | - | | Reset | | | | | - | +--------+ | | | | - | : | | | | - | +--------+ | +-----------+ | | | - | | *ROM* |----------|-->| Reset rls | | | | - | +--------+ | +-----------+ | | | - | | | | : | | | - | | ROM | | : | | | - | |services| | : | | | - | | | | +-------------+ | | | - | | | | | *R5 ROM* | | | | - | | | | +-------------+ | | | - | | |<---------|---|Load and auth| | | | - | | | | | tiboot3.bin | | | | - | | Start | | +-------------+ | | | - | | SYSFW |<---------|---| Start | | | | - | | | | | SYSFW | | | | - | +--------+ | +-------------+ | | | - | : | | | | | | - | +---------+ | | Load | | | | - | | *SYSFW* | | | system | | | | - | +---------+ | | Config data | | | | - | | |<--------|---| | | | | - | | | | +-------------+ | | | - | | | | : | | | - | | | | : | | | - | | | | : | | | - | | | | +-------------+ | | | - | | | | | *R5 SPL* | | | | - | | | | +-------------+ | | | - | | | | | DDR | | | | - | | | | | config | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | tispl.bin | | | | - | | | | +-------------+ | | | - | | |<--------|---| Start A53 | | | | - | | | | +-------------+ | | | - | | | | | +-----------+ | | - | | |---------|-----------------------|---->| Reset rls | | | - | | | | | +-----------+ | | - | | SYSFW | | | : | | - | |Services | | | +-----------+ | | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *A53 SPL* | | | - | | | | | +-----------+ | | - | | | | | | Load | | | - | | | | | | u-boot.img| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *U-Boot* | | | - | | | | | +-----------+ | | - | | | | | | prompt | | | - | | | | | +-----------+ | | - | | | | | | Load R5 | | | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | - | | | | | | +-----------+ | - | | | | | | | - | +---------+ | | | | - | | | | | - +------------------------------------------------------------------------+-----------------------+ + +------------------------------------------------------------------------+-----------------------+ + | SMS | MCU R5 | A72 | MAIN R5/C7x | + +------------------------------------------------------------------------+-----------------------+ + | +--------+ | | | | + | | Reset | | | | | + | +--------+ | | | | + | : | | | | + | +--------+ | +-----------+ | | | + | | *ROM* |----------|-->| Reset rls | | | | + | +--------+ | +-----------+ | | | + | | | | : | | | + | | ROM | | : | | | + | |services| | : | | | + | | | | +-------------+ | | | + | | | | | *R5 ROM* | | | | + | | | | +-------------+ | | | + | | |<---------|---|Load and auth| | | | + | | | | | tiboot3.bin | | | | + | | Start | | +-------------+ | | | + | | TIFS |<---------|---| Start | | | | + | | | | | TIFS | | | | + | +--------+ | +-------------+ | | | + | : | | | | | | + | +---------+ | | Load | | | | + | | *TIFS* | | | system | | | | + | +---------+ | | Config data | | | | + | | |<--------|---| | | | | + | | | | +-------------+ | | | + | | | | : | | | + | | | | : | | | + | | | | : | | | + | | | | +-------------+ | | | + | | | | | *R5 SPL* | | | | + | | | | +-------------+ | | | + | | | | | DDR | | | | + | | | | | config | | | | + | | | | +-------------+ | | | + | | | | | Load | | | | + | | | | | tispl.bin | | | | + | | | | +-------------+ | | | + | | | | | Load R5 | | | | + | | | | | firmware | | | | + | | | | +-------------+ | | | + | | |<--------|---| Start A72 | | | | + | | | | | and jump to | | | | + | | | | | DM fw image | | | | + | | | | +-------------+ | | | + | | | | | +-----------+ | | + | | |---------|-----------------------|---->| Reset rls | | | + | | | | | +-----------+ | | + | | TIFS | | | : | | + | |Services | | | +-----------+ | | + | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | + | | | | | +-----------+ | | + | | | | | : | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|---->| *A72 SPL* | | | + | | | | | +-----------+ | | + | | | | | | Load | | | + | | | | | | u-boot.img| | | + | | | | | +-----------+ | | + | | | | | : | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|---->| *U-Boot* | | | + | | | | | +-----------+ | | + | | | | | | prompt | | | + | | | | | +-----------+ | | + | | | | | | Load R5 | | | + | | | | | | Firmware | | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | + | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | + | | | | | | Load C7 | | +-----------+ | + | | | | | | Firmware | | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|-----| Start C7 | | +-----------+ | + | | |---------|-----------------------|-----+-----------+-----|----->| C7 starts | | + | | | | | | +-----------+ | + | | | | | | | + | +---------+ | | | | + | | | | | + +------------------------------------------------------------------------+-----------------------+ + +.. ifconfig:: CONFIG_part_variant in ('AM64X') - .. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S') + .. code-block:: text - .. code-block:: text + +------------------------------------------------------------------------+-----------------------+ + | DMSC | MAIN R50 | A53 | MAIN R51 | + +------------------------------------------------------------------------+-----------------------+ + | +--------+ | | | | + | | Reset | | | | | + | +--------+ | | | | + | : | | | | + | +--------+ | +-----------+ | | | + | | *ROM* |----------|-->| Reset rls | | | | + | +--------+ | +-----------+ | | | + | | | | : | | | + | | ROM | | : | | | + | |services| | : | | | + | | | | +-------------+ | | | + | | | | | *R5 ROM* | | | | + | | | | +-------------+ | | | + | | |<---------|---|Load and auth| | | | + | | | | | tiboot3.bin | | | | + | | Start | | +-------------+ | | | + | | SYSFW |<---------|---| Start | | | | + | | | | | SYSFW | | | | + | +--------+ | +-------------+ | | | + | : | | | | | | + | +---------+ | | Load | | | | + | | *SYSFW* | | | system | | | | + | +---------+ | | Config data | | | | + | | |<--------|---| | | | | + | | | | +-------------+ | | | + | | | | : | | | + | | | | : | | | + | | | | : | | | + | | | | +-------------+ | | | + | | | | | *R5 SPL* | | | | + | | | | +-------------+ | | | + | | | | | DDR | | | | + | | | | | config | | | | + | | | | +-------------+ | | | + | | | | | Load | | | | + | | | | | tispl.bin | | | | + | | | | +-------------+ | | | + | | |<--------|---| Start A53 | | | | + | | | | +-------------+ | | | + | | | | | +-----------+ | | + | | |---------|-----------------------|---->| Reset rls | | | + | | | | | +-----------+ | | + | | SYSFW | | | : | | + | |Services | | | +-----------+ | | + | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | + | | | | | +-----------+ | | + | | | | | : | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|---->| *A53 SPL* | | | + | | | | | +-----------+ | | + | | | | | | Load | | | + | | | | | | u-boot.img| | | + | | | | | +-----------+ | | + | | | | | : | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|---->| *U-Boot* | | | + | | | | | +-----------+ | | + | | | | | | prompt | | | + | | | | | +-----------+ | | + | | | | | | Load R5 | | | + | | | | | | Firmware | | | + | | | | | +-----------+ | | + | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | + | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | + | | | | | | +-----------+ | + | | | | | | | + | +---------+ | | | | + | | | | | + +------------------------------------------------------------------------+-----------------------+ + +.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S') - +------------------------------------------------------------------------+ - | TIFS | Main R5 | A53 | - +------------------------------------------------------------------------+ - | +--------+ | | | - | | Reset | | | | - | +--------+ | | | - | : | | | - | +--------+ | +-----------+ | | - | | *ROM* |----------|-->| Reset rls | | | - | +--------+ | +-----------+ | | - | | | | : | | - | | ROM | | : | | - | |services| | : | | - | | | | +-------------+ | | - | | | | | *R5 ROM* | | | - | | | | +-------------+ | | - | | |<---------|---|Load and auth| | | - | | | | | tiboot3.bin | | | - | +--------+ | +-------------+ | | - | | |<---------|---| Load sysfw | | | - | | | | | part to TIFS| | | - | | | | | core | | | - | | | | +-------------+ | | - | | | | : | | - | | | | : | | - | | | | : | | - | | | | +-------------+ | | - | | | | | *R5 SPL* | | | - | | | | +-------------+ | | - | | | | | DDR | | | - | | | | | config | | | - | | | | +-------------+ | | - | | | | | Load | | | - | | | | | tispl.bin | | | - | | | | +-------------+ | | - | | | | | Load R5 | | | - | | | | | firmware | | | - | | | | +-------------+ | | - | | |<---------|---| Start A53 | | | - | | | | | and jump to | | | - | | | | | DM fw image | | | - | | | | +-------------+ | | - | | | | | +-----------+ | - | | |----------|-----------------------|---->| Reset rls | | - | | | | | +-----------+ | - | | TIFS | | | : | - | |Services| | | +-----------+ | - | | |<---------|-----------------------|---->|*ATF/OPTEE*| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<---------|-----------------------|---->| *A53 SPL* | | - | | | | | +-----------+ | - | | | | | | Load | | - | | | | | | u-boot.img| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<---------|-----------------------|---->| *U-Boot* | | - | | | | | +-----------+ | - | | | | | | prompt | | - | | |----------|-----------------------|-----+-----------+-----| - | +--------+ | | | - | | | | - +------------------------------------------------------------------------+ + .. code-block:: text - Here |__SYSFW_CORE_NAME__| acts as master and provides all the critical services. R5/ARM64 - requests |__SYSFW_CORE_NAME__| to get these services done as shown in the above diagram. + +------------------------------------------------------------------------+ + | TIFS | Main R5 | A53 | + +------------------------------------------------------------------------+ + | +--------+ | | | + | | Reset | | | | + | +--------+ | | | + | : | | | + | +--------+ | +-----------+ | | + | | *ROM* |----------|-->| Reset rls | | | + | +--------+ | +-----------+ | | + | | | | : | | + | | ROM | | : | | + | |services| | : | | + | | | | +-------------+ | | + | | | | | *R5 ROM* | | | + | | | | +-------------+ | | + | | |<---------|---|Load and auth| | | + | | | | | tiboot3.bin | | | + | +--------+ | +-------------+ | | + | | |<---------|---| Load sysfw | | | + | | | | | part to TIFS| | | + | | | | | core | | | + | | | | +-------------+ | | + | | | | : | | + | | | | : | | + | | | | : | | + | | | | +-------------+ | | + | | | | | *R5 SPL* | | | + | | | | +-------------+ | | + | | | | | DDR | | | + | | | | | config | | | + | | | | +-------------+ | | + | | | | | Load | | | + | | | | | tispl.bin | | | + | | | | +-------------+ | | + | | | | | Load R5 | | | + | | | | | firmware | | | + | | | | +-------------+ | | + | | |<---------|---| Start A53 | | | + | | | | | and jump to | | | + | | | | | DM fw image | | | + | | | | +-------------+ | | + | | | | | +-----------+ | + | | |----------|-----------------------|---->| Reset rls | | + | | | | | +-----------+ | + | | TIFS | | | : | + | |Services| | | +-----------+ | + | | |<---------|-----------------------|---->|*ATF/OPTEE*| | + | | | | | +-----------+ | + | | | | | : | + | | | | | +-----------+ | + | | |<---------|-----------------------|---->| *A53 SPL* | | + | | | | | +-----------+ | + | | | | | | Load | | + | | | | | | u-boot.img| | + | | | | | +-----------+ | + | | | | | : | + | | | | | +-----------+ | + | | |<---------|-----------------------|---->| *U-Boot* | | + | | | | | +-----------+ | + | | | | | | prompt | | + | | |----------|-----------------------|-----+-----------+-----| + | +--------+ | | | + | | | | + +------------------------------------------------------------------------+ + +Here |__SYSFW_CORE_NAME__| acts as master and provides all the critical services. R5/ARM64 +requests |__SYSFW_CORE_NAME__| to get these services done as shown in the above diagram. .. ifconfig:: CONFIG_part_variant in ('AM62LX') diff --git a/source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst b/source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst index a39971e44..9e50a9038 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst @@ -1,14 +1,8 @@ -.. _u-boot-build-guide-bootflow-omap: - -######## -Bootflow -######## - .. _Boot-Flow-label: -********* +######### Boot Flow -********* +######### Booting the Linux kernel on an embedded platform is not as simple as simply pointing a program counter to the kernel location and letting the processor From d2aa28e11e4d551ec3489f557f58230b42ffd897 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Tue, 21 Oct 2025 19:25:43 -0500 Subject: [PATCH 2/6] fix(u-boot): remove old monolithic UG-General-Info The refactor seems to include all relevant information for the devices still using UG-General-Info. Purge this old file and move any remaining K3 devices over to the new structure. Fixes: 68145409 ("refactor(U-Boot): Split K3 and OMAP Build Guide") Signed-off-by: Randolph Sapp --- configs/AM62DX/AM62DX_linux_toc.txt | 8 +- configs/AM67/AM67_linux_toc.txt | 8 +- configs/AM67A/AM67A_linux_toc.txt | 8 +- configs/AM68/AM68_linux_toc.txt | 8 +- configs/AM68A/AM68A_linux_toc.txt | 8 +- configs/AM69/AM69_linux_toc.txt | 8 +- configs/AM69A/AM69A_linux_toc.txt | 8 +- configs/DRA821A/DRA821A_linux_toc.txt | 8 +- configs/J7200/J7200_linux_toc.txt | 8 +- configs/J721E/J721E_linux_toc.txt | 8 +- configs/J721S2/J721S2_linux_toc.txt | 8 +- configs/J722S/J722S_linux_toc.txt | 8 +- configs/J742S2/J742S2_linux_toc.txt | 8 +- configs/J784S4/J784S4_linux_toc.txt | 8 +- configs/TDA4VM/TDA4VM_linux_toc.txt | 8 +- .../U-Boot/UG-General-Info.rst | 2254 ----------------- 16 files changed, 105 insertions(+), 2269 deletions(-) delete mode 100644 source/linux/Foundational_Components/U-Boot/UG-General-Info.rst diff --git a/configs/AM62DX/AM62DX_linux_toc.txt b/configs/AM62DX/AM62DX_linux_toc.txt index 3ebd62020..ca085abdf 100644 --- a/configs/AM62DX/AM62DX_linux_toc.txt +++ b/configs/AM62DX/AM62DX_linux_toc.txt @@ -25,7 +25,13 @@ linux/Overview/Processor_SDK_Linux_create_SD_card linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Memory-K3 #linux/Foundational_Components/U-Boot/UG-QSPI diff --git a/configs/AM67/AM67_linux_toc.txt b/configs/AM67/AM67_linux_toc.txt index 78aef716a..dc4a64e7b 100644 --- a/configs/AM67/AM67_linux_toc.txt +++ b/configs/AM67/AM67_linux_toc.txt @@ -19,7 +19,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/AM67A/AM67A_linux_toc.txt b/configs/AM67A/AM67A_linux_toc.txt index f7b783ef9..532edf609 100644 --- a/configs/AM67A/AM67A_linux_toc.txt +++ b/configs/AM67A/AM67A_linux_toc.txt @@ -20,7 +20,13 @@ linux/Foundational_Components linux/index_Edge_AI linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/AM68/AM68_linux_toc.txt b/configs/AM68/AM68_linux_toc.txt index 7e5105afe..f95e2c7f7 100644 --- a/configs/AM68/AM68_linux_toc.txt +++ b/configs/AM68/AM68_linux_toc.txt @@ -19,7 +19,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/AM68A/AM68A_linux_toc.txt b/configs/AM68A/AM68A_linux_toc.txt index 90b74ddf3..60906f833 100644 --- a/configs/AM68A/AM68A_linux_toc.txt +++ b/configs/AM68A/AM68A_linux_toc.txt @@ -20,7 +20,13 @@ linux/Foundational_Components linux/index_Edge_AI linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/AM69/AM69_linux_toc.txt b/configs/AM69/AM69_linux_toc.txt index 4e96a9115..0b3cc49ae 100644 --- a/configs/AM69/AM69_linux_toc.txt +++ b/configs/AM69/AM69_linux_toc.txt @@ -19,7 +19,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/AM69A/AM69A_linux_toc.txt b/configs/AM69A/AM69A_linux_toc.txt index 8052a95e5..ffacdd493 100644 --- a/configs/AM69A/AM69A_linux_toc.txt +++ b/configs/AM69A/AM69A_linux_toc.txt @@ -20,7 +20,13 @@ linux/Foundational_Components linux/index_Edge_AI linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/DRA821A/DRA821A_linux_toc.txt b/configs/DRA821A/DRA821A_linux_toc.txt index 313981a4a..ef8c7a2c2 100644 --- a/configs/DRA821A/DRA821A_linux_toc.txt +++ b/configs/DRA821A/DRA821A_linux_toc.txt @@ -18,7 +18,13 @@ devices/DRA821A/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/J7200/J7200_linux_toc.txt b/configs/J7200/J7200_linux_toc.txt index a4f35d174..d1690f2e6 100644 --- a/configs/J7200/J7200_linux_toc.txt +++ b/configs/J7200/J7200_linux_toc.txt @@ -20,7 +20,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/J721E/J721E_linux_toc.txt b/configs/J721E/J721E_linux_toc.txt index 3d8e68854..3db378164 100644 --- a/configs/J721E/J721E_linux_toc.txt +++ b/configs/J721E/J721E_linux_toc.txt @@ -20,7 +20,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/J721S2/J721S2_linux_toc.txt b/configs/J721S2/J721S2_linux_toc.txt index 795520179..2486b18dd 100644 --- a/configs/J721S2/J721S2_linux_toc.txt +++ b/configs/J721S2/J721S2_linux_toc.txt @@ -20,7 +20,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/J722S/J722S_linux_toc.txt b/configs/J722S/J722S_linux_toc.txt index 700e4207b..c2873e605 100644 --- a/configs/J722S/J722S_linux_toc.txt +++ b/configs/J722S/J722S_linux_toc.txt @@ -20,7 +20,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/J742S2/J742S2_linux_toc.txt b/configs/J742S2/J742S2_linux_toc.txt index d783fa466..942269e6d 100644 --- a/configs/J742S2/J742S2_linux_toc.txt +++ b/configs/J742S2/J742S2_linux_toc.txt @@ -20,7 +20,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/J784S4/J784S4_linux_toc.txt b/configs/J784S4/J784S4_linux_toc.txt index 092c82142..dfa0996f6 100644 --- a/configs/J784S4/J784S4_linux_toc.txt +++ b/configs/J784S4/J784S4_linux_toc.txt @@ -20,7 +20,13 @@ devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/configs/TDA4VM/TDA4VM_linux_toc.txt b/configs/TDA4VM/TDA4VM_linux_toc.txt index b3d368206..b5cbde937 100644 --- a/configs/TDA4VM/TDA4VM_linux_toc.txt +++ b/configs/TDA4VM/TDA4VM_linux_toc.txt @@ -21,7 +21,13 @@ linux/Foundational_Components linux/index_Edge_AI linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide -linux/Foundational_Components/U-Boot/UG-General-Info +linux/Foundational_Components/U-Boot/Build-Guide-K3 +linux/Foundational_Components/U-Boot/BG-Setup-K3 +linux/Foundational_Components/U-Boot/BG-Build-K3 +linux/Foundational_Components/U-Boot/BG-Target-Images-K3 +linux/Foundational_Components/U-Boot/BG-Bootflow-K3 +linux/Foundational_Components/U-Boot/BG-Environment-K3 +linux/Foundational_Components/U-Boot/BG-Ram-Device-Trees-K3 linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Network linux/Foundational_Components/U-Boot/UG-NAND diff --git a/source/linux/Foundational_Components/U-Boot/UG-General-Info.rst b/source/linux/Foundational_Components/U-Boot/UG-General-Info.rst deleted file mode 100644 index 66be90d66..000000000 --- a/source/linux/Foundational_Components/U-Boot/UG-General-Info.rst +++ /dev/null @@ -1,2254 +0,0 @@ -General Information -------------------- - -.. ifconfig:: CONFIG_part_family not in ('AM335X_family', 'AM437X_family') - - .. rubric:: Install host dependencies - - To install host dependencies for building TI U-boot source (standalone) - on Ubuntu 22.04+, run the following command in the terminal prompt: - - .. code-block:: console - - sudo apt install git xz-utils build-essential autoconf flex bison libssl-dev bc libncurses-dev \ - python3 python3-setuptools python3-dev python3-yaml python3-jsonschema python3-pyelftools \ - swig yamllint libgnutls28-dev - -.. note:: - - The recommended host machine for building U-Boot is Ubuntu 22.04. - Users of Ubuntu 18.04 might need to install Python 3.7 or later. If using the default Python 3.6 - that is in Ubuntu 18.04, users might need to install these additional dependencies: - - .. code-block:: console - - pip install dataclasses pyelftools jsonschema yamllint importlib-resources - -.. ifconfig:: CONFIG_part_variant in ('AM62LX') - - Getting the BL-1 Source Code - ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - AM62L devices use TF-A BL-1 boot loader to configure LPDDR4 to - enable secondary program loader. - The easiest way to get access to the BL-1 source code is by - downloading and installing the Processor SDK Linux. Once installed, - the BL-1 source code is in the SDK at the path ``/board-support``. - For your convenience the sources also includes the BL-1's - git repository including commit history. - - Alternatively, BL-1 sources can directly be fetched from GIThub. The GIT - repo URL, branch and commit id can be found at :ref:`release-specific-build-information`. - section of the release notes. - - .. _Build-BL1-label: - - Build BL-1 - ^^^^^^^^^^ - .. note:: - The following commands needs to run from the root of the - TF-A tree unless otherwise specified. The root of the TF-A tree is - the top-level directory and can be identified by looking for the - "licenses" directory. - - .. rubric:: Setting up the toolchain paths - - .. include:: ../../Overview/GCC_ToolChain.rst - :start-after: .. start_include_yocto_toolchain_host_setup - :end-before: .. end_include_yocto_toolchain_host_setup - - .. code-block:: console - - $ cd - - $ make CROSS_COMPILE="$CROSS_COMPILE_64" ARCH=aarch64 PLAT=k3 TARGET_BOARD=am62l am62l_bl1 - - - - $ make CROSS_COMPILE="$CROSS_COMPILE_64" ARCH=aarch64 PLAT=k3 TARGET_BOARD=am62l - -.. _Getting the U-Boot Source Code-label: - -Getting the U-Boot Source Code -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The easiest way to get access to the U-boot source code is by -downloading and installing the Processor SDK Linux. Once installed, -the U-Boot source code is in the SDK at the path ``/board-support``. -For your convenience the sources also includes the U-Boot's -git repository including commit history. - -Alternatively, U-Boot sources can directly be fetched from Git. -The Git repo URL, branch and commit id can be found in the :ref:`u-boot-release-notes` :ref:`release-specific-build-information` -section of the release notes. - - -.. _Build-U-Boot-label: - -Build U-Boot -^^^^^^^^^^^^ -.. note:: - The following commands are intended to be run from the root of the - U-Boot tree unless otherwise specified. The root of the U-Boot tree is - the top-level directory and can be identified by looking for the - "MAINTAINERS" file. - -.. ifconfig:: CONFIG_part_family in ('AM335X_family', 'AM437X_family', 'AM57X_family') - - We strongly recommend the use of separate object directories when - building. This is done with O= parameter to make. We also recommend that - you use an output directory name that is identical to the configuration - target name. That way if you are working with multiple configuration - targets it is very easy to know which folder contains the u-boot - binaries that you are interested in. - - .. rubric:: Setting the tool chain path - - We strongly recommend using the toolchain that came with the Linux Core - release that corresponds to this U-Boot release. For e.g: - - .. code-block:: console - - export PATH=$HOME//bin:$PATH - - .. rubric:: Cleaning the Sources - - If you did not use a separate object directory: - - .. code-block:: console - - $ make CROSS_COMPILE=arm-none-linux-gnueabihf- distclean - - If you used 'O=am335x\_evm' as your object directory: - - .. code-block:: console - - $ rm -rf ./am335x_evm - - .. rubric:: Compiling MLO and u-boot - - Building of both u-boot and SPL is done at the same time. You must - however first configure the build for the board you are working with. - Use the following table to determine what defconfig to use to configure - with: - - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | Board | SD Boot | eMMC Boot | NAND Boot | UART Boot | Ethernet Boot | USB Ethernet Boot | USB Host Boot | SPI Boot | - +============================+=============================+==========================+============================================+==========================+==========================+==========================+=========================================+==========================================+ - | AM335x GP EVM | am335x\_evm\_defconfig | | am335x\_evm\_defconfig | am335x\_evm\_defconfig | am335x\_evm\_defconfig | am335x\_evm\_defconfig | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM335x EVM-SK | am335x\_evm\_defconfig | | | am335x\_evm\_defconfig | | am335x\_evm\_defconfig | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM335x ICE | am335x\_evm\_defconfig | | | am335x\_evm\_defconfig | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | BeagleBone Black | am335x\_evm\_defconfig | am335x\_evm\_defconfig | | am335x\_evm\_defconfig | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | BeagleBone White | am335x\_evm\_defconfig | | | am335x\_evm\_defconfig | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM437x GP EVM | am43xx\_evm\_defconfig | | am43xx\_evm\_defconfig | am43xx\_evm\_defconfig | am43xx\_evm\_defconfig | am43xx\_evm\_defconfig | am43xx\_evm\_usbhost\_boot\_defconfig | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM437x EVM-Sk | am43xx\_evm\_defconfig | | | | | | am43xx\_evm\_usbhost\_boot\_defconfig | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM437x IDK | am43xx\_evm\_defconfig | | | | | | | am43xx\_evm\_qspiboot\_defconfig (XIP) | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM437x ePOS EVM | am43xx\_evm\_defconfig | | am43xx\_evm\_defconfig | | | | am43xx\_evm\_usbhost\_boot\_defconfig | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM572x GP EVM | am57xx\_evm\_defconfig | | | am57xx\_evm\_defconfig | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM572x IDK | am57xx\_evm\_defconfig | | | | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | AM571x IDK | am57xx\_evm\_defconfig | | | | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | DRA74x/DRA72x/DRA71x EVM | dra7xx\_evm\_defconfig | dra7xx\_evm\_defconfig | dra7xx\_evm\_defconfig (DRA71x EVM only) | | | | | dra7xx\_evm\_defconfig(QSPI) | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | K2HK EVM | | | k2hk\_evm\_defconfig | k2hk\_evm\_defconfig | k2hk\_evm\_defconfig | | | k2hk\_evm\_defconfig | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | K2L EVM | | | k2l\_evm\_defconfig | k2l\_evm\_defconfig | | | | k2l\_evm\_defconfig | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | K2E EVM | | | k2e\_evm\_defconfig | k2e\_evm\_defconfig | | | | k2e\_evm\_defconfig | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | K2G GP EVM | k2g\_evm\_defconfig | | | k2g\_evm\_defconfig | k2g\_evm\_defconfig | | | k2g\_evm\_defconfig | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | K2G ICE | k2g\_evm\_defconfig | | | | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - | OMAP-L138 LCDK | omapl138\_lcdk\_defconfig | | omapl138\_lcdk\_defconfig | | | | | | - +----------------------------+-----------------------------+--------------------------+--------------------------------------------+--------------------------+--------------------------+--------------------------+-----------------------------------------+------------------------------------------+ - - Then (Use 'am335x_evm' and 'AM335x GP EVM' in this example): - - .. code-block:: console - - $ make CROSS_COMPILE=arm-none-linux-gnueabihf- O=am335x_evm am335x_evm_defconfig - $ make CROSS_COMPILE=arm-none-linux-gnueabihf- O=am335x_evm - - .. note:: - Not all possible build targets for a given platform are listed - here as the community has additional build targets that are not - supported by TI. To find these read the 'boards.cfg' file and look for - the build target listed above. And please note that the main config file - will leverage other files under include/configs, as seen by #include - statements. - - -.. ifconfig:: CONFIG_part_family not in ('AM335X_family', 'AM437X_family', 'AM57X_family') - - .. ifconfig:: CONFIG_part_variant not in ('AM65X', 'AM64X', 'AM62LX') - - .. note:: Note about HSM Rearchitecture - - After HSM rearchitecture in bootloader, loading of remote cores with firmware - will be supported at A72 SPL stage only and not at R5 SPL stage. Early loading - of remote core firmware in R5 SPL requires core reset functionality. As part - of HSM rearchitecture, this functionality has moved into the DM service which - requires SPL to re-implement device and clock control. This support is not - present in Uboot R5 SPL due to memory constraints on the existing 64-bit TI devices. - - .. ifconfig:: CONFIG_part_variant not in ('AM65X', 'AM62LX') - - .. note:: - As of Processor SDK 9.0, compilation of bootloader images will no longer require - different defconfigs for GP and HS devices. The same build commands will generate images - for GP, HS-SE and HS-FS devices. - - .. rubric:: Prebuilt Images - - Several prebuilt images are required from the TI Processor SDK for building U-Boot on K3 based platforms. - - .. ifconfig:: CONFIG_part_variant in ('AM62LX') - - - TF-A (**BL-1** and **BL-31**): Refer to :ref:`foundational-components-atf` - for more information - - ti-linux-firmware (**BINMAN_INDIRS**): Prebuilt TIFS binaries are - available in `ti-linux-firmware `__. - - .. ifconfig:: CONFIG_part_variant not in ('AM62LX') - - - TF-A (BL-31): Refer to :ref:`foundational-components-atf` for more information - - OP-TEE (TEE): Refer to :ref:`foundational-components-optee` for more information - - ti-linux-firmware (BINMAN_INDIRS): Prebuilt binaries for DM and SYSFW available `here - `__. - - All of these are available in the SDK at ``/board-support/prebuilt-images>`` - - Go :ref:`here ` to download and install the SDK. - - .. rubric:: Setting up the toolchain paths - - .. include:: ../../Overview/GCC_ToolChain.rst - :start-after: .. start_include_yocto_toolchain_host_setup - :end-before: .. end_include_yocto_toolchain_host_setup - - .. ifconfig:: CONFIG_part_variant not in ('AM62LX') - - .. rubric:: Compiling R5 and ARM64 images - - Use the following table to determine what defconfig to use to configure with: - - .. ifconfig:: CONFIG_part_variant in ('AM65X') - - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------+ - | Board | SD/eMMC Boot | UART boot | OSPI boot | Hyper Flash | USB DFU | - +============================+=================================+================================+================================+================================+================================+ - | AM65x EVM/IDK | am65x\_evm\_r5\_defconfig | am65x\_evm\_r5\_defconfig | am65x\_evm\_r5_defconfig | | | - | | am65x\_evm\_a53\_defconfig | am65x\_evm\_a53\_defconfig | am65x\_evm\_a53\_defconfig | | | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------+ - | AM65x HS EVM/IDK | am65x\_hs\_evm\_r5\_defconfig | am65x\_hs\_evm\_r5\_defconfig | am65x\_hs\_evm\_r5_defconfig | | | - | | am65x\_hs\_evm\_a53\_defconfig | am65x\_hs\_evm\_a53\_defconfig | am65x\_hs\_evm\_a53\_defconfig | | | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------+ - - *on GP* - - .. code-block:: console - - $ cd - - R5 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am65x_evm_r5_defconfig O=/r5 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=/r5 BINMAN_INDIRS=/board-support/prebuilt-images - - A53 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am65x_evm_a53_defconfig O=/a53 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=/board-support/prebuilt-images/bl31.bin TEE=/board-support/prebuilt-images/bl32.bin O=/a53 BINMAN_INDIRS=/board-support/prebuilt-images - - - - *on HS* - - .. code-block:: console - - $ cd - - R5 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am65x_hs_evm_r5_defconfig O=/r5 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" O=/r5 BINMAN_INDIRS=/board-support/prebuilt-images - - - A53 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am65x_hs_evm_a53_defconfig O=/a53 - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=/board-support/prebuilt-images/bl31.bin TEE=/board-support/prebuilt-images/bl32.bin O=/a53 BINMAN_INDIRS=/board-support/prebuilt-images - - - - .. ifconfig:: CONFIG_part_variant in ('AM64X') - - +----------------------------+---------------------------------+---------------------------------+--------------------------------+--------------------------------+ - | Board | SD Boot | eMMC Boot | UART boot | OSPI boot | - +============================+=================================+=================================+================================+================================+ - | AM64X EVM | am64x\_evm\_r5\_defconfig | am64x\_evm\_r5\_defconfig | am64x\_evm\_r5\_defconfig | am64x\_evm\_r5\_defconfig | - | | am64x\_evm\_a53\_defconfig | am64x\_evm\_a53\_defconfig | am64x\_evm\_a53\_defconfig | am64x\_evm\_a53\_defconfig | - +----------------------------+---------------------------------+---------------------------------+--------------------------------+--------------------------------+ - | AM64X SK | am64x\_evm\_r5\_defconfig | | am64x\_evm\_r5\_defconfig | am64x\_evm\_r5\_defconfig | - | | am64x\_evm\_a53\_defconfig | | am64x\_evm\_a53\_defconfig | am64x\_evm\_a53\_defconfig | - +----------------------------+---------------------------------+---------------------------------+--------------------------------+--------------------------------+ - - .. note:: - - Where to get the sources: - - - ti-u-boot version: :ref:`u-boot-release-notes` - - ti-linux-firmware version: :ref:`ti-linux-fw-release-notes` - - TF-A version: :ref:`tf-a-release-notes` - - OP-TEE version: :ref:`optee-release-notes` - - .. code-block:: console - - $ export UBOOT_DIR= - $ export TI_LINUX_FW_DIR= - $ export TFA_DIR= - $ export OPTEE_DIR= - - .. note:: - - The instructions below assume all binaries are built manually. For instructions to build bl31.bin go to: :ref:`foundational-components-optee`. - For instructions to build tee-pager_v2.bin (bl32.bin) go to: :ref:`foundational-components-atf`. BINMAN_INDIRS can point to - /board-support/prebuilt-images/am64xx-evm to use the pre-built binaries that come in the pre-built SDK (bl31.bin for BL31, bl32.bin for TEE). - - .. code-block:: console - - $ cd $UBOOT_DIR - - R5 - To build tiboot3.bin. Saved in $UBOOT_DIR/out/r5. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am64x_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. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am64x_evm_a53_defconfig O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR - $ 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/bl32.bin O=$UBOOT_DIR/out/a53 BINMAN_INDIRS=$TI_LINUX_FW_DIR - - .. ifconfig:: CONFIG_part_variant in ('J721E') - - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------+ - | Board | SD/eMMC Boot | UART boot | OSPI boot | Hyper Flash | USB DFU | - +============================+=================================+================================+================================+================================+================================+ - | J721E EVM | j721e\_evm\_r5\_defconfig | j721e\_evm\_r5\_defconfig | j721e\_evm\_r5\_defconfig | j721e\_evm\_r5\_defconfig | j721e\_evm\_r5\_defconfig | - | | j721e\_evm\_a72\_defconfig | j721e\_evm\_a72\_defconfig | j721e\_evm\_a72\_defconfig | j721e\_evm\_a72\_defconfig | j721e\_evm\_a72\_defconfig | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------+ - | J721E SK | j721e\_evm\_r5\_defconfig | j721e\_evm\_r5\_defconfig | j721e\_evm\_r5\_defconfig | | | - | | j721e\_evm\_a72\_defconfig | j721e\_evm\_a72\_defconfig | j721e\_evm\_a72\_defconfig | | | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J7200') - - +----------------------------+---------------------------------+--------------------------------+ - | Board | SD/eMMC Boot | UART boot | - +============================+=================================+================================+ - | J7200 EVM | j7200\_evm\_r5\_defconfig | j7200\_evm\_r5\_defconfig | - | | j7200\_evm\_a72\_defconfig | j7200\_evm\_a72\_defconfig | - +----------------------------+---------------------------------+--------------------------------+ - - - .. ifconfig:: CONFIG_part_variant in ('J721S2') - - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------------+ - | Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | Ethernet Boot | - +============================+=================================+================================+================================+================================+======================================+ - | J721S2 EVM | j721s2\_evm\_r5\_defconfig | j721s2\_evm\_r5\_defconfig | j721s2\_evm\_r5\_defconfig | j721s2\_evm\_r5\_defconfig | | - | | j721s2\_evm\_a72\_defconfig | j721s2\_evm\_a72\_defconfig | j721s2\_evm\_a72\_defconfig | j721s2\_evm\_a72\_defconfig | | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------------+ - | AM68 HS-FS SK | j721s2\_evm\_r5\_defconfig | j721s2\_evm\_r5\_defconfig | j721s2\_evm\_r5\_defconfig | | am68\_sk\_r5\_ethboot\_defconfig | - | | j721s2\_evm\_a72\_defconfig | j721s2\_evm\_a72\_defconfig | j721s2\_evm\_a72\_defconfig | | am68\_sk\_a72\_ethboot\_defconfig | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J784S4') - - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------------+ - | Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | Ethernet boot | - +============================+=================================+================================+================================+================================+======================================+ - | J784S4 EVM | j784s4\_evm\_r5\_defconfig | j784s4\_evm\_r5\_defconfig | j784s4\_evm\_r5\_defconfig | j784s4\_evm\_r5\_defconfig | | - | | j784s4\_evm\_a72\_defconfig | j784s4\_evm\_a72\_defconfig | j784s4\_evm\_a72\_defconfig | j784s4\_evm\_a72\_defconfig | | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------------+ - | AM69 HS-FS SK | j784s4\_evm\_r5\_defconfig | j784s4\_evm\_r5\_defconfig | j784s4\_evm\_r5\_defconfig | | am69\_sk\_r5\_ethboot\_defconfig | - | | j784s4\_evm\_a72\_defconfig | j784s4\_evm\_a72\_defconfig | j784s4\_evm\_a72\_defconfig | | am69\_sk\_a72\_ethboot\_defconfig | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+--------------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J742S2') - - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+ - | Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | - +============================+=================================+================================+================================+================================+ - | J742S2 EVM | j742s2\_evm\_r5\_defconfig | j742s2\_evm\_r5\_defconfig | j742s2\_evm\_r5\_defconfig | j742s2\_evm\_r5\_defconfig | - | | j742s2\_evm\_a72\_defconfig | j742s2\_evm\_a72\_defconfig | j742s2\_evm\_a72\_defconfig | j742s2\_evm\_a72\_defconfig | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+--------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J722S') - - +----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------------------------+-------------------------------------------------------+------------------------------------------+ - | Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | USB MSC | Ethernet boot | - +============================+=================================+================================+================================+======================================================+=======================================================+==========================================+ - | J722S EVM | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``j722s_evm_r5_defconfig am62x_r5_usbmsc.config`` | j722s\_evm\_r5\_ethboot\_defconfig | - | | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | j722s\_evm\_a53\_ethboot\_defconfig | - +----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------------------------+-------------------------------------------------------+------------------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J721E','J7200','J721S2','J784S4','J742S2') - - .. code-block:: console - - $ cd - $ PREBUILT_IMAGES=/board-support/prebuilt-images - - R5 - $ make ARCH=arm O=/r5 _evm_r5_defconfig - $ make ARCH=arm O=/r5 CROSS_COMPILE="$CROSS_COMPILE_32" BINMAN_INDIRS=${PREBUILT_IMAGES} - - - A72 - $ make ARCH=arm O=/a72 _evm_a72_defconfig - $ make ARCH=arm O=/a72 CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=${PREBUILT_IMAGES}/bl31.bin TEE=${PREBUILT_IMAGES}/bl32.bin BINMAN_INDIRS=${PREBUILT_IMAGES} - - .. ifconfig:: CONFIG_part_variant in ('J722S') - - .. code-block:: console - - $ cd - $ PREBUILT_IMAGES=/board-support/prebuilt-images - - R5 - $ make ARCH=arm O=/r5 j722s_evm_r5_defconfig - - To build with config fragments - $ make ARCH=arm O=/r5 j722s_evm_r5_defconfig am62x_r5_usbdfu.config - $ make ARCH=arm O=/r5 j722s_evm_r5_defconfig am62x_r5_usbmsc.config - - $ make ARCH=arm O=/r5 CROSS_COMPILE="$CROSS_COMPILE_32" BINMAN_INDIRS=${PREBUILT_IMAGES} - - - A53 - $ make ARCH=arm O=/a53 j722s_evm_a53_defconfig - $ make ARCH=arm O=/a53 CROSS_COMPILE="$CROSS_COMPILE_64" CC="$CC_64" BL31=${PREBUILT_IMAGES}/bl31.bin TEE=${PREBUILT_IMAGES}/bl32.bin BINMAN_INDIRS=${PREBUILT_IMAGES} - - - .. ifconfig:: CONFIG_part_variant in ('AM62X') - - +---------------+------------------------------------+----------------------------------------------------------+----------------------------------------------------------+ - | Board | SD / eMMC / UART / OSPI Boot | USB DFU | USB MSC | - +===============+====================================+==========================================================+==========================================================+ - | AM62X SK | | ``am62x_evm_r5_defconfig`` | | ``am62x_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``am62x_evm_r5_defconfig am62x_r5_usbmsc.config`` | - | | | ``am62x_evm_a53_defconfig`` | | ``am62x_evm_a53_defconfig`` | | ``am62x_evm_a53_defconfig`` | - +---------------+------------------------------------+----------------------------------------------------------+----------------------------------------------------------+ - | AM62X LP SK | | ``am62x_lpsk_r5_defconfig`` | | ``am62x_lpsk_r5_defconfig am62x_r5_usbdfu.config`` | | ``am62x_lpsk_r5_defconfig am62x_r5_usbmsc.config`` | - | | | ``am62x_lpsk_a53_defconfig`` | | ``am62x_lpsk_a53_defconfig`` | | ``am62x_lpsk_a53_defconfig`` | - +---------------+------------------------------------+----------------------------------------------------------+----------------------------------------------------------+ - | AM62SIP SK | | ``am62xsip_evm_r5_defconfig`` | | ``am62xsip_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``am62xsip_evm_r5_defconfig am62x_r5_usbmsc.config`` | - | | | ``am62xsip_evm_a53_defconfig`` | | ``am62xsip_evm_a53_defconfig`` | | ``am62xsip_evm_a53_defconfig`` | - +---------------+------------------------------------+----------------------------------------------------------+----------------------------------------------------------+ - - .. note:: - - Where to get the sources: - - - ti-u-boot version: :ref:`u-boot-release-notes` - - ti-linux-firmware version: :ref:`ti-linux-fw-release-notes` - - TF-A version: :ref:`tf-a-release-notes` - - OP-TEE version: :ref:`optee-release-notes` - - .. code-block:: console - - $ export UBOOT_DIR= - $ export TI_LINUX_FW_DIR= - $ export TFA_DIR= - $ export OPTEE_DIR= - - .. note:: - - The instructions below assume all binaries are built manually. For instructions to build bl31.bin go to: :ref:`foundational-components-optee`. - For instructions to build tee-pager_v2.bin (bl32.bin) go to: :ref:`foundational-components-atf`. BINMAN_INDIRS can point to - /board-support/prebuilt-images/am62xx-evm to use the pre-built binaries that come in the pre-built SDK (bl31.bin for BL31, bl32.bin for TEE). - - .. code-block:: console - - $ cd $UBOOT_DIR - - R5 - To build tiboot3.bin. Saved in $UBOOT_DIR/out/r5. - - 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 - - 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 - - For AM62SIP - NOTE: AM62SIP Uses config fragment model. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62x_evm_r5_defconfig am62xsip_sk_r5.config 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 or AM62SIP - $ 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 - $ 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 - - - .. ifconfig:: CONFIG_part_variant in ('AM62AX') - - +-------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------------+ - | Board | SD Boot | USB DFU | USB MSC | - +=============+==================================+========================================================+========================================================+ - | AM62AX SK | | ``am62ax_evm_r5_defconfig`` | | ``am62ax_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``am62ax_evm_r5_defconfig am62x_r5_usbmsc.config`` | - | | | ``am62ax_evm_a53_defconfig`` | | ``am62ax_evm_a53_defconfig`` | | ``am62ax_evm_a53_defconfig`` | - +-------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------------+ - - .. note:: - - Where to get the sources: - - - ti-u-boot version: :ref:`u-boot-release-notes` - - ti-linux-firmware version: :ref:`ti-linux-fw-release-notes` - - TF-A version: :ref:`tf-a-release-notes` - - OP-TEE version: :ref:`optee-release-notes` - - .. code-block:: console - - $ export UBOOT_DIR= - $ export TI_LINUX_FW_DIR= - $ export TFA_DIR= - $ export OPTEE_DIR= - - .. note:: - - The instructions below assume all binaries are built manually. For instructions to build bl31.bin go to: :ref:`foundational-components-optee`. - For instructions to build tee-pager_v2.bin (bl32.bin) go to: :ref:`foundational-components-atf`. BINMAN_INDIRS can point to - /board-support/prebuilt-images to use the pre-built binaries that come in the pre-built SDK (bl31.bin for BL31, bl32.bin for TEE). - - .. code-block:: console - - $ cd $UBOOT_DIR - - R5 - To build tiboot3.bin. Saved in $UBOOT_DIR/out/r5. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62ax_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. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am62ax_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 - - .. ifconfig:: CONFIG_part_variant in ('AM62DX') - - +-------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------------+ - | Board | SD Boot | USB DFU | USB MSC | - +=============+==================================+========================================================+========================================================+ - | AM62DX EVM | | ``am62dx_evm_r5_defconfig`` | | ``am62dx_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``am62dx_evm_r5_defconfig am62x_r5_usbmsc.config`` | - | | | ``am62dx_evm_a53_defconfig`` | | ``am62dx_evm_a53_defconfig`` | | ``am62dx_evm_a53_defconfig`` | - +-------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------------+ - - .. note:: - - Where to get the sources: - - - ti-u-boot version: :ref:`u-boot-release-notes` - - ti-linux-firmware version: :ref:`ti-linux-fw-release-notes` - - TF-A version: :ref:`tf-a-release-notes` - - OP-TEE version: :ref:`optee-release-notes` - - .. code-block:: console - - $ export UBOOT_DIR= - $ export TI_LINUX_FW_DIR= - $ export TFA_DIR= - $ export OPTEE_DIR= - - .. note:: - - The instructions below assume all binaries are built manually. For instructions to build bl31.bin go to: :ref:`foundational-components-optee`. - For instructions to build tee-pager_v2.bin (bl32.bin) go to: :ref:`foundational-components-atf`. BINMAN_INDIRS can point to - :file:`/board-support/prebuilt-images` to use the pre-built binaries that come in the pre-built SDK (bl31.bin for BL31, bl32.bin for TEE). - - .. code-block:: console - - $ cd $UBOOT_DIR - - R5 - To build tiboot3.bin. Saved in $UBOOT_DIR/out/r5. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62dx_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. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am62dx_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 - - - - .. ifconfig:: CONFIG_part_variant in ('AM62PX') - - +-------------+----------------------------------+----------------------------------------------------------+--------------------------------------------------------+-----------------------------------------+ - | Board | SD Boot | USB DFU | USB MSC | Ethernet Boot | - +=============+==================================+==========================================================+========================================================+=========================================+ - | AM62PX SK | | ``am62px_evm_r5_defconfig`` | | ``am62px_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``am62px_evm_r5_defconfig am62x_r5_usbmsc.config`` | | ``am62px_evm_r5_ethboot_defconfig`` | - | | | ``am62px_evm_a53_defconfig`` | | ``am62px_evm_a53_defconfig`` | | ``am62px_evm_a53_defconfig`` | | ``am62px_evm_a53_ethboot_defconfig`` | - +-------------+----------------------------------+----------------------------------------------------------+--------------------------------------------------------+-----------------------------------------+ - - .. note:: - - Where to get the sources: :ref:`release-specific-build-information`. - - .. code-block:: console - - $ export UBOOT_DIR= - $ export TI_LINUX_FW_DIR= - $ export TFA_DIR= - $ export OPTEE_DIR= - - .. note:: - - The instructions below assume all binaries are built manually. For instructions to build bl31.bin go to: :ref:`foundational-components-optee`. - For instructions to build tee-pager_v2.bin (bl32.bin) go to: :ref:`foundational-components-atf`. BINMAN_INDIRS can point to - /board-support/prebuilt-images to use the pre-built binaries that come in the pre-built SDK (bl31.bin for BL31, bl32.bin for TEE). - - .. code-block:: console - - R5 - To build tiboot3.bin. Saved in $UBOOT_DIR/out/r5. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_32" am62px_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. - $ make ARCH=arm CROSS_COMPILE="$CROSS_COMPILE_64" am62px_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 - - .. ifconfig:: CONFIG_part_variant in ('AM62LX') - - .. ifconfig:: CONFIG_part_variant in ('AM62LX') - - .. csv-table:: - :header: "Board","SD/eMMC UART OSPI USB-DFU USB-MSC" - - "AM62LX EVM", "am62lx_evm_defconfig" - - .. note:: - - Where to get the sources: :ref:`release-specific-build-information`. - - .. code-block:: console - - $ export UBOOT_DIR= - $ export TI_LINUX_FW_DIR= - $ export TFA_DIR= - - .. note:: - - The instructions below assume all binaries are built manually. - For instructions to build :file:bl1.bin or :file:bl31.bin go - to: :ref:`foundational-components-atf`. - - **BINMAN_INDIRS** can point to - :file:`/board-support/prebuilt-images` to use - the pre-built binaries that come in the pre-built SDK. - - .. code-block:: console - - $ make CROSS_COMPILE="$CROSS_COMPILE_64" am62lx_evm_defconfig O=$UBOOT_DIR/out - $ make CROSS_COMPILE="$CROSS_COMPILE_64" O=$UBOOT_DIR/out \ - BL1=$TFA_DIR/build/k3/am62l/release/bl1.bin \ - BL31=$TFA_DIR/build/k3/am62l/release/bl31.bin \ - BINMAN_INDIRS=$TI_LINUX_FW_DIR - -.. ifconfig:: CONFIG_part_variant not in ('AM64X', 'AM62X', 'AM62AX', 'AM62LX') - - .. note:: - - BINMAN_INDIRS is used to fetch the DM binary from board-support/prebuilt-images/ti-dm/ and SYSFW binaries from board-support/prebuilt-images/ti-sysfw/. If not using the SDK, BINMAN_INDIRS can point to either ti-linux-firmware or any folder where DM is located in /ti-dm/ and SYSFW binaries are present in /ti-sysfw/. Please make sure to use the absolute path. - -.. ifconfig:: CONFIG_part_variant in ('AM64X', 'AM62X', 'AM62AX') - - .. note:: - - BINMAN_INDIRS is used to fetch the DM binary from /ti-dm/ and SYSFW binaries from /ti-sysfw/. If using the SDK, BINMAN_INDIRS can point to /board-support/prebuilt-images. Else any folder where DM is located in /ti-dm/ and SYSFW binaries are present in /ti-sysfw/ can be used. Please make sure to use the absolute path. - -.. ifconfig:: CONFIG_part_variant in ('AM62LX') - - .. note:: - - BINMAN_INDIRS is used to fetch the TIFS binaries from - :file:`/ti-sysfw/`. If using the SDK, - BINMAN_INDIRS can point to - :file:`/board-support/prebuilt-images`. Else any - folder where SYSFW binaries are present in - :file:`/ti-sysfw/` can be used. Please make sure - to use the absolute path. - -.. ifconfig:: CONFIG_part_variant in ('J721E', 'J7200', 'AM62X', 'AM62AX', 'AM62DX', 'AM62PX', 'J721S2', 'J784S4','J742S2', 'J722S') - - .. note:: - - It is also possible to pick up a custom DM binary by adding TI_DM argument pointing to the file. If not provided, it defaults to picking up the DM binary from BINMAN_INDIRS. This is only applicable to devices that use split firmware. - -.. ifconfig:: CONFIG_part_variant in ('AM65X', 'J721E', 'J7200', 'AM64X', 'AM62X', 'AM62AX', 'AM62DX', 'AM62LX', 'AM62PX', 'J721S2', 'J784S4','J742S2', 'J722S') - - .. rubric:: Target Images - :name: target-images - - Copy the below images to the boot partition of an SD card and boot. - Instructions to format the SD card can be found :ref:`here `. - -.. ifconfig:: CONFIG_part_variant in ('AM65X') - - * GP - - * tiboot3-am65x_sr2-gp-evm.bin, sysfw-am65x_sr2-gp-evm.itb from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a53 - - * HS - - * tiboot3-am65x_sr2-hs-evm.bin, sysfw-am65x_sr2-hs-evm.itb from /r5 - * tispl.bin, u-boot.img from /a53 - -.. ifconfig:: CONFIG_part_variant in ('J721E') - - * GP - - * tiboot3-j721e-gp-evm.bin, sysfw-j721e-gp-evm.itb from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a72 - - * HS-FS - - * tiboot3-j721e_sr2-hs-fs-evm.bin, sysfw-j721e_sr2-hs-fs-evm.itb from /r5 - * tispl.bin, u-boot.img from /a72 - - * HS-SE - - * tiboot3-j721e_sr2-hs-evm.bin, sysfw-j721e_sr2-hs-evm.itb from /r5 - * tispl.bin, u-boot.img from /a72 - -.. ifconfig:: CONFIG_part_variant in ('J7200') - - * GP - - * tiboot3-j7200-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a72 - - * HS-FS - - * tiboot3-j7200_sr2-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - - * HS-SE - - * tiboot3-j7200_sr2-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - -.. ifconfig:: CONFIG_part_variant in ('J721S2') - - * GP - - * tiboot3-j721s2-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a72 - - * HS-FS - - * tiboot3-j721s2-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - - * HS-SE - - * tiboot3-j721s2-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - -.. ifconfig:: CONFIG_part_variant in ('J784S4') - - * GP - - * tiboot3-j784s4-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a72 - - * HS-FS - - * tiboot3-j784s4-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - - * HS-SE - - * tiboot3-j784s4-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - -.. ifconfig:: CONFIG_part_variant in ('J742S2') - - * GP - - * tiboot3-j742s2-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a72 - - * HS-FS - - * tiboot3-j742s2-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - - * HS-SE - - * tiboot3-j742s2-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a72 - -.. ifconfig:: CONFIG_part_variant in ('AM64X') - - * GP - - * tiboot3-am64x-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a53 - - * HS-FS - - * tiboot3-am64x_sr2-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - - * HS-SE - - * tiboot3-am64x_sr2-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - -.. ifconfig:: CONFIG_part_variant in ('AM62X') - - * GP - - * tiboot3-am62x-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a53 - - * HS-FS - - * tiboot3-am62x-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - - * HS-SE - - * tiboot3-am62x-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - -.. ifconfig:: CONFIG_part_variant in ('AM62AX') - - * GP - - * tiboot3-am62ax-gp-evm.bin from /r5 - * tispl.bin_unsigned, u-boot.img_unsigned from /a53 - - * HS-FS - - * tiboot3-am62ax-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - - * HS-SE - - * tiboot3-am62ax-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - -.. ifconfig:: CONFIG_part_variant in ('AM62DX') - - * HS-FS - - * :file:`tiboot3-am62dx-hs-fs-evm.bin` from :file:`/r5` - * :file:`tispl.bin, u-boot.img` from :file:`/a53` - - * HS-SE - - * :file:`tiboot3-am62dx-hs-evm.bin` from :file:`/r5` - * :file:`tispl.bin, u-boot.img` from :file:`/a53` - -.. ifconfig:: CONFIG_part_variant in ('AM62PX') - - * HS-FS - - * tiboot3-am62px-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - - * HS-SE - - * tiboot3-am62px-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - -.. ifconfig:: CONFIG_part_variant in ('J722S') - - * HS-FS - - * tiboot3-j722s-hs-fs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - - * HS-SE - - * tiboot3-j722s-hs-evm.bin from /r5 - * tispl.bin, u-boot.img from /a53 - -.. ifconfig:: CONFIG_part_variant in ('AM62LX') - - * **HS-FS** - - * tiboot3-am62lx-hs-fs-evm.bin - * tispl.bin - * u-boot.img - -.. ifconfig:: CONFIG_part_variant in ('AM65X', 'J721E', 'J7200', 'AM64X', 'AM62X', 'AM62AX', 'AM62DX', 'AM62PX', 'J721S2', 'J784S4','J742S2', 'J722S', 'AM62LX') - - .. warning:: - - Rename :file:`tiboot3--evm.bin` to :file:`tiboot3.bin` in order for the device to load this binary from the SD card boot partition. - Also, (For GP devices only) rename :file:`tispl.bin_unsigned` to :file:`tispl.bin` and :file:`u-boot.img_unsigned` to :file:`u-boot.img` as well. - -Image Formats -^^^^^^^^^^^^^ - - .. ifconfig:: CONFIG_part_variant not in ('J7200', 'AM64X', 'J721S2', 'J721E', 'AM62X', 'AM62AX', 'AM62LX', 'J784S4','J742S2', 'J722S', 'AM57X') - - - tiboot3.bin - - .. code-block:: text - - +-----------------------+ - | X.509 | - | Certificate | - | +-------------------+ | - | | | | - | | R5 | | - | | u-boot-spl.bin | | - | | | | - | +-------------------+ | - | | | | - | | FIT header | | - | | +---------------+ | | - | | | | | | - | | | DTB 1...N | | | - | | +---------------+ | | - | +-------------------+ | - +-----------------------+ - - - tispl.bin - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | ARM64 ATF | | - | +-------------------+ | - | | | | - | | ARM64 OPTEE | | - | +-------------------+ | - | | | | - | | ARM64 SPL | | - | +-------------------+ | - | | | | - | | SPL DTB 1...N | | - | +-------------------+ | - +-----------------------+ - - - sysfw.itb - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | sysfw.bin | | - | +-------------------+ | - | | | | - | | board config | | - | +-------------------+ | - | | | | - | | PM config | | - | +-------------------+ | - | | | | - | | RM config | | - | +-------------------+ | - | | | | - | | Secure config | | - | +-------------------+ | - +-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J721E') - - - tiboot3.bin - - .. code-block:: text - - +-----------------------+ - | X.509 | - | Certificate | - | +-------------------+ | - | | | | - | | R5 | | - | | u-boot-spl.bin | | - | | | | - | +-------------------+ | - | | | | - | | FIT header | | - | | +---------------+ | | - | | | | | | - | | | DTB 1...N | | | - | | +---------------+ | | - | +-------------------+ | - +-----------------------+ - - - tispl.bin - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | A72 ATF | | - | +-------------------+ | - | | | | - | | A72 OPTEE | | - | +-------------------+ | - | | | | - | | R5 DM FW | | - | +-------------------+ | - | | | | - | | A72 SPL | | - | +-------------------+ | - | | | | - | | SPL DTB 1...N | | - | +-------------------+ | - +-----------------------+ - - - sysfw.itb - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | sysfw.bin | | - | +-------------------+ | - | | | | - | | board config | | - | +-------------------+ | - | | | | - | | PM config | | - | +-------------------+ | - | | | | - | | RM config | | - | +-------------------+ | - | | | | - | | Secure config | | - | +-------------------+ | - +-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J7200', 'J721S2', 'J784S4','J742S2') - - - tiboot3.bin: - - .. code-block:: text - - +-----------------------+ - | X.509 | - | Certificate | - | +-------------------+ | - | | | | - | | R5 | | - | | u-boot-spl.bin | | - | | | | - | +-------------------+ | - | | | | - | | FIT header | | - | | +---------------+ | | - | | | | | | - | | | DTB 1...N | | | - | | +---------------+ | | - | +-------------------+ | - | | | | - | | FIT HEADER | | - | | +---------------+ | | - | | | | | | - | | | sysfw.bin | | | - | | +---------------+ | | - | | | | | | - | | | board config | | | - | | +---------------+ | | - | | | | | | - | | | PM config | | | - | | +---------------+ | | - | | | | | | - | | | RM config | | | - | | +---------------+ | | - | | | | | | - | | | Secure config | | | - | | +---------------+ | | - | +-------------------+ | - +-----------------------+ - - - tispl.bin - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | A72 ATF | | - | +-------------------+ | - | | | | - | | A72 OPTEE | | - | +-------------------+ | - | | | | - | | R5 DM FW | | - | +-------------------+ | - | | | | - | | A72 SPL | | - | +-------------------+ | - | | | | - | | SPL DTB 1...N | | - | +-------------------+ | - +-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('AM64X') - - - tiboot3.bin: - - .. code-block:: text - - +-----------------------+ - | X.509 | - | Certificate | - | +-------------------+ | - | | | | - | | R5 | | - | | u-boot-spl.bin | | - | | | | - | +-------------------+ | - | | | | - | | FIT header | | - | | +---------------+ | | - | | | | | | - | | | DTB 1...N | | | - | | +---------------+ | | - | +-------------------+ | - | | | | - | | FIT HEADER | | - | | +---------------+ | | - | | | | | | - | | | sysfw.bin | | | - | | +---------------+ | | - | | | | | | - | | | board config | | | - | | +---------------+ | | - | | | | | | - | | | PM config | | | - | | +---------------+ | | - | | | | | | - | | | RM config | | | - | | +---------------+ | | - | | | | | | - | | | Secure config | | | - | | +---------------+ | | - | +-------------------+ | - +-----------------------+ - - - tispl.bin - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | A53 ATF | | - | +-------------------+ | - | | | | - | | A53 OPTEE | | - | +-------------------+ | - | | | | - | | A53 SPL | | - | +-------------------+ | - | | | | - | | SPL DTB 1...N | | - | +-------------------+ | - +-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S') - - - tiboot3.bin: - - .. code-block:: text - - +-----------------------+ - | X.509 | - | Certificate | - | +-------------------+ | - | | | | - | | R5 | | - | | u-boot-spl.bin | | - | | | | - | +-------------------+ | - | | | | - | |TIFS with board cfg| | - | | | | - | +-------------------+ | - | | | | - | | | | - | | FIT header | | - | | +---------------+ | | - | | | | | | - | | | DTB 1...N | | | - | | +---------------+ | | - | +-------------------+ | - +-----------------------+ - - - tispl.bin - - .. code-block:: text - - +-----------------------+ - | | - | FIT HEADER | - | +-------------------+ | - | | | | - | | A53 ATF | | - | +-------------------+ | - | | | | - | | A53 OPTEE | | - | +-------------------+ | - | | | | - | | R5 DM FW | | - | +-------------------+ | - | | | | - | | A53 SPL | | - | +-------------------+ | - | | | | - | | SPL DTB 1...N | | - | +-------------------+ | - +-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('AM62LX') - - - tiboot3.bin - - .. code-block:: text - - TIBOOT3 - ┌─────────────┐ - │ X.509 │ - │ Certificate │ - │┌───────────┐│ - ││ BL-1 ││ - │├───────────┤│ - ││ TIFS ││ - │├───────────┤│ - ││ TIFS CERT ││ - │└───────────┘│ - └─────────────┘ - - - tispl.bin - - .. code-block:: text - - TISPL - ┌─────────────┐ - │ X.509 │ - │ Certificate │ - │┌───────────┐│ - ││ BL-31 ││ - │├───────────┤│ - ││ TIFS ││ - │├───────────┤│ - ││ TIFS CERT ││ - │├───────────┤│ - ││ BRD + SEC ││ - ││ CONFIGS ││ - │├───────────┤│ - ││ U-BOOT ││ - ││ SPL ││ - │└───────────┘│ - └─────────────┘ - -.. _Boot-Flow-label: - -Boot Flow -^^^^^^^^^ -.. ifconfig:: CONFIG_part_family in ('AM335X_family', 'AM437X_family', 'AM57X_family') - - Booting the Linux kernel on an embedded platform is not as simple as simply - pointing a program counter to the kernel location and letting the processor - run. This section will review the four bootloader software stages that must - be run before the kernel can be booted and run on the device. - - Application processors such as the the AM335x are complex pieces of hardware, - but have limited internal RAM (e.g., 128KB). Because of this limited amount - of RAM, multiple bootloader stages are needed. These bootloader stages - systematically unlock the full functionality of the device so that all - complexities of the device are available to the kernel. - - There are four distinct bootloader stages: - - .. Image:: /images/U-Boot_Boot_Order_32bit.png - - 1. ROM Code - - The first stage bootloader is housed in ROM on the device. The ROM code is - the first block of code that is automatically run on device start-up or - after power-on reset (POR). The ROM bootloader code is hardcoded into the - device and cannot be changed by the user. Because of this, it is important - to get an understanding of what exactly the ROM code is doing. - - The ROM code has two main functions: - - * Configuration of the device and initialization of primary peripherals - such as stack setup, configuring the Watchdog Timer (see TRM for details) - as well as the PLL and system clocks configuration - * Readies the device for next bootloader by checking boot sources for next - stage of bootloader (SPL) as well as loading the actual next stage - bootloader code into memory and starting it - - The list of booting devices that the ROM code will search through for the - second stage bootloader is configured by the voltage levels set on the - devices SYSBOOT pins on startup. These pins also set other boot parameters - (i.e. expected crystal frequency, bus width of external memory). For more - information on the SYSBOOT pins and associated boot parameters see the - device TRM. - - 2. SPL or MLO - - The second stage bootloader is known as the SPL (Secondary Program Loader), - but is sometimes referred to as the MLO (MMC Card Loader). The SPL is the - first stage of U-Boot, and must be loaded from one of the boot sources into - internal RAM. The SPL has very limited configuration or user interaction, - and mainly serves to initialize the external DDR memory and set-up the boot - process for the next bootloader stage: U-Boot. - - 3. U-Boot - - U-Boot allows for powerful command-based control over the kernel boot - environment via a serial terminal. The user has control over a number of - parameters such as boot arguments and the kernel boot command. In addition, - U-Boot environment variables can be configured. These environment variables - are stored in the **uEnv.txt** file on your storage medium or directly in - a Flash-based memory if configured such. These environment variables can be - viewed, modified, and saved using the **env print**, **env set**, and - **env save** commands, respectively. U-Boot is also a very useful tool to - program and manipulate a wide range of external memory devices as well as - a helpful aid during custom board bringup. - - 4. Linux Kernel - - **zImage** is the compressed kernel image wrapped with header info that - describes the kernel. This header includes the target architecture, the - operating system, kernel size, entry points, etc. The loading of the kernel - image is typically performed through the use of scripts stored in the U-Boot - environment (all starting with the **bootcmd** ENV variable that gets - executed after the autoboot countdown expires or manually by entering the - **boot** command at the U-Boot prompt). This also involves passing a board- - specific device tree blob (DTB) as an argument to U-Boot's **bootz** - command that will extract and start the actual kernel. - -.. ifconfig:: CONFIG_part_family not in ('AM335X_family', 'AM437X_family', 'AM62LX_family', 'AM57X_family') - - On K3 architecture based devices, ROM supports boot only via MCU(R5). This means that - bootloader has to run on R5 core. In order to meet this constraint, keeping - safety in picture and to have faster boot time, the software boot architecture - is designed as below: - - .. ifconfig:: CONFIG_part_family not in ('J7_family', 'AM64X_family', 'AM62X_family', 'AM62AX_family') - - .. code-block:: text - - +------------------------------------------------------------------------+ - | DMSC | R5 | ARM64 | - +------------------------------------------------------------------------+ - | +--------+ | | | - | | Reset | | | | - | +--------+ | | | - | : | | | - | +--------+ | +-----------+ | | - | | *ROM* |----------|-->| Reset rls | | | - | +--------+ | +-----------+ | | - | | | | : | | - | | ROM | | : | | - | |services| | : | | - | | | | +-------------+ | | - | | | | | *R5 ROM* | | | - | | | | +-------------+ | | - | | |<---------|---|Load and auth| | | - | | | | | tiboot3.bin | | | - | | | | +-------------+ | | - | | | | : | | - | | | | : | | - | | | | : | | - | | | | +-------------+ | | - | | | | | *R5 SPL* | | | - | | | | +-------------+ | | - | | | | | Load | | | - | | | | | sysfw.itb | | | - | | Start | | +-------------+ | | - | | System |<---------|---| Start | | | - | |Firmware| | | SYSFW | | | - | +--------+ | +-------------+ | | - | : | | | | | - | +---------+ | | Load | | | - | | *SYSFW* | | | system | | | - | +---------+ | | Config data | | | - | | |<--------|---| | | | - | | | | +-------------+ | | - | | | | | | | | - | | | | | DDR | | | - | | | | | config | | | - | | | | +-------------+ | | - | | | | | | | | - | | |<--------|---| Start A53 | | | - | | | | | and Reset | | | - | | | | +-------------+ | | - | | | | | +-----------+ | - | | |---------|-----------------------|---->| Reset rls | | - | | | | | +-----------+ | - | | DMSC | | | : | - | |Services | | | +-----------+ | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<--------|-----------------------|---->| *A53 SPL* | | - | | | | | +-----------+ | - | | | | | | Load | | - | | | | | | u-boot.img| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<--------|-----------------------|---->| *U-Boot* | | - | | | | | +-----------+ | - | | | | | | prompt | | - | | | | | +-----------+ | - | +---------+ | | | - | | | | - +------------------------------------------------------------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J721E') - - .. code-block:: text - - +------------------------------------------------------------------------+-----------------------+ - | DMSC | MCU R5 | A72 | MAIN R5/C66x/C7x | - +------------------------------------------------------------------------+-----------------------+ - | +--------+ | | | | - | | Reset | | | | | - | +--------+ | | | | - | : | | | | - | +--------+ | +-----------+ | | | - | | *ROM* |----------|-->| Reset rls | | | | - | +--------+ | +-----------+ | | | - | | | | : | | | - | | ROM | | : | | | - | |services| | : | | | - | | | | +-------------+ | | | - | | | | | *R5 ROM* | | | | - | | | | +-------------+ | | | - | | |<---------|---|Load and auth| | | | - | | | | | tiboot3.bin | | | | - | | | | +-------------+ | | | - | | | | : | | | - | | | | : | | | - | | | | : | | | - | | | | +-------------+ | | | - | | | | | *R5 SPL* | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | sysfw.itb | | | | - | | Start | | +-------------+ | | | - | | System |<---------|---| Start | | | | - | |Firmware| | | SYSFW | | | | - | +--------+ | +-------------+ | | | - | : | | | | | | - | +---------+ | | Load | | | | - | | *SYSFW* | | | system | | | | - | +---------+ | | Config data | | | | - | | |<--------|---| | | | | - | | | | +-------------+ | | | - | | | | | DDR | | | | - | | | | | config | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | tispl.bin | | | | - | | | | +-------------+ | | | - | | | | | Load R5 | | | | - | | | | | firmware | | | | - | | | | +-------------+ | | | - | | |<--------|---| Start A72 | | | | - | | | | | and jump to | | | | - | | | | | DM fw image | | | | - | | | | +-------------+ | | | - | | | | | +-----------+ | | - | | |---------|-----------------------|---->| Reset rls | | | - | | | | | +-----------+ | | - | | TIFS | | | : | | - | |Services | | | +-----------+ | | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *A72 SPL* | | | - | | | | | +-----------+ | | - | | | | | | Load | | | - | | | | | | u-boot.img| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *U-Boot* | | | - | | | | | +-----------+ | | - | | | | | | prompt | | | - | | | | | +-----------+ | | - | | | | | | Load R5 | | | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | - | | | | | | Load C6 | | +-----------+ | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start C6 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| C6 starts | | - | | | | | | Load C7 | | +-----------+ | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start C7 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| C7 starts | | - | +---------+ | | | +-----------+ | - | | | | | - +------------------------------------------------------------------------+-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('J7200', 'J721S2', 'J784S4','J742S2') - - .. code-block:: text - - +------------------------------------------------------------------------+-----------------------+ - | SMS | MCU R5 | A72 | MAIN R5/C7x | - +------------------------------------------------------------------------+-----------------------+ - | +--------+ | | | | - | | Reset | | | | | - | +--------+ | | | | - | : | | | | - | +--------+ | +-----------+ | | | - | | *ROM* |----------|-->| Reset rls | | | | - | +--------+ | +-----------+ | | | - | | | | : | | | - | | ROM | | : | | | - | |services| | : | | | - | | | | +-------------+ | | | - | | | | | *R5 ROM* | | | | - | | | | +-------------+ | | | - | | |<---------|---|Load and auth| | | | - | | | | | tiboot3.bin | | | | - | | Start | | +-------------+ | | | - | | TIFS |<---------|---| Start | | | | - | | | | | TIFS | | | | - | +--------+ | +-------------+ | | | - | : | | | | | | - | +---------+ | | Load | | | | - | | *TIFS* | | | system | | | | - | +---------+ | | Config data | | | | - | | |<--------|---| | | | | - | | | | +-------------+ | | | - | | | | : | | | - | | | | : | | | - | | | | : | | | - | | | | +-------------+ | | | - | | | | | *R5 SPL* | | | | - | | | | +-------------+ | | | - | | | | | DDR | | | | - | | | | | config | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | tispl.bin | | | | - | | | | +-------------+ | | | - | | | | | Load R5 | | | | - | | | | | firmware | | | | - | | | | +-------------+ | | | - | | |<--------|---| Start A72 | | | | - | | | | | and jump to | | | | - | | | | | DM fw image | | | | - | | | | +-------------+ | | | - | | | | | +-----------+ | | - | | |---------|-----------------------|---->| Reset rls | | | - | | | | | +-----------+ | | - | | TIFS | | | : | | - | |Services | | | +-----------+ | | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *A72 SPL* | | | - | | | | | +-----------+ | | - | | | | | | Load | | | - | | | | | | u-boot.img| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *U-Boot* | | | - | | | | | +-----------+ | | - | | | | | | prompt | | | - | | | | | +-----------+ | | - | | | | | | Load R5 | | | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | - | | | | | | Load C7 | | +-----------+ | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start C7 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| C7 starts | | - | | | | | | +-----------+ | - | | | | | | | - | +---------+ | | | | - | | | | | - +------------------------------------------------------------------------+-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('AM64X') - - .. code-block:: text - - +------------------------------------------------------------------------+-----------------------+ - | DMSC | MAIN R50 | A53 | MAIN R51 | - +------------------------------------------------------------------------+-----------------------+ - | +--------+ | | | | - | | Reset | | | | | - | +--------+ | | | | - | : | | | | - | +--------+ | +-----------+ | | | - | | *ROM* |----------|-->| Reset rls | | | | - | +--------+ | +-----------+ | | | - | | | | : | | | - | | ROM | | : | | | - | |services| | : | | | - | | | | +-------------+ | | | - | | | | | *R5 ROM* | | | | - | | | | +-------------+ | | | - | | |<---------|---|Load and auth| | | | - | | | | | tiboot3.bin | | | | - | | Start | | +-------------+ | | | - | | SYSFW |<---------|---| Start | | | | - | | | | | SYSFW | | | | - | +--------+ | +-------------+ | | | - | : | | | | | | - | +---------+ | | Load | | | | - | | *SYSFW* | | | system | | | | - | +---------+ | | Config data | | | | - | | |<--------|---| | | | | - | | | | +-------------+ | | | - | | | | : | | | - | | | | : | | | - | | | | : | | | - | | | | +-------------+ | | | - | | | | | *R5 SPL* | | | | - | | | | +-------------+ | | | - | | | | | DDR | | | | - | | | | | config | | | | - | | | | +-------------+ | | | - | | | | | Load | | | | - | | | | | tispl.bin | | | | - | | | | +-------------+ | | | - | | |<--------|---| Start A53 | | | | - | | | | +-------------+ | | | - | | | | | +-----------+ | | - | | |---------|-----------------------|---->| Reset rls | | | - | | | | | +-----------+ | | - | | SYSFW | | | : | | - | |Services | | | +-----------+ | | - | | |<--------|-----------------------|---->|*ATF/OPTEE*| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *A53 SPL* | | | - | | | | | +-----------+ | | - | | | | | | Load | | | - | | | | | | u-boot.img| | | - | | | | | +-----------+ | | - | | | | | : | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|---->| *U-Boot* | | | - | | | | | +-----------+ | | - | | | | | | prompt | | | - | | | | | +-----------+ | | - | | | | | | Load R5 | | | - | | | | | | Firmware | | | - | | | | | +-----------+ | | - | | |<--------|-----------------------|-----| Start R5 | | +-----------+ | - | | |---------|-----------------------|-----+-----------+-----|----->| R5 starts | | - | | | | | | +-----------+ | - | | | | | | | - | +---------+ | | | | - | | | | | - +------------------------------------------------------------------------+-----------------------+ - - .. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S') - - .. code-block:: text - - +------------------------------------------------------------------------+ - | TIFS | Main R5 | A53 | - +------------------------------------------------------------------------+ - | +--------+ | | | - | | Reset | | | | - | +--------+ | | | - | : | | | - | +--------+ | +-----------+ | | - | | *ROM* |----------|-->| Reset rls | | | - | +--------+ | +-----------+ | | - | | | | : | | - | | ROM | | : | | - | |services| | : | | - | | | | +-------------+ | | - | | | | | *R5 ROM* | | | - | | | | +-------------+ | | - | | |<---------|---|Load and auth| | | - | | | | | tiboot3.bin | | | - | +--------+ | +-------------+ | | - | | |<---------|---| Load sysfw | | | - | | | | | part to TIFS| | | - | | | | | core | | | - | | | | +-------------+ | | - | | | | : | | - | | | | : | | - | | | | : | | - | | | | +-------------+ | | - | | | | | *R5 SPL* | | | - | | | | +-------------+ | | - | | | | | DDR | | | - | | | | | config | | | - | | | | +-------------+ | | - | | | | | Load | | | - | | | | | tispl.bin | | | - | | | | +-------------+ | | - | | | | | Load R5 | | | - | | | | | firmware | | | - | | | | +-------------+ | | - | | |<---------|---| Start A53 | | | - | | | | | and jump to | | | - | | | | | DM fw image | | | - | | | | +-------------+ | | - | | | | | +-----------+ | - | | |----------|-----------------------|---->| Reset rls | | - | | | | | +-----------+ | - | | TIFS | | | : | - | |Services| | | +-----------+ | - | | |<---------|-----------------------|---->|*ATF/OPTEE*| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<---------|-----------------------|---->| *A53 SPL* | | - | | | | | +-----------+ | - | | | | | | Load | | - | | | | | | u-boot.img| | - | | | | | +-----------+ | - | | | | | : | - | | | | | +-----------+ | - | | |<---------|-----------------------|---->| *U-Boot* | | - | | | | | +-----------+ | - | | | | | | prompt | | - | | |----------|-----------------------|-----+-----------+-----| - | +--------+ | | | - | | | | - +------------------------------------------------------------------------+ - - Here |__SYSFW_CORE_NAME__| acts as master and provides all the critical services. R5/ARM64 - requests |__SYSFW_CORE_NAME__| to get these services done as shown in the above diagram. - -.. ifconfig:: CONFIG_part_variant in ('AM62LX') - - Unlike with most other K3 SoCs, the AM62LX does not have an Cortext-R5 - MCU core which ROM uses to initialize the SoC. Therefore it uses a 2 - phase ROM boot. The first phase will load the tiboot3.bin image which - contains Trusted-Firmware-A's BL-1 loader along with the typical X.509 - certificate to authenticate and validate the image which is used to - intialize the console and DDR for the next phase. - - .. code-block:: text - - ┌───────────────────┐┌───────────────────┐ - │ Secure ROM ││ Public ROM │ - │ SMS (M4) ││ (Cortex-A53) │ - │ ││ │ - │┌─────────────────┐││ │ - ││ Reset Release │││ │ - │└────────┬────────┘││ │ - │ │ ││ │ - │┌────────▼────────┐││ │ - ││ ROM Init │││ │ - │└────────┬────────┘││ │ - │ │ ││ │ - │┌────────▼────────┐││┌─────────────────┐│ - ││ Release A53 ┼┼┼► Release A53 ││ - │└─────────────────┘││└────────┬────────┘│ - │ ││ │ │ - │ Validate Image ││┌────────▼────────┐│ - │┌─────────────────┐│││ ROM Init ││ - ││ Integrity Check ◄┼┼┼ (1st Phase) ││ - │├─────────────────│││└────────┬────────┘│ - ││ Authentication │││ │ │ - │├─────────────────┤││┌────────▼────────┐│ - ││ Decryption ││││ WFI ││ - │└────────┬────────┘││└─────────────────┘│ - │ │ ││ │ - │┌────────▼────────┐││ End of ROM │ - ││ Wait for WFI │││~~~~~~~~~~~~~~~~~~~│ - ││ on Cortex-A53 │││ Start of │ - │└────────┬────────┘││ BL-1 │ - │ │ ││ │ - │┌────────▼────────┐││┌─────────────────┐│ - ││ Start BL-1 ┼┼┼► DDR Init ││ - │└────────┬────────┘││└────────┬────────┘│ - │ │ ││ │ │ - │┌────────▼────────┐││┌────────▼────────┐│ - ││ Wait for BL-1 ◄┼┼┼ Send BL-1 Done ││ - ││ Done Msg │││└────────┬────────┘│ - │└─────────────────┘││ │ │ - │ ││┌────────▼────────┐│ - │ │││ WFI ││ - │ ││└─────────────────┘│ - └───────────────────┘└───────────────────┘ - - After the BL-1 sends a message back to the Secure ROM to indicate it - has completed, the Secure ROM will reset the A53 back into Public ROM - to begin the 2nd ROM boot phase to load the tispl.bin into the SoC. - - .. code-block:: text - - ┌───────────────────┐┌───────────────────┐ - │ Secure ROM ││ Public ROM │ - │ SMS (M4) ││ (Cortex-A53) │ - │ ││ │ - │┌─────────────────┐││ │ - ││ Program Reset │││┌─────────────────┐│ - ││ Vector And ┼┼┼► Release A53 ││ - ││ Reset A53 │││└────────┬────────┘│ - │└─────────────────┘││ │ │ - │ ││ │ │ - │ Validate Image ││┌────────▼────────┐│ - │┌─────────────────┐│││ ROM Init ││ - ││ Integrity Check ◄┼┼┼ (2nd Phase) ││ - │├─────────────────┤││└────────┬────────┘│ - ││ Authentication │││ │ │ - │├─────────────────┤││┌────────▼────────┐│ - ││ Decryption ││││ WFI ││ - │└────────┬────────┘││└─────────────────┘│ - │ │ ││ │ - │┌────────▼────────┐││ End of ROM │ - ││ Wait for WFI │││~~~~~~~~~~~~~~~~~~~│ - ││ on Cortex-A53 │││ │ - │└────────┬────────┘││ │ - │ │ ││ │ - │┌────────▼────────┐││ │ - ││ Program Reset │││┌─────────────────┐│ - ││ Vector And ┼┼┼► TF-A (BL-31) ││ - ││ Reset A53 │││└────────┬────────┘│ - │└────────┬────────┘││ │ │ - │ │ ││┌────────▼────────┐│ - │┌────────▼────────┐│││ U-Boot SPL ││ - ││ Prep M4 Reset │││└────────┬────────┘│ - │└────────┬────────┘││ │ │ - │ │ ││┌────────▼────────┐│ - │┌────────▼────────┐│││ U-Boot ││ - ││ Boot TI-FS │││└────────┬────────┘│ - │└────────┬────────┘││ │ │ - │ │ ││ │ │ - │ End of ROM ││ │ │ - │~~~~~~~~~~~~~~~~~~~││ │ │ - │ │ ││┌────────▼────────┐│ - │┌────────▼────────┐│││ ││ - ││ ││││ ││ - ││ TI-FS ││││ Linux ││ - └┴─────────────────┴┘└┴─────────────────┴┘ - - From there TIFS, TF-A and U-Boot will has completed their - initialization routines which can begin loading the operating system - and complete the boot process. - -U-Boot Environment -^^^^^^^^^^^^^^^^^^ - -.. note:: - - SDK 9.0 will not default to the environments that are saved on the boards, - It will default to the ones that are given with the particular uboot in - the release. - -By default the SDK builds will have the default environments whenever being -run, to have some custom environments, one needs to rely on uEnv.txt -file. - -The added benefit of using uEnv.txt is that it is more granular than the -saveenv counterpart as we can choose to store the variables that are -actually being set during the development workflow. - -**Writing to MMC/EMMC** - -.. code-block:: console - - => env export -t $loadaddr - => fatwrite mmc ${mmcdev} ${loadaddr} ${bootenvfile} ${filesize} - -The following will update the uEnv.txt file on the bootmedia and then -whenever "run envboot" is run on the board, uEnv.txt will be read based on -mmcdev value to be read either from emmc/sd card. - -You can specifically choose the variables that you are changing in your -development process so that the other variables are not affected due to the -whole environment being saved. Optionally, one can save the full -environment too in uEnv.txt by not specifying this -will have some issues with the ethernet mac addresses not being overridden -but other things will be set. - -**Reading from MMC/EMMC** - -By default run envboot will read it from the MMC/EMMC partition ( based on -mmcdev) and set the environments. - -If manually needs to be done then the environment can be read from the -filesystem and then imported - -.. code-block:: console - - => fatload mmc ${mmcdev} ${loadaddr} ${bootenvfile} - => env import -t ${loadaddr} ${filesize} - -For production environments if one needs to rely on saveenv counterpart -then they can always refer to the `commit `__ - -.. rubric:: Networking Environment - :name: networking-environment - -When using a USB-Ethernet dongle a valid MAC address must be set in the -environment. To create a valid address please read `**this -page** `__. -Then issue the following command: - -.. code-block:: console - - => setenv usbethaddr value:from:link:above - -You can use the **printenv** command to see if **usbethaddr** is already -set. - -Then start the USB subsystem: - -.. code-block:: console - - => usb start - -The default behavior of U-Boot is to use all information that a DHCP -server passes to us when the user issues the **dhcp** command. This will -include the dhcp parameter *next-server* which indicates where to fetch -files from via TFTP. There may be times however where the dhcp server on -your network provides incorrect information and you are unable to modify -the server. In this case the following steps can be helpful: - -.. code-block:: console - - => setenv autoload no - => dhcp - => setenv serverip correct.server.ip - => tftp - -Another alternative is to use the full syntax of the tftp command: - -.. code-block:: console - - => setenv autoload no - => dhcp - => tftp ${loadaddr} server.ip:fileName - -Available RAM for image download -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To know the amount of RAM available for downloading images or for other -usage, use ``bdinfo`` command. - -.. code-block:: console - - => bdinfo - arch_number = 0x00000000 - boot_params = 0x80000100 - DRAM bank = 0x00000000 - -> start = 0x80000000 - -> size = 0x7F000000 - baudrate = 115200 bps - TLB addr = 0xFEFF0000 - relocaddr = 0xFEF30000 - reloc off = 0x7E730000 - irq_sp = 0xFCEF8880 - sp start = 0xFCEF8870 - Early malloc usage: 890 / 2000 - -After booting, U-Boot relocates itself (along with its various reserved -RAM areas) and places itself at end of available RAM (starting at -``relocaddr`` in ``bdinfo`` output above). Only the stack is located -just before that area. The address of top of the stack is in -``sp start`` in ``bdinfo`` output and it grows downwards. Users should -reserve at least about 1MB for stack, so in the example output above, -RAM in the range of ``[0x80000000, 0xFCE00000]`` is safely available for -use. - -Device Trees -^^^^^^^^^^^^ - -A note about device trees. Now all supported boards are required to use a -device tree to boot. To facilitate this in supported platforms, a command -in U-Boot environment **findfdt** is available that will set the **fdtfile** -variable to the name of the device tree to use, as found with the kernel -sources. In the Keystone-2 family devices (K2H/K/E/L/G), it is specified -by **name\_fdt** variable for each platform. The device tree is expected -to be loaded from the same media as the kernel, and from the same relative path. - -.. _AM64-SRAM-Layout-label: - -SRAM memory Layout during initial bootloader stage -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The SRAM memory layout explains the memory used for Bootloader's operation. - - .. ifconfig:: CONFIG_part_variant in ('AM64X') - - .. code-block:: text - - ┌──────────────────────────────────────┐0x70000000 - │ │ - │ │ - │ │ - │ SPL IMAGE (Max size 1.5 MB) │ - │ │ - │ │ - │ │ - ├──────────────────────────────────────┤0x7017FFFF - │ │ - │ SPL STACK │ - │ │ - ├──────────────────────────────────────┤0x70192727 - │ GLOBAL DATA(216 B) │ - ├──────────────────────────────────────┤0x701927FF - │ │ - │ INITIAL HEAP (32 KB) │ - │ │ - ├──────────────────────────────────────┤0x7019A7FF - │ │ - │ BSS (20 KB) │ - ├──────────────────────────────────────┤0x7019F7FF - │ EEPROM DATA (2 KB) │ - ├──────────────────────────────────────┤0x7019FFFF - │ │ - │ │ - │ UNALLOCATED AREA (123 KB) │ - │ │ - │ │ - ├──────────────────────────────────────┤0x701BEBFB - │ BOOT PARAMETER INDEX TABLE (5124 B)│ - ├──────────────────────────────────────┤0x701BFFFF - │ │ - │ TF-A (128 KB) │ - │ │ - ├──────────────────────────────────────┤0x701DFFFF - │ │ - │ DMSC CODE AREA (128 KB) │ - │ │ - └──────────────────────────────────────┘0x701FFFFF - - - In the last 128 KB of memory used by DMSC during run time, initial 80 KB - gets freed after a security handover happens. The last 48 KB still will be used by DMSC. - - For more details on Security handover see `here `__ . - - .. ifconfig:: CONFIG_part_variant in ('AM62X') - - .. code-block:: text - - ┌──────────────────────────────────────┐0x43c00000 - │ │ - │ │ - │ SPL IMAGE │ - │ (Max size 192 KB) │ - │ (excluding BSS) │ - │ (196608B Max) │ - │ │ - ├──────────────────────────────────────┤0x43c30000 - │ │ - │ │ - │ STACK (13568B Max) │ - │ │ - │ │ - ├──────────────────────────────────────┤ - │ Global Data (428B Max) │ - ├──────────────────────────────────────┤ - │ │ - │ HEAP (28KB Max) │ - │ │ - ├──────────────────────────────────────┤0x43c3a7f0 - │ │ - │ EMPTY (16B) │ - │ │ - ├──────────────────────────────────────┤0x43c3a800 - │ │ - │ │ - │ DM config data (2KB) │ - │ │ - │ │ - ├──────────────────────────────────────┤0x43c3b000 - │ │ - │ BSS (12KB) │ - │ │ - ├──────────────────────────────────────┤0x43c3e000 - │ │ - │ │ - │ EMPTY (4.5KB) │ - │ (Reserved for ROM) │ - │ │ - ├──────────────────────────────────────┤0x43c3f1e0 - │ │ - │ ROM Boot parameter table │ - │ + Extended boot info (3.5 KB) │ - │ │ - └──────────────────────────────────────┘0x43c3ffff - - .. ifconfig:: CONFIG_part_variant in ('AM62AX','AM62PX','AM62DX') - - .. code-block:: console - - ┌──────────────────────────────────────┐0x43c00000 - │ │ - │ │ - │ SPL IMAGE │ - │ (Max size 188 KB) │ - │ (excluding BSS) │ - │ (192512B Max) │ - │ │ - ├──────────────────────────────────────┤0x43c2f000 - │ │ - │ │ - │ STACK (17KB Max) │ - │ │ - │ │ - ├──────────────────────────────────────┤ - │ Global Data (428B Max) │ - ├──────────────────────────────────────┤ - │ │ - │ HEAP (28997B Max) │ - │ │ - ├──────────────────────────────────────┤0x43c3a7f0 - │ │ - │ EMPTY (16B) │ - │ │ - ├──────────────────────────────────────┤0x43c3a800 - │ │ - │ │ - │ DM config data (2KB) │ - │ │ - │ │ - ├──────────────────────────────────────┤0x43c3b000 - │ │ - │ BSS (12KB) │ - │ │ - ├──────────────────────────────────────┤0x43c3e000 - │ │ - │ │ - │ EMPTY (4.5KB) │ - │ (Reserved for ROM) │ - │ │ - ├──────────────────────────────────────┤0x43c3f1e0 - │ │ - │ ROM Boot parameter table │ - │ + Extended boot info (3.5 KB) │ - │ │ - └──────────────────────────────────────┘0x43c3ffff - - .. ifconfig:: CONFIG_part_variant in ('J722S') - - .. code-block:: console - - ┌──────────────────────────────────────┐0x43c00000 - │ │ - │ │ - │ SPL IMAGE │ - │ (excluding BSS) │ - │ (0x6ce00 B Max) │ - │ │ - ├──────────────────────────────────────┤0x43C6CE00 - │ EMPTY (0x50 B) │ - │ │ - ├──────────────────────────────────────┤0x43C6CE50 - │ │ - │ │ - │ STACK (0x5000 B Max) │ - │ │ - │ │ - ├──────────────────────────────────────┤0x43C71E50 - │ Global Data (0x1AC B Max) │ - │ (+0x4) │ - │ │ - ├──────────────────────────────────────┤0x43C72000 - │ │ - │ HEAP (0x9000 B Max) │ - | | - ├──────────────────────────────────────┤0x43C7B000 - │ │ - │ SPL BSS (0x3000 B) │ - │ │ - ├──────────────────────────────────────┤0x43C7E000 - │ │ - │ ROM Boot parameter table │ - │ + Extended boot info (3.5 KB) │ - │ │ - └──────────────────────────────────────┘0x43C7F290 - - - .. ifconfig:: CONFIG_part_variant in ('AM62LX') - - .. code-block:: text - - ┌────────────────────┐ 0x7081_8000 ┬ - │ Debug Buffers │ │ - ├────────────────────┤ 0x7081_6000 │ - │ TIFS -> A53 IPC │ │ - ├────────────────────┤ 0x7081_5000 │ - │ A53 -> TIFS IPC │ │ - ├────────────────────┤ 0x7081_4000 │ - │ │ │ - │ *Free Space* │ │ - │ │ │ - ├────────────────────┤ 0x7081_0000 ┬ │ - │ Translation Table │ │ │ - ├────────────────────┤ 0x7080_D000 │ │ - │ BSS │ │ │ MSRAM (96k) - ├────────────────────┤ 0x7080_B9C0 │ │ - │ Stack │ │ │ - ├────────────────────┤ 0x7080_B1C0 │ BL-1 │ - │ Data │ │ │ - ├────────────────────┤ 0x7080_B000 │ │ - │ RO-Data │ │ │ - ├────────────────────┤ 0x7080_6000 │ │ - │ Code │ │ │ - ├────────────────────┤ 0x7080_0000 ┘ ─┤ - │ │ │ - │ ROM Data │ │ PSRAM (64k) - │ │ │ - └────────────────────┘ 0x707F_0000 ┴ From 100ee1338c01f86d8e896898697fb45e1af8db15 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Tue, 11 Nov 2025 16:54:04 -0600 Subject: [PATCH 3/6] fix(linux): remove generic release notes Remove the generic release notes as these are incomplete and conflict with the device specific release notes by providing a blank release-specific-build-information label. Signed-off-by: Randolph Sapp --- configs/AM335X/AM335X_linux_toc.txt | 2 - configs/AM437X/AM437X_linux_toc.txt | 2 - configs/AM57X/AM57X_linux_toc.txt | 1 - configs/DRA821A/DRA821A_linux_toc.txt | 1 - configs/J7200/J7200_linux_toc.txt | 1 - ...ocessor_SDK_Linux_Kernel_Release_Notes.rst | 41 ------------------- ...ssor_SDK_Linux_RT_Kernel_Release_Notes.rst | 20 --------- .../linux/Foundational_Components_Kernel.rst | 2 - ...nal_Components_Kernel_RT_Release_Notes.rst | 2 - ...tional_Components_Kernel_Release_Notes.rst | 2 - 10 files changed, 74 deletions(-) delete mode 100644 source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_Kernel_Release_Notes.rst delete mode 100644 source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_RT_Kernel_Release_Notes.rst delete mode 100644 source/linux/Foundational_Components_Kernel_RT_Release_Notes.rst delete mode 100644 source/linux/Foundational_Components_Kernel_Release_Notes.rst diff --git a/configs/AM335X/AM335X_linux_toc.txt b/configs/AM335X/AM335X_linux_toc.txt index e5217f6d4..213c5472e 100644 --- a/configs/AM335X/AM335X_linux_toc.txt +++ b/configs/AM335X/AM335X_linux_toc.txt @@ -69,8 +69,6 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/UBIFS linux/Foundational_Components/Kernel/Kernel_Drivers/UFS linux/Foundational_Components/Kernel/Kernel_Drivers/USB/MUSB linux/Foundational_Components_Kernel_Users_Guide -linux/Foundational_Components_Kernel_Release_Notes -linux/Foundational_Components_Kernel_RT_Release_Notes linux/Foundational_Components_Kernel_LTP-DDT_Validation linux/Foundational_Components_Kernel_FAQs linux/Foundational_Components_Power_Management diff --git a/configs/AM437X/AM437X_linux_toc.txt b/configs/AM437X/AM437X_linux_toc.txt index 40a0810b1..f203aea8b 100644 --- a/configs/AM437X/AM437X_linux_toc.txt +++ b/configs/AM437X/AM437X_linux_toc.txt @@ -70,8 +70,6 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/UBIFS linux/Foundational_Components/Kernel/Kernel_Drivers/UFS linux/Foundational_Components/Kernel/Kernel_Drivers/USB/DWC3 linux/Foundational_Components_Kernel_Users_Guide -linux/Foundational_Components_Kernel_Release_Notes -linux/Foundational_Components_Kernel_RT_Release_Notes linux/Foundational_Components_Kernel_LTP-DDT_Validation linux/Foundational_Components_Kernel_FAQs linux/Foundational_Components_Power_Management diff --git a/configs/AM57X/AM57X_linux_toc.txt b/configs/AM57X/AM57X_linux_toc.txt index 650b450a1..f4518f8b5 100644 --- a/configs/AM57X/AM57X_linux_toc.txt +++ b/configs/AM57X/AM57X_linux_toc.txt @@ -80,7 +80,6 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/UBIFS linux/Foundational_Components/Kernel/Kernel_Drivers/USB/DWC3 linux/Foundational_Components/Kernel/Kernel_Drivers/VPE linux/Foundational_Components_Kernel_Users_Guide -linux/Foundational_Components_Kernel_Release_Notes linux/Foundational_Components_Kernel_LTP-DDT_Validation linux/Foundational_Components_Kernel_FAQs linux/Foundational_Components_Filesystem diff --git a/configs/DRA821A/DRA821A_linux_toc.txt b/configs/DRA821A/DRA821A_linux_toc.txt index ef8c7a2c2..3c7e81a4a 100644 --- a/configs/DRA821A/DRA821A_linux_toc.txt +++ b/configs/DRA821A/DRA821A_linux_toc.txt @@ -64,7 +64,6 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/UART linux/Foundational_Components/Kernel/Kernel_Drivers/UBIFS linux/Foundational_Components/Kernel/Kernel_Drivers/USB/CDNS3 linux/Foundational_Components_Kernel_Users_Guide -linux/Foundational_Components_Kernel_Release_Notes linux/Foundational_Components_Kernel_LTP-DDT_Validation linux/Foundational_Components_Kernel_FAQs linux/Foundational_Components_Filesystem diff --git a/configs/J7200/J7200_linux_toc.txt b/configs/J7200/J7200_linux_toc.txt index d1690f2e6..5ea85d6e3 100644 --- a/configs/J7200/J7200_linux_toc.txt +++ b/configs/J7200/J7200_linux_toc.txt @@ -79,7 +79,6 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/UBIFS linux/Foundational_Components/Kernel/Kernel_Drivers/USB/CDNS3 linux/Foundational_Components/Kernel/Kernel_Drivers/VTM linux/Foundational_Components_Kernel_Users_Guide -linux/Foundational_Components_Kernel_Release_Notes linux/Foundational_Components_Kernel_LTP-DDT_Validation linux/Foundational_Components_Kernel_FAQs linux/Foundational_Components_Filesystem diff --git a/source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_Kernel_Release_Notes.rst b/source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_Kernel_Release_Notes.rst deleted file mode 100644 index 9f73d110e..000000000 --- a/source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_Kernel_Release_Notes.rst +++ /dev/null @@ -1,41 +0,0 @@ -.. http://processors.wiki.ti.com/index.php/Processor_SDK_Linux_Kernel_Release_Notes - -Kernel Release Notes -====================== - -.. _release-specific-build-information: - -Build Information -------------------- - -.. ifconfig:: CONFIG_sdk in ('SITARA') - - Please refer to :ref:`release-specific-build-information-linux-kernel` section of the release notes for details. - -.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational') - - Please refer to Yocto build for details. - -Generic Kernel Release Notes ------------------------------- - -.. ifconfig:: CONFIG_sdk in ('SITARA') - - Please refer to :ref:`release-specific-generic-kernel-release-notes` for details. - -.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational') - - TODO - - -Known Issues --------------- - -.. ifconfig:: CONFIG_sdk in ('SITARA') - - Please refer to :ref:`release-specific-linux-kernel-known-issues` for details. - -.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational') - - TODO - diff --git a/source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_RT_Kernel_Release_Notes.rst b/source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_RT_Kernel_Release_Notes.rst deleted file mode 100644 index 4563bdb14..000000000 --- a/source/linux/Foundational_Components/Kernel/_Processor_SDK_Linux_RT_Kernel_Release_Notes.rst +++ /dev/null @@ -1,20 +0,0 @@ -.. http://processors.wiki.ti.com/index.php/Processor_SDK_Linux_RT_Kernel_Release_Notes - -RT Kernel Release Notes -======================== - -.. _release-specific-build-information: - -Build Information -------------------- -Please refer to the :ref:`release-specific-build-information-rt-linux-kernel` section of the release notes for details. - -Generic Kernel Release Notes ------------------------------- -Please refer to :ref:`release-specific-generic-kernel-release-notes` for details. - - -Known Issues --------------- -Please refer to :ref:`release-specific-rt-linux-kernel-known-issues` for details. - diff --git a/source/linux/Foundational_Components_Kernel.rst b/source/linux/Foundational_Components_Kernel.rst index 140dc96c9..4c36716ea 100644 --- a/source/linux/Foundational_Components_Kernel.rst +++ b/source/linux/Foundational_Components_Kernel.rst @@ -8,8 +8,6 @@ Kernel :maxdepth: 2 Foundational_Components_Kernel_Users_Guide - Foundational_Components_Kernel_Release_Notes - Foundational_Components_Kernel_RT_Release_Notes Foundational_Components_Kernel_Drivers Foundational_Components_Kernel_LTP-DDT_Validation Foundational_Components_Kernel_FAQs diff --git a/source/linux/Foundational_Components_Kernel_RT_Release_Notes.rst b/source/linux/Foundational_Components_Kernel_RT_Release_Notes.rst deleted file mode 100644 index 4dd99604f..000000000 --- a/source/linux/Foundational_Components_Kernel_RT_Release_Notes.rst +++ /dev/null @@ -1,2 +0,0 @@ -.. RT Kernel Release Notes -.. include:: Foundational_Components/Kernel/_Processor_SDK_Linux_RT_Kernel_Release_Notes.rst diff --git a/source/linux/Foundational_Components_Kernel_Release_Notes.rst b/source/linux/Foundational_Components_Kernel_Release_Notes.rst deleted file mode 100644 index a74c4f300..000000000 --- a/source/linux/Foundational_Components_Kernel_Release_Notes.rst +++ /dev/null @@ -1,2 +0,0 @@ -.. Kernel Release Notes -.. include:: Foundational_Components/Kernel/_Processor_SDK_Linux_Kernel_Release_Notes.rst From fc0613ea8b48dc30bac1a7eb68589a724384f26d Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Wed, 22 Oct 2025 15:14:32 -0500 Subject: [PATCH 4/6] fix(component-versions): standardize tag name Standardize the tag name for component versions listings to: release-specific-build-information This involves deprecating the partially used tag: release-specific-sdk-components-versions Signed-off-by: Randolph Sapp --- .../devices/AM335X/linux/Release_Specific_Migration_Guide.rst | 4 ++-- .../devices/AM335X/linux/Release_Specific_Release_Notes.rst | 2 -- .../devices/AM437X/linux/Release_Specific_Migration_Guide.rst | 4 ++-- .../devices/AM437X/linux/Release_Specific_Release_Notes.rst | 2 -- source/devices/AM57X/linux/Release_Specific_Release_Notes.rst | 3 --- .../devices/AM62DX/linux/Release_Specific_Release_Notes.rst | 1 + .../devices/AM62PX/android/Release_Specific_Release_Notes.rst | 2 ++ .../devices/AM62X/android/Release_Specific_Release_Notes.rst | 2 ++ .../devices/AM65X/linux/Release_Specific_Migration_Guide.rst | 4 ++-- source/devices/AM65X/linux/Release_Specific_Release_Notes.rst | 3 --- .../devices/AM67A/android/Release_Specific_Release_Notes.rst | 2 ++ .../devices/DRA821A/linux/Release_Specific_Release_Notes.rst | 2 +- 12 files changed, 14 insertions(+), 17 deletions(-) diff --git a/source/devices/AM335X/linux/Release_Specific_Migration_Guide.rst b/source/devices/AM335X/linux/Release_Specific_Migration_Guide.rst index 775b64fd5..46eb6bed6 100644 --- a/source/devices/AM335X/linux/Release_Specific_Migration_Guide.rst +++ b/source/devices/AM335X/linux/Release_Specific_Migration_Guide.rst @@ -18,7 +18,7 @@ Processor SDK 09.xx Releases Processor SDK 09.03.05.02 ------------------------- -- 2023 LTS Update release, with Kernel Stable Refresh. Please see :ref:`release-specific-sdk-components-versions`. +- 2023 LTS Update release, with Kernel Stable Refresh. Please see :ref:`release-specific-build-information`. - Kernel 6.1.119 - U-Boot 2023.04 - Yocto Kirkstone/4.0 @@ -27,7 +27,7 @@ Processor SDK 09.03.05.02 Processor SDK 09.01.00.001 -------------------------- -- 2023 LTS Update release, with new versions of Kernel and U-boot. Please see :ref:`release-specific-sdk-components-versions`. +- 2023 LTS Update release, with new versions of Kernel and U-boot. Please see :ref:`release-specific-build-information`. - Kernel 6.1.46 - U-Boot 2023.04 - Yocto Kirkstone/4.0 diff --git a/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst index 866da3082..ea43b30c7 100644 --- a/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst @@ -61,8 +61,6 @@ Processor SDK 9.3 Release has following new features: | -.. _release-specific-sdk-components-versions: - .. rubric:: SDK Components & Versions :name: sdk-components-versions diff --git a/source/devices/AM437X/linux/Release_Specific_Migration_Guide.rst b/source/devices/AM437X/linux/Release_Specific_Migration_Guide.rst index 5cb87837f..6cffab66a 100644 --- a/source/devices/AM437X/linux/Release_Specific_Migration_Guide.rst +++ b/source/devices/AM437X/linux/Release_Specific_Migration_Guide.rst @@ -18,7 +18,7 @@ Processor SDK 09.xx Releases Processor SDK 09.03.05.02 ------------------------- -- 2023 LTS Update release, with Kernel Stable Refresh. Please see :ref:`release-specific-sdk-components-versions`. +- 2023 LTS Update release, with Kernel Stable Refresh. Please see :ref:`release-specific-build-information`. - Kernel 6.1.119 - U-Boot 2023.04 - Yocto Kirkstone/4.0 @@ -26,7 +26,7 @@ Processor SDK 09.03.05.02 Processor SDK 09.01.00.001 -------------------------- -- 2023 LTS Update release, with new versions of Kernel and U-boot. Please see :ref:`release-specific-sdk-components-versions`. +- 2023 LTS Update release, with new versions of Kernel and U-boot. Please see :ref:`release-specific-build-information`. - Kernel 6.1.46 - U-Boot 2023.04 - Yocto Kirkstone/4.0 diff --git a/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst index 9b2404297..6c036cb72 100644 --- a/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst @@ -59,8 +59,6 @@ Processor SDK 9.3 Release has following new features: - 2023 LTS Stable Update to 6.1.119 - Important Bug Fixes -.. _release-specific-sdk-components-versions: - .. rubric:: SDK Components & Versions :name: sdk-components-versions diff --git a/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst index b971f5f36..254aade9d 100644 --- a/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst @@ -79,9 +79,6 @@ Processor SDK 11.01 Release has following new features: pdm-anomaly-detection are deprecated due to dependency on Matrix GUI/QT5 which is no longer supported with Scarthgap. - -.. _release-specific-sdk-components-versions: - .. rubric:: SDK Components & Versions :name: sdk-components-versions diff --git a/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst b/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst index 87fe529d9..b8df09c03 100644 --- a/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst @@ -61,6 +61,7 @@ What's included - DM Firmware 11.01.00.05 - Yocto scarthgap 5.0 +.. _release-specific-build-information: Build Information ================= diff --git a/source/devices/AM62PX/android/Release_Specific_Release_Notes.rst b/source/devices/AM62PX/android/Release_Specific_Release_Notes.rst index 6c174d0b0..e718723c0 100644 --- a/source/devices/AM62PX/android/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62PX/android/Release_Specific_Release_Notes.rst @@ -56,6 +56,8 @@ Following features are enabled/tested in this release for AM62Px Android: * **Display:** Support for LVDS panel and dual display (mirroring and extended) * **Display:** Support for the RPI 7Inch touchscreen DSI panel. +.. _release-specific-build-information: + SDK Components and Versions =========================== diff --git a/source/devices/AM62X/android/Release_Specific_Release_Notes.rst b/source/devices/AM62X/android/Release_Specific_Release_Notes.rst index 832a24be5..cef6f571d 100644 --- a/source/devices/AM62X/android/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62X/android/Release_Specific_Release_Notes.rst @@ -55,6 +55,8 @@ Following features are enabled/tested in this release for AM62x Android: * **Android Baseport:** Support of Generic System Image * **Display:** Support for LVDS panel and dual display (mirroring and extended) +.. _release-specific-build-information: + SDK Components and Versions =========================== diff --git a/source/devices/AM65X/linux/Release_Specific_Migration_Guide.rst b/source/devices/AM65X/linux/Release_Specific_Migration_Guide.rst index 8132c9d24..5bcf8a871 100644 --- a/source/devices/AM65X/linux/Release_Specific_Migration_Guide.rst +++ b/source/devices/AM65X/linux/Release_Specific_Migration_Guide.rst @@ -18,7 +18,7 @@ Processor SDK 09.xx Releases Processor SDK 09.03.05.02 ------------------------- -- 2023 LTS Update release, with Kernel Stable Refresh. Please see :ref:`release-specific-sdk-components-versions`. +- 2023 LTS Update release, with Kernel Stable Refresh. Please see :ref:`release-specific-build-information`. - Kernel 6.1.119 - U-Boot 2023.04 - Yocto Kirkstone/4.0 @@ -26,7 +26,7 @@ Processor SDK 09.03.05.02 Processor SDK 09.01.00.007 -------------------------- -- 2023 LTS Update release, with new versions of Kernel and U-boot. Please see :ref:`release-specific-sdk-components-versions`. +- 2023 LTS Update release, with new versions of Kernel and U-boot. Please see :ref:`release-specific-build-information`. - Kernel 6.1.46 - U-Boot 2023.04 - Yocto Kirkstone/4.0 diff --git a/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst index edd6e4bd8..dba5d7e54 100644 --- a/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst @@ -75,9 +75,6 @@ Supported Platforms =================== See :ref:`here ` for a list of supported platforms and links to more information. - -.. _release-specific-sdk-components-versions: - .. _release-specific-build-information: Build Information diff --git a/source/devices/AM67A/android/Release_Specific_Release_Notes.rst b/source/devices/AM67A/android/Release_Specific_Release_Notes.rst index 9bbb35c93..926319a8b 100644 --- a/source/devices/AM67A/android/Release_Specific_Release_Notes.rst +++ b/source/devices/AM67A/android/Release_Specific_Release_Notes.rst @@ -56,6 +56,8 @@ Following features are enabled/tested in this release for AM67A Android: * **Display:** Support for LVDS panel and dual display (mirroring and extended) * **Display:** Support for the RPI 7Inch touchscreen DSI panel. +.. _release-specific-build-information: + SDK Components and Versions =========================== diff --git a/source/devices/DRA821A/linux/Release_Specific_Release_Notes.rst b/source/devices/DRA821A/linux/Release_Specific_Release_Notes.rst index c987c6f63..482a7ddcf 100644 --- a/source/devices/DRA821A/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/DRA821A/linux/Release_Specific_Release_Notes.rst @@ -98,7 +98,7 @@ Release features - A72 PMU support for Performance profiling -.. _release-specific-sdk-components-versions: +.. _release-specific-build-information: Component versions ------------------ From a54ced317ff3f820cb5b90899807127612456569 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Wed, 22 Oct 2025 16:23:35 -0500 Subject: [PATCH 5/6] fix(release-notes): use release-specific-build-information Use the common release-specific-build-information tag instead of the component specific tags. This data was always somewhat tabular but was split over several sections with different formatting depending on the platform. We are now looking to merge this under a single table like what was done with AM62LX. This initial merge made some links inaccessible for some platforms. This attempts to go back and enforce a common tag name to make sure we are always linking the user to at least a close section while the transition occurs. Signed-off-by: Randolph Sapp --- .../linux/Release_Specific_Release_Notes.rst | 2 -- .../linux/Release_Specific_Release_Notes.rst | 2 -- .../linux/Release_Specific_Release_Notes.rst | 2 -- .../linux/Release_Specific_Release_Notes.rst | 8 -------- .../linux/Release_Specific_Release_Notes.rst | 8 -------- .../linux/Release_Specific_Release_Notes.rst | 8 -------- .../linux/Release_Specific_Release_Notes.rst | 8 -------- .../linux/Release_Specific_Release_Notes.rst | 8 -------- .../linux/Release_Specific_Release_Notes.rst | 8 -------- .../U-Boot/BG-Setup-K3.rst | 18 ++---------------- .../U-Boot/BG-Setup-OMAP.rst | 2 +- source/linux/Foundational_Components_ATF.rst | 2 +- source/linux/Foundational_Components_OPTEE.rst | 2 +- .../linux/How_to_Guides/Host/Boot_Sequence.rst | 2 +- source/linux/Overview/GCC_ToolChain.rst | 2 +- 15 files changed, 7 insertions(+), 75 deletions(-) diff --git a/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst index ea43b30c7..522e0c713 100644 --- a/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst @@ -89,8 +89,6 @@ See :ref:`here ` for a list o Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ diff --git a/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst index 6c036cb72..c76da0cde 100644 --- a/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst @@ -87,8 +87,6 @@ See :ref:`here ` for a list o Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ diff --git a/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst index 254aade9d..94dc6e3c6 100644 --- a/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM57X/linux/Release_Specific_Release_Notes.rst @@ -113,8 +113,6 @@ See `here <../../../linux/Release_Specific_Supported_Platforms_and_Versions.html Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ diff --git a/source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst b/source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst index 519f54912..37b7607db 100644 --- a/source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst @@ -92,8 +92,6 @@ What's new Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ @@ -105,8 +103,6 @@ U-Boot | uBoot Tag: 11.01.07 | -.. _tf-a-release-notes: - TF-A ---- | Head Commit: e0c4d3903b382bf34f552af53e6d955fae5283ab Merge changes from topic "xlnx_fix_gen_con_datatype" into integration @@ -115,8 +111,6 @@ TF-A | Tag: (2.13 based) | -.. _optee-release-notes: - OP-TEE ------ | Head Commit: 71785645fa6ce42db40dbf5a54e0eaedc4f61591 Update CHANGELOG for 4.6.0 @@ -125,8 +119,6 @@ OP-TEE | Tag: 4.6.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- | Head Commit: f59a711599249ecac75fea38b7a15ef9137d650d Merge branch 'main' of git://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware into ti-linux-firmware-next diff --git a/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst b/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst index b8df09c03..a022b099c 100644 --- a/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst @@ -66,8 +66,6 @@ What's included Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ @@ -79,8 +77,6 @@ U-Boot | uBoot Tag: 11.01.05 | -.. _tf-a-release-notes: - TF-A ---- | Head Commit: e0c4d3903b382bf34f552af53e6d955fae5283ab Merge changes from topic "xlnx_fix_gen_con_datatype" into integration @@ -89,8 +85,6 @@ TF-A | Tag: (2.13 based) | -.. _optee-release-notes: - OP-TEE ------ | Head Commit: 71785645fa6ce42db40dbf5a54e0eaedc4f61591 Update CHANGELOG for 4.6.0 @@ -99,8 +93,6 @@ OP-TEE | Tag: 4.6.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- | Head Commit: 33bec0e2ea9a25362c0c8243b2f1ed392dbc5b02 Merge branch 'main' of git://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware into ti-linux-firmware-next diff --git a/source/devices/AM62X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM62X/linux/Release_Specific_Release_Notes.rst index fab6f4eef..4d383e622 100644 --- a/source/devices/AM62X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62X/linux/Release_Specific_Release_Notes.rst @@ -80,8 +80,6 @@ Build Information Arago (Yocto/OE) ---------------- -.. _u-boot-release-notes: - U-Boot ------ @@ -93,8 +91,6 @@ U-Boot | uBoot Tag: 11.01.05 | -.. _tf-a-release-notes: - TF-A ---- | Head Commit: e0c4d3903b382bf34f552af53e6d955fae5283ab Merge changes from topic "xlnx_fix_gen_con_datatype" into integration @@ -103,8 +99,6 @@ TF-A | Tag: (2.13 based) | -.. _optee-release-notes: - OP-TEE ------ | Head Commit: 71785645fa6ce42db40dbf5a54e0eaedc4f61591 Update CHANGELOG for 4.6.0 @@ -113,8 +107,6 @@ OP-TEE | Tag: 4.6.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- | Head Commit: 33bec0e2ea9a25362c0c8243b2f1ed392dbc5b02 Merge branch 'main' of git://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware into ti-linux-firmware-next diff --git a/source/devices/AM64X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM64X/linux/Release_Specific_Release_Notes.rst index e20721d4e..8943965e4 100644 --- a/source/devices/AM64X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM64X/linux/Release_Specific_Release_Notes.rst @@ -74,8 +74,6 @@ What's new Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ @@ -90,8 +88,6 @@ U-Boot | uBoot Tag: 11.01.05 | -.. _tf-a-release-notes: - TF-A ---- | Head Commit: e0c4d3903b382bf34f552af53e6d955fae5283ab Merge changes from topic "xlnx_fix_gen_con_datatype" into integration @@ -100,8 +96,6 @@ TF-A | Tag: (2.13 based) | -.. _optee-release-notes: - OP-TEE ------ | Head Commit: 71785645fa6ce42db40dbf5a54e0eaedc4f61591 Update CHANGELOG for 4.6.0 @@ -110,8 +104,6 @@ OP-TEE | Tag: 4.6.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- | Head Commit: 33bec0e2ea9a25362c0c8243b2f1ed392dbc5b02 Merge branch 'main' of git://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware into ti-linux-firmware-next diff --git a/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst index dba5d7e54..e04141474 100644 --- a/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst @@ -80,8 +80,6 @@ See :ref:`here ` for a list o Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ @@ -92,8 +90,6 @@ U-Boot | uBoot Tag: 09.03.05 | -.. _tf-a-release-notes: - TF-A ---- @@ -103,8 +99,6 @@ TF-A | Tag: 2.10+ | -.. _optee-release-notes: - OP-TEE ------ @@ -114,8 +108,6 @@ OP-TEE | Tag: 4.1.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- diff --git a/source/devices/J7_Family/linux/Release_Specific_Release_Notes.rst b/source/devices/J7_Family/linux/Release_Specific_Release_Notes.rst index 0114664ac..a320e346b 100644 --- a/source/devices/J7_Family/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/J7_Family/linux/Release_Specific_Release_Notes.rst @@ -90,8 +90,6 @@ Processor SDK 11.01 Release has following new features: Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ | Head Commit: 743712b9ee4b33cc9739a3cbeb5a8f14ae2ccf35: TI: dts: arm64: ti: sync dtbs from ti-linux-6.12.y upto ce4785d01a0b @@ -140,8 +138,6 @@ Kernel meta-edgeai Yocto layer contains additional patches for Kernel `here `__. -.. _tf-a-release-notes: - TF-A ---- | Head Commit: e0c4d3903b382bf34f552af53e6d955fae5283ab: Merge changes from topic "xlnx_fix_gen_con_datatype" into integration @@ -152,8 +148,6 @@ TF-A | Branch: master | -.. _optee-release-notes: - OP-TEE ------ | Head Commit: 71785645fa6ce42db40dbf5a54e0eaedc4f61591: Update CHANGELOG for 4.6.0 @@ -165,8 +159,6 @@ OP-TEE | Tag: 4.6.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- | Head Commit: e89a348f4618a26812fb353a04ed9532ef890a2f: Merge branch 'main' of git://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware into ti-linux-firmware-next diff --git a/source/linux/Foundational_Components/U-Boot/BG-Setup-K3.rst b/source/linux/Foundational_Components/U-Boot/BG-Setup-K3.rst index e58fcc9d8..524962de4 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Setup-K3.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Setup-K3.rst @@ -46,19 +46,5 @@ the source code is in the SDK at the path :file:`/board-support`. For your convenience the sources also includes git repositories including commit history. -.. ifconfig:: CONFIG_part_variant in ('AM62LX') - - Alternatively, BL-1 and U-Boot sources can directly be fetched from GIT. The GIT - repo URL, branch and commit id can be found in the release notes: - - - ti-u-boot , OPTEE, TF-A and ti-linux-firmware version is at :ref:`release-specific-build-information` - -.. ifconfig:: CONFIG_part_variant not in ('AM62LX') - - Alternatively, U-Boot sources can directly be fetched from GIT. The GIT - repo URL, branch and commit id can be found in the release notes: - - - ti-u-boot version: :ref:`u-boot-release-notes` - - ti-linux-firmware version: :ref:`ti-linux-fw-release-notes` - - TF-A version: :ref:`tf-a-release-notes` - - OP-TEE version: :ref:`optee-release-notes` +U-Boot sources can also be directly fetched from GIT. The GIT repository URL, +branch and commit id is available in :ref:`release-specific-build-information`. diff --git a/source/linux/Foundational_Components/U-Boot/BG-Setup-OMAP.rst b/source/linux/Foundational_Components/U-Boot/BG-Setup-OMAP.rst index bffb5b783..ab4e499af 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Setup-OMAP.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Setup-OMAP.rst @@ -44,6 +44,6 @@ git repositories including commit history. Alternatively, U-Boot sources can directly be fetched from GIT. The GIT repo URL, branch and commit id can be found in the release notes: -- ti-u-boot version: :ref:`u-boot-release-notes` +- ti-u-boot version: :ref:`release-specific-build-information` diff --git a/source/linux/Foundational_Components_ATF.rst b/source/linux/Foundational_Components_ATF.rst index 12a27cd14..e523553a4 100644 --- a/source/linux/Foundational_Components_ATF.rst +++ b/source/linux/Foundational_Components_ATF.rst @@ -86,7 +86,7 @@ If it is not possible to use a pre-built binary, use the following: $ git clone https://review.trustedfirmware.org/TF-A/trusted-firmware-a.git $ git checkout -Where is the commit shown here: :ref:`tf-a-release-notes` :ref:`release-specific-build-information`. +Where is the commit shown in :ref:`release-specific-build-information`. | diff --git a/source/linux/Foundational_Components_OPTEE.rst b/source/linux/Foundational_Components_OPTEE.rst index 91c50bb74..3a0a155a9 100644 --- a/source/linux/Foundational_Components_OPTEE.rst +++ b/source/linux/Foundational_Components_OPTEE.rst @@ -27,7 +27,7 @@ If it is not possible to use pre-build binary, use the following: $ git clone https://github.com/OP-TEE/optee_os.git $ git checkout -Where is the OPTEE commit shown here: :ref:`optee-release-notes`. +Where is the OPTEE commit shown in :ref:`release-specific-build-information`. | diff --git a/source/linux/How_to_Guides/Host/Boot_Sequence.rst b/source/linux/How_to_Guides/Host/Boot_Sequence.rst index ec0f4338d..b858dcd6d 100644 --- a/source/linux/How_to_Guides/Host/Boot_Sequence.rst +++ b/source/linux/How_to_Guides/Host/Boot_Sequence.rst @@ -7,7 +7,7 @@ Boot Sequence The J721E boot sequence is shown in the U-boot documentation file for J721E (doc/board/ti/j721e_evm.rst). Please refer back to the particular U-boot component branch and version information for this release: - :ref:`u-boot-release-notes` + :ref:`release-specific-build-information` .. ifconfig:: CONFIG_part_family in ('AM57X_family') diff --git a/source/linux/Overview/GCC_ToolChain.rst b/source/linux/Overview/GCC_ToolChain.rst index 9d3e1acf6..cd64f1d65 100644 --- a/source/linux/Overview/GCC_ToolChain.rst +++ b/source/linux/Overview/GCC_ToolChain.rst @@ -312,7 +312,7 @@ follows. .. rubric:: Arm Toolchain setup Download the toolchain from `here `__, -and the version can be found in the :ref:`release notes `. +and the version can be found in the :ref:`release notes `. The following example shows how to download and set toolchain paths into a ```` directory in Linux Host using x86_64 architecture. The environment variables defined here will be referenced in the build From 087726c1a1b28631f3d17d83dccdb07119bce5c3 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Wed, 22 Oct 2025 16:35:03 -0500 Subject: [PATCH 6/6] fix(BG-Build-OMAP): remove unnecessary backslash Left in from the previous refactor, these are not needed when encapsulated by an inline-code wrapper. Fixes: 68145409 ("refactor(U-Boot): Split K3 and OMAP Build Guide") Signed-off-by: Randolph Sapp --- .../linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst b/source/linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst index 4e404c0bb..9c7ce7cb5 100644 --- a/source/linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst +++ b/source/linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst @@ -43,7 +43,7 @@ If you did not use a separate object directory: .. ifconfig:: CONFIG_part_variant in ('AM335X') - If you used ``O=am335x\_evm`` as your object directory: + If you used ``O=am335x_evm`` as your object directory: .. code-block:: console @@ -51,7 +51,7 @@ If you did not use a separate object directory: .. ifconfig:: CONFIG_part_variant in ('AM437X') - If you used ``O=am43xx\_evm`` as your object directory: + If you used ``O=am43xx_evm`` as your object directory: .. code-block:: console @@ -59,7 +59,7 @@ If you did not use a separate object directory: .. ifconfig:: CONFIG_part_variant in ('AM57X') - If you used ``O=am57xx\_evm`` as your object directory: + If you used ``O=am57xx_evm`` as your object directory: .. code-block:: console