EmbeddedPkg/Universal/MmcDxe/MmcBlockIo.c

   1 /** @file
   2 *
   3 *  Copyright (c) 2011-2012, ARM Limited. All rights reserved.
   4 *
   5 *  This program and the accompanying materials
   6 *  are licensed and made available under the terms and conditions of the BSD License
   7 *  which accompanies this distribution.  The full text of the license may be found at
   8 *  http://opensource.org/licenses/bsd-license.php
   9 *
  10 *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11 *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12 *
  13 **/
  14
  15 #include <Protocol/MmcHost.h>
  16 #include <Library/DebugLib.h>
  17 #include <Library/BaseMemoryLib.h>
  18 #include <Library/TimerLib.h>
  19
  20 #include "Mmc.h"
  21
  22 // Untested ...
  23 //#define USE_STREAM
  24
  25 #define MAX_RETRY_COUNT  1000
  26 #define CMD_RETRY_COUNT  20
  27
  28 EFI_STATUS
  29 MmcNotifyState (
  30   IN MMC_HOST_INSTANCE *MmcHostInstance,
  31   IN MMC_STATE State
  32   )
  33 {
  34   MmcHostInstance->State = State;
  35   return MmcHostInstance->MmcHost->NotifyState (MmcHostInstance->MmcHost, State);
  36 }
  37
  38 VOID
  39 PrintOCR (
  40   IN UINT32 Ocr
  41   )
  42 {
  43   UINTN minv;
  44   UINTN maxv;
  45   UINTN volts;
  46   UINTN loop;
  47
  48   minv  = 36;  // 3.6
  49   maxv  = 20;  // 2.0
  50   volts = 20;  // 2.0
  51
  52   // The MMC register bits [23:8] indicate the working range of the card
  53   for (loop = 8; loop < 24; loop++) {
  54     if (Ocr & (1 << loop)) {
  55       if (minv > volts) minv = volts;
  56       if (maxv < volts) maxv = volts + 1;
  57     }
  58     volts = volts + 1;
  59   }
  60
  61   DEBUG((EFI_D_ERROR, "- PrintOCR Ocr (0x%X)\n",Ocr));
  62   DEBUG((EFI_D_ERROR, "\t- Card operating voltage: %d.%d to %d.%d\n", minv/10, minv % 10, maxv/10, maxv % 10));
  63   if (((Ocr >> 29) & 3) == 0) {
  64     DEBUG((EFI_D_ERROR, "\t- AccessMode: Byte Mode\n"));
  65   } else {
  66     DEBUG((EFI_D_ERROR, "\t- AccessMode: Block Mode (0x%X)\n",((Ocr >> 29) & 3)));
  67   }
  68
  69   if (Ocr & MMC_OCR_POWERUP) {
  70     DEBUG((EFI_D_ERROR, "\t- PowerUp\n"));
  71   } else {
  72     DEBUG((EFI_D_ERROR, "\t- Voltage Not Supported\n"));
  73   }
  74 }
  75
  76 VOID PrintCID (
  77   IN UINT32* Cid
  78   )
  79 {
  80   DEBUG((EFI_D_ERROR, "- PrintCID\n"));
  81   DEBUG((EFI_D_ERROR, "\t- Manufacturing date: %d/%d\n",(Cid[0] >> 8) & 0xF,(Cid[0] >> 12) & 0xFF));
  82   DEBUG((EFI_D_ERROR, "\t- Product serial number: 0x%X%X\n",Cid[1] & 0xFFFFFF,(Cid[0] >> 24) & 0xFF));
  83   DEBUG((EFI_D_ERROR, "\t- Product revision: %d\n",Cid[1] >> 24));
  84   //DEBUG((EFI_D_ERROR, "\t- Product name: %s\n",(char*)(Cid + 2)));
  85   DEBUG((EFI_D_ERROR, "\t- OEM ID: %c%c\n",(Cid[3] >> 8) & 0xFF,(Cid[3] >> 16) & 0xFF));
  86 }
  87
  88 #if !defined(MDEPKG_NDEBUG)
  89 CONST CHAR8* mStrUnit[] = { "100kbit/s","1Mbit/s","10Mbit/s","100MBit/s","Unkbown","Unkbown","Unkbown","Unkbown" };
  90 CONST CHAR8* mStrValue[] = { "1.0","1.2","1.3","1.5","2.0","2.5","3.0","3.5","4.0","4.5","5.0","Unknown","Unknown","Unknown","Unknown" };
  91 #endif
  92
  93 VOID
  94 PrintCSD (
  95   IN UINT32* Csd
  96   )
  97 {
  98   UINTN Value;
  99
 100   if (((Csd[2] >> 30) & 0x3) == 0) {
 101     DEBUG((EFI_D_ERROR, "- PrintCSD Version 1.01-1.10/Version 2.00/Standard Capacity\n"));
 102   } else if (((Csd[2] >> 30) & 0x3) == 1) {
 103     DEBUG((EFI_D_ERROR, "- PrintCSD Version 2.00/High Capacity\n"));
 104   } else {
 105     DEBUG((EFI_D_ERROR, "- PrintCSD Version Higher than v3.3\n"));
 106   }
 107
 108   DEBUG((EFI_D_ERROR, "\t- Supported card command class: 0x%X\n",MMC_CSD_GET_CCC(Csd)));
 109   DEBUG((EFI_D_ERROR, "\t- Speed: %a %a\n",mStrValue[(MMC_CSD_GET_TRANSPEED(Csd) >> 3) & 0xF],mStrUnit[MMC_CSD_GET_TRANSPEED(Csd) & 7]));
 110   DEBUG((EFI_D_ERROR, "\t- Maximum Read Data Block: %d\n",2 << (MMC_CSD_GET_READBLLEN(Csd)-1)));
 111   DEBUG((EFI_D_ERROR, "\t- Maximum Write Data Block: %d\n",2 << (MMC_CSD_GET_WRITEBLLEN(Csd)-1)));
 112
 113   if (!MMC_CSD_GET_FILEFORMATGRP(Csd)) {
 114     Value = MMC_CSD_GET_FILEFORMAT(Csd);
 115     if (Value == 0)         DEBUG((EFI_D_ERROR, "\t- Format(0): Hard disk-like file system with partition table\n"));
 116     else if (Value == 1)    DEBUG((EFI_D_ERROR, "\t- Format(1): DOS FAT (floppy-like) with boot sector only (no partition table)\n"));
 117     else if (Value == 2)    DEBUG((EFI_D_ERROR, "\t- Format(2): Universal File Format\n"));
 118     else                    DEBUG((EFI_D_ERROR, "\t- Format(3): Others/Unknown\n"));
 119   } else {
 120     DEBUG((EFI_D_ERROR, "\t- Format: Reserved\n"));
 121   }
 122 }
 123
 124 VOID
 125 PrintRCA (
 126   IN UINT32 Rca
 127   )
 128 {
 129   DEBUG((EFI_D_ERROR, "- PrintRCA: 0x%X\n",Rca));
 130   DEBUG((EFI_D_ERROR, "\t- Status: 0x%X\n",Rca & 0xFFFF));
 131   DEBUG((EFI_D_ERROR, "\t- RCA: 0x%X\n",(Rca >> 16) & 0xFFFF));
 132 }
 133
 134 VOID
 135 PrintResponseR1 (
 136   IN  UINT32 Response
 137   )
 138 {
 139   DEBUG((EFI_D_INFO, "Response: 0x%X\n",Response));
 140   if (Response & MMC_R0_READY_FOR_DATA)     DEBUG((EFI_D_INFO, "\t- READY_FOR_DATA\n"));
 141
 142   if (((Response >> 9) & 0xF) == 0)         DEBUG((EFI_D_INFO, "\t- State: Idle\n"));
 143   else if (((Response >> 9) & 0xF) == 1)    DEBUG((EFI_D_INFO, "\t- State: Ready\n"));
 144   else if (((Response >> 9) & 0xF) == 2)    DEBUG((EFI_D_INFO, "\t- State: Ident\n"));
 145   else if (((Response >> 9) & 0xF) == 3)    DEBUG((EFI_D_INFO, "\t- State: StandBy\n"));
 146   else if (((Response >> 9) & 0xF) == 4)    DEBUG((EFI_D_INFO, "\t- State: Tran\n"));
 147   else if (((Response >> 9) & 0xF) == 5)    DEBUG((EFI_D_INFO, "\t- State: Data\n"));
 148   else if (((Response >> 9) & 0xF) == 6)    DEBUG((EFI_D_INFO, "\t- State: Rcv\n"));
 149   else if (((Response >> 9) & 0xF) == 7)    DEBUG((EFI_D_INFO, "\t- State: Prg\n"));
 150   else if (((Response >> 9) & 0xF) == 8)    DEBUG((EFI_D_INFO, "\t- State: Dis\n"));
 151   else                                      DEBUG((EFI_D_INFO, "\t- State: Reserved\n"));
 152 }
 153
 154 EFI_STATUS
 155 EFIAPI
 156 MmcGetCardStatus(
 157         IN MMC_HOST_INSTANCE     *MmcHostInstance
 158   )
 159 {
 160   EFI_STATUS              Status;
 161   UINT32                  Response[4];
 162   UINTN                   CmdArg;
 163   EFI_MMC_HOST_PROTOCOL   *MmcHost;
 164
 165   Status = EFI_SUCCESS;
 166   MmcHost = MmcHostInstance->MmcHost;
 167   CmdArg = 0;
 168
 169   if (MmcHost == NULL) {
 170     return EFI_INVALID_PARAMETER;
 171   }
 172   if(MmcHostInstance->State != MmcHwInitializationState){
 173     //Get the Status of the card.
 174     CmdArg = MmcHostInstance->CardInfo.RCA << 16;
 175     Status = MmcHost->SendCommand (MmcHost, MMC_CMD13, CmdArg);
 176     if (EFI_ERROR(Status)) {
 177       DEBUG((EFI_D_ERROR, "MmcGetCardStatus(MMC_CMD13): Error and Status = %r\n", Status));
 178       return Status;
 179     }
 180
 181     //Read Response
 182     MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1,Response);
 183     PrintResponseR1(Response[0]);
 184   }
 185
 186   return Status;
 187 }
 188
 189 EFI_STATUS
 190 EFIAPI
 191 MmcIdentificationMode (
 192   IN MMC_HOST_INSTANCE     *MmcHostInstance
 193   )
 194 {
 195   EFI_STATUS              Status;
 196   UINT32                  Response[4];
 197   UINTN                   Timeout;
 198   UINTN                   CmdArg;
 199   BOOLEAN                 IsHCS;
 200   EFI_MMC_HOST_PROTOCOL   *MmcHost;
 201
 202   MmcHost = MmcHostInstance->MmcHost;
 203   CmdArg = 0;
 204   IsHCS = FALSE;
 205
 206   if (MmcHost == NULL) {
 207     return EFI_INVALID_PARAMETER;
 208   }
 209
 210   // We can get into this function if we restart the identification mode
 211   if (MmcHostInstance->State == MmcHwInitializationState) {
 212     // Initialize the MMC Host HW
 213     Status = MmcNotifyState (MmcHostInstance, MmcHwInitializationState);
 214     if (EFI_ERROR(Status)) {
 215       DEBUG((EFI_D_ERROR, "MmcIdentificationMode() : Error MmcHwInitializationState\n"));
 216       return Status;
 217     }
 218   }
 219
 220   Status = MmcHost->SendCommand (MmcHost, MMC_CMD0, 0);
 221   if (EFI_ERROR(Status)) {
 222     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD0): Error\n"));
 223     return Status;
 224   }
 225
 226   Status = MmcNotifyState (MmcHostInstance, MmcIdleState);
 227   if (EFI_ERROR(Status)) {
 228     DEBUG((EFI_D_ERROR, "MmcIdentificationMode() : Error MmcIdleState\n"));
 229     return Status;
 230   }
 231
 232   // Are we using SDIO ?
 233   Status = MmcHost->SendCommand (MmcHost, MMC_CMD5, 0);
 234   if (Status == EFI_SUCCESS) {
 235     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD5): Error - SDIO not supported.\n"));
 236     return EFI_UNSUPPORTED;
 237   }
 238
 239   // Check which kind of card we are using. Ver2.00 or later SD Memory Card (PL180 is SD v1.1)
 240   CmdArg = (0x0UL << 12 | BIT8 | 0xCEUL << 0);
 241   Status = MmcHost->SendCommand (MmcHost, MMC_CMD8, CmdArg);
 242   if (Status == EFI_SUCCESS) {
 243     DEBUG ((EFI_D_ERROR, "Card is SD2.0 => Supports high capacity\n"));
 244     IsHCS = TRUE;
 245     MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R7,Response);
 246     PrintResponseR1(Response[0]);
 247     //check if it is valid response
 248     if(Response[0] != CmdArg){
 249       DEBUG ((EFI_D_ERROR, "The Card is not usable\n"));
 250       return EFI_UNSUPPORTED;
 251     }
 252   } else {
 253     DEBUG ((EFI_D_ERROR, "Not a SD2.0 Card\n"));
 254   }
 255
 256   // We need to wait for the MMC or SD card is ready => (gCardInfo.OCRData.PowerUp == 1)
 257   Timeout = MAX_RETRY_COUNT;
 258   while (Timeout > 0) {
 259     // SD Card or MMC Card ? CMD55 indicates to the card that the next command is an application specific command
 260     Status = MmcHost->SendCommand (MmcHost, MMC_CMD55, 0);
 261     if (Status == EFI_SUCCESS) {
 262         DEBUG ((EFI_D_INFO, "Card should be SD\n"));
 263         if (IsHCS) {
 264             MmcHostInstance->CardInfo.CardType = SD_CARD_2;
 265         } else {
 266             MmcHostInstance->CardInfo.CardType = SD_CARD;
 267         }
 268
 269         // Note: The first time CmdArg will be zero
 270         CmdArg = ((UINTN *) &(MmcHostInstance->CardInfo.OCRData))[0];
 271         if (IsHCS) {
 272             CmdArg |= BIT30;
 273         }
 274         Status = MmcHost->SendCommand (MmcHost, MMC_ACMD41, CmdArg);
 275         if (!EFI_ERROR(Status)) {
 276           MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_OCR,Response);
 277           ((UINT32 *) &(MmcHostInstance->CardInfo.OCRData))[0] = Response[0];
 278         }
 279     } else {
 280         DEBUG ((EFI_D_INFO, "Card should be MMC\n"));
 281         MmcHostInstance->CardInfo.CardType = MMC_CARD;
 282
 283         Status = MmcHost->SendCommand (MmcHost, MMC_CMD1, 0x800000);
 284         if (!EFI_ERROR(Status)) {
 285           MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_OCR,Response);
 286           ((UINT32 *) &(MmcHostInstance->CardInfo.OCRData))[0] = Response[0];
 287         }
 288     }
 289
 290     if (!EFI_ERROR(Status)) {
 291       if (!MmcHostInstance->CardInfo.OCRData.PowerUp) {
 292           MicroSecondDelay(1);
 293           Timeout--;
 294       } else {
 295           if ((MmcHostInstance->CardInfo.CardType == SD_CARD_2) && (MmcHostInstance->CardInfo.OCRData.AccessMode & BIT1)) {
 296               MmcHostInstance->CardInfo.CardType = SD_CARD_2_HIGH;
 297               DEBUG ((EFI_D_ERROR, "High capacity card.\n"));
 298           }
 299           break;  // The MMC/SD card is ready. Continue the Identification Mode
 300       }
 301     } else {
 302       MicroSecondDelay(1);
 303       Timeout--;
 304     }
 305   }
 306
 307   if (Timeout == 0) {
 308     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(): No Card\n"));
 309     return EFI_NO_MEDIA;
 310   } else {
 311     PrintOCR(Response[0]);
 312   }
 313
 314   Status = MmcNotifyState (MmcHostInstance, MmcReadyState);
 315   if (EFI_ERROR(Status)) {
 316     DEBUG((EFI_D_ERROR, "MmcIdentificationMode() : Error MmcReadyState\n"));
 317     return Status;
 318   }
 319
 320   Status = MmcHost->SendCommand (MmcHost, MMC_CMD2, 0);
 321   if (EFI_ERROR(Status)) {
 322     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD2): Error\n"));
 323     return Status;
 324   }
 325   MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_CID,Response);
 326   PrintCID(Response);
 327
 328   Status = MmcNotifyState (MmcHostInstance, MmcIdentificationState);
 329   if (EFI_ERROR(Status)) {
 330     DEBUG((EFI_D_ERROR, "MmcIdentificationMode() : Error MmcIdentificationState\n"));
 331     return Status;
 332   }
 333
 334   //
 335   // Note, SD specifications say that "if the command execution causes a state change, it
 336   // will be visible to the host in the response to the next command"
 337   // The status returned for this CMD3 will be 2 - identification
 338   //
 339   CmdArg = 1;
 340   Status = MmcHost->SendCommand (MmcHost, MMC_CMD3, CmdArg);
 341   if (EFI_ERROR(Status)) {
 342     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD3): Error\n"));
 343     return Status;
 344   }
 345
 346   MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_RCA,Response);
 347   PrintRCA(Response[0]);
 348
 349   // For MMC card, RCA is assigned by CMD3 while CMD3 dumps the RCA for SD card
 350   if (MmcHostInstance->CardInfo.CardType != MMC_CARD) {
 351     MmcHostInstance->CardInfo.RCA = Response[0] >> 16;
 352   } else {
 353     MmcHostInstance->CardInfo.RCA = CmdArg;
 354   }
 355
 356   Status = MmcNotifyState (MmcHostInstance, MmcStandByState);
 357   if (EFI_ERROR(Status)) {
 358     DEBUG((EFI_D_ERROR, "MmcIdentificationMode() : Error MmcStandByState\n"));
 359     return Status;
 360   }
 361
 362   return EFI_SUCCESS;
 363 }
 364
 365 EFI_STATUS InitializeMmcDevice (
 366   IN  MMC_HOST_INSTANCE   *MmcHostInstance
 367   )
 368 {
 369   UINT32                  Response[4];
 370   EFI_STATUS              Status;
 371   UINTN                   CardSize, NumBlocks, BlockSize, CmdArg;
 372   EFI_MMC_HOST_PROTOCOL   *MmcHost;
 373   UINTN                   BlockCount = 1;
 374
 375   MmcHost = MmcHostInstance->MmcHost;
 376
 377   MmcIdentificationMode (MmcHostInstance);
 378
 379   //Send a command to get Card specific data
 380   CmdArg = MmcHostInstance->CardInfo.RCA << 16;
 381   Status = MmcHost->SendCommand (MmcHost, MMC_CMD9, CmdArg);
 382   if (EFI_ERROR(Status)) {
 383     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD9): Error, Status=%r\n", Status));
 384     return Status;
 385   }
 386   //Read Response
 387   MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_CSD,Response);
 388   PrintCSD(Response);
 389
 390   if (MmcHostInstance->CardInfo.CardType == SD_CARD_2_HIGH) {
 391     CardSize = HC_MMC_CSD_GET_DEVICESIZE(Response);
 392     NumBlocks = ((CardSize + 1) * 1024);
 393     BlockSize = 1 << MMC_CSD_GET_READBLLEN(Response);
 394   } else {
 395     CardSize = MMC_CSD_GET_DEVICESIZE(Response);
 396     NumBlocks = (CardSize + 1) * (1 << (MMC_CSD_GET_DEVICESIZEMULT(Response) + 2));
 397     BlockSize = 1 << MMC_CSD_GET_READBLLEN(Response);
 398   }
 399
 400   //For >=2G card, BlockSize may be 1K, but the transfer size is 512 bytes.
 401   if (BlockSize > 512) {
 402     NumBlocks = MultU64x32(NumBlocks, BlockSize/512);
 403     BlockSize = 512;
 404   }
 405
 406   MmcHostInstance->BlockIo.Media->LastBlock    = (NumBlocks - 1);
 407   MmcHostInstance->BlockIo.Media->BlockSize    = BlockSize;
 408   MmcHostInstance->BlockIo.Media->ReadOnly     = MmcHost->IsReadOnly (MmcHost);
 409   MmcHostInstance->BlockIo.Media->MediaPresent = TRUE;
 410   MmcHostInstance->BlockIo.Media->MediaId++;
 411
 412   CmdArg = MmcHostInstance->CardInfo.RCA << 16;
 413   Status = MmcHost->SendCommand (MmcHost, MMC_CMD7, CmdArg);
 414   if (EFI_ERROR(Status)) {
 415     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD7): Error and Status = %r\n", Status));
 416     return Status;
 417   }
 418
 419   Status = MmcNotifyState (MmcHostInstance, MmcTransferState);
 420   if (EFI_ERROR(Status)) {
 421     DEBUG((EFI_D_ERROR, "MmcIdentificationMode() : Error MmcTransferState\n"));
 422     return Status;
 423   }
 424
 425   // Set Block Length
 426   Status = MmcHost->SendCommand (MmcHost, MMC_CMD16, MmcHostInstance->BlockIo.Media->BlockSize);
 427   if (EFI_ERROR(Status)) {
 428     DEBUG((EFI_D_ERROR, "MmcIdentificationMode(MMC_CMD16): Error MmcHostInstance->BlockIo.Media->BlockSize: %d and Error = %r\n",MmcHostInstance->BlockIo.Media->BlockSize, Status));
 429     return Status;
 430   }
 431
 432   // Block Count (not used). Could return an error for SD card
 433   if (MmcHostInstance->CardInfo.CardType == MMC_CARD) {
 434     MmcHost->SendCommand (MmcHost, MMC_CMD23, BlockCount);
 435   }
 436
 437   return EFI_SUCCESS;
 438 }
 439
 440 EFI_STATUS
 441 EFIAPI
 442 MmcReset (
 443   IN EFI_BLOCK_IO_PROTOCOL    *This,
 444   IN BOOLEAN                  ExtendedVerification
 445   )
 446 {
 447   MMC_HOST_INSTANCE       *MmcHostInstance;
 448
 449   MmcHostInstance = MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS(This);
 450
 451   if (MmcHostInstance->MmcHost == NULL) {
 452     // Nothing to do
 453     return EFI_SUCCESS;
 454   }
 455
 456   // If a card is not present then clear all media settings
 457   if (!MmcHostInstance->MmcHost->IsCardPresent (MmcHostInstance->MmcHost)) {
 458     MmcHostInstance->BlockIo.Media->MediaPresent = FALSE;
 459     MmcHostInstance->BlockIo.Media->LastBlock    = 0;
 460     MmcHostInstance->BlockIo.Media->BlockSize    = 512;  // Should be zero but there is a bug in DiskIo
 461     MmcHostInstance->BlockIo.Media->ReadOnly     = FALSE;
 462
 463     // Indicate that the driver requires initialization
 464     MmcHostInstance->State = MmcHwInitializationState;
 465
 466     return EFI_SUCCESS;
 467   }
 468
 469   // Implement me. Either send a CMD0 (could not work for some MMC host) or just turn off/turn
 470   //      on power and restart Identification mode
 471   return EFI_SUCCESS;
 472 }
 473
 474 EFI_STATUS
 475 MmcDetectCard (
 476   EFI_MMC_HOST_PROTOCOL     *MmcHost
 477   )
 478 {
 479   if (!MmcHost->IsCardPresent (MmcHost)) {
 480     return EFI_NO_MEDIA;
 481   } else {
 482     return EFI_SUCCESS;
 483   }
 484 }
 485
 486 #define MMCI0_BLOCKLEN 512
 487 #define MMCI0_TIMEOUT  10000
 488
 489 EFI_STATUS
 490 MmcIoBlocks (
 491   IN EFI_BLOCK_IO_PROTOCOL    *This,
 492   IN UINTN                    Transfer,
 493   IN UINT32                   MediaId,
 494   IN EFI_LBA                  Lba,
 495   IN UINTN                    BufferSize,
 496   OUT VOID                    *Buffer
 497   )
 498 {
 499   UINT32                  Response[4];
 500   EFI_STATUS              Status;
 501   UINTN                   CmdArg;
 502   INTN                    Timeout;
 503   UINTN                   Cmd;
 504   MMC_HOST_INSTANCE       *MmcHostInstance;
 505   EFI_MMC_HOST_PROTOCOL   *MmcHost;
 506   UINTN                   BytesRemainingToBeTransfered;
 507   UINTN                   BlockCount = 1;
 508
 509   MmcHostInstance = MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS(This);
 510   ASSERT(MmcHostInstance != 0);
 511   MmcHost = MmcHostInstance->MmcHost;
 512   ASSERT(MmcHost);
 513
 514   if ((MmcHost == 0)|| (Buffer == NULL)) {
 515     return EFI_INVALID_PARAMETER;
 516   }
 517
 518   // Check if a Card is Present
 519   if (!MmcHostInstance->BlockIo.Media->MediaPresent) {
 520     return EFI_NO_MEDIA;
 521   }
 522
 523   // All blocks must be within the device
 524   if ((Lba + (BufferSize / This->Media->BlockSize)) > (This->Media->LastBlock + 1)){
 525     return EFI_INVALID_PARAMETER;
 526   }
 527
 528   // The buffer size must not be zero and it must be an exact multiple of the block size
 529   if ((BufferSize == 0) || ((BufferSize % This->Media->BlockSize) != 0)) {
 530     return EFI_BAD_BUFFER_SIZE;
 531   }
 532
 533   if (This->Media->MediaId != MediaId) {
 534     return EFI_MEDIA_CHANGED;
 535   }
 536
 537   if((Transfer == MMC_IOBLOCKS_WRITE) && (This->Media->ReadOnly == TRUE)) {
 538     return EFI_WRITE_PROTECTED;
 539   }
 540
 541   BytesRemainingToBeTransfered = BufferSize;
 542   while (BytesRemainingToBeTransfered > 0) {
 543
 544     // Check if the Card is in Ready status
 545     CmdArg = MmcHostInstance->CardInfo.RCA << 16;
 546     Response[0] = 0;
 547     Timeout = 20;
 548     while(   (!(Response[0] & MMC_R0_READY_FOR_DATA))
 549           && (MMC_R0_CURRENTSTATE(Response) != MMC_R0_STATE_TRAN)
 550           && Timeout--) {
 551       Status = MmcHost->SendCommand (MmcHost, MMC_CMD13, CmdArg);
 552       if (!EFI_ERROR(Status)) {
 553         MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1,Response);
 554       }
 555     }
 556
 557     if (0 == Timeout) {
 558       DEBUG((EFI_D_ERROR, "The Card is busy\n"));
 559       return EFI_NOT_READY;
 560     }
 561
 562     //Set command argument based on the card access mode (Byte mode or Block mode)
 563     if (MmcHostInstance->CardInfo.OCRData.AccessMode & BIT1) {
 564       CmdArg = Lba;
 565     } else {
 566       CmdArg = Lba * This->Media->BlockSize;
 567     }
 568
 569     if (Transfer == MMC_IOBLOCKS_READ) {
 570 #ifndef USE_STREAM
 571       // Read a single block
 572       Cmd = MMC_CMD17;
 573 #else
 574       //TODO: Should we support read stream (MMC_CMD11)
 575 #endif
 576     } else {
 577 #ifndef USE_STREAM
 578       // Write a single block
 579       Cmd = MMC_CMD24;
 580 #else
 581       //TODO: Should we support write stream (MMC_CMD20)
 582 #endif
 583     }
 584     Status = MmcHost->SendCommand (MmcHost, Cmd, CmdArg);
 585     if (EFI_ERROR(Status)) {
 586       DEBUG((EFI_D_ERROR, "MmcIoBlocks(MMC_CMD%d): Error %r\n",Cmd, Status));
 587       return Status;
 588     }
 589
 590     if (Transfer == MMC_IOBLOCKS_READ) {
 591 #ifndef USE_STREAM
 592       // Read one block of Data
 593       Status = MmcHost->ReadBlockData (MmcHost, Lba,This->Media->BlockSize,Buffer);
 594       if (EFI_ERROR(Status)) {
 595         DEBUG((EFI_D_BLKIO, "MmcIoBlocks(): Error Read Block Data and Status = %r\n", Status));
 596         return Status;
 597       }
 598 #else
 599       //TODO: Read a stream
 600       ASSERT(0);
 601 #endif
 602       Status = MmcNotifyState (MmcHostInstance, MmcProgrammingState);
 603       if (EFI_ERROR(Status)) {
 604         DEBUG((EFI_D_ERROR, "MmcIoBlocks() : Error MmcProgrammingState\n"));
 605         return Status;
 606       }
 607     } else {
 608 #ifndef USE_STREAM
 609       // Write one block of Data
 610       Status = MmcHost->WriteBlockData (MmcHost, Lba,This->Media->BlockSize,Buffer);
 611       if (EFI_ERROR(Status)) {
 612         DEBUG((EFI_D_BLKIO, "MmcIoBlocks(): Error Write Block Data and Status = %r\n", Status));
 613         return Status;
 614       }
 615 #else
 616       //TODO: Write a stream
 617       ASSERT(0);
 618 #endif
 619     }
 620
 621     // Command 12 - Stop transmission (ends read)
 622     Status = MmcHost->SendCommand (MmcHost, MMC_CMD12, 0);
 623     if (!EFI_ERROR(Status)) {
 624       MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1b,Response);
 625     }
 626
 627     // Command 13 - Read status and wait for programming to complete (return to tran)
 628     Timeout = MMCI0_TIMEOUT;
 629     CmdArg = MmcHostInstance->CardInfo.RCA << 16;
 630     Response[0] = 0;
 631     while(   (!(Response[0] & MMC_R0_READY_FOR_DATA))
 632           && (MMC_R0_CURRENTSTATE(Response) != MMC_R0_STATE_TRAN)
 633           && Timeout--) {
 634       Status = MmcHost->SendCommand (MmcHost, MMC_CMD13, CmdArg);
 635       if (!EFI_ERROR(Status)) {
 636         MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1, Response);
 637         if ((Response[0] & MMC_R0_READY_FOR_DATA)) {
 638           break;  // Prevents delay once finished
 639         }
 640       }
 641       NanoSecondDelay(100);
 642     }
 643
 644     Status = MmcNotifyState (MmcHostInstance, MmcTransferState);
 645     if (EFI_ERROR(Status)) {
 646       DEBUG((EFI_D_ERROR, "MmcIoBlocks() : Error MmcTransferState\n"));
 647       return Status;
 648     }
 649
 650     BytesRemainingToBeTransfered -= This->Media->BlockSize;
 651     Lba    += BlockCount;
 652     Buffer = (UINT8 *)Buffer + This->Media->BlockSize;
 653   }
 654
 655   return EFI_SUCCESS;
 656 }
 657
 658 EFI_STATUS
 659 EFIAPI
 660 MmcReadBlocks (
 661   IN EFI_BLOCK_IO_PROTOCOL    *This,
 662   IN UINT32                   MediaId,
 663   IN EFI_LBA                  Lba,
 664   IN UINTN                    BufferSize,
 665   OUT VOID                    *Buffer
 666   )
 667 {
 668   return MmcIoBlocks (This, MMC_IOBLOCKS_READ, MediaId, Lba, BufferSize, Buffer);
 669 }
 670
 671 EFI_STATUS
 672 EFIAPI
 673 MmcWriteBlocks (
 674   IN EFI_BLOCK_IO_PROTOCOL    *This,
 675   IN UINT32                   MediaId,
 676   IN EFI_LBA                  Lba,
 677   IN UINTN                    BufferSize,
 678   IN VOID                     *Buffer
 679   )
 680 {
 681   return MmcIoBlocks (This, MMC_IOBLOCKS_WRITE, MediaId, Lba, BufferSize, Buffer);
 682 }
 683
 684 EFI_STATUS
 685 EFIAPI
 686 MmcFlushBlocks (
 687   IN EFI_BLOCK_IO_PROTOCOL  *This
 688   )
 689 {
 690   return EFI_SUCCESS;
 691 }
 692