Skip to content

Misc fixes for am335/am437 devices #526

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

Misc fixes for am335/am437 devices #526

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
84088e2
perf: Incremental update for Linux perf guide for am335x 11.02 release
jmenti Nov 19, 2025
5a01005
perf: Incremental update for Linux perf guide for am437x 11.02 release
jmenti Nov 19, 2025
cd1b503
perf: Incremental update for Linux perf guide for am65x 11.02 release
jmenti Nov 19, 2025
d2e0362
fix: Fix missing titles for AM65 performance guide
jmenti Nov 20, 2025
4d878ca
fix: Fix MMC command in u-boot MMC guide
jmenti Nov 20, 2025
1b8c0a6
fix: Fixup UART flasing guide for am335/am437
jmenti Nov 20, 2025
d0507c2
fix: Fix UFS block rendering
jmenti Nov 20, 2025
436d3bb
chore: add beaglebone green eco in build guides
jmenti Nov 20, 2025
cc72dfa
fix: Fixup Linux kernel paths for arm architecture
jmenti Nov 20, 2025
0126836
chore: Move fit Image instructions to _Fit_Image_Guide.rst
jmenti Nov 20, 2025
045f5f2
chore: Update Supported platforms
jmenti Nov 20, 2025
4bd9c1e
chore: Fix notes for eMMC in MMCSD u-boot guide
jmenti Nov 20, 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
4 changes: 3 additions & 1 deletion configs/AM65X/AM65X_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,9 @@ devices/AM65X/linux/Release_Specific
devices/AM65X/linux/Release_Specific_Release_Notes
devices/AM65X/linux/Release_Specific_Yocto_layer_Configuration
devices/AM65X/linux/Release_Specific_Migration_Guide
devices/AM65X/linux/Release_Specific_Performance_Guide
devices/AM65X/linux/Release_Specific_Kernel_Performance_Guide
devices/AM65X/linux/Linux_Performance_Guide
devices/AM65X/linux/RT_Linux_Performance_Guide
devices/AM65X/linux/Release_Specific_Supported_Platforms_and_Versions
linux/Foundational_Components
linux/Foundational_Components_U-Boot
Expand Down
473 changes: 243 additions & 230 deletions source/devices/AM335X/linux/Release_Specific_Performance_Guide.rst
View file
Open in desktop

Large diffs are not rendered by default.

69 changes: 69 additions & 0 deletions source/devices/AM437X/linux/Release_Specific_Performance_Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -273,6 +273,19 @@ Execute the benchmark with the following:
"scale (mb/s)","649.78 (min 649.00, max 651.60)"
"triad (mb/s)","378.94 (min 378.60, max 379.50)"

Boot-time Measurement
---------------------

Boot media: MMCSD
^^^^^^^^^^^^^^^^^

.. csv-table:: Linux boot time MMCSD
:header: "Boot Configuration","am43xx-gpevm: Boot time in seconds: avg(min,max)"

"Linux boot time from SD with default rootfs (20 boot cycles)","50.96 (min 41.96, max 67.61)"

Boot time numbers [avg, min, max] are measured from "Starting kernel" to Linux prompt across 20 boot cycles.

|

Graphics SGX/RGX Driver
Expand Down Expand Up @@ -306,6 +319,62 @@ NAND Driver
"1048576","4.31 (min 4.25, max 4.37)","84.87 (min 84.27, max 85.58)","9.79 (min 9.77, max 9.80)","44.28 (min 43.13, max 46.28)"
"5242880","4.33 (min 4.26, max 4.39)","84.84 (min 84.44, max 85.52)","9.77 (min 9.73, max 9.81)","44.97 (min 42.98, max 47.50)"

MMCSD
-----

.. warning::

**IMPORTANT**: The performance numbers can be severely affected if the media is
mounted in sync mode. Hot plug scripts in the filesystem mount
removable media in sync mode to ensure data integrity. For performance
sensitive applications, umount the auto-mounted filesystem and
re-mount in async mode.

