3 * Copyright (c) 2011-2015, ARM Limited. All rights reserved.
5 * SPDX-License-Identifier: BSD-2-Clause-Patent
9 #include <Library/BaseMemoryLib.h>
15 IN MMC_HOST_INSTANCE
*MmcHostInstance
,
19 MmcHostInstance
->State
= State
;
20 return MmcHostInstance
->MmcHost
->NotifyState (MmcHostInstance
->MmcHost
, State
);
26 IN MMC_HOST_INSTANCE
*MmcHostInstance
32 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
35 MmcHost
= MmcHostInstance
->MmcHost
;
38 if (MmcHost
== NULL
) {
39 return EFI_INVALID_PARAMETER
;
41 if (MmcHostInstance
->State
!= MmcHwInitializationState
) {
42 //Get the Status of the card.
43 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
44 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD13
, CmdArg
);
45 if (EFI_ERROR (Status
)) {
46 DEBUG ((EFI_D_ERROR
, "MmcGetCardStatus(MMC_CMD13): Error and Status = %r\n", Status
));
51 MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R1
, Response
);
52 PrintResponseR1 (Response
[0]);
61 IN EFI_BLOCK_IO_PROTOCOL
*This
,
62 IN BOOLEAN ExtendedVerification
65 MMC_HOST_INSTANCE
*MmcHostInstance
;
67 MmcHostInstance
= MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS (This
);
69 if (MmcHostInstance
->MmcHost
== NULL
) {
74 // If a card is not present then clear all media settings
75 if (!MmcHostInstance
->MmcHost
->IsCardPresent (MmcHostInstance
->MmcHost
)) {
76 MmcHostInstance
->BlockIo
.Media
->MediaPresent
= FALSE
;
77 MmcHostInstance
->BlockIo
.Media
->LastBlock
= 0;
78 MmcHostInstance
->BlockIo
.Media
->BlockSize
= 512; // Should be zero but there is a bug in DiskIo
79 MmcHostInstance
->BlockIo
.Media
->ReadOnly
= FALSE
;
81 // Indicate that the driver requires initialization
82 MmcHostInstance
->State
= MmcHwInitializationState
;
87 // Implement me. Either send a CMD0 (could not work for some MMC host) or just turn off/turn
88 // on power and restart Identification mode
94 EFI_MMC_HOST_PROTOCOL
*MmcHost
97 if (!MmcHost
->IsCardPresent (MmcHost
)) {
105 MmcStopTransmission (
106 EFI_MMC_HOST_PROTOCOL
*MmcHost
111 // Command 12 - Stop transmission (ends read or write)
112 // Normally only needed for streaming transfers or after error.
113 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD12
, 0);
114 if (!EFI_ERROR (Status
)) {
115 MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R1b
, Response
);
120 #define MMCI0_BLOCKLEN 512
121 #define MMCI0_TIMEOUT 10000
126 IN EFI_BLOCK_IO_PROTOCOL
*This
,
139 MMC_HOST_INSTANCE
*MmcHostInstance
;
140 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
142 MmcHostInstance
= MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS (This
);
143 MmcHost
= MmcHostInstance
->MmcHost
;
145 if (MmcHostInstance
->CardInfo
.CardType
!= EMMC_CARD
) {
146 //Set command argument based on the card capacity
149 if (MmcHostInstance
->CardInfo
.OCRData
.AccessMode
& SD_CARD_CAPACITY
) {
152 CmdArg
= Lba
* This
->Media
->BlockSize
;
155 //Set command argument based on the card access mode (Byte mode or Block mode)
156 if ((MmcHostInstance
->CardInfo
.OCRData
.AccessMode
& MMC_OCR_ACCESS_MASK
) ==
157 MMC_OCR_ACCESS_SECTOR
) {
160 CmdArg
= Lba
* This
->Media
->BlockSize
;
164 Status
= MmcHost
->SendCommand (MmcHost
, Cmd
, CmdArg
);
165 if (EFI_ERROR (Status
)) {
166 DEBUG ((EFI_D_ERROR
, "%a(MMC_CMD%d): Error %r\n", __func__
, Cmd
, Status
));
170 if (Transfer
== MMC_IOBLOCKS_READ
) {
172 Status
= MmcHost
->ReadBlockData (MmcHost
, Lba
, BufferSize
, Buffer
);
173 if (EFI_ERROR (Status
)) {
174 DEBUG ((EFI_D_BLKIO
, "%a(): Error Read Block Data and Status = %r\n", __func__
, Status
));
175 MmcStopTransmission (MmcHost
);
178 Status
= MmcNotifyState (MmcHostInstance
, MmcProgrammingState
);
179 if (EFI_ERROR (Status
)) {
180 DEBUG ((EFI_D_ERROR
, "%a() : Error MmcProgrammingState\n", __func__
));
185 Status
= MmcHost
->WriteBlockData (MmcHost
, Lba
, BufferSize
, Buffer
);
186 if (EFI_ERROR (Status
)) {
187 DEBUG ((EFI_D_BLKIO
, "%a(): Error Write Block Data and Status = %r\n", __func__
, Status
));
188 MmcStopTransmission (MmcHost
);
193 // Command 13 - Read status and wait for programming to complete (return to tran)
194 Timeout
= MMCI0_TIMEOUT
;
195 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
197 while(!(Response
[0] & MMC_R0_READY_FOR_DATA
)
198 && (MMC_R0_CURRENTSTATE (Response
) != MMC_R0_STATE_TRAN
)
200 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD13
, CmdArg
);
201 if (!EFI_ERROR (Status
)) {
202 MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R1
, Response
);
203 if (Response
[0] & MMC_R0_READY_FOR_DATA
) {
204 break; // Prevents delay once finished
209 if (BufferSize
> This
->Media
->BlockSize
) {
210 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD12
, 0);
211 if (EFI_ERROR (Status
)) {
212 DEBUG ((EFI_D_BLKIO
, "%a(): Error and Status:%r\n", __func__
, Status
));
214 MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R1b
, Response
);
217 Status
= MmcNotifyState (MmcHostInstance
, MmcTransferState
);
218 if (EFI_ERROR (Status
)) {
219 DEBUG ((EFI_D_ERROR
, "MmcIoBlocks() : Error MmcTransferState\n"));
227 IN EFI_BLOCK_IO_PROTOCOL
*This
,
240 MMC_HOST_INSTANCE
*MmcHostInstance
;
241 EFI_MMC_HOST_PROTOCOL
*MmcHost
;
242 UINTN BytesRemainingToBeTransfered
;
247 MmcHostInstance
= MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS (This
);
248 ASSERT (MmcHostInstance
!= NULL
);
249 MmcHost
= MmcHostInstance
->MmcHost
;
252 if (This
->Media
->MediaId
!= MediaId
) {
253 return EFI_MEDIA_CHANGED
;
256 if ((MmcHost
== NULL
) || (Buffer
== NULL
)) {
257 return EFI_INVALID_PARAMETER
;
260 // Check if a Card is Present
261 if (!MmcHostInstance
->BlockIo
.Media
->MediaPresent
) {
265 if (MMC_HOST_HAS_ISMULTIBLOCK(MmcHost
) && MmcHost
->IsMultiBlock(MmcHost
)) {
266 BlockCount
= (BufferSize
+ This
->Media
->BlockSize
- 1) / This
->Media
->BlockSize
;
269 // All blocks must be within the device
270 if ((Lba
+ (BufferSize
/ This
->Media
->BlockSize
)) > (This
->Media
->LastBlock
+ 1)) {
271 return EFI_INVALID_PARAMETER
;
274 if ((Transfer
== MMC_IOBLOCKS_WRITE
) && (This
->Media
->ReadOnly
== TRUE
)) {
275 return EFI_WRITE_PROTECTED
;
278 // Reading 0 Byte is valid
279 if (BufferSize
== 0) {
283 // The buffer size must be an exact multiple of the block size
284 if ((BufferSize
% This
->Media
->BlockSize
) != 0) {
285 return EFI_BAD_BUFFER_SIZE
;
288 // Check the alignment
289 if ((This
->Media
->IoAlign
> 2) && (((UINTN
)Buffer
& (This
->Media
->IoAlign
- 1)) != 0)) {
290 return EFI_INVALID_PARAMETER
;
293 BytesRemainingToBeTransfered
= BufferSize
;
294 while (BytesRemainingToBeTransfered
> 0) {
296 // Check if the Card is in Ready status
297 CmdArg
= MmcHostInstance
->CardInfo
.RCA
<< 16;
300 while( (!(Response
[0] & MMC_R0_READY_FOR_DATA
))
301 && (MMC_R0_CURRENTSTATE (Response
) != MMC_R0_STATE_TRAN
)
303 Status
= MmcHost
->SendCommand (MmcHost
, MMC_CMD13
, CmdArg
);
304 if (!EFI_ERROR (Status
)) {
305 MmcHost
->ReceiveResponse (MmcHost
, MMC_RESPONSE_TYPE_R1
, Response
);
310 DEBUG ((EFI_D_ERROR
, "The Card is busy\n"));
311 return EFI_NOT_READY
;
314 if (Transfer
== MMC_IOBLOCKS_READ
) {
315 if (BlockCount
== 1) {
316 // Read a single block
319 // Read multiple blocks
323 if (BlockCount
== 1) {
324 // Write a single block
327 // Write multiple blocks
332 ConsumeSize
= BlockCount
* This
->Media
->BlockSize
;
333 if (BytesRemainingToBeTransfered
< ConsumeSize
) {
334 ConsumeSize
= BytesRemainingToBeTransfered
;
336 Status
= MmcTransferBlock (This
, Cmd
, Transfer
, MediaId
, Lba
, ConsumeSize
, Buffer
);
337 if (EFI_ERROR (Status
)) {
338 DEBUG ((EFI_D_ERROR
, "%a(): Failed to transfer block and Status:%r\n", __func__
, Status
));
341 BytesRemainingToBeTransfered
-= ConsumeSize
;
342 if (BytesRemainingToBeTransfered
> 0) {
344 Buffer
= (UINT8
*)Buffer
+ ConsumeSize
;
354 IN EFI_BLOCK_IO_PROTOCOL
*This
,
361 return MmcIoBlocks (This
, MMC_IOBLOCKS_READ
, MediaId
, Lba
, BufferSize
, Buffer
);
367 IN EFI_BLOCK_IO_PROTOCOL
*This
,
374 return MmcIoBlocks (This
, MMC_IOBLOCKS_WRITE
, MediaId
, Lba
, BufferSize
, Buffer
);
380 IN EFI_BLOCK_IO_PROTOCOL
*This