updated the Bus Driver that is able to create all or one of its child handles on each call to Start() not to create new child handle if RemainingDeviepath is the End of Device Path Node, per UEFI 2.3.

The others changes include:
1. Check RemainingDevicePath at beginning of Supported(), make sure it has been verified before Start() is called.
2. Check IO protocol firstly rather than EfiDevicePathProtocolGuid, reduce the times entering into Start() function because EfiDevicePathProtocolGuid existed on most of handle.
3. If no any child device is created on last time, and RemainingDevicePath is valid Uart Devcie path, go on creating child device handle based on this RemainingDevicePath.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9262 6f19259b-4bc3-4df7-8a09-765794883524

2 files changed, 87 insertions, 49 deletions

diff --git a/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbBus.c b/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbBus.c
index d0def777bd..b2f5fdbc75 100644
--- a/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbBus.c
+++ b/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbBus.c
@@ -2,7 +2,7 @@
 

     Usb Bus Driver Binding and Bus IO Protocol.

 

-Copyright (c) 2004 - 2007, Intel Corporation

+Copyright (c) 2004 - 2009, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -1124,42 +1124,28 @@ UsbBusControllerDriverSupported (
   // Check whether device path is valid

   //

   if (RemainingDevicePath != NULL) {

-    DevicePathNode.DevPath = RemainingDevicePath;

-

-    if ((DevicePathNode.DevPath->Type    != MESSAGING_DEVICE_PATH) ||

-        (DevicePathNode.DevPath->SubType != MSG_USB_DP &&

-         DevicePathNode.DevPath->SubType != MSG_USB_CLASS_DP

-         && DevicePathNode.DevPath->SubType != MSG_USB_WWID_DP

-         )) {

-

-      return EFI_UNSUPPORTED;

+    //

+    // Check if RemainingDevicePath is the End of Device Path Node, 

+    // if yes, go on checking other conditions

+    //

+    if (!IsDevicePathEnd (RemainingDevicePath)) {

+      //

+      // If RemainingDevicePath isn't the End of Device Path Node,

+      // check its validation

+      //

+      DevicePathNode.DevPath = RemainingDevicePath;

+      

+      if ((DevicePathNode.DevPath->Type    != MESSAGING_DEVICE_PATH) ||

+          (DevicePathNode.DevPath->SubType != MSG_USB_DP &&

+           DevicePathNode.DevPath->SubType != MSG_USB_CLASS_DP

+           && DevicePathNode.DevPath->SubType != MSG_USB_WWID_DP

+           )) {

+      

+        return EFI_UNSUPPORTED;

+      }

     }

   }

 

-  Status = gBS->OpenProtocol (

-                  Controller,

-                  &gEfiDevicePathProtocolGuid,

-                  (VOID **) &ParentDevicePath,

-                  This->DriverBindingHandle,

-                  Controller,

-                  EFI_OPEN_PROTOCOL_BY_DRIVER

-                  );

-

-  if (Status == EFI_ALREADY_STARTED) {

-    return EFI_SUCCESS;

-  }

-

-  if (EFI_ERROR (Status)) {

-    return Status;

-  }

-

-  gBS->CloseProtocol (

-         Controller,

-         &gEfiDevicePathProtocolGuid,

-         This->DriverBindingHandle,

-         Controller

-         );

-

   //

   // Check whether USB_HC2 protocol is installed

   //

@@ -1171,45 +1157,80 @@ UsbBusControllerDriverSupported (
                   Controller,

                   EFI_OPEN_PROTOCOL_BY_DRIVER

                   );

-

   if (Status == EFI_ALREADY_STARTED) {

     return EFI_SUCCESS;

   }

 

-  if (!EFI_ERROR (Status)) {

+  if (EFI_ERROR (Status)) {

+    //

+    // If failed to open USB_HC2, fall back to USB_HC

+    //

+    Status = gBS->OpenProtocol (

+                    Controller,

+                    &gEfiUsbHcProtocolGuid,

+                    (VOID **) &UsbHc,

+                    This->DriverBindingHandle,

+                    Controller,

+                    EFI_OPEN_PROTOCOL_BY_DRIVER

+                    );

+    if (Status == EFI_ALREADY_STARTED) {

+      return EFI_SUCCESS;

+    }

+  

+    if (EFI_ERROR (Status)) {

+      return Status;

+    }

+

+    //

+    // Close the USB_HC used to perform the supported test

+    //

     gBS->CloseProtocol (

           Controller,

-          &gEfiUsb2HcProtocolGuid,

+          &gEfiUsbHcProtocolGuid,

           This->DriverBindingHandle,

           Controller

           );

 

-    return EFI_SUCCESS;

-  }

+  } else {

 

+    //

+    // Close the USB_HC2 used to perform the supported test

+    //

+    gBS->CloseProtocol (

+           Controller,

+           &gEfiUsb2HcProtocolGuid,

+           This->DriverBindingHandle,

+           Controller

+           );

+  }

+ 

   //

-  // If failed to open USB_HC2, fall back to USB_HC

+  // Open the EFI Device Path protocol needed to perform the supported test

   //

   Status = gBS->OpenProtocol (

                   Controller,

-                  &gEfiUsbHcProtocolGuid,

-                  (VOID **) &UsbHc,

+                  &gEfiDevicePathProtocolGuid,

+                  (VOID **) &ParentDevicePath,

                   This->DriverBindingHandle,

                   Controller,

                   EFI_OPEN_PROTOCOL_BY_DRIVER

                   );

-

   if (Status == EFI_ALREADY_STARTED) {

     return EFI_SUCCESS;

   }

 

   if (!EFI_ERROR (Status)) {

+    //

+    // Close protocol, don't use device path protocol in the Support() function

+    //

     gBS->CloseProtocol (

           Controller,

-          &gEfiUsbHcProtocolGuid,

+          &gEfiDevicePathProtocolGuid,

           This->DriverBindingHandle,

           Controller

           );

+

+    return EFI_SUCCESS;

   }

 

   return Status;

@@ -1283,6 +1304,16 @@ UsbBusControllerDriverStart (
     //

     // Save the passed in RemainingDevicePath this time

     //

+    if (RemainingDevicePath != NULL) {

+      if (IsDevicePathEnd (RemainingDevicePath)) {

+        //

+        // If RemainingDevicePath is the End of Device Path Node,

+        // skip enumerate any device and return EFI_SUCESSS

+        // 

+        return EFI_SUCCESS;

+      }

+    }

+

     Status = UsbBusAddWantedUsbIoDP (UsbBusId, RemainingDevicePath);

     ASSERT (!EFI_ERROR (Status));

     //

diff --git a/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbUtility.c b/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbUtility.c
index c59565fd1e..2275d6efc9 100644
--- a/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbUtility.c
+++ b/MdeModulePkg/Bus/Usb/UsbBusDxe/UsbUtility.c
@@ -2,7 +2,7 @@
 

     Wrapper function for usb host controller interface.

 

-Copyright (c) 2007, Intel Corporation

+Copyright (c) 2007 - 2009, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -1109,7 +1109,7 @@ UsbBusAddWantedUsbIoDP (
   //

   // Check whether remaining device path is valid

   //

-  if (RemainingDevicePath != NULL) {

+  if (RemainingDevicePath != NULL && !IsDevicePathEnd (RemainingDevicePath)) {

     if ((RemainingDevicePath->Type    != MESSAGING_DEVICE_PATH) ||

         (RemainingDevicePath->SubType != MSG_USB_DP &&

          RemainingDevicePath->SubType != MSG_USB_CLASS_DP

@@ -1127,24 +1127,31 @@ UsbBusAddWantedUsbIoDP (
 

   if (RemainingDevicePath == NULL) {

     //

-    // RemainingDevicePath== NULL means all Usb devices in this bus are wanted.

+    // RemainingDevicePath == NULL means all Usb devices in this bus are wanted.

     // Here use a Usb class Device Path in WantedUsbIoDPList to indicate all Usb devices

     // are wanted Usb devices

     //

     Status = UsbBusFreeUsbDPList (&Bus->WantedUsbIoDPList);

     ASSERT (!EFI_ERROR (Status));

     DevicePathPtr = DuplicateDevicePath ((EFI_DEVICE_PATH_PROTOCOL *) &mAllUsbClassDevicePath);

-  } else {

+  } else if (!IsDevicePathEnd (RemainingDevicePath)) {

     //

+    // If RemainingDevicePath isn't the End of Device Path Node, 

     // Create new Usb device path according to the usb part in remaining device path

     //

     DevicePathPtr = GetUsbDPFromFullDP (RemainingDevicePath);

+  } else {

+    //

+    // If RemainingDevicePath is the End of Device Path Node,

+    // skip enumerate any device and return EFI_SUCESSS

+    // 

+    return EFI_SUCCESS;

   }

 

   ASSERT (DevicePathPtr != NULL);

   Status = AddUsbDPToList (DevicePathPtr, &Bus->WantedUsbIoDPList);

   ASSERT (!EFI_ERROR (Status));

-  gBS->FreePool (DevicePathPtr);

+  FreePool (DevicePathPtr);

   return EFI_SUCCESS;

 }