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/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..3c7e81a4a 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 @@ -58,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 a4f35d174..5ea85d6e3 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 @@ -73,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/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/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..522e0c713 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 @@ -91,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_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..c76da0cde 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 @@ -89,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 b971f5f36..94dc6e3c6 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 @@ -116,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 87fe529d9..a022b099c 100644 --- a/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM62DX/linux/Release_Specific_Release_Notes.rst @@ -61,12 +61,11 @@ What's included - DM Firmware 11.01.00.05 - Yocto scarthgap 5.0 +.. _release-specific-build-information: Build Information ================= -.. _u-boot-release-notes: - U-Boot ------ @@ -78,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 @@ -88,8 +85,6 @@ TF-A | Tag: (2.13 based) | -.. _optee-release-notes: - OP-TEE ------ | Head Commit: 71785645fa6ce42db40dbf5a54e0eaedc4f61591 Update CHANGELOG for 4.6.0 @@ -98,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/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/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_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..e04141474 100644 --- a/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst +++ b/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst @@ -75,16 +75,11 @@ 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 ================= -.. _u-boot-release-notes: - U-Boot ------ @@ -95,8 +90,6 @@ U-Boot | uBoot Tag: 09.03.05 | -.. _tf-a-release-notes: - TF-A ---- @@ -106,8 +99,6 @@ TF-A | Tag: 2.10+ | -.. _optee-release-notes: - OP-TEE ------ @@ -117,8 +108,6 @@ OP-TEE | Tag: 4.1.0 | -.. _ti-linux-fw-release-notes: - ti-linux-firmware ----------------- 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 ------------------ 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/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/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 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 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/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 ┴ 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_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 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