- tempory -> temporary - immediatly -> immediately - permenent -> permanent - paramter -> parameter - funciton -> function Cc: Jiewen Yao <jiewen.yao@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Gary Lin <glin@suse.com> Reviewed-by: Jiewen Yao <jiewen.yao@intel.com> Reviewed-by: Giri P Mudusuru <giri.p.mudusuru@intel.com>
		
			
				
	
	
		
			273 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			273 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
 | 
						|
  Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
 | 
						|
  This program and the accompanying materials
 | 
						|
  are licensed and made available under the terms and conditions of the BSD License
 | 
						|
  which accompanies this distribution.  The full text of the license may be found at
 | 
						|
  http://opensource.org/licenses/bsd-license.php.
 | 
						|
 | 
						|
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 | 
						|
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#ifndef _FSP_COMMON_LIB_H_
 | 
						|
#define _FSP_COMMON_LIB_H_
 | 
						|
 | 
						|
#include <FspGlobalData.h>
 | 
						|
#include <FspMeasurePointId.h>
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the FSP global data pointer.
 | 
						|
 | 
						|
  @param[in] FspData       Fsp global data pointer.
 | 
						|
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspGlobalDataPointer (
 | 
						|
  IN FSP_GLOBAL_DATA   *FspData
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the FSP global data pointer.
 | 
						|
 | 
						|
**/
 | 
						|
FSP_GLOBAL_DATA *
 | 
						|
EFIAPI
 | 
						|
GetFspGlobalDataPointer (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets back the FSP API parameter passed by the bootlaoder.
 | 
						|
 | 
						|
  @retval ApiParameter FSP API parameter passed by the bootlaoder.
 | 
						|
**/
 | 
						|
UINT32
 | 
						|
EFIAPI
 | 
						|
GetFspApiParameter (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the FSP API parameter in the stack.
 | 
						|
 | 
						|
   @param[in] Value       New parameter value.
 | 
						|
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspApiParameter (
 | 
						|
  IN UINT32      Value
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the FSP continuation function parameters in the stack.
 | 
						|
 | 
						|
  @param[in] Value             New parameter value to set.
 | 
						|
  @param[in] Index             Parameter index.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspContinuationFuncParameter (
 | 
						|
  IN UINT32      Value,
 | 
						|
  IN UINT32      Index
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function changes the BootLoader return address in stack.
 | 
						|
 | 
						|
  @param[in] ReturnAddress       Address to return.
 | 
						|
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspApiReturnAddress (
 | 
						|
  IN UINT32  ReturnAddress
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function set the API status code returned to the BootLoader.
 | 
						|
 | 
						|
  @param[in] ReturnStatus       Status code to return.
 | 
						|
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspApiReturnStatus (
 | 
						|
  IN UINT32  ReturnStatus
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the context switching stack to a new stack frame.
 | 
						|
 | 
						|
  @param[in] NewStackTop       New core stack to be set.
 | 
						|
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspCoreStackPointer (
 | 
						|
  IN VOID   *NewStackTop
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the platform specific data pointer.
 | 
						|
 | 
						|
  @param[in] PlatformData       Fsp platform specific data pointer.
 | 
						|
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspPlatformDataPointer (
 | 
						|
  IN VOID   *PlatformData
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the platform specific data pointer.
 | 
						|
 | 
						|
   @param[in] PlatformData       Fsp platform specific data pointer.
 | 
						|
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
GetFspPlatformDataPointer (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the UPD data pointer.
 | 
						|
 | 
						|
  @param[in] UpdDataRgnPtr   UPD data pointer.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspUpdDataPointer (
 | 
						|
  IN VOID    *UpdDataRgnPtr
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the UPD data pointer.
 | 
						|
 | 
						|
  @return UpdDataRgnPtr   UPD data pointer.
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
GetFspUpdDataPointer (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the memory init UPD data pointer.
 | 
						|
 | 
						|
  @param[in] MemoryInitUpdPtr   memory init UPD data pointer.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspMemoryInitUpdDataPointer (
 | 
						|
  IN VOID    *MemoryInitUpdPtr
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the memory init UPD data pointer.
 | 
						|
 | 
						|
  @return memory init UPD data pointer.
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
GetFspMemoryInitUpdDataPointer (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets the silicon init UPD data pointer.
 | 
						|
 | 
						|
  @param[in] SiliconInitUpdPtr   silicon init UPD data pointer.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspSiliconInitUpdDataPointer (
 | 
						|
  IN VOID    *SiliconInitUpdPtr
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the silicon init UPD data pointer.
 | 
						|
 | 
						|
  @return silicon init UPD data pointer.
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
GetFspSiliconInitUpdDataPointer (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  Set FSP measurement point timestamp.
 | 
						|
 | 
						|
  @param[in] Id       Measurement point ID.
 | 
						|
 | 
						|
  @return performance timestamp.
 | 
						|
**/
 | 
						|
UINT64
 | 
						|
EFIAPI
 | 
						|
SetFspMeasurePoint (
 | 
						|
  IN UINT8  Id
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the FSP info header pointer.
 | 
						|
 | 
						|
  @retval FspInfoHeader   FSP info header pointer
 | 
						|
**/
 | 
						|
FSP_INFO_HEADER *
 | 
						|
EFIAPI
 | 
						|
GetFspInfoHeader (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the FSP info header pointer from the API context.
 | 
						|
 | 
						|
  @retval FspInfoHeader   FSP info header pointer
 | 
						|
**/
 | 
						|
FSP_INFO_HEADER *
 | 
						|
EFIAPI
 | 
						|
GetFspInfoHeaderFromApiContext (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets the VPD data pointer.
 | 
						|
 | 
						|
  @return VpdDataRgnPtr   VPD data pointer.
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
GetFspVpdDataPointer (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function gets FSP API calling mode.
 | 
						|
 | 
						|
  @retval API calling mode
 | 
						|
**/
 | 
						|
UINT8
 | 
						|
EFIAPI
 | 
						|
GetFspApiCallingMode (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  This function sets FSP API calling mode.
 | 
						|
 | 
						|
  @param[in] Mode     API calling mode
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
SetFspApiCallingMode (
 | 
						|
  UINT8  Mode
 | 
						|
  );
 | 
						|
 | 
						|
#endif
 |