AmlDbgPrint.c File Reference

#include <AmlNodeDefines.h>
#include <AmlDbgPrint/AmlDbgPrint.h>
#include <AmlCoreInterface.h>
#include <String/AmlString.h>
#include <Tree/AmlNode.h>
#include <Tree/AmlTreeTraversal.h>

Go to the source code of this file.

Functions
VOID EFIAPI	AmlDbgPrintChars (IN UINT32 ErrorLevel, IN CONST CHAR8 *Buffer, IN UINT32 Size)
VOID EFIAPI	AmlDbgPrintNameSeg (IN CONST CHAR8 *Buffer)
VOID EFIAPI	AmlDbgPrintNameString (IN CONST CHAR8 *Buffer, IN BOOLEAN NewLine)
STATIC VOID EFIAPI	AmlDbgPrintNodeHeader (IN AML_NODE_HEADER *Node, IN UINT8 Level)
STATIC VOID EFIAPI	AmlDbgPrintDataNode (IN AML_DATA_NODE *DataNode, IN UINT8 Level)
STATIC VOID EFIAPI	AmlDbgPrintObjectNode (IN AML_OBJECT_NODE *ObjectNode, IN UINT8 Level)
STATIC VOID EFIAPI	AmlDbgPrintRootNode (IN AML_ROOT_NODE *RootNode, IN UINT8 Level)
STATIC VOID EFIAPI	AmlDbgPrintTableHeader (VOID)
STATIC VOID EFIAPI	AmlDbgPrintTreeInternal (IN AML_NODE_HEADER *Node, IN BOOLEAN Recurse, IN UINT8 Level)
VOID EFIAPI	AmlDbgPrintNode (IN AML_NODE_HEADER *Node)
VOID EFIAPI	AmlDbgPrintTree (IN AML_NODE_HEADER *Node)
VOID EFIAPI	AmlDbgDumpRaw (IN CONST UINT8 *Ptr, IN UINT32 Length)

Variables
CONST CHAR8 *	NodeDataTypeStrTbl []
CONST CHAR8 *	NodeTypeStrTbl []

Detailed Description

AML Print Function.

Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.
Copyright (c) 2019 - 2021, Arm Limited. All rights reserved.

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file AmlDbgPrint.c.

Function Documentation

AmlDbgDumpRaw()

VOID EFIAPI AmlDbgDumpRaw	(	IN CONST UINT8 *	Ptr,
		IN UINT32	Length
	)

This function performs a raw data dump of the ACPI table.

Parameters

[in]	Ptr	Pointer to the start of the table buffer.
[in]	Length	The length of the buffer.

Definition at line 506 of file AmlDbgPrint.c.

AmlDbgPrintDataNode()

STATIC VOID EFIAPI AmlDbgPrintDataNode	(	IN AML_DATA_NODE *	DataNode,
		IN UINT8	Level
	)

Print fields of a data node.

Parameters

[in]	DataNode	Pointer to a data node.
[in]	Level	Level of the indentation.

Definition at line 222 of file AmlDbgPrint.c.

AmlDbgPrintNameSeg()

VOID EFIAPI AmlDbgPrintNameSeg

(

IN CONST CHAR8 *

Buffer

)

Print an AML NameSeg. Don't print trailing underscores ('_').

Parameters

[in]

Buffer

Buffer containing an AML NameSeg.

Definition at line 81 of file AmlDbgPrint.c.

AmlDbgPrintNameString()

VOID EFIAPI AmlDbgPrintNameString	(	IN CONST CHAR8 *	Buffer,
		IN BOOLEAN	NewLine
	)

Print an AML NameString.

Parameters

[in]	Buffer	Buffer containing an AML NameString.
[in]	NewLine	Print a newline char at the end of the NameString.

Definition at line 121 of file AmlDbgPrint.c.

AmlDbgPrintNode()

VOID EFIAPI AmlDbgPrintNode

(

IN AML_NODE_HEADER *

Node

)

Print Node information.

Parameters

[in]

Node

Pointer to the Node to print. Can be a root/object/data node.

Definition at line 476 of file AmlDbgPrint.c.

AmlDbgPrintNodeHeader()

STATIC VOID EFIAPI AmlDbgPrintNodeHeader	(	IN AML_NODE_HEADER *	Node,
		IN UINT8	Level
	)

Print the information contained in the header of the Node.

Parameters

[in]	Node	Pointer to a node.
[in]	Level	Level of the indentation.

Definition at line 196 of file AmlDbgPrint.c.

AmlDbgPrintObjectNode()

STATIC VOID EFIAPI AmlDbgPrintObjectNode	(	IN AML_OBJECT_NODE *	ObjectNode,
		IN UINT8	Level
	)

Print fields of an object node.

Parameters

[in]	ObjectNode	Pointer to an object node.
[in]	Level	Level of the indentation.

Definition at line 293 of file AmlDbgPrint.c.

AmlDbgPrintRootNode()

STATIC VOID EFIAPI AmlDbgPrintRootNode	(	IN AML_ROOT_NODE *	RootNode,
		IN UINT8	Level
	)

Print fields of a root node.

Parameters

[in]	RootNode	Pointer to a root node.
[in]	Level	Level of the indentation.

Definition at line 351 of file AmlDbgPrint.c.

AmlDbgPrintTableHeader()

STATIC VOID EFIAPI AmlDbgPrintTableHeader

(

VOID

)

Print a header to help interpreting node information.

Definition at line 389 of file AmlDbgPrint.c.

AmlDbgPrintTree()

VOID EFIAPI AmlDbgPrintTree

(

IN AML_NODE_HEADER *

Node

)

Recursively print the subtree under the Node.

Parameters

[in]

Node

Pointer to the root of the subtree to print. Can be a root/object/data node.

Definition at line 491 of file AmlDbgPrint.c.

AmlDbgPrintTreeInternal()

STATIC VOID EFIAPI AmlDbgPrintTreeInternal	(	IN AML_NODE_HEADER *	Node,
		IN BOOLEAN	Recurse,
		IN UINT8	Level
	)

Recursively print the subtree under the Node. This is an internal function.

Parameters

[in]	Node	Pointer to the root of the subtree to print. Can be a root/object/data node.
[in]	Recurse	If TRUE, recurse.
[in]	Level	Level in the tree.

Definition at line 430 of file AmlDbgPrint.c.

Variable Documentation

NodeDataTypeStrTbl

CONST CHAR8* NodeDataTypeStrTbl[]

Initial value:

= {
  "EAmlNodeDataTypeNone",
  "EAmlNodeDataTypeReserved1",
  "EAmlNodeDataTypeReserved2",
  "EAmlNodeDataTypeReserved3",
  "EAmlNodeDataTypeReserved4",
  "EAmlNodeDataTypeReserved5",
  "EAmlNodeDataTypeNameString",
  "EAmlNodeDataTypeString",
  "EAmlNodeDataTypeUInt",
  "EAmlNodeDataTypeRaw",
  "EAmlNodeDataTypeResourceData",
  "EAmlNodeDataTypeFieldPkgLen",
  "EAmlNodeDataTypeMax"
}

String table representing AML Data types as defined by EAML_NODE_DATA_TYPE.

Definition at line 22 of file AmlDbgPrint.c.

NodeTypeStrTbl

CONST CHAR8* NodeTypeStrTbl[]

Initial value:

= {
  "EAmlNodeUnknown",
  "EAmlNodeRoot",
  "EAmlNodeObject",
  "EAmlNodeData",
  "EAmlNodeMax"
}

String table representing AML Node types as defined by EAML_NODE_TYPE.

Definition at line 40 of file AmlDbgPrint.c.