DynamicTablesPkg: Apply uncrustify changes

[mirror_edk2.git] / DynamicTablesPkg / Library / Common / AmlLib / AmlDbgPrint / AmlDbgPrint.h

/** @file\r
  AML Debug Print.\r
\r
  Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved. <BR>\r
  Copyright (c) 2019 - 2020, Arm Limited. All rights reserved.<BR>\r
\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
**/\r
\r
#ifndef AML_PRINT_H_\r
#define AML_PRINT_H_\r
\r
/* This header file does not include internal Node definition,\r
   i.e. AML_ROOT_NODE, AML_OBJECT_NODE, etc. The node definitions\r
   must be included by the caller file. The function prototypes must\r
   only expose AML_NODE_HANDLE, AML_ROOT_NODE_HANDLE, etc. node\r
   definitions.\r
   This allows to keep the functions defined here both internal and\r
   potentially external. If necessary, any function of this file can\r
   be exposed externally.\r
   The Api folder is internal to the AmlLib, but should only use these\r
   functions. They provide a "safe" way to interact with the AmlLib.\r
*/\r
\r
#if !defined (MDEPKG_NDEBUG)\r
\r
  #include <AmlInclude.h>\r
\r
/**\r
  @defgroup DbgPrintApis Print APIs for debugging.\r
  @ingroup AMLLib\r
  @{\r
    Print APIs provide a way to print:\r
     - A buffer;\r
     - A (root/object/data) node;\r
     - An AML tree/branch;\r
     - The AML NameSpace from the root node.\r
  @}\r
*/\r
\r
/** This function performs a raw data dump of the ACPI table.\r
\r
  @param  [in]  Ptr     Pointer to the start of the table buffer.\r
  @param  [in]  Length  The length of the buffer.\r
**/\r
VOID\r
EFIAPI\r
AmlDbgDumpRaw (\r
  IN  CONST UINT8   *Ptr,\r
  IN        UINT32  Length\r
  );\r
\r
/** Print Size chars at Buffer address.\r
\r
  @ingroup DbgPrintApis\r
\r
  @param  [in]  ErrorLevel    Error level for the DEBUG macro.\r
  @param  [in]  Buffer        Buffer containing the chars.\r
  @param  [in]  Size          Number of chars to print.\r
**/\r
VOID\r
EFIAPI\r
AmlDbgPrintChars (\r
  IN        UINT32  ErrorLevel,\r
  IN  CONST CHAR8   *Buffer,\r
  IN        UINT32  Size\r
  );\r
\r
/** Print an AML NameSeg.\r
    Don't print trailing underscores ('_').\r
\r
  @param  [in] Buffer   Buffer containing an AML NameSeg.\r
**/\r
VOID\r
EFIAPI\r
AmlDbgPrintNameSeg (\r
  IN  CONST CHAR8  *Buffer\r
  );\r
\r
/** Print an AML NameString.\r
\r
  @param  [in] Buffer   Buffer containing an AML NameString.\r
  @param  [in] NewLine  Print a newline char at the end of the NameString.\r
**/\r
VOID\r
EFIAPI\r
AmlDbgPrintNameString (\r
  IN  CONST CHAR8    *Buffer,\r
  IN        BOOLEAN  NewLine\r
  );\r
\r
/** Print Node information.\r
\r
  @ingroup DbgPrintApis\r
\r
  @param  [in]  Node    Pointer to the Node to print.\r
                        Can be a root/object/data node.\r
**/\r
VOID\r
EFIAPI\r
AmlDbgPrintNode (\r
  IN  AML_NODE_HANDLE  Node\r
  );\r
\r
/** Recursively print the subtree under the Node.\r
\r
  @ingroup DbgPrintApis\r
\r
  @param  [in]  Node    Pointer to the root of the subtree to print.\r
                        Can be a root/object/data node.\r
**/\r
VOID\r
EFIAPI\r
AmlDbgPrintTree (\r
  IN  AML_NODE_HANDLE  Node\r
  );\r
\r
/** Print the absolute pathnames in the AML namespace of\r
    all the nodes in the tree starting from the Root node.\r
\r
  @ingroup DbgPrintApis\r
\r
  @param  [in]  RootNode    Pointer to a root node.\r
\r
  @retval EFI_SUCCESS             The function completed successfully.\r
  @retval EFI_BUFFER_TOO_SMALL    No space left in the buffer.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Out of memory.\r
**/\r
EFI_STATUS\r
EFIAPI\r
AmlDbgPrintNameSpace (\r
  IN  AML_ROOT_NODE_HANDLE  RootNode\r
  );\r
\r
/* Macros to encapsulate Aml Debug Print APIs.\r
*/\r
\r
#define AMLDBG_DUMP_RAW(Ptr, Length)                  \\r
          AmlDbgDumpRaw (Ptr, Length)\r
\r
#define AMLDBG_PRINT_CHARS(ErrorLevel, Buffer, Size)  \\r
          AmlDbgPrintChars (ErrorLevel, Buffer, Size)\r
\r
#define AMLDBG_PRINT_NAMESEG(Buffer)                  \\r
          AmlDbgPrintNameSeg (Buffer)\r
\r
#define AMLDBG_PRINT_NAMESTR(Buffer, NewLine)          \\r
          AmlDbgPrintNameString (Buffer,NewLine)\r
\r
#define AMLDBG_PRINT_NODE(Node)                       \\r
          AmlDbgPrintNode (Node)\r
\r
#define AMLDBG_PRINT_TREE(Node)                       \\r
          AmlDbgPrintTree (Node)\r
\r
#define AMLDBG_PRINT_NAMESPACE(RootNode)              \\r
          AmlDbgPrintNameSpace (RootNode)\r
\r
#else\r
\r
#define AMLDBG_DUMP_RAW(Ptr, Length)\r
\r
#define AMLDBG_PRINT_CHARS(ErrorLevel, Buffer, Size)\r
\r
#define AMLDBG_PRINT_NAMESEG(Buffer)\r
\r
#define AMLDBG_PRINT_NAMESTR(Buffer, NewLine)\r
\r
#define AMLDBG_PRINT_NODE(Node)\r
\r
#define AMLDBG_PRINT_TREE(Node)\r
\r
#define AMLDBG_PRINT_NAMESPACE(RootNode)\r
\r
#endif // MDEPKG_NDEBUG\r
\r
#endif // AML_PRINT_H_\r