]> git.proxmox.com Git - mirror_edk2.git/blame - MdeModulePkg/Bus/Pci/SdMmcPciHcDxe/SdDevice.c
MdeModulePkg/SdMmcPciHcDxe: Error handling enhance on tuning procedure
[mirror_edk2.git] / MdeModulePkg / Bus / Pci / SdMmcPciHcDxe / SdDevice.c
CommitLineData
48555339
FT
1/** @file\r
2 This file provides some helper functions which are specific for SD card device.\r
3\r
ac30e4c1 4 Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>\r
48555339
FT
5 This program and the accompanying materials\r
6 are licensed and made available under the terms and conditions of the BSD License\r
7 which accompanies this distribution. The full text of the license may be found at\r
8 http://opensource.org/licenses/bsd-license.php\r
9\r
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
15#include "SdMmcPciHcDxe.h"\r
16\r
17/**\r
18 Send command GO_IDLE_STATE to the device to make it go to Idle State.\r
19\r
20 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
21\r
22 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
23 @param[in] Slot The slot number of the SD card to send the command to.\r
24\r
25 @retval EFI_SUCCESS The SD device is reset correctly.\r
26 @retval Others The device reset fails.\r
27\r
28**/\r
29EFI_STATUS\r
30SdCardReset (\r
31 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
32 IN UINT8 Slot\r
33 )\r
34{\r
35 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
36 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
37 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
38 EFI_STATUS Status;\r
39\r
40 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
41 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
42 ZeroMem (&Packet, sizeof (Packet));\r
43\r
44 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
45 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
46 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
47\r
48 SdMmcCmdBlk.CommandIndex = SD_GO_IDLE_STATE;\r
49 SdMmcCmdBlk.CommandType = SdMmcCommandTypeBc;\r
50\r
51 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
52\r
53 return Status;\r
54}\r
55\r
56/**\r
57 Send command SEND_IF_COND to the device to inquiry the SD Memory Card interface\r
58 condition.\r
59\r
60 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
61\r
62 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
63 @param[in] Slot The slot number of the SD card to send the command to.\r
64 @param[in] SupplyVoltage The supplied voltage by the host.\r
65 @param[in] CheckPattern The check pattern to be sent to the device.\r
66\r
67 @retval EFI_SUCCESS The operation is done correctly.\r
68 @retval Others The operation fails.\r
69\r
70**/\r
71EFI_STATUS\r
72SdCardVoltageCheck (\r
73 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
74 IN UINT8 Slot,\r
75 IN UINT8 SupplyVoltage,\r
76 IN UINT8 CheckPattern\r
77 )\r
78{\r
79 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
80 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
81 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
82 EFI_STATUS Status;\r
83\r
84 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
85 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
86 ZeroMem (&Packet, sizeof (Packet));\r
87\r
88 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
89 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
90 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
91\r
92 SdMmcCmdBlk.CommandIndex = SD_SEND_IF_COND;\r
93 SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr;\r
94 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR7;\r
95 SdMmcCmdBlk.CommandArgument = (SupplyVoltage << 8) | CheckPattern;\r
96\r
97 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
98\r
99 if (!EFI_ERROR (Status)) {\r
100 if (SdMmcStatusBlk.Resp0 != SdMmcCmdBlk.CommandArgument) {\r
101 return EFI_DEVICE_ERROR;\r
102 }\r
103 }\r
104\r
105 return Status;\r
106}\r
107\r
108/**\r
109 Send command SDIO_SEND_OP_COND to the device to see whether it is SDIO device.\r
110\r
111 Refer to SDIO Simplified Spec 3 Section 3.2 for details.\r
112\r
113 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
114 @param[in] Slot The slot number of the SD card to send the command to.\r
115 @param[in] VoltageWindow The supply voltage window.\r
116 @param[in] S18R The boolean to show if it should switch to 1.8v.\r
117\r
118 @retval EFI_SUCCESS The operation is done correctly.\r
119 @retval Others The operation fails.\r
120\r
121**/\r
122EFI_STATUS\r
123SdioSendOpCond (\r
124 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
125 IN UINT8 Slot,\r
126 IN UINT32 VoltageWindow,\r
127 IN BOOLEAN S18R\r
128 )\r
129{\r
130 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
131 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
132 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
133 EFI_STATUS Status;\r
134 UINT32 Switch;\r
135\r
136 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
137 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
138 ZeroMem (&Packet, sizeof (Packet));\r
139\r
140 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
141 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
142 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
143\r
144 SdMmcCmdBlk.CommandIndex = SDIO_SEND_OP_COND;\r
145 SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr;\r
146 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR4;\r
147\r
148 Switch = S18R ? BIT24 : 0;\r
149\r
150 SdMmcCmdBlk.CommandArgument = (VoltageWindow & 0xFFFFFF) | Switch;\r
151\r
152 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
153\r
154 return Status;\r
155}\r
156\r
157/**\r
158 Send command SD_SEND_OP_COND to the device to see whether it is SDIO device.\r
159\r
160 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
161\r
162 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
163 @param[in] Slot The slot number of the SD card to send the command to.\r
164 @param[in] Rca The relative device address of addressed device.\r
165 @param[in] VoltageWindow The supply voltage window.\r
166 @param[in] S18R The boolean to show if it should switch to 1.8v.\r
167 @param[in] Xpc The boolean to show if it should provide 0.36w power control.\r
168 @param[in] Hcs The boolean to show if it support host capacity info.\r
169 @param[out] Ocr The buffer to store returned OCR register value.\r
170\r
171 @retval EFI_SUCCESS The operation is done correctly.\r
172 @retval Others The operation fails.\r
173\r
174**/\r
175EFI_STATUS\r
176SdCardSendOpCond (\r
177 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
178 IN UINT8 Slot,\r
179 IN UINT16 Rca,\r
180 IN UINT32 VoltageWindow,\r
181 IN BOOLEAN S18R,\r
182 IN BOOLEAN Xpc,\r
183 IN BOOLEAN Hcs,\r
184 OUT UINT32 *Ocr\r
185 )\r
186{\r
187 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
188 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
189 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
190 EFI_STATUS Status;\r
191 UINT32 Switch;\r
192 UINT32 MaxPower;\r
193 UINT32 HostCapacity;\r
194\r
195 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
196 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
197 ZeroMem (&Packet, sizeof (Packet));\r
198\r
199 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
200 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
201 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
202\r
203 SdMmcCmdBlk.CommandIndex = SD_APP_CMD;\r
204 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
205 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
206 SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16;\r
207\r
208 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
209 if (EFI_ERROR (Status)) {\r
210 return Status;\r
211 }\r
212\r
213 SdMmcCmdBlk.CommandIndex = SD_SEND_OP_COND;\r
214 SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr;\r
215 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR3;\r
216\r
217 Switch = S18R ? BIT24 : 0;\r
218 MaxPower = Xpc ? BIT28 : 0;\r
219 HostCapacity = Hcs ? BIT30 : 0;\r
220\r
221 SdMmcCmdBlk.CommandArgument = (VoltageWindow & 0xFFFFFF) | Switch | MaxPower | HostCapacity;\r
222\r
223 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
224 if (!EFI_ERROR (Status)) {\r
225 //\r
226 // For details, refer to SD Host Controller Simplified Spec 3.0 Table 2-12.\r
227 //\r
228 *Ocr = SdMmcStatusBlk.Resp0;\r
229 }\r
230\r
231 return Status;\r
232}\r
233\r
234/**\r
235 Broadcast command ALL_SEND_CID to the bus to ask all the SD devices to send the\r
236 data of their CID registers.\r
237\r
238 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
239\r
240 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
241 @param[in] Slot The slot number of the SD card to send the command to.\r
242\r
243 @retval EFI_SUCCESS The operation is done correctly.\r
244 @retval Others The operation fails.\r
245\r
246**/\r
247EFI_STATUS\r
248SdCardAllSendCid (\r
249 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
250 IN UINT8 Slot\r
251 )\r
252{\r
253 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
254 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
255 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
256 EFI_STATUS Status;\r
257\r
258 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
259 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
260 ZeroMem (&Packet, sizeof (Packet));\r
261\r
262 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
263 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
264 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
265\r
266 SdMmcCmdBlk.CommandIndex = SD_ALL_SEND_CID;\r
267 SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr;\r
268 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR2;\r
269\r
270 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
271\r
272 return Status;\r
273}\r
274\r
275/**\r
276 Send command SET_RELATIVE_ADDR to the SD device to assign a Relative device\r
277 Address (RCA).\r
278\r
279 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
280\r
281 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
282 @param[in] Slot The slot number of the SD card to send the command to.\r
283 @param[out] Rca The relative device address to assign.\r
284\r
285 @retval EFI_SUCCESS The operation is done correctly.\r
286 @retval Others The operation fails.\r
287\r
288**/\r
289EFI_STATUS\r
290SdCardSetRca (\r
291 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
292 IN UINT8 Slot,\r
293 OUT UINT16 *Rca\r
294 )\r
295{\r
296 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
297 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
298 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
299 EFI_STATUS Status;\r
300\r
301 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
302 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
303 ZeroMem (&Packet, sizeof (Packet));\r
304\r
305 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
306 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
307 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
308\r
309 SdMmcCmdBlk.CommandIndex = SD_SET_RELATIVE_ADDR;\r
310 SdMmcCmdBlk.CommandType = SdMmcCommandTypeBcr;\r
311 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR6;\r
312\r
313 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
314 if (!EFI_ERROR (Status)) {\r
315 *Rca = (UINT16)(SdMmcStatusBlk.Resp0 >> 16);\r
316 }\r
317\r
318 return Status;\r
319}\r
320\r
321/**\r
322 Send command SEND_CSD to the SD device to get the data of the CSD register.\r
323\r
324 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
325\r
326 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
327 @param[in] Slot The slot number of the SD card to send the command to.\r
328 @param[in] Rca The relative device address of selected device.\r
329 @param[out] Csd The buffer to store the content of the CSD register.\r
330 Note the caller should ignore the lowest byte of this\r
331 buffer as the content of this byte is meaningless even\r
332 if the operation succeeds.\r
333\r
334 @retval EFI_SUCCESS The operation is done correctly.\r
335 @retval Others The operation fails.\r
336\r
337**/\r
338EFI_STATUS\r
339SdCardGetCsd (\r
340 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
341 IN UINT8 Slot,\r
342 IN UINT16 Rca,\r
343 OUT SD_CSD *Csd\r
344 )\r
345{\r
346 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
347 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
348 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
349 EFI_STATUS Status;\r
350\r
351 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
352 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
353 ZeroMem (&Packet, sizeof (Packet));\r
354\r
355 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
356 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
357 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
358\r
359 SdMmcCmdBlk.CommandIndex = SD_SEND_CSD;\r
360 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
361 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR2;\r
362 SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16;\r
363\r
364 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
365 if (!EFI_ERROR (Status)) {\r
366 //\r
367 // For details, refer to SD Host Controller Simplified Spec 3.0 Table 2-12.\r
368 //\r
369 CopyMem (((UINT8*)Csd) + 1, &SdMmcStatusBlk.Resp0, sizeof (SD_CSD) - 1);\r
370 }\r
371\r
372 return Status;\r
373}\r
374\r
375/**\r
376 Send command SEND_CSD to the SD device to get the data of the CSD register.\r
377\r
378 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
379\r
380 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
381 @param[in] Slot The slot number of the SD card to send the command to.\r
382 @param[in] Rca The relative device address of selected device.\r
383 @param[out] Scr The buffer to store the content of the SCR register.\r
384\r
385 @retval EFI_SUCCESS The operation is done correctly.\r
386 @retval Others The operation fails.\r
387\r
388**/\r
389EFI_STATUS\r
390SdCardGetScr (\r
391 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
392 IN UINT8 Slot,\r
393 IN UINT16 Rca,\r
394 OUT SD_SCR *Scr\r
395 )\r
396{\r
397 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
398 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
399 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
400 EFI_STATUS Status;\r
401\r
402 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
403 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
404 ZeroMem (&Packet, sizeof (Packet));\r
405\r
406 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
407 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
408 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
409\r
410 SdMmcCmdBlk.CommandIndex = SD_APP_CMD;\r
411 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
412 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
413 SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16;\r
414\r
415 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
416 if (EFI_ERROR (Status)) {\r
417 return Status;\r
418 }\r
419\r
420 SdMmcCmdBlk.CommandIndex = SD_SEND_SCR;\r
421 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAdtc;\r
422 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
423\r
424 Packet.InDataBuffer = Scr;\r
425 Packet.InTransferLength = sizeof (SD_SCR);\r
426\r
427 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
428\r
429 return Status;\r
430}\r
431\r
432/**\r
433 Send command SELECT_DESELECT_CARD to the SD device to select/deselect it.\r
434\r
435 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
436\r
437 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
438 @param[in] Slot The slot number of the SD card to send the command to.\r
439 @param[in] Rca The relative device address of selected device.\r
440\r
441 @retval EFI_SUCCESS The operation is done correctly.\r
442 @retval Others The operation fails.\r
443\r
444**/\r
445EFI_STATUS\r
446SdCardSelect (\r
447 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
448 IN UINT8 Slot,\r
449 IN UINT16 Rca\r
450 )\r
451{\r
452 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
453 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
454 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
455 EFI_STATUS Status;\r
456\r
457 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
458 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
459 ZeroMem (&Packet, sizeof (Packet));\r
460\r
461 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
462 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
463 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
464\r
465 SdMmcCmdBlk.CommandIndex = SD_SELECT_DESELECT_CARD;\r
466 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
ac30e4c1
FT
467 if (Rca != 0) {\r
468 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1b;\r
469 }\r
48555339
FT
470 SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16;\r
471\r
472 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
473\r
474 return Status;\r
475}\r
476\r
477/**\r
478 Send command VOLTAGE_SWITCH to the SD device to switch the voltage of the device.\r
479\r
480 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
481\r
482 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
483 @param[in] Slot The slot number of the SD card to send the command to.\r
484\r
485 @retval EFI_SUCCESS The operation is done correctly.\r
486 @retval Others The operation fails.\r
487\r
488**/\r
489EFI_STATUS\r
490SdCardVoltageSwitch (\r
491 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
492 IN UINT8 Slot\r
493 )\r
494{\r
495 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
496 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
497 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
498 EFI_STATUS Status;\r
499\r
500 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
501 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
502 ZeroMem (&Packet, sizeof (Packet));\r
503\r
504 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
505 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
506 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
507\r
508 SdMmcCmdBlk.CommandIndex = SD_VOLTAGE_SWITCH;\r
509 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
510 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
511 SdMmcCmdBlk.CommandArgument = 0;\r
512\r
513 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
514\r
515 return Status;\r
516}\r
517\r
518/**\r
519 Send command SET_BUS_WIDTH to the SD device to set the bus width.\r
520\r
521 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
522\r
523 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
524 @param[in] Slot The slot number of the SD card to send the command to.\r
525 @param[in] Rca The relative device address of addressed device.\r
526 @param[in] BusWidth The bus width to be set, it could be 1 or 4.\r
527\r
528 @retval EFI_SUCCESS The operation is done correctly.\r
529 @retval Others The operation fails.\r
530\r
531**/\r
532EFI_STATUS\r
533SdCardSetBusWidth (\r
534 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
535 IN UINT8 Slot,\r
536 IN UINT16 Rca,\r
537 IN UINT8 BusWidth\r
538 )\r
539{\r
540 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
541 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
542 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
543 EFI_STATUS Status;\r
544 UINT8 Value;\r
545\r
546 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
547 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
548 ZeroMem (&Packet, sizeof (Packet));\r
549\r
550 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
551 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
552 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
553\r
554 SdMmcCmdBlk.CommandIndex = SD_APP_CMD;\r
555 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
556 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
557 SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16;\r
558\r
559 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
560 if (EFI_ERROR (Status)) {\r
561 return Status;\r
562 }\r
563\r
564 SdMmcCmdBlk.CommandIndex = SD_SET_BUS_WIDTH;\r
565 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
566 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
567\r
568 if (BusWidth == 1) {\r
569 Value = 0;\r
570 } else if (BusWidth == 4) {\r
571 Value = 2;\r
572 } else {\r
573 return EFI_INVALID_PARAMETER;\r
574 }\r
575\r
576 SdMmcCmdBlk.CommandArgument = Value & 0x3;\r
577\r
578 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
579 return Status;\r
580}\r
581\r
582/**\r
583 Send command SWITCH_FUNC to the SD device to check switchable function or switch card function.\r
584\r
585 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
586\r
587 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
588 @param[in] Slot The slot number of the SD card to send the command to.\r
589 @param[in] AccessMode The value for access mode group.\r
590 @param[in] CommandSystem The value for command set group.\r
591 @param[in] DriveStrength The value for drive length group.\r
592 @param[in] PowerLimit The value for power limit group.\r
593 @param[in] Mode Switch or check function.\r
594\r
595 @retval EFI_SUCCESS The operation is done correctly.\r
596 @retval Others The operation fails.\r
597\r
598**/\r
599EFI_STATUS\r
600SdCardSwitch (\r
601 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
602 IN UINT8 Slot,\r
603 IN UINT8 AccessMode,\r
604 IN UINT8 CommandSystem,\r
605 IN UINT8 DriveStrength,\r
606 IN UINT8 PowerLimit,\r
607 IN BOOLEAN Mode\r
608 )\r
609{\r
610 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
611 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
612 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
613 EFI_STATUS Status;\r
614 UINT32 ModeValue;\r
615 UINT8 Data[64];\r
616\r
617 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
618 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
619 ZeroMem (&Packet, sizeof (Packet));\r
620\r
621 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
622 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
623 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
624\r
625 SdMmcCmdBlk.CommandIndex = SD_SWITCH_FUNC;\r
626 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAdtc;\r
627 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
628\r
629 ModeValue = Mode ? BIT31 : 0;\r
630 SdMmcCmdBlk.CommandArgument = (AccessMode & 0xF) | ((PowerLimit & 0xF) << 4) | \\r
631 ((DriveStrength & 0xF) << 8) | ((DriveStrength & 0xF) << 12) | \\r
632 ModeValue;\r
633\r
634 Packet.InDataBuffer = Data;\r
635 Packet.InTransferLength = sizeof (Data);\r
636\r
637 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
638\r
639 return Status;\r
640}\r
641\r
642/**\r
643 Send command SEND_STATUS to the addressed SD device to get its status register.\r
644\r
645 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
646\r
647 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
648 @param[in] Slot The slot number of the SD card to send the command to.\r
649 @param[in] Rca The relative device address of addressed device.\r
650 @param[out] DevStatus The returned device status.\r
651\r
652 @retval EFI_SUCCESS The operation is done correctly.\r
653 @retval Others The operation fails.\r
654\r
655**/\r
656EFI_STATUS\r
657SdCardSendStatus (\r
658 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
659 IN UINT8 Slot,\r
660 IN UINT16 Rca,\r
661 OUT UINT32 *DevStatus\r
662 )\r
663{\r
664 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
665 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
666 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
667 EFI_STATUS Status;\r
668\r
669 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
670 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
671 ZeroMem (&Packet, sizeof (Packet));\r
672\r
673 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
674 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
675 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
676\r
677 SdMmcCmdBlk.CommandIndex = SD_SEND_STATUS;\r
678 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAc;\r
679 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
680 SdMmcCmdBlk.CommandArgument = (UINT32)Rca << 16;\r
681\r
682 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
683 if (!EFI_ERROR (Status)) {\r
684 *DevStatus = SdMmcStatusBlk.Resp0;\r
685 }\r
686\r
687 return Status;\r
688}\r
689\r
690/**\r
691 Send command SEND_TUNING_BLOCK to the SD device for HS200 optimal sampling point\r
692 detection.\r
693\r
694 It may be sent up to 40 times until the host finishes the tuning procedure.\r
695\r
696 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 for details.\r
697\r
698 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
699 @param[in] Slot The slot number of the SD card to send the command to.\r
700\r
701 @retval EFI_SUCCESS The operation is done correctly.\r
702 @retval Others The operation fails.\r
703\r
704**/\r
705EFI_STATUS\r
706SdCardSendTuningBlk (\r
707 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
708 IN UINT8 Slot\r
709 )\r
710{\r
711 EFI_SD_MMC_COMMAND_BLOCK SdMmcCmdBlk;\r
712 EFI_SD_MMC_STATUS_BLOCK SdMmcStatusBlk;\r
713 EFI_SD_MMC_PASS_THRU_COMMAND_PACKET Packet;\r
714 EFI_STATUS Status;\r
715 UINT8 TuningBlock[64];\r
716\r
717 ZeroMem (&SdMmcCmdBlk, sizeof (SdMmcCmdBlk));\r
718 ZeroMem (&SdMmcStatusBlk, sizeof (SdMmcStatusBlk));\r
719 ZeroMem (&Packet, sizeof (Packet));\r
720\r
721 Packet.SdMmcCmdBlk = &SdMmcCmdBlk;\r
722 Packet.SdMmcStatusBlk = &SdMmcStatusBlk;\r
723 Packet.Timeout = SD_MMC_HC_GENERIC_TIMEOUT;\r
724\r
725 SdMmcCmdBlk.CommandIndex = SD_SEND_TUNING_BLOCK;\r
726 SdMmcCmdBlk.CommandType = SdMmcCommandTypeAdtc;\r
727 SdMmcCmdBlk.ResponseType = SdMmcResponseTypeR1;\r
728 SdMmcCmdBlk.CommandArgument = 0;\r
729\r
730 Packet.InDataBuffer = TuningBlock;\r
731 Packet.InTransferLength = sizeof (TuningBlock);\r
732\r
733 Status = SdMmcPassThruPassThru (PassThru, Slot, &Packet, NULL);\r
734\r
735 return Status;\r
736}\r
737\r
738/**\r
739 Tunning the sampling point of SDR104 or SDR50 bus speed mode.\r
740\r
741 Command SD_SEND_TUNING_BLOCK may be sent up to 40 times until the host finishes the\r
742 tuning procedure.\r
743\r
744 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 and\r
745 SD Host Controller Simplified Spec 3.0 section Figure 3-7 for details.\r
746\r
747 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
748 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
749 @param[in] Slot The slot number of the SD card to send the command to.\r
750\r
751 @retval EFI_SUCCESS The operation is done correctly.\r
752 @retval Others The operation fails.\r
753\r
754**/\r
755EFI_STATUS\r
756SdCardTuningClock (\r
757 IN EFI_PCI_IO_PROTOCOL *PciIo,\r
758 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
759 IN UINT8 Slot\r
760 )\r
761{\r
762 EFI_STATUS Status;\r
763 UINT8 HostCtrl2;\r
764 UINT8 Retry;\r
765\r
766 //\r
767 // Notify the host that the sampling clock tuning procedure starts.\r
768 //\r
769 HostCtrl2 = BIT6;\r
770 Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
771 if (EFI_ERROR (Status)) {\r
772 return Status;\r
773 }\r
774 //\r
775 // Ask the device to send a sequence of tuning blocks till the tuning procedure is done.\r
776 //\r
777 Retry = 0;\r
778 do {\r
779 Status = SdCardSendTuningBlk (PassThru, Slot);\r
780 if (EFI_ERROR (Status)) {\r
781 DEBUG ((EFI_D_ERROR, "SdCardSendTuningBlk: Send tuning block fails with %r\n", Status));\r
782 return Status;\r
783 }\r
784\r
785 Status = SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, TRUE, sizeof (HostCtrl2), &HostCtrl2);\r
786 if (EFI_ERROR (Status)) {\r
787 return Status;\r
788 }\r
789\r
8c983d3e 790 if ((HostCtrl2 & (BIT6 | BIT7)) == 0) {\r
48555339
FT
791 break;\r
792 }\r
8c983d3e
FT
793 if ((HostCtrl2 & (BIT6 | BIT7)) == BIT7) {\r
794 return EFI_SUCCESS;\r
795 }\r
48555339
FT
796 } while (++Retry < 40);\r
797\r
8c983d3e
FT
798 DEBUG ((EFI_D_ERROR, "SdCardTuningClock: Send tuning block fails at %d times with HostCtrl2 %02x\n", Retry, HostCtrl2));\r
799 //\r
800 // Abort the tuning procedure and reset the tuning circuit.\r
801 //\r
802 HostCtrl2 = (UINT8)~(BIT6 | BIT7);\r
803 Status = SdMmcHcAndMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
804 if (EFI_ERROR (Status)) {\r
805 return Status;\r
48555339 806 }\r
8c983d3e 807 return EFI_DEVICE_ERROR;\r
48555339
FT
808}\r
809\r
810/**\r
811 Switch the bus width to specified width.\r
812\r
813 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 and\r
814 SD Host Controller Simplified Spec 3.0 section Figure 3-7 for details.\r
815\r
816 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
817 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
818 @param[in] Slot The slot number of the SD card to send the command to.\r
819 @param[in] Rca The relative device address to be assigned.\r
820 @param[in] BusWidth The bus width to be set, it could be 4 or 8.\r
821\r
822 @retval EFI_SUCCESS The operation is done correctly.\r
823 @retval Others The operation fails.\r
824\r
825**/\r
826EFI_STATUS\r
827SdCardSwitchBusWidth (\r
828 IN EFI_PCI_IO_PROTOCOL *PciIo,\r
829 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
830 IN UINT8 Slot,\r
831 IN UINT16 Rca,\r
832 IN UINT8 BusWidth\r
833 )\r
834{\r
835 EFI_STATUS Status;\r
836 UINT32 DevStatus;\r
837\r
838 Status = SdCardSetBusWidth (PassThru, Slot, Rca, BusWidth);\r
839 if (EFI_ERROR (Status)) {\r
840 DEBUG ((EFI_D_ERROR, "SdCardSwitchBusWidth: Switch to bus width %d fails with %r\n", BusWidth, Status));\r
841 return Status;\r
842 }\r
843\r
844 Status = SdCardSendStatus (PassThru, Slot, Rca, &DevStatus);\r
845 if (EFI_ERROR (Status)) {\r
846 DEBUG ((EFI_D_ERROR, "SdCardSwitchBusWidth: Send status fails with %r\n", Status));\r
847 return Status;\r
848 }\r
849 //\r
850 // Check the switch operation is really successful or not.\r
851 //\r
852 if ((DevStatus >> 16) != 0) {\r
853 DEBUG ((EFI_D_ERROR, "SdCardSwitchBusWidth: The switch operation fails as DevStatus is 0x%08x\n", DevStatus));\r
854 return EFI_DEVICE_ERROR;\r
855 }\r
856\r
857 Status = SdMmcHcSetBusWidth (PciIo, Slot, BusWidth);\r
858\r
859 return Status;\r
860}\r
861\r
862/**\r
863 Switch the high speed timing according to request.\r
864\r
865 Refer to SD Physical Layer Simplified Spec 4.1 Section 4.7 and\r
866 SD Host Controller Simplified Spec 3.0 section Figure 2-29 for details.\r
867\r
868 @param[in] PciIo A pointer to the EFI_PCI_IO_PROTOCOL instance.\r
869 @param[in] PassThru A pointer to the EFI_SD_MMC_PASS_THRU_PROTOCOL instance.\r
870 @param[in] Slot The slot number of the SD card to send the command to.\r
871 @param[in] Rca The relative device address to be assigned.\r
872 @param[in] S18A The boolean to show if it's a UHS-I SD card.\r
873\r
874 @retval EFI_SUCCESS The operation is done correctly.\r
875 @retval Others The operation fails.\r
876\r
877**/\r
878EFI_STATUS\r
879SdCardSetBusMode (\r
880 IN EFI_PCI_IO_PROTOCOL *PciIo,\r
881 IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru,\r
882 IN UINT8 Slot,\r
883 IN UINT16 Rca,\r
884 IN BOOLEAN S18A\r
885 )\r
886{\r
887 EFI_STATUS Status;\r
888 SD_MMC_HC_SLOT_CAP *Capability;\r
889 UINT32 ClockFreq;\r
890 UINT8 BusWidth;\r
891 UINT8 AccessMode;\r
892 UINT8 HostCtrl1;\r
893 UINT8 HostCtrl2;\r
894 SD_MMC_HC_PRIVATE_DATA *Private;\r
895\r
896 Private = SD_MMC_HC_PRIVATE_FROM_THIS (PassThru);\r
897\r
898 Capability = &Private->Capability[Slot];\r
899\r
900 Status = SdCardSelect (PassThru, Slot, Rca);\r
901 if (EFI_ERROR (Status)) {\r
902 return Status;\r
903 }\r
904\r
905 BusWidth = 4;\r
906\r
907 Status = SdCardSwitchBusWidth (PciIo, PassThru, Slot, Rca, BusWidth);\r
908 if (EFI_ERROR (Status)) {\r
909 return Status;\r
910 }\r
911\r
912 //\r
913 // Calculate supported bus speed/bus width/clock frequency.\r
914 //\r
915 ClockFreq = 0;\r
916 if (S18A && (Capability->Sdr104 != 0)) {\r
917 ClockFreq = 208;\r
918 AccessMode = 3;\r
919 } else if (S18A && (Capability->Sdr50 != 0)) {\r
920 ClockFreq = 100;\r
921 AccessMode = 2;\r
922 } else if (S18A && (Capability->Ddr50 != 0)) {\r
923 ClockFreq = 50;\r
924 AccessMode = 4;\r
925 } else {\r
926 ClockFreq = 50;\r
927 AccessMode = 1;\r
928 }\r
929\r
930 DEBUG ((EFI_D_INFO, "SdCardSetBusMode: AccessMode %d ClockFreq %d BusWidth %d\n", AccessMode, ClockFreq, BusWidth));\r
931\r
932 Status = SdCardSwitch (PassThru, Slot, AccessMode, 0, 0, 0, TRUE);\r
933 if (EFI_ERROR (Status)) {\r
934 return Status;\r
935 }\r
936\r
937 //\r
938 // Set to Hight Speed timing\r
939 //\r
940 if (AccessMode == 1) {\r
941 HostCtrl1 = BIT2;\r
942 Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL1, sizeof (HostCtrl1), &HostCtrl1);\r
943 if (EFI_ERROR (Status)) {\r
944 return Status;\r
945 }\r
946 }\r
947\r
948 HostCtrl2 = (UINT8)~0x7;\r
949 Status = SdMmcHcAndMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
950 if (EFI_ERROR (Status)) {\r
951 return Status;\r
952 }\r
953 HostCtrl2 = AccessMode;\r
954 Status = SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
955 if (EFI_ERROR (Status)) {\r
956 return Status;\r
957 }\r
958\r
959 Status = SdMmcHcClockSupply (PciIo, Slot, ClockFreq * 1000, *Capability);\r
960 if (EFI_ERROR (Status)) {\r
961 return Status;\r
962 }\r
963\r
964 if ((AccessMode == 3) || ((AccessMode == 2) && (Capability->TuningSDR50 != 0))) {\r
965 Status = SdCardTuningClock (PciIo, PassThru, Slot);\r
966 if (EFI_ERROR (Status)) {\r
967 return Status;\r
968 }\r
969 }\r
970\r
971 return Status;\r
972}\r
973\r
974/**\r
975 Execute SD device identification procedure.\r
976\r
977 Refer to SD Physical Layer Simplified Spec 4.1 Section 3.6 for details.\r
978\r
979 @param[in] Private A pointer to the SD_MMC_HC_PRIVATE_DATA instance.\r
980 @param[in] Slot The slot number of the SD card to send the command to.\r
981\r
982 @retval EFI_SUCCESS There is a SD card.\r
983 @retval Others There is not a SD card.\r
984\r
985**/\r
986EFI_STATUS\r
987SdCardIdentification (\r
988 IN SD_MMC_HC_PRIVATE_DATA *Private,\r
989 IN UINT8 Slot\r
990 )\r
991{\r
992 EFI_STATUS Status;\r
993 EFI_PCI_IO_PROTOCOL *PciIo;\r
994 EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru;\r
995 UINT32 Ocr;\r
996 UINT16 Rca;\r
997 BOOLEAN Xpc;\r
998 BOOLEAN S18r;\r
999 UINT64 MaxCurrent;\r
1000 UINT16 ControllerVer;\r
1001 UINT8 PowerCtrl;\r
1002 UINT32 PresentState;\r
1003 UINT8 HostCtrl2;\r
1004\r
1005 PciIo = Private->PciIo;\r
1006 PassThru = &Private->PassThru;\r
1007 //\r
1008 // 1. Send Cmd0 to the device\r
1009 //\r
1010 Status = SdCardReset (PassThru, Slot);\r
1011 if (EFI_ERROR (Status)) {\r
1012 DEBUG ((EFI_D_INFO, "SdCardIdentification: Executing Cmd0 fails with %r\n", Status));\r
1013 return Status;\r
1014 }\r
1015 //\r
1016 // 2. Send Cmd8 to the device\r
1017 //\r
1018 Status = SdCardVoltageCheck (PassThru, Slot, 0x1, 0xFF);\r
1019 if (EFI_ERROR (Status)) {\r
1020 DEBUG ((EFI_D_INFO, "SdCardIdentification: Executing Cmd8 fails with %r\n", Status));\r
1021 return Status;\r
1022 }\r
1023 //\r
1024 // 3. Send SDIO Cmd5 to the device to the SDIO device OCR register.\r
1025 //\r
1026 Status = SdioSendOpCond (PassThru, Slot, 0, FALSE);\r
1027 if (!EFI_ERROR (Status)) {\r
1028 DEBUG ((EFI_D_INFO, "SdCardIdentification: Found SDIO device, ignore it as we don't support\n"));\r
1029 return EFI_DEVICE_ERROR;\r
1030 }\r
1031 //\r
1032 // 4. Send Acmd41 with voltage window 0 to the device\r
1033 //\r
1034 Status = SdCardSendOpCond (PassThru, Slot, 0, 0, FALSE, FALSE, FALSE, &Ocr);\r
1035 if (EFI_ERROR (Status)) {\r
1036 DEBUG ((EFI_D_INFO, "SdCardIdentification: Executing SdCardSendOpCond fails with %r\n", Status));\r
1037 return EFI_DEVICE_ERROR;\r
1038 }\r
1039\r
1040 if (Private->Capability[Slot].Voltage33 != 0) {\r
1041 //\r
1042 // Support 3.3V\r
1043 //\r
1044 MaxCurrent = ((UINT32)Private->MaxCurrent[Slot] & 0xFF) * 4;\r
1045 } else if (Private->Capability[Slot].Voltage30 != 0) {\r
1046 //\r
1047 // Support 3.0V\r
1048 //\r
1049 MaxCurrent = (((UINT32)Private->MaxCurrent[Slot] >> 8) & 0xFF) * 4;\r
1050 } else if (Private->Capability[Slot].Voltage18 != 0) {\r
1051 //\r
1052 // Support 1.8V\r
1053 //\r
1054 MaxCurrent = (((UINT32)Private->MaxCurrent[Slot] >> 16) & 0xFF) * 4;\r
1055 } else {\r
1056 ASSERT (FALSE);\r
1057 return EFI_DEVICE_ERROR;\r
1058 }\r
1059\r
1060 if (MaxCurrent >= 150) {\r
1061 Xpc = TRUE;\r
1062 } else {\r
1063 Xpc = FALSE;\r
1064 }\r
1065\r
1066 Status = SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_CTRL_VER, TRUE, sizeof (ControllerVer), &ControllerVer);\r
1067 if (EFI_ERROR (Status)) {\r
1068 return Status;\r
1069 }\r
1070\r
1071 if ((ControllerVer & 0xFF) == 2) {\r
1072 S18r = TRUE;\r
1073 } else if (((ControllerVer & 0xFF) == 0) || ((ControllerVer & 0xFF) == 1)) {\r
1074 S18r = FALSE;\r
1075 } else {\r
1076 ASSERT (FALSE);\r
1077 return EFI_UNSUPPORTED;\r
1078 }\r
1079 //\r
1080 // 5. Repeatly send Acmd41 with supply voltage window to the device.\r
1081 // Note here we only support the cards complied with SD physical\r
1082 // layer simplified spec version 2.0 and version 3.0 and above.\r
1083 //\r
1084 do {\r
1085 Status = SdCardSendOpCond (PassThru, Slot, 0, Ocr, S18r, Xpc, TRUE, &Ocr);\r
1086 if (EFI_ERROR (Status)) {\r
1087 DEBUG ((EFI_D_ERROR, "SdCardIdentification: SdCardSendOpCond fails with %r Ocr %x, S18r %x, Xpc %x\n", Status, Ocr, S18r, Xpc));\r
1088 return EFI_DEVICE_ERROR;\r
1089 }\r
1090 } while ((Ocr & BIT31) == 0);\r
1091\r
1092 //\r
1093 // 6. If the S18A bit is set and the Host Controller supports 1.8V signaling\r
1094 // (One of support bits is set to 1: SDR50, SDR104 or DDR50 in the\r
1095 // Capabilities register), switch its voltage to 1.8V.\r
1096 //\r
1097 if ((Private->Capability[Slot].Sdr50 != 0 ||\r
1098 Private->Capability[Slot].Sdr104 != 0 ||\r
1099 Private->Capability[Slot].Ddr50 != 0) &&\r
1100 ((Ocr & BIT24) != 0)) {\r
1101 Status = SdCardVoltageSwitch (PassThru, Slot);\r
1102 if (EFI_ERROR (Status)) {\r
1103 DEBUG ((EFI_D_ERROR, "SdCardIdentification: Executing SdCardVoltageSwitch fails with %r\n", Status));\r
1104 Status = EFI_DEVICE_ERROR;\r
1105 goto Error;\r
1106 } else {\r
1107 Status = SdMmcHcStopClock (PciIo, Slot);\r
1108 if (EFI_ERROR (Status)) {\r
1109 Status = EFI_DEVICE_ERROR;\r
1110 goto Error;\r
1111 }\r
1112\r
1113 SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_PRESENT_STATE, TRUE, sizeof (PresentState), &PresentState);\r
1114 if (((PresentState >> 20) & 0xF) != 0) {\r
1115 DEBUG ((EFI_D_ERROR, "SdCardIdentification: SwitchVoltage fails with PresentState = 0x%x\n", PresentState));\r
1116 Status = EFI_DEVICE_ERROR;\r
1117 goto Error;\r
1118 }\r
1119 HostCtrl2 = BIT3;\r
1120 SdMmcHcOrMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, sizeof (HostCtrl2), &HostCtrl2);\r
1121\r
1122 gBS->Stall (5000);\r
1123\r
1124 SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_HOST_CTRL2, TRUE, sizeof (HostCtrl2), &HostCtrl2);\r
1125 if ((HostCtrl2 & BIT3) == 0) {\r
1126 DEBUG ((EFI_D_ERROR, "SdCardIdentification: SwitchVoltage fails with HostCtrl2 = 0x%x\n", HostCtrl2));\r
1127 Status = EFI_DEVICE_ERROR;\r
1128 goto Error;\r
1129 }\r
1130\r
1131 SdMmcHcInitClockFreq (PciIo, Slot, Private->Capability[Slot]);\r
1132\r
2a8b78cf 1133 gBS->Stall (1000);\r
48555339
FT
1134\r
1135 SdMmcHcRwMmio (PciIo, Slot, SD_MMC_HC_PRESENT_STATE, TRUE, sizeof (PresentState), &PresentState);\r
1136 if (((PresentState >> 20) & 0xF) != 0xF) {\r
1137 DEBUG ((EFI_D_ERROR, "SdCardIdentification: SwitchVoltage fails with PresentState = 0x%x, It should be 0xF\n", PresentState));\r
1138 Status = EFI_DEVICE_ERROR;\r
1139 goto Error;\r
1140 }\r
1141 }\r
1142 DEBUG ((EFI_D_INFO, "SdCardIdentification: Switch to 1.8v signal voltage success\n"));\r
1143 }\r
1144\r
1145 Status = SdCardAllSendCid (PassThru, Slot);\r
1146 if (EFI_ERROR (Status)) {\r
1147 DEBUG ((EFI_D_ERROR, "SdCardIdentification: Executing SdCardAllSendCid fails with %r\n", Status));\r
1148 return Status;\r
1149 }\r
1150\r
1151 Status = SdCardSetRca (PassThru, Slot, &Rca);\r
1152 if (EFI_ERROR (Status)) {\r
1153 DEBUG ((EFI_D_ERROR, "SdCardIdentification: Executing SdCardSetRca fails with %r\n", Status));\r
1154 return Status;\r
1155 }\r
1156 //\r
1157 // Enter Data Tranfer Mode.\r
1158 //\r
1159 DEBUG ((EFI_D_INFO, "SdCardIdentification: Found a SD device at slot [%d]\n", Slot));\r
1160 Private->Slot[Slot].CardType = SdCardType;\r
1161\r
1162 Status = SdCardSetBusMode (PciIo, PassThru, Slot, Rca, ((Ocr & BIT24) != 0));\r
1163\r
1164 return Status;\r
1165\r
1166Error:\r
1167 //\r
1168 // Set SD Bus Power = 0\r
1169 //\r
1170 PowerCtrl = (UINT8)~BIT0;\r
1171 Status = SdMmcHcAndMmio (PciIo, Slot, SD_MMC_HC_POWER_CTRL, sizeof (PowerCtrl), &PowerCtrl);\r
1172 return EFI_DEVICE_ERROR;\r
1173}\r
1174\r