/** @file | |
This file provides some helper functions which are specific for SD card device. | |
Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved. | |
Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR> | |
SPDX-License-Identifier: BSD-2-Clause-Patent | |
**/ | |
#include "SdMmcPciHcDxe.h" | |
/** | |
Send command GO_IDLE_STATE to the device to make it go to Idle State. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@retval EFI_SUCCESS The SD device is reset correctly. | |
@retval Others The device reset fails. | |
**/ | |
EFI_STATUS | |
SdCardReset ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_GO_IDLE_STATE; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeBc; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Send command SEND_IF_COND to the device to inquiry the SD Memory Card interface | |
condition. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] SupplyVoltage The supplied voltage by the host. | |
@param[in] CheckPattern The check pattern to be sent to the device. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardVoltageCheck ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT8 SupplyVoltage, | |
IN UINT8 CheckPattern | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_SEND_IF_COND; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR7; | |
SdMmcCmdBlk.CommandArgument = (SupplyVoltage << 8) | CheckPattern; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (!EFI_ERROR (Status)) { | |
if (SdMmcStatusBlk.Resp0 != SdMmcCmdBlk.CommandArgument) { | |
return EFI_DEVICE_ERROR; | |
} | |
} | |
return Status; | |
} | |
/** | |
Send command SDIO_SEND_OP_COND to the device to see whether it is SDIO device. | |
Refer to SDIO Simplified Spec 3 Section 3.2 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] VoltageWindow The supply voltage window. | |
@param[in] S18R The boolean to show if it should switch to 1.8v. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdioSendOpCond ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT32 VoltageWindow, | |
IN BOOLEAN S18R | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
UINT32 Switch; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SDIO_SEND_OP_COND; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR4; | |
Switch = S18R ? BIT24 : 0; | |
SdMmcCmdBlk.CommandArgument = (VoltageWindow & 0xFFFFFF) | Switch; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Send command SD_SEND_OP_COND to the device to see whether it is SDIO device. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] Rca The relative device address of addressed device. | |
@param[in] VoltageWindow The supply voltage window. | |
@param[in] S18R The boolean to show if it should switch to 1.8v. | |
@param[in] Xpc The boolean to show if it should provide 0.36w power control. | |
@param[in] Hcs The boolean to show if it support host capacity info. | |
@param[out] Ocr The buffer to store returned OCR register value. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSendOpCond ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT16 Rca, | |
IN UINT32 VoltageWindow, | |
IN BOOLEAN S18R, | |
IN BOOLEAN Xpc, | |
IN BOOLEAN Hcs, | |
OUT UINT32 *Ocr | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
UINT32 Switch; | |
UINT32 MaxPower; | |
UINT32 HostCapacity; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_APP_CMD; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
SdMmcCmdBlk.CommandIndex = SD_SEND_OP_COND; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR3; | |
Switch = S18R ? BIT24 : 0; | |
MaxPower = Xpc ? BIT28 : 0; | |
HostCapacity = Hcs ? BIT30 : 0; | |
SdMmcCmdBlk.CommandArgument = (VoltageWindow & 0xFFFFFF) | Switch | MaxPower | HostCapacity; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (!EFI_ERROR (Status)) { | |
// | |
// For details, refer to SD Host Controller Simplified Spec 3.0 Table 2-12. | |
// | |
*Ocr = SdMmcStatusBlk.Resp0; | |
} | |
return Status; | |
} | |
/** | |
Broadcast command ALL_SEND_CID to the bus to ask all the SD devices to send the | |
data of their CID registers. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardAllSendCid ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_ALL_SEND_CID; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR2; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Send command SET_RELATIVE_ADDR to the SD device to assign a Relative device | |
Address (RCA). | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[out] Rca The relative device address to assign. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSetRca ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
OUT UINT16 *Rca | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_SET_RELATIVE_ADDR; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR6; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (!EFI_ERROR (Status)) { | |
*Rca = (UINT16)(SdMmcStatusBlk.Resp0 >> 16); | |
} | |
return Status; | |
} | |
/** | |
Send command SELECT_DESELECT_CARD to the SD device to select/deselect it. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] Rca The relative device address of selected device. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSelect ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT16 Rca | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_SELECT_DESELECT_CARD; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc; | |
if (Rca != 0) { | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1b; | |
} | |
SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Send command VOLTAGE_SWITCH to the SD device to switch the voltage of the device. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardVoltageSwitch ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_VOLTAGE_SWITCH; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
SdMmcCmdBlk.CommandArgument = 0; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Send command SET_BUS_WIDTH to the SD device to set the bus width. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] Rca The relative device address of addressed device. | |
@param[in] BusWidth The bus width to be set, it could be 1 or 4. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSetBusWidth ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT16 Rca, | |
IN UINT8 BusWidth | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
UINT8 Value; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_APP_CMD; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
SdMmcCmdBlk.CommandIndex = SD_SET_BUS_WIDTH; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
if (BusWidth == 1) { | |
Value = 0; | |
} else if (BusWidth == 4) { | |
Value = 2; | |
} else { | |
return EFI_INVALID_PARAMETER; | |
} | |
SdMmcCmdBlk.CommandArgument = Value & 0x3; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Send command SWITCH_FUNC to the SD device to check switchable function or switch card function. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] BusTiming Target bus timing based on which access group value will be set. | |
@param[in] CommandSystem The value for command set group. | |
@param[in] DriverStrength The value for driver strength group. | |
@param[in] PowerLimit The value for power limit group. | |
@param[in] Mode Switch or check function. | |
@param[out] SwitchResp The return switch function status. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSwitch ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN SD_MMC_BUS_MODE BusTiming, | |
IN UINT8 CommandSystem, | |
IN SD_DRIVER_STRENGTH_TYPE DriverStrength, | |
IN UINT8 PowerLimit, | |
IN BOOLEAN Mode, | |
OUT UINT8 *SwitchResp | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
UINT32 ModeValue; | |
UINT8 AccessMode; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_SWITCH_FUNC; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAdtc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
ModeValue = Mode ? BIT31 : 0; | |
switch (BusTiming) { | |
case SdMmcUhsDdr50: | |
AccessMode = 0x4; | |
break; | |
case SdMmcUhsSdr104: | |
AccessMode = 0x3; | |
break; | |
case SdMmcUhsSdr50: | |
AccessMode = 0x2; | |
break; | |
case SdMmcUhsSdr25: | |
case SdMmcSdHs: | |
AccessMode = 0x1; | |
break; | |
case SdMmcUhsSdr12: | |
case SdMmcSdDs: | |
AccessMode = 0; | |
break; | |
default: | |
AccessMode = 0xF; | |
} | |
SdMmcCmdBlk.CommandArgument = (AccessMode & 0xF) | ((CommandSystem & 0xF) << 4) | \ | |
((DriverStrength & 0xF) << 8) | ((PowerLimit & 0xF) << 12) | \ | |
ModeValue; | |
Packet.InDataBuffer = SwitchResp; | |
Packet.InTransferLength = 64; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
if (Mode) { | |
if ((((AccessMode & 0xF) != 0xF) && ((SwitchResp[16] & 0xF) != AccessMode)) || | |
(((CommandSystem & 0xF) != 0xF) && (((SwitchResp[16] >> 4) & 0xF) != CommandSystem)) || | |
(((DriverStrength & 0xF) != 0xF) && ((SwitchResp[15] & 0xF) != DriverStrength)) || | |
(((PowerLimit & 0xF) != 0xF) && (((SwitchResp[15] >> 4) & 0xF) != PowerLimit))) | |
{ | |
return EFI_DEVICE_ERROR; | |
} | |
} | |
return Status; | |
} | |
/** | |
Send command SEND_STATUS to the addressed SD device to get its status register. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] Rca The relative device address of addressed device. | |
@param[out] DevStatus The returned device status. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSendStatus ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT16 Rca, | |
OUT UINT32 *DevStatus | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_SEND_STATUS; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16; | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
if (!EFI_ERROR (Status)) { | |
*DevStatus = SdMmcStatusBlk.Resp0; | |
} | |
return Status; | |
} | |
/** | |
Send command SEND_TUNING_BLOCK to the SD device for HS200 optimal sampling point | |
detection. | |
It may be sent up to 40 times until the host finishes the tuning procedure. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSendTuningBlk ( | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot | |
) | |
{ | |
EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk; | |
EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk; | |
EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet; | |
EFI_STATUS Status; | |
UINT8 TuningBlock[64]; | |
ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk)); | |
ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk)); | |
ZeroMem (&Packet, sizeof (Packet)); | |
Packet.SdMmcCmdBlk = &SdMmcCmdBlk; | |
Packet.SdMmcStatusBlk = &SdMmcStatusBlk; | |
Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT; | |
SdMmcCmdBlk.CommandIndex = SD_SEND_TUNING_BLOCK; | |
SdMmcCmdBlk.CommandType = SdMmcCommandTypeAdtc; | |
SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1; | |
SdMmcCmdBlk.CommandArgument = 0; | |
Packet.InDataBuffer = TuningBlock; | |
Packet.InTransferLength = sizeof (TuningBlock); | |
Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL); | |
return Status; | |
} | |
/** | |
Tunning the sampling point of SDR104 or SDR50 bus speed mode. | |
Command SD_SEND_TUNING_BLOCK may be sent up to 40 times until the host finishes the | |
tuning procedure. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 and | |
SD Host Controller Simplified Spec 3.0 section Figure 3-7 for details. | |
@param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardTuningClock ( | |
IN EFI_PCI_IO_PROTOCOL *PciIo, | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot | |
) | |
{ | |
EFI_STATUS Status; | |
UINT8 HostCtrl2; | |
UINT8 Retry; | |
// | |
// Notify the host that the sampling clock tuning procedure starts. | |
// | |
HostCtrl2 = BIT6; | |
Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
// | |
// Ask the device to send a sequence of tuning blocks till the tuning procedure is done. | |
// | |
Retry = 0; | |
do { | |
Status = SdCardSendTuningBlk (PassThru, Slot); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardSendTuningBlk: Send tuning block fails with %r\n", Status)); | |
return Status; | |
} | |
Status = SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, TRUE, sizeof (HostCtrl2), &HostCtrl2); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
if ((HostCtrl2 & (BIT6 | BIT7)) == 0) { | |
break; | |
} | |
if ((HostCtrl2 & (BIT6 | BIT7)) == BIT7) { | |
return EFI_SUCCESS; | |
} | |
} while (++Retry < 40); | |
DEBUG ((DEBUG_ERROR, "SdCardTuningClock: Send tuning block fails at %d times with HostCtrl2 %02x\n", Retry, HostCtrl2)); | |
// | |
// Abort the tuning procedure and reset the tuning circuit. | |
// | |
HostCtrl2 = (UINT8) ~(BIT6 | BIT7); | |
Status = SdMmcHcAndMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
return EFI_DEVICE_ERROR; | |
} | |
/** | |
Switch the bus width to specified width. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 and | |
SD Host Controller Simplified Spec 3.0 section Figure 3-7 for details. | |
@param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] Rca The relative device address to be assigned. | |
@param[in] BusWidth The bus width to be set, it could be 4 or 8. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSwitchBusWidth ( | |
IN EFI_PCI_IO_PROTOCOL *PciIo, | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT16 Rca, | |
IN UINT8 BusWidth | |
) | |
{ | |
EFI_STATUS Status; | |
UINT32 DevStatus; | |
Status = SdCardSetBusWidth (PassThru, Slot, Rca, BusWidth); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardSwitchBusWidth: Switch to bus width %d fails with %r\n", BusWidth, Status)); | |
return Status; | |
} | |
Status = SdCardSendStatus (PassThru, Slot, Rca, &DevStatus); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardSwitchBusWidth: Send status fails with %r\n", Status)); | |
return Status; | |
} | |
// | |
// Check the switch operation is really successful or not. | |
// | |
if ((DevStatus >> 16) != 0) { | |
DEBUG ((DEBUG_ERROR, "SdCardSwitchBusWidth: The switch operation fails as DevStatus is 0x%08x\n", DevStatus)); | |
return EFI_DEVICE_ERROR; | |
} | |
Status = SdMmcHcSetBusWidth (PciIo, Slot, BusWidth); | |
return Status; | |
} | |
/** | |
Check if passed BusTiming is supported in both controller and card. | |
@param[in] Private Pointer to controller private data | |
@param[in] SlotIndex Index of the slot in the controller | |
@param[in] CardSupportedBusTimings Bitmask indicating which bus timings are supported by card | |
@param[in] IsInUhsI Flag indicating if link is in UHS-I | |
@retval TRUE Both card and controller support given BusTiming | |
@retval FALSE Card or controller doesn't support given BusTiming | |
**/ | |
BOOLEAN | |
SdIsBusTimingSupported ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 SlotIndex, | |
IN UINT8 CardSupportedBusTimings, | |
IN BOOLEAN IsInUhsI, | |
IN SD_MMC_BUS_MODE BusTiming | |
) | |
{ | |
SD_MMC_HC_SLOT_CAP *Capability; | |
Capability = &Private->Capability[SlotIndex]; | |
if (IsInUhsI) { | |
switch (BusTiming) { | |
case SdMmcUhsSdr104: | |
if ((Capability->Sdr104 != 0) && ((CardSupportedBusTimings & BIT3) != 0)) { | |
return TRUE; | |
} | |
break; | |
case SdMmcUhsDdr50: | |
if ((Capability->Ddr50 != 0) && ((CardSupportedBusTimings & BIT4) != 0)) { | |
return TRUE; | |
} | |
break; | |
case SdMmcUhsSdr50: | |
if ((Capability->Sdr50 != 0) && ((CardSupportedBusTimings & BIT2) != 0)) { | |
return TRUE; | |
} | |
break; | |
case SdMmcUhsSdr25: | |
if ((CardSupportedBusTimings & BIT1) != 0) { | |
return TRUE; | |
} | |
break; | |
case SdMmcUhsSdr12: | |
if ((CardSupportedBusTimings & BIT0) != 0) { | |
return TRUE; | |
} | |
break; | |
default: | |
break; | |
} | |
} else { | |
switch (BusTiming) { | |
case SdMmcSdHs: | |
if ((Capability->HighSpeed != 0) && ((CardSupportedBusTimings & BIT1) != 0)) { | |
return TRUE; | |
} | |
break; | |
case SdMmcSdDs: | |
if ((CardSupportedBusTimings & BIT0) != 0) { | |
return TRUE; | |
} | |
break; | |
default: | |
break; | |
} | |
} | |
return FALSE; | |
} | |
/** | |
Get the target bus timing to set on the link. This function | |
will try to select highest bus timing supported by card, controller | |
and the driver. | |
@param[in] Private Pointer to controller private data | |
@param[in] SlotIndex Index of the slot in the controller | |
@param[in] CardSupportedBusTimings Bitmask indicating which bus timings are supported by card | |
@param[in] IsInUhsI Flag indicating if link is in UHS-I | |
@return Bus timing value that should be set on link | |
**/ | |
SD_MMC_BUS_MODE | |
SdGetTargetBusTiming ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 SlotIndex, | |
IN UINT8 CardSupportedBusTimings, | |
IN BOOLEAN IsInUhsI | |
) | |
{ | |
SD_MMC_BUS_MODE BusTiming; | |
if (IsInUhsI) { | |
BusTiming = SdMmcUhsSdr104; | |
} else { | |
BusTiming = SdMmcSdHs; | |
} | |
while (BusTiming > SdMmcSdDs) { | |
if (SdIsBusTimingSupported (Private, SlotIndex, CardSupportedBusTimings, IsInUhsI, BusTiming)) { | |
break; | |
} | |
BusTiming--; | |
} | |
return BusTiming; | |
} | |
/** | |
Get the target bus width to be set on the bus. | |
@param[in] Private Pointer to controller private data | |
@param[in] SlotIndex Index of the slot in the controller | |
@param[in] BusTiming Bus timing set on the bus | |
@return Bus width to be set on the bus | |
**/ | |
UINT8 | |
SdGetTargetBusWidth ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 SlotIndex, | |
IN SD_MMC_BUS_MODE BusTiming | |
) | |
{ | |
UINT8 BusWidth; | |
UINT8 PreferredBusWidth; | |
PreferredBusWidth = Private->Slot[SlotIndex].OperatingParameters.BusWidth; | |
if ((BusTiming == SdMmcSdDs) || (BusTiming == SdMmcSdHs)) { | |
if ((PreferredBusWidth != EDKII_SD_MMC_BUS_WIDTH_IGNORE) && | |
((PreferredBusWidth == 1) || (PreferredBusWidth == 4))) | |
{ | |
BusWidth = PreferredBusWidth; | |
} else { | |
BusWidth = 4; | |
} | |
} else { | |
// | |
// UHS-I modes support only 4-bit width. | |
// Switch to 4-bit has been done before calling this function anyway so | |
// this is purely informational. | |
// | |
BusWidth = 4; | |
} | |
return BusWidth; | |
} | |
/** | |
Get the target clock frequency to be set on the bus. | |
@param[in] Private Pointer to controller private data | |
@param[in] SlotIndex Index of the slot in the controller | |
@param[in] BusTiming Bus timing to be set on the bus | |
@return Value of the clock frequency to be set on bus in MHz | |
**/ | |
UINT32 | |
SdGetTargetBusClockFreq ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 SlotIndex, | |
IN SD_MMC_BUS_MODE BusTiming | |
) | |
{ | |
UINT32 PreferredClockFreq; | |
UINT32 MaxClockFreq; | |
PreferredClockFreq = Private->Slot[SlotIndex].OperatingParameters.ClockFreq; | |
switch (BusTiming) { | |
case SdMmcUhsSdr104: | |
MaxClockFreq = 208; | |
break; | |
case SdMmcUhsSdr50: | |
MaxClockFreq = 100; | |
break; | |
case SdMmcUhsDdr50: | |
case SdMmcUhsSdr25: | |
case SdMmcSdHs: | |
MaxClockFreq = 50; | |
break; | |
case SdMmcUhsSdr12: | |
case SdMmcSdDs: | |
default: | |
MaxClockFreq = 25; | |
} | |
if ((PreferredClockFreq != EDKII_SD_MMC_CLOCK_FREQ_IGNORE) && (PreferredClockFreq < MaxClockFreq)) { | |
return PreferredClockFreq; | |
} else { | |
return MaxClockFreq; | |
} | |
} | |
/** | |
Get the driver strength to be set on bus. | |
@param[in] Private Pointer to controller private data | |
@param[in] SlotIndex Index of the slot in the controller | |
@param[in] CardSupportedDriverStrengths Bitmask indicating which driver strengths are supported on the card | |
@param[in] BusTiming Bus timing set on the bus | |
@return Value of the driver strength to be set on the bus | |
**/ | |
EDKII_SD_MMC_DRIVER_STRENGTH | |
SdGetTargetDriverStrength ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 SlotIndex, | |
IN UINT8 CardSupportedDriverStrengths, | |
IN SD_MMC_BUS_MODE BusTiming | |
) | |
{ | |
EDKII_SD_MMC_DRIVER_STRENGTH PreferredDriverStrength; | |
EDKII_SD_MMC_DRIVER_STRENGTH DriverStrength; | |
if ((BusTiming == SdMmcSdDs) || (BusTiming == SdMmcSdHs)) { | |
DriverStrength.Sd = SdDriverStrengthIgnore; | |
return DriverStrength; | |
} | |
PreferredDriverStrength = Private->Slot[SlotIndex].OperatingParameters.DriverStrength; | |
DriverStrength.Sd = SdDriverStrengthTypeB; | |
if ((PreferredDriverStrength.Sd != EDKII_SD_MMC_DRIVER_STRENGTH_IGNORE) && | |
(CardSupportedDriverStrengths & (BIT0 << PreferredDriverStrength.Sd))) | |
{ | |
if (((PreferredDriverStrength.Sd == SdDriverStrengthTypeA) && | |
(Private->Capability[SlotIndex].DriverTypeA != 0)) || | |
((PreferredDriverStrength.Sd == SdDriverStrengthTypeC) && | |
(Private->Capability[SlotIndex].DriverTypeC != 0)) || | |
((PreferredDriverStrength.Sd == SdDriverStrengthTypeD) && | |
(Private->Capability[SlotIndex].DriverTypeD != 0))) | |
{ | |
DriverStrength.Sd = PreferredDriverStrength.Sd; | |
} | |
} | |
return DriverStrength; | |
} | |
/** | |
Get the target settings for the bus mode. | |
@param[in] Private Pointer to controller private data | |
@param[in] SlotIndex Index of the slot in the controller | |
@param[in] SwitchQueryResp Pointer to switch query response | |
@param[in] IsInUhsI Flag indicating if link is in UHS-I mode | |
@param[out] BusMode Target configuration of the bus | |
**/ | |
VOID | |
SdGetTargetBusMode ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 SlotIndex, | |
IN UINT8 *SwitchQueryResp, | |
IN BOOLEAN IsInUhsI, | |
OUT SD_MMC_BUS_SETTINGS *BusMode | |
) | |
{ | |
BusMode->BusTiming = SdGetTargetBusTiming (Private, SlotIndex, SwitchQueryResp[13], IsInUhsI); | |
BusMode->BusWidth = SdGetTargetBusWidth (Private, SlotIndex, BusMode->BusTiming); | |
BusMode->ClockFreq = SdGetTargetBusClockFreq (Private, SlotIndex, BusMode->BusTiming); | |
BusMode->DriverStrength = SdGetTargetDriverStrength (Private, SlotIndex, SwitchQueryResp[9], BusMode->BusTiming); | |
} | |
/** | |
Switch the high speed timing according to request. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 and | |
SD Host Controller Simplified Spec 3.0 section Figure 2-29 for details. | |
@param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance. | |
@param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@param[in] Rca The relative device address to be assigned. | |
@param[in] S18A The boolean to show if it's a UHS-I SD card. | |
@param[in] SdVersion1 The boolean to show if it's a Version 1 SD card. | |
@retval EFI_SUCCESS The operation is done correctly. | |
@retval Others The operation fails. | |
**/ | |
EFI_STATUS | |
SdCardSetBusMode ( | |
IN EFI_PCI_IO_PROTOCOL *PciIo, | |
IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, | |
IN UINT8 Slot, | |
IN UINT16 Rca, | |
IN BOOLEAN S18A, | |
IN BOOLEAN SdVersion1 | |
) | |
{ | |
EFI_STATUS Status; | |
SD_MMC_HC_SLOT_CAP *Capability; | |
UINT8 HostCtrl1; | |
UINT8 SwitchResp[64]; | |
SD_MMC_HC_PRIVATE_DATA *Private; | |
SD_MMC_BUS_SETTINGS BusMode; | |
ZeroMem (SwitchResp, 64 * sizeof (UINT8)); | |
Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru); | |
Capability = &Private->Capability[Slot]; | |
Status = SdCardSelect (PassThru, Slot, Rca); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
if (S18A) { | |
// | |
// For UHS-I speed modes 4-bit data bus is requiered so we | |
// switch here irrespective of platform preference. | |
// | |
Status = SdCardSwitchBusWidth (PciIo, PassThru, Slot, Rca, 4); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
} | |
// | |
// Get the supported bus speed from SWITCH cmd return data group #1. | |
// SdVersion1 don't support the SWITCH cmd | |
// | |
if (!SdVersion1) { | |
Status = SdCardSwitch (PassThru, Slot, 0xFF, 0xF, SdDriverStrengthIgnore, 0xF, FALSE, SwitchResp); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
} | |
SdGetTargetBusMode (Private, Slot, SwitchResp, S18A, &BusMode); | |
DEBUG (( | |
DEBUG_INFO, | |
"SdCardSetBusMode: Target bus mode: bus timing = %d, bus width = %d, clock freq[MHz] = %d, driver strength = %d\n", | |
BusMode.BusTiming, | |
BusMode.BusWidth, | |
BusMode.ClockFreq, | |
BusMode.DriverStrength.Sd | |
)); | |
if (!S18A) { | |
Status = SdCardSwitchBusWidth (PciIo, PassThru, Slot, Rca, BusMode.BusWidth); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
} | |
// | |
// SdVersion1 don't support the SWITCH cmd | |
// | |
if (!SdVersion1) { | |
Status = SdCardSwitch (PassThru, Slot, BusMode.BusTiming, 0xF, BusMode.DriverStrength.Sd, 0xF, TRUE, SwitchResp); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
} | |
Status = SdMmcSetDriverStrength (Private->PciIo, Slot, BusMode.DriverStrength.Sd); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
// | |
// Set to High Speed timing | |
// | |
if (BusMode.BusTiming == SdMmcSdHs) { | |
HostCtrl1 = BIT2; | |
Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL1, sizeof (HostCtrl1), &HostCtrl1); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
} | |
Status = SdMmcHcUhsSignaling (Private->ControllerHandle, PciIo, Slot, BusMode.BusTiming); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
Status = SdMmcHcClockSupply (Private, Slot, BusMode.BusTiming, FALSE, BusMode.ClockFreq * 1000); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
if ((BusMode.BusTiming == SdMmcUhsSdr104) || ((BusMode.BusTiming == SdMmcUhsSdr50) && (Capability->TuningSDR50 != 0))) { | |
Status = SdCardTuningClock (PciIo, PassThru, Slot); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
} | |
return Status; | |
} | |
/** | |
Execute SD device identification procedure. | |
Refer to SD Physical Layer Simplified Spec 4.1 Section 3.6 for details. | |
@param[in] Private A pointer to the SD_MMC_HC_PRIVATE_DATA instance. | |
@param[in] Slot The slot number of the SD card to send the command to. | |
@retval EFI_SUCCESS There is a SD card. | |
@retval Others There is not a SD card. | |
**/ | |
EFI_STATUS | |
SdCardIdentification ( | |
IN SD_MMC_HC_PRIVATE_DATA *Private, | |
IN UINT8 Slot | |
) | |
{ | |
EFI_STATUS Status; | |
EFI_PCI_IO_PROTOCOL *PciIo; | |
EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru; | |
UINT32 Ocr; | |
UINT16 Rca; | |
BOOLEAN Xpc; | |
BOOLEAN S18r; | |
UINT64 MaxCurrent; | |
UINT16 ControllerVer; | |
UINT8 PowerCtrl; | |
UINT32 PresentState; | |
UINT8 HostCtrl2; | |
UINTN Retry; | |
BOOLEAN ForceVoltage33; | |
BOOLEAN SdVersion1; | |
ForceVoltage33 = FALSE; | |
SdVersion1 = FALSE; | |
PciIo = Private->PciIo; | |
PassThru = &Private->PassThru; | |
Voltage33Retry: | |
// | |
// 1. Send Cmd0 to the device | |
// | |
Status = SdCardReset (PassThru, Slot); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_INFO, "SdCardIdentification: Executing Cmd0 fails with %r\n", Status)); | |
return Status; | |
} | |
// | |
// 2. Send Cmd8 to the device, the command will fail for SdVersion1 | |
// | |
Status = SdCardVoltageCheck (PassThru, Slot, 0x1, 0xFF); | |
if (EFI_ERROR (Status)) { | |
SdVersion1 = TRUE; | |
DEBUG ((DEBUG_INFO, "SdCardIdentification: Executing Cmd8 fails with %r\n", Status)); | |
} | |
// | |
// 3. Send SDIO Cmd5 to the device to the SDIO device OCR register. | |
// | |
Status = SdioSendOpCond (PassThru, Slot, 0, FALSE); | |
if (!EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_INFO, "SdCardIdentification: Found SDIO device, ignore it as we don't support\n")); | |
return EFI_DEVICE_ERROR; | |
} | |
// | |
// 4. Send Acmd41 with voltage window 0 to the device | |
// | |
Status = SdCardSendOpCond (PassThru, Slot, 0, 0, FALSE, FALSE, FALSE, &Ocr); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_INFO, "SdCardIdentification: Executing SdCardSendOpCond fails with %r\n", Status)); | |
return EFI_DEVICE_ERROR; | |
} | |
if (Private->Capability[Slot].Voltage33 != 0) { | |
// | |
// Support 3.3V | |
// | |
MaxCurrent = ((UINT32)Private->MaxCurrent[Slot] & 0xFF) * 4; | |
} else if (Private->Capability[Slot].Voltage30 != 0) { | |
// | |
// Support 3.0V | |
// | |
MaxCurrent = (((UINT32)Private->MaxCurrent[Slot] >> 8) & 0xFF) * 4; | |
} else if (Private->Capability[Slot].Voltage18 != 0) { | |
// | |
// Support 1.8V | |
// | |
MaxCurrent = (((UINT32)Private->MaxCurrent[Slot] >> 16) & 0xFF) * 4; | |
} else { | |
ASSERT (FALSE); | |
return EFI_DEVICE_ERROR; | |
} | |
if (MaxCurrent >= 150) { | |
Xpc = TRUE; | |
} else { | |
Xpc = FALSE; | |
} | |
Status = SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_CTRL_VER, TRUE, sizeof (ControllerVer), &ControllerVer); | |
if (EFI_ERROR (Status)) { | |
return Status; | |
} | |
if (((ControllerVer & 0xFF) >= SD_MMC_HC_CTRL_VER_300) && | |
((ControllerVer & 0xFF) <= SD_MMC_HC_CTRL_VER_420)) | |
{ | |
S18r = TRUE; | |
} else if (((ControllerVer & 0xFF) == SD_MMC_HC_CTRL_VER_100) || ((ControllerVer & 0xFF) == SD_MMC_HC_CTRL_VER_200)) { | |
S18r = FALSE; | |
} else { | |
ASSERT (FALSE); | |
return EFI_UNSUPPORTED; | |
} | |
// | |
// 1.8V had failed in the previous run, forcing a retry with 3.3V instead | |
// | |
if (ForceVoltage33 == TRUE) { | |
S18r = FALSE; | |
} | |
// | |
// 5. Repeatly send Acmd41 with supply voltage window to the device. | |
// Note here we only support the cards complied with SD physical | |
// layer simplified spec version 2.0 and version 3.0 and above. | |
// | |
Ocr = 0; | |
Retry = 0; | |
do { | |
Status = SdCardSendOpCond (PassThru, Slot, 0, Ocr, S18r, Xpc, TRUE, &Ocr); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: SdCardSendOpCond fails with %r Ocr %x, S18r %x, Xpc %x\n", Status, Ocr, S18r, Xpc)); | |
return EFI_DEVICE_ERROR; | |
} | |
if (Retry++ == 100) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: SdCardSendOpCond fails too many times\n")); | |
return EFI_DEVICE_ERROR; | |
} | |
gBS->Stall (10 * 1000); | |
} while ((Ocr & BIT31) == 0); | |
// | |
// 6. If the S18A bit is set and the Host Controller supports 1.8V signaling | |
// (One of support bits is set to 1: SDR50, SDR104 or DDR50 in the | |
// Capabilities register), switch its voltage to 1.8V. | |
// | |
if (((Private->Capability[Slot].Sdr50 != 0) || | |
(Private->Capability[Slot].Sdr104 != 0) || | |
(Private->Capability[Slot].Ddr50 != 0)) && | |
((Ocr & BIT24) != 0)) | |
{ | |
Status = SdCardVoltageSwitch (PassThru, Slot); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: Executing SdCardVoltageSwitch fails with %r\n", Status)); | |
Status = EFI_DEVICE_ERROR; | |
goto Error; | |
} else { | |
Status = SdMmcHcStopClock (PciIo, Slot); | |
if (EFI_ERROR (Status)) { | |
Status = EFI_DEVICE_ERROR; | |
goto Error; | |
} | |
SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_PRESENT_STATE, TRUE, sizeof (PresentState), &PresentState); | |
if (((PresentState >> 20) & 0xF) != 0) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: SwitchVoltage fails with PresentState = 0x%x\n", PresentState)); | |
Status = EFI_DEVICE_ERROR; | |
goto Error; | |
} | |
HostCtrl2 = BIT3; | |
SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2); | |
gBS->Stall (5000); | |
SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, TRUE, sizeof (HostCtrl2), &HostCtrl2); | |
if ((HostCtrl2 & BIT3) == 0) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: SwitchVoltage fails with HostCtrl2 = 0x%x\n", HostCtrl2)); | |
Status = EFI_DEVICE_ERROR; | |
goto Error; | |
} | |
Status = SdMmcHcStartSdClock (PciIo, Slot); | |
if (EFI_ERROR (Status)) { | |
goto Error; | |
} | |
gBS->Stall (1000); | |
SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_PRESENT_STATE, TRUE, sizeof (PresentState), &PresentState); | |
if (((PresentState >> 20) & 0xF) != 0xF) { | |
// | |
// Delay 50 milliseconds in order for clock to stabilize, retry reading the SD_MMC_HC_PRESENT_STATE | |
// | |
gBS->Stall (50000); | |
SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_PRESENT_STATE, TRUE, sizeof (PresentState), &PresentState); | |
if (((PresentState >> 20) & 0xF) != 0xF) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: SwitchVoltage fails with PresentState = 0x%x, It should be 0xF\n", PresentState)); | |
// | |
// Reset and reinitialize the slot before the 3.3V retry. | |
// | |
Status = SdMmcHcReset (Private, Slot); | |
if (EFI_ERROR (Status)) { | |
goto Error; | |
} | |
Status = SdMmcHcInitHost (Private, Slot); | |
if (EFI_ERROR (Status)) { | |
goto Error; | |
} | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: Switching to 1.8V failed, forcing a retry with 3.3V instead\n")); | |
ForceVoltage33 = TRUE; | |
goto Voltage33Retry; | |
} | |
} | |
} | |
DEBUG ((DEBUG_INFO, "SdCardIdentification: Switch to 1.8v signal voltage success\n")); | |
} | |
Status = SdCardAllSendCid (PassThru, Slot); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: Executing SdCardAllSendCid fails with %r\n", Status)); | |
return Status; | |
} | |
Status = SdCardSetRca (PassThru, Slot, &Rca); | |
if (EFI_ERROR (Status)) { | |
DEBUG ((DEBUG_ERROR, "SdCardIdentification: Executing SdCardSetRca fails with %r\n", Status)); | |
return Status; | |
} | |
// | |
// Enter Data Tranfer Mode. | |
// | |
DEBUG ((DEBUG_INFO, "SdCardIdentification: Found a SD device at slot [%d]\n", Slot)); | |
Private->Slot[Slot].CardType = SdCardType; | |
Status = SdCardSetBusMode (PciIo, PassThru, Slot, Rca, ((Ocr & BIT24) != 0), SdVersion1); | |
return Status; | |
Error: | |
// | |
// Set SD Bus Power = 0 | |
// | |
PowerCtrl = (UINT8) ~BIT0; | |
Status = SdMmcHcAndMmio (PciIo, Slot, SD_MMC_HC_POWER_CTRL, sizeof (PowerCtrl), &PowerCtrl); | |
return EFI_DEVICE_ERROR; | |
} |