Add IntelFsp2Pkg and IntelFsp2WrapperPkg.

Add FSP2.0 support.
This series of patch is to support FSP2.0 specification at
https://firmware.intel.com/sites/default/files/FSP_EAS_v2.0_Draft%20External.pdf

Some major updates include:
1) One FSP binary is separated to multiple components:
FSP-T, FSP-M, FSP-S, and optional FSP-O.
Each component has its own configuration data region.
2) All FSP-APIs use same UPD format - FSP_UPD_HEADER.
3) Add EnumInitPhaseEndOfFirmware notifyphase.
4) FSP1.1/FSP1.0 compatibility is NOT maintained.
5) We also add rename Fsp* to FspWrapper* in IntelFsp2WrapperPkg,
to indicate that it is for FspWrapper only.

IntelFspPkg and IntelFspWrapperPkg will be deprecated.
The new Intel platform will follow FSP2.0 and use IntelFsp2Pkg
and IntelFsp2WrapperPkg.
The old platform can still use IntelFspPkg and IntelFspWrapperPkg
for compatibility consideration.

Cc: Giri P Mudusuru <giri.p.mudusuru@intel.com>
Cc: Maurice Ma <maurice.ma@intel.com>
Cc: Ravi P Rangarajan <ravi.p.rangarajan@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiewen Yao <jiewen.yao@intel.com>
Reviewed-by: Giri P Mudusuru <giri.p.mudusuru@intel.com>
Reviewed-by: Maurice Ma <maurice.ma@intel.com>
Reviewed-by: Ravi P Rangarajan <ravi.p.rangarajan@intel.com>

3 files changed, 214 insertions, 0 deletions

diff --git a/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.c b/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.c
new file mode 100644
index 0000000000..6acdeb3b60
--- /dev/null
+++ b/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.c
@@ -0,0 +1,142 @@
+/** @file

+  Source file for FSP notify phase PEI module

+

+  Copyright (c) 2016, Intel Corporation. All rights reserved.

+  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 "FspNotifyPhasePeim.h"

+

+/**

+

+   This function waits for FSP notify.

+    

+   @param This          Entry point for DXE IPL PPI.

+   @param PeiServices   General purpose services available to every PEIM.

+   @param HobList       Address to the Pei HOB list.

+   

+   @return EFI_SUCCESS              This function never returns.

+

+**/

+EFI_STATUS

+EFIAPI

+WaitForNotify (

+  IN CONST EFI_DXE_IPL_PPI *This,

+  IN EFI_PEI_SERVICES      **PeiServices,

+  IN EFI_PEI_HOB_POINTERS  HobList

+  );

+

+CONST EFI_DXE_IPL_PPI mDxeIplPpi = {

+  WaitForNotify

+};

+

+CONST EFI_PEI_PPI_DESCRIPTOR mInstallDxeIplPpi = {

+  EFI_PEI_PPI_DESCRIPTOR_PPI,

+  &gEfiDxeIplPpiGuid,

+  (VOID *) &mDxeIplPpi

+};

+

+CONST EFI_PEI_PPI_DESCRIPTOR gEndOfPeiSignalPpi = {

+  (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),

+  &gEfiEndOfPeiSignalPpiGuid,

+  NULL

+};

+

+/**

+

+   This function waits for FSP notify.

+    

+   @param This          Entry point for DXE IPL PPI.

+   @param PeiServices   General purpose services available to every PEIM.

+   @param HobList       Address to the Pei HOB list.

+   

+   @return EFI_SUCCESS              This function never returns.

+

+**/

+EFI_STATUS

+EFIAPI

+WaitForNotify (

+  IN CONST EFI_DXE_IPL_PPI *This,

+  IN EFI_PEI_SERVICES      **PeiServices,

+  IN EFI_PEI_HOB_POINTERS  HobList

+  )

+{

+  EFI_STATUS   Status;

+

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "FSP HOB is located at 0x%08X\n", HobList));

+

+  //

+  // End of PEI phase signal

+  //

+  Status = PeiServicesInstallPpi (&gEndOfPeiSignalPpi);

+  ASSERT_EFI_ERROR (Status);

+

+  //

+  // Give control back to BootLoader after FspSiliconInit

+  //

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "FSP is waiting for NOTIFY\n"));

+  FspSiliconInitDone ();

+

+  //

