]>
Commit | Line | Data |
---|---|---|
3cbfba02 DW |
1 | /*++\r |
2 | \r | |
3 | Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>\r | |
4 | \r\r | |
5 | This program and the accompanying materials are licensed and made available under\r\r | |
6 | the terms and conditions of the BSD License that accompanies this distribution. \r\r | |
7 | The full text of the license may be found at \r\r | |
8 | http://opensource.org/licenses/bsd-license.php. \r\r | |
9 | \r\r | |
10 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r\r | |
11 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r\r | |
12 | \r\r | |
13 | \r | |
14 | Module Name:\r | |
15 | \r | |
16 | AcpiPlatformHooksLib.h\r | |
17 | \r | |
18 | Abstract:\r | |
19 | \r | |
20 | This is an implementation of the ACPI platform driver. Requirements for\r | |
21 | this driver are defined in the Tiano ACPI External Product Specification,\r | |
22 | revision 0.3.6.\r | |
23 | \r | |
24 | --*/\r | |
25 | \r | |
26 | #ifndef _ACPI_PLATFORM_HOOKS_LIB_H_\r | |
27 | #define _ACPI_PLATFORM_HOOKS_LIB_H_\r | |
28 | \r | |
29 | //\r | |
30 | // Statements that include other header files.\r | |
31 | //\r | |
32 | #include <IndustryStandard/Acpi.h>\r | |
33 | \r | |
34 | /**\r | |
35 | Returns the ACPI table version that the platform wants.\r | |
36 | \r | |
37 | @param[in] None\r | |
38 | \r | |
39 | @retval EFI_ACPI_TABLE_VERSION_NONE if ACPI is to be disabled.\r | |
40 | @retval EFI_ACPI_TABLE_VERSION_1_0B if 1.0b.\r | |
41 | @retval EFI_ACPI_TABLE_VERSION_2_00 if 2.00.\r | |
42 | **/\r | |
43 | EFI_ACPI_TABLE_VERSION\r | |
44 | AcpiPlatformHooksGetAcpiTableVersion (\r | |
45 | VOID\r | |
46 | );\r | |
47 | \r | |
48 | /**\r | |
49 | Returns the OEMID, OEM Table ID, OEM Revision.\r | |
50 | \r | |
51 | @param[in] None\r | |
52 | \r | |
53 | @retval OemId OEM ID string for ACPI tables, maximum 6 ASCII characters.\r | |
54 | This is an OEM-supplied string that identifies the OEM.\r | |
55 | @retval OemTableId An OEM-supplied string that the OEM uses to identify\r | |
56 | the particular data table. This field is particularly useful\r | |
57 | when defining a definition block to distinguish definition block\r | |
58 | functions. The OEM assigns each dissimilar table a new OEM Table ID.\r | |
59 | @retval OemRevision An OEM-supplied revision number for ACPI tables.\r | |
60 | Larger numbers are assumed to be newer revisions.\r | |
61 | \r | |
62 | **/\r | |
63 | EFI_STATUS\r | |
64 | AcpiPlatformHooksGetOemFields (\r | |
65 | OUT UINT8 *OemId,\r | |
66 | OUT UINT64 *OemTableId,\r | |
67 | OUT UINT32 *OemRevision\r | |
68 | );\r | |
69 | \r | |
70 | /**\r | |
71 | Called for every ACPI table found in the BIOS flash.\r | |
72 | Returns whether a table is active or not. Inactive tables\r | |
73 | are not published in the ACPI table list. This hook can be\r | |
74 | used to implement optional SSDT tables or enabling/disabling\r | |
75 | specific functionality (e.g. SPCR table) based on a setup\r | |
76 | switch or platform preference. In case of optional SSDT tables,\r | |
77 | the platform flash will include all the SSDT tables but will\r | |
78 | return EFI_SUCCESS only for those tables that need to be\r | |
79 | published.\r | |
80 | This hook can also be used to update the table data. The header\r | |
81 | is updated by the common code. For example, if a platform wants\r | |
82 | to use an SSDT table to export some platform settings to the\r | |
83 | ACPI code, it needs to update the data inside that SSDT based\r | |
84 | on platform preferences in this hook.\r | |
85 | \r | |
86 | @param[in] None\r | |
87 | \r | |
88 | @retval EFI_SUCCESS if the table is active.\r | |
89 | @retval EFI_UNSUPPORTED if the table is not active.\r | |
90 | **/\r | |
91 | EFI_STATUS\r | |
92 | AcpiPlatformHooksIsActiveTable (\r | |
93 | IN OUT EFI_ACPI_COMMON_HEADER *Table\r | |
94 | );\r | |
95 | \r | |
96 | #endif\r |