From 011c092676f156e6b07c4bc12890edd5759550e0 Mon Sep 17 00:00:00 2001 From: Bryan Brattlof Date: Mon, 15 Dec 2025 17:05:10 -0600 Subject: [PATCH 1/2] feat(fix): ensure files end with a newline Simple invisible character fixes Signed-off-by: Bryan Brattlof --- configs/J721S2/J721S2_linux_toc.txt | 2 +- configs/J742S2/J742S2_linux_toc.txt | 2 +- configs/J784S4/J784S4_linux_toc.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/configs/J721S2/J721S2_linux_toc.txt b/configs/J721S2/J721S2_linux_toc.txt index 2c7c861ce..3e158a08f 100644 --- a/configs/J721S2/J721S2_linux_toc.txt +++ b/configs/J721S2/J721S2_linux_toc.txt @@ -145,4 +145,4 @@ linux/How_to_Guides/Target/How_To_Carve_Out_CMA linux/Documentation_Tarball -linux/Demo_User_Guides/Chromium_Browser \ No newline at end of file +linux/Demo_User_Guides/Chromium_Browser diff --git a/configs/J742S2/J742S2_linux_toc.txt b/configs/J742S2/J742S2_linux_toc.txt index b0833faf0..f22ca8ec7 100644 --- a/configs/J742S2/J742S2_linux_toc.txt +++ b/configs/J742S2/J742S2_linux_toc.txt @@ -142,4 +142,4 @@ linux/How_to_Guides/Hardware_Setup_with_CCS/J742S2_EVM_Hardware_Setup linux/How_to_Guides/Target/How_To_Carve_Out_CMA linux/Documentation_Tarball -linux/Demo_User_Guides/Chromium_Browser \ No newline at end of file +linux/Demo_User_Guides/Chromium_Browser diff --git a/configs/J784S4/J784S4_linux_toc.txt b/configs/J784S4/J784S4_linux_toc.txt index b7f9d4bc2..506f30cdf 100644 --- a/configs/J784S4/J784S4_linux_toc.txt +++ b/configs/J784S4/J784S4_linux_toc.txt @@ -147,4 +147,4 @@ linux/How_to_Guides/FAQ/How_to_run_BIST_on_a_core linux/How_to_Guides/Target/How_To_Carve_Out_CMA linux/Documentation_Tarball -linux/Demo_User_Guides/Chromium_Browser \ No newline at end of file +linux/Demo_User_Guides/Chromium_Browser From 60ec232a4bc819e27323ac13149c22f0bd026d33 Mon Sep 17 00:00:00 2001 From: Bryan Brattlof Date: Mon, 15 Dec 2025 17:04:01 -0600 Subject: [PATCH 2/2] feat(U-Boot): add QoS configuration section Add basic documentation on how the CBASS QoS blocks function and how Sysconfig can be used to generate the files for U-Boot to apply during the SoC's bootup phase. Co-authored-by: Randolph Sapp Signed-off-by: Bryan Brattlof --- configs/AM62AX/AM62AX_linux_toc.txt | 1 + configs/AM62DX/AM62DX_linux_toc.txt | 1 + configs/AM62LX/AM62LX_linux_toc.txt | 1 + configs/AM62PX/AM62PX_linux_toc.txt | 1 + configs/AM62X/AM62X_linux_toc.txt | 1 + configs/AM64X/AM64X_linux_toc.txt | 1 + configs/AM67/AM67_linux_toc.txt | 1 + configs/AM67A/AM67A_linux_toc.txt | 1 + configs/AM68/AM68_linux_toc.txt | 1 + configs/AM68A/AM68A_linux_toc.txt | 1 + configs/AM69/AM69_linux_toc.txt | 1 + configs/AM69A/AM69A_linux_toc.txt | 1 + configs/J7200/J7200_linux_toc.txt | 1 + configs/J721E/J721E_linux_toc.txt | 1 + configs/J721S2/J721S2_linux_toc.txt | 1 + configs/J722S/J722S_linux_toc.txt | 1 + configs/J742S2/J742S2_linux_toc.txt | 1 + configs/J784S4/J784S4_linux_toc.txt | 1 + configs/TDA4VM/TDA4VM_linux_toc.txt | 1 + .../Foundational_Components/U-Boot/UG-QoS.rst | 47 +++++++++++++++++++ .../U-Boot/Users-Guide.rst | 1 + 21 files changed, 67 insertions(+) create mode 100644 source/linux/Foundational_Components/U-Boot/UG-QoS.rst diff --git a/configs/AM62AX/AM62AX_linux_toc.txt b/configs/AM62AX/AM62AX_linux_toc.txt index aa0758c15..955e66f74 100644 --- a/configs/AM62AX/AM62AX_linux_toc.txt +++ b/configs/AM62AX/AM62AX_linux_toc.txt @@ -44,6 +44,7 @@ linux/Foundational_Components/U-Boot/UG-DDRSS #linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-Falcon-Mode +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD diff --git a/configs/AM62DX/AM62DX_linux_toc.txt b/configs/AM62DX/AM62DX_linux_toc.txt index bb74d5058..d10f65bda 100644 --- a/configs/AM62DX/AM62DX_linux_toc.txt +++ b/configs/AM62DX/AM62DX_linux_toc.txt @@ -35,6 +35,7 @@ linux/Foundational_Components/U-Boot/UG-DFU linux/Foundational_Components/U-Boot/UG-Memory-K3 linux/Foundational_Components/U-Boot/UG-QSPI linux/Foundational_Components/U-Boot/UG-UART +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD diff --git a/configs/AM62LX/AM62LX_linux_toc.txt b/configs/AM62LX/AM62LX_linux_toc.txt index 57531fed6..2d431328d 100644 --- a/configs/AM62LX/AM62LX_linux_toc.txt +++ b/configs/AM62LX/AM62LX_linux_toc.txt @@ -39,6 +39,7 @@ linux/Foundational_Components/U-Boot/UG-QSPI linux/Foundational_Components/U-Boot/UG-UART linux/Foundational_Components/U-Boot/UG-Key-Writer-Lite linux/Foundational_Components/U-Boot/UG-Programming-OTPs +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD diff --git a/configs/AM62PX/AM62PX_linux_toc.txt b/configs/AM62PX/AM62PX_linux_toc.txt index c981ffd93..dbee9c869 100644 --- a/configs/AM62PX/AM62PX_linux_toc.txt +++ b/configs/AM62PX/AM62PX_linux_toc.txt @@ -44,6 +44,7 @@ linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-Splash-Screen linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-Falcon-Mode +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD diff --git a/configs/AM62X/AM62X_linux_toc.txt b/configs/AM62X/AM62X_linux_toc.txt index 015846561..07928a29e 100644 --- a/configs/AM62X/AM62X_linux_toc.txt +++ b/configs/AM62X/AM62X_linux_toc.txt @@ -43,6 +43,7 @@ linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-Splash-Screen linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-Falcon-Mode +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD diff --git a/configs/AM64X/AM64X_linux_toc.txt b/configs/AM64X/AM64X_linux_toc.txt index 162546a25..e58e12b51 100644 --- a/configs/AM64X/AM64X_linux_toc.txt +++ b/configs/AM64X/AM64X_linux_toc.txt @@ -41,6 +41,7 @@ linux/Foundational_Components/U-Boot/UG-NAND linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-PCIeBoot +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-TroubleShooting diff --git a/configs/AM67/AM67_linux_toc.txt b/configs/AM67/AM67_linux_toc.txt index dc4a64e7b..538fbabcb 100644 --- a/configs/AM67/AM67_linux_toc.txt +++ b/configs/AM67/AM67_linux_toc.txt @@ -37,6 +37,7 @@ linux/Foundational_Components/U-Boot/UG-SATA linux/Foundational_Components/U-Boot/UG-DDR3 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/AM67A/AM67A_linux_toc.txt b/configs/AM67A/AM67A_linux_toc.txt index 532edf609..36aea2d6f 100644 --- a/configs/AM67A/AM67A_linux_toc.txt +++ b/configs/AM67A/AM67A_linux_toc.txt @@ -42,6 +42,7 @@ linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS linux/Foundational_Components/U-Boot/Apps-TroubleShooting +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components_Kernel linux/Foundational_Components_Kernel_Drivers linux/Foundational_Components/Kernel/Kernel_Drivers/ADC diff --git a/configs/AM68/AM68_linux_toc.txt b/configs/AM68/AM68_linux_toc.txt index f95e2c7f7..fcbb08bb7 100644 --- a/configs/AM68/AM68_linux_toc.txt +++ b/configs/AM68/AM68_linux_toc.txt @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-HSM +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/AM68A/AM68A_linux_toc.txt b/configs/AM68A/AM68A_linux_toc.txt index 60906f833..132c70c4b 100644 --- a/configs/AM68A/AM68A_linux_toc.txt +++ b/configs/AM68A/AM68A_linux_toc.txt @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-DDRSS-J7 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-HSM +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/AM69/AM69_linux_toc.txt b/configs/AM69/AM69_linux_toc.txt index 0b3cc49ae..8a026af92 100644 --- a/configs/AM69/AM69_linux_toc.txt +++ b/configs/AM69/AM69_linux_toc.txt @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-HSM +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/AM69A/AM69A_linux_toc.txt b/configs/AM69A/AM69A_linux_toc.txt index ffacdd493..e45d703dd 100644 --- a/configs/AM69A/AM69A_linux_toc.txt +++ b/configs/AM69A/AM69A_linux_toc.txt @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-DDRSS-J7 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-HSM +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/J7200/J7200_linux_toc.txt b/configs/J7200/J7200_linux_toc.txt index 5b8f2863b..c033adf9c 100644 --- a/configs/J7200/J7200_linux_toc.txt +++ b/configs/J7200/J7200_linux_toc.txt @@ -42,6 +42,7 @@ linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-AVS linux/Foundational_Components/U-Boot/UG-Thermal +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/J721E/J721E_linux_toc.txt b/configs/J721E/J721E_linux_toc.txt index 039c31493..0c8e8255b 100644 --- a/configs/J721E/J721E_linux_toc.txt +++ b/configs/J721E/J721E_linux_toc.txt @@ -46,6 +46,7 @@ linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS linux/Foundational_Components/U-Boot/Apps-TroubleShooting +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components_Kernel linux/Foundational_Components_Kernel_Drivers linux/Foundational_Components/Kernel/Kernel_Drivers/ADC diff --git a/configs/J721S2/J721S2_linux_toc.txt b/configs/J721S2/J721S2_linux_toc.txt index 3e158a08f..599f822ac 100644 --- a/configs/J721S2/J721S2_linux_toc.txt +++ b/configs/J721S2/J721S2_linux_toc.txt @@ -42,6 +42,7 @@ linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-HSM linux/Foundational_Components/U-Boot/UG-AVS +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/J722S/J722S_linux_toc.txt b/configs/J722S/J722S_linux_toc.txt index 45115a6aa..c7639b3a3 100644 --- a/configs/J722S/J722S_linux_toc.txt +++ b/configs/J722S/J722S_linux_toc.txt @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-DDRSS-J7 linux/Foundational_Components/U-Boot/UG-Network-K3 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/J742S2/J742S2_linux_toc.txt b/configs/J742S2/J742S2_linux_toc.txt index f22ca8ec7..e6536b7cf 100644 --- a/configs/J742S2/J742S2_linux_toc.txt +++ b/configs/J742S2/J742S2_linux_toc.txt @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-UFS linux/Foundational_Components/U-Boot/UG-DDRSS-J7 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/J784S4/J784S4_linux_toc.txt b/configs/J784S4/J784S4_linux_toc.txt index 506f30cdf..7a3b6935a 100644 --- a/configs/J784S4/J784S4_linux_toc.txt +++ b/configs/J784S4/J784S4_linux_toc.txt @@ -41,6 +41,7 @@ linux/Foundational_Components/U-Boot/UG-DDRSS-J7 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-HSM +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/configs/TDA4VM/TDA4VM_linux_toc.txt b/configs/TDA4VM/TDA4VM_linux_toc.txt index b5cbde937..492a79d13 100644 --- a/configs/TDA4VM/TDA4VM_linux_toc.txt +++ b/configs/TDA4VM/TDA4VM_linux_toc.txt @@ -41,6 +41,7 @@ linux/Foundational_Components/U-Boot/UG-DDR3 linux/Foundational_Components/U-Boot/UG-HyperBus linux/Foundational_Components/U-Boot/UG-RemoteProc linux/Foundational_Components/U-Boot/UG-AVS +linux/Foundational_Components/U-Boot/UG-QoS linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS diff --git a/source/linux/Foundational_Components/U-Boot/UG-QoS.rst b/source/linux/Foundational_Components/U-Boot/UG-QoS.rst new file mode 100644 index 000000000..254721eee --- /dev/null +++ b/source/linux/Foundational_Components/U-Boot/UG-QoS.rst @@ -0,0 +1,47 @@ +Quality of Service (QoS) +######################## + +The Common Bus Architecture (CBASS) module includes Quality of Service +(QoS) blocks. These can change attributes such as the priority, Address +Selection (ASEL), and Order ID (orderID) values of the transactions +created by blocks in the System on a Chip (SoC) to route and prioritize +the traffic on the bus in a particular way. + +For example changing the Order ID can route traffic through a particular port +when more than port exists for that block on the bus. Most External +Memory Interface (EMIF) controllers for K3 SoCs will have two ports to +the CBASS so setting an Order ID value of 8 to 15 will route traffic +through the high priority port and serviced by the EMIF before standard +traffic. Setting an Order ID of 8 or higher for the display subsystem +will allow its traffic to use the EMIF's high priority port, helping to +minimize stuttering or jitter on the display. + +Consult the Technical Reference Manual (TRM) for you processor for more +information about these QoS settings. + +Modifying QoS Defaults +====================== + +By default, the majority of transactions will default to the lowest +priority level (ASEL is 0 and Order ID is 0). During boot-up `U-Boot can +change`_ the QoS settings for your board early on during boot-up using +the data generated from the Sysconfig Tool which you can download or +launch online `here`_. + +.. _U-Boot can change: https://source.denx.de/u-boot/u-boot/-/blob/v2025.10/arch/arm/mach-k3/am62px/am62p5_init.c?ref_type=tags#L253 +.. _here: https://www.ti.com/tool/SYSCONFIG + +The MCU+ SDK documentation has `an excellent guide`_ on how to to use the +Sysconfig Tool to generate the needed configuration file. Once generated, copy +the file into the :file:`arch/arm/mach-k3/r5/${SOC}/${SOC}_qos_uboot.c` and +rebuild U-Boot to apply your changes. + +.. _an excellent guide: https://software-dl.ti.com/mcu-plus-sdk/esd/AM62X/latest/exports/docs/api_guide_am62x/DRIVERS_QOS_PAGE.html + +.. note:: + + Configuring the QoS blocks of a running system can cause issues. + You can only modify these settings during boot-up by the boot-loaders + when many of the systems in the SoC are idle. + + diff --git a/source/linux/Foundational_Components/U-Boot/Users-Guide.rst b/source/linux/Foundational_Components/U-Boot/Users-Guide.rst index 09bbc3ff0..d6b74c360 100644 --- a/source/linux/Foundational_Components/U-Boot/Users-Guide.rst +++ b/source/linux/Foundational_Components/U-Boot/Users-Guide.rst @@ -34,3 +34,4 @@ User's Guide UG-Key-Writer-Lite UG-Programming-OTPs UG-Falcon-Mode + UG-QoS