IntelFsp2Pkg: Move to new location

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Guo Mang <mang.guo@intel.com>

3 files changed, 573 insertions, 0 deletions

diff --git a/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/BaseFspPlatformLib.inf b/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/BaseFspPlatformLib.inf
new file mode 100644
index 0000000000..907482daed
--- /dev/null
+++ b/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/BaseFspPlatformLib.inf
@@ -0,0 +1,54 @@
+## @file

+# Instance of FspPlatformLib

+#

+#  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.

+#

+##

+

+[Defines]

+  INF_VERSION                    = 0x00010005

+  BASE_NAME                      = BaseFspPlatformLib

+  FILE_GUID                      = B6380BFB-7140-4C52-AC42-8C966C9A3F34

+  MODULE_TYPE                    = BASE

+  VERSION_STRING                 = 1.0

+  LIBRARY_CLASS                  = FspPlatformLib

+

+[Sources]

+  FspPlatformMemory.c

+  FspPlatformNotify.c

+

+[Packages]

+  MdePkg/MdePkg.dec

+  IntelFsp2Pkg/IntelFsp2Pkg.dec

+

+[LibraryClasses]

+  BaseMemoryLib

+  MemoryAllocationLib

+  FspCommonLib

+  PerformanceLib

+  ReportStatusCodeLib

+

+[Pcd]

+  gIntelFsp2PkgTokenSpaceGuid.PcdGlobalDataPointerAddress    ## CONSUMES

+  gIntelFsp2PkgTokenSpaceGuid.PcdTemporaryRamBase            ## CONSUMES

+  gIntelFsp2PkgTokenSpaceGuid.PcdTemporaryRamSize            ## CONSUMES

+  gIntelFsp2PkgTokenSpaceGuid.PcdFspTemporaryRamSize         ## CONSUMES

+

+[Guids]

+  gFspPerformanceDataGuid                                   ## CONSUMES ## GUID

+  gFspEventEndOfFirmwareGuid                                ## PRODUCES ## GUID

+  gEfiEventReadyToBootGuid                                  ## CONSUMES ## Event

+

+[Protocols]

+  gEfiPciEnumerationCompleteProtocolGuid                    ## CONSUMES

+

+[FixedPcd]

+  gIntelFsp2PkgTokenSpaceGuid.PcdFspMaxPatchEntry        ## CONSUMES

+  gIntelFsp2PkgTokenSpaceGuid.PcdFspMaxPerfEntry         ## CONSUMES

diff --git a/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/FspPlatformMemory.c b/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/FspPlatformMemory.c
new file mode 100644
index 0000000000..edb8d67223
--- /dev/null
+++ b/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/FspPlatformMemory.c
@@ -0,0 +1,122 @@
+/** @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.

+

+**/

+

+#include <PiPei.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/MemoryAllocationLib.h>

+#include <Library/DebugLib.h>

+#include <Library/PcdLib.h>

+#include <Library/HobLib.h>

+#include <Library/PeiServicesLib.h>

+#include <Library/FspCommonLib.h>

+#include <FspGlobalData.h>

+#include <FspEas.h>

+

+/**

+  Get system memory resource descriptor by owner.

+

+  @param[in] OwnerGuid   resource owner guid

+**/

+EFI_HOB_RESOURCE_DESCRIPTOR *

+EFIAPI

+FspGetResourceDescriptorByOwner (

+  IN EFI_GUID   *OwnerGuid

+  )

+{

+  EFI_PEI_HOB_POINTERS    Hob;

+

+  //

+  // Get the HOB list for processing

+  //

+  Hob.Raw = GetHobList ();

+

+  //

+  // Collect memory ranges

+  //

+  while (!END_OF_HOB_LIST (Hob)) {

+    if (Hob.Header->HobType == EFI_HOB_TYPE_RESOURCE_DESCRIPTOR) {

+      if ((Hob.ResourceDescriptor->ResourceType == EFI_RESOURCE_MEMORY_RESERVED) && \

+          (CompareGuid (&Hob.ResourceDescriptor->Owner, OwnerGuid))) {

+        return  Hob.ResourceDescriptor;                     

+      }

+    }

+    Hob.Raw = GET_NEXT_HOB (Hob);

+  }

+  

+  return NULL;

+}

+

