[mirror_edk2.git] / ArmPkg / Universal / MmcDxe / Mmc.c

/** @file\r
  Main file of the MMC Dxe driver. The driver entrypoint is defined into this file.\r
\r
  Copyright (c) 2011, ARM Limited. All rights reserved.\r
  \r
  This program and the accompanying materials                          \r
  are licensed and made available under the terms and conditions of the BSD License         \r
  which accompanies this distribution.  The full text of the license may be found at        \r
  http://opensource.org/licenses/bsd-license.php                                            \r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
\r
**/\r
\r
#include <Protocol/DevicePath.h>\r
#include <Protocol/MmcHost.h>\r
\r
#include <Library/BaseLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
#include <Library/UefiBootServicesTableLib.h>\r
#include <Library/DevicePathLib.h>\r
#include <Library/DebugLib.h>\r
\r
#include "Mmc.h"\r
\r
EFI_BLOCK_IO_MEDIA mMmcMediaTemplate = {\r
  SIGNATURE_32('m','m','c','o'),            // MediaId\r
  TRUE,                                     // RemovableMedia\r
  FALSE,                                    // MediaPresent\r
  FALSE,                                    // LogicalPartition\r
  FALSE,                                    // ReadOnly\r
  FALSE,                                    // WriteCaching\r
  512,                                      // BlockSize\r
  4,                                        // IoAlign\r
  0,                                        // Pad\r
  0                                         // LastBlock\r
};\r
\r
//\r
// This device structure is serviced as a header.\r
// Its next field points to the first root bridge device node.\r
//\r
LIST_ENTRY  mMmcHostPool;\r
\r
/**\r
  Initialize the MMC Host Pool to support multiple MMC devices\r
**/\r
VOID\r
InitializeMmcHostPool (\r
  VOID\r
  )\r
{\r
    InitializeListHead (&mMmcHostPool);\r
}\r
\r
/**\r
  Insert a new Mmc Host controller to the pool\r
**/\r
VOID\r
InsertMmcHost (\r
  IN MMC_HOST_INSTANCE      *MmcHostInstance\r
  )\r
{\r
    InsertTailList (&mMmcHostPool, &(MmcHostInstance->Link));\r
}\r
\r
/*\r
  Remove a new Mmc Host controller to the pool\r
*/\r
VOID\r
RemoveMmcHost (\r
  IN MMC_HOST_INSTANCE      *MmcHostInstance\r
  )\r
{\r
    RemoveEntryList (&(MmcHostInstance->Link));\r
}\r
\r
MMC_HOST_INSTANCE* CreateMmcHostInstance(\r
  IN EFI_MMC_HOST_PROTOCOL* MmcHost\r
  )\r
{\r
    EFI_STATUS          Status;\r
    MMC_HOST_INSTANCE*  MmcHostInstance;\r
    EFI_DEVICE_PATH_PROTOCOL    *NewDevicePathNode;\r
    EFI_DEVICE_PATH_PROTOCOL    *DevicePath;\r
\r
    MmcHostInstance = AllocateZeroPool (sizeof (MMC_HOST_INSTANCE));\r
    if (MmcHostInstance == NULL) {\r
        return NULL;\r
    }\r
\r
    MmcHostInstance->Signature = MMC_HOST_INSTANCE_SIGNATURE;\r
\r
    MmcHostInstance->State = MmcHwInitializationState;\r
    \r
    MmcHostInstance->BlockIo.Media = AllocateCopyPool (sizeof(EFI_BLOCK_IO_MEDIA), &mMmcMediaTemplate);\r
    if (MmcHostInstance->BlockIo.Media == NULL) {\r
        goto FREE_INSTANCE;\r
    }\r
\r
    MmcHostInstance->BlockIo.Revision = EFI_BLOCK_IO_INTERFACE_REVISION;\r
    MmcHostInstance->BlockIo.Reset = MmcReset;\r
    MmcHostInstance->BlockIo.ReadBlocks = MmcReadBlocks;\r
    MmcHostInstance->BlockIo.WriteBlocks = MmcWriteBlocks;\r
    MmcHostInstance->BlockIo.FlushBlocks = MmcFlushBlocks;\r
\r
    MmcHostInstance->MmcHost = MmcHost;\r
\r
    // Create DevicePath for the new MMC Host\r
    Status = MmcHost->BuildDevicePath(&NewDevicePathNode);\r
    if (EFI_ERROR (Status)) {\r
        goto FREE_MEDIA;\r
    }\r
\r
    DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) AllocatePool (END_DEVICE_PATH_LENGTH);\r
    if (DevicePath == NULL) {\r
        goto FREE_MEDIA;\r
    }\r
    \r
    SetDevicePathEndNode (DevicePath);\r
    MmcHostInstance->DevicePath = AppendDevicePathNode (DevicePath, NewDevicePathNode);\r
