1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/** @file
ASL dynamic update library definitions.
This library provides dymanic update to various ASL structures.
There may be different libraries for different environments (PEI, BS, RT, SMM).
Make sure you meet the requirements for the library (protocol dependencies, use
restrictions, etc).
Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
**/
#ifndef _ASL_UPDATE_LIB_H_
#define _ASL_UPDATE_LIB_H_
//
// Include files
//
#include <IndustryStandard/Acpi.h>
#include <Protocol/AcpiTable.h>
#include <Protocol/AcpiSupport.h>
//
// AML parsing definitions
//
#define AML_RESRC_TEMP_END_TAG 0x0079
//
// ASL PSS package structure layout
//
#pragma pack (1)
typedef struct {
UINT8 NameOp; /// 12h ;First opcode is a NameOp.
UINT8 PackageLead; /// 20h ;First opcode is a NameOp.
UINT8 NumEntries; /// 06h ;First opcode is a NameOp.
UINT8 DwordPrefix1; /// 0Ch
UINT32 CoreFrequency; /// 00h
UINT8 DwordPrefix2; /// 0Ch
UINT32 Power; /// 00h
UINT8 DwordPrefix3; /// 0Ch
UINT32 TransLatency; /// 00h
UINT8 DwordPrefix4; /// 0Ch
UINT32 BMLatency; /// 00h
UINT8 DwordPrefix5; /// 0Ch
UINT32 Control; /// 00h
UINT8 DwordPrefix6; /// 0Ch
UINT32 Status; /// 00h
} PSS_PACKAGE_LAYOUT;
#pragma pack()
/**
Initialize the ASL update library state.
This must be called prior to invoking other library functions.
@retval EFI_SUCCESS The function completed successfully.
**/
EFI_STATUS
InitializeAslUpdateLib (
VOID
);
/**
This procedure will update immediate value assigned to a Name
@param[in] AslSignature The signature of Operation Region that we want to update.
@param[in] Buffer Source of data to be written over original aml
@param[in] Length Length of data to be overwritten
@retval EFI_SUCCESS The function completed successfully.
**/
EFI_STATUS
UpdateNameAslCode(
IN UINT32 AslSignature,
IN VOID *Buffer,
IN UINTN Length
);
/**
This function uses the ACPI support protocol to locate an ACPI table using the .
It is really only useful for finding tables that only have a single instance,
e.g. FADT, FACS, MADT, etc. It is not good for locating SSDT, etc.
Matches are determined by finding the table with ACPI table that has
a matching signature and version.
@param[in] Signature Pointer to an ASCII string containing the Signature to match
@param[in, out] Table Updated with a pointer to the table
@param[in, out] Handle AcpiSupport protocol table handle for the table found
@retval EFI_SUCCESS The function completed successfully.
**/
EFI_STATUS
LocateAcpiTableBySignature (
IN UINT32 Signature,
IN OUT EFI_ACPI_DESCRIPTION_HEADER **Table,
IN OUT UINTN *Handle
);
/**
This function uses the ACPI support protocol to locate an ACPI SSDT table.
The table is located by searching for a matching OEM Table ID field.
Partial match searches are supported via the TableIdSize parameter.
@param[in] TableId Pointer to an ASCII string containing the OEM Table ID from the ACPI table header
@param[in] TableIdSize Length of the TableId to match. Table ID are 8 bytes long, this function
will consider it a match if the first TableIdSize bytes match
@param[in, out] Table Updated with a pointer to the table
@param[in, out] Handle AcpiSupport protocol table handle for the table found
@retval EFI_SUCCESS The function completed successfully.
**/
EFI_STATUS
LocateAcpiTableByOemTableId (
IN UINT8 *TableId,
IN UINT8 TableIdSize,
IN OUT EFI_ACPI_DESCRIPTION_HEADER **Table,
IN OUT UINTN *Handle
);
/**
This function calculates and updates an UINT8 checksum.
@param[in] Buffer Pointer to buffer to checksum
@param[in] Size Number of bytes to checksum
@param[in] ChecksumOffset Offset to place the checksum result in
@retval EFI_SUCCESS The function completed successfully.
**/
EFI_STATUS
AcpiChecksum (
IN VOID *Buffer,
IN UINTN Size,
IN UINTN ChecksumOffset
);
#endif
|
