From: Pierre Gondois <pierre.gond...@arm.com>
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.gond...@arm.com>
Signed-off-by: Sami Mujawar <sami.muja...@arm.com>
---
DynamicTablesPkg/DynamicTables.dsc.inc | 1 +
DynamicTablesPkg/DynamicTablesPkg.ci.yaml | 6 +-
DynamicTablesPkg/DynamicTablesPkg.dec | 5 +-
DynamicTablesPkg/DynamicTablesPkg.dsc | 3 +-
DynamicTablesPkg/Library/Common/AmlLib/AmlLib.inf | 76 ++++++++++++++++++++
5 files changed, 88 insertions(+), 3 deletions(-)
diff --git a/DynamicTablesPkg/DynamicTables.dsc.inc
b/DynamicTablesPkg/DynamicTables.dsc.inc
index
bc03c09d6c0ebb2c6b1458d27e0bde00224e55cd..928529f797b49f2f0dd52508a9aad557f568719a
100644
--- a/DynamicTablesPkg/DynamicTables.dsc.inc
+++ b/DynamicTablesPkg/DynamicTables.dsc.inc
@@ -13,6 +13,7 @@ [BuildOptions]
RELEASE_*_*_CC_FLAGS = -DMDEPKG_NDEBUG
[LibraryClasses.common]
+ AmlLib|DynamicTablesPkg/Library/Common/AmlLib/AmlLib.inf
TableHelperLib|DynamicTablesPkg/Library/Common/TableHelperLib/TableHelperLib.inf
[Components.common]
diff --git a/DynamicTablesPkg/DynamicTablesPkg.ci.yaml
b/DynamicTablesPkg/DynamicTablesPkg.ci.yaml
index
f39b8019461ea151f9b1cf4bc751604d6e044af2..5ee20357326f4b79444d63418f56aae0b00508de
100644
--- a/DynamicTablesPkg/DynamicTablesPkg.ci.yaml
+++ b/DynamicTablesPkg/DynamicTablesPkg.ci.yaml
@@ -1,7 +1,7 @@
## @file
# CI configuration for DynamicTablesPkg
#
-# Copyright (c) 2020, ARM Limited. All rights reserved.<BR>
+# Copyright (c) 2020, Arm Limited. All rights reserved.<BR>
# SPDX-License-Identifier: BSD-2-Clause-Patent
##
{
@@ -69,11 +69,15 @@
"IgnoreFiles": [], # use gitignore syntax to ignore errors
# in matching files
"ExtendWords": [
+ "EISAID",
"CCIDX",
"CCSIDR",
"countof",
"EOBJECT",
+ "invoc",
"GTBLOCK",
+ "lgreater",
+ "lless",
"MPIDR",
"pytool",
"Roadmap",
diff --git a/DynamicTablesPkg/DynamicTablesPkg.dec
b/DynamicTablesPkg/DynamicTablesPkg.dec
index
6cb8a0b4f2c91b59e888951fda034bfdc56d95e1..57e6815fa159c5ce8d5cb0c930375e7322bff211
100644
--- a/DynamicTablesPkg/DynamicTablesPkg.dec
+++ b/DynamicTablesPkg/DynamicTablesPkg.dec
@@ -1,7 +1,7 @@
## @file
# dec file for Dynamic Tables Framework.
#
-# Copyright (c) 2017 - 2020, ARM Limited. All rights reserved.<BR>
+# Copyright (c) 2017 - 2020, Arm Limited. All rights reserved.<BR>
#
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
@@ -17,6 +17,9 @@ [Includes]
Include
[LibraryClasses]
+ ## @libraryclass Defines a set of APIs for Dynamic AML generation.
+ AmlLib|Include/Library/AmlLib/AmlLib.h
+
## @libraryclass Defines a set of helper methods.
TableHelperLib|Include/Library/TableHelperLib.h
diff --git a/DynamicTablesPkg/DynamicTablesPkg.dsc
b/DynamicTablesPkg/DynamicTablesPkg.dsc
index
5fb30a9315a75750a7d4c3e802c610a7991111c7..add6b192ad4187e2769b374ef68f93a65a1af8b6
100644
--- a/DynamicTablesPkg/DynamicTablesPkg.dsc
+++ b/DynamicTablesPkg/DynamicTablesPkg.dsc
@@ -2,7 +2,7 @@
# Dsc file for Dynamic Tables Framework.
#
# Copyright (c) 2019, Linaro Limited. All rights reserved.<BR>
-# Copyright (c) 2019 - 2020, ARM Limited. All rights reserved.<BR>
+# Copyright (c) 2019 - 2020, Arm Limited. All rights reserved.<BR>
#
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
@@ -36,6 +36,7 @@ [LibraryClasses.ARM, LibraryClasses.AARCH64]
PL011UartLib|ArmPlatformPkg/Library/PL011UartLib/PL011UartLib.inf
[Components.common]
+ DynamicTablesPkg/Library/Common/AmlLib/AmlLib.inf
DynamicTablesPkg/Library/Common/TableHelperLib/TableHelperLib.inf
[BuildOptions]
diff --git a/DynamicTablesPkg/Library/Common/AmlLib/AmlLib.inf
b/DynamicTablesPkg/Library/Common/AmlLib/AmlLib.inf
new file mode 100644
index
0000000000000000000000000000000000000000..e2babef445d5ed7dbd2f6aefbe26fa39df2b1ada
--- /dev/null
+++ b/DynamicTablesPkg/Library/Common/AmlLib/AmlLib.inf
@@ -0,0 +1,76 @@
+## @file
+# AML Generation Library
+#
+# Copyright (c) 2019 - 2020, Arm Limited. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+##
+
+[Defines]
+ INF_VERSION = 0x0001001B
+ BASE_NAME = DynamicAmlLib
+ FILE_GUID = 23A6AFDA-F2A5-45EC-BEFF-420639D345B9
+ VERSION_STRING = 1.0
+ MODULE_TYPE = DXE_DRIVER
+ LIBRARY_CLASS = AmlLib
+
+[Sources]
+ AmlCoreInterface.h
+ AmlDefines.h
+ AmlInclude.h
+ AmlNodeDefines.h
+ AmlDbgPrint/AmlDbgPrint.c
+ AmlDbgPrint/AmlDbgPrint.h
+ AmlEncoding/Aml.c
+ AmlEncoding/Aml.h
+ Api/AmlApi.c
+ Api/AmlApiHelper.c
+ Api/AmlApiHelper.h
+ Api/AmlResourceDataApi.c
+ CodeGen/AmlCodeGen.c
+ CodeGen/AmlResourceDataCodeGen.c
+ CodeGen/AmlResourceDataCodeGen.h
+ NameSpace/AmlNameSpace.c
+ NameSpace/AmlNameSpace.h
+ Parser/AmlFieldListParser.c
+ Parser/AmlFieldListParser.h
+ Parser/AmlMethodParser.c
+ Parser/AmlMethodParser.h
+ Parser/AmlParser.c
+ Parser/AmlParser.h
+ Parser/AmlResourceDataParser.c
+ Parser/AmlResourceDataParser.h
+ ResourceData/AmlResourceData.c
+ ResourceData/AmlResourceData.h
+ Serialize/AmlSerialize.c
+ Stream/AmlStream.c
+ Stream/AmlStream.h
+ String/AmlString.c
+ String/AmlString.h
+ Tree/AmlClone.c
+ Tree/AmlTreeIterator.h
+ Tree/AmlNode.c
+ Tree/AmlNode.h
+ Tree/AmlNodeInterface.c
+ Tree/AmlTree.c
+ Tree/AmlTree.h
+ Tree/AmlTreeEnumerator.c
+ Tree/AmlTreeIterator.c
+ Tree/AmlTreeTraversal.c
+ Tree/AmlTreeTraversal.h
+ Utils/AmlUtility.c
+ Utils/AmlUtility.h
+
+[Packages]
+ MdePkg/MdePkg.dec
+ DynamicTablesPkg/DynamicTablesPkg.dec
+
+[LibraryClasses]
+ BaseLib
+
+[BuildOptions]
+ *_*_*_CC_FLAGS = -DAML_HANDLE
+
+[Protocols]
+
+[Guids]
--
'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)'
-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.
View/Reply Online (#64101): https://edk2.groups.io/g/devel/message/64101
Mute This Topic: https://groups.io/mt/76149186/21656
Group Owner: devel+ow...@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [arch...@mail-archive.com]
-=-=-=-=-=-=-=-=-=-=-=-
