MdeModulePkg: Clean up source files

[mirror_edk2.git] / MdeModulePkg / Bus / Pci / UhciPei / UhcPeim.c

diff --git a/MdeModulePkg/Bus/Pci/UhciPei/UhcPeim.c b/MdeModulePkg/Bus/Pci/UhciPei/UhcPeim.c
index 482c404c0eaeadec2068acaf652e18e10e440c2f..ec2daf16497589db6087d75601f3f586c33db9a1 100644 (file)
--- a/MdeModulePkg/Bus/Pci/UhciPei/UhcPeim.c
+++ b/MdeModulePkg/Bus/Pci/UhciPei/UhcPeim.c
@@ -2,8 +2,8 @@
 PEIM to produce gPeiUsbHostControllerPpiGuid based on gPeiUsbControllerPpiGuid\r
 which is used to enable recovery function from USB Drivers.\r
 \r
 PEIM to produce gPeiUsbHostControllerPpiGuid based on gPeiUsbControllerPpiGuid\r
 which is used to enable recovery function from USB Drivers.\r
 \r

-Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved. <BR>\r
-  \r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved. <BR>\r
+\r

 This program and the accompanying materials\r
 are licensed and made available under the terms and conditions\r
 of the BSD License which accompanies this distribution.  The\r
 This program and the accompanying materials\r
 are licensed and made available under the terms and conditions\r
 of the BSD License which accompanies this distribution.  The\r