\r
    // Publish BlockIO protocol interface\r
    Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &MmcHostInstance->MmcHandle,\r
                  &gEfiBlockIoProtocolGuid,&(MmcHostInstance->BlockIo),\r
                  &gEfiDevicePathProtocolGuid,MmcHostInstance->DevicePath,\r
                  NULL\r
                  );\r
    if (EFI_ERROR(Status)) {\r
        goto FREE_DEVICE_PATH;\r
    }\r
\r
    return MmcHostInstance;\r
\r
FREE_DEVICE_PATH:\r
    FreePool(DevicePath);\r
\r
FREE_MEDIA:\r
    FreePool(MmcHostInstance->BlockIo.Media);\r
\r
FREE_INSTANCE:\r
    FreePool(MmcHostInstance);\r
\r
    return NULL;\r
}\r
\r
EFI_STATUS DestroyMmcHostInstance(\r
  IN MMC_HOST_INSTANCE* MmcHostInstance\r
  )\r
{\r
    EFI_STATUS Status;\r
\r
    // Uninstall Protocol Interfaces\r
    Status = gBS->UninstallMultipleProtocolInterfaces(\r
            &MmcHostInstance->MmcHandle,\r
            &gEfiBlockIoProtocolGuid,&(MmcHostInstance->BlockIo),\r
            &gEfiDevicePathProtocolGuid,&(MmcHostInstance->DevicePath),\r
            NULL\r
            );\r
    ASSERT_EFI_ERROR (Status);\r
    \r
    // Free Memory allocated for the instance\r
    if (MmcHostInstance->BlockIo.Media) {\r
        FreePool(MmcHostInstance->BlockIo.Media);\r
    }\r
    FreePool (MmcHostInstance);\r
\r
    return Status;\r
}\r
\r
/**\r
  This function checks if the controller implement the Mmc Host and the Device Path Protocols\r
**/\r
EFI_STATUS\r
EFIAPI\r
MmcDriverBindingSupported (\r
  IN EFI_DRIVER_BINDING_PROTOCOL    *This,\r
  IN EFI_HANDLE                     Controller,\r
  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath\r
  )\r
{\r
    EFI_STATUS                      Status;\r
    //EFI_DEVICE_PATH_PROTOCOL        *ParentDevicePath;\r
    EFI_MMC_HOST_PROTOCOL           *MmcHost;\r
    EFI_DEV_PATH_PTR                Node;\r
\r
    //\r
    // Check RemainingDevicePath validation\r
    //\r
    if (RemainingDevicePath != NULL) {\r
        //\r
        // Check if RemainingDevicePath is the End of Device Path Node, \r
        // if yes, go on checking other conditions\r
        //\r
        if (!IsDevicePathEnd (RemainingDevicePath)) {\r
            //\r
            // If RemainingDevicePath isn't the End of Device Path Node,\r
            // check its validation\r
            //\r
            Node.DevPath = RemainingDevicePath;\r
            if (Node.DevPath->Type != HARDWARE_DEVICE_PATH ||\r
              Node.DevPath->SubType != HW_VENDOR_DP      ||\r
              DevicePathNodeLength(Node.DevPath) != sizeof(VENDOR_DEVICE_PATH)) {\r
                return EFI_UNSUPPORTED;\r
            }\r
        }\r
    }\r
\r
    //\r
    // Check if Mmc Host protocol is installed by platform\r
    //\r
    Status = gBS->OpenProtocol (\r
                  Controller,\r
                  &gEfiMmcHostProtocolGuid,\r
                  (VOID **) &MmcHost,\r
                  This->DriverBindingHandle,\r
                  Controller,\r
                  EFI_OPEN_PROTOCOL_BY_DRIVER\r
                  );\r
    if (Status == EFI_ALREADY_STARTED) {\r
        return EFI_SUCCESS;\r
    }\r
    if (EFI_ERROR (Status)) {\r
        return Status;\r
    }\r
\r
    //\r
    // Close the Mmc Host used to perform the supported test\r
    //\r
    gBS->CloseProtocol (\r
        Controller,\r
        &gEfiMmcHostProtocolGuid,\r
        This->DriverBindingHandle,\r
        Controller\r
        );\r
\r
    return EFI_SUCCESS;\r
}\r
\r
/**\r
  \r
**/\r
EFI_STATUS\r
EFIAPI\r
MmcDriverBindingStart (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   Controller,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath\r
  )\r
{\r
    EFI_STATUS              Status;\r
    MMC_HOST_INSTANCE       *MmcHostInstance;\r
    EFI_MMC_HOST_PROTOCOL   *MmcHost;\r
\r
    //\r
    // Check RemainingDevicePath validation\r
    //\r
    if (RemainingDevicePath != NULL) {\r
        //\r
        // Check if RemainingDevicePath is the End of Device Path Node, \r
        // if yes, return EFI_SUCCESS\r
        //\r
        if (IsDevicePathEnd (RemainingDevicePath)) {\r
            return EFI_SUCCESS;\r
        }\r
    }\r
\r
    //\r
    // Get the Mmc Host protocol\r
    //\r
    Status = gBS->OpenProtocol (\r
                  Controller,\r
                  &gEfiMmcHostProtocolGuid,\r
                  (VOID **) &MmcHost,\r
                  This->DriverBindingHandle,\r
                  Controller,\r
                  EFI_OPEN_PROTOCOL_BY_DRIVER\r
                  );\r
    if (EFI_ERROR (Status)) {\r
        if (Status == EFI_ALREADY_STARTED) {\r
            return EFI_SUCCESS;\r
        }\r
        return Status;\r
    }\r
\r
    MmcHostInstance = CreateMmcHostInstance(MmcHost);\r
    if (MmcHostInstance != NULL) {\r
        // Add the handle to the pool\r
        InsertMmcHost (MmcHostInstance);\r
    }\r
\r
    return EFI_SUCCESS;\r
}\r
\r
/**\r
  \r
**/\r
EFI_STATUS\r
EFIAPI\r
MmcDriverBindingStop (\r
  IN  EFI_DRIVER_BINDING_PROTOCOL   *This,\r
  IN  EFI_HANDLE                    Controller,\r
  IN  UINTN                         NumberOfChildren,\r
  IN  EFI_HANDLE                    *ChildHandleBuffer\r
  )\r
{\r
    EFI_STATUS          Status = EFI_SUCCESS;\r
    LIST_ENTRY          *CurrentLink;\r
    MMC_HOST_INSTANCE   *MmcHostInstance;\r
\r
    MMC_TRACE("MmcDriverBindingStop()");\r
\r
    // For each MMC instance\r
    CurrentLink = mMmcHostPool.ForwardLink;\r
    while (CurrentLink != NULL && CurrentLink != &mMmcHostPool && (Status == EFI_SUCCESS)) {\r
        MmcHostInstance = MMC_HOST_INSTANCE_FROM_LINK(CurrentLink);\r
        ASSERT(MmcHostInstance != NULL);\r
\r
        // Close gEfiMmcHostProtocolGuid\r
        Status = gBS->CloseProtocol (\r
                    Controller,\r
                    &gEfiMmcHostProtocolGuid,(VOID **) &MmcHostInstance->MmcHost,\r
                    This->DriverBindingHandle\r
                    );\r
\r
        // Remove MMC Host Instance from the pool\r
        RemoveMmcHost (MmcHostInstance);\r
\r
        // Destroy MmcHostInstance\r
        DestroyMmcHostInstance (MmcHostInstance);\r
    }\r
\r
    return Status;\r
}\r
\r
EFI_DRIVER_BINDING_PROTOCOL gMmcDriverBinding = {\r
  MmcDriverBindingSupported,\r
  MmcDriverBindingStart,\r
  MmcDriverBindingStop,\r
  0xa,\r
  NULL,\r
  NULL\r
};\r
\r
/**\r
  \r
**/\r
EFI_STATUS\r
EFIAPI\r
MmcDxeInitialize (\r
  IN EFI_HANDLE         ImageHandle,\r
  IN EFI_SYSTEM_TABLE   *SystemTable\r
  )\r
{\r
    EFI_STATUS  Status;\r
\r
    //\r
    // Initializes MMC Host pool\r
    //\r
    InitializeMmcHostPool ();\r
\r
    //\r
    // Install driver model protocol(s).\r
    //\r
    Status = EfiLibInstallDriverBindingComponentName2 (\r
             ImageHandle,\r
             SystemTable,\r
             &gMmcDriverBinding,\r
             ImageHandle,\r
             &gMmcComponentName,\r
             &gMmcComponentName2\r
             );\r
    ASSERT_EFI_ERROR (Status);\r
\r
    // Install driver diagnostics\r
    Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &ImageHandle, \r
                  &gEfiDriverDiagnostics2ProtocolGuid,&gMmcDriverDiagnostics2,\r
                  NULL\r
                  );\r
    ASSERT_EFI_ERROR (Status);\r
