]>
Commit | Line | Data |
---|---|---|
2440e68c SM |
1 | /** @file\r |
2 | \r | |
bade7f42 | 3 | Copyright (c) 2017 - 2020, Arm Limited. All rights reserved.<BR>\r |
2440e68c | 4 | \r |
9cd9bdc6 | 5 | SPDX-License-Identifier: BSD-2-Clause-Patent\r |
2440e68c SM |
6 | \r |
7 | @par Glossary:\r | |
8 | - Cm or CM - Configuration Manager\r | |
9 | - Obj or OBJ - Object\r | |
10 | - Std or STD - Standard\r | |
11 | **/\r | |
12 | \r | |
13 | #ifndef ACPI_TABLE_GENERATOR_H_\r | |
14 | #define ACPI_TABLE_GENERATOR_H_\r | |
15 | \r | |
16 | #include <IndustryStandard/Acpi.h>\r | |
17 | \r | |
18 | // Module specific include files.\r | |
19 | #include <TableGenerator.h>\r | |
20 | \r | |
21 | #pragma pack(1)\r | |
22 | \r | |
23 | /**\r | |
24 | The Dynamic Tables Framework provisions two classes of ACPI table\r | |
25 | generators.\r | |
26 | - Standard generators: The ACPI table generators implemented by the\r | |
27 | Dynamic Tables Framework.\r | |
28 | - OEM generators: The ACPI table generators customized by the OEM.\r | |
29 | \r | |
30 | The Dynamic Tables Framework implements the following ACPI table generators:\r | |
31 | - RAW : This is the simplest ACPI table generator. It simply installs\r | |
32 | the ACPI table provided in the AcpiTableData member of the\r | |
33 | CM_STD_OBJ_ACPI_TABLE_INFO. The ACPI table data is provided by\r | |
34 | the Configuration Manager and is generated using an implementation\r | |
35 | defined mechanism.\r | |
36 | - DSDT : The DSDT generator is a clone of the RAW generator. The difference\r | |
37 | is in the way the ACPI Table Data is generated from an AML file.\r | |
38 | - SSDT : The SSDT generator is a clone of the RAW generator. The difference\r | |
39 | is in the way the ACPI Table Data is generated from an AML file.\r | |
40 | - FADT : The FADT generator collates the required platform information from\r | |
41 | the Configuration Manager and builds the FADT table.\r | |
42 | - MADT : The MADT generator collates the GIC information from the\r | |
43 | Configuration Manager and builds the MADT table.\r | |
44 | - GTDT : The GTDT generator collates the Timer information from the\r | |
45 | Configuration Manager and builds the GTDT table.\r | |
46 | - DBG2 : The DBG2 generator collates the debug serial port information from\r | |
47 | the Configuration Manager and builds the DBG2 table.\r | |
48 | - SPCR : The SPCR generator collates the serial port information from the\r | |
49 | Configuration Manager and builds the SPCR table.\r | |
50 | - MCFG : The MCFG generator collates the PCI configuration space information\r | |
51 | from the Configuration Manager and builds the MCFG table.\r | |
52 | - IORT : The IORT generator collates the IO Topology information from the\r | |
53 | Configuration Manager and builds the IORT table.\r | |
77db1156 KK |
54 | - PPTT : The PPTT generator collates the processor topology information from\r |
55 | the Configuration Manager and builds the PPTT table.\r | |
f413d9be SM |
56 | - SRAT : The SRAT generator collates the system resource affinity information\r |
57 | from the Configuration Manager and builds the SRAT table.\r | |
bade7f42 PG |
58 | - SSDT Serial-Port:\r |
59 | The SSDT Serial generator collates the Serial port information\r | |
60 | from the Configuration Manager and patches the SSDT Serial Port\r | |
61 | template to build the SSDT Serial port table.\r | |
37568365 PG |
62 | - SSDT CMN-600:\r |
63 | The SSDT CMN-600 generator collates the CMN-600 information\r | |
64 | from the Configuration Manager and patches the SSDT CMN-600\r | |
65 | template to build the SSDT CMN-600 table.\r | |
2440e68c SM |
66 | */\r |
67 | \r | |
68 | /** The ACPI_TABLE_GENERATOR_ID type describes ACPI table generator ID.\r | |
69 | */\r | |
70 | typedef TABLE_GENERATOR_ID ACPI_TABLE_GENERATOR_ID;\r | |
71 | \r | |
72 | /** The ESTD_ACPI_TABLE_ID enum describes the ACPI table IDs reserved for\r | |
73 | the standard generators.\r | |
74 | */\r | |
75 | typedef enum StdAcpiTableId {\r | |
76 | EStdAcpiTableIdReserved = 0x0000, ///< Reserved\r | |
77 | EStdAcpiTableIdRaw, ///< RAW Generator\r | |
78 | EStdAcpiTableIdDsdt = EStdAcpiTableIdRaw, ///< DSDT Generator\r | |
79 | EStdAcpiTableIdSsdt = EStdAcpiTableIdRaw, ///< SSDT Generator\r | |
80 | EStdAcpiTableIdFadt, ///< FADT Generator\r | |
81 | EStdAcpiTableIdMadt, ///< MADT Generator\r | |
82 | EStdAcpiTableIdGtdt, ///< GTDT Generator\r | |
83 | EStdAcpiTableIdDbg2, ///< DBG2 Generator\r | |
84 | EStdAcpiTableIdSpcr, ///< SPCR Generator\r | |
85 | EStdAcpiTableIdMcfg, ///< MCFG Generator\r | |
86 | EStdAcpiTableIdIort, ///< IORT Generator\r | |
77db1156 | 87 | EStdAcpiTableIdPptt, ///< PPTT Generator\r |
f413d9be | 88 | EStdAcpiTableIdSrat, ///< SRAT Generator\r |
bade7f42 | 89 | EStdAcpiTableIdSsdtSerialPort, ///< SSDT Serial-Port Generator\r |
37568365 | 90 | EStdAcpiTableIdSsdtCmn600, ///< SSDT Cmn-600 Generator\r |
2440e68c SM |
91 | EStdAcpiTableIdMax\r |
92 | } ESTD_ACPI_TABLE_ID;\r | |
93 | \r | |
94 | /** This macro checks if the Table Generator ID is for an ACPI Table Generator.\r | |
95 | \r | |
96 | @param [in] TableGeneratorId The table generator ID.\r | |
97 | \r | |
98 | @return TRUE if the table generator ID is for an ACPI Table\r | |
99 | Generator.\r | |
100 | **/\r | |
101 | #define IS_GENERATOR_TYPE_ACPI(TableGeneratorId) \\r | |
102 | (GET_TABLE_TYPE (TableGeneratorId) == ETableGeneratorTypeAcpi)\r | |
103 | \r | |
104 | /** This macro checks if the Table Generator ID is for a standard ACPI\r | |
105 | Table Generator.\r | |
106 | \r | |
107 | @param [in] TableGeneratorId The table generator ID.\r | |
108 | \r | |
109 | @return TRUE if the table generator ID is for a standard ACPI\r | |
110 | Table Generator.\r | |
111 | **/\r | |
112 | #define IS_VALID_STD_ACPI_GENERATOR_ID(TableGeneratorId) \\r | |
113 | ( \\r | |
114 | IS_GENERATOR_NAMESPACE_STD (TableGeneratorId) && \\r | |
115 | IS_GENERATOR_TYPE_ACPI (TableGeneratorId) && \\r | |
116 | ((GET_TABLE_ID (GeneratorId) >= EStdAcpiTableIdRaw) && \\r | |
117 | (GET_TABLE_ID (GeneratorId) < EStdAcpiTableIdMax)) \\r | |
118 | )\r | |
119 | \r | |
120 | /** This macro creates a standard ACPI Table Generator ID.\r | |
121 | \r | |
122 | @param [in] TableId The table generator ID.\r | |
123 | \r | |
124 | @return a standard ACPI table generator ID.\r | |
125 | **/\r | |
126 | #define CREATE_STD_ACPI_TABLE_GEN_ID(TableId) \\r | |
127 | CREATE_TABLE_GEN_ID ( \\r | |
128 | ETableGeneratorTypeAcpi, \\r | |
129 | ETableGeneratorNameSpaceStd, \\r | |
130 | TableId \\r | |
131 | )\r | |
132 | \r | |
133 | /** This macro creates an OEM ACPI Table Generator ID.\r | |
134 | \r | |
135 | @param [in] TableId The table generator ID.\r | |
136 | \r | |
137 | @return an OEM ACPI table generator ID.\r | |
138 | **/\r | |
139 | #define CREATE_OEM_ACPI_TABLE_GEN_ID(TableId) \\r | |
140 | CREATE_TABLE_GEN_ID ( \\r | |
141 | ETableGeneratorTypeAcpi, \\r | |
142 | ETableGeneratorNameSpaceOem, \\r | |
143 | TableId \\r | |
144 | )\r | |
145 | \r | |
146 | /** The Creator ID for the ACPI tables generated using\r | |
147 | the standard ACPI table generators.\r | |
148 | */\r | |
149 | #define TABLE_GENERATOR_CREATOR_ID_ARM SIGNATURE_32('A', 'R', 'M', 'H')\r | |
150 | \r | |
151 | /** A macro to initialise the common header part of EFI ACPI tables as\r | |
152 | defined by the EFI_ACPI_DESCRIPTION_HEADER structure.\r | |
153 | \r | |
154 | @param [in] Signature The ACPI table signature.\r | |
155 | @param [in] Type The ACPI table structure.\r | |
156 | @param [in] Revision The ACPI table revision.\r | |
157 | **/\r | |
158 | #define ACPI_HEADER(Signature, Type, Revision) { \\r | |
159 | Signature, /* UINT32 Signature */ \\r | |
160 | sizeof (Type), /* UINT32 Length */ \\r | |
161 | Revision, /* UINT8 Revision */ \\r | |
162 | 0, /* UINT8 Checksum */ \\r | |
163 | { 0, 0, 0, 0, 0, 0 }, /* UINT8 OemId[6] */ \\r | |
164 | 0, /* UINT64 OemTableId */ \\r | |
165 | 0, /* UINT32 OemRevision */ \\r | |
166 | 0, /* UINT32 CreatorId */ \\r | |
167 | 0 /* UINT32 CreatorRevision */\\r | |
168 | }\r | |
169 | \r | |
170 | /** A macro to dump the common header part of EFI ACPI tables as\r | |
171 | defined by the EFI_ACPI_DESCRIPTION_HEADER structure.\r | |
172 | \r | |
173 | @param [in] AcpiHeader The pointer to the ACPI table header.\r | |
174 | **/\r | |
175 | #define DUMP_ACPI_TABLE_HEADER(AcpiHeader) \\r | |
176 | DEBUG (( \\r | |
177 | DEBUG_INFO, \\r | |
178 | "ACPI TABLE %c%c%c%c : Rev 0x%x : Length : 0x%x\n", \\r | |
179 | (AcpiHeader->Signature & 0xFF), \\r | |
180 | ((AcpiHeader->Signature >> 8) & 0xFF), \\r | |
181 | ((AcpiHeader->Signature >> 16) & 0xFF), \\r | |
182 | ((AcpiHeader->Signature >> 24) & 0xFF), \\r | |
183 | AcpiHeader->Revision, \\r | |
184 | AcpiHeader->Length \\r | |
185 | ));\r | |
186 | \r | |
187 | /** Forward declarations.\r | |
188 | */\r | |
189 | typedef struct ConfigurationManagerProtocol EDKII_CONFIGURATION_MANAGER_PROTOCOL;\r | |
190 | typedef struct CmAStdObjAcpiTableInfo CM_STD_OBJ_ACPI_TABLE_INFO;\r | |
191 | typedef struct AcpiTableGenerator ACPI_TABLE_GENERATOR;\r | |
192 | \r | |
193 | /** This function pointer describes the interface to ACPI table build\r | |
194 | functions provided by the ACPI table generator and called by the\r | |
195 | Table Manager to build an ACPI table.\r | |
196 | \r | |
197 | @param [in] This Pointer to the ACPI table generator.\r | |
198 | @param [in] AcpiTableInfo Pointer to the ACPI table information.\r | |
199 | @param [in] CfgMgrProtocol Pointer to the Configuration Manager\r | |
200 | Protocol interface.\r | |
201 | @param [out] Table Pointer to the generated ACPI table.\r | |
202 | \r | |
203 | @return EFI_SUCCESS If the table is generated successfully or other\r | |
204 | failure codes as returned by the generator.\r | |
205 | **/\r | |
206 | typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_BUILD_TABLE) (\r | |
207 | IN CONST ACPI_TABLE_GENERATOR * This,\r | |
208 | IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo,\r | |
209 | IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol,\r | |
210 | OUT EFI_ACPI_DESCRIPTION_HEADER ** Table\r | |
211 | );\r | |
212 | \r | |
213 | /** This function pointer describes the interface used by the\r | |
214 | Table Manager to give the generator an opportunity to free\r | |
215 | any resources allocated for building the ACPI table.\r | |
216 | \r | |
217 | @param [in] This Pointer to the ACPI table generator.\r | |
218 | @param [in] AcpiTableInfo Pointer to the ACPI Table Info.\r | |
219 | @param [in] CfgMgrProtocol Pointer to the Configuration Manager\r | |
220 | Protocol Interface.\r | |
221 | @param [in, out] Table Pointer to the ACPI Table.\r | |
222 | \r | |
223 | @return EFI_SUCCESS If freed successfully or other failure codes\r | |
224 | as returned by the generator.\r | |
225 | **/\r | |
226 | typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_FREE_TABLE) (\r | |
227 | IN CONST ACPI_TABLE_GENERATOR * CONST This,\r | |
228 | IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo,\r | |
229 | IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol,\r | |
230 | IN OUT EFI_ACPI_DESCRIPTION_HEADER ** CONST Table\r | |
231 | );\r | |
232 | \r | |
233 | /** This function pointer describes an extended interface to build\r | |
234 | ACPI Tables. The ACPI table generator can generate multiple\r | |
235 | ACPI Tables and return a pointer to the list of ACPI tables.\r | |
236 | The FreeTableResourcesEx() must be called to free any resources\r | |
237 | that may have been allocated using this interface.\r | |
238 | \r | |
239 | @param [in] This Pointer to the ACPI table generator.\r | |
240 | @param [in] AcpiTableInfo Pointer to the ACPI table information.\r | |
241 | @param [in] CfgMgrProtocol Pointer to the Configuration Manager\r | |
242 | Protocol interface.\r | |
243 | @param [out] Table Pointer to a list of generated ACPI table(s).\r | |
244 | @param [out] TableCount Number of generated ACPI table(s).\r | |
245 | \r | |
246 | @return EFI_SUCCESS If the table is generated successfully or other\r | |
247 | failure codes as returned by the generator.\r | |
248 | **/\r | |
249 | typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_BUILD_TABLEEX) (\r | |
250 | IN CONST ACPI_TABLE_GENERATOR * This,\r | |
251 | IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo,\r | |
252 | IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol,\r | |
253 | OUT EFI_ACPI_DESCRIPTION_HEADER *** Table,\r | |
254 | OUT UINTN * CONST TableCount\r | |
255 | );\r | |
256 | \r | |
257 | /** This function pointer describes an extended interface used by the\r | |
258 | Table Manager to give the generator an opportunity to free\r | |
259 | any resources allocated for building the ACPI table. This interface\r | |
260 | must be used in conjunction with the BuildAcpiTableEx interface.\r | |
261 | \r | |
262 | @param [in] This Pointer to the ACPI table generator.\r | |
263 | @param [in] AcpiTableInfo Pointer to the ACPI Table Info.\r | |
264 | @param [in] CfgMgrProtocol Pointer to the Configuration Manager\r | |
265 | Protocol Interface.\r | |
266 | @param [in, out] Table Pointer to the list of ACPI Table(s).\r | |
267 | @param [in] TableCount Number of ACPI table(s).\r | |
268 | \r | |
269 | @return EFI_SUCCESS If freed successfully or other failure codes\r | |
270 | as returned by the generator.\r | |
271 | **/\r | |
272 | typedef EFI_STATUS (*ACPI_TABLE_GENERATOR_FREE_TABLEEX) (\r | |
273 | IN CONST ACPI_TABLE_GENERATOR * CONST This,\r | |
274 | IN CONST CM_STD_OBJ_ACPI_TABLE_INFO * CONST AcpiTableInfo,\r | |
275 | IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL * CONST CfgMgrProtocol,\r | |
276 | IN OUT EFI_ACPI_DESCRIPTION_HEADER *** CONST Table,\r | |
277 | IN CONST UINTN TableCount\r | |
278 | );\r | |
279 | \r | |
280 | /** The ACPI_TABLE_GENERATOR structure provides an interface that the\r | |
281 | Table Manager can use to invoke the functions to build ACPI tables.\r | |
282 | \r | |
283 | Note: Although the Generator is required to implement at least\r | |
284 | one pair of interfaces (BuildAcpiTable & FreeTableResources or\r | |
285 | BuildAcpiTableEx & FreeTableResourcesEx) for generating the ACPI\r | |
286 | table(s), if both pair of interfaces are implemented the extended\r | |
287 | version will take precedence.\r | |
288 | **/\r | |
289 | typedef struct AcpiTableGenerator {\r | |
290 | /// The ACPI table generator ID.\r | |
291 | ACPI_TABLE_GENERATOR_ID GeneratorID;\r | |
292 | \r | |
293 | /// String describing the ACPI table generator.\r | |
294 | CONST CHAR16 * Description;\r | |
295 | \r | |
296 | /// The ACPI table signature.\r | |
297 | UINT32 AcpiTableSignature;\r | |
298 | \r | |
299 | /// The ACPI table revision.\r | |
90e52483 | 300 | UINT8 AcpiTableRevision;\r |
2440e68c SM |
301 | \r |
302 | /// The minimum supported ACPI table revision.\r | |
90e52483 | 303 | UINT8 MinAcpiTableRevision;\r |
2440e68c SM |
304 | \r |
305 | /// The ACPI table creator ID.\r | |
306 | UINT32 CreatorId;\r | |
307 | \r | |
308 | /// The ACPI table creator revision.\r | |
309 | UINT32 CreatorRevision;\r | |
310 | \r | |
311 | /// ACPI table build function pointer.\r | |
312 | ACPI_TABLE_GENERATOR_BUILD_TABLE BuildAcpiTable;\r | |
313 | \r | |
314 | /** The function to free any resources\r | |
315 | allocated for building the ACPI table.\r | |
316 | */\r | |
317 | ACPI_TABLE_GENERATOR_FREE_TABLE FreeTableResources;\r | |
318 | \r | |
319 | /// ACPI table extended build function pointer.\r | |
320 | ACPI_TABLE_GENERATOR_BUILD_TABLEEX BuildAcpiTableEx;\r | |
321 | \r | |
322 | /** The function to free any resources\r | |
323 | allocated for building the ACPI table\r | |
324 | using the extended interface.\r | |
325 | */\r | |
326 | ACPI_TABLE_GENERATOR_FREE_TABLEEX FreeTableResourcesEx;\r | |
327 | } ACPI_TABLE_GENERATOR;\r | |
328 | \r | |
329 | /** Register ACPI table factory generator.\r | |
330 | \r | |
331 | The ACPI table factory maintains a list of the Standard and OEM ACPI\r | |
332 | table generators.\r | |
333 | \r | |
334 | @param [in] Generator Pointer to the ACPI table generator.\r | |
335 | \r | |
336 | @retval EFI_SUCCESS The Generator was registered\r | |
337 | successfully.\r | |
338 | @retval EFI_INVALID_PARAMETER The Generator ID is invalid or\r | |
339 | the Generator pointer is NULL.\r | |
340 | @retval EFI_ALREADY_STARTED The Generator for the Table ID is\r | |
341 | already registered.\r | |
342 | **/\r | |
343 | EFI_STATUS\r | |
344 | EFIAPI\r | |
345 | RegisterAcpiTableGenerator (\r | |
346 | IN CONST ACPI_TABLE_GENERATOR * CONST Generator\r | |
347 | );\r | |
348 | \r | |
349 | /** Deregister ACPI generator.\r | |
350 | \r | |
351 | This function is called by the ACPI table generator to deregister itself\r | |
352 | from the ACPI table factory.\r | |
353 | \r | |
354 | @param [in] Generator Pointer to the ACPI table generator.\r | |
355 | \r | |
356 | @retval EFI_SUCCESS Success.\r | |
357 | @retval EFI_INVALID_PARAMETER The generator is invalid.\r | |
358 | @retval EFI_NOT_FOUND The requested generator is not found\r | |
359 | in the list of registered generators.\r | |
360 | **/\r | |
361 | EFI_STATUS\r | |
362 | EFIAPI\r | |
363 | DeregisterAcpiTableGenerator (\r | |
364 | IN CONST ACPI_TABLE_GENERATOR * CONST Generator\r | |
365 | );\r | |
366 | \r | |
367 | #pragma pack()\r | |
368 | \r | |
369 | #endif // ACPI_TABLE_GENERATOR_H_\r | |
370 | \r |