Skip to content

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

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
bryanbrattlof wants to merge 2 commits into
base: master
Choose a base branch
from
Open

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
59704bf
feat(fix): ensure files end with a newline
bryanbrattlof Dec 15, 2025
06cc12a
feat(U-Boot): add QoS configuration section
bryanbrattlof Dec 15, 2025
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 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 @@ -38,6 +38,7 @@ linux/Foundational_Components/U-Boot/UG-UMS
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-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 @@ -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
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
3 changes: 2 additions & 1 deletion 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 Expand Up @@ -145,4 +146,4 @@ linux/How_to_Guides/Target/How_To_Carve_Out_CMA

linux/Documentation_Tarball

linux/Demo_User_Guides/Chromium_Browser
linux/Demo_User_Guides/Chromium_Browser
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
3 changes: 2 additions & 1 deletion 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 Expand Up @@ -147,4 +148,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
linux/Demo_User_Guides/Chromium_Browser
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)

Check warning on line 1 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Quality of Service (QoS)'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Quality of Service (QoS)'.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 1, "column": 1}}}, "severity": "INFO"}

Check warning on line 1 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.ReadabilityGrade] Simplify your language. The calculated Flesch–Kincaid grade level of 9.48 is above the recommended reading grade level of 9.

Raw Output:
{"message": "[RedHat.ReadabilityGrade] Simplify your language. The calculated Flesch–Kincaid grade level of 9.48 is above the recommended reading grade level of 9.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 1, "column": 1}}}, "severity": "INFO"}
########################

The Common Bus Architecture (CBASS) module includes Quality of Service
(QoS) blocks to route and prioritize SoC bus traffic. By adjusting

Check warning on line 5 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.SimpleWords] Use simple language. Consider using 'rank' rather than 'prioritize'.

Raw Output:
{"message": "[RedHat.SimpleWords] Use simple language. Consider using 'rank' rather than 'prioritize'.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 5, "column": 27}}}, "severity": "INFO"}
attributes like priority, Address Selection (ASEL), and Order ID

Check warning on line 6 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsWarnings] Consider using 'such as' rather than 'like' unless updating existing content that uses the term.

Raw Output:
{"message": "[RedHat.TermsWarnings] Consider using 'such as' rather than 'like' unless updating existing content that uses the term.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 6, "column": 12}}}, "severity": "WARNING"}
(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 is serviced before standard

Check warning on line 11 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.PassiveVoice] 'is serviced' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.

Raw Output:
{"message": "[RedHat.PassiveVoice] 'is serviced' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 11, "column": 43}}}, "severity": "INFO"}
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

Check warning on line 17 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Modifying QoS Defaults'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Modifying QoS Defaults'.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 17, "column": 1}}}, "severity": "INFO"}
======================

Most transactions default to the lowest priority (ASEL 0, Order ID 0).
During boot-up, `U-Boot can update`_ these settings using data from the.

Check warning on line 21 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Using] Use 'by using' instead of 'using' when it follows a noun for clarity and grammatical correctness.

Raw Output:
{"message": "[RedHat.Using] Use 'by using' instead of 'using' when it follows a noun for clarity and grammatical correctness.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 21, "column": 44}}}, "severity": "WARNING"}
Sysconfig Tool which you can download or launch online `here`_.

Check warning on line 22 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsSuggestions] Depending on the context, consider using 'start' or 'open' rather than 'launch'.

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'start' or 'open' rather than 'launch'.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 22, "column": 42}}}, "severity": "INFO"}

Check warning on line 22 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsSuggestions] Depending on the context, consider using 'that' or ', which' rather than 'which'.

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'that' or ', which' rather than 'which'.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 22, "column": 16}}}, "severity": "INFO"}

Check warning on line 22 in source/linux/Foundational_Components/U-Boot/UG-QoS.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Spelling] Verify the word 'Sysconfig'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'Sysconfig'. It is not in the American English spelling dictionary used by Vale.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 22, "column": 1}}}, "severity": "WARNING"}

.. _U-Boot can update: 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.


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 @@ -34,3 +34,4 @@ User's Guide
UG-Key-Writer-Lite
UG-Programming-OTPs
UG-Falcon-Mode
UG-QoS
Loading