1 /** @file 2 Definition of the MMC Host Protocol 3 4 Copyright (c) 2011-2014, ARM Limited. All rights reserved. 5 6 This program and the accompanying materials 7 are licensed and made available under the terms and conditions of the BSD License 8 which accompanies this distribution. The full text of the license may be found at 9 http://opensource.org/licenses/bsd-license.php 10 11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, 12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. 13 14 **/ 15 16 #ifndef __MMC_HOST_H__ 17 #define __MMC_HOST_H__ 18 19 /// 20 /// Global ID for the MMC Host Protocol 21 /// 22 #define EFI_MMC_HOST_PROTOCOL_GUID \ 23 { 0x3e591c00, 0x9e4a, 0x11df, {0x92, 0x44, 0x00, 0x02, 0xA5, 0xD5, 0xC5, 0x1B } } 24 25 #define MMC_RESPONSE_TYPE_R1 0 26 #define MMC_RESPONSE_TYPE_R1b 0 27 #define MMC_RESPONSE_TYPE_R2 1 28 #define MMC_RESPONSE_TYPE_R3 0 29 #define MMC_RESPONSE_TYPE_R6 0 30 #define MMC_RESPONSE_TYPE_R7 0 31 #define MMC_RESPONSE_TYPE_OCR 0 32 #define MMC_RESPONSE_TYPE_CID 1 33 #define MMC_RESPONSE_TYPE_CSD 1 34 #define MMC_RESPONSE_TYPE_RCA 0 35 36 typedef UINT32 MMC_RESPONSE_TYPE; 37 38 typedef UINT32 MMC_CMD; 39 40 #define MMC_CMD_WAIT_RESPONSE (1 << 16) 41 #define MMC_CMD_LONG_RESPONSE (1 << 17) 42 #define MMC_CMD_NO_CRC_RESPONSE (1 << 18) 43 44 #define MMC_INDX(Index) ((Index) & 0xFFFF) 45 #define MMC_GET_INDX(MmcCmd) ((MmcCmd) & 0xFFFF) 46 47 #define MMC_CMD0 (MMC_INDX(0) | MMC_CMD_NO_CRC_RESPONSE) 48 #define MMC_CMD1 (MMC_INDX(1) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_NO_CRC_RESPONSE) 49 #define MMC_CMD2 (MMC_INDX(2) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_LONG_RESPONSE) 50 #define MMC_CMD3 (MMC_INDX(3) | MMC_CMD_WAIT_RESPONSE) 51 #define MMC_CMD5 (MMC_INDX(5) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_NO_CRC_RESPONSE) 52 #define MMC_CMD6 (MMC_INDX(6) | MMC_CMD_WAIT_RESPONSE) 53 #define MMC_CMD7 (MMC_INDX(7) | MMC_CMD_WAIT_RESPONSE) 54 #define MMC_CMD8 (MMC_INDX(8) | MMC_CMD_WAIT_RESPONSE) 55 #define MMC_CMD9 (MMC_INDX(9) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_LONG_RESPONSE) 56 #define MMC_CMD11 (MMC_INDX(11) | MMC_CMD_WAIT_RESPONSE) 57 #define MMC_CMD12 (MMC_INDX(12) | MMC_CMD_WAIT_RESPONSE) 58 #define MMC_CMD13 (MMC_INDX(13) | MMC_CMD_WAIT_RESPONSE) 59 #define MMC_CMD16 (MMC_INDX(16) | MMC_CMD_WAIT_RESPONSE) 60 #define MMC_CMD17 (MMC_INDX(17) | MMC_CMD_WAIT_RESPONSE) 61 #define MMC_CMD18 (MMC_INDX(18) | MMC_CMD_WAIT_RESPONSE) 62 #define MMC_CMD20 (MMC_INDX(20) | MMC_CMD_WAIT_RESPONSE) 63 #define MMC_CMD23 (MMC_INDX(23) | MMC_CMD_WAIT_RESPONSE) 64 #define MMC_CMD24 (MMC_INDX(24) | MMC_CMD_WAIT_RESPONSE) 65 #define MMC_CMD25 (MMC_INDX(25) | MMC_CMD_WAIT_RESPONSE) 66 #define MMC_CMD35 (MMC_INDX(35) | MMC_CMD_WAIT_RESPONSE) 67 #define MMC_CMD36 (MMC_INDX(36) | MMC_CMD_WAIT_RESPONSE) 68 #define MMC_CMD38 (MMC_INDX(38) | MMC_CMD_WAIT_RESPONSE) 69 #define MMC_CMD55 (MMC_INDX(55) | MMC_CMD_WAIT_RESPONSE) 70 #define MMC_ACMD41 (MMC_INDX(41) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_NO_CRC_RESPONSE) 71 #define MMC_ACMD51 (MMC_INDX(51) | MMC_CMD_WAIT_RESPONSE) 72 73 // Valid responses for CMD1 in eMMC 74 #define EMMC_CMD1_CAPACITY_LESS_THAN_2GB 0x00FF8080 // Capacity <= 2GB, byte addressing used 75 #define EMMC_CMD1_CAPACITY_GREATER_THAN_2GB 0x40FF8080 // Capacity > 2GB, 512-byte sector addressing used 76 77 #define MMC_STATUS_APP_CMD (1 << 5) 78 79 typedef enum _MMC_STATE { 80 MmcInvalidState = 0, 81 MmcHwInitializationState, 82 MmcIdleState, 83 MmcReadyState, 84 MmcIdentificationState, 85 MmcStandByState, 86 MmcTransferState, 87 MmcSendingDataState, 88 MmcReceiveDataState, 89 MmcProgrammingState, 90 MmcDisconnectState, 91 } MMC_STATE; 92 93 #define EMMCBACKWARD (0) 94 #define EMMCHS26 (1 << 0) // High-Speed @26MHz at rated device voltages 95 #define EMMCHS52 (1 << 1) // High-Speed @52MHz at rated device voltages 96 #define EMMCHS52DDR1V8 (1 << 2) // High-Speed Dual Data Rate @52MHz 1.8V or 3V I/O 97 #define EMMCHS52DDR1V2 (1 << 3) // High-Speed Dual Data Rate @52MHz 1.2V I/O 98 #define EMMCHS200SDR1V8 (1 << 4) // HS200 Single Data Rate @200MHz 1.8V I/O 99 #define EMMCHS200SDR1V2 (1 << 5) // HS200 Single Data Rate @200MHz 1.2V I/O 100 #define EMMCHS400DDR1V8 (1 << 6) // HS400 Dual Data Rate @400MHz 1.8V I/O 101 #define EMMCHS400DDR1V2 (1 << 7) // HS400 Dual Data Rate @400MHz 1.2V I/O 102 103 /// 104 /// Forward declaration for EFI_MMC_HOST_PROTOCOL 105 /// 106 typedef struct _EFI_MMC_HOST_PROTOCOL EFI_MMC_HOST_PROTOCOL; 107 108 typedef BOOLEAN (EFIAPI *MMC_ISCARDPRESENT) ( 109 IN EFI_MMC_HOST_PROTOCOL *This 110 ); 111 112 typedef BOOLEAN (EFIAPI *MMC_ISREADONLY) ( 113 IN EFI_MMC_HOST_PROTOCOL *This 114 ); 115 116 typedef EFI_STATUS (EFIAPI *MMC_BUILDDEVICEPATH) ( 117 IN EFI_MMC_HOST_PROTOCOL *This, 118 OUT EFI_DEVICE_PATH_PROTOCOL **DevicePath 119 ); 120 121 typedef EFI_STATUS (EFIAPI *MMC_NOTIFYSTATE) ( 122 IN EFI_MMC_HOST_PROTOCOL *This, 123 IN MMC_STATE State 124 ); 125 126 typedef EFI_STATUS (EFIAPI *MMC_SENDCOMMAND) ( 127 IN EFI_MMC_HOST_PROTOCOL *This, 128 IN MMC_CMD Cmd, 129 IN UINT32 Argument 130 ); 131 132 typedef EFI_STATUS (EFIAPI *MMC_RECEIVERESPONSE) ( 133 IN EFI_MMC_HOST_PROTOCOL *This, 134 IN MMC_RESPONSE_TYPE Type, 135 IN UINT32 *Buffer 136 ); 137 138 typedef EFI_STATUS (EFIAPI *MMC_READBLOCKDATA) ( 139 IN EFI_MMC_HOST_PROTOCOL *This, 140 IN EFI_LBA Lba, 141 IN UINTN Length, 142 OUT UINT32 *Buffer 143 ); 144 145 typedef EFI_STATUS (EFIAPI *MMC_WRITEBLOCKDATA) ( 146 IN EFI_MMC_HOST_PROTOCOL *This, 147 IN EFI_LBA Lba, 148 IN UINTN Length, 149 IN UINT32 *Buffer 150 ); 151 152 typedef EFI_STATUS (EFIAPI *MMC_SETIOS) ( 153 IN EFI_MMC_HOST_PROTOCOL *This, 154 IN UINT32 BusClockFreq, 155 IN UINT32 BusWidth, 156 IN UINT32 TimingMode 157 ); 158 159 typedef BOOLEAN (EFIAPI *MMC_ISMULTIBLOCK) ( 160 IN EFI_MMC_HOST_PROTOCOL *This 161 ); 162 163 struct _EFI_MMC_HOST_PROTOCOL { 164 165 UINT32 Revision; 166 MMC_ISCARDPRESENT IsCardPresent; 167 MMC_ISREADONLY IsReadOnly; 168 MMC_BUILDDEVICEPATH BuildDevicePath; 169 170 MMC_NOTIFYSTATE NotifyState; 171 172 MMC_SENDCOMMAND SendCommand; 173 MMC_RECEIVERESPONSE ReceiveResponse; 174 175 MMC_READBLOCKDATA ReadBlockData; 176 MMC_WRITEBLOCKDATA WriteBlockData; 177 178 MMC_SETIOS SetIos; 179 MMC_ISMULTIBLOCK IsMultiBlock; 180 181 }; 182 183 #define MMC_HOST_PROTOCOL_REVISION 0x00010002 // 1.2 184 185 #define MMC_HOST_HAS_SETIOS(Host) (Host->Revision >= MMC_HOST_PROTOCOL_REVISION && \ 186 Host->SetIos != NULL) 187 #define MMC_HOST_HAS_ISMULTIBLOCK(Host) (Host->Revision >= MMC_HOST_PROTOCOL_REVISION && \ 188 Host->IsMultiBlock != NULL) 189 190 extern EFI_GUID gEfiMmcHostProtocolGuid; 191 192 #endif 193 194