audk/DynamicTablesPkg/Library/Common/AmlLib
Pierre Gondois 095db69d4c DynamicTablesPkg: Dynamic AML: Add AmlLib library
ACPI Definition blocks are implemented using AML which has
a complex grammar making run-time generation of definition
blocks difficult. Dynamic AML is a feature of Dynamic Tables
framework that provides a solution for dynamic generation of
ACPI Definition block tables.

Since, AML bytecode represents complex AML grammar, an AmlLib
library is introduced to assist parsing and traversing of the
AML bytecode at run-time.

The AmlLib library parses a definition block and represents it
as an AML tree. The AML objects, methods and data are represented
as tree nodes. Since the AML data is represented as tree nodes,
it is possible to traverse the tree, locate a node and modify the
node data. The tree can then be serialized to a buffer (that
represents the definition block). This definition block containing
the fixed-up AML code can then be installed as an ACPI Definition
Block table.

Dynamic AML introduces the following techniques:
* AML Fixup
* AML Codegen
* AML Fixup + Codegen

AML Fixup is a technique that involves compiling an ASL template
file to generate AML bytecode. This template AML bytecode can be
parsed at run-time and a fixup code can update the required fields
in the AML template.

AML Codegen employs generating small segments of AML code.

AmlLib provides a rich set of APIs to operate on AML data for AML
Fixup and Codegen.

Signed-off-by: Pierre Gondois <pierre.gondois@arm.com>
Signed-off-by: Sami Mujawar <sami.mujawar@arm.com>
Reviewed-by: Alexei Fedorov <Alexei.Fedorov@arm.com>
2020-08-13 18:00:06 +00:00
..
AmlDbgPrint DynamicTablesPkg: AML debug logging 2020-08-13 18:00:06 +00:00
AmlEncoding DynamicTablesPkg: AML grammar definition 2020-08-13 18:00:06 +00:00
Api DynamicTablesPkg: AmlLib APIs 2020-08-13 18:00:06 +00:00
CodeGen DynamicTablesPkg: AML Resource Data Codegen 2020-08-13 18:00:06 +00:00
NameSpace DynamicTablesPkg: AML ACPI Namespace interface 2020-08-13 18:00:06 +00:00
Parser DynamicTablesPkg: AML Field list parser 2020-08-13 18:00:06 +00:00
ResourceData DynamicTablesPkg: AML resource data helper 2020-08-13 18:00:06 +00:00
Serialize DynamicTablesPkg: AML serialise interface 2020-08-13 18:00:06 +00:00
Stream DynamicTablesPkg: AML stream interface 2020-08-13 18:00:06 +00:00
String DynamicTablesPkg: AML and ASL string helper 2020-08-13 18:00:06 +00:00
Tree DynamicTablesPkg: AML tree/node cloning 2020-08-13 18:00:06 +00:00
Utils DynamicTablesPkg: AML utility interfaces 2020-08-13 18:00:06 +00:00
AmlCoreInterface.h DynamicTablesPkg: AML Core interface 2020-08-13 18:00:06 +00:00
AmlDefines.h DynamicTablesPkg: AmlLib definitions 2020-08-13 18:00:06 +00:00
AmlInclude.h DynamicTablesPkg: AmlLib definitions 2020-08-13 18:00:06 +00:00
AmlLib.inf DynamicTablesPkg: Dynamic AML: Add AmlLib library 2020-08-13 18:00:06 +00:00
AmlNodeDefines.h DynamicTablesPkg: AML node definitions 2020-08-13 18:00:06 +00:00