]> git.proxmox.com Git - mirror_edk2.git/commitdiff
MdeModulePkg/SdMmcHcDxe: Implement revision 3 of SdMmcOverrideProtocol
authorAlbecki, Mateusz <mateusz.albecki@intel.com>
Wed, 26 Jun 2019 13:10:03 +0000 (21:10 +0800)
committerHao A Wu <hao.a.wu@intel.com>
Mon, 1 Jul 2019 01:19:36 +0000 (09:19 +0800)
https://bugzilla.tianocore.org/show_bug.cgi?id=1882

Implement support for GetOperatingParamters notify phase
in SdMmcHcDxe driver. GetOperatingParameters notify phase
is signaled before we start card detection and initialization.
Code has been updated for both eMMC and SD card controllers to
take into consideration those new parameters. Initialization process
has been divided into 2 steps. In the first step we bring the link
up to the point where we can get card identification data(Extended
CSD in eMMC case and SWITCH command response in SD card case). This
data is later used along with controller capabilities and operating
parameters passed in GetOperatingParameters phase to choose preferred
bus settings in GetTargetBusSettings function. Those settings are later
on to start bus training to high speeds. If user passes incompatible
setting with selected bus timing driver will assume it's standard behavior
with respect to that setting. For instance if HS400 has been selected as a
target bus timing due to card and controller support bus width setting of
4 and 1 bit won't be respected and 8 bit setting will be chosen instead.

Tests on Marvell boards were also performed by Marcin Wojtas
<mw@semihalf.com>:

https://edk2.groups.io/g/devel/message/42999

Board 1 (out of tree): SD - OK, MMC - OK
Board 2: (Armada80x0McBin): SD - OK, MMC - OK
Board 3: (Armada70x0Db): SD - problems, MMC - OK

Please note that the problem on Armada70x0Db SD devices are introduced by
adding new types of SD bus modes, a subsequent patch within edk2-platforms
repository will be proposed to address it.
(More details can be referred from the above link.)

Signed-off-by: Mateusz Albecki <mateusz.albecki@intel.com>
Reviewed-by: Hao A Wu <hao.a.wu@intel.com>
Regression-tested-by: Sumit Garg <sumit.garg@linaro.org>
MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/EmmcDevice.c
MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/SdDevice.c
MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/SdMmcPciHcDxe.c
MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/SdMmcPciHcDxe.h
MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/SdMmcPciHci.c
MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/SdMmcPciHci.h

