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
|
/** @file
ASL dynamic update library definitions.
This library provides dynamic 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).
Note that the current version of the library updates AML.
Copyright (c) 2020 Intel Corporation. All rights reserved. <BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#ifndef _ASL_UPDATE_LIB_H_
#define _ASL_UPDATE_LIB_H_
//
// Include files
//
#include <Uefi/UefiBaseType.h>
#include <IndustryStandard/Acpi.h>
#include <Protocol/AcpiTable.h>
#include <Protocol/AcpiSystemDescriptionTable.h>
/**
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.
@retval EFI_NOT_FOUND Failed to locate AcpiTable.
@retval EFI_NOT_READY Not ready to locate AcpiTable.
@retval EFI_UNSUPPORTED The function is not supported in this library.
**/
EFI_STATUS
EFIAPI
UpdateNameAslCode(
IN UINT32 AslSignature,
IN VOID *Buffer,
IN UINTN Length
);
/**
This procedure will update immediate value assigned to a Name in SSDT table.
@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
@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.
@retval EFI_NOT_FOUND - Failed to locate AcpiTable.
@retval EFI_NOT_READY - Not ready to locate AcpiTable.
@retval EFI_UNSUPPORTED - The function is not supported in this library.
**/
EFI_STATUS
EFIAPI
UpdateSsdtNameAslCode (
IN UINT8 *TableId,
IN UINT8 TableIdSize,
IN UINT32 AslSignature,
IN VOID *Buffer,
IN UINTN Length
);
/**
This procedure will update the name of ASL Method.
@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.
@retval EFI_NOT_FOUND - Failed to locate AcpiTable.
@retval EFI_NOT_READY - Not ready to locate AcpiTable.
@retval EFI_UNSUPPORTED - The function is not supported in this library.
**/
EFI_STATUS
EFIAPI
UpdateMethodAslCode (
IN UINT32 AslSignature,
IN VOID *Buffer,
IN UINTN Length
);
/**
This function uses the ACPI support protocol to locate an ACPI table.
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.
@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
@see AcpiSupport protocol for details
@retval EFI_SUCCESS The function completed successfully.
@retval EFI_NOT_FOUND Failed to locate AcpiTable.
@retval EFI_NOT_READY Not ready to locate AcpiTable.
@retval EFI_UNSUPPORTED The function is not supported in this library.
**/
EFI_STATUS
EFIAPI
LocateAcpiTableBySignature (
IN UINT32 Signature,
IN OUT EFI_ACPI_DESCRIPTION_HEADER **Table,
IN OUT UINTN *Handle
);
#endif
|