+/**

+  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

+  )

+{

+  EFI_STATUS                  Status;

+  EFI_BOOT_MODE               BootMode;

+  EFI_RESOURCE_ATTRIBUTE_TYPE ResourceAttribute;

+  EFI_PEI_HOB_POINTERS        Hob;

+

+  ResourceAttribute = (

+                       EFI_RESOURCE_ATTRIBUTE_PRESENT |

+                       EFI_RESOURCE_ATTRIBUTE_INITIALIZED |

+                       EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE |

+                       EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE |

+                       EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE |

+                       EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE

+                       );

+

+  Status = PeiServicesGetBootMode (&BootMode);

+  ASSERT_EFI_ERROR (Status);

+

+  if (BootMode != BOOT_ON_S3_RESUME) {

+    ResourceAttribute |= EFI_RESOURCE_ATTRIBUTE_TESTED;

+  }

+

+  *HighMemoryLength = 0;

+  *LowMemoryLength  = SIZE_1MB;

+  //

+  // Get the HOB list for processing

+  //

+  Hob.Raw = GetHobList ();

+

+  //

+  // Collect memory ranges

+  //

+  while (!END_OF_HOB_LIST (Hob)) {

+    if (Hob.Header->HobType == EFI_HOB_TYPE_RESOURCE_DESCRIPTOR) {

+      if ((Hob.ResourceDescriptor->ResourceType == EFI_RESOURCE_SYSTEM_MEMORY) ||

+          ((Hob.ResourceDescriptor->ResourceType == EFI_RESOURCE_MEMORY_RESERVED) &&

+           (Hob.ResourceDescriptor->ResourceAttribute == ResourceAttribute))) {

+        //

+        // Need memory above 1MB to be collected here

+        //

+        if (Hob.ResourceDescriptor->PhysicalStart >= BASE_1MB &&

+            Hob.ResourceDescriptor->PhysicalStart < (EFI_PHYSICAL_ADDRESS) BASE_4GB) {

+          *LowMemoryLength += (UINT64) (Hob.ResourceDescriptor->ResourceLength);

+        } else if (Hob.ResourceDescriptor->PhysicalStart >= (EFI_PHYSICAL_ADDRESS) BASE_4GB) {

+          *HighMemoryLength += (UINT64) (Hob.ResourceDescriptor->ResourceLength);

+        }

+      }

+    }

+    Hob.Raw = GET_NEXT_HOB (Hob);

+  }

+}

diff --git a/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/FspPlatformNotify.c b/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/FspPlatformNotify.c
new file mode 100644
index 0000000000..ac1fc1ac0b
--- /dev/null
+++ b/Core/IntelFsp2Pkg/Library/BaseFspPlatformLib/FspPlatformNotify.c
@@ -0,0 +1,397 @@
+/** @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.

+

+**/

+

+#include <PiPei.h>

+#include <Library/PeiServicesLib.h>

+#include <Library/PeiServicesTablePointerLib.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/PcdLib.h>

+#include <Library/DebugLib.h>

+#include <Library/HobLib.h>

+#include <Library/FspSwitchStackLib.h>

+#include <Library/FspCommonLib.h>

+#include <Guid/EventGroup.h>

+#include <FspEas.h>

+#include <FspStatusCode.h>

+#include <Protocol/PciEnumerationComplete.h>

+#include <Library/ReportStatusCodeLib.h>

+#include <Library/PerformanceLib.h>

+extern EFI_GUID gFspPerformanceDataGuid;

+

+EFI_PEI_PPI_DESCRIPTOR      mPeiPostPciEnumerationPpi = {

+  (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),

+  &gEfiPciEnumerationCompleteProtocolGuid,

+  NULL

+};

+

+EFI_PEI_PPI_DESCRIPTOR      mPeiReadyToBootPpi = {

+  (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),

+  &gEfiEventReadyToBootGuid,

+  NULL

+};

+

+EFI_PEI_PPI_DESCRIPTOR      mPeiEndOfFirmwarePpi = {

+  (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),

+  &gFspEventEndOfFirmwareGuid,

+  NULL

+};

+

+UINT32  mFspNotifySequence[] = {

+  EnumInitPhaseAfterPciEnumeration,

+  EnumInitPhaseReadyToBoot,

+  EnumInitPhaseEndOfFirmware

+};

+

+/**

+  Install FSP notification.

+

+  @param[in] NotificationCode  FSP notification code

+

+  @retval EFI_SUCCESS            Notify FSP successfully

+  @retval EFI_INVALID_PARAMETER  NotificationCode is invalid

+

+**/

+EFI_STATUS

+EFIAPI

+FspNotificationHandler (

+  IN  UINT32     NotificationCode

+  )