+  // BootLoader called FSP again through NotifyPhase

+  //

+  FspWaitForNotify ();

+

+  //

+  // Should not come here

+  //

+  while (TRUE) {

+    DEBUG ((DEBUG_ERROR, "No FSP API should be called after FSP is DONE!\n"));

+    SetFspApiReturnStatus (EFI_UNSUPPORTED);

+    Pei2LoaderSwitchStack ();

+  }

+

+  return EFI_SUCCESS;

+}

+

+/**

+  FSP notify phase PEI module entry point

+

+  @param[in]  FileHandle           Not used.

+  @param[in]  PeiServices          General purpose services available to every PEIM.

+

+  @retval     EFI_SUCCESS          The function completes successfully

+  @retval     EFI_OUT_OF_RESOURCES Insufficient resources to create database

+**/

+EFI_STATUS

+FspNotifyPhasePeimEntryPoint (

+  IN       EFI_PEI_FILE_HANDLE    FileHandle,

+  IN CONST EFI_PEI_SERVICES       **PeiServices

+  )

+{

+  EFI_STATUS                      Status;

+  VOID                            *OldDxeIplPpi;

+  EFI_PEI_PPI_DESCRIPTOR          *OldDescriptor;

+

+  DEBUG ((DEBUG_INFO | DEBUG_INIT, "The entry of FspNotificationPeim\n"));

+

+  //

+  // Locate old DXE IPL PPI

+  //

+  Status = PeiServicesLocatePpi (

+            &gEfiDxeIplPpiGuid,

+            0,

+            &OldDescriptor,

+            &OldDxeIplPpi

+            );

+  ASSERT_EFI_ERROR (Status);

+

+  //

+  // Re-install the DXE IPL PPI to wait for notify

+  //

+  Status = PeiServicesReInstallPpi (OldDescriptor, &mInstallDxeIplPpi);

+  ASSERT_EFI_ERROR (Status);

+

+  return EFI_SUCCESS;

+}

diff --git a/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.h b/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.h
new file mode 100644
index 0000000000..6e2ae591ec
--- /dev/null
+++ b/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.h
@@ -0,0 +1,23 @@
+/** @file

+  Header file for FSP notify phase PEI module

+

+  Copyright (c) 2016 Intel Corporation. All rights reserved.

+  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_NOTIFY_PHASE_PEIM_H_

+#define _FSP_NOTIFY_PHASE_PEIM_H_

+

+#include <Library/PeiServicesLib.h>

+#include <Ppi/DxeIpl.h>

+#include <Library/DebugLib.h>

+#include <Library/FspPlatformLib.h>

+#include <Library/FspCommonLib.h>

+#include <Library/FspSwitchStackLib.h>

+#endif

diff --git a/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.inf b/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.inf
new file mode 100644
index 0000000000..75f7ae5fb7
--- /dev/null
+++ b/IntelFsp2Pkg/FspNotifyPhase/FspNotifyPhasePeim.inf
@@ -0,0 +1,49 @@
+## @file

+# Component information file for the FSP notify phase PEI module.

+#

+#@copyright

+#  Copyright (c) 2016 Intel Corporation. All rights reserved.

+#  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                      = FspNotifyPhasePeim

+  FILE_GUID                      = 29CBB005-C972-49F3-960F-292E2202CECD

+  MODULE_TYPE                    = PEIM

+  VERSION_STRING                 = 1.0

+  ENTRY_POINT                    = FspNotifyPhasePeimEntryPoint

+

+[Sources]

+  FspNotifyPhasePeim.h

+  FspNotifyPhasePeim.c

+

+[Packages]

+  MdePkg/MdePkg.dec

+  IntelFsp2Pkg/IntelFsp2Pkg.dec

+

+[LibraryClasses]

+  PeimEntryPoint

+  DebugLib

+  FspPlatformLib

+  FspCommonLib

+  FspSwitchStackLib

+

+[Ppis]

+  gEfiDxeIplPpiGuid                       ## PRODUCES

+  gEfiEndOfPeiSignalPpiGuid               ## PRODUCES

+

+[Protocols]

+  gEfiPciEnumerationCompleteProtocolGuid  ## PRODUCES

+

+[Guids]

+  gEfiEventReadyToBootGuid                ## PRODUCES ## Event

+

+[Depex]

+  gEfiDxeIplPpiGuid