/** @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 #include #include #include #include #include #include #include #include // // 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; }