Skip to content

docs(linux): Documents Known SD Card Issues #437

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 1 commit into
base: master
Choose a base branch
from
Open

docs(linux): Documents Known SD Card Issues #437

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
2 changes: 2 additions & 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 @@ -83,6 +83,8 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/USB/AM62_DWC3
linux/Foundational_Components/Kernel/Kernel_Drivers/VTM
linux/Foundational_Components/Kernel/Kernel_Drivers/Watchdog

linux/Foundational_Components/MMC-Known-SD-Card-Issues

linux/Foundational_Components_Power_Management
linux/Foundational_Components/Power_Management/pm_overview
linux/Foundational_Components/Power_Management/pm_dfs
Expand Down
2 changes: 2 additions & 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 @@ -88,6 +88,8 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/USB/AM62_DWC3
linux/Foundational_Components/Kernel/Kernel_Drivers/VTM
linux/Foundational_Components/Kernel/Kernel_Drivers/Watchdog

linux/Foundational_Components/MMC-Known-SD-Card-Issues

linux/Foundational_Components_Power_Management
linux/Foundational_Components/Power_Management/pm_overview
linux/Foundational_Components/Power_Management/pm_dfs
Expand Down
2 changes: 2 additions & 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 @@ -85,6 +85,8 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/USB/AM62_DWC3
linux/Foundational_Components/Kernel/Kernel_Drivers/VTM
linux/Foundational_Components/Kernel/Kernel_Drivers/Watchdog

linux/Foundational_Components/MMC-Known-SD-Card-Issues

linux/Foundational_Components_Power_Management
linux/Foundational_Components/Power_Management/pm_overview
linux/Foundational_Components/Power_Management/pm_dfs
Expand Down
3 changes: 3 additions & 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 @@ -79,6 +79,9 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/UBIFS
linux/Foundational_Components/Kernel/Kernel_Drivers/USB/CDNS3
linux/Foundational_Components/Kernel/Kernel_Drivers/VTM
linux/Foundational_Components/Kernel/Kernel_Drivers/Watchdog

linux/Foundational_Components/MMC-Known-SD-Card-Issues

linux/Foundational_Components_Kernel_Users_Guide
linux/Foundational_Components_Kernel_LTP-DDT_Validation
linux/Foundational_Components_Kernel_FAQs
Expand Down
5 changes: 5 additions & 0 deletions source/linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/MMC-SD.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -405,6 +405,11 @@

There is no missing MMC support for |__PART_FAMILY_DEVICE_NAMES__| device.

SD card compatibility in Linux

Check warning on line 408 in source/linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/MMC-SD.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'SD card compatibility in Linux'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'SD card compatibility in Linux'.", "location": {"path": "source/linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/MMC-SD.rst", "range": {"start": {"line": 408, "column": 1}}}, "severity": "INFO"}
******************************

Refer to the :ref:`mmc-sd-card-compatibility-label` page.

Steps for working around SD card issues in Linux
************************************************

Expand Down
220 changes: 220 additions & 0 deletions source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,220 @@
.. _mmc-sd-card-compatibility-label:

#################################
SD Card Compatibility Data Points

Check warning on line 4 in source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'SD Card Compatibility Data Points'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'SD Card Compatibility Data Points'.", "location": {"path": "source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst", "range": {"start": {"line": 4, "column": 1}}}, "severity": "INFO"}
#################################

Some SD cards may not boot as expected on TI EVMs. This varies by SD card manufacturer, model, capacity, speed, and other factors. A variety have been tested and are documented in the table below:

Check warning on line 7 in source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsSuggestions] Depending on the context, consider using 'after', 'later', or 'following' rather than 'below'.

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'after', 'later', or 'following' rather than 'below'.", "location": {"path": "source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst", "range": {"start": {"line": 7, "column": 191}}}, "severity": "INFO"}

Check warning on line 7 in source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.PassiveVoice] 'are documented' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.", "location": {"path": "source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst", "range": {"start": {"line": 7, "column": 163}}}, "severity": "INFO"}

Check warning on line 7 in source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[RedHat.Definitions] Define acronyms and abbreviations (such as 'EVMs') on first occurrence if they're likely to be unfamiliar.", "location": {"path": "source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst", "range": {"start": {"line": 7, "column": 46}}}, "severity": "INFO"}

Check warning on line 7 in source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsWarnings] Consider using 'might' or 'can' rather than 'may' unless updating existing content that uses the term.