+{

+  EFI_STATUS                Status;

+

+  Status   = EFI_SUCCESS;

+

+  switch (NotificationCode) {

+  case EnumInitPhaseAfterPciEnumeration:

+    //

+    // Do POST PCI initialization if needed

+    //

+    DEBUG ((DEBUG_INFO | DEBUG_INIT, "FSP Post PCI Enumeration ...\n"));

+    PeiServicesInstallPpi (&mPeiPostPciEnumerationPpi);

+    break;

+

+  case EnumInitPhaseReadyToBoot:

+    //

+    // Ready To Boot

+    //

+    DEBUG ((DEBUG_INFO| DEBUG_INIT, "FSP Ready To Boot ...\n"));

+    PeiServicesInstallPpi (&mPeiReadyToBootPpi);

+    break;

+

+  case EnumInitPhaseEndOfFirmware:

+    //

+    // End of Firmware

+    //

+    DEBUG ((DEBUG_INFO| DEBUG_INIT, "FSP End of Firmware ...\n"));

+    PeiServicesInstallPpi (&mPeiEndOfFirmwarePpi);

+    break;

+

+  default:

+    Status = EFI_INVALID_PARAMETER;

+    break;

+  }

+

+  return Status;

+}

+

+/**

+  This function transfer control back to BootLoader after FspSiliconInit.

+

+  @param[in] Status return status for the FspSiliconInit.

+

+**/

+VOID

+EFIAPI

+FspSiliconInitDone2 (

+  IN EFI_STATUS Status

+  )

+{

+  //

+  // Convert to FSP EAS defined API return codes

+  //

+  switch (Status) {

+    case EFI_SUCCESS:

+    case EFI_INVALID_PARAMETER:

+    case EFI_UNSUPPORTED:

+    case EFI_DEVICE_ERROR:

+      break;

+    default:

+      DEBUG ((DEBUG_INFO | DEBUG_INIT, "FspSiliconInitApi() Invalid Error - [Status: 0x%08X]\n", Status));

+      Status = EFI_DEVICE_ERROR;  // Force to known error.

+      break;

+  }

+  //

+  // This is the end of the FspSiliconInit API

+  // Give control back to the boot loader

+  //

+  SetFspMeasurePoint (FSP_PERF_ID_API_FSP_SILICON_INIT_EXIT);

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "FspSiliconInitApi() - [Status: 0x%08X] - End\n", Status));

+  PERF_END_EX (&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_SILICON_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  do {

+    SetFspApiReturnStatus (Status);

+    Pei2LoaderSwitchStack ();

+    if (Status != EFI_SUCCESS) {

+      DEBUG ((DEBUG_ERROR, "!!!ERROR: FspSiliconInitApi() - [Status: 0x%08X] - Error encountered during previous API and cannot proceed further\n", Status));

+    }

+  } while (Status != EFI_SUCCESS);

+}

+

+/**

+  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, if NULL, will get value from GetFspApiParameter2 ()

+**/

+VOID

+EFIAPI

+FspMemoryInitDone2 (

+  IN EFI_STATUS Status,

+  IN OUT VOID   **HobListPtr

+  )

+{

+  FSP_GLOBAL_DATA   *FspData;

+  //

+  // Calling use FspMemoryInit API

+  // Update HOB and return the control directly

+  //

+  if (HobListPtr == NULL) {

+    HobListPtr = (VOID **)GetFspApiParameter2 ();

+  }

+  if (HobListPtr != NULL) {

+    *HobListPtr = (VOID *) GetHobList ();

+  }

+  //

+  // Convert to FSP EAS defined API return codes

+  //

+  switch (Status) {

+    case EFI_SUCCESS:

+    case EFI_INVALID_PARAMETER:

+    case EFI_UNSUPPORTED:

+    case EFI_DEVICE_ERROR:

+    case EFI_OUT_OF_RESOURCES:

+      break;

+    default:

+      DEBUG ((DEBUG_INFO | DEBUG_INIT, "FspMemoryInitApi() Invalid Error [Status: 0x%08X]\n", Status));

+      Status = EFI_DEVICE_ERROR;  // Force to known error.

+      break;

+  }

+  //

+  // This is the end of the FspMemoryInit API

+  // Give control back to the boot loader

+  //

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "FspMemoryInitApi() - [Status: 0x%08X] - End\n", Status));

+  SetFspMeasurePoint (FSP_PERF_ID_API_FSP_MEMORY_INIT_EXIT);

+  FspData = GetFspGlobalDataPointer ();

