Add IntelFspPkg to support create FSP bin based on EDKII.
Contributed-under: TianoCore Contribution Agreement 1.0 Signed off by: Ravi Rangarajan <ravi.p.rangarajan@intel.com> Reviewed by: Maurice Ma <maurice.ma@intel.com> Reviewed by: Jiewen Yao <jiewen.yao@intel.com> Reviewed by: Giri Mudusuru <giri.p.mudusuru@intel.com> Reviewed by: Liming Gao <liming.gao@intel.com> git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15705 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
30
IntelFspPkg/Include/Library/CacheAsRamLib.h
Normal file
30
IntelFspPkg/Include/Library/CacheAsRamLib.h
Normal file
@@ -0,0 +1,30 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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 _CACHE_AS_RAM_LIB_H_
|
||||
#define _CACHE_AS_RAM_LIB_H_
|
||||
|
||||
/**
|
||||
This function disable CAR.
|
||||
|
||||
@param[in] DisableCar TRUE means use INVD, FALSE means use WBINVD
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
DisableCacheAsRam (
|
||||
IN BOOLEAN DisableCar
|
||||
);
|
||||
|
||||
#endif
|
||||
|
62
IntelFspPkg/Include/Library/CacheLib.h
Normal file
62
IntelFspPkg/Include/Library/CacheLib.h
Normal file
@@ -0,0 +1,62 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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 _CACHE_LIB_H_
|
||||
#define _CACHE_LIB_H_
|
||||
|
||||
//
|
||||
// EFI_MEMORY_CACHE_TYPE
|
||||
//
|
||||
typedef INT32 EFI_MEMORY_CACHE_TYPE;
|
||||
|
||||
#define EFI_CACHE_UNCACHEABLE 0
|
||||
#define EFI_CACHE_WRITECOMBINING 1
|
||||
#define EFI_CACHE_WRITETHROUGH 4
|
||||
#define EFI_CACHE_WRITEPROTECTED 5
|
||||
#define EFI_CACHE_WRITEBACK 6
|
||||
|
||||
/**
|
||||
Reset all the MTRRs to a known state.
|
||||
|
||||
@retval EFI_SUCCESS All MTRRs have been reset successfully.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
ResetCacheAttributes (
|
||||
VOID
|
||||
);
|
||||
|
||||
/**
|
||||
Given the memory range and cache type, programs the MTRRs.
|
||||
|
||||
@param[in] MemoryAddress Base Address of Memory to program MTRR.
|
||||
@param[in] MemoryLength Length of Memory to program MTRR.
|
||||
@param[in] MemoryCacheType Cache Type.
|
||||
|
||||
@retval EFI_SUCCESS Mtrr are set successfully.
|
||||
@retval EFI_LOAD_ERROR No empty MTRRs to use.
|
||||
@retval EFI_INVALID_PARAMETER The input parameter is not valid.
|
||||
@retval others An error occurs when setting MTTR.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
SetCacheAttributes (
|
||||
IN EFI_PHYSICAL_ADDRESS MemoryAddress,
|
||||
IN UINT64 MemoryLength,
|
||||
IN EFI_MEMORY_CACHE_TYPE MemoryCacheType
|
||||
);
|
||||
|
||||
#endif
|
||||
|
29
IntelFspPkg/Include/Library/DebugDeviceLib.h
Normal file
29
IntelFspPkg/Include/Library/DebugDeviceLib.h
Normal file
@@ -0,0 +1,29 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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 __DEBUG_DEVICE_LIB_H__
|
||||
#define __DEBUG_DEVICE_LIB_H__
|
||||
|
||||
/**
|
||||
Returns the debug print device enable state.
|
||||
|
||||
@return Debug print device enable state.
|
||||
|
||||
**/
|
||||
UINT8
|
||||
EFIAPI
|
||||
GetDebugPrintDeviceEnable (
|
||||
VOID
|
||||
);
|
||||
|
||||
#endif
|
173
IntelFspPkg/Include/Library/FspCommonLib.h
Normal file
173
IntelFspPkg/Include/Library/FspCommonLib.h
Normal file
@@ -0,0 +1,173 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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 paramter passed by the bootlaoder.
|
||||
|
||||
@retval ApiParameter FSP API paramter passed by the bootlaoder.
|
||||
**/
|
||||
UINT32
|
||||
EFIAPI
|
||||
GetFspApiParameter (
|
||||
VOID
|
||||
);
|
||||
|
||||
/**
|
||||
This function sets the FSP API paramter 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
|
||||
);
|
||||
|
||||
/**
|
||||
Set FSP measurement point timestamp.
|
||||
|
||||
@param[in] Id Measurement point ID.
|
||||
|
||||
@return performance timestamp.
|
||||
**/
|
||||
UINT64
|
||||
EFIAPI
|
||||
SetFspMeasurePoint (
|
||||
IN UINT8 Id
|
||||
);
|
||||
|
||||
#endif
|
64
IntelFspPkg/Include/Library/FspPlatformLib.h
Normal file
64
IntelFspPkg/Include/Library/FspPlatformLib.h
Normal file
@@ -0,0 +1,64 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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_PLATFORM_LIB_H_
|
||||
#define _FSP_PLATFORM_LIB_H_
|
||||
|
||||
/**
|
||||
Get system memory from HOB.
|
||||
|
||||
@param[in,out] LowMemoryLength less than 4G memory length
|
||||
@param[in,out] HighMemoryLength greater than 4G memory length
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
FspGetSystemMemorySize (
|
||||
IN OUT UINT64 *LowMemoryLength,
|
||||
IN OUT UINT64 *HighMemoryLength
|
||||
);
|
||||
|
||||
/**
|
||||
Migrate bootloader data before destroying CAR.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
FspMigrateTemporaryMemory (
|
||||
VOID
|
||||
);
|
||||
|
||||
/**
|
||||
This function transfer control to the ContinuationFunc passed in by the
|
||||
bootloader.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
FspInitDone (
|
||||
VOID
|
||||
);
|
||||
|
||||
/**
|
||||
This function handle NotifyPhase API call from the bootloader.
|
||||
It gives control back to the bootloader after it is handled. If the
|
||||
Notification code is a ReadyToBoot event, this function will return
|
||||
and FSP continues the remaining execution until it reaches the DxeIpl.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
FspWaitForNotify (
|
||||
VOID
|
||||
);
|
||||
|
||||
#endif
|
27
IntelFspPkg/Include/Library/FspReturnLib.h
Normal file
27
IntelFspPkg/Include/Library/FspReturnLib.h
Normal file
@@ -0,0 +1,27 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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_RETURN_LIB_H_
|
||||
#define _FSP_RETURN_LIB_H_
|
||||
|
||||
/**
|
||||
Return the control from FSP to the Caller.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
AsmFspReturn (
|
||||
VOID
|
||||
);
|
||||
|
||||
#endif
|
45
IntelFspPkg/Include/Library/FspSwitchStackLib.h
Normal file
45
IntelFspPkg/Include/Library/FspSwitchStackLib.h
Normal file
@@ -0,0 +1,45 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2014, 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_SWITCH_STACK_LIB_H_
|
||||
#define _FSP_SWITCH_STACK_LIB_H_
|
||||
|
||||
/**
|
||||
|
||||
This funciton will switch the current stack to the previous saved stack.
|
||||
Before calling the previous stack has to be set in FSP_GLOBAL_DATA.CoreStack.
|
||||
EIP
|
||||
FLAGS 16 bit FLAGS 16 bit
|
||||
EDI
|
||||
ESI
|
||||
EBP
|
||||
ESP
|
||||
EBX
|
||||
EDX
|
||||
ECX
|
||||
EAX
|
||||
DWORD IDT base1
|
||||
StackPointer: DWORD IDT base2
|
||||
|
||||
@return ReturnKey After switching to the saved stack,
|
||||
this value will be saved in eax before returning.
|
||||
|
||||
|
||||
**/
|
||||
UINT32
|
||||
EFIAPI
|
||||
Pei2LoaderSwitchStack (
|
||||
VOID
|
||||
);
|
||||
|
||||
#endif
|
Reference in New Issue
Block a user