MdeModulePkg/Usb: All h/w related stop operation at DriverBindingStop() should be...

[mirror_edk2.git] / MdeModulePkg / Bus / Pci / EhciDxe / EhciDebug.h

diff --git a/MdeModulePkg/Bus/Pci/EhciDxe/EhciDebug.h b/MdeModulePkg/Bus/Pci/EhciDxe/EhciDebug.h
index be4bcd6556789f224988d4fa48ef39f345c17ea1..bc84bb7864f7fb468d33a436a090a34c1614e63a 100644 (file)
--- a/MdeModulePkg/Bus/Pci/EhciDxe/EhciDebug.h
+++ b/MdeModulePkg/Bus/Pci/EhciDxe/EhciDebug.h
@@ -1,7 +1,9 @@
 /** @file\r
 \r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+  This file contains the definination for host controller debug support routines.\r
+\r
+Copyright (c) 2007 - 2009, Intel Corporation. All rights reserved.<BR>\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
@@ -9,151 +11,65 @@ http://opensource.org/licenses/bsd-license.php
 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
-Module Name:\r
-\r
-  EhciDebug.h\r
-\r
-Abstract:\r
-\r
-  This file contains the definination for host controller debug support routines\r
-\r
-Revision History\r
-\r
 **/\r
 \r
 #ifndef _EFI_EHCI_DEBUG_H_\r
 #define _EFI_EHCI_DEBUG_H_\r
 \r
 \r
-enum {\r
-  USB_DEBUG_FORCE_OUTPUT  = (UINTN)(1 << 0),\r
-\r
-  EHC_DEBUG_QH            = (UINTN)(1 << 8),\r
-  EHC_DEBUG_QTD           = (UINTN)(1 << 9),\r
-  EHC_DEBUG_BUF           = (UINTN)(1 << 10),\r
-};\r
-\r
-\r
-/**\r
-  EHCI's debug output function. It determines whether\r
-  to output by the mask and level\r
-\r
-  @param  Level    The output level\r
-  @param  Format   The format parameters to the print\r
-  @param  ...      The variable length parameters after format\r
-\r
-  @return None\r
-\r
-**/\r
-VOID\r
-EhciDebugPrint (\r
-  IN  UINTN               Level,\r
-  IN  CHAR8               *Format,\r
-  ...\r
-  )\r
-;\r
-\r
-\r
-/**\r
-  EHCI's debug output function. It determines whether\r
-  to output by the mask and level\r
-\r
-  @param  Format   The format parameters to the print\r
-  @param  ...      The variable length parameters after format\r
-\r
-  @return None\r
-\r
-**/\r
-VOID\r
-EhcDebug (\r
-  IN  CHAR8               *Format,\r
-  ...\r
-  )\r
-;\r
-\r
-\r
-\r
-/**\r
-  EHCI's error output function. It determines whether\r
-  to output by the mask and level\r
-\r
-  @param  Format   The format parameters to the print\r
-  @param  ...      The variable length parameters after format\r
-\r
-  @return None\r
-\r
-**/\r
-VOID\r
-EhcError (\r
-  IN  CHAR8               *Format,\r
-  ...\r
-  )\r
-;\r
-\r
-\r
-\r
 /**\r
-  Dump the fields of a QTD\r
-\r
-  @param  Qtd      The QTD to dump\r
-  @param  Msg      The message to print before the dump\r
+  Dump the fields of a QTD.\r
 \r
-  @return None\r
+  @param  Qtd      The QTD to dump.\r
+  @param  Msg      The message to print before the dump.\r
 \r
 **/\r
 VOID\r
 EhcDumpQtd (\r
   IN EHC_QTD              *Qtd,\r
-  IN UINT8                *Msg\r
-  )\r
-;\r
-\r
+  IN CHAR8                *Msg\r
+  );\r
 \r
 \r
 /**\r
-  Dump the queue head\r
-\r
-  @param  Qh       The queue head to dump\r
-  @param  Msg      The message to print before the dump\r
-  @param  DumpBuf  Whether to dump the memory buffer of the associated QTD\r
+  Dump the queue head.\r
 \r
-  @return None\r
+  @param  Qh       The queue head to dump.\r
+  @param  Msg      The message to print before the dump.\r
+  @param  DumpBuf  Whether to dump the memory buffer of the associated QTD.\r
 \r
 **/\r
 VOID\r
 EhcDumpQh (\r
   IN EHC_QH               *Qh,\r
-  IN UINT8                *Msg,\r
+  IN CHAR8                *Msg,\r
   IN BOOLEAN              DumpBuf\r
-  )\r
-;\r
-\r
+  );\r
 \r
 \r
 /**\r
-  Dump the buffer in the form of hex\r
+  Dump the buffer in the form of hex.\r
 \r
-  @param  Buf      The buffer to dump\r
-  @param  Len      The length of buffer\r
-\r
-  @return None\r
+  @param  Buf      The buffer to dump.\r
+  @param  Len      The length of buffer.\r
 \r
 **/\r
 VOID\r
 EhcDumpBuf (\r
   IN UINT8                *Buf,\r
   IN UINTN                Len\r
-  )\r
-;\r
-\r
-#ifdef EFI_DEBUG\r
-  #define EHC_DEBUG(arg)                  EhcDebug    arg\r
-  #define EHC_ERROR(arg)                  EhcError    arg\r
-  #define EHC_DUMP_QH(arg)                EhcDumpQh   arg\r
-#else\r
-  #define EHC_DEBUG(arg)\r
-  #define EHC_ERROR(arg)\r
-  #define EHC_DUMP_QH(arg)\r
-#endif\r
+  );\r
+\r
+\r
+/**\r
+  Dump the EHCI status registers.\r
+\r
+  @param  Ehc    USB EHCI Host Controller instance\r
+\r
+**/\r
+VOID\r
+EhcDumpRegs (\r
+  IN  USB2_HC_DEV         *Ehc\r
+  );\r
 \r
 #endif\r