\r
    return Status;\r
}\r
Commit	Line	Data
1bfda055	1	/** @file\r
	2	Main file of the MMC Dxe driver. The driver entrypoint is defined into this file.\r
	3	\r
	4	Copyright (c) 2011, ARM Limited. All rights reserved.\r
	5	\r
	6	This program and the accompanying materials \r
	7	are licensed and made available under the terms and conditions of the BSD License \r
	8	which accompanies this distribution. The full text of the license may be found at \r
	9	http://opensource.org/licenses/bsd-license.php \r
	10	\r
	11	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	12	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	13	\r
	14	**/\r
	15	\r
	16	#include <Protocol/DevicePath.h>\r
	17	#include <Protocol/MmcHost.h>\r
	18	\r
	19	#include <Library/BaseLib.h>\r
	20	#include <Library/BaseMemoryLib.h>\r
	21	#include <Library/MemoryAllocationLib.h>\r
	22	#include <Library/UefiBootServicesTableLib.h>\r
	23	#include <Library/DevicePathLib.h>\r
	24	#include <Library/DebugLib.h>\r
	25	\r
	26	#include "Mmc.h"\r
	27	\r
	28	EFI_BLOCK_IO_MEDIA mMmcMediaTemplate = {\r
	29	SIGNATURE_32('m','m','c','o'), // MediaId\r
	30	TRUE, // RemovableMedia\r
	31	FALSE, // MediaPresent\r
	32	FALSE, // LogicalPartition\r
	33	FALSE, // ReadOnly\r
	34	FALSE, // WriteCaching\r
	35	512, // BlockSize\r
	36	4, // IoAlign\r
	37	0, // Pad\r
	38	0 // LastBlock\r
	39	};\r
	40	\r
	41	//\r
	42	// This device structure is serviced as a header.\r
	43	// Its next field points to the first root bridge device node.\r
	44	//\r
	45	LIST_ENTRY mMmcHostPool;\r
	46	\r
	47	/**\r
	48	Initialize the MMC Host Pool to support multiple MMC devices\r
	49	**/\r
	50	VOID\r
	51	InitializeMmcHostPool (\r
	52	VOID\r
	53	)\r
	54	{\r
	55	InitializeListHead (&mMmcHostPool);\r
	56	}\r
	57	\r
	58	/**\r
	59	Insert a new Mmc Host controller to the pool\r
	60	**/\r
	61	VOID\r
	62	InsertMmcHost (\r
	63	IN MMC_HOST_INSTANCE *MmcHostInstance\r
	64	)\r