Raw Output:
{"message": "[RedHat.TermsWarnings] Consider using 'might' or 'can' rather than 'may' unless updating existing content that uses the term.", "location": {"path": "source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst", "range": {"start": {"line": 7, "column": 15}}}, "severity": "WARNING"}

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Need reference on where this limitation is captured.
Ref: https://www.ti.com/lit/er/sprz582a/sprz582a.pdf i2463 for AM62L
that this limitation is only for AM62L SR1.0 (But not on AM62L SR1.1)

Is there a Silicon or board errata doc specifically capturing this limitation ? Need references as well for all mentioned devices.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Limitation described in Section "4.3 Issue 3 - uSD Card Boot Not Working" on page 61 of the AM64x EVM User's guide: https://www.ti.com/lit/pdf/SPRUJ63.

.. note::

Tested on SDK v11.01.05. "MISMATCH" result means board boots but shows mismatching speed modes in U-Boot and Kernel.

.. ifconfig:: CONFIG_part_variant in ('AM62X')

.. csv-table::
:header: SoC,Board,Brand,Capacity (GB),Model,Bus Interface,Speed Class,UHS Speed Class,App Performance,Video Speed Class,Color,Pass/Fail,Speed Mode (U-Boot / Kernel),Notes

Check warning on line 16 in source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.CaseSensitiveTerms] Use 'kernel' rather than 'Kernel'.

Raw Output:
{"message": "[RedHat.CaseSensitiveTerms] Use 'kernel' rather than 'Kernel'.", "location": {"path": "source/linux/Foundational_Components/MMC-Known-SD-Card-Issues.rst", "range": {"start": {"line": 16, "column": 165}}}, "severity": "WARNING"}

AM62X,SK-AM62B-P1,SanDisk,4,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62X,SK-AM62B-P1,SanDisk,8,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62X,SK-AM62B-P1,SanDisk,16,,,C4,,,,Black,PASS,SD High Speed,
AM62X,SK-AM62B-P1,SanDisk,16,Edge,I,C10,U1,A1,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,32,Edge,I,C10,U1,A1,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,8,Ultra Red,I,C10,,,,Red-grey,PASS,UHS SDR50/DDR50,
AM62X,SK-AM62B-P1,SanDisk,16,Ultra Red,I,C10,,A1,,Red-grey,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,32,Ultra Red,I,C10,U1,A1,,Red-grey,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,16,Ultra White,I,C10,,,,White-grey,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,32,Ultra White,I,C10,,,,White-grey,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,32,Extreme,I,,U3,A1,V30,Red-gold,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,SanDisk,32,Max Endurance,I,C10,U3,,V30,White-gold,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Lexar,32,,I,,U1,A1,V10,White-red,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Gigastone,16,Camera Plus,I,C10,U1,,,Red-white,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Kootion,16,,I,C10,U1,,,White-red,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Kingston,8,,,C4,,,,Black,PASS,SD High Speed,
AM62X,SK-AM62B-P1,Kingston,32,Canvas Select Plus,I,,U1,A1,V10,Black-pink,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Kingston,32,,I,C10,U3,,,Black-red,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Micro Center,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Micro Center,32,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Patriot,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Patriot,32,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Transcend,8,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62X,SK-AM62B-P1,Transcend,8,Premium 400x,I,C10,U1,,,Red-black,MISMATCH,UHS SDR104 (u-boot) / ultra high speed SDR50 SDHC (kernel),
AM62X,SK-AM62B-P1,Transcend,32,Premium,I,C10,U1,,,Red-black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Transcend,16,,I,C10,U1,,,Silver,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Transcend,64,Ultra Performance,I,,U3,A2,V30,Silver-black,PASS,UHS SDR104,
AM62X,SK-AM62A-LP,Strontium,32,Nitro,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Kexin,8,,,C10,,,,Green-black,PASS,SD High Speed,
AM62X,SK-AM62B-P1,Kexin,16,,I,C10,U1,,,Green-black,MISMATCH,UHS SDR104 (u-boot) / high speed SDHC (kernel),
AM62X,SK-AM62B-P1,PNY,16,,,C4,,,,Black,PASS,SD High Speed,
AM62X,SK-AM62B-P1,PNY,16,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,PNY,32,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,PNY,64,Elite-X,I,,U3,A1,V30,Green-black,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,Samsung,32,EVO Select,I,,U1,,,White-green,PASS,UHS SDR104,
AM62X,SK-AM62B-P1,,8,,,C4,,,,Black,PASS,UHS SDR50/DDR50,


.. ifconfig:: CONFIG_part_variant in ('AM62AX')

.. csv-table::
:header: SoC,Board,Brand,Capacity (GB),Model,Bus Interface,Speed Class,UHS Speed Class,App Performance,Video Speed Class,Color,Pass/Fail,Speed Mode (U-Boot / Kernel),Notes

