]> git.proxmox.com Git - mirror_edk2.git/blob - Omap35xxPkg/MMCHSDxe/MMCHS.h
Update comment for function header.
[mirror_edk2.git] / Omap35xxPkg / MMCHSDxe / MMCHS.h
1 /** @file
2
3 Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
4
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
9
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.
12
13 **/
14
15 #ifndef _MMCHS_H_
16 #define _MMCHS_H_
17
18 #include <Uefi.h>
19
20 #include <Library/BaseLib.h>
21 #include <Library/MemoryAllocationLib.h>
22 #include <Library/DebugLib.h>
23 #include <Library/IoLib.h>
24 #include <Library/PcdLib.h>
25 #include <Library/UefiBootServicesTableLib.h>
26 #include <Library/BaseMemoryLib.h>
27 #include <Library/OmapLib.h>
28 #include <Library/OmapDmaLib.h>
29 #include <Library/DmaLib.h>
30
31 #include <Protocol/EmbeddedExternalDevice.h>
32 #include <Protocol/BlockIo.h>
33 #include <Protocol/DevicePath.h>
34
35 #include <Omap3530/Omap3530.h>
36 #include <TPS65950.h>
37
38 #define MAX_RETRY_COUNT (100*5)
39
40 #define HCS BIT30 //Host capacity support/1 = Supporting high capacity
41 #define CCS BIT30 //Card capacity status/1 = High capacity card
42 typedef struct {
43 UINT32 Reserved0: 7; // 0
44 UINT32 V170_V195: 1; // 1.70V - 1.95V
45 UINT32 V200_V260: 7; // 2.00V - 2.60V
46 UINT32 V270_V360: 9; // 2.70V - 3.60V
47 UINT32 RESERVED_1: 5; // Reserved
48 UINT32 AccessMode: 2; // 00b (byte mode), 10b (sector mode)
49 UINT32 Busy: 1; // This bit is set to LOW if the card has not finished the power up routine
50 }OCR;
51
52 typedef struct {
53 UINT32 NOT_USED; // 1 [0:0]
54 UINT32 CRC; // CRC7 checksum [7:1]
55 UINT32 MDT; // Manufacturing date [19:8]
56 UINT32 RESERVED_1; // Reserved [23:20]
57 UINT32 PSN; // Product serial number [55:24]
58 UINT8 PRV; // Product revision [63:56]
59 UINT8 PNM[5]; // Product name [64:103]
60 UINT16 OID; // OEM/Application ID [119:104]
61 UINT8 MID; // Manufacturer ID [127:120]
62 }CID;
63
64 typedef struct {
65 UINT8 NOT_USED: 1; // Not used, always 1 [0:0]
66 UINT8 CRC: 7; // CRC [7:1]
67
68 UINT8 RESERVED_1: 2; // Reserved [9:8]
69 UINT8 FILE_FORMAT: 2; // File format [11:10]
70 UINT8 TMP_WRITE_PROTECT: 1; // Temporary write protection [12:12]
71 UINT8 PERM_WRITE_PROTECT: 1; // Permanent write protection [13:13]
72 UINT8 COPY: 1; // Copy flag (OTP) [14:14]
73 UINT8 FILE_FORMAT_GRP: 1; // File format group [15:15]
74
75 UINT16 RESERVED_2: 5; // Reserved [20:16]
76 UINT16 WRITE_BL_PARTIAL: 1; // Partial blocks for write allowed [21:21]
77 UINT16 WRITE_BL_LEN: 4; // Max. write data block length [25:22]
78 UINT16 R2W_FACTOR: 3; // Write speed factor [28:26]
79 UINT16 RESERVED_3: 2; // Reserved [30:29]
80 UINT16 WP_GRP_ENABLE: 1; // Write protect group enable [31:31]
81
82 UINT32 WP_GRP_SIZE: 7; // Write protect group size [38:32]
83 UINT32 SECTOR_SIZE: 7; // Erase sector size [45:39]
84 UINT32 ERASE_BLK_EN: 1; // Erase single block enable [46:46]
85 UINT32 C_SIZE_MULT: 3; // Device size multiplier [49:47]
86 UINT32 VDD_W_CURR_MAX: 3; // Max. write current @ VDD max [52:50]
87 UINT32 VDD_W_CURR_MIN: 3; // Max. write current @ VDD min [55:53]
88 UINT32 VDD_R_CURR_MAX: 3; // Max. read current @ VDD max [58:56]
89 UINT32 VDD_R_CURR_MIN: 3; // Max. read current @ VDD min [61:59]
90 UINT32 C_SIZELow2: 2; // Device size [63:62]
91
92 UINT32 C_SIZEHigh10: 10;// Device size [73:64]
93 UINT32 RESERVED_4: 2; // Reserved [75:74]
94 UINT32 DSR_IMP: 1; // DSR implemented [76:76]
95 UINT32 READ_BLK_MISALIGN: 1; // Read block misalignment [77:77]
96 UINT32 WRITE_BLK_MISALIGN: 1; // Write block misalignment [78:78]
97 UINT32 READ_BL_PARTIAL: 1; // Partial blocks for read allowed [79:79]
98 UINT32 READ_BL_LEN: 4; // Max. read data block length [83:80]
99 UINT32 CCC: 12;// Card command classes [95:84]
100
101 UINT8 TRAN_SPEED ; // Max. bus clock frequency [103:96]
102 UINT8 NSAC ; // Data read access-time 2 in CLK cycles (NSAC*100) [111:104]
103 UINT8 TAAC ; // Data read access-time 1 [119:112]
104
105 UINT8 RESERVED_5: 6; // Reserved [125:120]
106 UINT8 CSD_STRUCTURE: 2; // CSD structure [127:126]
107 }CSD;
108
109 typedef struct {
110 UINT8 NOT_USED: 1; // Not used, always 1 [0:0]
111 UINT8 CRC: 7; // CRC [7:1]
112 UINT8 RESERVED_1: 2; // Reserved [9:8]
113 UINT8 FILE_FORMAT: 2; // File format [11:10]
114 UINT8 TMP_WRITE_PROTECT: 1; // Temporary write protection [12:12]
115 UINT8 PERM_WRITE_PROTECT: 1; // Permanent write protection [13:13]
116 UINT8 COPY: 1; // Copy flag (OTP) [14:14]
117 UINT8 FILE_FORMAT_GRP: 1; // File format group [15:15]
118 UINT16 RESERVED_2: 5; // Reserved [20:16]
119 UINT16 WRITE_BL_PARTIAL: 1; // Partial blocks for write allowed [21:21]
120 UINT16 WRITE_BL_LEN: 4; // Max. write data block length [25:22]
121 UINT16 R2W_FACTOR: 3; // Write speed factor [28:26]
122 UINT16 RESERVED_3: 2; // Reserved [30:29]
123 UINT16 WP_GRP_ENABLE: 1; // Write protect group enable [31:31]
124 UINT16 WP_GRP_SIZE: 7; // Write protect group size [38:32]
125 UINT16 SECTOR_SIZE: 7; // Erase sector size [45:39]
126 UINT16 ERASE_BLK_EN: 1; // Erase single block enable [46:46]
127 UINT16 RESERVED_4: 1; // Reserved [47:47]
128 UINT32 C_SIZELow16: 16;// Device size [69:48]
129 UINT32 C_SIZEHigh6: 6; // Device size [69:48]
130 UINT32 RESERVED_5: 6; // Reserved [75:70]
131 UINT32 DSR_IMP: 1; // DSR implemented [76:76]
132 UINT32 READ_BLK_MISALIGN: 1; // Read block misalignment [77:77]
133 UINT32 WRITE_BLK_MISALIGN: 1; // Write block misalignment [78:78]
134 UINT32 READ_BL_PARTIAL: 1; // Partial blocks for read allowed [79:79]
135 UINT16 READ_BL_LEN: 4; // Max. read data block length [83:80]
136 UINT16 CCC: 12;// Card command classes [95:84]
137 UINT8 TRAN_SPEED ; // Max. bus clock frequency [103:96]
138 UINT8 NSAC ; // Data read access-time 2 in CLK cycles (NSAC*100) [111:104]
139 UINT8 TAAC ; // Data read access-time 1 [119:112]
140 UINT8 RESERVED_6: 6; // 0 [125:120]
141 UINT8 CSD_STRUCTURE: 2; // CSD structure [127:126]
142 }CSD_SDV2;
143
144 typedef enum {
145 UNKNOWN_CARD,
146 MMC_CARD, //MMC card
147 SD_CARD, //SD 1.1 card
148 SD_CARD_2, //SD 2.0 or above standard card
149 SD_CARD_2_HIGH //SD 2.0 or above high capacity card
150 } CARD_TYPE;
151
152 typedef enum {
153 READ,
154 WRITE
155 } OPERATION_TYPE;
156
157 typedef struct {
158 UINT16 RCA;
159 UINTN BlockSize;
160 UINTN NumBlocks;
161 UINTN ClockFrequencySelect;
162 CARD_TYPE CardType;
163 OCR OCRData;
164 CID CIDData;
165 CSD CSDData;
166 } CARD_INFO;
167
168 EFI_STATUS
169 DetectCard (
170 VOID
171 );
172
173 extern EFI_BLOCK_IO_PROTOCOL gBlockIo;
174
175 #endif