feat(linux): AM62P: Document eMMC HS400 support

jmenti · StaticRocket · commit 06138087cffe · 2025-10-09T16:42:05.000-05:00
eMMC HS400 mode is only supported on AM62p SR1.2, all other silicon revisions
only support up to eMMC HS200 mode. Document this in build sheet and u-boot/Linux
driver documentation.

Signed-off-by: Judith Mendez &lt;jm@ti.com&gt;
diff --git a/source/devices/AM62PX/linux/Release_Specific_Build_Sheet.rst b/source/devices/AM62PX/linux/Release_Specific_Build_Sheet.rst
@@ -123,7 +123,8 @@ The support status is indicated by the following codes:
    ,,etc.,No,No,No
    ,Error Location Module (ELM),,Yes,No,No
    ,Multimedia Card Secure Digital (MMCSD) Interface,SD Card,Yes,No,Yes
-   ,,eMMC,Yes,No,Yes
+   ,,eMMC,Yes,Yes,Yes
+   ,,eMMC HS400 mode,Yes (SR1.2 only),Yes,Yes
    Industrial & Control Interfaces,Controller Area Network (MCAN) - MAIN domain,CAN,Yes,No,Yes
    ,,CAN FD,Yes,No,Yes
    ,Controller Area Network (MCAN) - MCU domain,CAN,Yes,Yes,No
diff --git a/source/linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/MMC-SD.rst b/source/linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/MMC-SD.rst
@@ -72,7 +72,8 @@ Features
    The MMCSD driver supports the following features:
 
    - Support ADMA for DMA transfers
-   - HS200 speed mode
+   - HS400 speed mode (SR1.2)
+   - HS200 speed mode (SR1.1)
    - Support for both built-in and module mode
    - ext2/ext3/ext4 file system support
 
@@ -222,7 +223,8 @@ Supported ultra high speed (UHS) modes
       AM62*, Y, Y, N
       AM62ax, Y, Y, N
       am64x, Y, Y, N
-      am62px, Y, Y, N
+      am62px SR1.1, Y, Y, N
+      am62px SR1.2, Y, Y, Y
       am62lx, Y, Y, N
 
 Driver configuration
@@ -365,32 +367,36 @@ MMC support in Linux
 
    **eMMC HS400 support**
 