AM62AX,SK-AM62A-LP,SanDisk,4,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62AX,SK-AM62A-LP,SanDisk,8,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Considering AM62A release is with EdgeAI, will it be correct to mention boot support with 4GB & 8GB sized SD cards as the EdgeAI wic image size (tisdk-edgeai-image-am62a-evm-11.01.07.05.rootfs.wic.xz) is ~11 GB in itself - https://www.ti.com/tool/download/PROCESSOR-SDK-LINUX-AM62A/11.01.07.05 ?

AM62AX,SK-AM62A-LP,SanDisk,16,,,C4,,,,Black,PASS,SD High Speed,
AM62AX,SK-AM62A-LP,SanDisk,16,Edge,I,C10,U1,A1,,Black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,32,Edge,I,C10,U1,A1,,Black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,8,Ultra Red,I,C10,,,,Red-grey,PASS,UHS SDR50/DDR50,
AM62AX,SK-AM62A-LP,SanDisk,16,Ultra Red,I,C10,,A1,,Red-grey,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,32,Ultra Red,I,C10,U1,A1,,Red-grey,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,16,Ultra White,I,C10,,,,White-grey,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,32,Ultra White,I,C10,,,,White-grey,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,32,Extreme,I,,U3,A1,V30,Red-gold,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,SanDisk,32,Max Endurance,I,C10,U3,,V30,White-gold,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Lexar,32,,I,,U1,A1,V10,White-red,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Gigastone,16,Camera Plus,I,C10,U1,,,Red-white,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Kootion,16,,I,C10,U1,,,White-red,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Kingston,8,,,C4,,,,Black,PASS,SD High Speed,
Copy link
Member

@cshilwant cshilwant Aug 13, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment as #437 (comment)

AM62AX,SK-AM62A-LP,Kingston,32,Canvas Select Plus,I,,U1,A1,V10,Black-pink,PASS,UHS SDR104,"1/6 of the ones we tested of this type failed to boot, giving this error:

Trying to boot from MMC2
Error reading cluster
spl_load_image_fat: error reading image u-boot.img, err - -22
SPL: failed to boot from all boot devices
### ERROR ### Please RESET the board ###"
AM62AX,SK-AM62A-LP,Kingston,32,,I,C10,U3,,,Black-red,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Micro Center,16,,I,C10,U1,,,Black,PASS,UHS SDR104,"3/7 of the ones we tested of this type failed to boot, giving this error:

Trying to boot from MMC2
Error reading cluster
spl_load_image_fat: error reading image u-boot.img, err - -22
SPL: failed to boot from all boot devices
### ERROR ### Please RESET the board ###"
AM62AX,SK-AM62A-LP,Micro Center,32,,I,C10,U1,,,Black,FAIL,,"The 1 card we tested of this type failed to boot, giving this error:

Trying to boot from MMC2
Error reading cluster
spl_load_image_fat: error reading image u-boot.img, err - -22
SPL: failed to boot from all boot devices
### ERROR ### Please RESET the board ###"
AM62AX,SK-AM62A-LP,Patriot,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Patriot,32,,I,C10,U1,,,Black,PASS,UHS SDR104,"8/10 of the ones we tested of this type failed to boot, giving this error:

Trying to boot from MMC2
Error reading cluster
spl_load_image_fat: error reading image u-boot.img, err - -22
SPL: failed to boot from all boot devices
### ERROR ### Please RESET the board ###"
AM62AX,SK-AM62A-LP,Transcend,8,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62AX,SK-AM62A-LP,Transcend,8,Premium 400x,I,C10,U1,,,Red-black,MISMATCH,UHS SDR104 (u-boot) / ultra high speed SDR50 SDHC (kernel),
AM62AX,SK-AM62A-LP,Transcend,32,Premium,I,C10,U1,,,Red-black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Transcend,16,,I,C10,U1,,,Silver,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Transcend,64,Ultra Performance,I,,U3,A2,V30,Silver-black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Strontium,32,Nitro,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Kexin,8,,,C10,,,,Green-black,PASS,SD High Speed,
AM62AX,SK-AM62A-LP,Kexin,16,,I,C10,U1,,,Green-black,MISMATCH,UHS SDR104 (u-boot) / high speed SDHC (kernel),
AM62AX,SK-AM62A-LP,PNY,16,,,C4,,,,Black,PASS,SD High Speed,
AM62AX,SK-AM62A-LP,PNY,16,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,PNY,32,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,PNY,64,Elite-X,I,,U3,A1,V30,Green-black,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,Samsung,32,EVO Select,I,,U1,,,White-green,PASS,UHS SDR104,
AM62AX,SK-AM62A-LP,,8,,,C4,,,,Black,PASS,UHS SDR50/DDR50,


