]> git.proxmox.com Git - mirror_edk2.git/blame - MdeModulePkg/Universal/Acpi/AcpiTableDxe/AcpiTableProtocol.c
Small code refinement in 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
360 return Status;\r
361}\r
362\r
363\r
364/**\r
365 Removes an ACPI table from the RSDT/XSDT.\r
366\r
367 @param This Protocol instance pointer.\r
368 @param TableKey Specifies the table to uninstall. The key was returned from InstallAcpiTable().\r
369\r
370 @return EFI_SUCCESS The table was successfully uninstalled.\r
371 @return EFI_NOT_FOUND TableKey does not refer to a valid key for a table entry.\r
372\r
373**/\r
374EFI_STATUS\r
375EFIAPI\r
376UninstallAcpiTable (\r
377 IN CONST EFI_ACPI_TABLE_PROTOCOL *This,\r
378 IN UINTN TableKey\r
379 )\r
380{\r
381 EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance;\r
382 EFI_STATUS Status;\r
383\r
384 //\r
385 // Get the instance of the ACPI table protocol\r
386 //\r
387 AcpiTableInstance = EFI_ACPI_TABLE_INSTANCE_FROM_THIS (This);\r
388\r
389 //\r
390 // Uninstall the ACPI table\r
391 //\r
392 Status = SetAcpiTable (\r
393 AcpiTableInstance,\r
394 NULL,\r
395 FALSE,\r
46a989f7 396 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0,\r
5f55c700 397 &TableKey\r
398 );\r
399 if (!EFI_ERROR (Status)) {\r
400 Status = PublishTables (\r
401 AcpiTableInstance,\r
46a989f7 402 EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0\r
5f55c700 403 );\r
404 }\r
405\r
406 if (EFI_ERROR (Status)) {\r
407 return EFI_NOT_FOUND;\r
408 } else {\r
409 return EFI_SUCCESS;\r
410 }\r
411}\r
412\r
da935a5c 413/**\r
414 If the number of APCI tables exceeds the preallocated max table number, enlarge the table buffer.\r
415\r
416 @param AcpiTableInstance ACPI table protocol instance data structure.\r
417\r
418 @return EFI_SUCCESS reallocate the table beffer successfully.\r
419 @return EFI_OUT_OF_RESOURCES Unable to allocate required resources.\r
420\r
421**/\r
422EFI_STATUS\r
423ReallocateAcpiTableBuffer (\r
424 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
425 )\r
426{\r
427 UINTN NewMaxTableNumber;\r
428 UINTN TotalSize;\r
429 UINT8 *Pointer;\r
430 EFI_PHYSICAL_ADDRESS PageAddress;\r
431 EFI_ACPI_TABLE_INSTANCE TempPrivateData;\r
432 EFI_STATUS Status;\r
433 UINT64 CurrentData;\r
434 \r
435 CopyMem (&TempPrivateData, AcpiTableInstance, sizeof (EFI_ACPI_TABLE_INSTANCE)); \r
436 //\r
437 // Enlarge the max table number from mEfiAcpiMaxNumTables to mEfiAcpiMaxNumTables + EFI_ACPI_MAX_NUM_TABLES\r
438 //\r
439 NewMaxTableNumber = mEfiAcpiMaxNumTables + EFI_ACPI_MAX_NUM_TABLES;\r
440 //\r
441 // Create RSDP, RSDT, XSDT structures and allocate all buffers\r
442 //\r
443 TotalSize = sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
444 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
445 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 1.0 RSDT\r
446 NewMaxTableNumber * sizeof (UINT32) +\r
447 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 RSDT\r
448 NewMaxTableNumber * sizeof (UINT32) +\r
449 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 XSDT\r
450 NewMaxTableNumber * sizeof (UINT64);\r
451\r
452 //\r
453 // Allocate memory in the lower 32 bit of address range for\r
454 // compatibility with ACPI 1.0 OS.\r
455 //\r
456 // This is done because ACPI 1.0 pointers are 32 bit values.\r
457 // ACPI 2.0 OS and all 64 bit OS must use the 64 bit ACPI table addresses.\r
458 // There is no architectural reason these should be below 4GB, it is purely\r
459 // for convenience of implementation that we force memory below 4GB.\r
460 //\r
461 PageAddress = 0xFFFFFFFF;\r
462 Status = gBS->AllocatePages (\r
463 AllocateMaxAddress,\r
464 EfiACPIReclaimMemory,\r
465 EFI_SIZE_TO_PAGES (TotalSize),\r
466 &PageAddress\r
467 );\r
468\r
469 if (EFI_ERROR (Status)) {\r
470 return EFI_OUT_OF_RESOURCES;\r
471 }\r
472\r
473 Pointer = (UINT8 *) (UINTN) PageAddress;\r
474 ZeroMem (Pointer, TotalSize);\r
475 \r
476 AcpiTableInstance->Rsdp1 = (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
477 Pointer += sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
478 AcpiTableInstance->Rsdp3 = (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
479 Pointer += sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
480\r
481 AcpiTableInstance->Rsdt1 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
482 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + NewMaxTableNumber * sizeof (UINT32));\r
483 AcpiTableInstance->Rsdt3 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
484 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + NewMaxTableNumber * sizeof (UINT32));\r
485\r
486 AcpiTableInstance->Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
5f55c700 487\r
da935a5c 488 //\r
489 // Initialize RSDP\r
490 //\r
491 CopyMem (AcpiTableInstance->Rsdp1, TempPrivateData.Rsdp1, sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER)); \r
492 AcpiTableInstance->Rsdp1->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt1;\r
493 \r
494 CopyMem (AcpiTableInstance->Rsdp3, TempPrivateData.Rsdp3, sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER)); \r
495 AcpiTableInstance->Rsdp3->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt3;\r
496 CurrentData = (UINT64) (UINTN) AcpiTableInstance->Xsdt;\r
497 CopyMem (&AcpiTableInstance->Rsdp3->XsdtAddress, &CurrentData, sizeof (UINT64));\r
498\r
499 //\r
500 // copy the original Rsdt1, Rsdt3 and Xsdt structure to new buffer \r
501 //\r
502 CopyMem (AcpiTableInstance->Rsdt1, TempPrivateData.Rsdt1, (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + mEfiAcpiMaxNumTables * sizeof (UINT32))); \r
503 CopyMem (AcpiTableInstance->Rsdt3, TempPrivateData.Rsdt3, (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + mEfiAcpiMaxNumTables * sizeof (UINT32))); \r
504 CopyMem (AcpiTableInstance->Xsdt, TempPrivateData.Xsdt, (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + mEfiAcpiMaxNumTables * sizeof (UINT64)));\r
505 \r
506 //\r
507 // Calculate orignal ACPI table buffer size\r
508 //\r
509 TotalSize = sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
510 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
511 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 1.0 RSDT\r
512 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
513 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 RSDT\r
514 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
515 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 XSDT\r
516 mEfiAcpiMaxNumTables * sizeof (UINT64);\r
2432c685 517 gBS->FreePages ((EFI_PHYSICAL_ADDRESS)(UINTN)TempPrivateData.Rsdp1, EFI_SIZE_TO_PAGES (TotalSize));\r
da935a5c 518 \r
519 //\r
520 // Update the Max ACPI table number\r
521 // \r
522 mEfiAcpiMaxNumTables = NewMaxTableNumber;\r
523 return EFI_SUCCESS;\r
524}\r
5f55c700 525/**\r
526 This function adds an ACPI table to the table list. It will detect FACS and\r
527 allocate the correct type of memory and properly align the table.\r
528\r
529 @param AcpiTableInstance Instance of the protocol.\r
530 @param Table Table to add.\r
531 @param Checksum Does the table require checksumming.\r
532 @param Version The version of the list to add the table to.\r
533 @param Handle Pointer for returning the handle.\r
534\r
535 @return EFI_SUCCESS The function completed successfully.\r
536 @return EFI_OUT_OF_RESOURCES Could not allocate a required resource.\r
537 @return EFI_ABORTED The table is a duplicate of a table that is required\r
538 to be unique.\r
539\r
540**/\r
541EFI_STATUS\r
542AddTableToList (\r
543 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
544 IN VOID *Table,\r
545 IN BOOLEAN Checksum,\r
546 IN EFI_ACPI_TABLE_VERSION Version,\r
547 OUT UINTN *Handle\r
548 )\r
549{\r
550 EFI_STATUS Status;\r
551 EFI_ACPI_TABLE_LIST *CurrentTableList;\r
552 UINT32 CurrentTableSignature;\r
553 UINT32 CurrentTableSize;\r
554 UINT32 *CurrentRsdtEntry;\r
555 VOID *CurrentXsdtEntry;\r
556 UINT64 Buffer64;\r
557 BOOLEAN AddToRsdt;\r
558\r
559 //\r
560 // Check for invalid input parameters\r
561 //\r
562 ASSERT (AcpiTableInstance);\r
563 ASSERT (Table);\r
564 ASSERT (Handle);\r
565\r
566 //\r
567 // Init locals\r
568 //\r
569 AddToRsdt = TRUE;\r
570\r
571 //\r
572 // Create a new list entry\r
573 //\r
574 CurrentTableList = AllocatePool (sizeof (EFI_ACPI_TABLE_LIST));\r
575 ASSERT (CurrentTableList);\r
576\r
577 //\r
578 // Determine table type and size\r
579 //\r
580 CurrentTableSignature = ((EFI_ACPI_COMMON_HEADER *) Table)->Signature;\r
581 CurrentTableSize = ((EFI_ACPI_COMMON_HEADER *) Table)->Length;\r
582\r
583 //\r
584 // Allocate a buffer for the table. All tables are allocated in the lower 32 bits of address space\r
585 // for backwards compatibility with ACPI 1.0 OS.\r
586 //\r
587 // This is done because ACPI 1.0 pointers are 32 bit values.\r
588 // ACPI 2.0 OS and all 64 bit OS must use the 64 bit ACPI table addresses.\r
589 // There is no architectural reason these should be below 4GB, it is purely\r
590 // for convenience of implementation that we force memory below 4GB.\r
591 //\r
592 CurrentTableList->PageAddress = 0xFFFFFFFF;\r
593 CurrentTableList->NumberOfPages = EFI_SIZE_TO_PAGES (CurrentTableSize);\r
594\r
595 //\r
596 // Allocation memory type depends on the type of the table\r
597 //\r
598 if (CurrentTableSignature == EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE || \r
599 CurrentTableSignature == EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE) {\r
600 //\r
601 // Allocate memory for the FACS. This structure must be aligned\r
602 // on a 64 byte boundary and must be ACPI NVS memory.\r
603 // Using AllocatePages should ensure that it is always aligned.\r
604 //\r
605 ASSERT ((EFI_PAGE_SIZE % 64) == 0);\r
606 Status = gBS->AllocatePages (\r
607 AllocateMaxAddress,\r
608 EfiACPIMemoryNVS,\r
609 CurrentTableList->NumberOfPages,\r
610 &CurrentTableList->PageAddress\r
611 );\r
612 } else {\r
613 //\r
614 // All other tables are ACPI reclaim memory, no alignment requirements.\r
615 //\r
616 Status = gBS->AllocatePages (\r
617 AllocateMaxAddress,\r
618 EfiACPIReclaimMemory,\r
619 CurrentTableList->NumberOfPages,\r
620 &CurrentTableList->PageAddress\r
621 );\r
622 }\r
623 //\r
624 // Check return value from memory alloc.\r
625 //\r
626 if (EFI_ERROR (Status)) {\r
627 gBS->FreePool (CurrentTableList);\r
628 return EFI_OUT_OF_RESOURCES;\r
629 }\r
630 //\r
631 // Update the table pointer with the allocated memory start\r
632 //\r
633 CurrentTableList->Table = (EFI_ACPI_COMMON_HEADER *) (UINTN) CurrentTableList->PageAddress;\r
634\r
635 //\r
636 // Initialize the table contents\r
637 //\r
638 CurrentTableList->Signature = EFI_ACPI_TABLE_LIST_SIGNATURE;\r
639 CopyMem (CurrentTableList->Table, Table, CurrentTableSize);\r
640 CurrentTableList->Handle = AcpiTableInstance->CurrentHandle++;\r
641 *Handle = CurrentTableList->Handle;\r
642 CurrentTableList->Version = Version;\r
643\r
644 //\r
645 // Update internal pointers if this is a required table. If it is a required\r
646 // table and a table of that type already exists, return an error.\r
647 //\r
648 // Calculate the checksum if the table is not FACS.\r
649 //\r
650 switch (CurrentTableSignature) {\r
651\r
652 case EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE:\r
653 //\r
654 // We don't add the FADT in the standard way because some\r
655 // OS expect the FADT to be early in the table list.\r
656 // So we always add it as the first element in the list.\r
657 //\r
658 AddToRsdt = FALSE;\r
659\r
660 //\r
661 // Check that the table has not been previously added.\r
662 //\r
663 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0 && AcpiTableInstance->Fadt1 != NULL) ||\r
664 ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 && AcpiTableInstance->Fadt3 != NULL) ||\r
665 ((Version & EFI_ACPI_TABLE_VERSION_3_0) != 0 && AcpiTableInstance->Fadt3 != NULL)\r
666 ) {\r
667 gBS->FreePages (CurrentTableList->PageAddress, CurrentTableList->NumberOfPages);\r
668 gBS->FreePool (CurrentTableList);\r
669 return EFI_ABORTED;\r
670 }\r
671 //\r
672 // Add the table to the appropriate table version\r
673 //\r
674 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
675 //\r
676 // Save a pointer to the table\r
677 //\r
678 AcpiTableInstance->Fadt1 = (EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE *) CurrentTableList->Table;\r
679\r
680 //\r
681 // Update pointers in FADT. If tables don't exist this will put NULL pointers there.\r
682 //\r
683 AcpiTableInstance->Fadt1->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs1;\r
684 AcpiTableInstance->Fadt1->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt1;\r
685\r
686 //\r
687 // RSDP OEM information is updated to match the FADT OEM information\r
688 //\r
689 CopyMem (\r
690 &AcpiTableInstance->Rsdp1->OemId,\r
691 &AcpiTableInstance->Fadt1->Header.OemId,\r
692 6\r
693 );\r
694\r
695 //\r
696 // RSDT OEM information is updated to match the FADT OEM information.\r
697 //\r
698 CopyMem (\r
699 &AcpiTableInstance->Rsdt1->OemId,\r
700 &AcpiTableInstance->Fadt1->Header.OemId,\r
701 6\r
702 );\r
703\r
704 CopyMem (\r
705 &AcpiTableInstance->Rsdt1->OemTableId,\r
706 &AcpiTableInstance->Fadt1->Header.OemTableId,\r
707 sizeof (UINT64)\r
708 );\r
709 AcpiTableInstance->Rsdt1->OemRevision = AcpiTableInstance->Fadt1->Header.OemRevision;\r
710 }\r
711\r
712 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
713 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
714 //\r
715 // Save a pointer to the table\r
716 //\r
717 AcpiTableInstance->Fadt3 = (EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE *) CurrentTableList->Table;\r
718\r
719 //\r
720 // Update pointers in FADT. If tables don't exist this will put NULL pointers there.\r
721 //\r
f0c855b2 722 AcpiTableInstance->Fadt3->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs3;\r
723 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Facs3;\r
724 CopyMem (\r
725 &AcpiTableInstance->Fadt3->XFirmwareCtrl,\r
726 &Buffer64,\r
727 sizeof (UINT64)\r
728 );\r
729 AcpiTableInstance->Fadt3->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt3;\r
730 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Dsdt3;\r
731 CopyMem (\r
732 &AcpiTableInstance->Fadt3->XDsdt,\r
733 &Buffer64,\r
734 sizeof (UINT64)\r
735 );\r
5f55c700 736\r
f0c855b2 737 //\r
738 // RSDP OEM information is updated to match the FADT OEM information\r
739 //\r
740 CopyMem (\r
741 &AcpiTableInstance->Rsdp3->OemId,\r
742 &AcpiTableInstance->Fadt3->Header.OemId,\r
743 6\r
744 );\r
745 \r
746 //\r
747 // RSDT OEM information is updated to match FADT OEM information.\r
748 //\r
749 CopyMem (\r
750 &AcpiTableInstance->Rsdt3->OemId,\r
751 &AcpiTableInstance->Fadt3->Header.OemId,\r
752 6\r
753 );\r
754 CopyMem (\r
755 &AcpiTableInstance->Rsdt3->OemTableId,\r
756 &AcpiTableInstance->Fadt3->Header.OemTableId,\r
757 sizeof (UINT64)\r
758 );\r
759 AcpiTableInstance->Rsdt3->OemRevision = AcpiTableInstance->Fadt3->Header.OemRevision;\r
760 \r
761 //\r
762 // XSDT OEM information is updated to match FADT OEM information.\r
763 //\r
764 CopyMem (\r
765 &AcpiTableInstance->Xsdt->OemId,\r
766 &AcpiTableInstance->Fadt3->Header.OemId,\r
767 6\r
768 );\r
769 CopyMem (\r
770 &AcpiTableInstance->Xsdt->OemTableId,\r
771 &AcpiTableInstance->Fadt3->Header.OemTableId,\r
772 sizeof (UINT64)\r
773 );\r
774 AcpiTableInstance->Xsdt->OemRevision = AcpiTableInstance->Fadt3->Header.OemRevision;\r
5f55c700 775 } \r
776 //\r
777 // Checksum the table\r
778 //\r
779 if (Checksum) {\r
780 AcpiPlatformChecksum (\r
781 CurrentTableList->Table,\r
782 CurrentTableList->Table->Length,\r
783 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
784 Checksum)\r
785 );\r
786 }\r
787 break;\r
788\r
789 case EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE:\r
790 //\r
791 // Check that the table has not been previously added.\r
792 //\r
793 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0 && AcpiTableInstance->Facs1 != NULL) ||\r
794 ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 && AcpiTableInstance->Facs3 != NULL) ||\r
795 ((Version & EFI_ACPI_TABLE_VERSION_3_0) != 0 && AcpiTableInstance->Facs3 != NULL)\r
796 ) {\r
797 gBS->FreePages (CurrentTableList->PageAddress, CurrentTableList->NumberOfPages);\r
798 gBS->FreePool (CurrentTableList);\r
799 return EFI_ABORTED;\r
800 }\r
801 //\r
802 // FACS is referenced by FADT and is not part of RSDT\r
803 //\r
804 AddToRsdt = FALSE;\r
805\r
806 //\r
807 // Add the table to the appropriate table version\r
808 //\r
809 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
810 //\r
811 // Save a pointer to the table\r
812 //\r
813 AcpiTableInstance->Facs1 = (EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE *) CurrentTableList->Table;\r
814\r
815 //\r
816 // If FADT already exists, update table pointers.\r
817 //\r
818 if (AcpiTableInstance->Fadt1 != NULL) {\r
819 AcpiTableInstance->Fadt1->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs1;\r
820\r
821 //\r
822 // Checksum FADT table\r
823 //\r
824 AcpiPlatformChecksum (\r
825 AcpiTableInstance->Fadt1,\r
826 AcpiTableInstance->Fadt1->Header.Length,\r
827 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
828 Checksum)\r
829 );\r
830 }\r
831 }\r
832\r
833 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
834 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
835 //\r
836 // Save a pointer to the table\r
837 //\r
838 AcpiTableInstance->Facs3 = (EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE *) CurrentTableList->Table;\r
839\r
840 //\r
841 // If FADT already exists, update table pointers.\r
842 //\r
843 if (AcpiTableInstance->Fadt3 != NULL) {\r
844 AcpiTableInstance->Fadt3->FirmwareCtrl = (UINT32) (UINTN) AcpiTableInstance->Facs3;\r
845 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Facs3;\r
846 CopyMem (\r
847 &AcpiTableInstance->Fadt3->XFirmwareCtrl,\r
848 &Buffer64,\r
849 sizeof (UINT64)\r
850 );\r
851\r
852 //\r
853 // Checksum FADT table\r
854 //\r
855 AcpiPlatformChecksum (\r
856 AcpiTableInstance->Fadt3,\r
857 AcpiTableInstance->Fadt3->Header.Length,\r
858 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
859 Checksum)\r
860 );\r
861 }\r
862 }\r
863\r
864 break;\r
865\r
866 case EFI_ACPI_1_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE:\r
867 //\r
868 // Check that the table has not been previously added.\r
869 //\r
870 if (((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0 && AcpiTableInstance->Dsdt1 != NULL) ||\r
871 ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 && AcpiTableInstance->Dsdt3 != NULL) ||\r
872 ((Version & EFI_ACPI_TABLE_VERSION_3_0) != 0 && AcpiTableInstance->Dsdt3 != NULL)\r
873 ) {\r
874 gBS->FreePages (CurrentTableList->PageAddress, CurrentTableList->NumberOfPages);\r
875 gBS->FreePool (CurrentTableList);\r
876 return EFI_ABORTED;\r
877 }\r
878 //\r
879 // DSDT is referenced by FADT and is not part of RSDT\r
880 //\r
881 AddToRsdt = FALSE;\r
882\r
883 //\r
884 // Add the table to the appropriate table version\r
885 //\r
886 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
887 //\r
888 // Save a pointer to the table\r
889 //\r
890 AcpiTableInstance->Dsdt1 = (EFI_ACPI_DESCRIPTION_HEADER *) CurrentTableList->Table;\r
891\r
892 //\r
893 // If FADT already exists, update table pointers.\r
894 //\r
895 if (AcpiTableInstance->Fadt1 != NULL) {\r
896 AcpiTableInstance->Fadt1->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt1;\r
897\r
898 //\r
899 // Checksum FADT table\r
900 //\r
901 AcpiPlatformChecksum (\r
902 AcpiTableInstance->Fadt1,\r
903 AcpiTableInstance->Fadt1->Header.Length,\r
904 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
905 Checksum)\r
906 );\r
907 }\r
908 }\r
909 \r
910 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
911 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
912 //\r
913 // Save a pointer to the table\r
914 //\r
915 AcpiTableInstance->Dsdt3 = (EFI_ACPI_DESCRIPTION_HEADER *) CurrentTableList->Table;\r
916\r
917 //\r
918 // If FADT already exists, update table pointers.\r
919 //\r
920 if (AcpiTableInstance->Fadt3 != NULL) {\r
921 AcpiTableInstance->Fadt3->Dsdt = (UINT32) (UINTN) AcpiTableInstance->Dsdt3;\r
922 Buffer64 = (UINT64) (UINTN) AcpiTableInstance->Dsdt3;\r
923 CopyMem (\r
924 &AcpiTableInstance->Fadt3->XDsdt,\r
925 &Buffer64,\r
926 sizeof (UINT64)\r
927 );\r
928\r
929 //\r
930 // Checksum FADT table\r
931 //\r
932 AcpiPlatformChecksum (\r
933 AcpiTableInstance->Fadt3,\r
934 AcpiTableInstance->Fadt3->Header.Length,\r
935 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
936 Checksum)\r
937 );\r
938 }\r
939 } \r
940 //\r
941 // Checksum the table\r
942 //\r
943 if (Checksum) {\r
944 AcpiPlatformChecksum (\r
945 CurrentTableList->Table,\r
946 CurrentTableList->Table->Length,\r
947 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
948 Checksum)\r
949 );\r
950 }\r
951 break;\r
952\r
953 default:\r
954 //\r
955 // Checksum the table\r
956 //\r
957 if (Checksum) {\r
958 AcpiPlatformChecksum (\r
959 CurrentTableList->Table,\r
960 CurrentTableList->Table->Length,\r
961 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
962 Checksum)\r
963 );\r
964 }\r
965 break;\r
966 }\r
967 //\r
968 // Add the table to the current list of tables\r
969 //\r
970 InsertTailList (&AcpiTableInstance->TableList, &CurrentTableList->Link);\r
971\r
972 //\r
973 // Add the table to RSDT and/or XSDT table entry lists.\r
974 //\r
975 //\r
976 // Add to ACPI 1.0b table tree\r
977 //\r
978 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
5f55c700 979 if (AddToRsdt) {\r
980 //\r
da935a5c 981 // If the table number exceed the gEfiAcpiMaxNumTables, enlarge the table buffer\r
5f55c700 982 //\r
da935a5c 983 if (AcpiTableInstance->NumberOfTableEntries1 >= mEfiAcpiMaxNumTables) {\r
984 Status = ReallocateAcpiTableBuffer (AcpiTableInstance);\r
985 ASSERT_EFI_ERROR (Status);\r
986 }\r
5f55c700 987 CurrentRsdtEntry = (UINT32 *)\r
988 (\r
da935a5c 989 (UINT8 *) AcpiTableInstance->Rsdt1 +\r
5f55c700 990 sizeof (EFI_ACPI_DESCRIPTION_HEADER) +\r
da935a5c 991 AcpiTableInstance->NumberOfTableEntries1 *\r
5f55c700 992 sizeof (UINT32)\r
993 );\r
994\r
995 //\r
da935a5c 996 // Add entry to the RSDT unless its the FACS or DSDT\r
5f55c700 997 //\r
998 *CurrentRsdtEntry = (UINT32) (UINTN) CurrentTableList->Table;\r
999\r
1000 //\r
1001 // Update RSDT length\r
1002 //\r
da935a5c 1003 AcpiTableInstance->Rsdt1->Length = AcpiTableInstance->Rsdt1->Length + sizeof (UINT32);\r
5f55c700 1004\r
da935a5c 1005 AcpiTableInstance->NumberOfTableEntries1++;\r
1006 }\r
1007 }\r
1008 //\r
1009 // Add to ACPI 2.0/3.0 table tree\r
1010 //\r
1011 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1012 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1013 if (AddToRsdt) {\r
1014 //\r
1015 // If the table number exceed the gEfiAcpiMaxNumTables, enlarge the table buffer\r
1016 //\r
1017 if (AcpiTableInstance->NumberOfTableEntries3 >= mEfiAcpiMaxNumTables) {\r
1018 Status = ReallocateAcpiTableBuffer (AcpiTableInstance);\r
1019 ASSERT_EFI_ERROR (Status);\r
1020 }\r
1021 //\r
1022 // At this time, it is assumed that RSDT and XSDT maintain parallel lists of tables.\r
1023 // If it becomes necessary to maintain separate table lists, changes will be required.\r
1024 //\r
1025 CurrentRsdtEntry = (UINT32 *)\r
1026 (\r
1027 (UINT8 *) AcpiTableInstance->Rsdt3 +\r
1028 sizeof (EFI_ACPI_DESCRIPTION_HEADER) +\r
1029 AcpiTableInstance->NumberOfTableEntries3 *\r
1030 sizeof (UINT32)\r
1031 );\r
1032\r
1033 //\r
1034 // This pointer must not be directly dereferenced as the XSDT entries may not\r
1035 // be 64 bit aligned resulting in a possible fault. Use CopyMem to update.\r
1036 //\r
1037 CurrentXsdtEntry = (VOID *)\r
1038 (\r
1039 (UINT8 *) AcpiTableInstance->Xsdt +\r
1040 sizeof (EFI_ACPI_DESCRIPTION_HEADER) +\r
1041 AcpiTableInstance->NumberOfTableEntries3 *\r
1042 sizeof (UINT64)\r
1043 );\r
1044\r
1045 //\r
1046 // Add entry to the RSDT\r
1047 //\r
1048 *CurrentRsdtEntry = (UINT32) (UINTN) CurrentTableList->Table;\r
1049\r
1050 //\r
1051 // Update RSDT length\r
1052 //\r
1053 AcpiTableInstance->Rsdt3->Length = AcpiTableInstance->Rsdt3->Length + sizeof (UINT32);\r
1054\r
1055 //\r
1056 // Add entry to XSDT, XSDT expects 64 bit pointers, but\r
1057 // the table pointers in XSDT are not aligned on 8 byte boundary.\r
1058 //\r
1059 Buffer64 = (UINT64) (UINTN) CurrentTableList->Table;\r
1060 CopyMem (\r
1061 CurrentXsdtEntry,\r
1062 &Buffer64,\r
1063 sizeof (UINT64)\r
1064 );\r
1065\r
1066 //\r
1067 // Update length\r
1068 //\r
1069 AcpiTableInstance->Xsdt->Length = AcpiTableInstance->Xsdt->Length + sizeof (UINT64);\r
1070\r
1071 AcpiTableInstance->NumberOfTableEntries3++;\r
5f55c700 1072 }\r
5f55c700 1073 }\r
1074\r
1075 ChecksumCommonTables (AcpiTableInstance);\r
1076 return EFI_SUCCESS;\r
1077}\r
1078\r
1079\r
1080/**\r
1081 This function finds the table specified by the handle and returns a pointer to it.\r
1082 If the handle is not found, EFI_NOT_FOUND is returned and the contents of Table are\r
1083 undefined.\r
1084\r
1085 @param Handle Table to find.\r
1086 @param TableList Table list to search\r
1087 @param Table Pointer to table found. \r
1088\r
1089 @return EFI_SUCCESS The function completed successfully.\r
1090 @return EFI_NOT_FOUND No table found matching the handle specified.\r
1091\r
1092**/\r
1093EFI_STATUS\r
1094FindTableByHandle (\r
1095 IN UINTN Handle,\r
1096 IN LIST_ENTRY *TableList,\r
1097 OUT EFI_ACPI_TABLE_LIST **Table\r
1098 )\r
1099{\r
1100 LIST_ENTRY *CurrentLink;\r
1101 EFI_ACPI_TABLE_LIST *CurrentTable;\r
1102\r
1103 //\r
1104 // Check for invalid input parameters\r
1105 //\r
1106 ASSERT (Table);\r
1107\r
1108 //\r
1109 // Find the table\r
1110 //\r
1111 CurrentLink = TableList->ForwardLink;\r
1112\r
1113 while (CurrentLink != TableList) {\r
1114 CurrentTable = EFI_ACPI_TABLE_LIST_FROM_LINK (CurrentLink);\r
1115 if (CurrentTable->Handle == Handle) {\r
1116 //\r
1117 // Found handle, so return this table.\r
1118 //\r
1119 *Table = CurrentTable;\r
1120 return EFI_SUCCESS;\r
1121 }\r
1122\r
1123 CurrentLink = CurrentLink->ForwardLink;\r
1124 }\r
1125 //\r
1126 // Table not found\r
1127 //\r
1128 return EFI_NOT_FOUND;\r
1129}\r
1130\r
1131\r
1132/**\r
1133 This function removes a basic table from the RSDT and/or XSDT.\r
1134 For Acpi 1.0 tables, pass in the Rsdt.\r
1135 For Acpi 2.0 tables, pass in both Rsdt and Xsdt.\r
1136\r
1137 @param Table Pointer to table found. \r
1138 @param NumberOfTableEntries Current number of table entries in the RSDT/XSDT\r
1139 @param Rsdt Pointer to the RSDT to remove from\r
1140 @param Xsdt Pointer to the Xsdt to remove from\r
1141\r
1142 @return EFI_SUCCESS The function completed successfully.\r
1143 @return EFI_INVALID_PARAMETER The table was not found in both Rsdt and Xsdt.\r
1144\r
1145**/\r
1146EFI_STATUS\r
1147RemoveTableFromRsdt (\r
1148 IN OUT EFI_ACPI_TABLE_LIST * Table,\r
1149 IN OUT UINTN *NumberOfTableEntries,\r
1150 IN OUT EFI_ACPI_DESCRIPTION_HEADER * Rsdt,\r
1151 IN OUT EFI_ACPI_DESCRIPTION_HEADER * Xsdt OPTIONAL\r
1152 )\r
1153{\r
1154 UINT32 *CurrentRsdtEntry;\r
1155 VOID *CurrentXsdtEntry;\r
1156 UINT64 CurrentTablePointer64;\r
1157 UINTN Index;\r
1158\r
1159 //\r
1160 // Check for invalid input parameters\r
1161 //\r
1162 ASSERT (Table);\r
1163 ASSERT (NumberOfTableEntries);\r
1164 ASSERT (Rsdt);\r
1165\r
1166 //\r
1167 // Find the table entry in the RSDT and XSDT\r
1168 //\r
1169 for (Index = 0; Index < *NumberOfTableEntries; Index++) {\r
1170 //\r
1171 // At this time, it is assumed that RSDT and XSDT maintain parallel lists of tables.\r
1172 // If it becomes necessary to maintain separate table lists, changes will be required.\r
1173 //\r
1174 CurrentRsdtEntry = (UINT32 *) ((UINT8 *) Rsdt + sizeof (EFI_ACPI_DESCRIPTION_HEADER) + Index * sizeof (UINT32));\r
1175 if (Xsdt != NULL) {\r
1176 //\r
1177 // This pointer must not be directly dereferenced as the XSDT entries may not\r
1178 // be 64 bit aligned resulting in a possible fault. Use CopyMem to update.\r
1179 //\r
1180 CurrentXsdtEntry = (VOID *) ((UINT8 *) Xsdt + sizeof (EFI_ACPI_DESCRIPTION_HEADER) + Index * sizeof (UINT64));\r
1181\r
1182 //\r
1183 // Read the entry value out of the XSDT\r
1184 //\r
1185 CopyMem (&CurrentTablePointer64, CurrentXsdtEntry, sizeof (UINT64));\r
1186 } else {\r
1187 //\r
1188 // Initialize to NULL\r
1189 //\r
1190 CurrentXsdtEntry = 0;\r
1191 CurrentTablePointer64 = 0;\r
1192 }\r
1193 //\r
1194 // Check if we have found the corresponding entry in both RSDT and XSDT\r
1195 //\r
1196 if (*CurrentRsdtEntry == (UINT32) (UINTN) Table->Table &&\r
1197 ((Xsdt == NULL) || CurrentTablePointer64 == (UINT64) (UINTN) Table->Table)\r
1198 ) {\r
1199 //\r
1200 // Found entry, so copy all following entries and shrink table\r
1201 // We actually copy all + 1 to copy the initialized value of memory over\r
1202 // the last entry.\r
1203 //\r
1204 CopyMem (CurrentRsdtEntry, CurrentRsdtEntry + 1, (*NumberOfTableEntries - Index) * sizeof (UINT32));\r
1205 Rsdt->Length = Rsdt->Length - sizeof (UINT32);\r
1206 if (Xsdt != NULL) {\r
1207 CopyMem (CurrentXsdtEntry, ((UINT64 *) CurrentXsdtEntry) + 1, (*NumberOfTableEntries - Index) * sizeof (UINT64));\r
1208 Xsdt->Length = Xsdt->Length - sizeof (UINT64);\r
1209 }\r
1210 break;\r
1211 } else if (Index + 1 == *NumberOfTableEntries) {\r
1212 //\r
1213 // At the last entry, and table not found\r
1214 //\r
1215 return EFI_INVALID_PARAMETER;\r
1216 }\r
1217 }\r
1218 //\r
1219 // Checksum the tables\r
1220 //\r
1221 AcpiPlatformChecksum (\r
1222 Rsdt,\r
1223 Rsdt->Length,\r
1224 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1225 Checksum)\r
1226 );\r
1227\r
1228 if (Xsdt != NULL) {\r
1229 AcpiPlatformChecksum (\r
1230 Xsdt,\r
1231 Xsdt->Length,\r
1232 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1233 Checksum)\r
1234 );\r
1235 }\r
1236 //\r
1237 // Decrement the number of tables\r
1238 //\r
1239 (*NumberOfTableEntries)--;\r
1240\r
1241 return EFI_SUCCESS;\r
1242}\r
1243\r
1244\r
1245/**\r
1246 This function removes a table and frees any associated memory.\r
1247\r
1248 @param AcpiTableInstance Instance of the protocol.\r
1249 @param Version Version(s) to delete.\r
1250 @param Table Pointer to table found.\r
1251\r
1252 @return EFI_SUCCESS The function completed successfully.\r
1253\r
1254**/\r
1255EFI_STATUS\r
1256DeleteTable (\r
1257 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
1258 IN EFI_ACPI_TABLE_VERSION Version,\r
1259 IN OUT EFI_ACPI_TABLE_LIST *Table\r
1260 )\r
1261{\r
1262 UINT32 CurrentTableSignature;\r
1263 BOOLEAN RemoveFromRsdt;\r
1264\r
1265 //\r
1266 // Check for invalid input parameters\r
1267 //\r
1268 ASSERT (AcpiTableInstance);\r
1269 ASSERT (Table);\r
1270\r
1271 //\r
1272 // Init locals\r
1273 //\r
1274 RemoveFromRsdt = TRUE;\r
6198c346 1275 //\r
1276 // Check for Table->Table\r
1277 //\r
1278 ASSERT (Table->Table != NULL);\r
5f55c700 1279 CurrentTableSignature = ((EFI_ACPI_COMMON_HEADER *) Table->Table)->Signature;\r
1280\r
1281 //\r
1282 // Basic tasks to accomplish delete are:\r
1283 // Determine removal requirements (in RSDT/XSDT or not)\r
1284 // Remove entry from RSDT/XSDT\r
1285 // Remove any table references to the table\r
1286 // If no one is using the table\r
1287 // Free the table (removing pointers from private data and tables)\r
1288 // Remove from list\r
1289 // Free list structure\r
1290 //\r
1291 //\r
1292 // Determine if this table is in the RSDT or XSDT\r
1293 //\r
1294 if ((CurrentTableSignature == EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE) ||\r
1295 (CurrentTableSignature == EFI_ACPI_2_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) ||\r
1296 (CurrentTableSignature == EFI_ACPI_3_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE)\r
1297 ) {\r
1298 RemoveFromRsdt = FALSE;\r
1299 }\r
1300 //\r
1301 // We don't remove the FADT in the standard way because some\r
1302 // OS expect the FADT to be early in the table list.\r
1303 // So we always put it as the first element in the list.\r
1304 //\r
1305 if (CurrentTableSignature == EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE) {\r
1306 RemoveFromRsdt = FALSE;\r
1307 }\r
1308\r
1309 //\r
1310 // Remove the table from RSDT and XSDT\r
1311 //\r
1312 if (Table->Table != NULL) {\r
1313 //\r
1314 // This is a basic table, remove it from any lists and the Rsdt and/or Xsdt\r
1315 //\r
1316 if (Version & EFI_ACPI_TABLE_VERSION_NONE & Table->Version) {\r
1317 //\r
1318 // Remove this version from the table\r
1319 //\r
1320 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_NONE;\r
1321 }\r
1322\r
1323 if (Version & EFI_ACPI_TABLE_VERSION_1_0B & Table->Version) {\r
1324 //\r
1325 // Remove this version from the table\r
1326 //\r
1327 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_1_0B;\r
1328\r
1329 //\r
1330 // Remove from Rsdt. We don't care about the return value because it is\r
1331 // acceptable for the table to not exist in Rsdt.\r
1332 // We didn't add some tables so we don't remove them.\r
1333 //\r
1334 if (RemoveFromRsdt) {\r
1335 RemoveTableFromRsdt (\r
1336 Table,\r
1337 &AcpiTableInstance->NumberOfTableEntries1,\r
1338 AcpiTableInstance->Rsdt1,\r
1339 NULL\r
1340 );\r
1341 }\r
1342 }\r
1343\r
1344 if ((Version & EFI_ACPI_TABLE_VERSION_2_0 & Table->Version) ||\r
1345 (Version & EFI_ACPI_TABLE_VERSION_3_0 & Table->Version)) {\r
1346 //\r
1347 // Remove this version from the table\r
1348 //\r
1349 if (Version & EFI_ACPI_TABLE_VERSION_2_0 & Table->Version) {\r
1350 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_2_0;\r
1351 } \r
1352 if (Version & EFI_ACPI_TABLE_VERSION_3_0 & Table->Version) {\r
1353 Table->Version = Table->Version &~EFI_ACPI_TABLE_VERSION_3_0;\r
1354 }\r
1355 \r
1356 //\r
1357 // Remove from Rsdt and Xsdt. We don't care about the return value\r
1358 // because it is acceptable for the table to not exist in Rsdt/Xsdt.\r
1359 // We didn't add some tables so we don't remove them.\r
1360 //\r
1361 if (RemoveFromRsdt) {\r
1362 RemoveTableFromRsdt (\r
1363 Table,\r
1364 &AcpiTableInstance->NumberOfTableEntries3,\r
1365 AcpiTableInstance->Rsdt3,\r
1366 AcpiTableInstance->Xsdt\r
1367 );\r
1368 }\r
1369 } \r
1370 //\r
1371 // Free the table, clean up any dependent tables and our private data pointers.\r
1372 //\r
1373 switch (Table->Table->Signature) {\r
1374\r
1375 case EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE:\r
1376 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
1377 AcpiTableInstance->Fadt1 = NULL;\r
1378 }\r
1379\r
1380 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1381 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1382 AcpiTableInstance->Fadt3 = NULL;\r
1383 }\r
1384 break;\r
1385\r
1386 case EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE:\r
1387 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
1388 AcpiTableInstance->Facs1 = NULL;\r
1389\r
1390 //\r
1391 // Update FADT table pointers\r
1392 //\r
1393 if (AcpiTableInstance->Fadt1 != NULL) {\r
1394 AcpiTableInstance->Fadt1->FirmwareCtrl = 0;\r
1395\r
1396 //\r
1397 // Checksum table\r
1398 //\r
1399 AcpiPlatformChecksum (\r
1400 AcpiTableInstance->Fadt1,\r
1401 AcpiTableInstance->Fadt1->Header.Length,\r
1402 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1403 Checksum)\r
1404 );\r
1405 }\r
1406 }\r
1407\r
1408 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1409 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1410 AcpiTableInstance->Facs3 = NULL;\r
1411\r
1412 //\r
1413 // Update FADT table pointers\r
1414 //\r
1415 if (AcpiTableInstance->Fadt3 != NULL) {\r
1416 AcpiTableInstance->Fadt3->FirmwareCtrl = 0;\r
1417 ZeroMem (&AcpiTableInstance->Fadt3->XFirmwareCtrl, sizeof (UINT64));\r
1418\r
1419 //\r
1420 // Checksum table\r
1421 //\r
1422 AcpiPlatformChecksum (\r
1423 AcpiTableInstance->Fadt3,\r
1424 AcpiTableInstance->Fadt3->Header.Length,\r
1425 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1426 Checksum)\r
1427 );\r
1428 }\r
1429 } \r
1430 break;\r
1431\r
1432 case EFI_ACPI_3_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE:\r
1433 if ((Version & EFI_ACPI_TABLE_VERSION_1_0B) != 0) {\r
1434 AcpiTableInstance->Dsdt1 = NULL;\r
1435\r
1436 //\r
1437 // Update FADT table pointers\r
1438 //\r
1439 if (AcpiTableInstance->Fadt1 != NULL) {\r
1440 AcpiTableInstance->Fadt1->Dsdt = 0;\r
1441\r
1442 //\r
1443 // Checksum table\r
1444 //\r
1445 AcpiPlatformChecksum (\r
1446 AcpiTableInstance->Fadt1,\r
1447 AcpiTableInstance->Fadt1->Header.Length,\r
1448 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1449 Checksum)\r
1450 );\r
1451 }\r
1452 }\r
1453\r
1454 \r
1455 if ((Version & EFI_ACPI_TABLE_VERSION_2_0) != 0 ||\r
1456 (Version & EFI_ACPI_TABLE_VERSION_3_0) != 0) {\r
1457 AcpiTableInstance->Dsdt3 = NULL;\r
1458\r
1459 //\r
1460 // Update FADT table pointers\r
1461 //\r
1462 if (AcpiTableInstance->Fadt3 != NULL) {\r
1463 AcpiTableInstance->Fadt3->Dsdt = 0;\r
1464 ZeroMem (&AcpiTableInstance->Fadt3->XDsdt, sizeof (UINT64));\r
1465\r
1466 //\r
1467 // Checksum table\r
1468 //\r
1469 AcpiPlatformChecksum (\r
1470 AcpiTableInstance->Fadt3,\r
1471 AcpiTableInstance->Fadt3->Header.Length,\r
1472 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1473 Checksum)\r
1474 );\r
1475 }\r
1476 }\r
1477 break;\r
1478\r
1479 default:\r
1480 //\r
1481 // Do nothing\r
1482 //\r
1483 break;\r
1484 }\r
1485 }\r
1486 //\r
1487 // If no version is using this table anymore, remove and free list entry.\r
1488 //\r
1489 if (Table->Version == 0) {\r
1490 //\r
1491 // Free the Table\r
1492 //\r
1493 gBS->FreePages (Table->PageAddress, Table->NumberOfPages);\r
1494 RemoveEntryList (&(Table->Link));\r
1495 gBS->FreePool (Table);\r
1496 }\r
1497 //\r
1498 // Done\r
1499 //\r
1500 return EFI_SUCCESS;\r
1501}\r
1502\r
1503\r
1504/**\r
1505 This function finds and removes the table specified by the handle.\r
1506\r
1507 @param AcpiTableInstance Instance of the protocol.\r
1508 @param Version Bitmask of which versions to remove.\r
1509 @param Handle Table to remove.\r
1510\r
1511 @return EFI_SUCCESS The function completed successfully.\r
1512 @return EFI_ABORTED An error occurred.\r
1513 @return EFI_NOT_FOUND Handle not found in table list.\r
1514\r
1515**/\r
1516EFI_STATUS\r
1517RemoveTableFromList (\r
1518 IN EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance,\r
1519 IN EFI_ACPI_TABLE_VERSION Version,\r
1520 IN UINTN Handle\r
1521 )\r
1522{\r
1523 EFI_ACPI_TABLE_LIST *Table;\r
1524 EFI_STATUS Status;\r
1525\r
b474ed49 1526 Table = (EFI_ACPI_TABLE_LIST*) NULL;\r
1527\r
5f55c700 1528 //\r
1529 // Check for invalid input parameters\r
1530 //\r
1531 ASSERT (AcpiTableInstance);\r
1532\r
1533 //\r
1534 // Find the table\r
1535 //\r
1536 Status = FindTableByHandle (\r
1537 Handle,\r
1538 &AcpiTableInstance->TableList,\r
1539 &Table\r
1540 );\r
1541 if (EFI_ERROR (Status)) {\r
1542 return EFI_NOT_FOUND;\r
1543 }\r
1544 //\r
1545 // Remove the table\r
1546 //\r
1547 Status = DeleteTable (AcpiTableInstance, Version, Table);\r
1548 if (EFI_ERROR (Status)) {\r
1549 return EFI_ABORTED;\r
1550 }\r
1551 //\r
1552 // Completed successfully\r
1553 //\r
1554 return EFI_SUCCESS;\r
1555}\r
1556\r
1557\r
1558/**\r
1559 This function calculates and updates an UINT8 checksum.\r
1560\r
1561 @param Buffer Pointer to buffer to checksum\r
1562 @param Size Number of bytes to checksum\r
1563 @param ChecksumOffset Offset to place the checksum result in\r
1564\r
1565 @return EFI_SUCCESS The function completed successfully.\r
1566\r
1567**/\r
1568EFI_STATUS\r
1569AcpiPlatformChecksum (\r
1570 IN VOID *Buffer,\r
1571 IN UINTN Size,\r
1572 IN UINTN ChecksumOffset\r
1573 )\r
1574{\r
1575 UINT8 Sum;\r
1576 UINT8 *Ptr;\r
1577\r
1578 Sum = 0;\r
1579 //\r
1580 // Initialize pointer\r
1581 //\r
1582 Ptr = Buffer;\r
1583\r
1584 //\r
1585 // set checksum to 0 first\r
1586 //\r
1587 Ptr[ChecksumOffset] = 0;\r
1588\r
1589 //\r
1590 // add all content of buffer\r
1591 //\r
1592 while ((Size--) != 0) {\r
1593 Sum = (UINT8) (Sum + (*Ptr++));\r
1594 }\r
1595 //\r
1596 // set checksum\r
1597 //\r
1598 Ptr = Buffer;\r
1599 Ptr[ChecksumOffset] = (UINT8) (0xff - Sum + 1);\r
1600\r
1601 return EFI_SUCCESS;\r
1602}\r
1603\r
1604\r
1605/**\r
1606 Checksum all versions of the common tables, RSDP, RSDT, XSDT.\r
1607\r
1608 @param AcpiTableInstance Protocol instance private data.\r
1609\r
1610 @return EFI_SUCCESS The function completed successfully.\r
1611\r
1612**/\r
1613EFI_STATUS\r
1614ChecksumCommonTables (\r
1615 IN OUT EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
1616 )\r
1617{\r
1618 //\r
1619 // RSDP ACPI 1.0 checksum for 1.0 table. This is only the first 20 bytes of the structure\r
1620 //\r
1621 AcpiPlatformChecksum (\r
1622 AcpiTableInstance->Rsdp1,\r
1623 sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER),\r
1624 OFFSET_OF (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER,\r
1625 Checksum)\r
1626 );\r
1627\r
1628 //\r
1629 // RSDP ACPI 1.0 checksum for 2.0/3.0 table. This is only the first 20 bytes of the structure\r
1630 //\r
1631 AcpiPlatformChecksum (\r
1632 AcpiTableInstance->Rsdp3,\r
1633 sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER),\r
1634 OFFSET_OF (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER,\r
1635 Checksum)\r
1636 );\r
1637\r
1638 //\r
1639 // RSDP ACPI 2.0/3.0 checksum, this is the entire table\r
1640 //\r
1641 AcpiPlatformChecksum (\r
1642 AcpiTableInstance->Rsdp3,\r
1643 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER),\r
1644 OFFSET_OF (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER,\r
1645 ExtendedChecksum)\r
1646 );\r
1647\r
1648 //\r
1649 // RSDT checksums\r
1650 //\r
1651 AcpiPlatformChecksum (\r
1652 AcpiTableInstance->Rsdt1,\r
1653 AcpiTableInstance->Rsdt1->Length,\r
1654 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1655 Checksum)\r
1656 );\r
1657\r
1658 AcpiPlatformChecksum (\r
1659 AcpiTableInstance->Rsdt3,\r
1660 AcpiTableInstance->Rsdt3->Length,\r
1661 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1662 Checksum)\r
1663 );\r
1664\r
1665 //\r
1666 // XSDT checksum\r
1667 //\r
1668 AcpiPlatformChecksum (\r
1669 AcpiTableInstance->Xsdt,\r
1670 AcpiTableInstance->Xsdt->Length,\r
1671 OFFSET_OF (EFI_ACPI_DESCRIPTION_HEADER,\r
1672 Checksum)\r
1673 );\r
1674 \r
1675 return EFI_SUCCESS;\r
1676}\r
1677\r
1678\r
1679/**\r
1680 Constructor for the ACPI table protocol. Initializes instance\r
1681 data.\r
1682\r
1683 @param AcpiTableInstance Instance to construct\r
1684\r
1685 @return EFI_SUCCESS Instance initialized.\r
1686 @return EFI_OUT_OF_RESOURCES Unable to allocate required resources.\r
1687\r
1688**/\r
1689EFI_STATUS\r
1690AcpiTableAcpiTableConstructor (\r
1691 EFI_ACPI_TABLE_INSTANCE *AcpiTableInstance\r
1692 )\r
1693{\r
1694 EFI_STATUS Status;\r
1695 UINT64 CurrentData;\r
1696 UINTN TotalSize;\r
1697 UINT8 *Pointer;\r
1698 EFI_PHYSICAL_ADDRESS PageAddress;\r
1699\r
1700 //\r
1701 // Check for invalid input parameters\r
1702 //\r
1703 ASSERT (AcpiTableInstance);\r
1704\r
1705 InitializeListHead (&AcpiTableInstance->TableList);\r
1706 AcpiTableInstance->CurrentHandle = 1;\r
1707\r
1708 AcpiTableInstance->AcpiTableProtocol.InstallAcpiTable = InstallAcpiTable;\r
1709 AcpiTableInstance->AcpiTableProtocol.UninstallAcpiTable = UninstallAcpiTable;\r
1710 //\r
1711 // Create RSDP, RSDT, XSDT structures\r
1712 // Allocate all buffers\r
1713 //\r
1714 TotalSize = sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
1715 sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER) +\r
1716 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 1.0 RSDT\r
da935a5c 1717 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
5f55c700 1718 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 RSDT\r
da935a5c 1719 mEfiAcpiMaxNumTables * sizeof (UINT32) +\r
5f55c700 1720 sizeof (EFI_ACPI_DESCRIPTION_HEADER) + // for ACPI 2.0/3.0 XSDT\r
da935a5c 1721 mEfiAcpiMaxNumTables * sizeof (UINT64);\r
5f55c700 1722\r
1723 //\r
1724 // Allocate memory in the lower 32 bit of address range for\r
1725 // compatibility with ACPI 1.0 OS.\r
1726 //\r
1727 // This is done because ACPI 1.0 pointers are 32 bit values.\r
1728 // ACPI 2.0 OS and all 64 bit OS must use the 64 bit ACPI table addresses.\r
1729 // There is no architectural reason these should be below 4GB, it is purely\r
1730 // for convenience of implementation that we force memory below 4GB.\r
1731 //\r
1732 PageAddress = 0xFFFFFFFF;\r
1733 Status = gBS->AllocatePages (\r
1734 AllocateMaxAddress,\r
1735 EfiACPIReclaimMemory,\r
1736 EFI_SIZE_TO_PAGES (TotalSize),\r
1737 &PageAddress\r
1738 );\r
1739\r
1740 if (EFI_ERROR (Status)) {\r
1741 return EFI_OUT_OF_RESOURCES;\r
1742 }\r
1743\r
1744 Pointer = (UINT8 *) (UINTN) PageAddress;\r
1745 ZeroMem (Pointer, TotalSize);\r
1746\r
1747 AcpiTableInstance->Rsdp1 = (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
1748 Pointer += sizeof (EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
1749 AcpiTableInstance->Rsdp3 = (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER *) Pointer;\r
1750 Pointer += sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
1751\r
1752 AcpiTableInstance->Rsdt1 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
1753 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + EFI_ACPI_MAX_NUM_TABLES * sizeof (UINT32));\r
1754 AcpiTableInstance->Rsdt3 = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
1755 Pointer += (sizeof (EFI_ACPI_DESCRIPTION_HEADER) + EFI_ACPI_MAX_NUM_TABLES * sizeof (UINT32));\r
1756\r
1757 AcpiTableInstance->Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) Pointer;\r
1758\r
1759 //\r
1760 // Initialize RSDP\r
1761 //\r
1762 CurrentData = EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE;\r
1763 CopyMem (&AcpiTableInstance->Rsdp1->Signature, &CurrentData, sizeof (UINT64));\r
1764 CopyMem (AcpiTableInstance->Rsdp1->OemId, EFI_ACPI_OEM_ID, 6);\r
1765 AcpiTableInstance->Rsdp1->Reserved = EFI_ACPI_RESERVED_BYTE;\r
1766 AcpiTableInstance->Rsdp1->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt1;\r
1767\r
1768 CurrentData = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE;\r
1769 CopyMem (&AcpiTableInstance->Rsdp3->Signature, &CurrentData, sizeof (UINT64));\r
1770 CopyMem (AcpiTableInstance->Rsdp3->OemId, EFI_ACPI_OEM_ID, 6);\r
1771 AcpiTableInstance->Rsdp3->Revision = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION;\r
1772 AcpiTableInstance->Rsdp3->RsdtAddress = (UINT32) (UINTN) AcpiTableInstance->Rsdt3;\r
1773 AcpiTableInstance->Rsdp3->Length = sizeof (EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER);\r
1774 CurrentData = (UINT64) (UINTN) AcpiTableInstance->Xsdt;\r
1775 CopyMem (&AcpiTableInstance->Rsdp3->XsdtAddress, &CurrentData, sizeof (UINT64));\r
1776 SetMem (AcpiTableInstance->Rsdp3->Reserved, 3, EFI_ACPI_RESERVED_BYTE);\r
1777\r
1778 //\r
1779 // Initialize Rsdt\r
1780 //\r
1781 // Note that we "reserve" one entry for the FADT so it can always be\r
1782 // at the beginning of the list of tables. Some OS don't seem\r
1783 // to find it correctly if it is too far down the list.\r
1784 //\r
1785 AcpiTableInstance->Rsdt1->Signature = EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE;\r
1786 AcpiTableInstance->Rsdt1->Length = sizeof (EFI_ACPI_DESCRIPTION_HEADER);\r
1787 AcpiTableInstance->Rsdt1->Revision = EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION;\r
1788 CopyMem (AcpiTableInstance->Rsdt1->OemId, EFI_ACPI_OEM_ID, 6);\r
1789 CurrentData = EFI_ACPI_OEM_TABLE_ID;\r
1790 CopyMem (&AcpiTableInstance->Rsdt1->OemTableId, &CurrentData, sizeof (UINT64));\r
1791 AcpiTableInstance->Rsdt1->OemRevision = EFI_ACPI_OEM_REVISION;\r
1792 AcpiTableInstance->Rsdt1->CreatorId = EFI_ACPI_CREATOR_ID;\r
1793 AcpiTableInstance->Rsdt1->CreatorRevision = EFI_ACPI_CREATOR_REVISION;\r
1794 //\r
1795 // We always reserve first one for FADT\r
1796 //\r
1797 AcpiTableInstance->NumberOfTableEntries1 = 1;\r
1798 AcpiTableInstance->Rsdt1->Length = AcpiTableInstance->Rsdt1->Length + sizeof(UINT32);\r
1799\r
1800 AcpiTableInstance->Rsdt3->Signature = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE;\r
1801 AcpiTableInstance->Rsdt3->Length = sizeof (EFI_ACPI_DESCRIPTION_HEADER);\r
1802 AcpiTableInstance->Rsdt3->Revision = EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION;\r
1803 CopyMem (AcpiTableInstance->Rsdt3->OemId, EFI_ACPI_OEM_ID, 6);\r
1804 CurrentData = EFI_ACPI_OEM_TABLE_ID;\r
1805 CopyMem (&AcpiTableInstance->Rsdt3->OemTableId, &CurrentData, sizeof (UINT64));\r
1806 AcpiTableInstance->Rsdt3->OemRevision = EFI_ACPI_OEM_REVISION;\r
1807 AcpiTableInstance->Rsdt3->CreatorId = EFI_ACPI_CREATOR_ID;\r
1808 AcpiTableInstance->Rsdt3->CreatorRevision = EFI_ACPI_CREATOR_REVISION;\r
1809 //\r
1810 // We always reserve first one for FADT\r
1811 //\r
1812 AcpiTableInstance->NumberOfTableEntries3 = 1;\r
1813 AcpiTableInstance->Rsdt3->Length = AcpiTableInstance->Rsdt3->Length + sizeof(UINT32);\r
1814\r
1815 //\r
1816 // Initialize Xsdt\r
1817 //\r
1818 AcpiTableInstance->Xsdt->Signature = EFI_ACPI_3_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE;\r
1819 AcpiTableInstance->Xsdt->Length = sizeof (EFI_ACPI_DESCRIPTION_HEADER);\r
1820 AcpiTableInstance->Xsdt->Revision = EFI_ACPI_3_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION;\r
1821 CopyMem (AcpiTableInstance->Xsdt->OemId, EFI_ACPI_OEM_ID, 6);\r
1822 CurrentData = EFI_ACPI_OEM_TABLE_ID;\r
1823 CopyMem (&AcpiTableInstance->Xsdt->OemTableId, &CurrentData, sizeof (UINT64));\r
1824 AcpiTableInstance->Xsdt->OemRevision = EFI_ACPI_OEM_REVISION;\r
1825 AcpiTableInstance->Xsdt->CreatorId = EFI_ACPI_CREATOR_ID;\r
1826 AcpiTableInstance->Xsdt->CreatorRevision = EFI_ACPI_CREATOR_REVISION;\r
1827 //\r
1828 // We always reserve first one for FADT\r
1829 //\r
1830 AcpiTableInstance->Xsdt->Length = AcpiTableInstance->Xsdt->Length + sizeof(UINT64);\r
1831\r
1832 ChecksumCommonTables (AcpiTableInstance);\r
1833\r
1834 //\r
1835 // Completed successfully\r
1836 //\r
1837 return EFI_SUCCESS;\r
1838}\r
1839\r