From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=217.140.106.54; helo=cam-smtp0.cambridge.arm.com; envelope-from=sami.mujawar@arm.com; receiver=edk2-devel@lists.01.org Received: from cam-smtp0.cambridge.arm.com (unknown [217.140.106.54]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id DAA562118F796 for ; Fri, 21 Dec 2018 08:58:40 -0800 (PST) Received: from E107187.Arm.com (e107187.arm.com [10.1.195.55]) by cam-smtp0.cambridge.arm.com (8.13.8/8.13.8) with ESMTP id wBLGvOUV018491; Fri, 21 Dec 2018 16:58:37 GMT From: Sami Mujawar To: edk2-devel@lists.01.org Cc: alexei.fedorov@arm.com, leif.lindholm@linaro.org, Matteo.Carlini@arm.com, Stephanie.Hughes-Fitt@arm.com, nd@arm.com Date: Fri, 21 Dec 2018 16:57:00 +0000 Message-Id: <20181221165719.49480-4-sami.mujawar@arm.com> X-Mailer: git-send-email 2.11.0.windows.3 In-Reply-To: <20181221165719.49480-1-sami.mujawar@arm.com> References: <20181221165719.49480-1-sami.mujawar@arm.com> Subject: [PATCH v1 03/22] DynamicTablesPkg: Acpi Table Generator X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 X-List-Received-Date: Fri, 21 Dec 2018 16:58:41 -0000 This patch introduces the required interfaces and definitions for implementing an ACPI table generator. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Sami Mujawar --- DynamicTablesPkg/Include/AcpiTableGenerator.h | 357 ++++++++++++++++++++ 1 file changed, 357 insertions(+) diff --git a/DynamicTablesPkg/Include/AcpiTableGenerator.h b/DynamicTablesPkg/Include/AcpiTableGenerator.h new file mode 100644 index 0000000000000000000000000000000000000000..ad4d0732197f25bf43f3fb3cdf0cc9321e9d2030 --- /dev/null +++ b/DynamicTablesPkg/Include/AcpiTableGenerator.h @@ -0,0 +1,357 @@ +/** @file + + Copyright (c) 2017 - 2018, ARM Limited. All rights reserved. + + This program and the accompanying materials + are licensed and made available under the terms and conditions of the BSD License + which accompanies this distribution. The full text of the license may be found at + http://opensource.org/licenses/bsd-license.php + + THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, + WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + + @par Glossary: + - Cm or CM - Configuration Manager + - Obj or OBJ - Object + - Std or STD - Standard +**/ + +#ifndef ACPI_TABLE_GENERATOR_H_ +#define ACPI_TABLE_GENERATOR_H_ + +#include + +// Module specific include files. +#include + +#pragma pack(1) + +/** +The Dynamic Tables Framework provisions two classes of ACPI table +generators. + - Standard generators: The ACPI table generators implemented by the + Dynamic Tables Framework. + - OEM generators: The ACPI table generators customized by the OEM. + +The Dynamic Tables Framework implements the following ACPI table generators: + - RAW : This is the simplest ACPI table generator. It simply installs + the ACPI table provided in the AcpiTableData member of the + CM_STD_OBJ_ACPI_TABLE_INFO. The ACPI table data is provided by + the Configuration Manager and is generated using an implementation + defined mechanism. + - DSDT : The DSDT generator is a clone of the RAW generator. The difference + is in the way the ACPI Table Data is generated from an AML file. + - SSDT : The SSDT generator is a clone of the RAW generator. The difference + is in the way the ACPI Table Data is generated from an AML file. + - FADT : The FADT generator collates the required platform information from + the Configuration Manager and builds the FADT table. + - MADT : The MADT generator collates the GIC information from the + Configuration Manager and builds the MADT table. + - GTDT : The GTDT generator collates the Timer information from the + Configuration Manager and builds the GTDT table. + - DBG2 : The DBG2 generator collates the debug serial port information from + the Configuration Manager and builds the DBG2 table. + - SPCR : The SPCR generator collates the serial port information from the + Configuration Manager and builds the SPCR table. + - MCFG : The MCFG generator collates the PCI configuration space information + from the Configuration Manager and builds the MCFG table. + - IORT : The IORT generator collates the IO Topology information from the + Configuration Manager and builds the IORT table. +*/ + +/** The ACPI_TABLE_GENERATOR_ID type describes ACPI table generator ID. +*/ +typedef TABLE_GENERATOR_ID ACPI_TABLE_GENERATOR_ID; + +/** The ESTD_ACPI_TABLE_ID enum describes the ACPI table IDs reserved for + the standard generators. +*/ +typedef enum StdAcpiTableId { + ESTD_ACPI_TABLE_ID_RESERVED = 0x0000, ///< Reserved + ESTD_ACPI_TABLE_ID_RAW, ///< RAW Generator + ESTD_ACPI_TABLE_ID_DSDT = ESTD_ACPI_TABLE_ID_RAW, ///< DSDT Generator + ESTD_ACPI_TABLE_ID_SSDT = ESTD_ACPI_TABLE_ID_RAW, ///< SSDT Generator + ESTD_ACPI_TABLE_ID_FADT, ///< FADT Generator + ESTD_ACPI_TABLE_ID_MADT, ///< MADT Generator + ESTD_ACPI_TABLE_ID_GTDT, ///< GTDT Generator + ESTD_ACPI_TABLE_ID_DBG2, ///< DBG2 Generator + ESTD_ACPI_TABLE_ID_SPCR, ///< SPCR Generator + ESTD_ACPI_TABLE_ID_MCFG, ///< MCFG Generator + ESTD_ACPI_TABLE_ID_IORT, ///< IORT Generator + ESTD_ACPI_TABLE_ID_MAX +} ESTD_ACPI_TABLE_ID; + +/** This macro checks if the Table Generator ID is for an ACPI Table Generator. + + @param [in] TableGeneratorId The table generator ID. + + @return TRUE if the table generator ID is for an ACPI Table + Generator. +**/ +#define IS_GENERATOR_TYPE_ACPI(TableGeneratorId) \ + (GET_TABLE_TYPE (TableGeneratorId) == ETableGeneratorTypeAcpi) + +/** This macro checks if the Table Generator ID is for a standard ACPI + Table Generator. + + @param [in] TableGeneratorId The table generator ID. + + @return TRUE if the table generator ID is for a standard ACPI + Table Generator. +**/ +#define IS_VALID_STD_ACPI_GENERATOR_ID(TableGeneratorId) \ + ( \ + IS_GENERATOR_NAMESPACE_STD (TableGeneratorId) && \ + IS_GENERATOR_TYPE_ACPI (TableGeneratorId) && \ + ((GET_TABLE_ID (GeneratorId) >= ESTD_ACPI_TABLE_ID_RAW) && \ + (GET_TABLE_ID (GeneratorId) < ESTD_ACPI_TABLE_ID_MAX)) \ + ) + +/** This macro creates a standard ACPI Table Generator ID. + + @param [in] TableId The table generator ID. + + @return a standard ACPI table generator ID. +**/ +#define CREATE_STD_ACPI_TABLE_GEN_ID(TableId) \ + CREATE_TABLE_GEN_ID ( \ + ETableGeneratorTypeAcpi, \ + ETableGeneratorNameSpaceStd, \ + TableId \ + ) + +/** This macro creates an OEM ACPI Table Generator ID. + + @param [in] TableId The table generator ID. + + @return an OEM ACPI table generator ID. +**/ +#define CREATE_OEM_ACPI_TABLE_GEN_ID(TableId) \ + CREATE_TABLE_GEN_ID ( \ + ETableGeneratorTypeAcpi, \ + ETableGeneratorNameSpaceOem, \ + TableId \ + ) + +/** The Creator ID for the ACPI tables generated using + the standard ACPI table generators. +*/ +#define TABLE_GENERATOR_CREATOR_ID_ARM SIGNATURE_32('A', 'R', 'M', 'H') + +/** A macro to initialise the common header part of EFI ACPI tables as + defined by the EFI_ACPI_DESCRIPTION_HEADER structure. + + @param [in] Signature The ACPI table signature. + @param [in] Type The ACPI table structure. + @param [in] Revision The ACPI table revision. +**/ +#define ACPI_HEADER(Signature, Type, Revision) { \ + Signature, /* UINT32 Signature */ \ + sizeof (Type), /* UINT32 Length */ \ + Revision, /* UINT8 Revision */ \ + 0, /* UINT8 Checksum */ \ + { 0, 0, 0, 0, 0, 0 }, /* UINT8 OemId[6] */ \ + 0, /* UINT64 OemTableId */ \ + 0, /* UINT32 OemRevision */ \ + 0, /* UINT32 CreatorId */ \ + 0 /* UINT32 CreatorRevision */\ + } + +/** A macro to dump the common header part of EFI ACPI tables as + defined by the EFI_ACPI_DESCRIPTION_HEADER structure. + + @param [in] AcpiHeader The pointer to the ACPI table header. +**/ +#define DUMP_ACPI_TABLE_HEADER(AcpiHeader) \ + DEBUG (( \ + DEBUG_INFO, \ + "ACPI TABLE %c%c%c%c : Rev 0x%x : Length : 0x%x\n", \ + (AcpiHeader->Signature & 0xFF), \ + ((AcpiHeader->Signature >> 8) & 0xFF), \ + ((AcpiHeader->Signature >> 16) & 0xFF), \ + ((AcpiHeader->Signature >> 24) & 0xFF), \ + AcpiHeader->Revision, \ + AcpiHeader->Length \ + )); + +/** Forward declarations. +*/ +typedef struct ConfigurationManagerProtocol EDKII_CONFIGURATION_MANAGER_PROTOCOL; +typedef struct CmAStdObjAcpiTableInfo CM_STD_OBJ_ACPI_TABLE_INFO; +typedef struct AcpiTableGenerator ACPI_TABLE_GENERATOR; + +/** This function pointer describes the interface to ACPI table build + functions provided by the ACPI table generator and called by the + Table Manager to build an ACPI table. + + @param [in] This Pointer to the ACPI table generator. + @param [in] AcpiTableInfo Pointer to the ACPI table information. + @param [in] CfgMgrProtocol Pointer to the Configuration Manager + Protocol interface. + @param [out] Table Pointer to the generated ACPI table. + + @return EFI_SUCCESS If the table is generated successfully or other + failure codes as returned by the generator. +**/ +typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_BUILD_TABLE) ( + IN CONST ACPI_TABLE_GENERATOR * This, + IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo, + IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol, + OUT EFI_ACPI_DESCRIPTION_HEADER ** Table + ); + +/** This function pointer describes the interface used by the + Table Manager to give the generator an opportunity to free + any resources allocated for building the ACPI table. + + @param [in] This Pointer to the ACPI table generator. + @param [in] AcpiTableInfo Pointer to the ACPI Table Info. + @param [in] CfgMgrProtocol Pointer to the Configuration Manager + Protocol Interface. + @param [in, out] Table Pointer to the ACPI Table. + + @return EFI_SUCCESS If freed successfully or other failure codes + as returned by the generator. +**/ +typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_FREE_TABLE) ( + IN CONST ACPI_TABLE_GENERATOR * CONST This, + IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo, + IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol, + IN OUT EFI_ACPI_DESCRIPTION_HEADER ** CONST Table + ); + +/** This function pointer describes an extended interface to build + ACPI Tables. The ACPI table generator can generate multiple + ACPI Tables and return a pointer to the list of ACPI tables. + The FreeTableResourcesEx() must be called to free any resources + that may have been allocated using this interface. + + @param [in] This Pointer to the ACPI table generator. + @param [in] AcpiTableInfo Pointer to the ACPI table information. + @param [in] CfgMgrProtocol Pointer to the Configuration Manager + Protocol interface. + @param [out] Table Pointer to a list of generated ACPI table(s). + @param [out] TableCount Number of generated ACPI table(s). + + @return EFI_SUCCESS If the table is generated successfully or other + failure codes as returned by the generator. +**/ +typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_BUILD_TABLEEX) ( + IN CONST ACPI_TABLE_GENERATOR * This, + IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo, + IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol, + OUT EFI_ACPI_DESCRIPTION_HEADER *** Table, + OUT UINTN * CONST TableCount + ); + +/** This function pointer describes an extended interface used by the + Table Manager to give the generator an opportunity to free + any resources allocated for building the ACPI table. This interface + must be used in conjunction with the BuildAcpiTableEx interface. + + @param [in] This Pointer to the ACPI table generator. + @param [in] AcpiTableInfo Pointer to the ACPI Table Info. + @param [in] CfgMgrProtocol Pointer to the Configuration Manager + Protocol Interface. + @param [in, out] Table Pointer to the list of ACPI Table(s). + @param [in] TableCount Number of ACPI table(s). + + @return EFI_SUCCESS If freed successfully or other failure codes + as returned by the generator. +**/ +typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_FREE_TABLEEX) ( + IN CONST ACPI_TABLE_GENERATOR * CONST This, + IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo, + IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol, + IN OUT EFI_ACPI_DESCRIPTION_HEADER *** CONST Table, + IN CONST UINTN TableCount + ); + +/** The ACPI_TABLE_GENERATOR structure provides an interface that the + Table Manager can use to invoke the functions to build ACPI tables. + + Note: Although the Generator is required to implement at least + one pair of interfaces (BuildAcpiTable & FreeTableResources or + BuildAcpiTableEx & FreeTableResourcesEx) for generating the ACPI + table(s), if both pair of interfaces are implemented the extended + version will take precedence. +**/ +typedef struct AcpiTableGenerator { + /// The ACPI table generator ID. + ACPI_TABLE_GENERATOR_ID GeneratorID; + + /// String describing the ACPI table generator. + CONST CHAR16 * Description; + + /// The ACPI table signature. + UINT32 AcpiTableSignature; + + /// The ACPI table revision. + UINT32 AcpiTableRevision; + + /// The ACPI table creator ID. + UINT32 CreatorId; + + /// The ACPI table creator revision. + UINT32 CreatorRevision; + + /// ACPI table build function pointer. + ACPI_TABLE_GENERATOR_BUILD_TABLE BuildAcpiTable; + + /** The function to free any resources + allocated for building the ACPI table. + */ + ACPI_TABLE_GENERATOR_FREE_TABLE FreeTableResources; + + /// ACPI table extended build function pointer. + ACPI_TABLE_GENERATOR_BUILD_TABLEEX BuildAcpiTableEx; + + /** The function to free any resources + allocated for building the ACPI table + using the extended interface. + */ + ACPI_TABLE_GENERATOR_FREE_TABLEEX FreeTableResourcesEx; +} ACPI_TABLE_GENERATOR; + +/** Register ACPI table factory generator. + + The ACPI table factory maintains a list of the Standard and OEM ACPI + table generators. + + @param [in] Generator Pointer to the ACPI table generator. + + @retval EFI_SUCCESS The Generator was registered + successfully. + @retval EFI_INVALID_PARAMETER The Generator ID is invalid or + the Generator pointer is NULL. + @retval EFI_ALREADY_STARTED The Generator for the Table ID is + already registered. +**/ +EFI_STATUS +EFIAPI +RegisterAcpiTableGenerator ( + IN CONST ACPI_TABLE_GENERATOR * CONST Generator + ); + +/** Deregister ACPI generator. + + This function is called by the ACPI table generator to deregister itself + from the ACPI table factory. + + @param [in] Generator Pointer to the ACPI table generator. + + @retval EFI_SUCCESS Success. + @retval EFI_INVALID_PARAMETER The generator is invalid. + @retval EFI_NOT_FOUND The requested generator is not found + in the list of registered generators. +**/ +EFI_STATUS +EFIAPI +DeregisterAcpiTableGenerator ( + IN CONST ACPI_TABLE_GENERATOR * CONST Generator + ); + +#pragma pack() + +#endif // ACPI_TABLE_GENERATOR_H_ + -- 'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)'