.. ifconfig:: CONFIG_part_variant in ('AM62PX')

.. csv-table::
:header: SoC,Board,Brand,Capacity (GB),Model,Bus Interface,Speed Class,UHS Speed Class,App Performance,Video Speed Class,Color,Pass/Fail,Speed Mode (U-Boot / Kernel),Notes

AM62PX,SK-AM62P-LP,SanDisk,4,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62PX,SK-AM62P-LP,SanDisk,8,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62PX,SK-AM62P-LP,SanDisk,16,,,C4,,,,Black,PASS,SD High Speed,
AM62PX,SK-AM62P-LP,SanDisk,16,Edge,I,C10,U1,A1,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,32,Edge,I,C10,U1,A1,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,8,Ultra Red,I,C10,,,,Red-grey,PASS,UHS SDR50/DDR50,
AM62PX,SK-AM62P-LP,SanDisk,16,Ultra Red,I,C10,,A1,,Red-grey,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,32,Ultra Red,I,C10,U1,A1,,Red-grey,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,16,Ultra White,I,C10,,,,White-grey,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,32,Ultra White,I,C10,,,,White-grey,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,32,Extreme,I,,U3,A1,V30,Red-gold,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,SanDisk,32,Max Endurance,I,C10,U3,,V30,White-gold,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Lexar,32,,I,,U1,A1,V10,White-red,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Gigastone,16,Camera Plus,I,C10,U1,,,Red-white,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Kootion,16,,I,C10,U1,,,White-red,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Kingston,8,,,C4,,,,Black,PASS,SD High Speed,
AM62PX,SK-AM62P-LP,Kingston,32,Canvas Select Plus,I,,U1,A1,V10,Black-pink,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Kingston,32,,I,C10,U3,,,Black-red,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Micro Center,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Micro Center,32,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Patriot,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Patriot,32,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Transcend,8,,I,C4,,,,Black,PASS,UHS SDR50/DDR50,
AM62PX,SK-AM62P-LP,Transcend,8,Premium 400x,I,C10,U1,,,Red-black,MISMATCH,UHS SDR104 (u-boot) / ultra high speed SDR50 SDHC (kernel),
AM62PX,SK-AM62P-LP,Transcend,32,Premium,I,C10,U1,,,Red-black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Transcend,16,,I,C10,U1,,,Silver,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Transcend,64,Ultra Performance,I,,U3,A2,V30,Silver-black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Strontium,32,Nitro,I,C10,U1,,,Black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Kexin,8,,,C10,,,,Green-black,PASS,SD High Speed,
AM62PX,SK-AM62P-LP,Kexin,16,,I,C10,U1,,,Green-black,MISMATCH,UHS SDR104 (u-boot) / high speed SDHC (kernel),
AM62PX,SK-AM62P-LP,PNY,16,,,C4,,,,Black,PASS,SD High Speed,
AM62PX,SK-AM62P-LP,PNY,16,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,PNY,32,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,PNY,64,Elite-X,I,,U3,A1,V30,Green-black,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,Samsung,32,EVO Select,I,,U1,,,White-green,PASS,UHS SDR104,
AM62PX,SK-AM62P-LP,,8,,,C4,,,,Black,PASS,UHS SDR50/DDR50,


.. ifconfig:: CONFIG_part_variant in ('AM64X')

.. note::

The below table was tested on a TMDS64EVM without the solution described in Section "4.3 Issue 3 - uSD Card Boot Not Working" on page 61 of the
AM64x EVM User's guide: https://www.ti.com/lit/pdf/SPRUJ63.

.. csv-table::
:header: SoC,Board,Brand,Capacity (GB),Model,Bus Interface,Speed Class,UHS Speed Class,App Performance,Video Speed Class,Color,Pass/Fail,Speed Mode (U-Boot / Kernel),Notes

