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
011c092
feat(fix): ensure files end with a newline
bryanbrattlof Dec 15, 2025
60ec232
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 @@ -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
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
3 changes: 2 additions & 1 deletion 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 Expand Up @@ -142,4 +143,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
linux/Demo_User_Guides/Chromium_Browser
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
47 changes: 47 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,47 @@
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 11.75 is above the recommended reading grade level of 9.

Raw Output:
{"message": "[RedHat.ReadabilityGrade] Simplify your language. The calculated Flesch–Kincaid grade level of 11.75 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. These can change attributes such as the priority, Address

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.SentenceLength] Try to keep sentences to an average of 32 words or fewer.

Raw Output:
{"message": "[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 5, "column": 15}}}, "severity": "INFO"}
Selection (ASEL), and Order ID (orderID) values of the transactions
created by blocks in the System on a Chip (SoC) to route and prioritize

Check warning on line 7 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": 7, "column": 62}}}, "severity": "INFO"}
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

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.SentenceLength] Try to keep sentences to an average of 32 words or fewer.

Raw Output:
{"message": "[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 11, "column": 55}}}, "severity": "INFO"}
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

Check warning on line 15 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 'later' rather than 'higher'.

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

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

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.

Raw Output:
{"message": "[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 15, "column": 10}}}, "severity": "INFO"}
will allow its traffic to use the EMIF's high priority port, helping to

Check warning on line 16 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 'EMIF's'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'EMIF's'. 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": 16, "column": 35}}}, "severity": "WARNING"}
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

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.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": 22, "column": 1}}}, "severity": "INFO"}
======================

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

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

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.

Raw Output:
{"message": "[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-QoS.rst", "range": {"start": {"line": 26, "column": 47}}}, "severity": "INFO"}
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.


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