4 Copyright (c) 2016 - 2019, ARM Limited. All rights reserved.
5 SPDX-License-Identifier: BSD-2-Clause-Patent
9 #include <IndustryStandard/Acpi.h>
10 #include <Library/UefiLib.h>
11 #include "AcpiParser.h"
12 #include "AcpiTableParser.h"
16 A list of registered ACPI table parsers.
18 STATIC ACPI_TABLE_PARSER mTableParserList
[MAX_ACPI_TABLE_PARSERS
];
21 Register the ACPI table Parser
23 This function registers the ACPI table parser.
25 @param [in] Signature The ACPI table signature.
26 @param [in] ParserProc The ACPI table parser.
28 @retval EFI_SUCCESS The parser is registered.
29 @retval EFI_INVALID_PARAMETER A parameter is invalid.
30 @retval EFI_ALREADY_STARTED The parser for the Table
31 was already registered.
32 @retval EFI_OUT_OF_RESOURCES No space to register the
39 IN PARSE_ACPI_TABLE_PROC ParserProc
44 if ((ParserProc
== NULL
) || (Signature
== ACPI_PARSER_SIGNATURE_NULL
)) {
45 return EFI_INVALID_PARAMETER
;
48 // Search if a parser is already installed
50 Index
< (sizeof (mTableParserList
) / sizeof (mTableParserList
[0]));
53 if (Signature
== mTableParserList
[Index
].Signature
) {
54 if (mTableParserList
[Index
].Parser
!= NULL
) {
55 return EFI_ALREADY_STARTED
;
60 // Find the first free slot and register the parser
62 Index
< (sizeof (mTableParserList
) / sizeof (mTableParserList
[0]));
65 if (mTableParserList
[Index
].Signature
== ACPI_PARSER_SIGNATURE_NULL
) {
66 mTableParserList
[Index
].Signature
= Signature
;
67 mTableParserList
[Index
].Parser
= ParserProc
;
73 return EFI_OUT_OF_RESOURCES
;
77 Deregister the ACPI table Parser
79 This function deregisters the ACPI table parser.
81 @param [in] Signature The ACPI table signature.
83 @retval EFI_SUCCESS The parser was deregistered.
84 @retval EFI_INVALID_PARAMETER A parameter is invalid.
85 @retval EFI_NOT_FOUND A registered parser was not found.
95 if (Signature
== ACPI_PARSER_SIGNATURE_NULL
) {
96 return EFI_INVALID_PARAMETER
;
100 Index
< (sizeof (mTableParserList
) / sizeof (mTableParserList
[0]));
103 if (Signature
== mTableParserList
[Index
].Signature
) {
104 mTableParserList
[Index
].Signature
= ACPI_PARSER_SIGNATURE_NULL
;
105 mTableParserList
[Index
].Parser
= NULL
;
110 // No matching registered parser found.
111 return EFI_NOT_FOUND
;
115 Get the ACPI table Parser
117 This function returns the ACPI table parser proc from the list of
120 @param [in] Signature The ACPI table signature.
121 @param [out] ParserProc Pointer to a ACPI table parser proc.
123 @retval EFI_SUCCESS The parser was returned successfully.
124 @retval EFI_INVALID_PARAMETER A parameter is invalid.
125 @retval EFI_NOT_FOUND A registered parser was not found.
131 OUT PARSE_ACPI_TABLE_PROC
* ParserProc
136 if ((ParserProc
== NULL
) || (Signature
== ACPI_PARSER_SIGNATURE_NULL
)) {
137 return EFI_INVALID_PARAMETER
;
141 Index
< (sizeof (mTableParserList
) / sizeof (mTableParserList
[0]));
144 if (Signature
== mTableParserList
[Index
].Signature
) {
145 *ParserProc
= mTableParserList
[Index
].Parser
;
150 // No matching registered parser found.
151 return EFI_NOT_FOUND
;
155 This function processes the ACPI tables.
156 This function calls ProcessTableReportOptions() to list the ACPI
157 tables, perform binary dump of the tables and determine if the
158 ACPI fields should be traced.
160 This function also invokes the parser for the ACPI tables.
162 This function also performs a RAW dump of the ACPI table including
163 the unknown/unparsed ACPI tables and validates the checksum.
165 @param [in] Ptr Pointer to the start of the ACPI
176 CONST UINT32
* AcpiTableSignature
;
177 CONST UINT32
* AcpiTableLength
;
178 CONST UINT8
* AcpiTableRevision
;
179 PARSE_ACPI_TABLE_PROC ParserProc
;
188 Trace
= ProcessTableReportOptions (
195 DumpRaw (Ptr
, *AcpiTableLength
);
196 if (GetConsistencyChecking ()) {
197 VerifyChecksum (TRUE
, Ptr
, *AcpiTableLength
);
201 Status
= GetParser (*AcpiTableSignature
, &ParserProc
);
202 if (EFI_ERROR (Status
)) {
203 // No registered parser found, do default handling.
205 DumpAcpiHeader (Ptr
);