/** @file
|
PCH SPI SMM Driver implements the SPI Host Controller Compatibility Interface.
|
|
Copyright (c) 2019 Intel Corporation. All rights reserved. <BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
**/
|
|
#include "PchSpi.h"
|
|
//
|
// Global variables
|
//
|
GLOBAL_REMOVE_IF_UNREFERENCED SPI_INSTANCE *mSpiInstance;
|
//
|
// mPchSpiResvMmioAddr keeps the reserved MMIO range assiged to SPI.
|
// In SMM it always set back the reserved MMIO address to SPI BAR0 to ensure the MMIO range
|
// won't overlap with SMRAM range, and trusted.
|
//
|
GLOBAL_REMOVE_IF_UNREFERENCED UINT32 mSpiResvMmioAddr;
|
|
/**
|
<b>SPI Runtime SMM Module Entry Point</b>\n
|
- <b>Introduction</b>\n
|
The SPI SMM module provide a standard way for other modules to use the PCH SPI Interface in SMM.
|
|
- @pre
|
- EFI_SMM_BASE2_PROTOCOL
|
- Documented in System Management Mode Core Interface Specification .
|
|
- @result
|
The SPI SMM driver produces @link _PCH_SPI_PROTOCOL PCH_SPI_PROTOCOL @endlink with GUID
|
gPchSmmSpiProtocolGuid which is different from SPI RUNTIME driver.
|
|
- <b>Integration Check List</b>\n
|
- This driver supports Descriptor Mode only.
|
- This driver supports Hardware Sequence only.
|
- When using SMM SPI Protocol to perform flash access in an SMI handler,
|
and the SMI occurrence is asynchronous to normal mode code execution,
|
proper synchronization mechanism must be applied, e.g. disable SMI before
|
the normal mode SendSpiCmd() starts and re-enable SMI after
|
the normal mode SendSpiCmd() completes.
|
@note The implementation of SendSpiCmd() uses GBL_SMI_EN in
|
SMI_EN register (ABase + 30h) to disable and enable SMIs. But this may
|
not be effective as platform may well set the SMI_LOCK bit (i.e., PMC PCI Offset A0h [4]).
|
So the synchronization at caller level is likely needed.
|
|
@param[in] ImageHandle Image handle of this driver.
|
@param[in] SystemTable Global system service table.
|
|
@retval EFI_SUCCESS Initialization complete.
|
@exception EFI_UNSUPPORTED The chipset is unsupported by this driver.
|
@retval EFI_OUT_OF_RESOURCES Do not have enough resources to initialize the driver.
|
@retval EFI_DEVICE_ERROR Device error, driver exits abnormally.
|
**/
|
EFI_STATUS
|
EFIAPI
|
InstallPchSpi (
|
IN EFI_HANDLE ImageHandle,
|
IN EFI_SYSTEM_TABLE *SystemTable
|
)
|
{
|
EFI_STATUS Status;
|
|
//
|
// Init PCH spi reserved MMIO address.
|
//
|
mSpiResvMmioAddr = PCH_SPI_BASE_ADDRESS;
|
|
///
|
/// Allocate pool for SPI protocol instance
|
///
|
Status = gSmst->SmmAllocatePool (
|
EfiRuntimeServicesData, /// MemoryType don't care
|
sizeof (SPI_INSTANCE),
|
(VOID **) &mSpiInstance
|
);
|
if (EFI_ERROR (Status)) {
|
return Status;
|
}
|
|
if (mSpiInstance == NULL) {
|
return EFI_OUT_OF_RESOURCES;
|
}
|
|
ZeroMem ((VOID *) mSpiInstance, sizeof (SPI_INSTANCE));
|
///
|
/// Initialize the SPI protocol instance
|
///
|
Status = SpiProtocolConstructor (mSpiInstance);
|
if (EFI_ERROR (Status)) {
|
return Status;
|
}
|
//
|
// Install the SMM EFI_SPI_PROTOCOL interface
|
//
|
Status = gSmst->SmmInstallProtocolInterface (
|
&(mSpiInstance->Handle),
|
&gEfiSmmSpiProtocolGuid,
|
EFI_NATIVE_INTERFACE,
|
&(mSpiInstance->SpiProtocol)
|
);
|
if (EFI_ERROR (Status)) {
|
gSmst->SmmFreePool (mSpiInstance);
|
return EFI_DEVICE_ERROR;
|
}
|
|
return EFI_SUCCESS;
|
}
|
|
/**
|
Acquire PCH spi mmio address.
|
It is not expected for this BAR0 to change because the SPI device is hidden
|
from the OS for SKL PCH LP/H B stepping and above (refer to section 3.5.1),
|
but if it is ever different from the preallocated address, reassign it back.
|
In SMM, it always override the BAR0 and returns the reserved MMIO range for SPI.
|
|
@param[in] SpiInstance Pointer to SpiInstance to initialize
|
|
@retval PchSpiBar0 return SPI MMIO address
|
**/
|
UINTN
|
AcquireSpiBar0 (
|
IN SPI_INSTANCE *SpiInstance
|
)
|
{
|
//
|
// SPIBAR0 will be different before and after PCI enum so need to get it from SPI BAR0 reg.
|
//
|
return mSpiResvMmioAddr;
|
}
|
|
/**
|
Release pch spi mmio address. Do nothing.
|
|
@param[in] SpiInstance Pointer to SpiInstance to initialize
|
|
@retval None
|
**/
|
VOID
|
ReleaseSpiBar0 (
|
IN SPI_INSTANCE *SpiInstance
|
)
|
{
|
}
|
|
/**
|
This function is a hook for Spi to disable BIOS Write Protect
|
|
@retval EFI_SUCCESS The protocol instance was properly initialized
|
@retval EFI_ACCESS_DENIED The BIOS Region can only be updated in SMM phase
|
|
**/
|
EFI_STATUS
|
EFIAPI
|
DisableBiosWriteProtect (
|
VOID
|
)
|
{
|
|
return EFI_SUCCESS;
|
}
|
|
/**
|
This function is a hook for Spi to enable BIOS Write Protect
|
|
|
**/
|
VOID
|
EFIAPI
|
EnableBiosWriteProtect (
|
VOID
|
)
|
{
|
}
|
