FspsWrapperPeim.c File Reference

#include <PiPei.h>
#include <Library/PeimEntryPoint.h>
#include <Library/PeiServicesLib.h>
#include <Library/PeiServicesTablePointerLib.h>
#include <Library/BaseLib.h>
#include <Library/DebugLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/HobLib.h>
#include <Library/PcdLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/FspWrapperPlatformLib.h>
#include <Library/FspWrapperHobProcessLib.h>
#include <Library/FspWrapperMultiPhaseProcessLib.h>
#include <Library/TimerLib.h>
#include <Library/PerformanceLib.h>
#include <Library/FspWrapperApiLib.h>
#include <Library/FspMeasurementLib.h>
#include <Ppi/FspSiliconInitDone.h>
#include <Ppi/EndOfPeiPhase.h>
#include <Ppi/MemoryDiscovered.h>
#include <Ppi/TemporaryRamDone.h>
#include <Ppi/SecPlatformInformation.h>
#include <Ppi/Tcg.h>
#include <Ppi/FirmwareVolumeInfoMeasurementExcluded.h>
#include <Library/FspWrapperApiTestLib.h>
#include <FspEas.h>
#include <FspStatusCode.h>
#include <FspGlobalData.h>

Go to the source code of this file.

Functions
EFI_STATUS EFIAPI	S3EndOfPeiNotify (IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDesc, IN VOID *Ppi)
EFI_STATUS EFIAPI	FspSiliconInitDoneGetFspHobList (IN CONST EFI_PEI_SERVICES **PeiServices, IN FSP_SILICON_INIT_DONE_PPI *This, OUT VOID **FspHobList)
UINTN	GetFspsUpdDataAddress (VOID)
EFI_STATUS EFIAPI	FspsWrapperEndOfPeiNotify (IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDesc, IN VOID *Ppi)
EFI_STATUS EFIAPI	PeiMemoryDiscoveredNotify (IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDesc, IN VOID *Ppi)
EFI_STATUS	FspsWrapperInitApiMode (VOID)
EFI_STATUS	FspsWrapperInitDispatchMode (VOID)
EFI_STATUS EFIAPI	TcgPpiNotify (IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDesc, IN VOID *Ppi)
EFI_STATUS EFIAPI	FspsWrapperPeimEntryPoint (IN EFI_PEI_FILE_HANDLE FileHandle, IN CONST EFI_PEI_SERVICES **PeiServices)

Variables
EFI_PEI_NOTIFY_DESCRIPTOR	mS3EndOfPeiNotifyDesc
EFI_GUID	gFspHobGuid
FSP_SILICON_INIT_DONE_PPI	mFspSiliconInitDonePpi
EFI_PEI_PPI_DESCRIPTOR	mPeiFspSiliconInitDonePpi
EFI_PEI_NOTIFY_DESCRIPTOR	mFspsWrapperEndOfPeiNotifyDesc
EFI_PEI_NOTIFY_DESCRIPTOR	mPeiMemoryDiscoveredNotifyDesc
EFI_PEI_NOTIFY_DESCRIPTOR	mTcgPpiNotifyDesc

Detailed Description

This will be invoked only once. It will call FspMemoryInit API, register TemporaryRamDonePpi to call TempRamExit API, and register MemoryDiscoveredPpi notify to call FspSiliconInit API.

Copyright (c) 2014 - 2021, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file FspsWrapperPeim.c.

Function Documentation

FspSiliconInitDoneGetFspHobList()

EFI_STATUS EFIAPI FspSiliconInitDoneGetFspHobList	(	IN CONST EFI_PEI_SERVICES **	PeiServices,
		IN FSP_SILICON_INIT_DONE_PPI *	This,
		OUT VOID **	FspHobList
	)

Return Hob list produced by FSP.

Parameters

[in]	PeiServices	The pointer to the PEI Services Table.
[in]	This	The pointer to this instance of this PPI.
[out]	FspHobList	The pointer to Hob list produced by FSP.

Returns

EFI_SUCCESS Return Hob list produced by FSP successfully.

Definition at line 169 of file FspsWrapperPeim.c.

FspsWrapperEndOfPeiNotify()

EFI_STATUS EFIAPI FspsWrapperEndOfPeiNotify	(	IN EFI_PEI_SERVICES **	PeiServices,
		IN EFI_PEI_NOTIFY_DESCRIPTOR *	NotifyDesc,
		IN VOID *	Ppi
	)

This function is for FSP dispatch mode to perform post FSP-S process.

Parameters

[in]	PeiServices	Pointer to PEI Services Table.
[in]	NotifyDesc	Pointer to the descriptor for the Notification event that caused this function to execute.
[in]	Ppi	Pointer to the PPI data associated with this function.

Return values

EFI_STATUS

Status returned by PeiServicesInstallPpi ()

Definition at line 215 of file FspsWrapperPeim.c.

FspsWrapperInitApiMode()

EFI_STATUS FspsWrapperInitApiMode

(

VOID

)

Do FSP initialization in API mode.

Return values

EFI_STATUS

Always return EFI_SUCCESS

Definition at line 384 of file FspsWrapperPeim.c.

FspsWrapperInitDispatchMode()