MMC EXT4 FIO 1G
^^^^^^^^^^^^^^^

.. csv-table:: MMC EXT4 FIO 1G
:header: "Buffer size (bytes)","am43xx-gpevm: Write EXT4 Throughput (Mbytes/sec)","am43xx-gpevm: Write EXT4 CPU Load (%)","am43xx-gpevm: Read EXT4 Throughput (Mbytes/sec)","am43xx-gpevm: Read EXT4 CPU Load (%)"

"1m","19.94 (min 19.90, max 20.00)","7.46 (min 6.73, max 8.24)","21.66 (min 21.60, max 21.70)","8.81 (min 8.58, max 9.02)"
"4m","19.92 (min 19.90, max 20.00)","6.47 (min 6.07, max 6.61)","21.66 (min 21.60, max 21.70)","8.28 (min 7.99, max 8.96)"
"4k","2.53","19.67 (min 18.85, max 20.81)","8.43 (min 8.40, max 8.46)","35.89 (min 33.69, max 38.46)"
"256k","19.12 (min 19.00, max 19.30)","9.85 (min 9.59, max 10.32)","21.32 (min 21.30, max 21.40)","9.98 (min 9.78, max 10.33)"

MMC EXT4
^^^^^^^^

.. csv-table:: MMC EXT4
:header: "Buffer size (bytes)","am43xx-gpevm: Write Raw Throughput (Mbytes/sec)","am43xx-gpevm: Write Raw CPU Load (%)","am43xx-gpevm: Read Raw Throughput (Mbytes/sec)","am43xx-gpevm: Read Raw CPU Load (%)"

"102400","19.14 (min 18.28, max 19.49)","13.97 (min 12.01, max 20.55)","20.21 (min 19.95, max 20.49)","11.98 (min 10.00, max 14.82)"
"262144","18.66 (min 17.79, max 19.56)","14.06 (min 11.87, max 18.30)","20.47 (min 20.22, max 21.04)","15.89 (min 14.88, max 16.73)"
"524288","18.62 (min 17.83, max 19.31)","13.80 (min 11.66, max 18.71)","21.34 (min 20.77, max 21.77)","15.92 (min 14.72, max 18.95)"
"1048576","18.69 (min 17.96, max 19.38)","13.81 (min 11.82, max 18.81)","22.75 (min 22.62, max 22.81)","16.25 (min 15.93, max 16.74)"
"5242880","18.99 (min 18.32, max 19.79)","13.58 (min 11.41, max 18.03)","22.77 (min 22.73, max 22.80)","16.96 (min 16.74, max 17.25)"

The performance numbers were captured using the following:

- SanDisk Max Endurance SD card (SDSQQVR-032G-GN6IA)
- Partition was mounted with async option

UBoot MMCSD
-----------

UBOOT MMCSD FAT
^^^^^^^^^^^^^^^

.. csv-table:: UBOOT MMCSD FAT
:header: "File size (bytes in hex)","am43xx-gpevm: Write Throughput (Kbytes/sec)","am43xx-gpevm: Read Throughput (Kbytes/sec)"

"400000","14236.33 (min 11314.92, max 16062.75)","19022.86 (min 18875.58, max 19230.05)"
"800000","14039.31 (min 11457.34, max 16650.41)","19359.07 (min 19275.29, max 19458.43)"
"1000000","14257.06 (min 11855.28, max 16804.10)","19508.72 (min 19458.43, max 19574.67)"

The performance numbers were captured using the following:

- SanDisk Max Endurance SD card (SDSQQVR-032G-GN6IA)

|

USB Driver
Expand Down
39 changes: 39 additions & 0 deletions source/devices/AM65X/linux/Linux_Performance_Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
==============================

Check warning on line 1 in source/devices/AM65X/linux/Linux_Performance_Guide.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.93 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.93 is above the recommended reading grade level of 9.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 1, "column": 1}}}, "severity": "INFO"}
Linux 11.02 Performance Guide

