Skip to content

feat(U-Boot): add QoS configuration section #713

New issue

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

Sign up for GitHub

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

Already on GitHub? Sign in to your account

Open
maybe-yiyi wants to merge 1 commit into
base: master
Choose a base branch
from
Open

feat(U-Boot): add QoS configuration section #713

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/styles/config/vocabularies/PSDK/accept.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ PVRCarbon
PVRTune
Sitara
Slint
SysConfig
TFLite
TVM
Trixie
Expand Down
1 change: 1 addition & 0 deletions configs/AM62AX/AM62AX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM62DX/AM62DX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ linux/Foundational_Components/U-Boot/UG-QSPI
linux/Foundational_Components/U-Boot/UG-UART
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
Expand Down
1 change: 1 addition & 0 deletions configs/AM62LX/AM62LX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ linux/Foundational_Components/U-Boot/UG-UART
linux/Foundational_Components/U-Boot/UG-Secure-Boot
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
Expand Down
1 change: 1 addition & 0 deletions configs/AM62PX/AM62PX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM62X/AM62X_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM64X/AM64X_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM67/AM67_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM67A/AM67A_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM68/AM68_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM68A/AM68A_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM69/AM69_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/AM69A/AM69A_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/J7200/J7200_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/J721E/J721E_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/J721S2/J721S2_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/J722S/J722S_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/J742S2/J742S2_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/J784S4/J784S4_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions configs/TDA4VM/TDA4VM_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
40 changes: 40 additions & 0 deletions source/linux/Foundational_Components/U-Boot/UG-QoS.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
Quality of Service (QoS)
########################

The Common Bus Architecture (CBASS) module includes Quality of Service
(QoS) blocks to route and prioritize SoC bus traffic. By adjusting
attributes such as priority, Address Selection (ASEL), and Order ID
(orderID), you can optimize transaction handling.

For example, most K3 SoC External Memory Interface (EMIF) controllers
use two ports. Setting an Order ID between 8 and 15 routes traffic
through a high-priority port, ensuring it gets serviced before standard
traffic. Applying this to the display subsystem helps prevent stuttering
and jitter.

For more details, see your processor's Technical Reference Manual (TRM).

Modifying QoS defaults
======================

Most transactions default to the lowest priority (ASEL 0, orderID 0).
During boot-up, `U-Boot can update`_ these settings by using data from
the SysConfig tool, which you can download or use online `here`_.

.. _U-Boot can update: https://source.denx.de/u-boot/u-boot/-/blob/v2026.04/arch/arm/mach-k3/am62px/am62p5_init.c?ref_type=tags#L216
.. _here: https://www.ti.com/tool/SYSCONFIG

The MCU+ SDK documentation has an excellent `guide`_ on how to use the
SysConfig tool to generate the needed :file:`<soc>_qos_uboot.c`
configuration file. Once generated, copy it into
:file:`arch/arm/mach-k3/r5/<soc>/<soc>_qos_uboot.c`, where ``<soc>``
is your SoC name, e.g. ``am62px``. Then rebuild U-Boot to apply your
changes.

.. _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 change these settings during boot-up by using the
bootloaders, when many of the systems in the SoC are idle.
1 change: 1 addition & 0 deletions source/linux/Foundational_Components/U-Boot/Users-Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,4 @@ User's Guide
UG-Key-Writer-Lite
UG-Programming-OTPs
UG-Falcon-Mode
UG-QoS