/** @file
|
PCH Init Smm module for PCH specific SMI handlers.
|
|
Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
**/
|
#include "PchInitSmm.h"
|
|
GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL *mPchIoTrap;
|
GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_SX_DISPATCH2_PROTOCOL *mSxDispatch;
|
|
GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA *mPchNvsArea;
|
GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mAcpiBaseAddr;
|
|
//
|
// NOTE: The module variables of policy here are only valid in post time, but not runtime time.
|
//
|
GLOBAL_REMOVE_IF_UNREFERENCED PCH_CONFIG_HOB *mPchConfigHob;
|
GLOBAL_REMOVE_IF_UNREFERENCED SI_CONFIG_HOB *mSiConfigHob;
|
|
//
|
// The reserved MMIO range to be used in Sx handler
|
//
|
GLOBAL_REMOVE_IF_UNREFERENCED EFI_PHYSICAL_ADDRESS mResvMmioBaseAddr;
|
GLOBAL_REMOVE_IF_UNREFERENCED UINTN mResvMmioSize;
|
//
|
// The reserved MMIO range to be used by xHCI ASL code
|
//
|
GLOBAL_REMOVE_IF_UNREFERENCED EFI_PHYSICAL_ADDRESS mXhciMmioBaseAddr;
|
|
/**
|
SMBUS Sx entry SMI handler.
|
**/
|
VOID
|
SmbusSxCallback (
|
VOID
|
)
|
{
|
UINTN SmbusRegBase;
|
UINT16 SmbusIoBase;
|
|
SmbusRegBase = MmPciBase (
|
DEFAULT_PCI_BUS_NUMBER_PCH,
|
PCI_DEVICE_NUMBER_PCH_SMBUS,
|
PCI_FUNCTION_NUMBER_PCH_SMBUS
|
);
|
|
if (MmioRead32 (SmbusRegBase) == 0xFFFFFFFF) {
|
return;
|
}
|
|
SmbusIoBase = MmioRead16 (SmbusRegBase + R_PCH_SMBUS_BASE) & B_PCH_SMBUS_BASE_BAR;
|
if (SmbusIoBase == 0) {
|
return;
|
}
|
|
MmioOr8 (SmbusRegBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_IO_SPACE);
|
//
|
// Clear SMBUS status and SMB_WAK_STS of GPE0
|
//
|
IoWrite8 (SmbusIoBase + R_PCH_SMBUS_HSTS, B_PCH_SMBUS_SMBALERT_STS);
|
IoWrite32 (mAcpiBaseAddr + R_PCH_ACPI_GPE0_STS_127_96, B_PCH_ACPI_GPE0_STS_127_96_SMB_WAK);
|
}
|
|
/**
|
PCH Sx entry SMI handler.
|
|
@param[in] Handle Handle of the callback
|
@param[in] Context The dispatch context
|
@param[in,out] CommBuffer A pointer to a collection of data in memory that will
|
be conveyed from a non-SMM environment into an SMM environment.
|
@param[in,out] CommBufferSize The size of the CommBuffer.
|
|
@retval EFI_SUCCESS
|
**/
|
EFI_STATUS
|
EFIAPI
|
PchSxHandler (
|
IN EFI_HANDLE Handle,
|
IN CONST VOID *Context OPTIONAL,
|
IN OUT VOID *CommBuffer OPTIONAL,
|
IN OUT UINTN *CommBufferSize OPTIONAL
|
)
|
{
|
PchGpioSxIsolationCallback ();
|
PchLanSxCallback ();
|
|
if (((EFI_SMM_SX_REGISTER_CONTEXT*)Context)->Type == SxS3) {
|
PchXhciS3Callback ();
|
}
|
|
SmbusSxCallback ();
|
|
return EFI_SUCCESS;
|
}
|
|
/**
|
Initialize PCH Sx entry SMI handler.
|
|
@param[in] ImageHandle - Handle for the image of this driver
|
**/
|
VOID
|
InitializeSxHandler (
|
IN EFI_HANDLE ImageHandle
|
)
|
{
|
EFI_SMM_SX_REGISTER_CONTEXT SxDispatchContext;
|
EFI_HANDLE SxDispatchHandle;
|
EFI_SLEEP_TYPE SxType;
|
EFI_STATUS Status;
|
|
DEBUG ((DEBUG_INFO, "InitializeSxHandler() Start\n"));
|
|
//
|
// Register the callback for S3/S4/S5 entry
|
//
|
SxDispatchContext.Phase = SxEntry;
|
for (SxType = SxS3; SxType <= SxS5; SxType++) {
|
SxDispatchContext.Type = SxType;
|
Status = mSxDispatch->Register (
|
mSxDispatch,
|
PchSxHandler,
|
&SxDispatchContext,
|
&SxDispatchHandle
|
);
|
ASSERT_EFI_ERROR (Status);
|
}
|
|
DEBUG ((DEBUG_INFO, "InitializeSxHandler() End\n"));
|
}
|
|
/**
|
Allocates reserved MMIO for Sx SMI handler use.
|
|
This function is only called from entry point therefore DXE/boot Services can be used here.
|
Updates ACPI NVS location to reserve allocated MMIO range as system resource.
|
**/
|
VOID
|
AllocateReservedMmio (
|
IN EFI_HANDLE ImageHandle
|
)
|
{
|
PCH_NVS_AREA_PROTOCOL *PchNvsAreaProtocol;
|
EFI_STATUS Status;
|
|
mResvMmioSize = 1 << N_PCH_LAN_MBARA_ALIGN;
|
|
if ((PcdGet8 (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchBottomUp) || (PcdGet8 (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchTopDown)) {
|
mResvMmioBaseAddr = 0xFFFFFFFF;
|
}
|
Status = gDS->AllocateMemorySpace (
|
PcdGet8 (PcdEfiGcdAllocateType),
|
EfiGcdMemoryTypeMemoryMappedIo,
|
N_PCH_LAN_MBARA_ALIGN,
|
mResvMmioSize,
|
&mResvMmioBaseAddr,
|
ImageHandle,
|
NULL
|
);
|
ASSERT_EFI_ERROR (Status);
|
|
DEBUG ((DEBUG_INFO, "mResvMmioBaseAddr %x\n", mResvMmioBaseAddr));
|
|
//
|
// Locate the PCH shared data area and update reserved memory base address
|
//
|
Status = gBS->LocateProtocol (&gPchNvsAreaProtocolGuid, NULL, (VOID **) &PchNvsAreaProtocol);
|
ASSERT_EFI_ERROR (Status);
|
|
PchNvsAreaProtocol->Area->SxMemSize = (UINT32) mResvMmioSize;
|
PchNvsAreaProtocol->Area->SxMemBase = (UINT32) mResvMmioBaseAddr;
|
|
//
|
// Install and initialize all the needed protocols
|
//
|
if ((PcdGet8 (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchBottomUp) || (PcdGet8 (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchTopDown)) {
|
mXhciMmioBaseAddr = 0xFFFFFFFF;
|
}
|
Status = gDS->AllocateMemorySpace (
|
PcdGet8 (PcdEfiGcdAllocateType),
|
EfiGcdMemoryTypeMemoryMappedIo,
|
N_PCH_XHCI_MEM_ALIGN,
|
V_PCH_XHCI_MEM_LENGTH,
|
&mXhciMmioBaseAddr,
|
ImageHandle,
|
NULL
|
);
|
ASSERT_EFI_ERROR (Status);
|
DEBUG ((DEBUG_INFO, "mXhciMmioBaseAddr %x\n", mXhciMmioBaseAddr));
|
|
//
|
// Update XWMB, XHCI memory base address
|
//
|
PchNvsAreaProtocol->Area->XhciRsvdMemBase = (UINT32) mXhciMmioBaseAddr;
|
}
|
|
/**
|
Initializes the PCH SMM handler for for PCIE hot plug support
|
<b>PchInit SMM Module Entry Point</b>\n
|
- <b>Introduction</b>\n
|
The PchInitSmm module is a SMM driver that initializes the Intel Platform Controller Hub
|
SMM requirements and services. It consumes the PCH_POLICY_HOB and SI_POLICY_HOB for expected
|
configurations per policy.
|
|
- <b>Details</b>\n
|
This module provides SMI handlers to services PCIE HotPlug SMI, LinkActive SMI, and LinkEq SMI.
|
And also provides port 0x61 emulation support, registers BIOS WP handler to process BIOSWP status,
|
and registers SPI Async SMI handler to handler SPI Async SMI.
|
This module also registers Sx SMI callback function to detail with GPIO Sx Isolation and LAN requirement.
|
|
- @pre
|
- PCH PCR base address configured
|
- EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
|
- This is to ensure that PCI MMIO and IO resource has been prepared and available for this driver to allocate.
|
- EFI_SMM_BASE2_PROTOCOL
|
- EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL
|
- EFI_SMM_SX_DISPATCH2_PROTOCOL
|
- EFI_SMM_CPU_PROTOCOL
|
- @link _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL PCH_SMM_IO_TRAP_CONTROL_PROTOCOL @endlink
|
- @link _PCH_SMI_DISPATCH_PROTOCOL PCH_SMI_DISPATCH_PROTOCOL @endlink
|
- @link _PCH_PCIE_SMI_DISPATCH_PROTOCOL PCH_PCIE_SMI_DISPATCH_PROTOCOL @endlink
|
- @link _PCH_TCO_SMI_DISPATCH_PROTOCOL PCH_TCO_SMI_DISPATCH_PROTOCOL @endlink
|
- @link _PCH_ESPI_SMI_DISPATCH_PROTOCOL PCH_ESPI_SMI_DISPATCH_PROTOCOL @endlink
|
|
- <b>References</b>\n
|
- @link _PCH_POLICY PCH_POLICY_HOB @endlink.
|
- @link _SI_POLICY_STRUCT SI_POLICY_HOB @endlink.
|
|
- <b>Integration Checklists</b>\n
|
- Verify prerequisites are met. Porting Recommendations.
|
- No modification of this module should be necessary
|
- Any modification of this module should follow the PCH BIOS Specification and EDS
|
|
@param[in] ImageHandle - Handle for the image of this driver
|
@param[in] SystemTable - Pointer to the EFI System Table
|
|
@retval EFI_SUCCESS - PCH SMM handler was installed
|
**/
|
EFI_STATUS
|
EFIAPI
|
PchInitSmmEntryPoint (
|
IN EFI_HANDLE ImageHandle,
|
IN EFI_SYSTEM_TABLE *SystemTable
|
)
|
{
|
EFI_STATUS Status;
|
PCH_NVS_AREA_PROTOCOL *PchNvsAreaProtocol;
|
EFI_PEI_HOB_POINTERS HobPtr;
|
|
DEBUG ((DEBUG_INFO, "PchInitSmmEntryPoint()\n"));
|
|
Status = gSmst->SmmLocateProtocol (
|
&gEfiSmmIoTrapDispatch2ProtocolGuid,
|
NULL,
|
(VOID **) &mPchIoTrap
|
);
|
ASSERT_EFI_ERROR (Status);
|
|
Status = gSmst->SmmLocateProtocol (
|
&gEfiSmmSxDispatch2ProtocolGuid,
|
NULL,
|
(VOID**) &mSxDispatch
|
);
|
ASSERT_EFI_ERROR (Status);
|
|
Status = gBS->LocateProtocol (&gPchNvsAreaProtocolGuid, NULL, (VOID **) &PchNvsAreaProtocol);
|
ASSERT_EFI_ERROR (Status);
|
mPchNvsArea = PchNvsAreaProtocol->Area;
|
|
//
|
// Get PCH Data HOB.
|
//
|
HobPtr.Guid = GetFirstGuidHob (&gPchConfigHobGuid);
|
ASSERT (HobPtr.Guid != NULL);
|
mPchConfigHob = (PCH_CONFIG_HOB *) GET_GUID_HOB_DATA (HobPtr.Guid);
|
|
HobPtr.Guid = GetFirstGuidHob (&gSiConfigHobGuid);
|
ASSERT (HobPtr.Guid != NULL);
|
mSiConfigHob = (SI_CONFIG_HOB *) GET_GUID_HOB_DATA (HobPtr.Guid);
|
|
PchAcpiBaseGet (&mAcpiBaseAddr);
|
|
AllocateReservedMmio (ImageHandle);
|
|
InitializeSxHandler (ImageHandle);
|
|
Status = InitializePchPcieSmm (ImageHandle, SystemTable);
|
ASSERT_EFI_ERROR (Status);
|
|
Status = InstallIoTrapPort61h (ImageHandle, SystemTable);
|
ASSERT_EFI_ERROR (Status);
|
|
Status = InstallPchBiosWriteProtect (ImageHandle, SystemTable);
|
ASSERT_EFI_ERROR (Status);
|
|
Status = InstallPchSpiAsyncSmiHandler ();
|
ASSERT_EFI_ERROR (Status);
|
|
|
return EFI_SUCCESS;
|
}
|
