214 lines
7.2 KiB
C
214 lines
7.2 KiB
C
/** @file
|
|
Boot service DXE ASL update library implementation.
|
|
|
|
These functions in this file can be called during DXE and cannot be called during runtime
|
|
or in SMM which should use a RT or SMM library.
|
|
|
|
This library uses the ACPI Support protocol.
|
|
|
|
@copyright
|
|
INTEL CONFIDENTIAL
|
|
Copyright 2015 - 2017 Intel Corporation.
|
|
|
|
The source code contained or described herein and all documents related to the
|
|
source code ("Material") are owned by Intel Corporation or its suppliers or
|
|
licensors. Title to the Material remains with Intel Corporation or its suppliers
|
|
and licensors. The Material may contain trade secrets and proprietary and
|
|
confidential information of Intel Corporation and its suppliers and licensors,
|
|
and is protected by worldwide copyright and trade secret laws and treaty
|
|
provisions. No part of the Material may be used, copied, reproduced, modified,
|
|
published, uploaded, posted, transmitted, distributed, or disclosed in any way
|
|
without Intel's prior express written permission.
|
|
|
|
No license under any patent, copyright, trade secret or other intellectual
|
|
property right is granted to or conferred upon you by disclosure or delivery
|
|
of the Materials, either expressly, by implication, inducement, estoppel or
|
|
otherwise. Any license under such intellectual property rights must be
|
|
express and approved by Intel in writing.
|
|
|
|
Unless otherwise agreed by Intel in writing, you may not remove or alter
|
|
this notice or any other notice embedded in Materials by Intel or
|
|
Intel's suppliers or licensors in any way.
|
|
|
|
This file contains an 'Intel Peripheral Driver' and is uniquely identified as
|
|
"Intel Reference Module" and is licensed for Intel CPUs and chipsets under
|
|
the terms of your license agreement with Intel or your vendor. This file may
|
|
be modified by the user, subject to additional terms of the license agreement.
|
|
|
|
@par Specification Reference:
|
|
**/
|
|
#include <Base.h>
|
|
#include <Uefi/UefiBaseType.h>
|
|
#include <Uefi/UefiSpec.h>
|
|
#include <Library/UefiBootServicesTableLib.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/UefiLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/MemoryAllocationLib.h>
|
|
|
|
#include <Library/AslUpdateLib.h>
|
|
|
|
//
|
|
// Function implemenations
|
|
//
|
|
|
|
/**
|
|
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
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
/**
|
|
This function calculates and updates an UINT8 checksum.
|
|
|
|
@param Buffer Pointer to buffer to checksum
|
|
@param Size Number of bytes to checksum
|
|
@param ChecksumOffset Offset to place the checksum result in
|
|
|
|
@return EFI_SUCCESS The function completed successfully.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
AcpiPlatformChecksum (
|
|
IN VOID *Buffer,
|
|
IN UINTN Size,
|
|
IN UINTN ChecksumOffset
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
|
|
/**
|
|
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
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
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] 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.
|
|
**/
|
|
EFI_STATUS
|
|
UpdateSsdtNameAslCode (
|
|
IN UINT8 *TableId,
|
|
IN UINT8 TableIdSize,
|
|
IN UINT32 AslSignature,
|
|
IN VOID *Buffer,
|
|
IN UINTN Length
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
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.
|
|
**/
|
|
EFI_STATUS
|
|
UpdateMethodAslCode (
|
|
IN UINT32 AslSignature,
|
|
IN VOID *Buffer,
|
|
IN UINTN Length
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
This function uses the ACPI SDT 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.
|
|
|
|
@param[in] Signature - Pointer to an ASCII string containing the OEM Table ID from the ACPI table header
|
|
@param[in, out] Table - Updated with a pointer to the table
|
|
@param[in, out] Handle - AcpiSupport protocol table handle for the table found
|
|
@param[in, out] Version - The version of the table desired
|
|
|
|
@retval EFI_SUCCESS - The function completed successfully.
|
|
**/
|
|
EFI_STATUS
|
|
LocateAcpiTableBySignature (
|
|
IN UINT32 Signature,
|
|
IN OUT EFI_ACPI_DESCRIPTION_HEADER **Table,
|
|
IN OUT UINTN *Handle
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
This function uses the ACPI SDT protocol to locate an ACPI 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
|
|
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
|
|
@param[in, out] Version - See AcpiSupport protocol, GetAcpiTable function for use
|
|
|
|
@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
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
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
|
|
)
|
|
{
|
|
return EFI_SUCCESS;
|
|
}
|