-   For 11.0 and 11.1 SDK, am62px device does not support eMMC HS400 mode due to errata `i2458 <https://www.ti.com/lit/pdf/sprz574>`__.
-   If support for HS400 is required, please add the following to k3-am62p-j722s-common-main.dtsi:
-
-   .. code-block:: diff
-
-      diff --git a/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi b/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi
-      index 3e5ca8a3eb86..a05b22a6e5a2 100644
-      --- a/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi
-      +++ b/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi
-      @@ -593,12 +593,16 @@ sdhci0: mmc@fa10000 {
-                      bus-width = <8>;
-                      mmc-ddr-1_8v;
-                      mmc-hs200-1_8v;
-      +               mmc-hs400-1_8v;
-                      ti,clkbuf-sel = <0x7>;
-                      ti,trm-icp = <0x8>;
-      +               ti,strobe-sel = <0x55>;
-                      ti,otap-del-sel-legacy = <0x1>;
-                      ti,otap-del-sel-mmc-hs = <0x1>;
-                      ti,otap-del-sel-ddr52 = <0x6>;
-                      ti,otap-del-sel-hs200 = <0x8>;
-      +               ti,otap-del-sel-hs400 = <0x5>; // at 0.85V VDD_CORE
-      +               //ti,otap-del-sel-hs400 = <0x7>; // at 0.75V VDD_CORE
-                      ti,itap-del-sel-legacy = <0x10>;
-                      ti,itap-del-sel-mmc-hs = <0xa>;
-                      ti,itap-del-sel-ddr52 = <0x3>;
+   - For 11.1.1 SDK, only am62px SR1.2 supports eMMC HS400 mode, all earlier silicon revisions
+     only support up to eMMC HS200 mode. Logic to determine eMMC mode is abstracted away in host
+     driver and depends on silicon revision parsing.
+
+   - For 11.0 and 11.1 SDK, am62px device does not support eMMC HS400 mode due to errata `i2458 <https://www.ti.com/lit/pdf/sprz574>`__.
+     If support for HS400 is required, please add the following to k3-am62p-j722s-common-main.dtsi:
+
+      .. code-block:: diff
+
+         diff --git a/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi b/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi
+         index 3e5ca8a3eb86..a05b22a6e5a2 100644
+         --- a/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi
+         +++ b/arch/arm64/boot/dts/ti/k3-am62p-j722s-common-main.dtsi
+         @@ -593,12 +593,16 @@ sdhci0: mmc@fa10000 {
+                         bus-width = <8>;
+                         mmc-ddr-1_8v;
+                         mmc-hs200-1_8v;
+         +               mmc-hs400-1_8v;
+                         ti,clkbuf-sel = <0x7>;
+                         ti,trm-icp = <0x8>;
+         +               ti,strobe-sel = <0x55>;
+                         ti,otap-del-sel-legacy = <0x1>;
+                         ti,otap-del-sel-mmc-hs = <0x1>;
+                         ti,otap-del-sel-ddr52 = <0x6>;
+                         ti,otap-del-sel-hs200 = <0x8>;
+         +               ti,otap-del-sel-hs400 = <0x5>; // at 0.85V VDD_CORE
+         +               //ti,otap-del-sel-hs400 = <0x7>; // at 0.75V VDD_CORE
+                         ti,itap-del-sel-legacy = <0x10>;
+                         ti,itap-del-sel-mmc-hs = <0xa>;
+                         ti,itap-del-sel-ddr52 = <0x3>;
 
 .. ifconfig:: CONFIG_part_family in ('AM62X_family')
 
diff --git a/source/linux/Foundational_Components/U-Boot/UG-Memory-K3.rst b/source/linux/Foundational_Components/U-Boot/UG-Memory-K3.rst
@@ -681,52 +681,56 @@ MMC support in u-boot
 
    **eMMC HS400 support**
 
-   For 11.0 and 11.1 SDK, am62px device does not support eMMC HS400 mode due to errata `i2458 <https://www.ti.com/lit/pdf/sprz574>`__.
-   If support for HS400 is required, add the following to k3-am62p-j722s-common-main.dtsi:
-
-   .. code-block:: diff
-
-      diff --git a/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi b/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi
-      index 8bfc6539b2a..8a536b081e1 100644
-      --- a/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi
-      +++ b/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi
-      @@ -593,12 +593,16 @@
-                      bus-width = <8>;
-                      mmc-ddr-1_8v;
-                      mmc-hs200-1_8v;
-      +               mmc-hs400-1_8v;
-                      ti,clkbuf-sel = <0x7>;
-      +               ti,strobe-sel = <0x55>;
-                      ti,trm-icp = <0x8>;
-                      ti,otap-del-sel-legacy = <0x1>;
-                      ti,otap-del-sel-mmc-hs = <0x1>;
-                      ti,otap-del-sel-ddr52 = <0x6>;
-                      ti,otap-del-sel-hs200 = <0x8>;
-      +               ti,otap-del-sel-hs400 = <0x5>; // at 0.85V VDD_CORE
-      +               //ti,otap-del-sel-hs400 = <0x7>; // at 0.75V VDD_CORE
-                      ti,itap-del-sel-legacy = <0x10>;
-                      ti,itap-del-sel-mmc-hs = <0xa>;
-                      ti,itap-del-sel-ddr52 = <0x3>;
-
-   and enable the following config options:
-
-   .. code-block:: diff
-
-      diff --git a/configs/am62px_evm_a53_defconfig b/configs/am62px_evm_a53_defconfig
-      index 09a91248ce6..f95879f41c9 100644
-      --- a/configs/am62px_evm_a53_defconfig
-      +++ b/configs/am62px_evm_a53_defconfig
-      @@ -114,8 +114,8 @@ CONFIG_MMC_IO_VOLTAGE=y
-       CONFIG_SPL_MMC_IO_VOLTAGE=y
-       CONFIG_MMC_UHS_SUPPORT=y
-       CONFIG_SPL_MMC_UHS_SUPPORT=y
-      -CONFIG_MMC_HS200_SUPPORT=y
-      -CONFIG_SPL_MMC_HS200_SUPPORT=y
-      +CONFIG_MMC_HS400_SUPPORT=y
-      +CONFIG_SPL_MMC_HS400_SUPPORT=y
-       CONFIG_MMC_SDHCI=y
-       CONFIG_MMC_SDHCI_ADMA=y
-       CONFIG_SPL_MMC_SDHCI_ADMA=y
+   - For 11.1.1 SDK, only am62px SR1.2 supports eMMC HS400 mode, all earlier silicon revisions
+     only support up to eMMC HS200 mode. Logic to determine eMMC mode is abstracted away in host
+     driver and depends on silicon revision parsing.
+
+   - For 11.0 and 11.1 SDK, am62px device does not support eMMC HS400 mode due to errata `i2458 <https://www.ti.com/lit/pdf/sprz574>`__.
+     If support for HS400 is required, add the following to k3-am62p-j722s-common-main.dtsi:
+
+      .. code-block:: diff
+
+         diff --git a/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi b/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi
+         index 8bfc6539b2a..8a536b081e1 100644
+         --- a/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi
+         +++ b/dts/upstream/src/arm64/ti/k3-am62p-j722s-common-main.dtsi
+         @@ -593,12 +593,16 @@
+                        bus-width = <8>;
+                        mmc-ddr-1_8v;
+                        mmc-hs200-1_8v;
+         +               mmc-hs400-1_8v;
+                        ti,clkbuf-sel = <0x7>;
+         +               ti,strobe-sel = <0x55>;
+                        ti,trm-icp = <0x8>;
+                        ti,otap-del-sel-legacy = <0x1>;
+                        ti,otap-del-sel-mmc-hs = <0x1>;
+                        ti,otap-del-sel-ddr52 = <0x6>;
+                        ti,otap-del-sel-hs200 = <0x8>;
+         +               ti,otap-del-sel-hs400 = <0x5>; // at 0.85V VDD_CORE
+         +               //ti,otap-del-sel-hs400 = <0x7>; // at 0.75V VDD_CORE
+                        ti,itap-del-sel-legacy = <0x10>;
+                        ti,itap-del-sel-mmc-hs = <0xa>;
+                        ti,itap-del-sel-ddr52 = <0x3>;
+
+      and enable the following config options:
+
+      .. code-block:: diff
+
+         diff --git a/configs/am62px_evm_a53_defconfig b/configs/am62px_evm_a53_defconfig
+         index 09a91248ce6..f95879f41c9 100644
+         --- a/configs/am62px_evm_a53_defconfig
+         +++ b/configs/am62px_evm_a53_defconfig
+         @@ -114,8 +114,8 @@ CONFIG_MMC_IO_VOLTAGE=y
+         CONFIG_SPL_MMC_IO_VOLTAGE=y
+         CONFIG_MMC_UHS_SUPPORT=y
+         CONFIG_SPL_MMC_UHS_SUPPORT=y
+         -CONFIG_MMC_HS200_SUPPORT=y
+         -CONFIG_SPL_MMC_HS200_SUPPORT=y
+         +CONFIG_MMC_HS400_SUPPORT=y
+         +CONFIG_SPL_MMC_HS400_SUPPORT=y
+         CONFIG_MMC_SDHCI=y
+         CONFIG_MMC_SDHCI_ADMA=y
+         CONFIG_SPL_MMC_SDHCI_ADMA=y
 
 .. ifconfig:: CONFIG_part_family in ('AM62X_family')
 