+  PERF_START_EX(&gFspPerformanceDataGuid, "EventRec", NULL, (FspData->PerfData[0] & FSP_PERFORMANCE_DATA_TIMER_MASK), FSP_STATUS_CODE_TEMP_RAM_INIT | FSP_STATUS_CODE_COMMON_CODE| FSP_STATUS_CODE_API_ENTRY);

+  PERF_END_EX(&gFspPerformanceDataGuid, "EventRec", NULL, (FspData->PerfData[1] & FSP_PERFORMANCE_DATA_TIMER_MASK), FSP_STATUS_CODE_TEMP_RAM_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  PERF_START_EX(&gFspPerformanceDataGuid, "EventRec", NULL, (FspData->PerfData[2] & FSP_PERFORMANCE_DATA_TIMER_MASK), FSP_STATUS_CODE_MEMORY_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+  PERF_END_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_MEMORY_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_MEMORY_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  do {

+    SetFspApiReturnStatus (Status);

+    Pei2LoaderSwitchStack ();

+    if (Status != EFI_SUCCESS) {

+      DEBUG ((DEBUG_ERROR, "!!!ERROR: FspMemoryInitApi() - [Status: 0x%08X] - Error encountered during previous API and cannot proceed further\n", Status));

+    }

+  } while (Status != EFI_SUCCESS);

+

+  //

+  // The TempRamExitApi is called

+  //

+  if (GetFspApiCallingIndex () == TempRamExitApiIndex) {

+    SetPhaseStatusCode (FSP_STATUS_CODE_TEMP_RAM_EXIT);

+    SetFspMeasurePoint (FSP_PERF_ID_API_TEMP_RAM_EXIT_ENTRY);

+    PERF_START_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_TEMP_RAM_EXIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_TEMP_RAM_EXIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    DEBUG ((DEBUG_INFO | DEBUG_INIT, "TempRamExitApi() - Begin\n"));

+  } else {

+    SetPhaseStatusCode (FSP_STATUS_CODE_SILICON_INIT);

+    SetFspMeasurePoint (FSP_PERF_ID_API_FSP_SILICON_INIT_ENTRY);

+    PERF_START_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_SILICON_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_SILICON_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    DEBUG ((DEBUG_INFO | DEBUG_INIT, "FspSiliconInitApi() - Begin\n"));

+  }

+}

+

+/**

+  This function returns control to BootLoader after TempRamExitApi.

+

+  @param[in] Status return status for the TempRamExitApi.

+

+**/

+VOID

+EFIAPI

+FspTempRamExitDone2 (

+  IN EFI_STATUS Status

+  )

+{

+  //

+  // Convert to FSP EAS defined API return codes

+  //

+  switch (Status) {

+    case EFI_SUCCESS:

+    case EFI_INVALID_PARAMETER:

+    case EFI_UNSUPPORTED:

+    case EFI_DEVICE_ERROR:

+      break;

+    default:

+      DEBUG ((DEBUG_INFO | DEBUG_INIT, "TempRamExitApi() Invalid Error - [Status: 0x%08X]\n", Status));

+      Status = EFI_DEVICE_ERROR;  // Force to known error.

+      break;

+  }

+  //

+  // This is the end of the TempRamExit API

+  // Give control back to the boot loader

+  //

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "TempRamExitApi() - [Status: 0x%08X] - End\n", Status));

+  SetFspMeasurePoint (FSP_PERF_ID_API_TEMP_RAM_EXIT_EXIT);

+  PERF_END_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_TEMP_RAM_EXIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_TEMP_RAM_EXIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+  do {

+    SetFspApiReturnStatus (Status);

+    Pei2LoaderSwitchStack ();

+    if (Status != EFI_SUCCESS) {

+      DEBUG ((DEBUG_ERROR, "!!!ERROR: TempRamExitApi() - [Status: 0x%08X] - Error encountered during previous API and cannot proceed further\n", Status));

+    }

+  } while (Status != EFI_SUCCESS);

+  SetPhaseStatusCode (FSP_STATUS_CODE_SILICON_INIT);

+  SetFspMeasurePoint (FSP_PERF_ID_API_FSP_SILICON_INIT_ENTRY);

+  PERF_START_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_SILICON_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+  REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_SILICON_INIT | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "SiliconInitApi() - Begin\n"));

+}

+

