2 This file provides some helper functions which are specific for EMMC device.
4 Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
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 "SdMmcPciHcDxe.h"
18 Send command GO_IDLE_STATE (CMD0 with argument of 0x00000000) to the device to
19 make it go to Idle State.
21 Refer to EMMC Electrical Standard Spec 5.1 Section 6.4 for details.
23 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
24 @param[in] Slot The slot number of the SD card to send the command to.
26 @retval EFI_SUCCESS The EMMC device is reset correctly.
27 @retval Others The device reset fails.
32 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
36 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
37 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
38 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
41 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
42 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
43 ZeroMem (&Packet
, sizeof (Packet
));
45 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
46 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
47 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
49 SdMmcCmdBlk
.CommandIndex
= EMMC_GO_IDLE_STATE
;
50 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeBc
;
51 SdMmcCmdBlk
.ResponseType
= 0;
52 SdMmcCmdBlk
.CommandArgument
= 0;
56 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
62 Send command SEND_OP_COND to the EMMC device to get the data of the OCR register.
64 Refer to EMMC Electrical Standard Spec 5.1 Section 6.4 for details.
66 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
67 @param[in] Slot The slot number of the SD card to send the command to.
68 @param[in, out] Argument On input, the argument of SEND_OP_COND is to send to the device.
69 On output, the argument is the value of OCR register.
71 @retval EFI_SUCCESS The operation is done correctly.
72 @retval Others The operation fails.
77 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
79 IN OUT UINT32
*Argument
82 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
83 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
84 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
87 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
88 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
89 ZeroMem (&Packet
, sizeof (Packet
));
91 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
92 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
93 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
95 SdMmcCmdBlk
.CommandIndex
= EMMC_SEND_OP_COND
;
96 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeBcr
;
97 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR3
;
98 SdMmcCmdBlk
.CommandArgument
= *Argument
;
100 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
101 if (!EFI_ERROR (Status
)) {
103 // For details, refer to SD Host Controller Simplified Spec 3.0 Table 2-12.
105 *Argument
= SdMmcStatusBlk
.Resp0
;
112 Broadcast command ALL_SEND_CID to the bus to ask all the EMMC devices to send the
113 data of their CID registers.
115 Refer to EMMC Electrical Standard Spec 5.1 Section 6.4 for details.
117 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
118 @param[in] Slot The slot number of the SD card to send the command to.
120 @retval EFI_SUCCESS The operation is done correctly.
121 @retval Others The operation fails.
126 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
130 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
131 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
132 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
135 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
136 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
137 ZeroMem (&Packet
, sizeof (Packet
));
139 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
140 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
141 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
143 SdMmcCmdBlk
.CommandIndex
= EMMC_ALL_SEND_CID
;
144 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeBcr
;
145 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR2
;
146 SdMmcCmdBlk
.CommandArgument
= 0;
148 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
154 Send command SET_RELATIVE_ADDR to the EMMC device to assign a Relative device
157 Refer to EMMC Electrical Standard Spec 5.1 Section 6.4 for details.
159 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
160 @param[in] Slot The slot number of the SD card to send the command to.
161 @param[in] Rca The relative device address to be assigned.
163 @retval EFI_SUCCESS The operation is done correctly.
164 @retval Others The operation fails.
169 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
174 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
175 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
176 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
179 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
180 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
181 ZeroMem (&Packet
, sizeof (Packet
));
183 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
184 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
185 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
187 SdMmcCmdBlk
.CommandIndex
= EMMC_SET_RELATIVE_ADDR
;
188 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAc
;
189 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR1
;
190 SdMmcCmdBlk
.CommandArgument
= (UINT32
)Rca
<< 16;
192 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
198 Send command SEND_CSD to the EMMC device to get the data of the CSD register.
200 Refer to EMMC Electrical Standard Spec 5.1 Section 6.10.4 for details.
202 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
203 @param[in] Slot The slot number of the SD card to send the command to.
204 @param[in] Rca The relative device address of selected device.
205 @param[out] Csd The buffer to store the content of the CSD register.
206 Note the caller should ignore the lowest byte of this
207 buffer as the content of this byte is meaningless even
208 if the operation succeeds.
210 @retval EFI_SUCCESS The operation is done correctly.
211 @retval Others The operation fails.
216 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
222 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
223 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
224 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
227 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
228 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
229 ZeroMem (&Packet
, sizeof (Packet
));
231 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
232 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
233 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
235 SdMmcCmdBlk
.CommandIndex
= EMMC_SEND_CSD
;
236 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAc
;
237 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR2
;
238 SdMmcCmdBlk
.CommandArgument
= (UINT32
)Rca
<< 16;
240 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
241 if (!EFI_ERROR (Status
)) {
243 // For details, refer to SD Host Controller Simplified Spec 3.0 Table 2-12.
245 CopyMem (((UINT8
*)Csd
) + 1, &SdMmcStatusBlk
.Resp0
, sizeof (EMMC_CSD
) - 1);
252 Send command SELECT_DESELECT_CARD to the EMMC device to select/deselect it.
254 Refer to EMMC Electrical Standard Spec 5.1 Section 6.10.4 for details.
256 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
257 @param[in] Slot The slot number of the SD card to send the command to.
258 @param[in] Rca The relative device address of selected device.
260 @retval EFI_SUCCESS The operation is done correctly.
261 @retval Others The operation fails.
266 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
271 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
272 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
273 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
276 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
277 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
278 ZeroMem (&Packet
, sizeof (Packet
));
280 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
281 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
282 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
284 SdMmcCmdBlk
.CommandIndex
= EMMC_SELECT_DESELECT_CARD
;
285 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAc
;
286 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR1
;
287 SdMmcCmdBlk
.CommandArgument
= (UINT32
)Rca
<< 16;
289 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
295 Send command SEND_EXT_CSD to the EMMC device to get the data of the EXT_CSD register.
297 Refer to EMMC Electrical Standard Spec 5.1 Section 6.10.4 for details.
299 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
300 @param[in] Slot The slot number of the SD card to send the command to.
301 @param[out] ExtCsd The buffer to store the content of the EXT_CSD register.
303 @retval EFI_SUCCESS The operation is done correctly.
304 @retval Others The operation fails.
309 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
311 OUT EMMC_EXT_CSD
*ExtCsd
314 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
315 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
316 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
319 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
320 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
321 ZeroMem (&Packet
, sizeof (Packet
));
323 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
324 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
325 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
327 SdMmcCmdBlk
.CommandIndex
= EMMC_SEND_EXT_CSD
;
328 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAdtc
;
329 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR1
;
330 SdMmcCmdBlk
.CommandArgument
= 0x00000000;
332 Packet
.InDataBuffer
= ExtCsd
;
333 Packet
.InTransferLength
= sizeof (EMMC_EXT_CSD
);
335 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
340 Send command SWITCH to the EMMC device to switch the mode of operation of the
341 selected Device or modifies the EXT_CSD registers.
343 Refer to EMMC Electrical Standard Spec 5.1 Section 6.10.4 for details.
345 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
346 @param[in] Slot The slot number of the SD card to send the command to.
347 @param[in] Access The access mode of SWTICH command.
348 @param[in] Index The offset of the field to be access.
349 @param[in] Value The value to be set to the specified field of EXT_CSD register.
350 @param[in] CmdSet The value of CmdSet field of EXT_CSD register.
352 @retval EFI_SUCCESS The operation is done correctly.
353 @retval Others The operation fails.
358 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
366 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
367 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
368 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
371 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
372 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
373 ZeroMem (&Packet
, sizeof (Packet
));
375 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
376 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
377 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
379 SdMmcCmdBlk
.CommandIndex
= EMMC_SWITCH
;
380 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAc
;
381 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR1b
;
382 SdMmcCmdBlk
.CommandArgument
= (Access
<< 24) | (Index
<< 16) | (Value
<< 8) | CmdSet
;
384 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
390 Send command SEND_STATUS to the addressed EMMC device to get its status register.
392 Refer to EMMC Electrical Standard Spec 5.1 Section 6.10.4 for details.
394 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
395 @param[in] Slot The slot number of the SD card to send the command to.
396 @param[in] Rca The relative device address of addressed device.
397 @param[out] DevStatus The returned device status.
399 @retval EFI_SUCCESS The operation is done correctly.
400 @retval Others The operation fails.
405 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
408 OUT UINT32
*DevStatus
411 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
412 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
413 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
416 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
417 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
418 ZeroMem (&Packet
, sizeof (Packet
));
420 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
421 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
422 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
424 SdMmcCmdBlk
.CommandIndex
= EMMC_SEND_STATUS
;
425 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAc
;
426 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR1
;
427 SdMmcCmdBlk
.CommandArgument
= (UINT32
)Rca
<< 16;
429 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
430 if (!EFI_ERROR (Status
)) {
431 *DevStatus
= SdMmcStatusBlk
.Resp0
;
438 Send command SEND_TUNING_BLOCK to the EMMC device for HS200 optimal sampling point
441 It may be sent up to 40 times until the host finishes the tuning procedure.
443 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 for details.
445 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
446 @param[in] Slot The slot number of the SD card to send the command to.
447 @param[in] BusWidth The bus width to work.
449 @retval EFI_SUCCESS The operation is done correctly.
450 @retval Others The operation fails.
455 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
460 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk
;
461 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk
;
462 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet
;
464 UINT8 TuningBlock
[128];
466 ZeroMem (&SdMmcCmdBlk
, sizeof (SdMmcCmdBlk
));
467 ZeroMem (&SdMmcStatusBlk
, sizeof (SdMmcStatusBlk
));
468 ZeroMem (&Packet
, sizeof (Packet
));
470 Packet
.SdMmcCmdBlk
= &SdMmcCmdBlk
;
471 Packet
.SdMmcStatusBlk
= &SdMmcStatusBlk
;
472 Packet
.Timeout
= SD_MMC_HC_GENERIC_TIMEOUT
;
474 SdMmcCmdBlk
.CommandIndex
= EMMC_SEND_TUNING_BLOCK
;
475 SdMmcCmdBlk
.CommandType
= SdMmcCommandTypeAdtc
;
476 SdMmcCmdBlk
.ResponseType
= SdMmcResponseTypeR1
;
477 SdMmcCmdBlk
.CommandArgument
= 0;
479 Packet
.InDataBuffer
= TuningBlock
;
481 Packet
.InTransferLength
= sizeof (TuningBlock
);
483 Packet
.InTransferLength
= 64;
486 Status
= SdMmcPassThruPassThru (PassThru
, Slot
, &Packet
, NULL
);
492 Tunning the clock to get HS200 optimal sampling point.
494 Command SEND_TUNING_BLOCK may be sent up to 40 times until the host finishes the
497 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller
498 Simplified Spec 3.0 Figure 2-29 for details.
500 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
501 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
502 @param[in] Slot The slot number of the SD card to send the command to.
503 @param[in] BusWidth The bus width to work.
505 @retval EFI_SUCCESS The operation is done correctly.
506 @retval Others The operation fails.
510 EmmcTuningClkForHs200 (
511 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
512 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
522 // Notify the host that the sampling clock tuning procedure starts.
525 Status
= SdMmcHcOrMmio (PciIo
, Slot
, SD_MMC_HC_HOST_CTRL2
, sizeof (HostCtrl2
), &HostCtrl2
);
526 if (EFI_ERROR (Status
)) {
530 // Ask the device to send a sequence of tuning blocks till the tuning procedure is done.
534 Status
= EmmcSendTuningBlk (PassThru
, Slot
, BusWidth
);
535 if (EFI_ERROR (Status
)) {
536 DEBUG ((DEBUG_ERROR
, "EmmcTuningClkForHs200: Send tuning block fails with %r\n", Status
));
540 Status
= SdMmcHcRwMmio (PciIo
, Slot
, SD_MMC_HC_HOST_CTRL2
, TRUE
, sizeof (HostCtrl2
), &HostCtrl2
);
541 if (EFI_ERROR (Status
)) {
545 if ((HostCtrl2
& (BIT6
| BIT7
)) == 0) {
549 if ((HostCtrl2
& (BIT6
| BIT7
)) == BIT7
) {
552 } while (++Retry
< 40);
554 DEBUG ((DEBUG_ERROR
, "EmmcTuningClkForHs200: Send tuning block fails at %d times with HostCtrl2 %02x\n", Retry
, HostCtrl2
));
556 // Abort the tuning procedure and reset the tuning circuit.
558 HostCtrl2
= (UINT8
)~(BIT6
| BIT7
);
559 Status
= SdMmcHcAndMmio (PciIo
, Slot
, SD_MMC_HC_HOST_CTRL2
, sizeof (HostCtrl2
), &HostCtrl2
);
560 if (EFI_ERROR (Status
)) {
563 return EFI_DEVICE_ERROR
;
567 Switch the bus width to specified width.
569 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.9 and SD Host Controller
570 Simplified Spec 3.0 Figure 3-7 for details.
572 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
573 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
574 @param[in] Slot The slot number of the SD card to send the command to.
575 @param[in] Rca The relative device address to be assigned.
576 @param[in] IsDdr If TRUE, use dual data rate data simpling method. Otherwise
577 use single data rate data simpling method.
578 @param[in] BusWidth The bus width to be set, it could be 4 or 8.
580 @retval EFI_SUCCESS The operation is done correctly.
581 @retval Others The operation fails.
586 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
587 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
602 // Write Byte, the Value field is written into the byte pointed by Index.
605 Index
= OFFSET_OF (EMMC_EXT_CSD
, BusWidth
);
608 } else if (BusWidth
== 8) {
611 return EFI_INVALID_PARAMETER
;
619 Status
= EmmcSwitch (PassThru
, Slot
, Access
, Index
, Value
, CmdSet
);
620 if (EFI_ERROR (Status
)) {
621 DEBUG ((DEBUG_ERROR
, "EmmcSwitchBusWidth: Switch to bus width %d fails with %r\n", BusWidth
, Status
));
625 Status
= EmmcSendStatus (PassThru
, Slot
, Rca
, &DevStatus
);
626 if (EFI_ERROR (Status
)) {
627 DEBUG ((DEBUG_ERROR
, "EmmcSwitchBusWidth: Send status fails with %r\n", Status
));
631 // Check the switch operation is really successful or not.
633 if ((DevStatus
& BIT7
) != 0) {
634 DEBUG ((DEBUG_ERROR
, "EmmcSwitchBusWidth: The switch operation fails as DevStatus is 0x%08x\n", DevStatus
));
635 return EFI_DEVICE_ERROR
;
638 Status
= SdMmcHcSetBusWidth (PciIo
, Slot
, BusWidth
);
644 Switch the clock frequency to the specified value.
646 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6 and SD Host Controller
647 Simplified Spec 3.0 Figure 3-3 for details.
649 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
650 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
651 @param[in] Slot The slot number of the SD card to send the command to.
652 @param[in] Rca The relative device address to be assigned.
653 @param[in] HsTiming The value to be written to HS_TIMING field of EXT_CSD register.
654 @param[in] Timing The bus mode timing indicator.
655 @param[in] ClockFreq The max clock frequency to be set, the unit is MHz.
657 @retval EFI_SUCCESS The operation is done correctly.
658 @retval Others The operation fails.
662 EmmcSwitchClockFreq (
663 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
664 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
668 IN SD_MMC_BUS_MODE Timing
,
678 SD_MMC_HC_PRIVATE_DATA
*Private
;
680 Private
= SD_MMC_HC_PRIVATE_FROM_THIS (PassThru
);
682 // Write Byte, the Value field is written into the byte pointed by Index.
685 Index
= OFFSET_OF (EMMC_EXT_CSD
, HsTiming
);
689 Status
= EmmcSwitch (PassThru
, Slot
, Access
, Index
, Value
, CmdSet
);
690 if (EFI_ERROR (Status
)) {
691 DEBUG ((DEBUG_ERROR
, "EmmcSwitchClockFreq: Switch to hstiming %d fails with %r\n", HsTiming
, Status
));
695 Status
= EmmcSendStatus (PassThru
, Slot
, Rca
, &DevStatus
);
696 if (EFI_ERROR (Status
)) {
697 DEBUG ((DEBUG_ERROR
, "EmmcSwitchClockFreq: Send status fails with %r\n", Status
));
701 // Check the switch operation is really successful or not.
703 if ((DevStatus
& BIT7
) != 0) {
704 DEBUG ((DEBUG_ERROR
, "EmmcSwitchClockFreq: The switch operation fails as DevStatus is 0x%08x\n", DevStatus
));
705 return EFI_DEVICE_ERROR
;
708 // Convert the clock freq unit from MHz to KHz.
710 Status
= SdMmcHcClockSupply (PciIo
, Slot
, ClockFreq
* 1000, Private
->Capability
[Slot
]);
711 if (EFI_ERROR (Status
)) {
715 if (mOverride
!= NULL
&& mOverride
->NotifyPhase
!= NULL
) {
716 Status
= mOverride
->NotifyPhase (
717 Private
->ControllerHandle
,
719 EdkiiSdMmcSwitchClockFreqPost
,
722 if (EFI_ERROR (Status
)) {
725 "%a: SD/MMC switch clock freq post notifier callback failed - %r\n",
737 Switch to the High Speed timing according to request.
739 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller
740 Simplified Spec 3.0 Figure 2-29 for details.
742 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
743 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
744 @param[in] Slot The slot number of the SD card to send the command to.
745 @param[in] Rca The relative device address to be assigned.
746 @param[in] ClockFreq The max clock frequency to be set.
747 @param[in] IsDdr If TRUE, use dual data rate data simpling method. Otherwise
748 use single data rate data simpling method.
749 @param[in] BusWidth The bus width to be set, it could be 4 or 8.
751 @retval EFI_SUCCESS The operation is done correctly.
752 @retval Others The operation fails.
756 EmmcSwitchToHighSpeed (
757 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
758 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
769 SD_MMC_BUS_MODE Timing
;
770 SD_MMC_HC_PRIVATE_DATA
*Private
;
772 Private
= SD_MMC_HC_PRIVATE_FROM_THIS (PassThru
);
774 Status
= EmmcSwitchBusWidth (PciIo
, PassThru
, Slot
, Rca
, IsDdr
, BusWidth
);
775 if (EFI_ERROR (Status
)) {
779 // Set to Hight Speed timing
782 Status
= SdMmcHcOrMmio (PciIo
, Slot
, SD_MMC_HC_HOST_CTRL1
, sizeof (HostCtrl1
), &HostCtrl1
);
783 if (EFI_ERROR (Status
)) {
788 Timing
= SdMmcMmcHsDdr
;
789 } else if (ClockFreq
== 52) {
790 Timing
= SdMmcMmcHsSdr
;
792 Timing
= SdMmcMmcLegacy
;
795 Status
= SdMmcHcUhsSignaling (Private
->ControllerHandle
, PciIo
, Slot
, Timing
);
796 if (EFI_ERROR (Status
)) {
801 Status
= EmmcSwitchClockFreq (PciIo
, PassThru
, Slot
, Rca
, HsTiming
, Timing
, ClockFreq
);
807 Switch to the HS200 timing according to request.
809 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller
810 Simplified Spec 3.0 Figure 2-29 for details.
812 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
813 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
814 @param[in] Slot The slot number of the SD card to send the command to.
815 @param[in] Rca The relative device address to be assigned.
816 @param[in] ClockFreq The max clock frequency to be set.
817 @param[in] BusWidth The bus width to be set, it could be 4 or 8.
819 @retval EFI_SUCCESS The operation is done correctly.
820 @retval Others The operation fails.
825 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
826 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
836 SD_MMC_BUS_MODE Timing
;
837 SD_MMC_HC_PRIVATE_DATA
*Private
;
839 Private
= SD_MMC_HC_PRIVATE_FROM_THIS (PassThru
);
841 if ((BusWidth
!= 4) && (BusWidth
!= 8)) {
842 return EFI_INVALID_PARAMETER
;
845 Status
= EmmcSwitchBusWidth (PciIo
, PassThru
, Slot
, Rca
, FALSE
, BusWidth
);
846 if (EFI_ERROR (Status
)) {
850 // Set to HS200/SDR104 timing
853 // Stop bus clock at first
855 Status
= SdMmcHcStopClock (PciIo
, Slot
);
856 if (EFI_ERROR (Status
)) {
860 Timing
= SdMmcMmcHs200
;
862 Status
= SdMmcHcUhsSignaling (Private
->ControllerHandle
, PciIo
, Slot
, Timing
);
863 if (EFI_ERROR (Status
)) {
868 // Wait Internal Clock Stable in the Clock Control register to be 1 before set SD Clock Enable bit
870 Status
= SdMmcHcWaitMmioSet (
873 SD_MMC_HC_CLOCK_CTRL
,
877 SD_MMC_HC_GENERIC_TIMEOUT
879 if (EFI_ERROR (Status
)) {
883 // Set SD Clock Enable in the Clock Control register to 1
886 Status
= SdMmcHcOrMmio (PciIo
, Slot
, SD_MMC_HC_CLOCK_CTRL
, sizeof (ClockCtrl
), &ClockCtrl
);
889 Status
= EmmcSwitchClockFreq (PciIo
, PassThru
, Slot
, Rca
, HsTiming
, Timing
, ClockFreq
);
890 if (EFI_ERROR (Status
)) {
894 Status
= EmmcTuningClkForHs200 (PciIo
, PassThru
, Slot
, BusWidth
);
900 Switch to the HS400 timing according to request.
902 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller
903 Simplified Spec 3.0 Figure 2-29 for details.
905 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
906 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
907 @param[in] Slot The slot number of the SD card to send the command to.
908 @param[in] Rca The relative device address to be assigned.
909 @param[in] ClockFreq The max clock frequency to be set.
911 @retval EFI_SUCCESS The operation is done correctly.
912 @retval Others The operation fails.
917 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
918 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
926 SD_MMC_BUS_MODE Timing
;
927 SD_MMC_HC_PRIVATE_DATA
*Private
;
929 Private
= SD_MMC_HC_PRIVATE_FROM_THIS (PassThru
);
931 Status
= EmmcSwitchToHS200 (PciIo
, PassThru
, Slot
, Rca
, ClockFreq
, 8);
932 if (EFI_ERROR (Status
)) {
936 // Set to Hight Speed timing and set the clock frequency to a value less than 52MHz.
939 Status
= EmmcSwitchClockFreq (PciIo
, PassThru
, Slot
, Rca
, HsTiming
, SdMmcMmcHsSdr
, 52);
940 if (EFI_ERROR (Status
)) {
944 // HS400 mode must use 8 data lines.
946 Status
= EmmcSwitchBusWidth (PciIo
, PassThru
, Slot
, Rca
, TRUE
, 8);
947 if (EFI_ERROR (Status
)) {
951 Timing
= SdMmcMmcHs400
;
953 Status
= SdMmcHcUhsSignaling (Private
->ControllerHandle
, PciIo
, Slot
, Timing
);
954 if (EFI_ERROR (Status
)) {
959 Status
= EmmcSwitchClockFreq (PciIo
, PassThru
, Slot
, Rca
, HsTiming
, Timing
, ClockFreq
);
965 Switch the high speed timing according to request.
967 Refer to EMMC Electrical Standard Spec 5.1 Section 6.6.8 and SD Host Controller
968 Simplified Spec 3.0 Figure 2-29 for details.
970 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.
971 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.
972 @param[in] Slot The slot number of the SD card to send the command to.
973 @param[in] Rca The relative device address to be assigned.
975 @retval EFI_SUCCESS The operation is done correctly.
976 @retval Others The operation fails.
981 IN EFI_PCI_IO_PROTOCOL
*PciIo
,
982 IN EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
,
994 SD_MMC_HC_PRIVATE_DATA
*Private
;
996 Private
= SD_MMC_HC_PRIVATE_FROM_THIS (PassThru
);
998 Status
= EmmcGetCsd (PassThru
, Slot
, Rca
, &Csd
);
999 if (EFI_ERROR (Status
)) {
1000 DEBUG ((DEBUG_ERROR
, "EmmcSetBusMode: GetCsd fails with %r\n", Status
));
1004 Status
= EmmcSelect (PassThru
, Slot
, Rca
);
1005 if (EFI_ERROR (Status
)) {
1006 DEBUG ((DEBUG_ERROR
, "EmmcSetBusMode: Select fails with %r\n", Status
));
1010 ASSERT (Private
->Capability
[Slot
].BaseClkFreq
!= 0);
1012 // Check if the Host Controller support 8bits bus width.
1014 if (Private
->Capability
[Slot
].BusWidth8
!= 0) {
1020 // Get Deivce_Type from EXT_CSD register.
1022 Status
= EmmcGetExtCsd (PassThru
, Slot
, &ExtCsd
);
1023 if (EFI_ERROR (Status
)) {
1024 DEBUG ((DEBUG_ERROR
, "EmmcSetBusMode: GetExtCsd fails with %r\n", Status
));
1028 // Calculate supported bus speed/bus width/clock frequency.
1033 if (((ExtCsd
.DeviceType
& (BIT4
| BIT5
)) != 0) && (Private
->Capability
[Slot
].Sdr104
!= 0)) {
1037 } else if (((ExtCsd
.DeviceType
& (BIT2
| BIT3
)) != 0) && (Private
->Capability
[Slot
].Ddr50
!= 0)) {
1041 } else if (((ExtCsd
.DeviceType
& BIT1
) != 0) && (Private
->Capability
[Slot
].HighSpeed
!= 0)) {
1045 } else if (((ExtCsd
.DeviceType
& BIT0
) != 0) && (Private
->Capability
[Slot
].HighSpeed
!= 0)) {
1051 // Check if both of the device and the host controller support HS400 DDR mode.
1053 if (((ExtCsd
.DeviceType
& (BIT6
| BIT7
)) != 0) && (Private
->Capability
[Slot
].Hs400
!= 0)) {
1055 // The host controller supports 8bits bus.
1057 ASSERT (BusWidth
== 8);
1063 if ((ClockFreq
== 0) || (HsTiming
== 0)) {
1065 // Continue using default setting.
1070 DEBUG ((DEBUG_INFO
, "EmmcSetBusMode: HsTiming %d ClockFreq %d BusWidth %d Ddr %a\n", HsTiming
, ClockFreq
, BusWidth
, IsDdr
? "TRUE":"FALSE"));
1072 if (HsTiming
== 3) {
1074 // Execute HS400 timing switch procedure
1076 Status
= EmmcSwitchToHS400 (PciIo
, PassThru
, Slot
, Rca
, ClockFreq
);
1077 } else if (HsTiming
== 2) {
1079 // Execute HS200 timing switch procedure
1081 Status
= EmmcSwitchToHS200 (PciIo
, PassThru
, Slot
, Rca
, ClockFreq
, BusWidth
);
1084 // Execute High Speed timing switch procedure
1086 Status
= EmmcSwitchToHighSpeed (PciIo
, PassThru
, Slot
, Rca
, ClockFreq
, IsDdr
, BusWidth
);
1089 DEBUG ((DEBUG_INFO
, "EmmcSetBusMode: Switch to %a %r\n", (HsTiming
== 3) ? "HS400" : ((HsTiming
== 2) ? "HS200" : "HighSpeed"), Status
));
1095 Execute EMMC device identification procedure.
1097 Refer to EMMC Electrical Standard Spec 5.1 Section 6.4 for details.
1099 @param[in] Private A pointer to the SD_MMC_HC_PRIVATE_DATA instance.
1100 @param[in] Slot The slot number of the SD card to send the command to.
1102 @retval EFI_SUCCESS There is a EMMC card.
1103 @retval Others There is not a EMMC card.
1107 EmmcIdentification (
1108 IN SD_MMC_HC_PRIVATE_DATA
*Private
,
1113 EFI_PCI_IO_PROTOCOL
*PciIo
;
1114 EFI_SD_MMC_PASS_THRU_PROTOCOL
*PassThru
;
1119 PciIo
= Private
->PciIo
;
1120 PassThru
= &Private
->PassThru
;
1122 Status
= EmmcReset (PassThru
, Slot
);
1123 if (EFI_ERROR (Status
)) {
1124 DEBUG ((DEBUG_VERBOSE
, "EmmcIdentification: Executing Cmd0 fails with %r\n", Status
));
1131 Status
= EmmcGetOcr (PassThru
, Slot
, &Ocr
);
1132 if (EFI_ERROR (Status
)) {
1133 DEBUG ((DEBUG_VERBOSE
, "EmmcIdentification: Executing Cmd1 fails with %r\n", Status
));
1138 if (Retry
++ == 100) {
1139 DEBUG ((DEBUG_VERBOSE
, "EmmcIdentification: Executing Cmd1 fails too many times\n"));
1140 return EFI_DEVICE_ERROR
;
1142 gBS
->Stall(10 * 1000);
1143 } while ((Ocr
& BIT31
) == 0);
1145 Status
= EmmcGetAllCid (PassThru
, Slot
);
1146 if (EFI_ERROR (Status
)) {
1147 DEBUG ((DEBUG_VERBOSE
, "EmmcIdentification: Executing Cmd2 fails with %r\n", Status
));
1151 // Slot starts from 0 and valid RCA starts from 1.
1152 // Here we takes a simple formula to calculate the RCA.
1153 // Don't support multiple devices on the slot, that is
1154 // shared bus slot feature.
1157 Status
= EmmcSetRca (PassThru
, Slot
, Rca
);
1158 if (EFI_ERROR (Status
)) {
1159 DEBUG ((DEBUG_ERROR
, "EmmcIdentification: Executing Cmd3 fails with %r\n", Status
));
1163 // Enter Data Tranfer Mode.
1165 DEBUG ((DEBUG_INFO
, "EmmcIdentification: Found a EMMC device at slot [%d], RCA [%d]\n", Slot
, Rca
));
1166 Private
->Slot
[Slot
].CardType
= EmmcCardType
;
1168 Status
= EmmcSetBusMode (PciIo
, PassThru
, Slot
, Rca
);