1 /******************************************************************************
3 * Module Name: tbutils - ACPI Table utilities
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2016, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
48 #define _COMPONENT ACPI_TABLES
49 ACPI_MODULE_NAME ("tbutils")
52 /* Local prototypes */
54 static ACPI_PHYSICAL_ADDRESS
55 AcpiTbGetRootTableEntry (
57 UINT32 TableEntrySize
);
60 #if (!ACPI_REDUCED_HARDWARE)
61 /*******************************************************************************
63 * FUNCTION: AcpiTbInitializeFacs
69 * DESCRIPTION: Create a permanent mapping for the FADT and save it in a global
70 * for accessing the Global Lock and Firmware Waking Vector
72 ******************************************************************************/
75 AcpiTbInitializeFacs (
78 ACPI_TABLE_FACS
*Facs
;
81 /* If Hardware Reduced flag is set, there is no FACS */
83 if (AcpiGbl_ReducedHardware
)
88 else if (AcpiGbl_FADT
.XFacs
&&
89 (!AcpiGbl_FADT
.Facs
|| !AcpiGbl_Use32BitFacsAddresses
))
91 (void) AcpiGetTableByIndex (AcpiGbl_XFacsIndex
,
92 ACPI_CAST_INDIRECT_PTR (ACPI_TABLE_HEADER
, &Facs
));
95 else if (AcpiGbl_FADT
.Facs
)
97 (void) AcpiGetTableByIndex (AcpiGbl_FacsIndex
,
98 ACPI_CAST_INDIRECT_PTR (ACPI_TABLE_HEADER
, &Facs
));
102 /* If there is no FACS, just continue. There was already an error msg */
106 #endif /* !ACPI_REDUCED_HARDWARE */
109 /*******************************************************************************
111 * FUNCTION: AcpiTbCheckDsdtHeader
117 * DESCRIPTION: Quick compare to check validity of the DSDT. This will detect
118 * if the DSDT has been replaced from outside the OS and/or if
119 * the DSDT header has been corrupted.
121 ******************************************************************************/
124 AcpiTbCheckDsdtHeader (
128 /* Compare original length and checksum to current values */
130 if (AcpiGbl_OriginalDsdtHeader
.Length
!= AcpiGbl_DSDT
->Length
||
131 AcpiGbl_OriginalDsdtHeader
.Checksum
!= AcpiGbl_DSDT
->Checksum
)
133 ACPI_BIOS_ERROR ((AE_INFO
,
134 "The DSDT has been corrupted or replaced - "
135 "old, new headers below"));
137 AcpiTbPrintTableHeader (0, &AcpiGbl_OriginalDsdtHeader
);
138 AcpiTbPrintTableHeader (0, AcpiGbl_DSDT
);
140 /* Disable further error messages */
142 AcpiGbl_OriginalDsdtHeader
.Length
= AcpiGbl_DSDT
->Length
;
143 AcpiGbl_OriginalDsdtHeader
.Checksum
= AcpiGbl_DSDT
->Checksum
;
148 /*******************************************************************************
150 * FUNCTION: AcpiTbCopyDsdt
152 * PARAMETERS: TableDesc - Installed table to copy
156 * DESCRIPTION: Implements a subsystem option to copy the DSDT to local memory.
157 * Some very bad BIOSs are known to either corrupt the DSDT or
158 * install a new, bad DSDT. This copy works around the problem.
160 ******************************************************************************/
166 ACPI_TABLE_HEADER
*NewTable
;
167 ACPI_TABLE_DESC
*TableDesc
;
170 TableDesc
= &AcpiGbl_RootTableList
.Tables
[TableIndex
];
172 NewTable
= ACPI_ALLOCATE (TableDesc
->Length
);
175 ACPI_ERROR ((AE_INFO
, "Could not copy DSDT of length 0x%X",
180 memcpy (NewTable
, TableDesc
->Pointer
, TableDesc
->Length
);
181 AcpiTbUninstallTable (TableDesc
);
183 AcpiTbInitTableDescriptor (
184 &AcpiGbl_RootTableList
.Tables
[AcpiGbl_DsdtIndex
],
185 ACPI_PTR_TO_PHYSADDR (NewTable
),
186 ACPI_TABLE_ORIGIN_INTERNAL_VIRTUAL
, NewTable
);
189 "Forced DSDT copy: length 0x%05X copied locally, original unmapped",
196 /*******************************************************************************
198 * FUNCTION: AcpiTbGetRootTableEntry
200 * PARAMETERS: TableEntry - Pointer to the RSDT/XSDT table entry
201 * TableEntrySize - sizeof 32 or 64 (RSDT or XSDT)
203 * RETURN: Physical address extracted from the root table
205 * DESCRIPTION: Get one root table entry. Handles 32-bit and 64-bit cases on
206 * both 32-bit and 64-bit platforms
208 * NOTE: ACPI_PHYSICAL_ADDRESS is 32-bit on 32-bit platforms, 64-bit on
211 ******************************************************************************/
213 static ACPI_PHYSICAL_ADDRESS
214 AcpiTbGetRootTableEntry (
216 UINT32 TableEntrySize
)
222 * Get the table physical address (32-bit for RSDT, 64-bit for XSDT):
223 * Note: Addresses are 32-bit aligned (not 64) in both RSDT and XSDT
225 if (TableEntrySize
== ACPI_RSDT_ENTRY_SIZE
)
228 * 32-bit platform, RSDT: Return 32-bit table entry
229 * 64-bit platform, RSDT: Expand 32-bit to 64-bit and return
231 return ((ACPI_PHYSICAL_ADDRESS
) (*ACPI_CAST_PTR (
232 UINT32
, TableEntry
)));
237 * 32-bit platform, XSDT: Truncate 64-bit to 32-bit and return
238 * 64-bit platform, XSDT: Move (unaligned) 64-bit to local,
241 ACPI_MOVE_64_TO_64 (&Address64
, TableEntry
);
243 #if ACPI_MACHINE_WIDTH == 32
244 if (Address64
> ACPI_UINT32_MAX
)
246 /* Will truncate 64-bit address to 32 bits, issue warning */
248 ACPI_BIOS_WARNING ((AE_INFO
,
249 "64-bit Physical Address in XSDT is too large (0x%8.8X%8.8X),"
251 ACPI_FORMAT_UINT64 (Address64
)));
254 return ((ACPI_PHYSICAL_ADDRESS
) (Address64
));
259 /*******************************************************************************
261 * FUNCTION: AcpiTbParseRootTable
263 * PARAMETERS: Rsdp - Pointer to the RSDP
267 * DESCRIPTION: This function is called to parse the Root System Description
268 * Table (RSDT or XSDT)
270 * NOTE: Tables are mapped (not copied) for efficiency. The FACS must
271 * be mapped and cannot be copied because it contains the actual
272 * memory location of the ACPI Global Lock.
274 ******************************************************************************/
277 AcpiTbParseRootTable (
278 ACPI_PHYSICAL_ADDRESS RsdpAddress
)
280 ACPI_TABLE_RSDP
*Rsdp
;
281 UINT32 TableEntrySize
;
284 ACPI_TABLE_HEADER
*Table
;
285 ACPI_PHYSICAL_ADDRESS Address
;
292 ACPI_FUNCTION_TRACE (TbParseRootTable
);
295 /* Map the entire RSDP and extract the address of the RSDT or XSDT */
297 Rsdp
= AcpiOsMapMemory (RsdpAddress
, sizeof (ACPI_TABLE_RSDP
));
300 return_ACPI_STATUS (AE_NO_MEMORY
);
303 AcpiTbPrintTableHeader (RsdpAddress
,
304 ACPI_CAST_PTR (ACPI_TABLE_HEADER
, Rsdp
));
306 /* Use XSDT if present and not overridden. Otherwise, use RSDT */
308 if ((Rsdp
->Revision
> 1) &&
309 Rsdp
->XsdtPhysicalAddress
&&
310 !AcpiGbl_DoNotUseXsdt
)
313 * RSDP contains an XSDT (64-bit physical addresses). We must use
314 * the XSDT if the revision is > 1 and the XSDT pointer is present,
315 * as per the ACPI specification.
317 Address
= (ACPI_PHYSICAL_ADDRESS
) Rsdp
->XsdtPhysicalAddress
;
318 TableEntrySize
= ACPI_XSDT_ENTRY_SIZE
;
322 /* Root table is an RSDT (32-bit physical addresses) */
324 Address
= (ACPI_PHYSICAL_ADDRESS
) Rsdp
->RsdtPhysicalAddress
;
325 TableEntrySize
= ACPI_RSDT_ENTRY_SIZE
;
329 * It is not possible to map more than one entry in some environments,
330 * so unmap the RSDP here before mapping other tables
332 AcpiOsUnmapMemory (Rsdp
, sizeof (ACPI_TABLE_RSDP
));
334 /* Map the RSDT/XSDT table header to get the full table length */
336 Table
= AcpiOsMapMemory (Address
, sizeof (ACPI_TABLE_HEADER
));
339 return_ACPI_STATUS (AE_NO_MEMORY
);
342 AcpiTbPrintTableHeader (Address
, Table
);
345 * Validate length of the table, and map entire table.
346 * Minimum length table must contain at least one entry.
348 Length
= Table
->Length
;
349 AcpiOsUnmapMemory (Table
, sizeof (ACPI_TABLE_HEADER
));
351 if (Length
< (sizeof (ACPI_TABLE_HEADER
) + TableEntrySize
))
353 ACPI_BIOS_ERROR ((AE_INFO
,
354 "Invalid table length 0x%X in RSDT/XSDT", Length
));
355 return_ACPI_STATUS (AE_INVALID_TABLE_LENGTH
);
358 Table
= AcpiOsMapMemory (Address
, Length
);
361 return_ACPI_STATUS (AE_NO_MEMORY
);
364 /* Validate the root table checksum */
366 Status
= AcpiTbVerifyChecksum (Table
, Length
);
367 if (ACPI_FAILURE (Status
))
369 AcpiOsUnmapMemory (Table
, Length
);
370 return_ACPI_STATUS (Status
);
373 /* Get the number of entries and pointer to first entry */
375 TableCount
= (UINT32
) ((Table
->Length
- sizeof (ACPI_TABLE_HEADER
)) /
377 TableEntry
= ACPI_ADD_PTR (UINT8
, Table
, sizeof (ACPI_TABLE_HEADER
));
379 /* Initialize the root table array from the RSDT/XSDT */
381 for (i
= 0; i
< TableCount
; i
++)
383 /* Get the table physical address (32-bit for RSDT, 64-bit for XSDT) */
385 Address
= AcpiTbGetRootTableEntry (TableEntry
, TableEntrySize
);
387 /* Skip NULL entries in RSDT/XSDT */
394 Status
= AcpiTbInstallStandardTable (Address
,
395 ACPI_TABLE_ORIGIN_INTERNAL_PHYSICAL
, FALSE
, TRUE
, &TableIndex
);
397 if (ACPI_SUCCESS (Status
) &&
399 &AcpiGbl_RootTableList
.Tables
[TableIndex
].Signature
,
402 AcpiGbl_FadtIndex
= TableIndex
;
408 TableEntry
+= TableEntrySize
;
411 AcpiOsUnmapMemory (Table
, Length
);
412 return_ACPI_STATUS (AE_OK
);