Check warning on line 2 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Linux 11.02 Performance Guide'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Linux 11.02 Performance Guide'.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 2, "column": 2}}}, "severity": "INFO"}
==============================

.. rubric:: **Read This First**
:name: read-this-first-rt-kernel-perf-guide

**All performance numbers provided in this document are gathered using

Check warning on line 8 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.PassiveVoice] 'are gathered' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 8, "column": 53}}}, "severity": "INFO"}
following Evaluation Modules unless otherwise specified.**

+----------------+---------------------------------------------------------------------------------------------------------------------+
| Name | Description |
+================+=====================================================================================================================+
| AM65x EVM | AM65x Evaluation Module rev 1.0 with ARM running at 800MHz, DDR4-2400 (1600 MT/S), TMDX654GPEVM |

Check warning on line 14 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Definitions] Define acronyms and abbreviations (such as 'EVM') on first occurrence if they're likely to be unfamiliar.

Raw Output:
{"message": "[RedHat.Definitions] Define acronyms and abbreviations (such as 'EVM') on first occurrence if they're likely to be unfamiliar.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 14, "column": 9}}}, "severity": "INFO"}
+----------------+---------------------------------------------------------------------------------------------------------------------+

Table: Evaluation Modules

.. rubric:: About This Manual
:name: about-this-manual-rt-kernel-perf-guide

This document provides performance data for each of the device drivers
which are part of the Processor SDK Linux package. This document should be

Check warning on line 23 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.PassiveVoice] 'be used' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 23, "column": 73}}}, "severity": "INFO"}

Check warning on line 23 in source/devices/AM65X/linux/Linux_Performance_Guide.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/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 23, "column": 52}}}, "severity": "INFO"}

Check warning on line 23 in source/devices/AM65X/linux/Linux_Performance_Guide.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/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 23, "column": 1}}}, "severity": "INFO"}
used in conjunction with release notes and user guides provided with the
Processor SDK Linux package for information on specific issues present

Check warning on line 25 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'information about' rather than 'information on'.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 25, "column": 33}}}, "severity": "INFO"}
with drivers included in a particular release.

.. rubric:: If You Need Assistance

Check warning on line 28 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.SimpleWords] Use simple language. Consider using 'help' rather than 'Assistance'.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 28, "column": 26}}}, "severity": "INFO"}
:name: if-you-need-assistance-rt-kernel-perf-guide

For further information or to report any problems, contact
https://e2e.ti.com/ or https://support.ti.com/

|

.. note::

AM65 benchmarking is performed using RT Kernel. For more information on

Check warning on line 38 in source/devices/AM65X/linux/Linux_Performance_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.PassiveVoice] 'is performed' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.", "location": {"path": "source/devices/AM65X/linux/Linux_Performance_Guide.rst", "range": {"start": {"line": 38, "column": 22}}}, "severity": "INFO"}
the RT Kernel performance numbers, go :ref:`here <RT-linux-performance>`.
21 changes: 17 additions & 4 deletions ..._Specific_RT_Kernel_Performance_Guide.rst → ...M65X/linux/RT_Linux_Performance_Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
.. _RT-linux-performance:

=================================
RT-linux 11.02 Performance Guide
Expand Down Expand Up @@ -302,6 +303,19 @@ thread-enabled workloads to be tested.
"x264-4mq (workloads/)","0.33"
"x264-4mqw1 (workloads/)","0.33"

Boot-time Measurement
---------------------

Boot media: MMCSD
^^^^^^^^^^^^^^^^^

.. csv-table:: Linux boot time MMCSD
:header: "Boot Configuration","am654x-evm: Boot time in seconds: avg(min,max)"

"Linux boot time from SD with default rootfs (20 boot cycles)","17.15 (min 16.76, max 17.93)"

Boot time numbers [avg, min, max] are measured from "Starting kernel" to Linux prompt across 20 boot cycles.

|