@@ -220,12 +220,12 @@ UhcPeimEntry (
 \r
 /**\r
   Submits control transfer to a target USB device.\r
 \r
 /**\r
   Submits control transfer to a target USB device.\r

-  \r
+\r

   @param  PeiServices            The pointer of EFI_PEI_SERVICES.\r
   @param  This                   The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  DeviceAddress          The target device address.\r
   @param  DeviceSpeed            Target device speed.\r
   @param  PeiServices            The pointer of EFI_PEI_SERVICES.\r
   @param  This                   The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  DeviceAddress          The target device address.\r
   @param  DeviceSpeed            Target device speed.\r

-  @param  MaximumPacketLength    Maximum packet size the default control transfer \r
+  @param  MaximumPacketLength    Maximum packet size the default control transfer\r

                                  endpoint is capable of sending or receiving.\r
   @param  Request                USB device request to send.\r
   @param  TransferDirection      Specifies the data direction for the data stage.\r
                                  endpoint is capable of sending or receiving.\r
   @param  Request                USB device request to send.\r
   @param  TransferDirection      Specifies the data direction for the data stage.\r


@@ -458,18 +458,18 @@ UhcControlTransfer (
 \r
 /**\r
   Submits bulk transfer to a bulk endpoint of a USB device.\r
 \r
 /**\r
   Submits bulk transfer to a bulk endpoint of a USB device.\r

-  \r
+\r

   @param  PeiServices           The pointer of EFI_PEI_SERVICES.\r
   @param  This                  The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  DeviceAddress         Target device address.\r
   @param  EndPointAddress       Endpoint number and its direction in bit 7.\r
   @param  PeiServices           The pointer of EFI_PEI_SERVICES.\r
   @param  This                  The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  DeviceAddress         Target device address.\r
   @param  EndPointAddress       Endpoint number and its direction in bit 7.\r

-  @param  MaximumPacketLength   Maximum packet size the endpoint is capable of \r
+  @param  MaximumPacketLength   Maximum packet size the endpoint is capable of\r

                                 sending or receiving.\r
                                 sending or receiving.\r

-  @param  Data                  Array of pointers to the buffers of data to transmit \r
+  @param  Data                  Array of pointers to the buffers of data to transmit\r

                                 from or receive into.\r
   @param  DataLength            The lenght of the data buffer.\r
   @param  DataToggle            On input, the initial data toggle for the transfer;\r
                                 from or receive into.\r
   @param  DataLength            The lenght of the data buffer.\r
   @param  DataToggle            On input, the initial data toggle for the transfer;\r

-                                On output, it is updated to to next data toggle to use of \r
+                                On output, it is updated to to next data toggle to use of\r

                                 the subsequent bulk transfer.\r
   @param  TimeOut               Indicates the maximum time, in millisecond, which the\r
                                 transfer is allowed to complete.\r
                                 the subsequent bulk transfer.\r
   @param  TimeOut               Indicates the maximum time, in millisecond, which the\r
                                 transfer is allowed to complete.\r


@@ -694,10 +694,10 @@ UhcBulkTransfer (
   Retrieves the number of root hub ports.\r
 \r
   @param[in]  PeiServices   The pointer to the PEI Services Table.\r
   Retrieves the number of root hub ports.\r
 \r
   @param[in]  PeiServices   The pointer to the PEI Services Table.\r

-  @param[in]  This          The pointer to this instance of the \r
+  @param[in]  This          The pointer to this instance of the\r

                             PEI_USB_HOST_CONTROLLER_PPI.\r
                             PEI_USB_HOST_CONTROLLER_PPI.\r

-  @param[out] PortNumber    The pointer to the number of the root hub ports.                                \r
-                                \r
+  @param[out] PortNumber    The pointer to the number of the root hub ports.\r
+\r

   @retval EFI_SUCCESS           The port number was retrieved successfully.\r
   @retval EFI_INVALID_PARAMETER PortNumber is NULL.\r
 \r
   @retval EFI_SUCCESS           The port number was retrieved successfully.\r
   @retval EFI_INVALID_PARAMETER PortNumber is NULL.\r
 \r


@@ -739,10 +739,10 @@ UhcGetRootHubPortNumber (
 \r
 /**\r
   Retrieves the current status of a USB root hub port.\r
 \r
 /**\r
   Retrieves the current status of a USB root hub port.\r

-  \r
+\r

   @param  PeiServices            The pointer of EFI_PEI_SERVICES.\r
   @param  This                   The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  PeiServices            The pointer of EFI_PEI_SERVICES.\r
   @param  This                   The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r

-  @param  PortNumber             The root hub port to retrieve the state from.  \r
+  @param  PortNumber             The root hub port to retrieve the state from.\r

   @param  PortStatus             Variable to receive the port state.\r
 \r
   @retval EFI_SUCCESS            The status of the USB root hub port specified.\r
   @param  PortStatus             Variable to receive the port state.\r
 \r
   @retval EFI_SUCCESS            The status of the USB root hub port specified.\r


@@ -832,7 +832,7 @@ UhcGetRootHubPortStatus (
 \r
 /**\r
   Sets a feature for the specified root hub port.\r
 \r
 /**\r
   Sets a feature for the specified root hub port.\r

-  \r
+\r

   @param  PeiServices           The pointer of EFI_PEI_SERVICES\r
   @param  This                  The pointer of PEI_USB_HOST_CONTROLLER_PPI\r
   @param  PortNumber            Root hub port to set.\r
   @param  PeiServices           The pointer of EFI_PEI_SERVICES\r
   @param  This                  The pointer of PEI_USB_HOST_CONTROLLER_PPI\r
   @param  PortNumber            Root hub port to set.\r


@@ -908,7 +908,7 @@ UhcSetRootHubPortFeature (
 \r
 /**\r
   Clears a feature for the specified root hub port.\r
 \r
 /**\r
   Clears a feature for the specified root hub port.\r

-  \r
+\r

   @param  PeiServices           The pointer of EFI_PEI_SERVICES.\r
   @param  This                  The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  PortNumber            Specifies the root hub port whose feature\r
   @param  PeiServices           The pointer of EFI_PEI_SERVICES.\r
   @param  This                  The pointer of PEI_USB_HOST_CONTROLLER_PPI.\r
   @param  PortNumber            Specifies the root hub port whose feature\r


@@ -916,7 +916,7 @@ UhcSetRootHubPortFeature (
   @param  PortFeature           Indicates the feature selector associated with the\r
                                 feature clear request.\r
 \r
   @param  PortFeature           Indicates the feature selector associated with the\r
                                 feature clear request.\r
 \r

-  @retval EFI_SUCCESS            The feature specified by PortFeature was cleared \r
+  @retval EFI_SUCCESS            The feature specified by PortFeature was cleared\r

                                  for the USB root hub port specified by PortNumber.\r
   @retval EFI_INVALID_PARAMETER  PortNumber is invalid or PortFeature is invalid.\r
 \r
                                  for the USB root hub port specified by PortNumber.\r
   @retval EFI_INVALID_PARAMETER  PortNumber is invalid or PortFeature is invalid.\r
 \r


@@ -1131,7 +1131,7 @@ CreateFrameList (
   ASSERT (UhcDev->BulkQH != NULL);\r
 \r
   //\r
   ASSERT (UhcDev->BulkQH != NULL);\r
 \r
   //\r

-  //Set the corresponding QH pointer \r
+  //Set the corresponding QH pointer\r

   //\r
   SetQHHorizontalLinkPtr(UhcDev->ConfigQH, UhcDev->BulkQH);\r
   SetQHHorizontalQHorTDSelect (UhcDev->ConfigQH, TRUE);\r
   //\r
   SetQHHorizontalLinkPtr(UhcDev->ConfigQH, UhcDev->BulkQH);\r
   SetQHHorizontalQHorTDSelect (UhcDev->ConfigQH, TRUE);\r


@@ -1154,7 +1154,7 @@ CreateFrameList (
 \r
 /**\r
   Read a 16bit width data from Uhc HC IO space register.\r
 \r
 /**\r
   Read a 16bit width data from Uhc HC IO space register.\r

-  \r
+\r

   @param  UhcDev  The UHCI device.\r
   @param  Port    The IO space address of the register.\r
 \r
   @param  UhcDev  The UHCI device.\r
   @param  Port    The IO space address of the register.\r
 \r


@@ -1172,7 +1172,7 @@ USBReadPortW (
 \r
 /**\r
   Write a 16bit width data into Uhc HC IO space register.\r
 \r
 /**\r
   Write a 16bit width data into Uhc HC IO space register.\r

-  \r
+\r

   @param  UhcDev  The UHCI device.\r
   @param  Port    The IO space address of the register.\r
   @param  Data    The data written into the register.\r
   @param  UhcDev  The UHCI device.\r
   @param  Port    The IO space address of the register.\r
   @param  Data    The data written into the register.\r


@@ -1190,7 +1190,7 @@ USBWritePortW (
 \r
 /**\r
   Write a 32bit width data into Uhc HC IO space register.\r
 \r
 /**\r
   Write a 32bit width data into Uhc HC IO space register.\r

-  \r
+\r

   @param  UhcDev  The UHCI device.\r
   @param  Port    The IO space address of the register.\r
   @param  Data    The data written into the register.\r
   @param  UhcDev  The UHCI device.\r
   @param  Port    The IO space address of the register.\r
   @param  Data    The data written into the register.\r


@@ -1208,7 +1208,7 @@ USBWritePortDW (
 \r
 /**\r
   Clear the content of UHCI's Status Register.\r
 \r
 /**\r
   Clear the content of UHCI's Status Register.\r

-  \r
+\r

   @param  UhcDev       The UHCI device.\r
   @param  StatusAddr   The IO space address of the register.\r
 \r
   @param  UhcDev       The UHCI device.\r
   @param  StatusAddr   The IO space address of the register.\r
 \r