65	{\r
66	InsertTailList (&mMmcHostPool, &(MmcHostInstance->Link));\r
67	}\r
68	\r
69	/*\r
70	Remove a new Mmc Host controller to the pool\r
71	*/\r
72	VOID\r
73	RemoveMmcHost (\r
74	IN MMC_HOST_INSTANCE *MmcHostInstance\r
75	)\r
76	{\r
77	RemoveEntryList (&(MmcHostInstance->Link));\r
78	}\r
79	\r
80	MMC_HOST_INSTANCE* CreateMmcHostInstance(\r
81	IN EFI_MMC_HOST_PROTOCOL* MmcHost\r
82	)\r
83	{\r
84	EFI_STATUS Status;\r
85	MMC_HOST_INSTANCE* MmcHostInstance;\r
86	EFI_DEVICE_PATH_PROTOCOL *NewDevicePathNode;\r
87	EFI_DEVICE_PATH_PROTOCOL *DevicePath;\r
88	\r
89	MmcHostInstance = AllocateZeroPool (sizeof (MMC_HOST_INSTANCE));\r
90	if (MmcHostInstance == NULL) {\r
91	return NULL;\r
92	}\r
93	\r
94	MmcHostInstance->Signature = MMC_HOST_INSTANCE_SIGNATURE;\r
95	\r
96	MmcHostInstance->State = MmcHwInitializationState;\r
97	\r
98	MmcHostInstance->BlockIo.Media = AllocateCopyPool (sizeof(EFI_BLOCK_IO_MEDIA), &mMmcMediaTemplate);\r
99	if (MmcHostInstance->BlockIo.Media == NULL) {\r
100	goto FREE_INSTANCE;\r
101	}\r
102	\r
103	MmcHostInstance->BlockIo.Revision = EFI_BLOCK_IO_INTERFACE_REVISION;\r
104	MmcHostInstance->BlockIo.Reset = MmcReset;\r
105	MmcHostInstance->BlockIo.ReadBlocks = MmcReadBlocks;\r
106	MmcHostInstance->BlockIo.WriteBlocks = MmcWriteBlocks;\r
107	MmcHostInstance->BlockIo.FlushBlocks = MmcFlushBlocks;\r
108	\r
109	MmcHostInstance->MmcHost = MmcHost;\r
110	\r
111	// Create DevicePath for the new MMC Host\r
112	Status = MmcHost->BuildDevicePath(&NewDevicePathNode);\r
113	if (EFI_ERROR (Status)) {\r
114	goto FREE_MEDIA;\r
115	}\r
116	\r
117	DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) AllocatePool (END_DEVICE_PATH_LENGTH);\r
118	if (DevicePath == NULL) {\r
119	goto FREE_MEDIA;\r
120	}\r
121	\r
122	SetDevicePathEndNode (DevicePath);\r
123	MmcHostInstance->DevicePath = AppendDevicePathNode (DevicePath, NewDevicePathNode);\r
124	\r
125	// Publish BlockIO protocol interface\r
126	Status = gBS->InstallMultipleProtocolInterfaces (\r
127	&MmcHostInstance->MmcHandle,\r
128	&gEfiBlockIoProtocolGuid,&(MmcHostInstance->BlockIo),\r
129	&gEfiDevicePathProtocolGuid,MmcHostInstance->DevicePath,\r
130	NULL\r
131	);\r
132	if (EFI_ERROR(Status)) {\r
133	goto FREE_DEVICE_PATH;\r
134	}\r
135	\r
136	return MmcHostInstance;\r
137	\r
138	FREE_DEVICE_PATH:\r
139	FreePool(DevicePath);\r
140	\r
141	FREE_MEDIA:\r
142	FreePool(MmcHostInstance->BlockIo.Media);\r
143	\r
144	FREE_INSTANCE:\r
145	FreePool(MmcHostInstance);\r
146	\r
147	return NULL;\r
148	}\r
149	\r
150	EFI_STATUS DestroyMmcHostInstance(\r
151	IN MMC_HOST_INSTANCE* MmcHostInstance\r
152	)\r
153	{\r
154	EFI_STATUS Status;\r
155	\r
156	// Uninstall Protocol Interfaces\r
157	Status = gBS->UninstallMultipleProtocolInterfaces(\r
158	&MmcHostInstance->MmcHandle,\r
159	&gEfiBlockIoProtocolGuid,&(MmcHostInstance->BlockIo),\r
160	&gEfiDevicePathProtocolGuid,&(MmcHostInstance->DevicePath),\r
161	NULL\r
162	);\r
163	ASSERT_EFI_ERROR (Status);\r
164	\r
165	// Free Memory allocated for the instance\r
166	if (MmcHostInstance->BlockIo.Media) {\r
167	FreePool(MmcHostInstance->BlockIo.Media);\r
168	}\r
169	FreePool (MmcHostInstance);\r
170	\r
171	return Status;\r
172	}\r
173	\r
174	/**\r
175	This function checks if the controller implement the Mmc Host and the Device Path Protocols\r
176	**/\r
177	EFI_STATUS\r
178	EFIAPI\r
179	MmcDriverBindingSupported (\r
180	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
181	IN EFI_HANDLE Controller,\r
182	IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
183	)\r
184	{\r
185	EFI_STATUS Status;\r
186	//EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath;\r
187	EFI_MMC_HOST_PROTOCOL *MmcHost;\r
188	EFI_DEV_PATH_PTR Node;\r
189	\r
190	//\r
191	// Check RemainingDevicePath validation\r
192	//\r
193	if (RemainingDevicePath != NULL) {\r
194	//\r
195	// Check if RemainingDevicePath is the End of Device Path Node, \r
196	// if yes, go on checking other conditions\r
197	//\r
198	if (!IsDevicePathEnd (RemainingDevicePath)) {\r
199	//\r
200	// If RemainingDevicePath isn't the End of Device Path Node,\r
201	// check its validation\r
202	//\r
203	Node.DevPath = RemainingDevicePath;\r
204	if (Node.DevPath->Type != HARDWARE_DEVICE_PATH \|\|\r
205	Node.DevPath->SubType != HW_VENDOR_DP \|\|\r
206	DevicePathNodeLength(Node.DevPath) != sizeof(VENDOR_DEVICE_PATH)) {\r
207	return EFI_UNSUPPORTED;\r
208	}\r
209	}\r
210	}\r
211	\r
212	//\r
213	// Check if Mmc Host protocol is installed by platform\r
214	//\r
215	Status = gBS->OpenProtocol (\r
216	Controller,\r
217	&gEfiMmcHostProtocolGuid,\r
218	(VOID **) &MmcHost,\r
219	This->DriverBindingHandle,\r
220	Controller,\r
221	EFI_OPEN_PROTOCOL_BY_DRIVER\r
222	);\r
223	if (Status == EFI_ALREADY_STARTED) {\r
224	return EFI_SUCCESS;\r
225	}\r
226	if (EFI_ERROR (Status)) {\r
227	return Status;\r
228	}\r
229	\r
230	//\r
231	// Close the Mmc Host used to perform the supported test\r
232	//\r
233	gBS->CloseProtocol (\r
234	Controller,\r
235	&gEfiMmcHostProtocolGuid,\r
236	This->DriverBindingHandle,\r
237	Controller\r
238	);\r
239	\r
240	return EFI_SUCCESS;\r
241	}\r
242	\r
243	/**\r
244	\r
245	**/\r
246	EFI_STATUS\r
247	EFIAPI\r
248	MmcDriverBindingStart (\r
249	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
250	IN EFI_HANDLE Controller,\r
251	IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
252	)\r
253	{\r
254	EFI_STATUS Status;\r
255	MMC_HOST_INSTANCE *MmcHostInstance;\r
256	EFI_MMC_HOST_PROTOCOL *MmcHost;\r
257	\r
258	//\r
259	// Check RemainingDevicePath validation\r
260	//\r
261	if (RemainingDevicePath != NULL) {\r
262	//\r
263	// Check if RemainingDevicePath is the End of Device Path Node, \r
264	// if yes, return EFI_SUCCESS\r
265	//\r
266	if (IsDevicePathEnd (RemainingDevicePath)) {\r
267	return EFI_SUCCESS;\r
268	}\r
269	}\r
270	\r
271	//\r
272	// Get the Mmc Host protocol\r
273	//\r
274	Status = gBS->OpenProtocol (\r
275	Controller,\r
276	&gEfiMmcHostProtocolGuid,\r
277	(VOID **) &MmcHost,\r
278	This->DriverBindingHandle,\r
279	Controller,\r
280	EFI_OPEN_PROTOCOL_BY_DRIVER\r
281	);\r
282	if (EFI_ERROR (Status)) {\r
283	if (Status == EFI_ALREADY_STARTED) {\r
284	return EFI_SUCCESS;\r
285	}\r
286	return Status;\r
287	}\r
288	\r
289	MmcHostInstance = CreateMmcHostInstance(MmcHost);\r
290	if (MmcHostInstance != NULL) {\r
291	// Add the handle to the pool\r
292	InsertMmcHost (MmcHostInstance);\r
293	}\r
294	\r
295	return EFI_SUCCESS;\r
296	}\r
297	\r
298	/**\r
299	\r
300	**/\r
301	EFI_STATUS\r
302	EFIAPI\r
303	MmcDriverBindingStop (\r
304	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
305	IN EFI_HANDLE Controller,\r
306	IN UINTN NumberOfChildren,\r
307	IN EFI_HANDLE *ChildHandleBuffer\r
308	)\r
309	{\r
310	EFI_STATUS Status = EFI_SUCCESS;\r
311	LIST_ENTRY *CurrentLink;\r
312	MMC_HOST_INSTANCE *MmcHostInstance;\r
313	\r
314	MMC_TRACE("MmcDriverBindingStop()");\r
315	\r
316	// For each MMC instance\r
317	CurrentLink = mMmcHostPool.ForwardLink;\r
318	while (CurrentLink != NULL && CurrentLink != &mMmcHostPool && (Status == EFI_SUCCESS)) {\r
319	MmcHostInstance = MMC_HOST_INSTANCE_FROM_LINK(CurrentLink);\r
320	ASSERT(MmcHostInstance != NULL);\r
321	\r
322	// Close gEfiMmcHostProtocolGuid\r
323	Status = gBS->CloseProtocol (\r
324	Controller,\r
325	&gEfiMmcHostProtocolGuid,(VOID **) &MmcHostInstance->MmcHost,\r
326	This->DriverBindingHandle\r
327	);\r
328	\r
329	// Remove MMC Host Instance from the pool\r
330	RemoveMmcHost (MmcHostInstance);\r
331	\r
332	// Destroy MmcHostInstance\r
333	DestroyMmcHostInstance (MmcHostInstance);\r
334	}\r
335	\r
336	return Status;\r
337	}\r
338	\r
339	EFI_DRIVER_BINDING_PROTOCOL gMmcDriverBinding = {\r
340	MmcDriverBindingSupported,\r
341	MmcDriverBindingStart,\r
342	MmcDriverBindingStop,\r
343	0xa,\r
344	NULL,\r
345	NULL\r
346	};\r
347	\r
348	/**\r
349	\r
350	**/\r
351	EFI_STATUS\r
352	EFIAPI\r
353	MmcDxeInitialize (\r
354	IN EFI_HANDLE ImageHandle,\r
355	IN EFI_SYSTEM_TABLE *SystemTable\r
356	)\r
357	{\r
358	EFI_STATUS Status;\r
359	\r
360	//\r
361	// Initializes MMC Host pool\r
362	//\r
363	InitializeMmcHostPool ();\r
364	\r
365	//\r
366	// Install driver model protocol(s).\r
367	//\r
368	Status = EfiLibInstallDriverBindingComponentName2 (\r
369	ImageHandle,\r
370	SystemTable,\r
371	&gMmcDriverBinding,\r
372	ImageHandle,\r
373	&gMmcComponentName,\r
374	&gMmcComponentName2\r
375	);\r
376	ASSERT_EFI_ERROR (Status);\r
377	\r
378	// Install driver diagnostics\r
379	Status = gBS->InstallMultipleProtocolInterfaces (\r
380	&ImageHandle, \r
381	&gEfiDriverDiagnostics2ProtocolGuid,&gMmcDriverDiagnostics2,\r
382	NULL\r
383	);\r
384	ASSERT_EFI_ERROR (Status);\r
385	\r
386	return Status;\r
387	}\r