Graphics SGX/RGX Driver
Expand Down Expand Up @@ -359,7 +373,6 @@ EMMC Driver
sensitive applications, umount the auto-mounted filesystem and
re-mount in async mode.


EMMC EXT4 FIO 1G
^^^^^^^^^^^^^^^^

Expand Down Expand Up @@ -428,9 +441,9 @@ UBOOT MMCSD FAT
.. csv-table:: UBOOT MMCSD FAT
:header: "File size (bytes in hex)","am654x-evm: Write Throughput (Kbytes/sec)","am654x-evm: Read Throughput (Kbytes/sec)"

"400000","17724.22 (min 16583.00, max 18703.20)","22714.58 (min 22505.49, max 22882.68)"
"800000","18825.70 (min 14733.81, max 20951.41)","23141.61 (min 23011.24, max 23206.80)"
"1000000","19418.42 (min 17693.30, max 20557.09)","23372.42 (min 23305.83, max 23405.71)"
"400000","17601.94 (min 15937.74, max 18703.20)","22738.19 (min 22505.49, max 22882.68)"
"800000","19452.04 (min 14733.81, max 20951.41)","23197.75 (min 23011.24, max 23272.73)"
"1000000","19428.52 (min 16499.50, max 21222.80)","23381.92 (min 23305.83, max 23405.71)"

The performance numbers were captured using the following:

Expand Down
2 changes: 1 addition & 1 deletion source/devices/AM65X/linux/Release_Specific.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Release Specific
:maxdepth: 5

Release_Specific_Release_Notes
Release_Specific_Performance_Guide
Release_Specific_Yocto_layer_Configuration
Release_Specific_Migration_Guide
Release_Specific_Kernel_Performance_Guide
Release_Specific_Supported_Platforms_and_Versions
9 changes: 9 additions & 0 deletions source/devices/AM65X/linux/Release_Specific_Kernel_Performance_Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
########################
Kernel Performance Guide
########################

.. toctree::
:maxdepth: 4

RT_Linux_Performance_Guide
Linux_Performance_Guide
7 changes: 0 additions & 7 deletions source/devices/AM65X/linux/Release_Specific_Performance_Guide.rst
View file
Open in desktop

This file was deleted.

6 changes: 3 additions & 3 deletions source/devices/AM65X/linux/Release_Specific_Supported_Platforms_and_Versions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,9 @@ The following platforms and EVMs are supported with Processor SDK.
|**Platform** |**EVM** |**Tested |**Document** |**Processor SDK |**Processor SDK |**Processor SDK |
| | |Version** | |Linux** |RT Linux** |RTOS** |
+--------------------------------------+--------------------------------------+----------+--------------------------------------------+----------------+----------------+----------------+
|`AM65x/DRA80xM <http://www.ti.com/ |`AM65x/DRA80xM EVM | Beta |Hardware User's Guide | X | X | X |
|AM65x>`__ |<http://www.ti.com/tool/ | |`Hardware Setup with CCS <http://software-d | | | |
| |tmdx654gpevm>`__ | |l.ti.com/processor-sdk-rtos/esd/docs/ | | | |
|`AM65x/DRA80xM <http://www.ti.com/ | AM65 GP EVM is no longer available | Beta |Hardware User's Guide | X | X | X |
|AM65x>`__ | on TI.com | |`Hardware Setup with CCS <http://software-d | | | |
| | | |l.ti.com/processor-sdk-rtos/esd/docs/ | | | |
| | | |latest/rtos/How_to_Guides.html#am65x-evm>`__| | | |
| +--------------------------------------+----------+--------------------------------------------+----------------+----------------+----------------+
| |`AM65x/DRA80xM IDK | Beta |Hardware User's Guide | X | X | X |
Expand Down
2 changes: 2 additions & 0 deletions source/linux/Foundational_Components/Kernel/Kernel_Drivers/UFS.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
.. _KERNEL-SATA:

UFS
---------------------------------

Expand Down
Loading
Loading