/** @file The PEI Library Implements SmmControl Support. @copyright INTEL CONFIDENTIAL Copyright 1999 - 2020 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 **/ #include "PchSmmControlLib.h" #include #include STATIC PEI_SMM_CONTROL_PPI mSmmControlPpi = { PeiActivate, PeiDeactivate }; STATIC EFI_PEI_PPI_DESCRIPTOR mPpiList = { (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST), &gEfiPeiMmControlPpiGuid, &mSmmControlPpi }; /** This function install PEI SMM Control PPI **/ VOID PchSmmControlInit ( VOID ) { EFI_STATUS Status; Status = PeiServicesInstallPpi (&mPpiList); ASSERT_EFI_ERROR (Status); } /** Trigger the software SMI @param[in] Data The value to be set on the software SMI data port @retval EFI_SUCCESS Function completes successfully **/ EFI_STATUS EFIAPI SmmTrigger ( IN UINT8 Data ) { UINT32 OutputData; UINT32 OutputPort; UINT16 PmBase; PmBase = PmcGetAcpiBase (); /// /// Enable the APMC SMI /// OutputPort = PmBase + R_ACPI_IO_SMI_EN; OutputData = IoRead32 ((UINTN) OutputPort); OutputData |= (B_ACPI_IO_SMI_EN_APMC | B_ACPI_IO_SMI_EN_GBL_SMI); DEBUG ( (DEBUG_VERBOSE, "The SMI Control Port at address %x will be written to %x.\n", OutputPort, OutputData) ); IoWrite32 ( (UINTN) OutputPort, (UINT32) (OutputData) ); OutputPort = R_PCH_IO_APM_CNT; OutputData = Data; /// /// Generate the APMC SMI /// IoWrite8 ( (UINTN) OutputPort, (UINT8) (OutputData) ); return EFI_SUCCESS; } /** Clear the SMI status @retval EFI_SUCCESS The function completes successfully @retval EFI_DEVICE_ERROR Something error occurred **/ EFI_STATUS EFIAPI SmmClear ( VOID ) { UINT32 OutputData; UINT32 OutputPort; UINT16 PmBase; PmBase = PmcGetAcpiBase (); /// /// Clear the Power Button Override Status Bit, it gates EOS from being set. /// OutputPort = PmBase + R_ACPI_IO_PM1_STS; OutputData = B_ACPI_IO_PM1_STS_PRBTNOR; DEBUG ( (DEBUG_VERBOSE, "The PM1 Status Port at address %x will be written to %x.\n", OutputPort, OutputData) ); IoWrite16 ( (UINTN) OutputPort, (UINT16) (OutputData) ); /// /// Clear the APM SMI Status Bit /// OutputPort = PmBase + R_ACPI_IO_SMI_STS; OutputData = B_ACPI_IO_SMI_STS_APM; DEBUG ( (DEBUG_VERBOSE, "The SMI Status Port at address %x will be written to %x.\n", OutputPort, OutputData) ); IoWrite32 ( (UINTN) OutputPort, (UINT32) (OutputData) ); /// /// Set the EOS Bit /// OutputPort = PmBase + R_ACPI_IO_SMI_EN; OutputData = IoRead32 ((UINTN) OutputPort); OutputData |= B_ACPI_IO_SMI_EN_EOS; DEBUG ( (DEBUG_VERBOSE, "The SMI Control Port at address %x will be written to %x.\n", OutputPort, OutputData) ); IoWrite32 ( (UINTN) OutputPort, (UINT32) (OutputData) ); /// /// If the EOS bit did not get set, then we've got a problem. /// DEBUG_CODE ( OutputData = IoRead32 ((UINTN) OutputPort); if ((OutputData & B_ACPI_IO_SMI_EN_EOS) != B_ACPI_IO_SMI_EN_EOS) { DEBUG ((DEBUG_ERROR, "Bugger, EOS did not get set!\n")); return EFI_DEVICE_ERROR; } ); return EFI_SUCCESS; } /** This routine generates an SMI @param[in] PeiServices General purpose services available to every PEIM. @param[in] This The EFI SMM Control ppi instance @param[in, out] ArgumentBuffer The buffer of argument @param[in, out] ArgumentBufferSize The size of the argument buffer @param[in] Periodic Periodic or not @param[in] ActivationInterval Interval of periodic SMI @retval EFI Status Describing the result of the operation @retval EFI_INVALID_PARAMETER Some parameter value passed is not supported **/ EFI_STATUS EFIAPI PeiActivate ( IN EFI_PEI_SERVICES **PeiServices, IN PEI_SMM_CONTROL_PPI *This, IN OUT INT8 *ArgumentBuffer OPTIONAL, IN OUT UINTN *ArgumentBufferSize OPTIONAL, IN BOOLEAN Periodic OPTIONAL, IN UINTN ActivationInterval OPTIONAL ) { EFI_STATUS Status; UINT8 Data; if (Periodic) { DEBUG ((DEBUG_WARN, "Invalid parameter\n")); return EFI_INVALID_PARAMETER; } if (ArgumentBuffer == NULL) { Data = 0xFF; } else { if (ArgumentBufferSize == NULL || *ArgumentBufferSize != 1) { return EFI_INVALID_PARAMETER; } Data = *ArgumentBuffer; } /// /// Clear any pending the APM SMI /// Status = SmmClear (); if (EFI_ERROR (Status)) { return Status; } return SmmTrigger (Data); } /** This routine clears an SMI @param[in] PeiServices General purpose services available to every PEIM. @param[in] This The EFI SMM Control ppi instance @param[in] Periodic Periodic or not @retval EFI Status Describing the result of the operation @retval EFI_INVALID_PARAMETER Some parameter value passed is not supported **/ EFI_STATUS EFIAPI PeiDeactivate ( IN EFI_PEI_SERVICES **PeiServices, IN PEI_SMM_CONTROL_PPI *This, IN BOOLEAN Periodic OPTIONAL ) { if (Periodic) { return EFI_INVALID_PARAMETER; } return SmmClear (); }