AM64X,TMDS64EVM,SanDisk,4,,I,C4,,,,Black,MISMATCH,SD High Speed (u-boot) / ultra high speed DDR50 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,8,,I,C4,,,,Black,MISMATCH,SD High Speed (u-boot) / ultra high speed DDR50 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,16,,,C4,,,,Black,PASS,SD High Speed,
AM64X,TMDS64EVM,SanDisk,16,Edge,I,C10,U1,A1,,Black,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,32,Edge,I,C10,U1,A1,,Black,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,8,Ultra Red,I,C10,,,,Red-grey,MISMATCH,SD High Speed (u-boot) / ultra high speed DDR50 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,16,Ultra Red,I,C10,,A1,,Red-grey,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,32,Ultra Red,I,C10,U1,A1,,Red-grey,FAIL,,"U-Boot SPL 2025.01-00527-gd2a72467939e (Jul 01 2025 - 21:23:47 +0000)
Resetting on cold boot to workaround ErrataID:i2331
Please resend tiboot3.bin in case of UART/DFU boot
resetting ..."
AM64X,TMDS64EVM,SanDisk,16,Ultra White,I,C10,,,,White-grey,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,32,Ultra White,I,C10,,,,White-grey,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,32,Extreme,I,,U3,A1,V30,Red-gold,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,SanDisk,32,Max Endurance,I,C10,U3,,V30,White-gold,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Lexar,32,,I,,U1,A1,V10,White-red,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Gigastone,16,Camera Plus,I,C10,U1,,,Red-white,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Kootion,16,,I,C10,U1,,,White-red,PASS,UHS SDR104,
AM64X,TMDS64EVM,Kingston,8,,,C4,,,,Black,PASS,SD High Speed,
AM64X,TMDS64EVM,Kingston,32,Canvas Select Plus,I,,U1,A1,V10,Black-pink,PASS,UHS SDR104,
AM64X,TMDS64EVM,Kingston,32,,I,C10,U3,,,Black-red,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Micro Center,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM64X,TMDS64EVM,Micro Center,32,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM64X,TMDS64EVM,Patriot,16,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM64X,TMDS64EVM,Patriot,32,,I,C10,U1,,,Black,PASS,UHS SDR104,
AM64X,TMDS64EVM,Transcend,8,,I,C4,,,,Black,MISMATCH,SD High Speed (u-boot) / ultra high speed DDR50 SDHC (kernel),
AM64X,TMDS64EVM,Transcend,8,Premium 400x,I,C10,U1,,,Red-black,PASS,UHS SDR104,
AM64X,TMDS64EVM,Transcend,32,Premium,I,C10,U1,,,Red-black,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Transcend,16,,I,C10,U1,,,Silver,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Transcend,64,Ultra Performance,I,,U3,A2,V30,Silver-black,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,Strontium,32,Nitro,I,C10,U1,,,Black,FAIL,,"U-Boot SPL 2025.01-00527-gd2a72467939e (Jul 01 2025 - 21:23:47 +0000)
Resetting on cold boot to workaround ErrataID:i2331
Please resend tiboot3.bin in case of UART/DFU boot
resetting ..."
AM64X,TMDS64EVM,Kexin,8,,,C10,,,,Green-black,PASS,SD High Speed,
AM64X,TMDS64EVM,Kexin,16,,I,C10,U1,,,Green-black,MISMATCH,UHS SDR104 (u-boot) / high speed SDHC (kernel),
AM64X,TMDS64EVM,PNY,16,,,C4,,,,Black,PASS,SD High Speed,
AM64X,TMDS64EVM,PNY,16,Elite,I,,U1,,,Green-grey,MISMATCH,SD High Speed (u-boot) / ultra high speed SDR104 SDHC (kernel),
AM64X,TMDS64EVM,PNY,32,Elite,I,,U1,,,Green-grey,PASS,UHS SDR104,
AM64X,TMDS64EVM,PNY,64,Elite-X,I,,U3,A1,V30,Green-black,FAIL,,"U-Boot SPL 2025.01-00527-gd2a72467939e (Jul 01 2025 - 21:23:47 +0000)
Resetting on cold boot to workaround ErrataID:i2331
Please resend tiboot3.bin in case of UART/DFU boot
resetting ..."
AM64X,TMDS64EVM,Samsung,32,EVO Select,I,,U1,,,White-green,PASS,UHS SDR104,
AM64X,TMDS64EVM,,8,,,C4,,,,Black,MISMATCH,SD High Speed (u-boot) / ultra high speed DDR50 SDHC (kernel),
5 changes: 5 additions & 0 deletions source/linux/Foundational_Components/U-Boot/UG-Memory-K3.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -785,6 +785,11 @@

|

SD card compatibility in u-boot

Check warning on line 788 in source/linux/Foundational_Components/U-Boot/UG-Memory-K3.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'SD card compatibility in u-boot'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'SD card compatibility in u-boot'.", "location": {"path": "source/linux/Foundational_Components/U-Boot/UG-Memory-K3.rst", "range": {"start": {"line": 788, "column": 1}}}, "severity": "INFO"}
===============================

Refer to the :ref:`mmc-sd-card-compatibility-label` page.

Steps for working around SD card issues in u-boot
=================================================

Expand Down