f56ae7bf82
Added FspMemoryInitDone2, FspTempRamExitDone2, FspSiliconInitDone2 to return error status to Boot Loader for FSP API calls. To maintain backward compatibility existing functions (FspMemoryInitDone, FspTempRamExitDone, FspSiliconInitDone) declaration left untouched. Cc: Maurice Ma <maurice.ma@intel.com> Cc: Jiewen Yao <jiewen.yao@intel.com> Cc: Giri P Mudusuru <giri.p.mudusuru@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Richard Thomaiyar <richard.marian.thomaiyar@intel.com> Reviewed-by: Jiewen Yao <jiewen.yao@intel.com> Reviewed-by: Giri P Mudusuru <giri.p.mudusuru@intel.com>
132 lines
2.7 KiB
C
132 lines
2.7 KiB
C
/** @file
|
|
|
|
Copyright (c) 2014 - 2016, 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 resource descriptor by owner.
|
|
|
|
@param[in] OwnerGuid resource owner guid
|
|
**/
|
|
EFI_HOB_RESOURCE_DESCRIPTOR *
|
|
EFIAPI
|
|
FspGetResourceDescriptorByOwner (
|
|
IN EFI_GUID *OwnerGuid
|
|
);
|
|
|
|
/**
|
|
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
|
|
);
|
|
|
|
|
|
/**
|
|
Set a new stack frame for the continuation function.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspSetNewStackFrame (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
This function transfer control back to BootLoader after FspSiliconInit.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspSiliconInitDone (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
This function returns control to BootLoader after MemoryInitApi.
|
|
|
|
@param[in,out] HobListPtr The address of HobList pointer.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspMemoryInitDone (
|
|
IN OUT VOID **HobListPtr
|
|
);
|
|
|
|
/**
|
|
This function returns control to BootLoader after TempRamExitApi.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspTempRamExitDone (
|
|
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
|
|
);
|
|
|
|
/**
|
|
This function transfer control back to BootLoader after FspSiliconInit.
|
|
|
|
@param[in] Status return status for the FspSiliconInit.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspSiliconInitDone2 (
|
|
IN EFI_STATUS Status
|
|
);
|
|
|
|
/**
|
|
This function returns control to BootLoader after MemoryInitApi.
|
|
|
|
@param[in] Status return status for the MemoryInitApi.
|
|
@param[in,out] HobListPtr The address of HobList pointer.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspMemoryInitDone2 (
|
|
IN EFI_STATUS Status,
|
|
IN OUT VOID **HobListPtr
|
|
);
|
|
|
|
/**
|
|
This function returns control to BootLoader after TempRamExitApi.
|
|
|
|
@param[in] Status return status for the TempRamExitApi.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
FspTempRamExitDone2 (
|
|
IN EFI_STATUS Status
|
|
);
|
|
|
|
#endif
|