+/**

+  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

+FspWaitForNotify (

+  VOID

+  )

+{

+  EFI_STATUS                 Status;

+  UINT32                     NotificationValue;

+  UINT32                     NotificationCount;

+  UINT8                      Count;

+

+  NotificationCount = 0;

+  while (NotificationCount < sizeof(mFspNotifySequence) / sizeof(UINT32)) {

+

+    Count = (UINT8)((NotificationCount << 1) & 0x07);

+    SetFspMeasurePoint (FSP_PERF_ID_API_NOTIFY_POST_PCI_ENTRY + Count);

+

+    if (NotificationCount == 0) {

+      SetPhaseStatusCode (FSP_STATUS_CODE_POST_PCIE_ENUM_NOTIFICATION);

+      PERF_START_EX (&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_POST_PCIE_ENUM_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+      REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_POST_PCIE_ENUM_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    } else if (NotificationCount == 1) {

+      SetPhaseStatusCode (FSP_STATUS_CODE_READY_TO_BOOT_NOTIFICATION);

+      PERF_START_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_READY_TO_BOOT_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+      REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_READY_TO_BOOT_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    } else if (NotificationCount == 2) {

+      SetPhaseStatusCode (FSP_STATUS_CODE_END_OF_FIRMWARE_NOTIFICATION);

+      PERF_START_EX (&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_END_OF_FIRMWARE_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+      REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_END_OF_FIRMWARE_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_ENTRY);

+    }

+

+    NotificationValue = ((NOTIFY_PHASE_PARAMS *)(UINTN)GetFspApiParameter ())->Phase;

+    DEBUG ((DEBUG_INFO | DEBUG_INIT, "NotifyPhaseApi() - Begin  [Phase: %08X]\n", NotificationValue));

+    if (mFspNotifySequence[NotificationCount] != NotificationValue) {

+      //

+      // Notify code does not follow the predefined order

+      //

+      DEBUG ((DEBUG_INFO, "Unsupported FSP Notification Value\n"));

+      Status = EFI_UNSUPPORTED;

+    } else {

+      //

+      // Process Notification and Give control back to the boot loader framework caller

+      //

+      Status = FspNotificationHandler (NotificationValue);

+      if (!EFI_ERROR(Status)) {

+        NotificationCount++;

+      }

+    }

+

+    DEBUG ((DEBUG_INFO | DEBUG_INIT, "NotifyPhaseApi() - End  [Status: 0x%08X]\n", Status));

+    SetFspMeasurePoint (FSP_PERF_ID_API_NOTIFY_POST_PCI_EXIT + Count);

+

+    if ((NotificationCount - 1) == 0) {

+      PERF_END_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_POST_PCIE_ENUM_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+      REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_POST_PCIE_ENUM_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+    } else if ((NotificationCount - 1) == 1) {

+      PERF_END_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_READY_TO_BOOT_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+      REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_READY_TO_BOOT_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+    } else if ((NotificationCount - 1) == 2) {

+      PERF_END_EX(&gFspPerformanceDataGuid, "EventRec", NULL, 0, FSP_STATUS_CODE_END_OF_FIRMWARE_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+      REPORT_STATUS_CODE (EFI_PROGRESS_CODE, FSP_STATUS_CODE_END_OF_FIRMWARE_NOTIFICATION | FSP_STATUS_CODE_COMMON_CODE | FSP_STATUS_CODE_API_EXIT);

+    }

+    do {

+      SetFspApiReturnStatus(Status);

+      Pei2LoaderSwitchStack();

+      if (Status != EFI_SUCCESS) {

+        DEBUG ((DEBUG_ERROR, "!!!ERROR: NotifyPhaseApi() [Phase: %08X] - Failed - [Status: 0x%08X]\n", NotificationValue, Status));

+      }

+    } while (Status != EFI_SUCCESS);

+  }

+

+  //

+  // Control goes back to the PEI Core and it dispatches further PEIMs.

+  // DXEIPL is the final one to transfer control back to the boot loader.

+  //

+}

+

+/**

+  This function transfer control back to BootLoader after FspSiliconInit.

+

+**/

+VOID

+EFIAPI

+FspSiliconInitDone (

+  VOID

+  )

+{

+  FspSiliconInitDone2 (EFI_SUCCESS);

+}

+

+/**

+  This function returns control to BootLoader after MemoryInitApi.

+

+  @param[in,out] HobListPtr The address of HobList pointer.

+**/

+VOID

+EFIAPI

+FspMemoryInitDone (

+  IN OUT VOID   **HobListPtr

+  )

+{

+  FspMemoryInitDone2 (EFI_SUCCESS, HobListPtr);

+}

+

+/**

+  This function returns control to BootLoader after TempRamExitApi.

+

+**/

+VOID

+EFIAPI

+FspTempRamExitDone (

+  VOID

+  )

+{

+  FspTempRamExitDone2 (EFI_SUCCESS);

+}