]> git.proxmox.com Git - mirror_edk2.git/blame - MdeModulePkg/Universal/Acpi/AcpiTableDxe/AcpiTableProtocol.c
MdeModulePkg:
[mirror_edk2.git] / MdeModulePkg / Universal / Acpi / AcpiTableDxe / AcpiTableProtocol.c
CommitLineData
5f55c700 1/** @file\r
2 ACPI Table Protocol Implementation\r
3\r
da935a5c 4 Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
e5eed7d3 5 This program and the accompanying materials\r
5f55c700 6 are licensed and made available under the terms and conditions of the BSD License\r
7 which accompanies this distribution. The full text of the license may be found at\r
8 http://opensource.org/licenses/bsd-license.php\r
9\r
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
15//\r
16// Includes\r
17//\r
18#include "AcpiTable.h"\r
da935a5c 19//\r
20// The maximum number of tables that pre-allocated. \r
21//\r
22UINTN mEfiAcpiMaxNumTables = EFI_ACPI_MAX_NUM_TABLES; \r
5f55c700 23\r
24/**\r
25 This function adds an ACPI table to the table list. It will detect FACS and\r
26 allocate the correct type of memory and properly align the table.\r
27\r
28 @param AcpiTableInstance Instance of the protocol.\r
29 @param Table Table to add.\r
30 @param Checksum Does the table require checksumming.\r
31 @param Version The version of the list to add the table to.\r
32 @param Handle Pointer for returning the handle.\r
33\r
34 @return EFI_SUCCESS The function completed successfully.\r
35 @return EFI_OUT_OF_RESOURCES Could not allocate a required resource.\r
36 @return EFI_ABORTED The table is a duplicate of a table that is required\r
37 to be unique.\r
38\r
39**/\r
40EFI_STATUS\r
41AddTableToList (\r
42 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
43 IN VOID *Table,\r
44 IN BOOLEAN Checksum,\r
45 IN EFI_ACPI_TABLE_VERSION Version,\r
46 OUT UINTN *Handle\r
47 );\r
48\r
49/**\r
50 This function finds and removes the table specified by the handle.\r
51\r
52 @param AcpiTableInstance Instance of the protocol.\r
53 @param Version Bitmask of which versions to remove.\r
54 @param Handle Table to remove.\r
55\r
56 @return EFI_SUCCESS The function completed successfully.\r
57 @return EFI_ABORTED An error occurred.\r
58 @return EFI_NOT_FOUND Handle not found in table list.\r
59\r
60**/\r
61EFI_STATUS\r
62RemoveTableFromList (\r
63 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
64 IN EFI_ACPI_TABLE_VERSION Version,\r
65 IN UINTN Handle\r
66 );\r
67\r
68/**\r
69 This function calculates and updates an UINT8 checksum.\r
70\r
71 @param Buffer Pointer to buffer to checksum\r
72 @param Size Number of bytes to checksum\r
73 @param ChecksumOffset Offset to place the checksum result in\r
74\r
75 @return EFI_SUCCESS The function completed successfully.\r
5f55c700 76**/\r
77EFI_STATUS\r
78AcpiPlatformChecksum (\r
79 IN VOID *Buffer,\r
80 IN UINTN Size,\r
81 IN UINTN ChecksumOffset\r
82 );\r
83\r
84/**\r
85 Checksum all versions of the common tables, RSDP, RSDT, XSDT.\r
86\r
87 @param AcpiTableInstance Protocol instance private data.\r
88\r
89 @return EFI_SUCCESS The function completed successfully.\r
90\r
91**/\r
92EFI_STATUS\r
93ChecksumCommonTables (\r
94 IN OUT EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
95 );\r
96\r
97//\r
98// Protocol function implementations.\r
99//\r
100\r
101/**\r
102 This function adds, removes, or updates ACPI tables. If the address is not\r
103 null and the handle value is null, the table is added. If both the address and \r
104 handle are not null, the table at handle is updated with the table at address.\r
105 If the address is null and the handle is not, the table at handle is deleted.\r
106\r
107 @param AcpiTableInstance Instance of the protocol.\r
108 @param Table Pointer to a table.\r
109 @param Checksum Boolean indicating if the checksum should be calculated.\r
110 @param Version Version(s) to set.\r
111 @param Handle Handle of the table.\r
112\r
113 @return EFI_SUCCESS The function completed successfully.\r
114 @return EFI_INVALID_PARAMETER Both the Table and *Handle were NULL.\r
115 @return EFI_ABORTED Could not complete the desired request.\r
116\r
117**/\r
118EFI_STATUS\r
119EFIAPI\r
120SetAcpiTable (\r
121 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
122 IN VOID *Table OPTIONAL,\r
123 IN BOOLEAN Checksum,\r
124 IN EFI_ACPI_TABLE_VERSION Version,\r
125 IN OUT UINTN *Handle\r
126 )\r
127{\r
128 UINTN SavedHandle;\r
129 EFI_STATUS Status;\r
130\r
131 //\r
132 // Check for invalid input parameters\r
133 //\r
134 ASSERT (Handle);\r
135\r
136 //\r
137 // Initialize locals\r
138 //\r
139 //\r
140 // Determine desired action\r
141 //\r
142 if (*Handle == 0) {\r
143 if (Table == NULL) {\r
144 //\r
145 // Invalid parameter combination\r
146 //\r
147 return EFI_INVALID_PARAMETER;\r
148 } else {\r
149 //\r
150 // Add table\r
151 //\r
152 Status = AddTableToList (AcpiTableInstance, Table, Checksum, Version, Handle);\r
153 }\r
154 } else {\r
155 if (Table != NULL) {\r
156 //\r
157 // Update table\r
158 //\r
159 //\r
160 // Delete the table list entry\r
161 //\r
162 Status = RemoveTableFromList (AcpiTableInstance, Version, *Handle);\r
163 if (EFI_ERROR (Status)) {\r
164 //\r
165 // Should not get an error here ever, but abort if we do.\r
166 //\r
167 return EFI_ABORTED;\r
168 }\r
169 //\r
170 // Set the handle to replace the table at the same handle\r
171 //\r
172 SavedHandle = AcpiTableInstance->CurrentHandle;\r
173 AcpiTableInstance->CurrentHandle = *Handle;\r
174\r
175 //\r
176 // Add the table\r
177 //\r
178 Status = AddTableToList (AcpiTableInstance, Table, Checksum, Version, Handle);\r
179\r
180 //\r
181 // Restore the saved current handle\r
182 //\r
183 AcpiTableInstance->CurrentHandle = SavedHandle;\r
184 } else {\r
185 //\r
186 // Delete table\r
187 //\r
188 Status = RemoveTableFromList (AcpiTableInstance, Version, *Handle);\r
189 }\r
190 }\r
191\r
192 if (EFI_ERROR (Status)) {\r
193 //\r
194 // Should not get an error here ever, but abort if we do.\r
195 //\r
196 return EFI_ABORTED;\r
197 }\r
198 //\r
199 // Done\r
200 //\r
201 return EFI_SUCCESS;\r
202}\r
203\r
204/**\r
205 This function publishes the specified versions of the ACPI tables by\r
206 installing EFI configuration table entries for them. Any combination of\r
207 table versions can be published.\r
208\r
209 @param AcpiTableInstance Instance of the protocol.\r
210 @param Version Version(s) to publish.\r
211\r
212 @return EFI_SUCCESS The function completed successfully.\r
213 @return EFI_ABORTED The function could not complete successfully.\r
214\r
215**/\r
216EFI_STATUS\r
217EFIAPI\r
218PublishTables (\r
219 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
220 IN EFI_ACPI_TABLE_VERSION Version\r
221 )\r
222{\r
223 EFI_STATUS Status;\r
224 UINT32 *CurrentRsdtEntry;\r
225 VOID *CurrentXsdtEntry;\r
226 UINT64 Buffer64;\r
227\r
228 //\r
229 // Reorder tables as some operating systems don't seem to find the\r
230 // FADT correctly if it is not in the first few entries\r
231 //\r
232\r
233 //\r
234 // Add FADT as the first entry\r
235 //\r
236 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
237 CurrentRsdtEntry = (UINT32 *) ((UINT8 *) AcpiTableInstance->Rsdt1 + sizeof (EFI_ACPI_DESCRIPTION_HEADER));\r
238 *CurrentRsdtEntry = (UINT32) (UINTN) AcpiTableInstance->Fadt1;\r
239 }\r
240 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
241 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
242 CurrentRsdtEntry = (UINT32 *) ((UINT8 *) AcpiTableInstance->Rsdt3 + sizeof (EFI_ACPI_DESCRIPTION_HEADER));\r
243 *CurrentRsdtEntry = (UINT32) (UINTN) AcpiTableInstance->Fadt3;\r
244 CurrentXsdtEntry = (VOID *) ((UINT8 *) AcpiTableInstance->Xsdt + sizeof (EFI_ACPI_DESCRIPTION_HEADER));\r
245 //\r
246 // Add entry to XSDT, XSDT expects 64 bit pointers, but\r
247 // the table pointers in XSDT are not aligned on 8 byte boundary.\r
248 //\r
249 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Fadt3;\r
250 CopyMem (\r
251 CurrentXsdtEntry,\r
252 &Buffer64,\r
253 sizeof (UINT64)\r
254 );\r
255 }\r
256\r
257 //\r
258 // Do checksum again because Dsdt/Xsdt is updated.\r
259 //\r
260 ChecksumCommonTables (AcpiTableInstance);\r
261\r
262 //\r
263 // Add the RSD_PTR to the system table and store that we have installed the\r
264 // tables.\r
265 //\r
266 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) &&\r
267 !AcpiTableInstance->TablesInstalled1) {\r
268 Status = gBS->InstallConfigurationTable (&gEfiAcpi10TableGuid, AcpiTableInstance->Rsdp1);\r
269 if (EFI_ERROR (Status)) {\r
270 return EFI_ABORTED;\r
271 }\r
272\r
273 AcpiTableInstance->TablesInstalled1 = TRUE;\r
274 }\r
275\r
276 if (((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
277 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) &&\r
278 !AcpiTableInstance->TablesInstalled3) {\r
279 Status = gBS->InstallConfigurationTable (&gEfiAcpiTableGuid, AcpiTableInstance->Rsdp3);\r
280 if (EFI_ERROR (Status)) {\r
281 return EFI_ABORTED;\r
282 }\r
283\r
284 AcpiTableInstance->TablesInstalled3= TRUE;\r
285 }\r
286\r
287 return EFI_SUCCESS;\r
288}\r
289\r
290\r
291/**\r
292 Installs an ACPI table into the RSDT/XSDT.\r
2fd3009f 293 Note that the ACPI table should be checksumed before installing it.\r
294 Otherwise it will assert.\r
5f55c700 295\r
296 @param This Protocol instance pointer.\r
297 @param AcpiTableBuffer A pointer to a buffer containing the ACPI table to be installed.\r
298 @param AcpiTableBufferSize Specifies the size, in bytes, of the AcpiTableBuffer buffer.\r
299 @param TableKey Reurns a key to refer to the ACPI table.\r
300\r
301 @return EFI_SUCCESS The table was successfully inserted.\r
302 @return EFI_INVALID_PARAMETER Either AcpiTableBuffer is NULL, TableKey is NULL, or AcpiTableBufferSize \r
303 and the size field embedded in the ACPI table pointed to by AcpiTableBuffer\r
304 are not in sync.\r
305 @return EFI_OUT_OF_RESOURCES Insufficient resources exist to complete the request.\r
306\r
307**/\r
308EFI_STATUS\r
309EFIAPI\r
310InstallAcpiTable (\r
311 IN CONST EFI_ACPI_TABLE_PROTOCOL *This,\r
312 IN CONST VOID *AcpiTableBuffer,\r
313 IN UINTN AcpiTableBufferSize,\r
314 OUT UINTN *TableKey\r
315 )\r
316{\r
317 EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance;\r
318 EFI_STATUS Status;\r
319 VOID *AcpiTableBufferConst;\r
2fd3009f 320 UINT32 Length;\r
321 UINT8 Checksum;\r
5f55c700 322\r
323 //\r
324 // Check for invalid input parameters\r
325 //\r
326 if ((AcpiTableBuffer == NULL) || (TableKey == NULL)\r
327 || (((EFI_ACPI_DESCRIPTION_HEADER *) AcpiTableBuffer)->Length != AcpiTableBufferSize)) {\r
328 return EFI_INVALID_PARAMETER;\r
329 }\r
330\r
2fd3009f 331 Length = ((EFI_ACPI_COMMON_HEADER *) AcpiTableBuffer)->Length;\r
332 Checksum = CalculateCheckSum8 ((UINT8 *)AcpiTableBuffer, Length);\r
333 ASSERT (Checksum == 0);\r
334\r
5f55c700 335 //\r
336 // Get the instance of the ACPI table protocol\r
337 //\r
338 AcpiTableInstance = EFI_ACPI_TABLE_INSTANCE_FROM_THIS (This);\r
339\r
340 //\r
341 // Install the ACPI table\r
342 //\r
343 AcpiTableBufferConst = AllocateCopyPool (AcpiTableBufferSize,AcpiTableBuffer);\r
344 *TableKey = 0;\r
345 Status = SetAcpiTable (\r
346 AcpiTableInstance,\r
347 AcpiTableBufferConst,\r
0f8e582f 348 FALSE,\r
46a989f7 349 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0,\r
5f55c700 350 TableKey\r
351 );\r
352 if (!EFI_ERROR (Status)) {\r
353 Status = PublishTables (\r
354 AcpiTableInstance,\r
46a989f7 355 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0\r
5f55c700 356 );\r
357 }\r
358 FreePool (AcpiTableBufferConst);\r
359 \r
3dc8585e
JY
360 //\r
361 // Add a new table successfully, notify registed callback\r
362 //\r
363 if (FeaturePcdGet (PcdInstallAcpiSdtProtocol)) {\r
364 if (!EFI_ERROR (Status)) {\r
365 SdtNotifyAcpiList (\r
366 AcpiTableInstance,\r
367 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0,\r
368 *TableKey\r
369 );\r
370 }\r
371 }\r
372\r
5f55c700 373 return Status;\r
374}\r
375\r
376\r
377/**\r
378 Removes an ACPI table from the RSDT/XSDT.\r
379\r
380 @param This Protocol instance pointer.\r
381 @param TableKey Specifies the table to uninstall. The key was returned from InstallAcpiTable().\r
382\r
383 @return EFI_SUCCESS The table was successfully uninstalled.\r
384 @return EFI_NOT_FOUND TableKey does not refer to a valid key for a table entry.\r
385\r
386**/\r
387EFI_STATUS\r
388EFIAPI\r
389UninstallAcpiTable (\r
390 IN CONST EFI_ACPI_TABLE_PROTOCOL *This,\r
391 IN UINTN TableKey\r
392 )\r
393{\r
394 EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance;\r
395 EFI_STATUS Status;\r
396\r
397 //\r
398 // Get the instance of the ACPI table protocol\r
399 //\r
400 AcpiTableInstance = EFI_ACPI_TABLE_INSTANCE_FROM_THIS (This);\r
401\r
402 //\r
403 // Uninstall the ACPI table\r
404 //\r
405 Status = SetAcpiTable (\r
406 AcpiTableInstance,\r
407 NULL,\r
408 FALSE,\r
46a989f7 409 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0,\r
5f55c700 410 &TableKey\r
411 );\r
412 if (!EFI_ERROR (Status)) {\r
413 Status = PublishTables (\r
414 AcpiTableInstance,\r
46a989f7 415 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0\r
5f55c700 416 );\r
417 }\r
418\r
419 if (EFI_ERROR (Status)) {\r
420 return EFI_NOT_FOUND;\r
421 } else {\r
422 return EFI_SUCCESS;\r
423 }\r
424}\r
425\r
da935a5c 426/**\r
427 If the number of APCI tables exceeds the preallocated max table number, enlarge the table buffer.\r
428\r
429 @param AcpiTableInstance ACPI table protocol instance data structure.\r
430\r
431 @return EFI_SUCCESS reallocate the table beffer successfully.\r
432 @return EFI_OUT_OF_RESOURCES Unable to allocate required resources.\r
433\r
434**/\r
435EFI_STATUS\r
436ReallocateAcpiTableBuffer (\r
437 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
438 )\r
439{\r
440 UINTN NewMaxTableNumber;\r
441 UINTN TotalSize;\r
442 UINT8 *Pointer;\r
443 EFI_PHYSICAL_ADDRESS PageAddress;\r
444 EFI_ACPI_TABLE_INSTANCE TempPrivateData;\r
445 EFI_STATUS Status;\r
446 UINT64 CurrentData;\r
447 \r
448 CopyMem (&TempPrivateData, AcpiTableInstance, sizeof (EFI_ACPI_TABLE_INSTANCE)); \r
449 //\r
450 // Enlarge the max table number from mEfiAcpiMaxNumTables to mEfiAcpiMaxNumTables + EFI_ACPI_MAX_NUM_TABLES\r
451 //\r
452 NewMaxTableNumber = mEfiAcpiMaxNumTables + EFI_ACPI_MAX_NUM_TABLES;\r
453 //\r
454 // Create RSDP, RSDT, XSDT structures and allocate all buffers\r
455 //\r
456 TotalSize = sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
457 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
458 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 1.0 RSDT\r
459 NewMaxTableNumber * sizeof (UINT32) +\r
460 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 RSDT\r
461 NewMaxTableNumber * sizeof (UINT32) +\r
462 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 XSDT\r
463 NewMaxTableNumber * sizeof (UINT64);\r
464\r
465 //\r
466 // Allocate memory in the lower 32 bit of address range for\r
467 // compatibility with ACPI 1.0 OS.\r
468 //\r
469 // This is done because ACPI 1.0 pointers are 32 bit values.\r
470 // ACPI 2.0 OS and all 64 bit OS must use the 64 bit ACPI table addresses.\r
471 // There is no architectural reason these should be below 4GB, it is purely\r
472 // for convenience of implementation that we force memory below 4GB.\r
473 //\r
474 PageAddress = 0xFFFFFFFF;\r
475 Status = gBS->AllocatePages (\r
476 AllocateMaxAddress,\r
477 EfiACPIReclaimMemory,\r
478 EFI_SIZE_TO_PAGES (TotalSize),\r
479 &PageAddress\r
480 );\r
481\r
482 if (EFI_ERROR (Status)) {\r
483 return EFI_OUT_OF_RESOURCES;\r
484 }\r
485\r
486 Pointer = (UINT8 *) (UINTN) PageAddress;\r
487 ZeroMem (Pointer, TotalSize);\r
488 \r
489 AcpiTableInstance->Rsdp1 = (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
490 Pointer += sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
491 AcpiTableInstance->Rsdp3 = (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
492 Pointer += sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
493\r
494 AcpiTableInstance->Rsdt1 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
495 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + NewMaxTableNumber * sizeof (UINT32));\r
496 AcpiTableInstance->Rsdt3 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
497 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + NewMaxTableNumber * sizeof (UINT32));\r
498\r
499 AcpiTableInstance->Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
5f55c700 500\r
da935a5c 501 //\r
502 // Initialize RSDP\r
503 //\r
504 CopyMem (AcpiTableInstance->Rsdp1, TempPrivateData.Rsdp1, sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER)); \r
505 AcpiTableInstance->Rsdp1->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt1;\r
506 \r
507 CopyMem (AcpiTableInstance->Rsdp3, TempPrivateData.Rsdp3, sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER)); \r
508 AcpiTableInstance->Rsdp3->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt3;\r
509 CurrentData = (UINT64) (UINTN) AcpiTableInstance->Xsdt;\r
510 CopyMem (&AcpiTableInstance->Rsdp3->XsdtAddress, &CurrentData, sizeof (UINT64));\r
511\r
512 //\r
513 // copy the original Rsdt1, Rsdt3 and Xsdt structure to new buffer \r
514 //\r
515 CopyMem (AcpiTableInstance->Rsdt1, TempPrivateData.Rsdt1, (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + mEfiAcpiMaxNumTables * sizeof (UINT32))); \r
516 CopyMem (AcpiTableInstance->Rsdt3, TempPrivateData.Rsdt3, (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + mEfiAcpiMaxNumTables * sizeof (UINT32))); \r
517 CopyMem (AcpiTableInstance->Xsdt, TempPrivateData.Xsdt, (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + mEfiAcpiMaxNumTables * sizeof (UINT64)));\r
518 \r
519 //\r
520 // Calculate orignal ACPI table buffer size\r
521 //\r
522 TotalSize = sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
523 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
524 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 1.0 RSDT\r
525 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
526 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 RSDT\r
527 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
528 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 XSDT\r
529 mEfiAcpiMaxNumTables * sizeof (UINT64);\r
2432c685 530 gBS->FreePages ((EFI_PHYSICAL_ADDRESS)(UINTN)TempPrivateData.Rsdp1, EFI_SIZE_TO_PAGES (TotalSize));\r
da935a5c 531 \r
532 //\r
533 // Update the Max ACPI table number\r
534 // \r
535 mEfiAcpiMaxNumTables = NewMaxTableNumber;\r
536 return EFI_SUCCESS;\r
537}\r
5f55c700 538/**\r
539 This function adds an ACPI table to the table list. It will detect FACS and\r
540 allocate the correct type of memory and properly align the table.\r
541\r
542 @param AcpiTableInstance Instance of the protocol.\r
543 @param Table Table to add.\r
544 @param Checksum Does the table require checksumming.\r
545 @param Version The version of the list to add the table to.\r
546 @param Handle Pointer for returning the handle.\r
547\r
548 @return EFI_SUCCESS The function completed successfully.\r
549 @return EFI_OUT_OF_RESOURCES Could not allocate a required resource.\r
550 @return EFI_ABORTED The table is a duplicate of a table that is required\r
551 to be unique.\r
552\r
553**/\r
554EFI_STATUS\r
555AddTableToList (\r
556 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
557 IN VOID *Table,\r
558 IN BOOLEAN Checksum,\r
559 IN EFI_ACPI_TABLE_VERSION Version,\r
560 OUT UINTN *Handle\r
561 )\r
562{\r
563 EFI_STATUS Status;\r
564 EFI_ACPI_TABLE_LIST *CurrentTableList;\r
565 UINT32 CurrentTableSignature;\r
566 UINT32 CurrentTableSize;\r
567 UINT32 *CurrentRsdtEntry;\r
568 VOID *CurrentXsdtEntry;\r
569 UINT64 Buffer64;\r
570 BOOLEAN AddToRsdt;\r
571\r
572 //\r
573 // Check for invalid input parameters\r
574 //\r
575 ASSERT (AcpiTableInstance);\r
576 ASSERT (Table);\r
577 ASSERT (Handle);\r
578\r
579 //\r
580 // Init locals\r
581 //\r
582 AddToRsdt = TRUE;\r
583\r
584 //\r
585 // Create a new list entry\r
586 //\r
587 CurrentTableList = AllocatePool (sizeof (EFI_ACPI_TABLE_LIST));\r
588 ASSERT (CurrentTableList);\r
589\r
590 //\r
591 // Determine table type and size\r
592 //\r
593 CurrentTableSignature = ((EFI_ACPI_COMMON_HEADER *) Table)->Signature;\r
594 CurrentTableSize = ((EFI_ACPI_COMMON_HEADER *) Table)->Length;\r
595\r
596 //\r
597 // Allocate a buffer for the table. All tables are allocated in the lower 32 bits of address space\r
598 // for backwards compatibility with ACPI 1.0 OS.\r
599 //\r
600 // This is done because ACPI 1.0 pointers are 32 bit values.\r
601 // ACPI 2.0 OS and all 64 bit OS must use the 64 bit ACPI table addresses.\r
602 // There is no architectural reason these should be below 4GB, it is purely\r
603 // for convenience of implementation that we force memory below 4GB.\r
604 //\r
605 CurrentTableList->PageAddress = 0xFFFFFFFF;\r
606 CurrentTableList->NumberOfPages = EFI_SIZE_TO_PAGES (CurrentTableSize);\r
607\r
608 //\r
609 // Allocation memory type depends on the type of the table\r
610 //\r
611 if (CurrentTableSignature == EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE || \r
612 CurrentTableSignature == EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE) {\r
613 //\r
614 // Allocate memory for the FACS. This structure must be aligned\r
615 // on a 64 byte boundary and must be ACPI NVS memory.\r
616 // Using AllocatePages should ensure that it is always aligned.\r
617 //\r
618 ASSERT ((EFI_PAGE_SIZE % 64) == 0);\r
619 Status = gBS->AllocatePages (\r
620 AllocateMaxAddress,\r
621 EfiACPIMemoryNVS,\r
622 CurrentTableList->NumberOfPages,\r
623 &CurrentTableList->PageAddress\r
624 );\r
625 } else {\r
626 //\r
627 // All other tables are ACPI reclaim memory, no alignment requirements.\r
628 //\r
629 Status = gBS->AllocatePages (\r
630 AllocateMaxAddress,\r
631 EfiACPIReclaimMemory,\r
632 CurrentTableList->NumberOfPages,\r
633 &CurrentTableList->PageAddress\r
634 );\r
635 }\r
636 //\r
637 // Check return value from memory alloc.\r
638 //\r
639 if (EFI_ERROR (Status)) {\r
640 gBS->FreePool (CurrentTableList);\r
641 return EFI_OUT_OF_RESOURCES;\r
642 }\r
643 //\r
644 // Update the table pointer with the allocated memory start\r
645 //\r
646 CurrentTableList->Table = (EFI_ACPI_COMMON_HEADER *) (UINTN) CurrentTableList->PageAddress;\r
647\r
648 //\r
649 // Initialize the table contents\r
650 //\r
651 CurrentTableList->Signature = EFI_ACPI_TABLE_LIST_SIGNATURE;\r
652 CopyMem (CurrentTableList->Table, Table, CurrentTableSize);\r
653 CurrentTableList->Handle = AcpiTableInstance->CurrentHandle++;\r
654 *Handle = CurrentTableList->Handle;\r
655 CurrentTableList->Version = Version;\r
656\r
657 //\r
658 // Update internal pointers if this is a required table. If it is a required\r
659 // table and a table of that type already exists, return an error.\r
660 //\r
661 // Calculate the checksum if the table is not FACS.\r
662 //\r
663 switch (CurrentTableSignature) {\r
664\r
665 case EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE:\r
666 //\r
667 // We don't add the FADT in the standard way because some\r
668 // OS expect the FADT to be early in the table list.\r
669 // So we always add it as the first element in the list.\r
670 //\r
671 AddToRsdt = FALSE;\r
672\r
673 //\r
674 // Check that the table has not been previously added.\r
675 //\r
676 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0 && AcpiTableInstance->Fadt1 != NULL) ||\r
677 ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 && AcpiTableInstance->Fadt3 != NULL) ||\r
678 ((Version & EFI_ACPI_TABLE_VERSION_3_0) != 0 && AcpiTableInstance->Fadt3 != NULL)\r
679 ) {\r
680 gBS->FreePages (CurrentTableList->PageAddress, CurrentTableList->NumberOfPages);\r
681 gBS->FreePool (CurrentTableList);\r
682 return EFI_ABORTED;\r
683 }\r
684 //\r
685 // Add the table to the appropriate table version\r
686 //\r
687 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
688 //\r
689 // Save a pointer to the table\r
690 //\r
691 AcpiTableInstance->Fadt1 = (EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE *) CurrentTableList->Table;\r
692\r
693 //\r
694 // Update pointers in FADT. If tables don't exist this will put NULL pointers there.\r
695 //\r
696 AcpiTableInstance->Fadt1->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs1;\r
697 AcpiTableInstance->Fadt1->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt1;\r
698\r
699 //\r
700 // RSDP OEM information is updated to match the FADT OEM information\r
701 //\r
702 CopyMem (\r
703 &AcpiTableInstance->Rsdp1->OemId,\r
704 &AcpiTableInstance->Fadt1->Header.OemId,\r
705 6\r
706 );\r
707\r
708 //\r
709 // RSDT OEM information is updated to match the FADT OEM information.\r
710 //\r
711 CopyMem (\r
712 &AcpiTableInstance->Rsdt1->OemId,\r
713 &AcpiTableInstance->Fadt1->Header.OemId,\r
714 6\r
715 );\r
716\r
717 CopyMem (\r
718 &AcpiTableInstance->Rsdt1->OemTableId,\r
719 &AcpiTableInstance->Fadt1->Header.OemTableId,\r
720 sizeof (UINT64)\r
721 );\r
722 AcpiTableInstance->Rsdt1->OemRevision = AcpiTableInstance->Fadt1->Header.OemRevision;\r
723 }\r
724\r
725 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
726 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
727 //\r
728 // Save a pointer to the table\r
729 //\r
730 AcpiTableInstance->Fadt3 = (EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE *) CurrentTableList->Table;\r
731\r
732 //\r
733 // Update pointers in FADT. If tables don't exist this will put NULL pointers there.\r
734 //\r
f0c855b2 735 AcpiTableInstance->Fadt3->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs3;\r
736 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Facs3;\r
737 CopyMem (\r
738 &AcpiTableInstance->Fadt3->XFirmwareCtrl,\r
739 &Buffer64,\r
740 sizeof (UINT64)\r
741 );\r
742 AcpiTableInstance->Fadt3->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt3;\r
743 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Dsdt3;\r
744 CopyMem (\r
745 &AcpiTableInstance->Fadt3->XDsdt,\r
746 &Buffer64,\r
747 sizeof (UINT64)\r
748 );\r
5f55c700 749\r
f0c855b2 750 //\r
751 // RSDP OEM information is updated to match the FADT OEM information\r
752 //\r
753 CopyMem (\r
754 &AcpiTableInstance->Rsdp3->OemId,\r
755 &AcpiTableInstance->Fadt3->Header.OemId,\r
756 6\r
757 );\r
758 \r
759 //\r
760 // RSDT OEM information is updated to match FADT OEM information.\r
761 //\r
762 CopyMem (\r
763 &AcpiTableInstance->Rsdt3->OemId,\r
764 &AcpiTableInstance->Fadt3->Header.OemId,\r
765 6\r
766 );\r
767 CopyMem (\r
768 &AcpiTableInstance->Rsdt3->OemTableId,\r
769 &AcpiTableInstance->Fadt3->Header.OemTableId,\r
770 sizeof (UINT64)\r
771 );\r
772 AcpiTableInstance->Rsdt3->OemRevision = AcpiTableInstance->Fadt3->Header.OemRevision;\r
773 \r
774 //\r
775 // XSDT OEM information is updated to match FADT OEM information.\r
776 //\r
777 CopyMem (\r
778 &AcpiTableInstance->Xsdt->OemId,\r
779 &AcpiTableInstance->Fadt3->Header.OemId,\r
780 6\r
781 );\r
782 CopyMem (\r
783 &AcpiTableInstance->Xsdt->OemTableId,\r
784 &AcpiTableInstance->Fadt3->Header.OemTableId,\r
785 sizeof (UINT64)\r
786 );\r
787 AcpiTableInstance->Xsdt->OemRevision = AcpiTableInstance->Fadt3->Header.OemRevision;\r
5f55c700 788 } \r
789 //\r
790 // Checksum the table\r
791 //\r
792 if (Checksum) {\r
793 AcpiPlatformChecksum (\r
794 CurrentTableList->Table,\r
795 CurrentTableList->Table->Length,\r
796 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
797 Checksum)\r
798 );\r
799 }\r
800 break;\r
801\r
802 case EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE:\r
803 //\r
804 // Check that the table has not been previously added.\r
805 //\r
806 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0 && AcpiTableInstance->Facs1 != NULL) ||\r
807 ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 && AcpiTableInstance->Facs3 != NULL) ||\r
808 ((Version & EFI_ACPI_TABLE_VERSION_3_0) != 0 && AcpiTableInstance->Facs3 != NULL)\r
809 ) {\r
810 gBS->FreePages (CurrentTableList->PageAddress, CurrentTableList->NumberOfPages);\r
811 gBS->FreePool (CurrentTableList);\r
812 return EFI_ABORTED;\r
813 }\r
814 //\r
815 // FACS is referenced by FADT and is not part of RSDT\r
816 //\r
817 AddToRsdt = FALSE;\r
818\r
819 //\r
820 // Add the table to the appropriate table version\r
821 //\r
822 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
823 //\r
824 // Save a pointer to the table\r
825 //\r
826 AcpiTableInstance->Facs1 = (EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE *) CurrentTableList->Table;\r
827\r
828 //\r
829 // If FADT already exists, update table pointers.\r
830 //\r
831 if (AcpiTableInstance->Fadt1 != NULL) {\r
832 AcpiTableInstance->Fadt1->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs1;\r
833\r
834 //\r
835 // Checksum FADT table\r
836 //\r
837 AcpiPlatformChecksum (\r
838 AcpiTableInstance->Fadt1,\r
839 AcpiTableInstance->Fadt1->Header.Length,\r
840 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
841 Checksum)\r
842 );\r
843 }\r
844 }\r
845\r
846 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
847 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
848 //\r
849 // Save a pointer to the table\r
850 //\r
851 AcpiTableInstance->Facs3 = (EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE *) CurrentTableList->Table;\r
852\r
853 //\r
854 // If FADT already exists, update table pointers.\r
855 //\r
856 if (AcpiTableInstance->Fadt3 != NULL) {\r
857 AcpiTableInstance->Fadt3->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs3;\r
858 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Facs3;\r
859 CopyMem (\r
860 &AcpiTableInstance->Fadt3->XFirmwareCtrl,\r
861 &Buffer64,\r
862 sizeof (UINT64)\r
863 );\r
864\r
865 //\r
866 // Checksum FADT table\r
867 //\r
868 AcpiPlatformChecksum (\r
869 AcpiTableInstance->Fadt3,\r
870 AcpiTableInstance->Fadt3->Header.Length,\r
871 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
872 Checksum)\r
873 );\r
874 }\r
875 }\r
876\r
877 break;\r
878\r
879 case EFI_ACPI_1_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE:\r
880 //\r
881 // Check that the table has not been previously added.\r
882 //\r
883 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0 && AcpiTableInstance->Dsdt1 != NULL) ||\r
884 ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 && AcpiTableInstance->Dsdt3 != NULL) ||\r
885 ((Version & EFI_ACPI_TABLE_VERSION_3_0) != 0 && AcpiTableInstance->Dsdt3 != NULL)\r
886 ) {\r
887 gBS->FreePages (CurrentTableList->PageAddress, CurrentTableList->NumberOfPages);\r
888 gBS->FreePool (CurrentTableList);\r
889 return EFI_ABORTED;\r
890 }\r
891 //\r
892 // DSDT is referenced by FADT and is not part of RSDT\r
893 //\r
894 AddToRsdt = FALSE;\r
895\r
896 //\r
897 // Add the table to the appropriate table version\r
898 //\r
899 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
900 //\r
901 // Save a pointer to the table\r
902 //\r
903 AcpiTableInstance->Dsdt1 = (EFI_ACPI_DESCRIPTION_HEADER *) CurrentTableList->Table;\r
904\r
905 //\r
906 // If FADT already exists, update table pointers.\r
907 //\r
908 if (AcpiTableInstance->Fadt1 != NULL) {\r
909 AcpiTableInstance->Fadt1->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt1;\r
910\r
911 //\r
912 // Checksum FADT table\r
913 //\r
914 AcpiPlatformChecksum (\r
915 AcpiTableInstance->Fadt1,\r
916 AcpiTableInstance->Fadt1->Header.Length,\r
917 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
918 Checksum)\r
919 );\r
920 }\r
921 }\r
922 \r
923 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
924 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
925 //\r
926 // Save a pointer to the table\r
927 //\r
928 AcpiTableInstance->Dsdt3 = (EFI_ACPI_DESCRIPTION_HEADER *) CurrentTableList->Table;\r
929\r
930 //\r
931 // If FADT already exists, update table pointers.\r
932 //\r
933 if (AcpiTableInstance->Fadt3 != NULL) {\r
934 AcpiTableInstance->Fadt3->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt3;\r
935 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Dsdt3;\r
936 CopyMem (\r
937 &AcpiTableInstance->Fadt3->XDsdt,\r
938 &Buffer64,\r
939 sizeof (UINT64)\r
940 );\r
941\r
942 //\r
943 // Checksum FADT table\r
944 //\r
945 AcpiPlatformChecksum (\r
946 AcpiTableInstance->Fadt3,\r
947 AcpiTableInstance->Fadt3->Header.Length,\r
948 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
949 Checksum)\r
950 );\r
951 }\r
952 } \r
953 //\r
954 // Checksum the table\r
955 //\r
956 if (Checksum) {\r
957 AcpiPlatformChecksum (\r
958 CurrentTableList->Table,\r
959 CurrentTableList->Table->Length,\r
960 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
961 Checksum)\r
962 );\r
963 }\r
964 break;\r
965\r
966 default:\r
967 //\r
968 // Checksum the table\r
969 //\r
970 if (Checksum) {\r
971 AcpiPlatformChecksum (\r
972 CurrentTableList->Table,\r
973 CurrentTableList->Table->Length,\r
974 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
975 Checksum)\r
976 );\r
977 }\r
978 break;\r
979 }\r
980 //\r
981 // Add the table to the current list of tables\r
982 //\r
983 InsertTailList (&AcpiTableInstance->TableList, &CurrentTableList->Link);\r
984\r
985 //\r
986 // Add the table to RSDT and/or XSDT table entry lists.\r
987 //\r
988 //\r
989 // Add to ACPI 1.0b table tree\r
990 //\r
991 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
5f55c700 992 if (AddToRsdt) {\r
993 //\r
da935a5c 994 // If the table number exceed the gEfiAcpiMaxNumTables, enlarge the table buffer\r
5f55c700 995 //\r
da935a5c 996 if (AcpiTableInstance->NumberOfTableEntries1 >= mEfiAcpiMaxNumTables) {\r
997 Status = ReallocateAcpiTableBuffer (AcpiTableInstance);\r
998 ASSERT_EFI_ERROR (Status);\r
999 }\r
5f55c700 1000 CurrentRsdtEntry = (UINT32 *)\r
1001 (\r
da935a5c 1002 (UINT8 *) AcpiTableInstance->Rsdt1 +\r
5f55c700 1003 sizeof (EFI_ACPI_DESCRIPTION_HEADER) +\r
da935a5c 1004 AcpiTableInstance->NumberOfTableEntries1 *\r
5f55c700 1005 sizeof (UINT32)\r
1006 );\r
1007\r
1008 //\r
da935a5c 1009 // Add entry to the RSDT unless its the FACS or DSDT\r
5f55c700 1010 //\r
1011 *CurrentRsdtEntry = (UINT32) (UINTN) CurrentTableList->Table;\r
1012\r
1013 //\r
1014 // Update RSDT length\r
1015 //\r
da935a5c 1016 AcpiTableInstance->Rsdt1->Length = AcpiTableInstance->Rsdt1->Length + sizeof (UINT32);\r
5f55c700 1017\r
da935a5c 1018 AcpiTableInstance->NumberOfTableEntries1++;\r
1019 }\r
1020 }\r
1021 //\r
1022 // Add to ACPI 2.0/3.0 table tree\r
1023 //\r
1024 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1025 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1026 if (AddToRsdt) {\r
1027 //\r
1028 // If the table number exceed the gEfiAcpiMaxNumTables, enlarge the table buffer\r
1029 //\r
1030 if (AcpiTableInstance->NumberOfTableEntries3 >= mEfiAcpiMaxNumTables) {\r
1031 Status = ReallocateAcpiTableBuffer (AcpiTableInstance);\r
1032 ASSERT_EFI_ERROR (Status);\r
1033 }\r
1034 //\r
1035 // At this time, it is assumed that RSDT and XSDT maintain parallel lists of tables.\r
1036 // If it becomes necessary to maintain separate table lists, changes will be required.\r
1037 //\r
1038 CurrentRsdtEntry = (UINT32 *)\r
1039 (\r
1040 (UINT8 *) AcpiTableInstance->Rsdt3 +\r
1041 sizeof (EFI_ACPI_DESCRIPTION_HEADER) +\r
1042 AcpiTableInstance->NumberOfTableEntries3 *\r
1043 sizeof (UINT32)\r
1044 );\r
1045\r
1046 //\r
1047 // This pointer must not be directly dereferenced as the XSDT entries may not\r
1048 // be 64 bit aligned resulting in a possible fault. Use CopyMem to update.\r
1049 //\r
1050 CurrentXsdtEntry = (VOID *)\r
1051 (\r
1052 (UINT8 *) AcpiTableInstance->Xsdt +\r
1053 sizeof (EFI_ACPI_DESCRIPTION_HEADER) +\r
1054 AcpiTableInstance->NumberOfTableEntries3 *\r
1055 sizeof (UINT64)\r
1056 );\r
1057\r
1058 //\r
1059 // Add entry to the RSDT\r
1060 //\r
1061 *CurrentRsdtEntry = (UINT32) (UINTN) CurrentTableList->Table;\r
1062\r
1063 //\r
1064 // Update RSDT length\r
1065 //\r
1066 AcpiTableInstance->Rsdt3->Length = AcpiTableInstance->Rsdt3->Length + sizeof (UINT32);\r
1067\r
1068 //\r
1069 // Add entry to XSDT, XSDT expects 64 bit pointers, but\r
1070 // the table pointers in XSDT are not aligned on 8 byte boundary.\r
1071 //\r
1072 Buffer64 = (UINT64) (UINTN) CurrentTableList->Table;\r
1073 CopyMem (\r
1074 CurrentXsdtEntry,\r
1075 &Buffer64,\r
1076 sizeof (UINT64)\r
1077 );\r
1078\r
1079 //\r
1080 // Update length\r
1081 //\r
1082 AcpiTableInstance->Xsdt->Length = AcpiTableInstance->Xsdt->Length + sizeof (UINT64);\r
1083\r
1084 AcpiTableInstance->NumberOfTableEntries3++;\r
5f55c700 1085 }\r
5f55c700 1086 }\r
1087\r
1088 ChecksumCommonTables (AcpiTableInstance);\r
1089 return EFI_SUCCESS;\r
1090}\r
1091\r
1092\r
1093/**\r
1094 This function finds the table specified by the handle and returns a pointer to it.\r
1095 If the handle is not found, EFI_NOT_FOUND is returned and the contents of Table are\r
1096 undefined.\r
1097\r
1098 @param Handle Table to find.\r
1099 @param TableList Table list to search\r
1100 @param Table Pointer to table found. \r
1101\r
1102 @return EFI_SUCCESS The function completed successfully.\r
1103 @return EFI_NOT_FOUND No table found matching the handle specified.\r
1104\r
1105**/\r
1106EFI_STATUS\r
1107FindTableByHandle (\r
1108 IN UINTN Handle,\r
1109 IN LIST_ENTRY *TableList,\r
1110 OUT EFI_ACPI_TABLE_LIST **Table\r
1111 )\r
1112{\r
1113 LIST_ENTRY *CurrentLink;\r
1114 EFI_ACPI_TABLE_LIST *CurrentTable;\r
1115\r
1116 //\r
1117 // Check for invalid input parameters\r
1118 //\r
1119 ASSERT (Table);\r
1120\r
1121 //\r
1122 // Find the table\r
1123 //\r
1124 CurrentLink = TableList->ForwardLink;\r
1125\r
1126 while (CurrentLink != TableList) {\r
1127 CurrentTable = EFI_ACPI_TABLE_LIST_FROM_LINK (CurrentLink);\r
1128 if (CurrentTable->Handle == Handle) {\r
1129 //\r
1130 // Found handle, so return this table.\r
1131 //\r
1132 *Table = CurrentTable;\r
1133 return EFI_SUCCESS;\r
1134 }\r
1135\r
1136 CurrentLink = CurrentLink->ForwardLink;\r
1137 }\r
1138 //\r
1139 // Table not found\r
1140 //\r
1141 return EFI_NOT_FOUND;\r
1142}\r
1143\r
1144\r
1145/**\r
1146 This function removes a basic table from the RSDT and/or XSDT.\r
1147 For Acpi 1.0 tables, pass in the Rsdt.\r
1148 For Acpi 2.0 tables, pass in both Rsdt and Xsdt.\r
1149\r
1150 @param Table Pointer to table found. \r
1151 @param NumberOfTableEntries Current number of table entries in the RSDT/XSDT\r
1152 @param Rsdt Pointer to the RSDT to remove from\r
1153 @param Xsdt Pointer to the Xsdt to remove from\r
1154\r
1155 @return EFI_SUCCESS The function completed successfully.\r
1156 @return EFI_INVALID_PARAMETER The table was not found in both Rsdt and Xsdt.\r
1157\r
1158**/\r
1159EFI_STATUS\r
1160RemoveTableFromRsdt (\r
1161 IN OUT EFI_ACPI_TABLE_LIST * Table,\r
1162 IN OUT UINTN *NumberOfTableEntries,\r
1163 IN OUT EFI_ACPI_DESCRIPTION_HEADER * Rsdt,\r
1164 IN OUT EFI_ACPI_DESCRIPTION_HEADER * Xsdt OPTIONAL\r
1165 )\r
1166{\r
1167 UINT32 *CurrentRsdtEntry;\r
1168 VOID *CurrentXsdtEntry;\r
1169 UINT64 CurrentTablePointer64;\r
1170 UINTN Index;\r
1171\r
1172 //\r
1173 // Check for invalid input parameters\r
1174 //\r
1175 ASSERT (Table);\r
1176 ASSERT (NumberOfTableEntries);\r
1177 ASSERT (Rsdt);\r
1178\r
1179 //\r
1180 // Find the table entry in the RSDT and XSDT\r
1181 //\r
1182 for (Index = 0; Index < *NumberOfTableEntries; Index++) {\r
1183 //\r
1184 // At this time, it is assumed that RSDT and XSDT maintain parallel lists of tables.\r
1185 // If it becomes necessary to maintain separate table lists, changes will be required.\r
1186 //\r
1187 CurrentRsdtEntry = (UINT32 *) ((UINT8 *) Rsdt + sizeof (EFI_ACPI_DESCRIPTION_HEADER) + Index * sizeof (UINT32));\r
1188 if (Xsdt != NULL) {\r
1189 //\r
1190 // This pointer must not be directly dereferenced as the XSDT entries may not\r
1191 // be 64 bit aligned resulting in a possible fault. Use CopyMem to update.\r
1192 //\r
1193 CurrentXsdtEntry = (VOID *) ((UINT8 *) Xsdt + sizeof (EFI_ACPI_DESCRIPTION_HEADER) + Index * sizeof (UINT64));\r
1194\r
1195 //\r
1196 // Read the entry value out of the XSDT\r
1197 //\r
1198 CopyMem (&CurrentTablePointer64, CurrentXsdtEntry, sizeof (UINT64));\r
1199 } else {\r
1200 //\r
1201 // Initialize to NULL\r
1202 //\r
1203 CurrentXsdtEntry = 0;\r
1204 CurrentTablePointer64 = 0;\r
1205 }\r
1206 //\r
1207 // Check if we have found the corresponding entry in both RSDT and XSDT\r
1208 //\r
1209 if (*CurrentRsdtEntry == (UINT32) (UINTN) Table->Table &&\r
1210 ((Xsdt == NULL) || CurrentTablePointer64 == (UINT64) (UINTN) Table->Table)\r
1211 ) {\r
1212 //\r
1213 // Found entry, so copy all following entries and shrink table\r
1214 // We actually copy all + 1 to copy the initialized value of memory over\r
1215 // the last entry.\r
1216 //\r
1217 CopyMem (CurrentRsdtEntry, CurrentRsdtEntry + 1, (*NumberOfTableEntries - Index) * sizeof (UINT32));\r
1218 Rsdt->Length = Rsdt->Length - sizeof (UINT32);\r
1219 if (Xsdt != NULL) {\r
1220 CopyMem (CurrentXsdtEntry, ((UINT64 *) CurrentXsdtEntry) + 1, (*NumberOfTableEntries - Index) * sizeof (UINT64));\r
1221 Xsdt->Length = Xsdt->Length - sizeof (UINT64);\r
1222 }\r
1223 break;\r
1224 } else if (Index + 1 == *NumberOfTableEntries) {\r
1225 //\r
1226 // At the last entry, and table not found\r
1227 //\r
1228 return EFI_INVALID_PARAMETER;\r
1229 }\r
1230 }\r
1231 //\r
1232 // Checksum the tables\r
1233 //\r
1234 AcpiPlatformChecksum (\r
1235 Rsdt,\r
1236 Rsdt->Length,\r
1237 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1238 Checksum)\r
1239 );\r
1240\r
1241 if (Xsdt != NULL) {\r
1242 AcpiPlatformChecksum (\r
1243 Xsdt,\r
1244 Xsdt->Length,\r
1245 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1246 Checksum)\r
1247 );\r
1248 }\r
1249 //\r
1250 // Decrement the number of tables\r
1251 //\r
1252 (*NumberOfTableEntries)--;\r
1253\r
1254 return EFI_SUCCESS;\r
1255}\r
1256\r
1257\r
1258/**\r
1259 This function removes a table and frees any associated memory.\r
1260\r
1261 @param AcpiTableInstance Instance of the protocol.\r
1262 @param Version Version(s) to delete.\r
1263 @param Table Pointer to table found.\r
1264\r
1265 @return EFI_SUCCESS The function completed successfully.\r
1266\r
1267**/\r
1268EFI_STATUS\r
1269DeleteTable (\r
1270 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
1271 IN EFI_ACPI_TABLE_VERSION Version,\r
1272 IN OUT EFI_ACPI_TABLE_LIST *Table\r
1273 )\r
1274{\r
1275 UINT32 CurrentTableSignature;\r
1276 BOOLEAN RemoveFromRsdt;\r
1277\r
1278 //\r
1279 // Check for invalid input parameters\r
1280 //\r
1281 ASSERT (AcpiTableInstance);\r
1282 ASSERT (Table);\r
1283\r
1284 //\r
1285 // Init locals\r
1286 //\r
1287 RemoveFromRsdt = TRUE;\r
6198c346 1288 //\r
1289 // Check for Table->Table\r
1290 //\r
1291 ASSERT (Table->Table != NULL);\r
5f55c700 1292 CurrentTableSignature = ((EFI_ACPI_COMMON_HEADER *) Table->Table)->Signature;\r
1293\r
1294 //\r
1295 // Basic tasks to accomplish delete are:\r
1296 // Determine removal requirements (in RSDT/XSDT or not)\r
1297 // Remove entry from RSDT/XSDT\r
1298 // Remove any table references to the table\r
1299 // If no one is using the table\r
1300 // Free the table (removing pointers from private data and tables)\r
1301 // Remove from list\r
1302 // Free list structure\r
1303 //\r
1304 //\r
1305 // Determine if this table is in the RSDT or XSDT\r
1306 //\r
1307 if ((CurrentTableSignature == EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE) ||\r
1308 (CurrentTableSignature == EFI_ACPI_2_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) ||\r
1309 (CurrentTableSignature == EFI_ACPI_3_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE)\r
1310 ) {\r
1311 RemoveFromRsdt = FALSE;\r
1312 }\r
1313 //\r
1314 // We don't remove the FADT in the standard way because some\r
1315 // OS expect the FADT to be early in the table list.\r
1316 // So we always put it as the first element in the list.\r
1317 //\r
1318 if (CurrentTableSignature == EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE) {\r
1319 RemoveFromRsdt = FALSE;\r
1320 }\r
1321\r
1322 //\r
1323 // Remove the table from RSDT and XSDT\r
1324 //\r
1325 if (Table->Table != NULL) {\r
1326 //\r
1327 // This is a basic table, remove it from any lists and the Rsdt and/or Xsdt\r
1328 //\r
1329 if (Version & EFI_ACPI_TABLE_VERSION_NONE & Table->Version) {\r
1330 //\r
1331 // Remove this version from the table\r
1332 //\r
1333 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_NONE;\r
1334 }\r
1335\r
1336 if (Version & EFI_ACPI_TABLE_VERSION_1_0B & Table->Version) {\r
1337 //\r
1338 // Remove this version from the table\r
1339 //\r
1340 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_1_0B;\r
1341\r
1342 //\r
1343 // Remove from Rsdt. We don't care about the return value because it is\r
1344 // acceptable for the table to not exist in Rsdt.\r
1345 // We didn't add some tables so we don't remove them.\r
1346 //\r
1347 if (RemoveFromRsdt) {\r
1348 RemoveTableFromRsdt (\r
1349 Table,\r
1350 &AcpiTableInstance->NumberOfTableEntries1,\r
1351 AcpiTableInstance->Rsdt1,\r
1352 NULL\r
1353 );\r
1354 }\r
1355 }\r
1356\r
1357 if ((Version & EFI_ACPI_TABLE_VERSION_2_0 & Table->Version) ||\r
1358 (Version & EFI_ACPI_TABLE_VERSION_3_0 & Table->Version)) {\r
1359 //\r
1360 // Remove this version from the table\r
1361 //\r
1362 if (Version & EFI_ACPI_TABLE_VERSION_2_0 & Table->Version) {\r
1363 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_2_0;\r
1364 } \r
1365 if (Version & EFI_ACPI_TABLE_VERSION_3_0 & Table->Version) {\r
1366 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_3_0;\r
1367 }\r
1368 \r
1369 //\r
1370 // Remove from Rsdt and Xsdt. We don't care about the return value\r
1371 // because it is acceptable for the table to not exist in Rsdt/Xsdt.\r
1372 // We didn't add some tables so we don't remove them.\r
1373 //\r
1374 if (RemoveFromRsdt) {\r
1375 RemoveTableFromRsdt (\r
1376 Table,\r
1377 &AcpiTableInstance->NumberOfTableEntries3,\r
1378 AcpiTableInstance->Rsdt3,\r
1379 AcpiTableInstance->Xsdt\r
1380 );\r
1381 }\r
1382 } \r
1383 //\r
1384 // Free the table, clean up any dependent tables and our private data pointers.\r
1385 //\r
1386 switch (Table->Table->Signature) {\r
1387\r
1388 case EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE:\r
1389 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
1390 AcpiTableInstance->Fadt1 = NULL;\r
1391 }\r
1392\r
1393 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1394 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1395 AcpiTableInstance->Fadt3 = NULL;\r
1396 }\r
1397 break;\r
1398\r
1399 case EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE:\r
1400 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
1401 AcpiTableInstance->Facs1 = NULL;\r
1402\r
1403 //\r
1404 // Update FADT table pointers\r
1405 //\r
1406 if (AcpiTableInstance->Fadt1 != NULL) {\r
1407 AcpiTableInstance->Fadt1->FirmwareCtrl = 0;\r
1408\r
1409 //\r
1410 // Checksum table\r
1411 //\r
1412 AcpiPlatformChecksum (\r
1413 AcpiTableInstance->Fadt1,\r
1414 AcpiTableInstance->Fadt1->Header.Length,\r
1415 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1416 Checksum)\r
1417 );\r
1418 }\r
1419 }\r
1420\r
1421 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1422 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1423 AcpiTableInstance->Facs3 = NULL;\r
1424\r
1425 //\r
1426 // Update FADT table pointers\r
1427 //\r
1428 if (AcpiTableInstance->Fadt3 != NULL) {\r
1429 AcpiTableInstance->Fadt3->FirmwareCtrl = 0;\r
1430 ZeroMem (&AcpiTableInstance->Fadt3->XFirmwareCtrl, sizeof (UINT64));\r
1431\r
1432 //\r
1433 // Checksum table\r
1434 //\r
1435 AcpiPlatformChecksum (\r
1436 AcpiTableInstance->Fadt3,\r
1437 AcpiTableInstance->Fadt3->Header.Length,\r
1438 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1439 Checksum)\r
1440 );\r
1441 }\r
1442 } \r
1443 break;\r
1444\r
1445 case EFI_ACPI_3_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE:\r
1446 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
1447 AcpiTableInstance->Dsdt1 = NULL;\r
1448\r
1449 //\r
1450 // Update FADT table pointers\r
1451 //\r
1452 if (AcpiTableInstance->Fadt1 != NULL) {\r
1453 AcpiTableInstance->Fadt1->Dsdt = 0;\r
1454\r
1455 //\r
1456 // Checksum table\r
1457 //\r
1458 AcpiPlatformChecksum (\r
1459 AcpiTableInstance->Fadt1,\r
1460 AcpiTableInstance->Fadt1->Header.Length,\r
1461 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1462 Checksum)\r
1463 );\r
1464 }\r
1465 }\r
1466\r
1467 \r
1468 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1469 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1470 AcpiTableInstance->Dsdt3 = NULL;\r
1471\r
1472 //\r
1473 // Update FADT table pointers\r
1474 //\r
1475 if (AcpiTableInstance->Fadt3 != NULL) {\r
1476 AcpiTableInstance->Fadt3->Dsdt = 0;\r
1477 ZeroMem (&AcpiTableInstance->Fadt3->XDsdt, sizeof (UINT64));\r
1478\r
1479 //\r
1480 // Checksum table\r
1481 //\r
1482 AcpiPlatformChecksum (\r
1483 AcpiTableInstance->Fadt3,\r
1484 AcpiTableInstance->Fadt3->Header.Length,\r
1485 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1486 Checksum)\r
1487 );\r
1488 }\r
1489 }\r
1490 break;\r
1491\r
1492 default:\r
1493 //\r
1494 // Do nothing\r
1495 //\r
1496 break;\r
1497 }\r
1498 }\r
1499 //\r
1500 // If no version is using this table anymore, remove and free list entry.\r
1501 //\r
1502 if (Table->Version == 0) {\r
1503 //\r
1504 // Free the Table\r
1505 //\r
1506 gBS->FreePages (Table->PageAddress, Table->NumberOfPages);\r
1507 RemoveEntryList (&(Table->Link));\r
1508 gBS->FreePool (Table);\r
1509 }\r
1510 //\r
1511 // Done\r
1512 //\r
1513 return EFI_SUCCESS;\r
1514}\r
1515\r
1516\r
1517/**\r
1518 This function finds and removes the table specified by the handle.\r
1519\r
1520 @param AcpiTableInstance Instance of the protocol.\r
1521 @param Version Bitmask of which versions to remove.\r
1522 @param Handle Table to remove.\r
1523\r
1524 @return EFI_SUCCESS The function completed successfully.\r
1525 @return EFI_ABORTED An error occurred.\r
1526 @return EFI_NOT_FOUND Handle not found in table list.\r
1527\r
1528**/\r
1529EFI_STATUS\r
1530RemoveTableFromList (\r
1531 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
1532 IN EFI_ACPI_TABLE_VERSION Version,\r
1533 IN UINTN Handle\r
1534 )\r
1535{\r
1536 EFI_ACPI_TABLE_LIST *Table;\r
1537 EFI_STATUS Status;\r
1538\r
b474ed49 1539 Table = (EFI_ACPI_TABLE_LIST*) NULL;\r
1540\r
5f55c700 1541 //\r
1542 // Check for invalid input parameters\r
1543 //\r
1544 ASSERT (AcpiTableInstance);\r
1545\r
1546 //\r
1547 // Find the table\r
1548 //\r
1549 Status = FindTableByHandle (\r
1550 Handle,\r
1551 &AcpiTableInstance->TableList,\r
1552 &Table\r
1553 );\r
1554 if (EFI_ERROR (Status)) {\r
1555 return EFI_NOT_FOUND;\r
1556 }\r
1557 //\r
1558 // Remove the table\r
1559 //\r
1560 Status = DeleteTable (AcpiTableInstance, Version, Table);\r
1561 if (EFI_ERROR (Status)) {\r
1562 return EFI_ABORTED;\r
1563 }\r
1564 //\r
1565 // Completed successfully\r
1566 //\r
1567 return EFI_SUCCESS;\r
1568}\r
1569\r
1570\r
1571/**\r
1572 This function calculates and updates an UINT8 checksum.\r
1573\r
1574 @param Buffer Pointer to buffer to checksum\r
1575 @param Size Number of bytes to checksum\r
1576 @param ChecksumOffset Offset to place the checksum result in\r
1577\r
1578 @return EFI_SUCCESS The function completed successfully.\r
1579\r
1580**/\r
1581EFI_STATUS\r
1582AcpiPlatformChecksum (\r
1583 IN VOID *Buffer,\r
1584 IN UINTN Size,\r
1585 IN UINTN ChecksumOffset\r
1586 )\r
1587{\r
1588 UINT8 Sum;\r
1589 UINT8 *Ptr;\r
1590\r
1591 Sum = 0;\r
1592 //\r
1593 // Initialize pointer\r
1594 //\r
1595 Ptr = Buffer;\r
1596\r
1597 //\r
1598 // set checksum to 0 first\r
1599 //\r
1600 Ptr[ChecksumOffset] = 0;\r
1601\r
1602 //\r
1603 // add all content of buffer\r
1604 //\r
1605 while ((Size--) != 0) {\r
1606 Sum = (UINT8) (Sum + (*Ptr++));\r
1607 }\r
1608 //\r
1609 // set checksum\r
1610 //\r
1611 Ptr = Buffer;\r
1612 Ptr[ChecksumOffset] = (UINT8) (0xff - Sum + 1);\r
1613\r
1614 return EFI_SUCCESS;\r
1615}\r
1616\r
1617\r
1618/**\r
1619 Checksum all versions of the common tables, RSDP, RSDT, XSDT.\r
1620\r
1621 @param AcpiTableInstance Protocol instance private data.\r
1622\r
1623 @return EFI_SUCCESS The function completed successfully.\r
1624\r
1625**/\r
1626EFI_STATUS\r
1627ChecksumCommonTables (\r
1628 IN OUT EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
1629 )\r
1630{\r
1631 //\r
1632 // RSDP ACPI 1.0 checksum for 1.0 table. This is only the first 20 bytes of the structure\r
1633 //\r
1634 AcpiPlatformChecksum (\r
1635 AcpiTableInstance->Rsdp1,\r
1636 sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER),\r
1637 OFFSET_OF (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER,\r
1638 Checksum)\r
1639 );\r
1640\r
1641 //\r
1642 // RSDP ACPI 1.0 checksum for 2.0/3.0 table. This is only the first 20 bytes of the structure\r
1643 //\r
1644 AcpiPlatformChecksum (\r
1645 AcpiTableInstance->Rsdp3,\r
1646 sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER),\r
1647 OFFSET_OF (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER,\r
1648 Checksum)\r
1649 );\r
1650\r
1651 //\r
1652 // RSDP ACPI 2.0/3.0 checksum, this is the entire table\r
1653 //\r
1654 AcpiPlatformChecksum (\r
1655 AcpiTableInstance->Rsdp3,\r
1656 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER),\r
1657 OFFSET_OF (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER,\r
1658 ExtendedChecksum)\r
1659 );\r
1660\r
1661 //\r
1662 // RSDT checksums\r
1663 //\r
1664 AcpiPlatformChecksum (\r
1665 AcpiTableInstance->Rsdt1,\r
1666 AcpiTableInstance->Rsdt1->Length,\r
1667 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1668 Checksum)\r
1669 );\r
1670\r
1671 AcpiPlatformChecksum (\r
1672 AcpiTableInstance->Rsdt3,\r
1673 AcpiTableInstance->Rsdt3->Length,\r
1674 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1675 Checksum)\r
1676 );\r
1677\r
1678 //\r
1679 // XSDT checksum\r
1680 //\r
1681 AcpiPlatformChecksum (\r
1682 AcpiTableInstance->Xsdt,\r
1683 AcpiTableInstance->Xsdt->Length,\r
1684 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1685 Checksum)\r
1686 );\r
1687 \r
1688 return EFI_SUCCESS;\r
1689}\r
1690\r
1691\r
1692/**\r
1693 Constructor for the ACPI table protocol. Initializes instance\r
1694 data.\r
1695\r
1696 @param AcpiTableInstance Instance to construct\r
1697\r
1698 @return EFI_SUCCESS Instance initialized.\r
1699 @return EFI_OUT_OF_RESOURCES Unable to allocate required resources.\r
1700\r
1701**/\r
1702EFI_STATUS\r
1703AcpiTableAcpiTableConstructor (\r
1704 EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
1705 )\r
1706{\r
1707 EFI_STATUS Status;\r
1708 UINT64 CurrentData;\r
1709 UINTN TotalSize;\r
1710 UINT8 *Pointer;\r
1711 EFI_PHYSICAL_ADDRESS PageAddress;\r
1712\r
1713 //\r
1714 // Check for invalid input parameters\r
1715 //\r
1716 ASSERT (AcpiTableInstance);\r
1717\r
1718 InitializeListHead (&AcpiTableInstance->TableList);\r
1719 AcpiTableInstance->CurrentHandle = 1;\r
1720\r
1721 AcpiTableInstance->AcpiTableProtocol.InstallAcpiTable = InstallAcpiTable;\r
1722 AcpiTableInstance->AcpiTableProtocol.UninstallAcpiTable = UninstallAcpiTable;\r
3dc8585e
JY
1723\r
1724 if (FeaturePcdGet (PcdInstallAcpiSdtProtocol)) {\r
1725 SdtAcpiTableAcpiSdtConstructor (AcpiTableInstance);\r
1726 }\r
1727\r
5f55c700 1728 //\r
1729 // Create RSDP, RSDT, XSDT structures\r
1730 // Allocate all buffers\r
1731 //\r
1732 TotalSize = sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
1733 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
1734 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 1.0 RSDT\r
da935a5c 1735 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
5f55c700 1736 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 RSDT\r
da935a5c 1737 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
5f55c700 1738 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 XSDT\r
da935a5c 1739 mEfiAcpiMaxNumTables * sizeof (UINT64);\r
5f55c700 1740\r
1741 //\r
1742 // Allocate memory in the lower 32 bit of address range for\r
1743 // compatibility with ACPI 1.0 OS.\r
1744 //\r
1745 // This is done because ACPI 1.0 pointers are 32 bit values.\r
1746 // ACPI 2.0 OS and all 64 bit OS must use the 64 bit ACPI table addresses.\r
1747 // There is no architectural reason these should be below 4GB, it is purely\r
1748 // for convenience of implementation that we force memory below 4GB.\r
1749 //\r
1750 PageAddress = 0xFFFFFFFF;\r
1751 Status = gBS->AllocatePages (\r
1752 AllocateMaxAddress,\r
1753 EfiACPIReclaimMemory,\r
1754 EFI_SIZE_TO_PAGES (TotalSize),\r
1755 &PageAddress\r
1756 );\r
1757\r
1758 if (EFI_ERROR (Status)) {\r
1759 return EFI_OUT_OF_RESOURCES;\r
1760 }\r
1761\r
1762 Pointer = (UINT8 *) (UINTN) PageAddress;\r
1763 ZeroMem (Pointer, TotalSize);\r
1764\r
1765 AcpiTableInstance->Rsdp1 = (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
1766 Pointer += sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
1767 AcpiTableInstance->Rsdp3 = (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
1768 Pointer += sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
1769\r
1770 AcpiTableInstance->Rsdt1 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
1771 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + EFI_ACPI_MAX_NUM_TABLES * sizeof (UINT32));\r
1772 AcpiTableInstance->Rsdt3 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
1773 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + EFI_ACPI_MAX_NUM_TABLES * sizeof (UINT32));\r
1774\r
1775 AcpiTableInstance->Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
1776\r
1777 //\r
1778 // Initialize RSDP\r
1779 //\r
1780 CurrentData = EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE;\r
1781 CopyMem (&AcpiTableInstance->Rsdp1->Signature, &CurrentData, sizeof (UINT64));\r
1782 CopyMem (AcpiTableInstance->Rsdp1->OemId, EFI_ACPI_OEM_ID, 6);\r
1783 AcpiTableInstance->Rsdp1->Reserved = EFI_ACPI_RESERVED_BYTE;\r
1784 AcpiTableInstance->Rsdp1->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt1;\r
1785\r
1786 CurrentData = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE;\r
1787 CopyMem (&AcpiTableInstance->Rsdp3->Signature, &CurrentData, sizeof (UINT64));\r
1788 CopyMem (AcpiTableInstance->Rsdp3->OemId, EFI_ACPI_OEM_ID, 6);\r
1789 AcpiTableInstance->Rsdp3->Revision = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION;\r
1790 AcpiTableInstance->Rsdp3->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt3;\r
1791 AcpiTableInstance->Rsdp3->Length = sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
1792 CurrentData = (UINT64) (UINTN) AcpiTableInstance->Xsdt;\r
1793 CopyMem (&AcpiTableInstance->Rsdp3->XsdtAddress, &CurrentData, sizeof (UINT64));\r
1794 SetMem (AcpiTableInstance->Rsdp3->Reserved, 3, EFI_ACPI_RESERVED_BYTE);\r
1795\r
1796 //\r
1797 // Initialize Rsdt\r
1798 //\r
1799 // Note that we "reserve" one entry for the FADT so it can always be\r
1800 // at the beginning of the list of tables. Some OS don't seem\r
1801 // to find it correctly if it is too far down the list.\r
1802 //\r
1803 AcpiTableInstance->Rsdt1->Signature = EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE;\r
1804 AcpiTableInstance->Rsdt1->Length = sizeof (EFI_ACPI_DESCRIPTION_HEADER);\r
1805 AcpiTableInstance->Rsdt1->Revision = EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION;\r
1806 CopyMem (AcpiTableInstance->Rsdt1->OemId, EFI_ACPI_OEM_ID, 6);\r
1807 CurrentData = EFI_ACPI_OEM_TABLE_ID;\r
1808 CopyMem (&AcpiTableInstance->Rsdt1->OemTableId, &CurrentData, sizeof (UINT64));\r
1809 AcpiTableInstance->Rsdt1->OemRevision = EFI_ACPI_OEM_REVISION;\r
1810 AcpiTableInstance->Rsdt1->CreatorId = EFI_ACPI_CREATOR_ID;\r
1811 AcpiTableInstance->Rsdt1->CreatorRevision = EFI_ACPI_CREATOR_REVISION;\r
1812 //\r
1813 // We always reserve first one for FADT\r
1814 //\r
1815 AcpiTableInstance->NumberOfTableEntries1 = 1;\r
1816 AcpiTableInstance->Rsdt1->Length = AcpiTableInstance->Rsdt1->Length + sizeof(UINT32);\r
1817\r
1818 AcpiTableInstance->Rsdt3->Signature = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE;\r
1819 AcpiTableInstance->Rsdt3->Length = sizeof (EFI_ACPI_DESCRIPTION_HEADER);\r
1820 AcpiTableInstance->Rsdt3->Revision = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION;\r
1821 CopyMem (AcpiTableInstance->Rsdt3->OemId, EFI_ACPI_OEM_ID, 6);\r
1822 CurrentData = EFI_ACPI_OEM_TABLE_ID;\r
1823 CopyMem (&AcpiTableInstance->Rsdt3->OemTableId, &CurrentData, sizeof (UINT64));\r
1824 AcpiTableInstance->Rsdt3->OemRevision = EFI_ACPI_OEM_REVISION;\r
1825 AcpiTableInstance->Rsdt3->CreatorId = EFI_ACPI_CREATOR_ID;\r
1826 AcpiTableInstance->Rsdt3->CreatorRevision = EFI_ACPI_CREATOR_REVISION;\r
1827 //\r
1828 // We always reserve first one for FADT\r
1829 //\r
1830 AcpiTableInstance->NumberOfTableEntries3 = 1;\r
1831 AcpiTableInstance->Rsdt3->Length = AcpiTableInstance->Rsdt3->Length + sizeof(UINT32);\r
1832\r
1833 //\r
1834 // Initialize Xsdt\r
1835 //\r
1836 AcpiTableInstance->Xsdt->Signature = EFI_ACPI_3_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE;\r
1837 AcpiTableInstance->Xsdt->Length = sizeof (EFI_ACPI_DESCRIPTION_HEADER);\r
1838 AcpiTableInstance->Xsdt->Revision = EFI_ACPI_3_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION;\r
1839 CopyMem (AcpiTableInstance->Xsdt->OemId, EFI_ACPI_OEM_ID, 6);\r
1840 CurrentData = EFI_ACPI_OEM_TABLE_ID;\r
1841 CopyMem (&AcpiTableInstance->Xsdt->OemTableId, &CurrentData, sizeof (UINT64));\r
1842 AcpiTableInstance->Xsdt->OemRevision = EFI_ACPI_OEM_REVISION;\r
1843 AcpiTableInstance->Xsdt->CreatorId = EFI_ACPI_CREATOR_ID;\r
1844 AcpiTableInstance->Xsdt->CreatorRevision = EFI_ACPI_CREATOR_REVISION;\r
1845 //\r
1846 // We always reserve first one for FADT\r
1847 //\r
1848 AcpiTableInstance->Xsdt->Length = AcpiTableInstance->Xsdt->Length + sizeof(UINT64);\r
1849\r
1850 ChecksumCommonTables (AcpiTableInstance);\r
1851\r
1852 //\r
1853 // Completed successfully\r
1854 //\r
1855 return EFI_SUCCESS;\r
1856}\r
1857\r