EFI_STATUS FspsWrapperInitDispatchMode

(

VOID

)

Do FSP initialization in Dispatch mode.

Return values

FSP	initialization status.

Definition at line 415 of file FspsWrapperPeim.c.

FspsWrapperPeimEntryPoint()

EFI_STATUS EFIAPI FspsWrapperPeimEntryPoint	(	IN EFI_PEI_FILE_HANDLE	FileHandle,
		IN CONST EFI_PEI_SERVICES **	PeiServices
	)

This is the entrypoint of PEIM.

Parameters

[in]	FileHandle	Handle of the file being invoked.
[in]	PeiServices	Describes the list of possible PEI Services.

Return values

EFI_SUCCESS

if it completed successfully.

Definition at line 535 of file FspsWrapperPeim.c.

GetFspsUpdDataAddress()

UINTN GetFspsUpdDataAddress

(

VOID

)

Get the FSP S UPD Data address

Returns

FSP-S UPD Data Address

Definition at line 192 of file FspsWrapperPeim.c.

PeiMemoryDiscoveredNotify()

EFI_STATUS EFIAPI PeiMemoryDiscoveredNotify	(	IN EFI_PEI_SERVICES **	PeiServices,
		IN EFI_PEI_NOTIFY_DESCRIPTOR *	NotifyDesc,
		IN VOID *	Ppi
	)

This function is called after PEI core discover memory and finish migration.

Parameters

[in]	PeiServices	Pointer to PEI Services Table.
[in]	NotifyDesc	Pointer to the descriptor for the Notification event that caused this function to execute.
[in]	Ppi	Pointer to the PPI data associated with this function.

Return values

EFI_STATUS

Always return EFI_SUCCESS

Definition at line 282 of file FspsWrapperPeim.c.

S3EndOfPeiNotify()

EFI_STATUS EFIAPI S3EndOfPeiNotify	(	IN EFI_PEI_SERVICES **	PeiServices,
		IN EFI_PEI_NOTIFY_DESCRIPTOR *	NotifyDesc,
		IN VOID *	Ppi
	)

This function handles S3 resume task at the end of PEI.

Parameters

[in]	PeiServices	Pointer to PEI Services Table.
[in]	NotifyDesc	Pointer to the descriptor for the Notification event that caused this function to execute.
[in]	Ppi	Pointer to the PPI data associated with this function.

Return values

EFI_STATUS

Always return EFI_SUCCESS

Definition at line 81 of file FspsWrapperPeim.c.

TcgPpiNotify()

EFI_STATUS EFIAPI TcgPpiNotify	(	IN EFI_PEI_SERVICES **	PeiServices,
		IN EFI_PEI_NOTIFY_DESCRIPTOR *	NotifyDesc,
		IN VOID *	Ppi
	)

This function is called after TCG installed PPI.

Parameters

[in]	PeiServices	Pointer to PEI Services Table.
[in]	NotifyDesc	Pointer to the descriptor for the Notification event that caused this function to execute.
[in]	Ppi	Pointer to the PPI data associated with this function.

Return values

EFI_STATUS

Always return EFI_SUCCESS

Definition at line 501 of file FspsWrapperPeim.c.

Variable Documentation

mFspSiliconInitDonePpi

FSP_SILICON_INIT_DONE_PPI mFspSiliconInitDonePpi

Initial value:

= {
  FspSiliconInitDoneGetFspHobList
}

Definition at line 148 of file FspsWrapperPeim.c.

mFspsWrapperEndOfPeiNotifyDesc

EFI_PEI_NOTIFY_DESCRIPTOR mFspsWrapperEndOfPeiNotifyDesc

Initial value:

= {
  (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  &gEfiEndOfPeiSignalPpiGuid,
  FspsWrapperEndOfPeiNotify
}

Definition at line 240 of file FspsWrapperPeim.c.

mPeiFspSiliconInitDonePpi

EFI_PEI_PPI_DESCRIPTOR mPeiFspSiliconInitDonePpi

Initial value:

= {
  EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST,
  &gFspSiliconInitDonePpiGuid,
  &mFspSiliconInitDonePpi
}

Definition at line 152 of file FspsWrapperPeim.c.

mPeiMemoryDiscoveredNotifyDesc

EFI_PEI_NOTIFY_DESCRIPTOR mPeiMemoryDiscoveredNotifyDesc

Initial value:

= {
  (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  &gEfiPeiMemoryDiscoveredPpiGuid,
  PeiMemoryDiscoveredNotify
}

Definition at line 264 of file FspsWrapperPeim.c.

mS3EndOfPeiNotifyDesc

EFI_PEI_NOTIFY_DESCRIPTOR mS3EndOfPeiNotifyDesc

Initial value:

= {
  (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  &gEfiEndOfPeiSignalPpiGuid,
  S3EndOfPeiNotify
}

Definition at line 63 of file FspsWrapperPeim.c.

mTcgPpiNotifyDesc

EFI_PEI_NOTIFY_DESCRIPTOR mTcgPpiNotifyDesc

Initial value:

= {
  (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  &gEdkiiTcgPpiGuid,
  TcgPpiNotify
}

Definition at line 483 of file FspsWrapperPeim.c.