3 * Copyright (c) 2011-2015, ARM Limited. All rights reserved.
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
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.
15 #include <Library/BaseMemoryLib.h>
16 #include <Library/MemoryAllocationLib.h>
17 #include <Library/TimerLib.h>
26 #define MAX_RETRY_COUNT 1000
27 #define CMD_RETRY_COUNT 20
28 #define RCA_SHIFT_OFFSET 16
29 #define EMMC_CARD_SIZE 512
30 #define EMMC_ECSD_SIZE_OFFSET 53
32 #define EXTCSD_BUS_WIDTH 183
33 #define EXTCSD_HS_TIMING 185
35 #define EMMC_TIMING_BACKWARD 0
36 #define EMMC_TIMING_HS 1
37 #define EMMC_TIMING_HS200 2
38 #define EMMC_TIMING_HS400 3
40 #define EMMC_BUS_WIDTH_1BIT 0
41 #define EMMC_BUS_WIDTH_4BIT 1
42 #define EMMC_BUS_WIDTH_8BIT 2
43 #define EMMC_BUS_WIDTH_DDR_4BIT 5
44 #define EMMC_BUS_WIDTH_DDR_8BIT 6
46 #define EMMC_SWITCH_ERROR (1 << 7)
48 #define SD_BUS_WIDTH_1BIT (1 << 0)
49 #define SD_BUS_WIDTH_4BIT (1 << 2)
51 #define SD_CCC_SWITCH (1 << 10)
53 #define DEVICE_STATE(x) (((x) >> 9) & 0xf)
54 typedef enum _EMMC_DEVICE_STATE
{
68 UINT32 mEmmcRcaCount
= 0;
74 IN MMC_HOST_INSTANCE
*MmcHostInstance
,
75 OUT EMMC_DEVICE_STATE
*State
78 EFI_MMC_HOST_PROTOCOL
*Host
;
83 return EFI_INVALID_PARAMETER
;
86 Host
= MmcHostInstance
->MmcHost
;
87 RCA
= MmcHostInstance
->CardInfo
.RCA
<< RCA_SHIFT_OFFSET
;
88 Status
= Host
->SendCommand (Host
, MMC_CMD13
, RCA
);
89 if (EFI_ERROR (Status
)) {
90 DEBUG ((EFI_D_ERROR
, "EmmcGetDeviceState(): Failed to get card status, Status=%r.\n", Status
));
93 Status
= Host
->ReceiveResponse (Host
, MMC_RESPONSE_TYPE_R1
, &Data
);
94 if (EFI_ERROR (Status
)) {
95 DEBUG ((EFI_D_ERROR
, "EmmcGetDeviceState(): Failed to get response of CMD13, Status=%r.\n", Status
));
98 if (Data
& EMMC_SWITCH_ERROR
) {
99 DEBUG ((EFI_D_ERROR
, "EmmcGetDeviceState(): Failed to switch expected mode, Status=%r.\n", Status
));
100 return EFI_DEVICE_ERROR
;
102 *State
= DEVICE_STATE(Data
);
110 IN MMC_HOST_INSTANCE
*MmcHostInstance
,
115 EFI_MMC_HOST_PROTOCOL
*Host
;
116 EMMC_DEVICE_STATE State
;
120 Host
= MmcHostInstance
->MmcHost
;
121 Argument
= EMMC_CMD6_ARG_ACCESS(3) | EMMC_CMD6_ARG_INDEX(ExtCmdIndex
) |
122 EMMC_CMD6_ARG_VALUE(Value
) | EMMC_CMD6_ARG_CMD_SET(1);
123 Status
= Host
->SendCommand (Host
, MMC_CMD6
, Argument
);
124 if (EFI_ERROR (Status
)) {
125 DEBUG ((EFI_D_ERROR
, "EmmcSetEXTCSD(): Failed to send CMD6, Status=%r.\n", Status
));
128 // Make sure device exiting prog mode
130 Status
= EmmcGetDeviceState (MmcHostInstance
, &State
);
131 if (EFI_ERROR (Status
)) {
132 DEBUG ((EFI_D_ERROR
, "EmmcSetEXTCSD(): Failed to get device state, Status=%r.\n", Status
));
135 } while (State
== EMMC_PRG_STATE
);
142 EmmcIdentificationMode (
143 IN MMC_HOST_INSTANCE
*MmcHostInstance
,
144 IN OCR_RESPONSE Response
147 EFI_MMC_HOST_PROTOCOL
*Host
;
148 EFI_BLOCK_IO_MEDIA
*Media
;
150 EMMC_DEVICE_STATE State
;
153 Host
= MmcHostInstance
->MmcHost
;
154 Media
= MmcHostInstance
->BlockIo
.Media
;
156 // Fetch card identity register
157 Status
= Host
->SendCommand (Host
, MMC_CMD2
, 0);
158 if (EFI_ERROR (Status
)) {
159 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): Failed to send CMD2, Status=%r.\n", Status
));
163 Status
= Host
->ReceiveResponse (Host
, MMC_RESPONSE_TYPE_R2
, (UINT32
*)&(MmcHostInstance
->CardInfo
.CIDData
));
164 if (EFI_ERROR (Status
)) {
165 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): CID retrieval error, Status=%r.\n", Status
));
169 // Assign a relative address value to the card
170 MmcHostInstance
->CardInfo
.RCA
= ++mEmmcRcaCount
; // TODO: might need a more sophisticated way of doing this
171 RCA
= MmcHostInstance
->CardInfo
.RCA
<< RCA_SHIFT_OFFSET
;
172 Status
= Host
->SendCommand (Host
, MMC_CMD3
, RCA
);
173 if (EFI_ERROR (Status
)) {
174 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): RCA set error, Status=%r.\n", Status
));
178 // Fetch card specific data
179 Status
= Host
->SendCommand (Host
, MMC_CMD9
, RCA
);
180 if (EFI_ERROR (Status
)) {
181 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): Failed to send CMD9, Status=%r.\n", Status
));
185 Status
= Host
->ReceiveResponse (Host
, MMC_RESPONSE_TYPE_R2
, (UINT32
*)&(MmcHostInstance
->CardInfo
.CSDData
));
186 if (EFI_ERROR (Status
)) {
187 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): CSD retrieval error, Status=%r.\n", Status
));
192 Status
= Host
->SendCommand (Host
, MMC_CMD7
, RCA
);
193 if (EFI_ERROR (Status
)) {
194 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): Card selection error, Status=%r.\n", Status
));
197 if (MMC_HOST_HAS_SETIOS(Host
)) {
198 // Set 1-bit bus width
199 Status
= Host
->SetIos (Host
, 0, 1, EMMCBACKWARD
);
200 if (EFI_ERROR (Status
)) {
201 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): Set 1-bit bus width error, Status=%r.\n", Status
));
205 // Set 1-bit bus width for EXTCSD
206 Status
= EmmcSetEXTCSD (MmcHostInstance
, EXTCSD_BUS_WIDTH
, EMMC_BUS_WIDTH_1BIT
);
207 if (EFI_ERROR (Status
)) {
208 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): Set extcsd bus width error, Status=%r.\n", Status
));
214 MmcHostInstance
->CardInfo
.ECSDData
= AllocatePages (EFI_SIZE_TO_PAGES (sizeof (ECSD
)));
215 if (MmcHostInstance
->CardInfo
.ECSDData
== NULL
) {
216 return EFI_OUT_OF_RESOURCES
;
218 Status
= Host
->SendCommand (Host
, MMC_CMD8
, 0);
219 if (EFI_ERROR (Status
)) {
220 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): ECSD fetch error, Status=%r.\n", Status
));
223 Status
= Host
->ReadBlockData (Host
, 0, 512, (UINT32
*)MmcHostInstance
->CardInfo
.ECSDData
);
224 if (EFI_ERROR (Status
)) {
225 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): ECSD read error, Status=%r.\n", Status
));
229 // Make sure device exiting data mode
231 Status
= EmmcGetDeviceState (MmcHostInstance
, &State
);
232 if (EFI_ERROR (Status
)) {
233 DEBUG ((EFI_D_ERROR
, "EmmcIdentificationMode(): Failed to get device state, Status=%r.\n", Status
));
236 } while (State
== EMMC_DATA_STATE
);
239 Media
->BlockSize
= EMMC_CARD_SIZE
; // 512-byte support is mandatory for eMMC cards
240 Media
->MediaId
= MmcHostInstance
->CardInfo
.CIDData
.PSN
;
241 Media
->ReadOnly
= MmcHostInstance
->CardInfo
.CSDData
.PERM_WRITE_PROTECT
;
242 Media
->LogicalBlocksPerPhysicalBlock
= 1;
244 // Compute last block using bits [215:212] of the ECSD
245 Media
->LastBlock
= MmcHostInstance
->CardInfo
.ECSDData
->SECTOR_COUNT
- 1; // eMMC isn't supposed to report this for
246 // Cards <2GB in size, but the model does.
249 MmcHostInstance
->CardInfo
.CardType
= EMMC_CARD
;
253 FreePages (MmcHostInstance
->CardInfo
.ECSDData
, EFI_SIZE_TO_PAGES (sizeof (ECSD
)));
259 InitializeEmmcDevice (
260 IN MMC_HOST_INSTANCE
*MmcHostInstance
263 EFI_MMC_HOST_PROTOCOL
*Host
;
264 EFI_STATUS Status
= EFI_SUCCESS
;
266 UINT32 BusClockFreq
, Idx
, BusMode
;
267 UINT32 TimingMode
[4] = {EMMCHS52DDR1V2
, EMMCHS52DDR1V8
, EMMCHS52
, EMMCHS26
};
269 Host
= MmcHostInstance
->MmcHost
;
270 ECSDData
= MmcHostInstance
->CardInfo
.ECSDData
;
271 if (ECSDData
->DEVICE_TYPE
== EMMCBACKWARD
)
274 if (!MMC_HOST_HAS_SETIOS(Host
)) {
277 Status
= EmmcSetEXTCSD (MmcHostInstance
, EXTCSD_HS_TIMING
, EMMC_TIMING_HS
);
278 if (EFI_ERROR (Status
)) {
279 DEBUG ((DEBUG_ERROR
, "InitializeEmmcDevice(): Failed to switch high speed mode, Status:%r.\n", Status
));
283 for (Idx
= 0; Idx
< 4; Idx
++) {
284 switch (TimingMode
[Idx
]) {
288 BusClockFreq
= 52000000;
291 BusClockFreq
= 26000000;
294 return EFI_UNSUPPORTED
;
296 Status
= Host
->SetIos (Host
, BusClockFreq
, 8, TimingMode
[Idx
]);
297 if (!EFI_ERROR (Status
)) {
298 switch (TimingMode
[Idx
]) {
301 BusMode
= EMMC_BUS_WIDTH_DDR_8BIT
;
305 BusMode
= EMMC_BUS_WIDTH_8BIT
;
308 return EFI_UNSUPPORTED
;
310 Status
= EmmcSetEXTCSD (MmcHostInstance
, EXTCSD_BUS_WIDTH
, BusMode
);
311 if (EFI_ERROR (Status
)) {
312 DEBUG ((DEBUG_ERROR
, "InitializeEmmcDevice(): Failed to set EXTCSD bus width, Status:%r\n", Status
));
322 CreateSwitchCmdArgument (
330 Argument
= Mode
<< 31 | 0x00FFFFFF;
331 Argument
&= ~(0xF << (Group
* 4));
332 Argument
|= Value
<< (Group
* 4);
339 InitializeSdMmcDevice (
340 IN MMC_HOST_INSTANCE
*MmcHostInstance
353 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
355 Speed
= SD_DEFAULT_SPEED
;
356 MmcHost
= MmcHostInstance
->MmcHost
;
358 // Send a command to get Card specific data
359 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
360 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD9
, CmdArg
);
361 if (EFI_ERROR (Status
)) {
362 DEBUG((EFI_D_ERROR
, "InitializeSdMmcDevice(MMC_CMD9): Error, Status=%r\n", Status
));
367 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_CSD
, Response
);
368 if (EFI_ERROR (Status
)) {
369 DEBUG((EFI_D_ERROR
, "InitializeSdMmcDevice(): Failed to receive CSD, Status=%r\n", Status
));
373 if (MMC_CSD_GET_CCC(Response
) & SD_CCC_SWITCH
) {
379 if (MmcHostInstance
->CardInfo
.CardType
== SD_CARD_2_HIGH
) {
380 CardSize
= HC_MMC_CSD_GET_DEVICESIZE (Response
);
381 NumBlocks
= ((CardSize
+ 1) * 1024);
382 BlockSize
= 1 << MMC_CSD_GET_READBLLEN (Response
);
384 CardSize
= MMC_CSD_GET_DEVICESIZE (Response
);
385 NumBlocks
= (CardSize
+ 1) * (1 << (MMC_CSD_GET_DEVICESIZEMULT (Response
) + 2));
386 BlockSize
= 1 << MMC_CSD_GET_READBLLEN (Response
);
389 // For >=2G card, BlockSize may be 1K, but the transfer size is 512 bytes.
390 if (BlockSize
> 512) {
391 NumBlocks
= MultU64x32 (NumBlocks
, BlockSize
/ 512);
395 MmcHostInstance
->BlockIo
.Media
->LastBlock
= (NumBlocks
- 1);
396 MmcHostInstance
->BlockIo
.Media
->BlockSize
= BlockSize
;
397 MmcHostInstance
->BlockIo
.Media
->ReadOnly
= MmcHost
->IsReadOnly (MmcHost
);
398 MmcHostInstance
->BlockIo
.Media
->MediaPresent
= TRUE
;
399 MmcHostInstance
->BlockIo
.Media
->MediaId
++;
401 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
402 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD7
, CmdArg
);
403 if (EFI_ERROR (Status
)) {
404 DEBUG((EFI_D_ERROR
, "InitializeSdMmcDevice(MMC_CMD7): Error and Status = %r\n", Status
));
408 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD55
, CmdArg
);
409 if (EFI_ERROR (Status
)) {
410 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD55): Error and Status = %r\n", __FUNCTION__
, Status
));
413 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R1
, Response
);
414 if (EFI_ERROR (Status
)) {
415 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD55): Error and Status = %r\n", __FUNCTION__
, Status
));
418 if ((Response
[0] & MMC_STATUS_APP_CMD
) == 0) {
423 Status
= MmcHost
->SendCommand (MmcHost
, MMC_ACMD51
, 0);
424 if (EFI_ERROR (Status
)) {
425 DEBUG ((EFI_D_ERROR
, "%a(MMC_ACMD51): Error and Status = %r\n", __func__
, Status
));
428 Status
= MmcHost
->ReadBlockData (MmcHost
, 0, 8, Buffer
);
429 if (EFI_ERROR (Status
)) {
430 DEBUG ((EFI_D_ERROR
, "%a(MMC_ACMD51): ReadBlockData Error and Status = %r\n", __func__
, Status
));
433 CopyMem (&Scr
, Buffer
, 8);
434 if (Scr
.SD_SPEC
== 2) {
435 if (Scr
.SD_SPEC3
== 1) {
436 if (Scr
.SD_SPEC4
== 1) {
437 DEBUG ((EFI_D_INFO
, "Found SD Card for Spec Version 4.xx\n"));
439 DEBUG ((EFI_D_INFO
, "Found SD Card for Spec Version 3.0x\n"));
442 if (Scr
.SD_SPEC4
== 0) {
443 DEBUG ((EFI_D_INFO
, "Found SD Card for Spec Version 2.0\n"));
445 DEBUG ((EFI_D_ERROR
, "Found invalid SD Card\n"));
449 if ((Scr
.SD_SPEC3
== 0) && (Scr
.SD_SPEC4
== 0)) {
450 if (Scr
.SD_SPEC
== 1) {
451 DEBUG ((EFI_D_INFO
, "Found SD Card for Spec Version 1.10\n"));
453 DEBUG ((EFI_D_INFO
, "Found SD Card for Spec Version 1.0\n"));
456 DEBUG ((EFI_D_ERROR
, "Found invalid SD Card\n"));
461 /* SD Switch, Mode:0, Group:0, Value:0 */
462 CmdArg
= CreateSwitchCmdArgument(0, 0, 0);
463 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD6
, CmdArg
);
464 if (EFI_ERROR (Status
)) {
465 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): Error and Status = %r\n", __FUNCTION__
, Status
));
468 Status
= MmcHost
->ReadBlockData (MmcHost
, 0, SWITCH_CMD_DATA_LENGTH
, Buffer
);
469 if (EFI_ERROR (Status
)) {
470 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): ReadBlockData Error and Status = %r\n", __FUNCTION__
, Status
));
475 if (!(Buffer
[3] & SD_HIGH_SPEED_SUPPORTED
)) {
476 DEBUG ((DEBUG_ERROR
, "%a : High Speed not supported by Card %r\n", __FUNCTION__
, Status
));
480 Speed
= SD_HIGH_SPEED
;
482 /* SD Switch, Mode:1, Group:0, Value:1 */
483 CmdArg
= CreateSwitchCmdArgument(1, 0, 1);
484 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD6
, CmdArg
);
485 if (EFI_ERROR (Status
)) {
486 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): Error and Status = %r\n", __FUNCTION__
, Status
));
489 Status
= MmcHost
->ReadBlockData (MmcHost
, 0, SWITCH_CMD_DATA_LENGTH
, Buffer
);
490 if (EFI_ERROR (Status
)) {
491 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): ReadBlockData Error and Status = %r\n", __FUNCTION__
, Status
));
495 if ((Buffer
[4] & SWITCH_CMD_SUCCESS_MASK
) != 0x01000000) {
496 DEBUG((DEBUG_ERROR
, "Problem switching SD card into high-speed mode\n"));
501 if (Scr
.SD_BUS_WIDTHS
& SD_BUS_WIDTH_4BIT
) {
502 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
503 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD55
, CmdArg
);
504 if (EFI_ERROR (Status
)) {
505 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD55): Error and Status = %r\n", __FUNCTION__
, Status
));
509 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD6
, 2);
510 if (EFI_ERROR (Status
)) {
511 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): Error and Status = %r\n", __FUNCTION__
, Status
));
515 if (MMC_HOST_HAS_SETIOS(MmcHost
)) {
516 Status
= MmcHost
->SetIos (MmcHost
, Speed
, BUSWIDTH_4
, EMMCBACKWARD
);
517 if (EFI_ERROR (Status
)) {
518 DEBUG ((DEBUG_ERROR
, "%a (SetIos): Error and Status = %r\n", __FUNCTION__
, Status
));
528 MmcIdentificationMode (
529 IN MMC_HOST_INSTANCE
*MmcHostInstance
537 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
538 OCR_RESPONSE OcrResponse
;
540 MmcHost
= MmcHostInstance
->MmcHost
;
544 if (MmcHost
== NULL
) {
545 return EFI_INVALID_PARAMETER
;
548 // We can get into this function if we restart the identification mode
549 if (MmcHostInstance
->State
== MmcHwInitializationState
) {
550 // Initialize the MMC Host HW
551 Status
= MmcNotifyState (MmcHostInstance
, MmcHwInitializationState
);
552 if (EFI_ERROR (Status
)) {
553 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcHwInitializationState, Status=%r.\n", Status
));
558 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD0
, 0);
559 if (EFI_ERROR (Status
)) {
560 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD0): Error, Status=%r.\n", Status
));
563 Status
= MmcNotifyState (MmcHostInstance
, MmcIdleState
);
564 if (EFI_ERROR (Status
)) {
565 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcIdleState, Status=%r.\n", Status
));
569 // Send CMD1 to get OCR (MMC)
570 // This command only valid for MMC and eMMC
571 Timeout
= MAX_RETRY_COUNT
;
573 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD1
, EMMC_CMD1_CAPACITY_GREATER_THAN_2GB
);
574 if (EFI_ERROR (Status
))
576 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_OCR
, (UINT32
*)&OcrResponse
);
577 if (EFI_ERROR (Status
)) {
578 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status
));
582 } while (!OcrResponse
.Ocr
.PowerUp
&& (Timeout
> 0));
583 if (Status
== EFI_SUCCESS
) {
584 if (!OcrResponse
.Ocr
.PowerUp
) {
585 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD1): Card initialisation failure, Status=%r.\n", Status
));
586 return EFI_DEVICE_ERROR
;
588 OcrResponse
.Ocr
.PowerUp
= 0;
589 if (OcrResponse
.Raw
== EMMC_CMD1_CAPACITY_GREATER_THAN_2GB
) {
590 MmcHostInstance
->CardInfo
.OCRData
.AccessMode
= BIT1
;
593 MmcHostInstance
->CardInfo
.OCRData
.AccessMode
= 0x0;
595 // Check whether MMC or eMMC
596 if (OcrResponse
.Raw
== EMMC_CMD1_CAPACITY_GREATER_THAN_2GB
||
597 OcrResponse
.Raw
== EMMC_CMD1_CAPACITY_LESS_THAN_2GB
) {
598 return EmmcIdentificationMode (MmcHostInstance
, OcrResponse
);
602 // Are we using SDIO ?
603 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD5
, 0);
604 if (Status
== EFI_SUCCESS
) {
605 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD5): Error - SDIO not supported, Status=%r.\n", Status
));
606 return EFI_UNSUPPORTED
;
609 // Check which kind of card we are using. Ver2.00 or later SD Memory Card (PL180 is SD v1.1)
610 CmdArg
= (0x0UL
<< 12 | BIT8
| 0xCEUL
<< 0);
611 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD8
, CmdArg
);
612 if (Status
== EFI_SUCCESS
) {
613 DEBUG ((EFI_D_ERROR
, "Card is SD2.0 => Supports high capacity\n"));
615 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R7
, Response
);
616 if (EFI_ERROR (Status
)) {
617 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive response to CMD8, Status=%r.\n", Status
));
620 PrintResponseR1 (Response
[0]);
621 // Check if it is valid response
622 if (Response
[0] != CmdArg
) {
623 DEBUG ((EFI_D_ERROR
, "The Card is not usable\n"));
624 return EFI_UNSUPPORTED
;
627 DEBUG ((EFI_D_ERROR
, "Not a SD2.0 Card\n"));
630 // We need to wait for the MMC or SD card is ready => (gCardInfo.OCRData.PowerUp == 1)
631 Timeout
= MAX_RETRY_COUNT
;
632 while (Timeout
> 0) {
633 // SD Card or MMC Card ? CMD55 indicates to the card that the next command is an application specific command
634 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD55
, 0);
635 if (Status
== EFI_SUCCESS
) {
636 DEBUG ((EFI_D_INFO
, "Card should be SD\n"));
638 MmcHostInstance
->CardInfo
.CardType
= SD_CARD_2
;
640 MmcHostInstance
->CardInfo
.CardType
= SD_CARD
;
643 // Note: The first time CmdArg will be zero
644 CmdArg
= ((UINTN
*) &(MmcHostInstance
->CardInfo
.OCRData
))[0];
648 Status
= MmcHost
->SendCommand (MmcHost
, MMC_ACMD41
, CmdArg
);
649 if (!EFI_ERROR (Status
)) {
650 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_OCR
, Response
);
651 if (EFI_ERROR (Status
)) {
652 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status
));
655 ((UINT32
*) &(MmcHostInstance
->CardInfo
.OCRData
))[0] = Response
[0];
658 DEBUG ((EFI_D_INFO
, "Card should be MMC\n"));
659 MmcHostInstance
->CardInfo
.CardType
= MMC_CARD
;
661 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD1
, 0x800000);
662 if (!EFI_ERROR (Status
)) {
663 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_OCR
, Response
);
664 if (EFI_ERROR (Status
)) {
665 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status
));
668 ((UINT32
*) &(MmcHostInstance
->CardInfo
.OCRData
))[0] = Response
[0];
672 if (!EFI_ERROR (Status
)) {
673 if (!MmcHostInstance
->CardInfo
.OCRData
.PowerUp
) {
677 if ((MmcHostInstance
->CardInfo
.CardType
== SD_CARD_2
) && (MmcHostInstance
->CardInfo
.OCRData
.AccessMode
& BIT1
)) {
678 MmcHostInstance
->CardInfo
.CardType
= SD_CARD_2_HIGH
;
679 DEBUG ((EFI_D_ERROR
, "High capacity card.\n"));
681 break; // The MMC/SD card is ready. Continue the Identification Mode
690 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(): No Card\n"));
693 PrintOCR (Response
[0]);
696 Status
= MmcNotifyState (MmcHostInstance
, MmcReadyState
);
697 if (EFI_ERROR (Status
)) {
698 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcReadyState\n"));
702 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD2
, 0);
703 if (EFI_ERROR (Status
)) {
704 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD2): Error\n"));
707 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_CID
, Response
);
708 if (EFI_ERROR (Status
)) {
709 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive CID, Status=%r.\n", Status
));
715 Status
= MmcHost
->NotifyState (MmcHost
, MmcIdentificationState
);
716 if (EFI_ERROR (Status
)) {
717 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcIdentificationState\n"));
722 // Note, SD specifications say that "if the command execution causes a state change, it
723 // will be visible to the host in the response to the next command"
724 // The status returned for this CMD3 will be 2 - identification
727 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD3
, CmdArg
);
728 if (EFI_ERROR (Status
)) {
729 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD3): Error\n"));
733 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_RCA
, Response
);
734 if (EFI_ERROR (Status
)) {
735 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive RCA, Status=%r.\n", Status
));
738 PrintRCA (Response
[0]);
740 // For MMC card, RCA is assigned by CMD3 while CMD3 dumps the RCA for SD card
741 if (MmcHostInstance
->CardInfo
.CardType
!= MMC_CARD
) {
742 MmcHostInstance
->CardInfo
.RCA
= Response
[0] >> 16;
744 MmcHostInstance
->CardInfo
.RCA
= CmdArg
;
746 Status
= MmcNotifyState (MmcHostInstance
, MmcStandByState
);
747 if (EFI_ERROR (Status
)) {
748 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcStandByState\n"));
756 InitializeMmcDevice (
757 IN MMC_HOST_INSTANCE
*MmcHostInstance
761 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
765 MmcHost
= MmcHostInstance
->MmcHost
;
767 Status
= MmcIdentificationMode (MmcHostInstance
);
768 if (EFI_ERROR (Status
)) {
769 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(): Error in Identification Mode, Status=%r\n", Status
));
773 Status
= MmcNotifyState (MmcHostInstance
, MmcTransferState
);
774 if (EFI_ERROR (Status
)) {
775 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(): Error MmcTransferState, Status=%r\n", Status
));
779 if (MmcHostInstance
->CardInfo
.CardType
!= EMMC_CARD
) {
780 Status
= InitializeSdMmcDevice (MmcHostInstance
);
782 Status
= InitializeEmmcDevice (MmcHostInstance
);
784 if (EFI_ERROR (Status
)) {
789 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD16
, MmcHostInstance
->BlockIo
.Media
->BlockSize
);
790 if (EFI_ERROR (Status
)) {
791 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(MMC_CMD16): Error MmcHostInstance->BlockIo.Media->BlockSize: %d and Error = %r\n",
792 MmcHostInstance
->BlockIo
.Media
->BlockSize
, Status
));
796 // Block Count (not used). Could return an error for SD card
797 if (MmcHostInstance
->CardInfo
.CardType
== MMC_CARD
) {
798 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD23
, BlockCount
);
799 if (EFI_ERROR (Status
)) {
800 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(MMC_CMD23): Error, Status=%r\n", Status
));