index deaf4468c9d7526ba363c96a86d5185d70639186..3f4a8e5413d111eefba6547a47ee60666df6e7a5 100644 (file)
@@ -641,13 +641,13 @@ EmmcSwitchBusWidth (
   Refer to EMMC Electrical Standard Spec 5.1 Section 6.6 and SD Host Controller\r
   Simplified Spec 3.0 Figure 3-3 for details.\r
 \r
-  @param[in] PciIo          A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
-  @param[in] PassThru       A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
-  @param[in] Slot           The slot number of the SD card to send the command to.\r
-  @param[in] Rca            The relative device address to be assigned.\r
-  @param[in] HsTiming       The value to be written to HS_TIMING field of EXT_CSD register.\r
-  @param[in] Timing         The bus mode timing indicator.\r
-  @param[in] ClockFreq      The max clock frequency to be set, the unit is MHz.\r
+  @param[in] PciIo           A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
+  @param[in] PassThru        A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
+  @param[in] Slot            The slot number of the SD card to send the command to.\r
+  @param[in] Rca             The relative device address to be assigned.\r
+  @param[in] DriverStrength  Driver strength to set for speed modes that support it.\r
+  @param[in] BusTiming       The bus mode timing indicator.\r
+  @param[in] ClockFreq       The max clock frequency to be set, the unit is MHz.\r
 \r
   @retval EFI_SUCCESS       The operation is done correctly.\r
   @retval Others            The operation fails.\r
@@ -659,8 +659,8 @@ EmmcSwitchBusTiming (
   IN EFI_SD_MMC_PASS_THRU_PROTOCOL      *PassThru,\r
   IN UINT8                              Slot,\r
   IN UINT16                             Rca,\r
-  IN UINT8                              HsTiming,\r
-  IN SD_MMC_BUS_MODE                    Timing,\r
+  IN EDKII_SD_MMC_DRIVER_STRENGTH       DriverStrength,\r
+  IN SD_MMC_BUS_MODE                    BusTiming,\r
   IN UINT32                             ClockFreq\r
   )\r
 {\r
@@ -678,12 +678,29 @@ EmmcSwitchBusTiming (
   //\r
   Access = 0x03;\r
   Index  = OFFSET_OF (EMMC_EXT_CSD, HsTiming);\r
-  Value  = HsTiming;\r
   CmdSet = 0;\r
+  switch (BusTiming) {\r
+    case SdMmcMmcHs400:\r
+      Value = (UINT8)((DriverStrength.Emmc << 4) | 3);\r
+      break;\r
+    case SdMmcMmcHs200:\r
+      Value = (UINT8)((DriverStrength.Emmc << 4) | 2);\r
+      break;\r
+    case SdMmcMmcHsSdr:\r
+    case SdMmcMmcHsDdr:\r
+      Value = 1;\r
+      break;\r
+    case SdMmcMmcLegacy:\r
+      Value = 0;\r
+      break;\r
+    default:\r
+      DEBUG ((DEBUG_ERROR, "EmmcSwitchBusTiming: Unsupported BusTiming(%d\n)", BusTiming));\r
+      return EFI_INVALID_PARAMETER;\r
+  }\r
 \r
   Status = EmmcSwitch (PassThru, Slot, Access, Index, Value, CmdSet);\r
   if (EFI_ERROR (Status)) {\r
-    DEBUG ((DEBUG_ERROR, "EmmcSwitchBusTiming: Switch to hstiming %d fails with %r\n", HsTiming, Status));\r
+    DEBUG ((DEBUG_ERROR, "EmmcSwitchBusTiming: Switch to bus timing %d fails with %r\n", BusTiming, Status));\r
     return Status;\r
   }\r
 \r
@@ -713,7 +730,7 @@ EmmcSwitchBusTiming (
                           Private->ControllerHandle,\r
                           Slot,\r
                           EdkiiSdMmcSwitchClockFreqPost,\r
-                          &Timing\r
+                          &BusTiming\r
                           );\r
     if (EFI_ERROR (Status)) {\r
       DEBUG ((\r
@@ -739,10 +756,7 @@ EmmcSwitchBusTiming (
   @param[in] PassThru       A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
   @param[in] Slot           The slot number of the SD card to send the command to.\r
   @param[in] Rca            The relative device address to be assigned.\r
-  @param[in] ClockFreq      The max clock frequency to be set.\r
-  @param[in] IsDdr          If TRUE, use dual data rate data simpling method. Otherwise\r
-                            use single data rate data simpling method.\r
-  @param[in] BusWidth       The bus width to be set, it could be 4 or 8.\r
+  @param[in] BusMode        Pointer to SD_MMC_BUS_SETTINGS structure containing bus settings.\r
 \r
   @retval EFI_SUCCESS       The operation is done correctly.\r
   @retval Others            The operation fails.\r
@@ -754,25 +768,34 @@ EmmcSwitchToHighSpeed (
   IN EFI_SD_MMC_PASS_THRU_PROTOCOL      *PassThru,\r
   IN UINT8                              Slot,\r
   IN UINT16                             Rca,\r
-  IN UINT32                             ClockFreq,\r
-  IN BOOLEAN                            IsDdr,\r
-  IN UINT8                              BusWidth\r
+  IN SD_MMC_BUS_SETTINGS                *BusMode\r
   )\r
 {\r
   EFI_STATUS              Status;\r
-  UINT8                   HsTiming;\r
   UINT8                   HostCtrl1;\r
-  SD_MMC_BUS_MODE         Timing;\r
   SD_MMC_HC_PRIVATE_DATA  *Private;\r
+  BOOLEAN                 IsDdr;\r
 \r
   Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru);\r
 \r
-  Status = EmmcSwitchBusWidth (PciIo, PassThru, Slot, Rca, IsDdr, BusWidth);\r
+  if ((BusMode->BusTiming != SdMmcMmcHsSdr && BusMode->BusTiming != SdMmcMmcHsDdr) ||\r
+      BusMode->ClockFreq > 52) {\r
+    return EFI_INVALID_PARAMETER;\r
+  }\r
+\r
+  if (BusMode->BusTiming == SdMmcMmcHsDdr) {\r
+    IsDdr = TRUE;\r
+  } else {\r
+    IsDdr = FALSE;\r
+  }\r
+\r
+  Status = EmmcSwitchBusWidth (PciIo, PassThru, Slot, Rca, IsDdr, BusMode->BusWidth);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
+\r
   //\r
-  // Set to Hight Speed timing\r
+  // Set to High Speed timing\r
   //\r
   HostCtrl1 = BIT2;\r
   Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL1, sizeof (HostCtrl1), &HostCtrl1);\r
@@ -780,37 +803,25 @@ EmmcSwitchToHighSpeed (
     return Status;\r
   }\r
 \r
-  if (IsDdr) {\r
-    Timing = SdMmcMmcHsDdr;\r
-  } else if (ClockFreq == 52) {\r
-    Timing = SdMmcMmcHsSdr;\r
-  } else {\r
-    Timing = SdMmcMmcLegacy;\r
-  }\r
-\r
-  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, Timing);\r
+  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, BusMode->BusTiming);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
 \r
-  HsTiming = 1;\r
-  Status = EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, HsTiming, Timing, ClockFreq);\r
-\r
-  return Status;\r
+  return EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, BusMode->DriverStrength, BusMode->BusTiming, BusMode->ClockFreq);\r
 }\r
 \r
 /**\r
-  Switch to the HS200 timing according to request.\r
+  Switch to the HS200 timing. This function assumes that eMMC bus is still in legacy mode.\r
 \r
   Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller\r
   Simplified Spec 3.0 Figure 2-29 for details.\r
 \r
-  @param[in] PciIo          A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
-  @param[in] PassThru       A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
-  @param[in] Slot           The slot number of the SD card to send the command to.\r
-  @param[in] Rca            The relative device address to be assigned.\r
-  @param[in] ClockFreq      The max clock frequency to be set.\r
-  @param[in] BusWidth       The bus width to be set, it could be 4 or 8.\r
+  @param[in] PciIo           A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
+  @param[in] PassThru        A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
+  @param[in] Slot            The slot number of the SD card to send the command to.\r
+  @param[in] Rca             The relative device address to be assigned.\r
+  @param[in] BusMode         Pointer to SD_MMC_BUS_SETTINGS structure containing bus settings.\r
 \r
   @retval EFI_SUCCESS       The operation is done correctly.\r
   @retval Others            The operation fails.\r
@@ -822,30 +833,25 @@ EmmcSwitchToHS200 (
   IN EFI_SD_MMC_PASS_THRU_PROTOCOL      *PassThru,\r
   IN UINT8                              Slot,\r
   IN UINT16                             Rca,\r
-  IN UINT32                             ClockFreq,\r
-  IN UINT8                              BusWidth\r
+  IN SD_MMC_BUS_SETTINGS                *BusMode\r
   )\r
 {\r
   EFI_STATUS               Status;\r
-  UINT8                    HsTiming;\r
   UINT16                   ClockCtrl;\r
-  SD_MMC_BUS_MODE          Timing;\r
   SD_MMC_HC_PRIVATE_DATA  *Private;\r
 \r
   Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru);\r
 \r
-  if ((BusWidth != 4) && (BusWidth != 8)) {\r
+  if (BusMode->BusTiming != SdMmcMmcHs200 ||\r
+      (BusMode->BusWidth != 4 && BusMode->BusWidth != 8)) {\r
     return EFI_INVALID_PARAMETER;\r
   }\r
 \r
-  Status = EmmcSwitchBusWidth (PciIo, PassThru, Slot, Rca, FALSE, BusWidth);\r
+  Status = EmmcSwitchBusWidth (PciIo, PassThru, Slot, Rca, FALSE, BusMode->BusWidth);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
   //\r
-  // Set to HS200/SDR104 timing\r
-  //\r
-  //\r
   // Stop bus clock at first\r
   //\r
   Status = SdMmcHcStopClock (PciIo, Slot);\r
@@ -853,9 +859,7 @@ EmmcSwitchToHS200 (
     return Status;\r
   }\r
 \r
-  Timing = SdMmcMmcHs200;\r
-\r
-  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, Timing);\r
+  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, BusMode->BusTiming);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
@@ -881,28 +885,27 @@ EmmcSwitchToHS200 (
   ClockCtrl = BIT2;\r
   Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_CLOCK_CTRL, sizeof (ClockCtrl), &ClockCtrl);\r
 \r
-  HsTiming = 2;\r
-  Status = EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, HsTiming, Timing, ClockFreq);\r
+  Status = EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, BusMode->DriverStrength, BusMode->BusTiming, BusMode->ClockFreq);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
 \r
-  Status = EmmcTuningClkForHs200 (PciIo, PassThru, Slot, BusWidth);\r
+  Status = EmmcTuningClkForHs200 (PciIo, PassThru, Slot, BusMode->BusWidth);\r
 \r
   return Status;\r
 }\r
 \r
 /**\r
-  Switch to the HS400 timing according to request.\r
+  Switch to the HS400 timing. This function assumes that eMMC bus is still in legacy mode.\r
 \r
   Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller\r
   Simplified Spec 3.0 Figure 2-29 for details.\r
 \r
-  @param[in] PciIo          A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
-  @param[in] PassThru       A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
-  @param[in] Slot           The slot number of the SD card to send the command to.\r
-  @param[in] Rca            The relative device address to be assigned.\r
-  @param[in] ClockFreq      The max clock frequency to be set.\r
+  @param[in] PciIo           A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
+  @param[in] PassThru        A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
+  @param[in] Slot            The slot number of the SD card to send the command to.\r
+  @param[in] Rca             The relative device address to be assigned.\r
+  @param[in] BusMode         Pointer to SD_MMC_BUS_SETTINGS structure containing bus settings.\r
 \r
   @retval EFI_SUCCESS       The operation is done correctly.\r
   @retval Others            The operation fails.\r
@@ -914,47 +917,314 @@ EmmcSwitchToHS400 (
   IN EFI_SD_MMC_PASS_THRU_PROTOCOL      *PassThru,\r
   IN UINT8                              Slot,\r
   IN UINT16                             Rca,\r
-  IN UINT32                             ClockFreq\r
+  IN SD_MMC_BUS_SETTINGS                *BusMode\r
   )\r
 {\r
   EFI_STATUS                 Status;\r
-  UINT8                      HsTiming;\r
-  SD_MMC_BUS_MODE            Timing;\r
   SD_MMC_HC_PRIVATE_DATA     *Private;\r
+  SD_MMC_BUS_SETTINGS        Hs200BusMode;\r
+  UINT32                     HsFreq;\r
+\r
+  if (BusMode->BusTiming != SdMmcMmcHs400 ||\r
+      BusMode->BusWidth != 8) {\r
+    return EFI_INVALID_PARAMETER;\r
+  }\r
 \r
   Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru);\r
+  Hs200BusMode.BusTiming = SdMmcMmcHs200;\r
+  Hs200BusMode.BusWidth = BusMode->BusWidth;\r
+  Hs200BusMode.ClockFreq = BusMode->ClockFreq;\r
+  Hs200BusMode.DriverStrength = BusMode->DriverStrength;\r
 \r
-  Status = EmmcSwitchToHS200 (PciIo, PassThru, Slot, Rca, ClockFreq, 8);\r
+  Status = EmmcSwitchToHS200 (PciIo, PassThru, Slot, Rca, &Hs200BusMode);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
+\r
   //\r
-  // Set to Hight Speed timing and set the clock frequency to a value less than 52MHz.\r
+  // Set to High Speed timing and set the clock frequency to a value less than or equal to 52MHz.\r
+  // This step is necessary to be able to switch Bus into 8 bit DDR mode which is unsupported in HS200.\r
   //\r
-  HsTiming = 1;\r
-  Status = EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, HsTiming, SdMmcMmcHsSdr, 52);\r
+  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, SdMmcMmcHsSdr);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
-  //\r
-  // HS400 mode must use 8 data lines.\r
-  //\r
-  Status = EmmcSwitchBusWidth (PciIo, PassThru, Slot, Rca, TRUE, 8);\r
+\r
+  HsFreq = BusMode->ClockFreq < 52 ? BusMode->ClockFreq : 52;\r
+  Status = EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, BusMode->DriverStrength, SdMmcMmcHsSdr, HsFreq);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
 \r
-  Timing = SdMmcMmcHs400;\r
+  Status = EmmcSwitchBusWidth (PciIo, PassThru, Slot, Rca, TRUE, BusMode->BusWidth);\r
+  if (EFI_ERROR (Status)) {\r
+    return Status;\r
+  }\r
 \r
-  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, Timing);\r
+  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, BusMode->BusTiming);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
 \r
-  HsTiming = 3;\r
-  Status = EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, HsTiming, Timing, ClockFreq);\r
+  return EmmcSwitchBusTiming (PciIo, PassThru, Slot, Rca, BusMode->DriverStrength, BusMode->BusTiming, BusMode->ClockFreq);\r
+}\r
 \r
-  return Status;\r
+/**\r
+  Check if passed BusTiming is supported in both controller and card.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] ExtCsd     Pointer to the card's extended CSD\r
+  @param[in] BusTiming  Bus timing to check\r
+\r
+  @retval TRUE  Both card and controller support given BusTiming\r
+  @retval FALSE Card or controller doesn't support given BusTiming\r
+**/\r
+BOOLEAN\r
+EmmcIsBusTimingSupported (\r
+  IN SD_MMC_HC_PRIVATE_DATA  *Private,\r
+  IN UINT8                   SlotIndex,\r
+  IN EMMC_EXT_CSD            *ExtCsd,\r
+  IN SD_MMC_BUS_MODE         BusTiming\r
+  )\r
+{\r
+  BOOLEAN             Supported;\r
+  SD_MMC_HC_SLOT_CAP  *Capabilities;\r
+\r
+  Capabilities = &Private->Capability[SlotIndex];\r
+\r
+  Supported = FALSE;\r
+  switch (BusTiming) {\r
+    case SdMmcMmcHs400:\r
+      if ((((ExtCsd->DeviceType & (BIT6 | BIT7))  != 0) && (Capabilities->Hs400 != 0)) && Capabilities->BusWidth8 != 0) {\r
+        Supported = TRUE;\r
+      }\r
+      break;\r
+    case SdMmcMmcHs200:\r
+      if ((((ExtCsd->DeviceType & (BIT4 | BIT5))  != 0) && (Capabilities->Sdr104 != 0))) {\r
+        Supported = TRUE;\r
+      }\r
+      break;\r
+    case SdMmcMmcHsDdr:\r
+      if ((((ExtCsd->DeviceType & (BIT2 | BIT3))  != 0) && (Capabilities->Ddr50 != 0))) {\r
+        Supported = TRUE;\r
+      }\r
+      break;\r
+    case SdMmcMmcHsSdr:\r
+      if ((((ExtCsd->DeviceType & BIT1)  != 0) && (Capabilities->HighSpeed != 0))) {\r
+        Supported = TRUE;\r
+      }\r
+      break;\r
+    case SdMmcMmcLegacy:\r
+      if ((ExtCsd->DeviceType & BIT0) != 0) {\r
+        Supported = TRUE;\r
+      }\r
+      break;\r
+    default:\r
+      ASSERT (FALSE);\r
+  }\r
+\r
+  return Supported;\r
+}\r
+\r
+/**\r
+  Get the target bus timing to set on the link. This function\r
+  will try to select highest bus timing supported by card, controller\r
+  and the driver.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] ExtCsd     Pointer to the card's extended CSD\r
+\r
+  @return  Bus timing value that should be set on link\r
+**/\r
+SD_MMC_BUS_MODE\r
+EmmcGetTargetBusTiming (\r
+  IN SD_MMC_HC_PRIVATE_DATA  *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN EMMC_EXT_CSD             *ExtCsd\r
+  )\r
+{\r
+  SD_MMC_BUS_MODE  BusTiming;\r
+\r
+  //\r
+  // We start with highest bus timing that this driver currently supports and\r
+  // return as soon as we find supported timing.\r
+  //\r
+  BusTiming = SdMmcMmcHs400;\r
+  while (BusTiming > SdMmcMmcLegacy) {\r
+    if (EmmcIsBusTimingSupported (Private, SlotIndex, ExtCsd, BusTiming)) {\r
+      break;\r
+    }\r
+    BusTiming--;\r
+  }\r
+\r
+  return BusTiming;\r
+}\r
+\r
+/**\r
+  Check if the passed bus width is supported by controller and card.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] BusTiming  Bus timing set on the link\r
+  @param[in] BusWidth   Bus width to check\r
+\r
+  @retval TRUE   Passed bus width is supported in current bus configuration\r
+  @retval FALSE  Passed bus width is not supported in current bus configuration\r
+**/\r
+BOOLEAN\r
+EmmcIsBusWidthSupported (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN SD_MMC_BUS_MODE          BusTiming,\r
+  IN UINT16                   BusWidth\r
+  )\r
+{\r
+  if (BusWidth == 8 && Private->Capability[SlotIndex].BusWidth8 != 0) {\r
+    return TRUE;\r
+  } else if (BusWidth == 4 && BusTiming != SdMmcMmcHs400) {\r
+    return TRUE;\r
+  } else if (BusWidth == 1 && (BusTiming == SdMmcMmcHsSdr || BusTiming == SdMmcMmcLegacy)) {\r
+    return TRUE;\r
+  }\r
+\r
+  return FALSE;\r
+}\r
+\r
+/**\r
+  Get the target bus width to be set on the bus.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] ExtCsd     Pointer to card's extended CSD\r
+  @param[in] BusTiming  Bus timing set on the bus\r
+\r
+  @return Bus width to be set on the bus\r
+**/\r
+UINT8\r
+EmmcGetTargetBusWidth (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN EMMC_EXT_CSD             *ExtCsd,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  UINT8  BusWidth;\r
+  UINT8  PreferredBusWidth;\r
+\r
+  PreferredBusWidth = Private->Slot[SlotIndex].OperatingParameters.BusWidth;\r
+\r
+  if (PreferredBusWidth != EDKII_SD_MMC_BUS_WIDTH_IGNORE &&\r
+      EmmcIsBusWidthSupported (Private, SlotIndex, BusTiming, PreferredBusWidth)) {\r
+    BusWidth = PreferredBusWidth;\r
+  } else if (EmmcIsBusWidthSupported (Private, SlotIndex, BusTiming, 8)) {\r
+    BusWidth = 8;\r
+  } else if (EmmcIsBusWidthSupported (Private, SlotIndex, BusTiming, 4)) {\r
+    BusWidth = 4;\r
+  } else {\r
+    BusWidth = 1;\r
+  }\r
+\r
+  return BusWidth;\r
+}\r
+\r
+/**\r
+  Get the target clock frequency to be set on the bus.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] ExtCsd     Pointer to card's extended CSD\r
+  @param[in] BusTiming  Bus timing to be set on the bus\r
+\r
+  @return Value of the clock frequency to be set on bus in MHz\r
+**/\r
+UINT32\r
+EmmcGetTargetClockFreq (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN EMMC_EXT_CSD             *ExtCsd,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  UINT32 PreferredClockFreq;\r
+  UINT32 MaxClockFreq;\r
+\r
+  PreferredClockFreq = Private->Slot[SlotIndex].OperatingParameters.ClockFreq;\r
+\r
+  switch (BusTiming) {\r
+    case SdMmcMmcHs400:\r
+    case SdMmcMmcHs200:\r
+      MaxClockFreq = 200;\r
+      break;\r
+    case SdMmcMmcHsSdr:\r
+    case SdMmcMmcHsDdr:\r
+      MaxClockFreq = 52;\r
+      break;\r
+    default:\r
+      MaxClockFreq = 26;\r
+      break;\r
+  }\r
+\r
+  if (PreferredClockFreq != EDKII_SD_MMC_CLOCK_FREQ_IGNORE && PreferredClockFreq < MaxClockFreq) {\r
+    return PreferredClockFreq;\r
+  } else {\r
+    return MaxClockFreq;\r
+  }\r
+}\r
+\r
+/**\r
+  Get the driver strength to be set on bus.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] ExtCsd     Pointer to card's extended CSD\r
+  @param[in] BusTiming  Bus timing set on the bus\r
+\r
+  @return Value of the driver strength to be set on the bus\r
+**/\r
+EDKII_SD_MMC_DRIVER_STRENGTH\r
+EmmcGetTargetDriverStrength (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN EMMC_EXT_CSD             *ExtCsd,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  EDKII_SD_MMC_DRIVER_STRENGTH  PreferredDriverStrength;\r
+  EDKII_SD_MMC_DRIVER_STRENGTH  DriverStrength;\r
+\r
+  PreferredDriverStrength = Private->Slot[SlotIndex].OperatingParameters.DriverStrength;\r
+  DriverStrength.Emmc = EmmcDriverStrengthType0;\r
+\r
+  if (PreferredDriverStrength.Emmc != EDKII_SD_MMC_DRIVER_STRENGTH_IGNORE &&\r
+      (ExtCsd->DriverStrength & (BIT0 << PreferredDriverStrength.Emmc))) {\r
+    DriverStrength.Emmc = PreferredDriverStrength.Emmc;\r
+  }\r
+\r
+  return DriverStrength;\r
+}\r
+\r
+/**\r
+  Get the target settings for the bus mode.\r
+\r
+  @param[in]  Private    Pointer to controller private data\r
+  @param[in]  SlotIndex  Index of the slot in the controller\r
+  @param[in]  ExtCsd     Pointer to card's extended CSD\r
+  @param[out] BusMode    Target configuration of the bus\r
+**/\r
+VOID\r
+EmmcGetTargetBusMode (\r
+  IN SD_MMC_HC_PRIVATE_DATA  *Private,\r
+  IN UINT8                   SlotIndex,\r
+  IN EMMC_EXT_CSD            *ExtCsd,\r
+  OUT SD_MMC_BUS_SETTINGS    *BusMode\r
+  )\r
+{\r
+  BusMode->BusTiming = EmmcGetTargetBusTiming (Private, SlotIndex, ExtCsd);\r
+  BusMode->BusWidth = EmmcGetTargetBusWidth (Private, SlotIndex, ExtCsd, BusMode->BusTiming);\r
+  BusMode->ClockFreq = EmmcGetTargetClockFreq (Private, SlotIndex, ExtCsd, BusMode->BusTiming);\r
+  BusMode->DriverStrength = EmmcGetTargetDriverStrength (Private, SlotIndex, ExtCsd, BusMode->BusTiming);\r
 }\r
 \r
 /**\r
@@ -983,10 +1253,7 @@ EmmcSetBusMode (
   EFI_STATUS                    Status;\r
   EMMC_CSD                      Csd;\r
   EMMC_EXT_CSD                  ExtCsd;\r
-  UINT8                         HsTiming;\r
-  BOOLEAN                       IsDdr;\r
-  UINT32                        ClockFreq;\r
-  UINT8                         BusWidth;\r
+  SD_MMC_BUS_SETTINGS           BusMode;\r
   SD_MMC_HC_PRIVATE_DATA        *Private;\r
 \r
   Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru);\r
@@ -1004,85 +1271,30 @@ EmmcSetBusMode (
   }\r
 \r
   ASSERT (Private->BaseClkFreq[Slot] != 0);\r
+\r
   //\r
-  // Check if the Host Controller support 8bits bus width.\r
-  //\r
-  if (Private->Capability[Slot].BusWidth8 != 0) {\r
-    BusWidth = 8;\r
-  } else {\r
-    BusWidth = 4;\r
-  }\r
-  //\r
-  // Get Deivce_Type from EXT_CSD register.\r
+  // Get Device_Type from EXT_CSD register.\r
   //\r
   Status = EmmcGetExtCsd (PassThru, Slot, &ExtCsd);\r
   if (EFI_ERROR (Status)) {\r
     DEBUG ((DEBUG_ERROR, "EmmcSetBusMode: GetExtCsd fails with %r\n", Status));\r
     return Status;\r
   }\r
-  //\r
-  // Calculate supported bus speed/bus width/clock frequency.\r
-  //\r
-  HsTiming  = 0;\r
-  IsDdr     = FALSE;\r
-  ClockFreq = 0;\r
-  if (((ExtCsd.DeviceType & (BIT4 | BIT5))  != 0) && (Private->Capability[Slot].Sdr104 != 0)) {\r
-    HsTiming  = 2;\r
-    IsDdr     = FALSE;\r
-    ClockFreq = 200;\r
-  } else if (((ExtCsd.DeviceType & (BIT2 | BIT3))  != 0) && (Private->Capability[Slot].Ddr50 != 0)) {\r
-    HsTiming  = 1;\r
-    IsDdr     = TRUE;\r
-    ClockFreq = 52;\r
-  } else if (((ExtCsd.DeviceType & BIT1)  != 0) && (Private->Capability[Slot].HighSpeed != 0)) {\r
-    HsTiming  = 1;\r
-    IsDdr     = FALSE;\r
-    ClockFreq = 52;\r
-  } else if (((ExtCsd.DeviceType & BIT0)  != 0) && (Private->Capability[Slot].HighSpeed != 0)) {\r
-    HsTiming  = 1;\r
-    IsDdr     = FALSE;\r
-    ClockFreq = 26;\r
-  }\r
-  //\r
-  // Check if both of the device and the host controller support HS400 DDR mode.\r
-  //\r
-  if (((ExtCsd.DeviceType & (BIT6 | BIT7))  != 0) && (Private->Capability[Slot].Hs400 != 0)) {\r
-    //\r
-    // The host controller supports 8bits bus.\r
-    //\r
-    ASSERT (BusWidth == 8);\r
-    HsTiming  = 3;\r
-    IsDdr     = TRUE;\r
-    ClockFreq = 200;\r
-  }\r
 \r
-  if ((ClockFreq == 0) || (HsTiming == 0)) {\r
-    //\r
-    // Continue using default setting.\r
-    //\r
-    return EFI_SUCCESS;\r
-  }\r
+  EmmcGetTargetBusMode (Private, Slot, &ExtCsd, &BusMode);\r
 \r
-  DEBUG ((DEBUG_INFO, "EmmcSetBusMode: HsTiming %d ClockFreq %d BusWidth %d Ddr %a\n", HsTiming, ClockFreq, BusWidth, IsDdr ? "TRUE":"FALSE"));\r
+  DEBUG ((DEBUG_INFO, "EmmcSetBusMode: Target bus mode: timing = %d, width = %d, clock freq = %d, driver strength = %d\n",\r
+                          BusMode.BusTiming, BusMode.BusWidth, BusMode.ClockFreq, BusMode.DriverStrength.Emmc));\r
 \r
-  if (HsTiming == 3) {\r
-    //\r
-    // Execute HS400 timing switch procedure\r
-    //\r
-    Status = EmmcSwitchToHS400 (PciIo, PassThru, Slot, Rca, ClockFreq);\r
-  } else if (HsTiming == 2) {\r
-    //\r
-    // Execute HS200 timing switch procedure\r
-    //\r
-    Status = EmmcSwitchToHS200 (PciIo, PassThru, Slot, Rca, ClockFreq, BusWidth);\r
+  if (BusMode.BusTiming == SdMmcMmcHs400) {\r
+    Status = EmmcSwitchToHS400 (PciIo, PassThru, Slot, Rca, &BusMode);\r
+  } else if (BusMode.BusTiming == SdMmcMmcHs200) {\r
+    Status = EmmcSwitchToHS200 (PciIo, PassThru, Slot, Rca, &BusMode);\r
   } else {\r
-    //\r
-    // Execute High Speed timing switch procedure\r
-    //\r
-    Status = EmmcSwitchToHighSpeed (PciIo, PassThru, Slot, Rca, ClockFreq, IsDdr, BusWidth);\r
+    Status = EmmcSwitchToHighSpeed (PciIo, PassThru, Slot, Rca, &BusMode);\r
   }\r
 \r
-  DEBUG ((DEBUG_INFO, "EmmcSetBusMode: Switch to %a %r\n", (HsTiming == 3) ? "HS400" : ((HsTiming == 2) ? "HS200" : "HighSpeed"), Status));\r
+  DEBUG ((DEBUG_INFO, "EmmcSetBusMode: Switch to %a %r\n", (BusMode.BusTiming == SdMmcMmcHs400) ? "HS400" : ((BusMode.BusTiming == SdMmcMmcHs200) ? "HS200" : "HighSpeed"), Status));\r
 \r
   return Status;\r
 }\r
index 17936a54927ada89ee7ac2a74816c03f023e4dbe..336baade9e58070c140395500c5cc9cbac77900e 100644 (file)
@@ -313,10 +313,6 @@ SdCardSetRca (
   return Status;\r
 }\r
 \r
-\r
-\r
-\r
-\r
 /**\r
   Send command SELECT_DESELECT_CARD to the SD device to select/deselect it.\r
 \r
@@ -472,14 +468,14 @@ SdCardSetBusWidth (
 \r
   Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
 \r
-  @param[in]  PassThru      A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
-  @param[in]  Slot          The slot number of the SD card to send the command to.\r
-  @param[in]  AccessMode    The value for access mode group.\r
-  @param[in]  CommandSystem The value for command set group.\r
-  @param[in]  DriveStrength The value for drive length group.\r
-  @param[in]  PowerLimit    The value for power limit group.\r
-  @param[in]  Mode          Switch or check function.\r
-  @param[out] SwitchResp    The return switch function status.\r
+  @param[in]  PassThru       A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
+  @param[in]  Slot           The slot number of the SD card to send the command to.\r
+  @param[in]  BusTiming      Target bus timing based on which access group value will be set.\r
+  @param[in]  CommandSystem  The value for command set group.\r
+  @param[in]  DriverStrength The value for driver strength group.\r
+  @param[in]  PowerLimit     The value for power limit group.\r
+  @param[in]  Mode           Switch or check function.\r
+  @param[out] SwitchResp     The return switch function status.\r
 \r
   @retval EFI_SUCCESS       The operation is done correctly.\r
   @retval Others            The operation fails.\r
@@ -489,9 +485,9 @@ EFI_STATUS
 SdCardSwitch (\r
   IN     EFI_SD_MMC_PASS_THRU_PROTOCOL  *PassThru,\r
   IN     UINT8                          Slot,\r
-  IN     UINT8                          AccessMode,\r
+  IN     SD_MMC_BUS_MODE                BusTiming,\r
   IN     UINT8                          CommandSystem,\r
-  IN     UINT8                          DriveStrength,\r
+  IN     SD_DRIVER_STRENGTH_TYPE        DriverStrength,\r
   IN     UINT8                          PowerLimit,\r
   IN     BOOLEAN                        Mode,\r
      OUT UINT8                          *SwitchResp\r
@@ -502,6 +498,7 @@ SdCardSwitch (
   EFI_SD_MMC_PASS_THRU_COMMAND_PACKET   Packet;\r
   EFI_STATUS                            Status;\r
   UINT32                                ModeValue;\r
+  UINT8                                 AccessMode;\r
 \r
   ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
   ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
@@ -516,14 +513,49 @@ SdCardSwitch (
   SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
 \r
   ModeValue = Mode ? BIT31 : 0;\r
-  SdMmcCmdBlk.CommandArgument = (AccessMode & 0xF) | ((PowerLimit & 0xF) << 4) | \\r
-                                ((DriveStrength & 0xF) << 8) | ((DriveStrength & 0xF) << 12) | \\r
+\r
+  switch (BusTiming) {\r
+    case SdMmcUhsDdr50:\r
+      AccessMode = 0x4;\r
+      break;\r
+    case SdMmcUhsSdr104:\r
+      AccessMode = 0x3;\r
+      break;\r
+    case SdMmcUhsSdr50:\r
+      AccessMode = 0x2;\r
+      break;\r
+    case SdMmcUhsSdr25:\r
+    case SdMmcSdHs:\r
+      AccessMode = 0x1;\r
+      break;\r
+    case SdMmcUhsSdr12:\r
+    case SdMmcSdDs:\r
+      AccessMode = 0;\r
+      break;\r
+    default:\r
+      AccessMode = 0xF;\r
+  }\r
+\r
+  SdMmcCmdBlk.CommandArgument = (AccessMode & 0xF) | ((CommandSystem & 0xF) << 4) | \\r
+                                ((DriverStrength & 0xF) << 8) | ((PowerLimit & 0xF) << 12) | \\r
                                 ModeValue;\r
 \r
   Packet.InDataBuffer     = SwitchResp;\r
   Packet.InTransferLength = 64;\r
 \r
   Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
+  if (EFI_ERROR (Status)) {\r
+    return Status;\r
+  }\r
+\r
+  if (Mode) {\r
+    if ((((AccessMode & 0xF) != 0xF) && ((SwitchResp[16] & 0xF) != AccessMode)) ||\r
+        (((CommandSystem & 0xF) != 0xF) && (((SwitchResp[16] >> 4) & 0xF) != CommandSystem)) ||\r
+        (((DriverStrength & 0xF) != 0xF) && ((SwitchResp[15] & 0xF) != DriverStrength)) ||\r
+        (((PowerLimit & 0xF) != 0xF) && (((SwitchResp[15] >> 4) & 0xF) != PowerLimit))) {\r
+      return EFI_DEVICE_ERROR;\r
+    }\r
+  }\r
 \r
   return Status;\r
 }\r
@@ -748,6 +780,273 @@ SdCardSwitchBusWidth (
   return Status;\r
 }\r
 \r
+/**\r
+  Check if passed BusTiming is supported in both controller and card.\r
+\r
+  @param[in] Private                  Pointer to controller private data\r
+  @param[in] SlotIndex                Index of the slot in the controller\r
+  @param[in] CardSupportedBusTimings  Bitmask indicating which bus timings are supported by card\r
+  @param[in] IsInUhsI                 Flag indicating if link is in UHS-I\r
+\r
+  @retval TRUE  Both card and controller support given BusTiming\r
+  @retval FALSE Card or controller doesn't support given BusTiming\r
+**/\r
+BOOLEAN\r
+SdIsBusTimingSupported (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN UINT8                    CardSupportedBusTimings,\r
+  IN BOOLEAN                  IsInUhsI,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  SD_MMC_HC_SLOT_CAP           *Capability;\r
+\r
+  Capability = &Private->Capability[SlotIndex];\r
+\r
+  if (IsInUhsI) {\r
+    switch (BusTiming) {\r
+      case SdMmcUhsSdr104:\r
+        if ((Capability->Sdr104 != 0) && ((CardSupportedBusTimings & BIT3) != 0)) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      case SdMmcUhsDdr50:\r
+        if ((Capability->Ddr50 != 0) && ((CardSupportedBusTimings & BIT4) != 0)) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      case SdMmcUhsSdr50:\r
+        if ((Capability->Sdr50 != 0) && ((CardSupportedBusTimings & BIT2) != 0)) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      case SdMmcUhsSdr25:\r
+        if ((CardSupportedBusTimings & BIT1) != 0) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      case SdMmcUhsSdr12:\r
+        if ((CardSupportedBusTimings & BIT0) != 0) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      default:\r
+        break;\r
+    }\r
+  } else {\r
+    switch (BusTiming) {\r
+      case SdMmcSdHs:\r
+        if ((Capability->HighSpeed != 0) && (CardSupportedBusTimings & BIT1) != 0) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      case SdMmcSdDs:\r
+        if ((CardSupportedBusTimings & BIT0) != 0) {\r
+          return TRUE;\r
+        }\r
+        break;\r
+      default:\r
+        break;\r
+    }\r
+  }\r
+\r
+  return FALSE;\r
+}\r
+\r
+/**\r
+  Get the target bus timing to set on the link. This function\r
+  will try to select highest bus timing supported by card, controller\r
+  and the driver.\r
+\r
+  @param[in] Private                  Pointer to controller private data\r
+  @param[in] SlotIndex                Index of the slot in the controller\r
+  @param[in] CardSupportedBusTimings  Bitmask indicating which bus timings are supported by card\r
+  @param[in] IsInUhsI                 Flag indicating if link is in UHS-I\r
+\r
+  @return  Bus timing value that should be set on link\r
+**/\r
+SD_MMC_BUS_MODE\r
+SdGetTargetBusTiming (\r
+  IN SD_MMC_HC_PRIVATE_DATA  *Private,\r
+  IN UINT8                   SlotIndex,\r
+  IN UINT8                   CardSupportedBusTimings,\r
+  IN BOOLEAN                 IsInUhsI\r
+  )\r
+{\r
+  SD_MMC_BUS_MODE  BusTiming;\r
+\r
+  if (IsInUhsI) {\r
+    BusTiming = SdMmcUhsSdr104;\r
+  } else {\r
+    BusTiming = SdMmcSdHs;\r
+  }\r
+\r
+  while (BusTiming > SdMmcSdDs) {\r
+    if (SdIsBusTimingSupported (Private, SlotIndex, CardSupportedBusTimings, IsInUhsI, BusTiming)) {\r
+      break;\r
+    }\r
+    BusTiming--;\r
+  }\r
+\r
+  return BusTiming;\r
+}\r
+\r
+/**\r
+  Get the target bus width to be set on the bus.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] BusTiming  Bus timing set on the bus\r
+\r
+  @return Bus width to be set on the bus\r
+**/\r
+UINT8\r
+SdGetTargetBusWidth (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  UINT8  BusWidth;\r
+  UINT8  PreferredBusWidth;\r
+\r
+  PreferredBusWidth = Private->Slot[SlotIndex].OperatingParameters.BusWidth;\r
+\r
+  if (BusTiming == SdMmcSdDs || BusTiming == SdMmcSdHs) {\r
+    if (PreferredBusWidth != EDKII_SD_MMC_BUS_WIDTH_IGNORE &&\r
+        (PreferredBusWidth == 1 || PreferredBusWidth == 4)) {\r
+      BusWidth = PreferredBusWidth;\r
+    } else {\r
+      BusWidth = 4;\r
+    }\r
+  } else {\r
+    //\r
+    // UHS-I modes support only 4-bit width.\r
+    // Switch to 4-bit has been done before calling this function anyway so\r
+    // this is purely informational.\r
+    //\r
+    BusWidth = 4;\r
+  }\r
+\r
+  return BusWidth;\r
+}\r
+\r
+/**\r
+  Get the target clock frequency to be set on the bus.\r
+\r
+  @param[in] Private    Pointer to controller private data\r
+  @param[in] SlotIndex  Index of the slot in the controller\r
+  @param[in] BusTiming  Bus timing to be set on the bus\r
+\r
+  @return Value of the clock frequency to be set on bus in MHz\r
+**/\r
+UINT32\r
+SdGetTargetBusClockFreq (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  UINT32 PreferredClockFreq;\r
+  UINT32 MaxClockFreq;\r
+\r
+  PreferredClockFreq = Private->Slot[SlotIndex].OperatingParameters.ClockFreq;\r
+\r
+  switch (BusTiming) {\r
+    case SdMmcUhsSdr104:\r
+      MaxClockFreq = 208;\r
+      break;\r
+    case SdMmcUhsSdr50:\r
+      MaxClockFreq = 100;\r
+      break;\r
+    case SdMmcUhsDdr50:\r
+    case SdMmcUhsSdr25:\r
+    case SdMmcSdHs:\r
+      MaxClockFreq = 50;\r
+      break;\r
+    case SdMmcUhsSdr12:\r
+    case SdMmcSdDs:\r
+    default:\r
+      MaxClockFreq = 25;\r
+  }\r
+\r
+  if (PreferredClockFreq != EDKII_SD_MMC_CLOCK_FREQ_IGNORE && PreferredClockFreq < MaxClockFreq) {\r
+    return PreferredClockFreq;\r
+  } else {\r
+    return MaxClockFreq;\r
+  }\r
+}\r
+\r
+/**\r
+  Get the driver strength to be set on bus.\r
+\r
+  @param[in] Private                       Pointer to controller private data\r
+  @param[in] SlotIndex                     Index of the slot in the controller\r
+  @param[in] CardSupportedDriverStrengths  Bitmask indicating which driver strengths are supported on the card\r
+  @param[in] BusTiming                     Bus timing set on the bus\r
+\r
+  @return Value of the driver strength to be set on the bus\r
+**/\r
+EDKII_SD_MMC_DRIVER_STRENGTH\r
+SdGetTargetDriverStrength (\r
+  IN SD_MMC_HC_PRIVATE_DATA   *Private,\r
+  IN UINT8                    SlotIndex,\r
+  IN UINT8                    CardSupportedDriverStrengths,\r
+  IN SD_MMC_BUS_MODE          BusTiming\r
+  )\r
+{\r
+  EDKII_SD_MMC_DRIVER_STRENGTH  PreferredDriverStrength;\r
+  EDKII_SD_MMC_DRIVER_STRENGTH  DriverStrength;\r
+\r
+  if (BusTiming == SdMmcSdDs || BusTiming == SdMmcSdHs) {\r
+    DriverStrength.Sd = SdDriverStrengthIgnore;\r
+    return DriverStrength;\r
+  }\r
+\r
+  PreferredDriverStrength = Private->Slot[SlotIndex].OperatingParameters.DriverStrength;\r
+  DriverStrength.Sd = SdDriverStrengthTypeB;\r
+\r
+  if (PreferredDriverStrength.Sd != EDKII_SD_MMC_DRIVER_STRENGTH_IGNORE &&\r
+      (CardSupportedDriverStrengths & (BIT0 << PreferredDriverStrength.Sd))) {\r
+\r
+    if ((PreferredDriverStrength.Sd == SdDriverStrengthTypeA &&\r
+        (Private->Capability[SlotIndex].DriverTypeA != 0)) ||\r
+        (PreferredDriverStrength.Sd == SdDriverStrengthTypeC &&\r
+        (Private->Capability[SlotIndex].DriverTypeC != 0)) ||\r
+        (PreferredDriverStrength.Sd == SdDriverStrengthTypeD &&\r
+        (Private->Capability[SlotIndex].DriverTypeD != 0))) {\r
+      DriverStrength.Sd = PreferredDriverStrength.Sd;\r
+    }\r
+  }\r
+\r
+  return DriverStrength;\r
+}\r
+\r
+/**\r
+  Get the target settings for the bus mode.\r
+\r
+  @param[in]  Private          Pointer to controller private data\r
+  @param[in]  SlotIndex        Index of the slot in the controller\r
+  @param[in]  SwitchQueryResp  Pointer to switch query response\r
+  @param[in]  IsInUhsI         Flag indicating if link is in UHS-I mode\r
+  @param[out] BusMode          Target configuration of the bus\r
+**/\r
+VOID\r
+SdGetTargetBusMode (\r
+  IN SD_MMC_HC_PRIVATE_DATA  *Private,\r
+  IN UINT8                   SlotIndex,\r
+  IN UINT8                   *SwitchQueryResp,\r
+  IN BOOLEAN                 IsInUhsI,\r
+  OUT SD_MMC_BUS_SETTINGS    *BusMode\r
+  )\r
+{\r
+  BusMode->BusTiming = SdGetTargetBusTiming (Private, SlotIndex, SwitchQueryResp[13], IsInUhsI);\r
+  BusMode->BusWidth = SdGetTargetBusWidth (Private, SlotIndex, BusMode->BusTiming);\r
+  BusMode->ClockFreq = SdGetTargetBusClockFreq (Private, SlotIndex, BusMode->BusTiming);\r
+  BusMode->DriverStrength = SdGetTargetDriverStrength (Private, SlotIndex, SwitchQueryResp[9], BusMode->BusTiming);\r
+}\r
+\r
 /**\r
   Switch the high speed timing according to request.\r
 \r
@@ -775,13 +1074,10 @@ SdCardSetBusMode (
 {\r
   EFI_STATUS                   Status;\r
   SD_MMC_HC_SLOT_CAP           *Capability;\r
-  UINT32                       ClockFreq;\r
-  UINT8                        BusWidth;\r
-  UINT8                        AccessMode;\r
   UINT8                        HostCtrl1;\r
   UINT8                        SwitchResp[64];\r
-  SD_MMC_BUS_MODE              Timing;\r
   SD_MMC_HC_PRIVATE_DATA       *Private;\r
+  SD_MMC_BUS_SETTINGS          BusMode;\r
 \r
   Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru);\r
 \r
@@ -792,61 +1088,51 @@ SdCardSetBusMode (
     return Status;\r
   }\r
 \r
-  BusWidth = 4;\r
-\r
-  Status = SdCardSwitchBusWidth (PciIo, PassThru, Slot, Rca, BusWidth);\r
-  if (EFI_ERROR (Status)) {\r
-    return Status;\r
+  if (S18A) {\r
+    //\r
+    // For UHS-I speed modes 4-bit data bus is requiered so we\r
+    // switch here irrespective of platform preference.\r
+    //\r
+    Status = SdCardSwitchBusWidth (PciIo, PassThru, Slot, Rca, 4);\r
+    if (EFI_ERROR (Status)) {\r
+      return Status;\r
+    }\r
   }\r
+\r
   //\r
   // Get the supported bus speed from SWITCH cmd return data group #1.\r
   //\r
-  Status = SdCardSwitch (PassThru, Slot, 0xF, 0xF, 0xF, 0xF, FALSE, SwitchResp);\r
+  Status = SdCardSwitch (PassThru, Slot, 0xFF, 0xF, SdDriverStrengthIgnore, 0xF, FALSE, SwitchResp);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
-  //\r
-  // Calculate supported bus speed/bus width/clock frequency by host and device capability.\r
-  //\r
-  ClockFreq = 0;\r
-  if (S18A && (Capability->Sdr104 != 0) && ((SwitchResp[13] & BIT3) != 0)) {\r
-    ClockFreq = 208;\r
-    AccessMode = 3;\r
-    Timing = SdMmcUhsSdr104;\r
-  } else if (S18A && (Capability->Sdr50 != 0) && ((SwitchResp[13] & BIT2) != 0)) {\r
-    ClockFreq = 100;\r
-    AccessMode = 2;\r
-    Timing = SdMmcUhsSdr50;\r
-  } else if (S18A && (Capability->Ddr50 != 0) && ((SwitchResp[13] & BIT4) != 0)) {\r
-    ClockFreq = 50;\r
-    AccessMode = 4;\r
-    Timing = SdMmcUhsDdr50;\r
-  } else if ((SwitchResp[13] & BIT1) != 0) {\r
-    ClockFreq = 50;\r
-    AccessMode = 1;\r
-    Timing = SdMmcUhsSdr25;\r
-  } else {\r
-    ClockFreq = 25;\r
-    AccessMode = 0;\r
-    Timing = SdMmcUhsSdr12;\r
+\r
+  SdGetTargetBusMode (Private, Slot, SwitchResp, S18A, &BusMode);\r
+\r
+  DEBUG ((DEBUG_INFO, "SdCardSetBusMode: Target bus mode: bus timing = %d, bus width = %d, clock freq[MHz] = %d, driver strength = %d\n",\r
+                         BusMode.BusTiming, BusMode.BusWidth, BusMode.ClockFreq, BusMode.DriverStrength.Sd));\r
+\r
+  if (!S18A) {\r
+    Status = SdCardSwitchBusWidth (PciIo, PassThru, Slot, Rca, BusMode.BusWidth);\r
+    if (EFI_ERROR (Status)) {\r
+      return Status;\r
+    }\r
   }\r
 \r
-  Status = SdCardSwitch (PassThru, Slot, AccessMode, 0xF, 0xF, 0xF, TRUE, SwitchResp);\r
+  Status = SdCardSwitch (PassThru, Slot, BusMode.BusTiming, 0xF, BusMode.DriverStrength.Sd, 0xF, TRUE, SwitchResp);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
 \r
-  if ((SwitchResp[16] & 0xF) != AccessMode) {\r
-    DEBUG ((DEBUG_ERROR, "SdCardSetBusMode: Switch to AccessMode %d ClockFreq %d BusWidth %d fails! The Switch response is 0x%1x\n", AccessMode, ClockFreq, BusWidth, SwitchResp[16] & 0xF));\r
-    return EFI_DEVICE_ERROR;\r
+  Status = SdMmcSetDriverStrength (Private->PciIo, Slot, BusMode.DriverStrength.Sd);\r
+  if (EFI_ERROR (Status)) {\r
+    return Status;\r
   }\r
 \r
-  DEBUG ((DEBUG_INFO, "SdCardSetBusMode: Switch to AccessMode %d ClockFreq %d BusWidth %d\n", AccessMode, ClockFreq, BusWidth));\r
-\r
   //\r
-  // Set to Hight Speed timing\r
+  // Set to High Speed timing\r
   //\r
-  if (AccessMode == 1) {\r
+  if (BusMode.BusTiming == SdMmcSdHs) {\r
     HostCtrl1 = BIT2;\r
     Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL1, sizeof (HostCtrl1), &HostCtrl1);\r
     if (EFI_ERROR (Status)) {\r
@@ -854,12 +1140,12 @@ SdCardSetBusMode (
     }\r
   }\r
 \r
-  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, Timing);\r
+  Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, BusMode.BusTiming);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
 \r
-  Status = SdMmcHcClockSupply (PciIo, Slot, ClockFreq * 1000, Private->BaseClkFreq[Slot], Private->ControllerVersion[Slot]);\r
+  Status = SdMmcHcClockSupply (PciIo, Slot, BusMode.ClockFreq * 1000, Private->BaseClkFreq[Slot], Private->ControllerVersion[Slot]);\r
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
@@ -869,7 +1155,7 @@ SdCardSetBusMode (
                           Private->ControllerHandle,\r
                           Slot,\r
                           EdkiiSdMmcSwitchClockFreqPost,\r
-                          &Timing\r
+                          &BusMode.BusTiming\r
                           );\r
     if (EFI_ERROR (Status)) {\r
       DEBUG ((\r
@@ -882,7 +1168,7 @@ SdCardSetBusMode (
     }\r
   }\r
 \r
-  if ((AccessMode == 3) || ((AccessMode == 2) && (Capability->TuningSDR50 != 0))) {\r
+  if ((BusMode.BusTiming == SdMmcUhsSdr104) || ((BusMode.BusTiming == SdMmcUhsSdr50) && (Capability->TuningSDR50 != 0))) {\r
     Status = SdCardTuningClock (PciIo, PassThru, Slot);\r
     if (EFI_ERROR (Status)) {\r
       return Status;\r
index 4881ee44ccb791252be2ff247497e3010440465e..373f1bed45a11cf29f45a99e6812350731d6b5be 100644 (file)
@@ -28,6 +28,11 @@ EFI_DRIVER_BINDING_PROTOCOL gSdMmcPciHcDriverBinding = {
   NULL\r
 };\r
 \r
+#define SLOT_INIT_TEMPLATE {0, UnknownSlot, 0, 0, 0, \\r
+                               {EDKII_SD_MMC_BUS_WIDTH_IGNORE,\\r
+                               EDKII_SD_MMC_CLOCK_FREQ_IGNORE,\\r
+                               {EDKII_SD_MMC_DRIVER_STRENGTH_IGNORE}}}\r
+\r
 //\r
 // Template for SD/MMC host controller private data.\r
 //\r
@@ -50,8 +55,12 @@ SD_MMC_HC_PRIVATE_DATA gSdMmcPciHcTemplate = {
                                     // Queue\r
   INITIALIZE_LIST_HEAD_VARIABLE (gSdMmcPciHcTemplate.Queue),\r
   {                                 // Slot\r
-    {0, UnknownSlot, 0, 0, 0}, {0, UnknownSlot, 0, 0, 0}, {0, UnknownSlot, 0, 0, 0},\r
-    {0, UnknownSlot, 0, 0, 0}, {0, UnknownSlot, 0, 0, 0}, {0, UnknownSlot, 0, 0, 0}\r
+    SLOT_INIT_TEMPLATE,\r
+    SLOT_INIT_TEMPLATE,\r
+    SLOT_INIT_TEMPLATE,\r
+    SLOT_INIT_TEMPLATE,\r
+    SLOT_INIT_TEMPLATE,\r
+    SLOT_INIT_TEMPLATE\r
   },\r
   {                                 // Capability\r
     {0},\r
@@ -328,6 +337,7 @@ SdMmcPciHcEnumerateDevice (
 \r
   return;\r
 }\r
+\r
 /**\r
   Tests to see if this driver supports a given controller. If a child device is provided,\r
   it further tests to see if this driver supports creating a handle for the specified child device.\r
@@ -619,7 +629,6 @@ SdMmcPciHcDriverBindingStart (
   Support64BitDma = TRUE;\r
   for (Slot = FirstBar; Slot < (FirstBar + SlotNum); Slot++) {\r
     Private->Slot[Slot].Enable = TRUE;\r
-\r
     //\r
     // Get SD/MMC Pci Host Controller Version\r
     //\r
@@ -635,19 +644,34 @@ SdMmcPciHcDriverBindingStart (
 \r
     Private->BaseClkFreq[Slot] = Private->Capability[Slot].BaseClkFreq;\r
 \r
-    if (mOverride != NULL && mOverride->Capability != NULL) {\r
-      Status = mOverride->Capability (\r
-                            Controller,\r
-                            Slot,\r
-                            &Private->Capability[Slot],\r
-                            &Private->BaseClkFreq[Slot]\r
-                            );\r
-      if (EFI_ERROR (Status)) {\r
-        DEBUG ((DEBUG_WARN, "%a: Failed to override capability - %r\n",\r
-          __FUNCTION__, Status));\r
-        continue;\r
+    if (mOverride != NULL) {\r
+      if (mOverride->Capability != NULL) {\r
+        Status = mOverride->Capability (\r
+                              Controller,\r
+                              Slot,\r
+                              &Private->Capability[Slot],\r
+                              &Private->BaseClkFreq[Slot]\r
+                              );\r
+        if (EFI_ERROR (Status)) {\r
+          DEBUG ((DEBUG_WARN, "%a: Failed to override capability - %r\n",\r
+            __FUNCTION__, Status));\r
+          continue;\r
+        }\r
+      }\r
+\r
+      if (mOverride->NotifyPhase != NULL) {\r
+        Status = mOverride->NotifyPhase (\r
+                              Controller,\r
+                              Slot,\r
+                              EdkiiSdMmcGetOperatingParam,\r
+                              (VOID*)&Private->Slot[Slot].OperatingParameters\r
+                              );\r
+        if (EFI_ERROR (Status)) {\r
+          DEBUG ((DEBUG_WARN, "%a: Failed to get operating parameters, using defaults\n", __FUNCTION__));\r
+        }\r
       }\r
     }\r
+\r
     DumpCapabilityReg (Slot, &Private->Capability[Slot]);\r
     DEBUG ((\r
       DEBUG_INFO,\r
index 77bbf83b76519919d0422dc4d400bdf5fd7a1d2b..c29e48767ec70b69ef162737e1cf48a63aabec4e 100644 (file)
@@ -78,11 +78,12 @@ typedef enum {
 } EFI_SD_MMC_SLOT_TYPE;\r
 \r
 typedef struct {\r
-  BOOLEAN                           Enable;\r
-  EFI_SD_MMC_SLOT_TYPE              SlotType;\r
-  BOOLEAN                           MediaPresent;\r
-  BOOLEAN                           Initialized;\r
-  SD_MMC_CARD_TYPE                  CardType;\r
+  BOOLEAN                            Enable;\r
+  EFI_SD_MMC_SLOT_TYPE               SlotType;\r
+  BOOLEAN                            MediaPresent;\r
+  BOOLEAN                            Initialized;\r
+  SD_MMC_CARD_TYPE                   CardType;\r
+  EDKII_SD_MMC_OPERATING_PARAMETERS  OperatingParameters;\r
 } SD_MMC_HC_SLOT;\r
 \r
 typedef struct {\r
@@ -120,6 +121,13 @@ typedef struct {
   UINT32                              BaseClkFreq[SD_MMC_HC_MAX_SLOT];\r
 } SD_MMC_HC_PRIVATE_DATA;\r
 \r
+typedef struct {\r
+  SD_MMC_BUS_MODE               BusTiming;\r
+  UINT8                         BusWidth;\r
+  UINT32                        ClockFreq;\r
+  EDKII_SD_MMC_DRIVER_STRENGTH  DriverStrength;\r
+} SD_MMC_BUS_SETTINGS;\r
+\r
 #define SD_MMC_HC_TRB_SIG             SIGNATURE_32 ('T', 'R', 'B', 'T')\r
 \r
 //\r
index 5d1f977e55d296e82aae112090a8953ff114162a..b9d04e0f17a20d6212860f654b6d78f4eeaefcdb 100644 (file)
@@ -1339,6 +1339,40 @@ SdMmcHcUhsSignaling (
   return EFI_SUCCESS;\r
 }\r
 \r
+/**\r
+  Set driver strength in host controller.\r
+\r
+  @param[in] PciIo           The PCI IO protocol instance.\r
+  @param[in] SlotIndex       The slot index of the card.\r
+  @param[in] DriverStrength  DriverStrength to set in the controller.\r
+\r
+  @retval EFI_SUCCESS  Driver strength programmed successfully.\r
+  @retval Others       Failed to set driver strength.\r
+**/\r
+EFI_STATUS\r
+SdMmcSetDriverStrength (\r
+  IN EFI_PCI_IO_PROTOCOL      *PciIo,\r
+  IN UINT8                    SlotIndex,\r
+  IN SD_DRIVER_STRENGTH_TYPE  DriverStrength\r
+  )\r
+{\r
+  EFI_STATUS  Status;\r
+  UINT16      HostCtrl2;\r
+\r
+  if (DriverStrength == SdDriverStrengthIgnore) {\r
+    return EFI_SUCCESS;\r
+  }\r
+\r
+  HostCtrl2 = (UINT16)~SD_MMC_HC_CTRL_DRIVER_STRENGTH_MASK;\r
+  Status = SdMmcHcAndMmio (PciIo, SlotIndex, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
+  if (EFI_ERROR (Status)) {\r
+    return Status;\r
+  }\r
+\r
+  HostCtrl2 = (DriverStrength << 4) & SD_MMC_HC_CTRL_DRIVER_STRENGTH_MASK;\r
+  return SdMmcHcOrMmio (PciIo, SlotIndex, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
+}\r
+\r
 /**\r
   Turn on/off LED.\r
 \r
index 0b0d41525633434985a9de3d510c5bac9b5e8086..088c70451cd18ffcfaef5f574399cc1989f35b41 100644 (file)
@@ -72,6 +72,8 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
 #define SD_MMC_HC_CTRL_MMC_HS200      0x0003\r
 #define SD_MMC_HC_CTRL_MMC_HS400      0x0005\r
 \r
+#define SD_MMC_HC_CTRL_DRIVER_STRENGTH_MASK  0x0030\r
+\r
 //\r
 // The transfer modes supported by SD Host Controller\r
 //\r
@@ -617,4 +619,21 @@ SdMmcHcUhsSignaling (
   IN SD_MMC_BUS_MODE        Timing\r
   );\r
 \r
+/**\r
+  Set driver strength in host controller.\r
+\r
+  @param[in] PciIo           The PCI IO protocol instance.\r
+  @param[in] SlotIndex       The slot index of the card.\r
+  @param[in] DriverStrength  DriverStrength to set in the controller.\r
+\r
+  @retval EFI_SUCCESS  Driver strength programmed successfully.\r
+  @retval Others       Failed to set driver strength.\r
+**/\r
+EFI_STATUS\r
+SdMmcSetDriverStrength (\r
+  IN EFI_PCI_IO_PROTOCOL      *PciIo,\r
+  IN UINT8                    SlotIndex,\r
+  IN SD_DRIVER_STRENGTH_TYPE  DriverStrength\r
+  );\r
+\r
 #endif\r