[mirror_edk2.git] / EmbeddedPkg / 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
e8e95df4	55	InitializeListHead (&mMmcHostPool);\r
1bfda055	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
e8e95df4	66	InsertTailList (&mMmcHostPool, &(MmcHostInstance->Link));\r
1bfda055	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
e8e95df4	77	RemoveEntryList (&(MmcHostInstance->Link));\r
1bfda055	78	}\r
1bfda055	79	\r
e8e95df4	80	MMC_HOST_INSTANCE* CreateMmcHostInstance (\r
1bfda055	81	IN EFI_MMC_HOST_PROTOCOL* MmcHost\r
	82	)\r
	83	{\r
e8e95df4	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
1bfda055	88	\r
e8e95df4	89	MmcHostInstance = AllocateZeroPool (sizeof (MMC_HOST_INSTANCE));\r
	90	if (MmcHostInstance == NULL) {\r
	91	return NULL;\r
	92	}\r
1bfda055	93	\r
e8e95df4	94	MmcHostInstance->Signature = MMC_HOST_INSTANCE_SIGNATURE;\r
1bfda055	95	\r
e8e95df4	96	MmcHostInstance->State = MmcHwInitializationState;\r
1bfda055	97	\r
e8e95df4	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
1bfda055	102	\r
e8e95df4	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
1bfda055	108	\r
e8e95df4	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
1bfda055	116	\r
e8e95df4	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
1bfda055	137	\r
1bfda055	138	FREE_DEVICE_PATH:\r
e8e95df4	139	FreePool(DevicePath);\r
1bfda055	140	\r
1bfda055	141	FREE_MEDIA:\r
e8e95df4	142	FreePool(MmcHostInstance->BlockIo.Media);\r
1bfda055	143	\r
1bfda055	144	FREE_INSTANCE:\r
e8e95df4	145	FreePool(MmcHostInstance);\r
1bfda055	146	\r
e8e95df4	147	return NULL;\r
1bfda055	148	}\r
1bfda055	149	\r
e8e95df4	150	EFI_STATUS DestroyMmcHostInstance (\r
1bfda055	151	IN MMC_HOST_INSTANCE* MmcHostInstance\r
	152	)\r
	153	{\r
e8e95df4	154	EFI_STATUS Status;\r
1bfda055	155	\r
e8e95df4	156	// Uninstall Protocol Interfaces\r
e8e95df4	157	Status = gBS->UninstallMultipleProtocolInterfaces (\r
6102636a	158	MmcHostInstance->MmcHandle,\r
e8e95df4	159	&gEfiBlockIoProtocolGuid,&(MmcHostInstance->BlockIo),\r
6102636a	160	&gEfiDevicePathProtocolGuid,MmcHostInstance->DevicePath,\r
e8e95df4	161	NULL\r
	162	);\r
	163	ASSERT_EFI_ERROR (Status);\r
1bfda055	164	\r
e8e95df4	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
1bfda055	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
e8e95df4	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
1bfda055	194	//\r
e8e95df4	195	// Check if RemainingDevicePath is the End of Device Path Node,\r
e8e95df4	196	// if yes, go on checking other conditions\r
1bfda055	197	//\r
e8e95df4	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
1bfda055	209	}\r
e8e95df4	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
1bfda055	224	return EFI_SUCCESS;\r
e8e95df4	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
1bfda055	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
e8e95df4	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
1bfda055	262	//\r
e8e95df4	263	// Check if RemainingDevicePath is the End of Device Path Node,\r
e8e95df4	264	// if yes, return EFI_SUCCESS\r
1bfda055	265	//\r
e8e95df4	266	if (IsDevicePathEnd (RemainingDevicePath)) {\r
e8e95df4	267	return EFI_SUCCESS;\r
1bfda055	268	}\r
e8e95df4	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
1bfda055	285	}\r
e8e95df4	286	return Status;\r
e8e95df4	287	}\r
1bfda055	288	\r
e8e95df4	289	MmcHostInstance = CreateMmcHostInstance(MmcHost);\r
	290	if (MmcHostInstance != NULL) {\r
	291	// Add the handle to the pool\r
	292	InsertMmcHost (MmcHostInstance);\r
	293	}\r
1bfda055	294	\r
e8e95df4	295	return EFI_SUCCESS;\r
1bfda055	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
e8e95df4	310	EFI_STATUS Status = EFI_SUCCESS;\r
	311	LIST_ENTRY *CurrentLink;\r
	312	MMC_HOST_INSTANCE *MmcHostInstance;\r
1bfda055	313	\r
e8e95df4	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
1bfda055	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
e8e95df4	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
1bfda055	387	}\r