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_INFO
, "%a : High Speed not supported by Card\n", __FUNCTION__
));
478 Speed
= SD_HIGH_SPEED
;
480 /* SD Switch, Mode:1, Group:0, Value:1 */
481 CmdArg
= CreateSwitchCmdArgument(1, 0, 1);
482 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD6
, CmdArg
);
483 if (EFI_ERROR (Status
)) {
484 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): Error and Status = %r\n", __FUNCTION__
, Status
));
487 Status
= MmcHost
->ReadBlockData (MmcHost
, 0, SWITCH_CMD_DATA_LENGTH
, Buffer
);
488 if (EFI_ERROR (Status
)) {
489 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): ReadBlockData Error and Status = %r\n", __FUNCTION__
, Status
));
493 if ((Buffer
[4] & SWITCH_CMD_SUCCESS_MASK
) != 0x01000000) {
494 DEBUG((DEBUG_ERROR
, "Problem switching SD card into high-speed mode\n"));
500 if (Scr
.SD_BUS_WIDTHS
& SD_BUS_WIDTH_4BIT
) {
501 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
502 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD55
, CmdArg
);
503 if (EFI_ERROR (Status
)) {
504 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD55): Error and Status = %r\n", __FUNCTION__
, Status
));
508 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD6
, 2);
509 if (EFI_ERROR (Status
)) {
510 DEBUG ((DEBUG_ERROR
, "%a (MMC_CMD6): Error and Status = %r\n", __FUNCTION__
, Status
));
514 if (MMC_HOST_HAS_SETIOS(MmcHost
)) {
515 Status
= MmcHost
->SetIos (MmcHost
, Speed
, BUSWIDTH_4
, EMMCBACKWARD
);
516 if (EFI_ERROR (Status
)) {
517 DEBUG ((DEBUG_ERROR
, "%a (SetIos): Error and Status = %r\n", __FUNCTION__
, Status
));
527 MmcIdentificationMode (
528 IN MMC_HOST_INSTANCE
*MmcHostInstance
536 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
537 OCR_RESPONSE OcrResponse
;
539 MmcHost
= MmcHostInstance
->MmcHost
;
543 if (MmcHost
== NULL
) {
544 return EFI_INVALID_PARAMETER
;
547 // We can get into this function if we restart the identification mode
548 if (MmcHostInstance
->State
== MmcHwInitializationState
) {
549 // Initialize the MMC Host HW
550 Status
= MmcNotifyState (MmcHostInstance
, MmcHwInitializationState
);
551 if (EFI_ERROR (Status
)) {
552 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcHwInitializationState, Status=%r.\n", Status
));
557 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD0
, 0);
558 if (EFI_ERROR (Status
)) {
559 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD0): Error, Status=%r.\n", Status
));
562 Status
= MmcNotifyState (MmcHostInstance
, MmcIdleState
);
563 if (EFI_ERROR (Status
)) {
564 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcIdleState, Status=%r.\n", Status
));
568 // Send CMD1 to get OCR (MMC)
569 // This command only valid for MMC and eMMC
570 Timeout
= MAX_RETRY_COUNT
;
572 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD1
, EMMC_CMD1_CAPACITY_GREATER_THAN_2GB
);
573 if (EFI_ERROR (Status
))
575 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_OCR
, (UINT32
*)&OcrResponse
);
576 if (EFI_ERROR (Status
)) {
577 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status
));
581 } while (!OcrResponse
.Ocr
.PowerUp
&& (Timeout
> 0));
582 if (Status
== EFI_SUCCESS
) {
583 if (!OcrResponse
.Ocr
.PowerUp
) {
584 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD1): Card initialisation failure, Status=%r.\n", Status
));
585 return EFI_DEVICE_ERROR
;
587 OcrResponse
.Ocr
.PowerUp
= 0;
588 if (OcrResponse
.Raw
== EMMC_CMD1_CAPACITY_GREATER_THAN_2GB
) {
589 MmcHostInstance
->CardInfo
.OCRData
.AccessMode
= BIT1
;
592 MmcHostInstance
->CardInfo
.OCRData
.AccessMode
= 0x0;
594 // Check whether MMC or eMMC
595 if (OcrResponse
.Raw
== EMMC_CMD1_CAPACITY_GREATER_THAN_2GB
||
596 OcrResponse
.Raw
== EMMC_CMD1_CAPACITY_LESS_THAN_2GB
) {
597 return EmmcIdentificationMode (MmcHostInstance
, OcrResponse
);
601 // Are we using SDIO ?
602 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD5
, 0);
603 if (Status
== EFI_SUCCESS
) {
604 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD5): Error - SDIO not supported, Status=%r.\n", Status
));
605 return EFI_UNSUPPORTED
;
608 // Check which kind of card we are using. Ver2.00 or later SD Memory Card (PL180 is SD v1.1)
609 CmdArg
= (0x0UL
<< 12 | BIT8
| 0xCEUL
<< 0);
610 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD8
, CmdArg
);
611 if (Status
== EFI_SUCCESS
) {
612 DEBUG ((EFI_D_ERROR
, "Card is SD2.0 => Supports high capacity\n"));
614 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R7
, Response
);
615 if (EFI_ERROR (Status
)) {
616 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive response to CMD8, Status=%r.\n", Status
));
619 PrintResponseR1 (Response
[0]);
620 // Check if it is valid response
621 if (Response
[0] != CmdArg
) {
622 DEBUG ((EFI_D_ERROR
, "The Card is not usable\n"));
623 return EFI_UNSUPPORTED
;
626 DEBUG ((EFI_D_ERROR
, "Not a SD2.0 Card\n"));
629 // We need to wait for the MMC or SD card is ready => (gCardInfo.OCRData.PowerUp == 1)
630 Timeout
= MAX_RETRY_COUNT
;
631 while (Timeout
> 0) {
632 // SD Card or MMC Card ? CMD55 indicates to the card that the next command is an application specific command
633 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD55
, 0);
634 if (Status
== EFI_SUCCESS
) {
635 DEBUG ((EFI_D_INFO
, "Card should be SD\n"));
637 MmcHostInstance
->CardInfo
.CardType
= SD_CARD_2
;
639 MmcHostInstance
->CardInfo
.CardType
= SD_CARD
;
642 // Note: The first time CmdArg will be zero
643 CmdArg
= ((UINTN
*) &(MmcHostInstance
->CardInfo
.OCRData
))[0];
647 Status
= MmcHost
->SendCommand (MmcHost
, MMC_ACMD41
, CmdArg
);
648 if (!EFI_ERROR (Status
)) {
649 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_OCR
, Response
);
650 if (EFI_ERROR (Status
)) {
651 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status
));
654 ((UINT32
*) &(MmcHostInstance
->CardInfo
.OCRData
))[0] = Response
[0];
657 DEBUG ((EFI_D_INFO
, "Card should be MMC\n"));
658 MmcHostInstance
->CardInfo
.CardType
= MMC_CARD
;
660 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD1
, 0x800000);
661 if (!EFI_ERROR (Status
)) {
662 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_OCR
, Response
);
663 if (EFI_ERROR (Status
)) {
664 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status
));
667 ((UINT32
*) &(MmcHostInstance
->CardInfo
.OCRData
))[0] = Response
[0];
671 if (!EFI_ERROR (Status
)) {
672 if (!MmcHostInstance
->CardInfo
.OCRData
.PowerUp
) {
676 if ((MmcHostInstance
->CardInfo
.CardType
== SD_CARD_2
) && (MmcHostInstance
->CardInfo
.OCRData
.AccessMode
& BIT1
)) {
677 MmcHostInstance
->CardInfo
.CardType
= SD_CARD_2_HIGH
;
678 DEBUG ((EFI_D_ERROR
, "High capacity card.\n"));
680 break; // The MMC/SD card is ready. Continue the Identification Mode
689 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(): No Card\n"));
692 PrintOCR (Response
[0]);
695 Status
= MmcNotifyState (MmcHostInstance
, MmcReadyState
);
696 if (EFI_ERROR (Status
)) {
697 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcReadyState\n"));
701 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD2
, 0);
702 if (EFI_ERROR (Status
)) {
703 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD2): Error\n"));
706 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_CID
, Response
);
707 if (EFI_ERROR (Status
)) {
708 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive CID, Status=%r.\n", Status
));
714 Status
= MmcHost
->NotifyState (MmcHost
, MmcIdentificationState
);
715 if (EFI_ERROR (Status
)) {
716 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcIdentificationState\n"));
721 // Note, SD specifications say that "if the command execution causes a state change, it
722 // will be visible to the host in the response to the next command"
723 // The status returned for this CMD3 will be 2 - identification
726 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD3
, CmdArg
);
727 if (EFI_ERROR (Status
)) {
728 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode(MMC_CMD3): Error\n"));
732 Status
= MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_RCA
, Response
);
733 if (EFI_ERROR (Status
)) {
734 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Failed to receive RCA, Status=%r.\n", Status
));
737 PrintRCA (Response
[0]);
739 // For MMC card, RCA is assigned by CMD3 while CMD3 dumps the RCA for SD card
740 if (MmcHostInstance
->CardInfo
.CardType
!= MMC_CARD
) {
741 MmcHostInstance
->CardInfo
.RCA
= Response
[0] >> 16;
743 MmcHostInstance
->CardInfo
.RCA
= CmdArg
;
745 Status
= MmcNotifyState (MmcHostInstance
, MmcStandByState
);
746 if (EFI_ERROR (Status
)) {
747 DEBUG ((EFI_D_ERROR
, "MmcIdentificationMode() : Error MmcStandByState\n"));
755 InitializeMmcDevice (
756 IN MMC_HOST_INSTANCE
*MmcHostInstance
760 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
764 MmcHost
= MmcHostInstance
->MmcHost
;
766 Status
= MmcIdentificationMode (MmcHostInstance
);
767 if (EFI_ERROR (Status
)) {
768 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(): Error in Identification Mode, Status=%r\n", Status
));
772 Status
= MmcNotifyState (MmcHostInstance
, MmcTransferState
);
773 if (EFI_ERROR (Status
)) {
774 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(): Error MmcTransferState, Status=%r\n", Status
));
778 if (MmcHostInstance
->CardInfo
.CardType
!= EMMC_CARD
) {
779 Status
= InitializeSdMmcDevice (MmcHostInstance
);
781 Status
= InitializeEmmcDevice (MmcHostInstance
);
783 if (EFI_ERROR (Status
)) {
788 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD16
, MmcHostInstance
->BlockIo
.Media
->BlockSize
);
789 if (EFI_ERROR (Status
)) {
790 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(MMC_CMD16): Error MmcHostInstance->BlockIo.Media->BlockSize: %d and Error = %r\n",
791 MmcHostInstance
->BlockIo
.Media
->BlockSize
, Status
));
795 // Block Count (not used). Could return an error for SD card
796 if (MmcHostInstance
->CardInfo
.CardType
== MMC_CARD
) {
797 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD23
, BlockCount
);
798 if (EFI_ERROR (Status
)) {
799 DEBUG((EFI_D_ERROR
, "InitializeMmcDevice(MMC_CMD23): Error, Status=%r\n", Status
));