IntelFspWrapperPkg/FspInitPei/FspInitPeiV2.c

   1 /** @file
   2   In FSP API V2 mode, it will be invoked only once. It will call FspMemoryInit API,
   3   register TemporaryRamDonePpi to call TempRamExit API, and register MemoryDiscoveredPpi
   4   notify to call FspSiliconInit API.
   5
   6   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
   7   This program and the accompanying materials
   8   are licensed and made available under the terms and conditions of the BSD License
   9   which accompanies this distribution.  The full text of the license may be found at
  10   http://opensource.org/licenses/bsd-license.php.
  11
  12   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  13   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  14
  15 **/
  16
  17
  18 #include "FspInitPei.h"
  19
  20 /**
  21   Return Hob list produced by FSP.
  22
  23   @param[in]  PeiServices  The pointer to the PEI Services Table.
  24   @param[in]  This         The pointer to this instance of this PPI.
  25   @param[out] FspHobList   The pointer to Hob list produced by FSP.
  26
  27   @return EFI_SUCCESS FReturn Hob list produced by FSP successfully.
  28 **/
  29 EFI_STATUS
  30 EFIAPI
  31 FspInitDoneGetFspHobListV2 (
  32   IN  CONST EFI_PEI_SERVICES         **PeiServices,
  33   IN  FSP_INIT_DONE_PPI              *This,
  34   OUT VOID                           **FspHobList
  35   );
  36
  37 FSP_INIT_DONE_PPI mFspInitDonePpiV2 = {
  38   FspInitDoneGetFspHobListV2
  39 };
  40
  41 EFI_PEI_PPI_DESCRIPTOR            mPeiFspInitDonePpiV2 = {
  42   EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST,
  43   &gFspInitDonePpiGuid,
  44   &mFspInitDonePpiV2
  45 };
  46
  47 /**
  48   This function is called after PEI core discover memory and finish migration.
  49
  50   @param[in] PeiServices    Pointer to PEI Services Table.
  51   @param[in] NotifyDesc     Pointer to the descriptor for the Notification event that
  52                             caused this function to execute.
  53   @param[in] Ppi            Pointer to the PPI data associated with this function.
  54
  55   @retval EFI_STATUS        Always return EFI_SUCCESS
  56 **/
  57 EFI_STATUS
  58 EFIAPI
  59 PeiMemoryDiscoveredNotify (
  60   IN EFI_PEI_SERVICES          **PeiServices,
  61   IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDesc,
  62   IN VOID                      *Ppi
  63   );
  64
  65 EFI_PEI_NOTIFY_DESCRIPTOR mPeiMemoryDiscoveredNotifyDesc = {
  66   (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  67   &gEfiPeiMemoryDiscoveredPpiGuid,
  68   PeiMemoryDiscoveredNotify
  69 };
  70
  71 /**
  72   TemporaryRamDone() disables the use of Temporary RAM. If present, this service is invoked
  73   by the PEI Foundation after the EFI_PEI_PERMANANT_MEMORY_INSTALLED_PPI is installed.
  74
  75   @retval EFI_SUCCESS           Use of Temporary RAM was disabled.
  76   @retval EFI_INVALID_PARAMETER Temporary RAM could not be disabled.
  77
  78 **/
  79 EFI_STATUS
  80 EFIAPI
  81 PeiTemporaryRamDone (
  82   VOID
  83   );
  84
  85 EFI_PEI_TEMPORARY_RAM_DONE_PPI mPeiTemporaryRamDonePpi = {
  86   PeiTemporaryRamDone
  87 };
  88
  89 EFI_PEI_PPI_DESCRIPTOR         mPeiTemporaryRamDoneDesc = {
  90   (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  91   &gEfiTemporaryRamDonePpiGuid,
  92   &mPeiTemporaryRamDonePpi
  93 };
  94
  95 /**
  96   Return Hob list produced by FSP.
  97
  98   @param[in]  PeiServices  The pointer to the PEI Services Table.
  99   @param[in]  This         The pointer to this instance of this PPI.
 100   @param[out] FspHobList   The pointer to Hob list produced by FSP.
 101
 102   @return EFI_SUCCESS FReturn Hob list produced by FSP successfully.
 103 **/
 104 EFI_STATUS
 105 EFIAPI
 106 FspInitDoneGetFspHobListV2 (
 107   IN  CONST EFI_PEI_SERVICES         **PeiServices,
 108   IN  FSP_INIT_DONE_PPI              *This,
 109   OUT VOID                           **FspHobList
 110   )
 111 {
 112   EFI_HOB_GUID_TYPE                  *GuidHob;
 113
 114   GuidHob = GetFirstGuidHob (&gFspInitDonePpiGuid);
 115   if (GuidHob != NULL) {
 116     *FspHobList = *(VOID **)GET_GUID_HOB_DATA (GuidHob);
 117     return EFI_SUCCESS;
 118   } else {
 119     return EFI_NOT_FOUND;
 120   }
 121 }
 122
 123 /**
 124   Call FspMemoryInit API.
 125
 126   @param[in]  FspHeader   FSP header pointer.
 127
 128   @return Status returned by FspMemoryInit API.
 129 **/
 130 EFI_STATUS
 131 PeiFspMemoryInit (
 132   IN FSP_INFO_HEADER *FspHeader
 133   )
 134 {
 135   FSP_MEMORY_INIT_PARAMS    FspMemoryInitParams;
 136   FSP_INIT_RT_COMMON_BUFFER FspRtBuffer;
 137   UINT8                     FspUpdRgn[FixedPcdGet32 (PcdMaxUpdRegionSize)];
 138   UINT32                    UpdRegionSize;
 139   EFI_BOOT_MODE             BootMode;
 140   UINT64                    StackSize;
 141   EFI_PHYSICAL_ADDRESS      StackBase;
 142   EFI_STATUS                Status;
 143   VOID                      *FspHobList;
 144   VOID                      *HobData;
 145
 146   DEBUG ((DEBUG_INFO, "PeiFspMemoryInit enter\n"));
 147
 148   PeiServicesGetBootMode (&BootMode);
 149   DEBUG ((DEBUG_INFO, "BootMode - 0x%x\n", BootMode));
 150
 151   GetStackInfo (BootMode, FALSE, &StackSize, &StackBase);
 152   DEBUG ((DEBUG_INFO, "StackBase - 0x%x\n", StackBase));
 153   DEBUG ((DEBUG_INFO, "StackSize - 0x%x\n", StackSize));
 154
 155   ZeroMem (&FspRtBuffer, sizeof(FspRtBuffer));
 156   FspRtBuffer.StackTop = (UINT32 *)(UINTN)(StackBase + StackSize);
 157
 158   FspRtBuffer.BootMode = BootMode;
 159
 160   /* Platform override any UPD configs */
 161   UpdRegionSize = GetUpdRegionSize();
 162   DEBUG ((DEBUG_INFO, "UpdRegionSize - 0x%x\n", UpdRegionSize));
 163   DEBUG ((DEBUG_INFO, "sizeof(FspUpdRgn) - 0x%x\n", sizeof(FspUpdRgn)));
 164   ASSERT(sizeof(FspUpdRgn) >= UpdRegionSize);
 165   ZeroMem (FspUpdRgn, UpdRegionSize);
 166   FspRtBuffer.UpdDataRgnPtr = UpdateFspUpdConfigs (FspUpdRgn);
 167   FspRtBuffer.BootLoaderTolumSize = GetBootLoaderTolumSize ();
 168
 169   ZeroMem (&FspMemoryInitParams, sizeof(FspMemoryInitParams));
 170   FspMemoryInitParams.NvsBufferPtr = GetNvsBuffer ();
 171   DEBUG ((DEBUG_INFO, "NvsBufferPtr - 0x%x\n", FspMemoryInitParams.NvsBufferPtr));
 172   FspMemoryInitParams.RtBufferPtr  = (VOID *)&FspRtBuffer;
 173   FspHobList = NULL;
 174   FspMemoryInitParams.HobListPtr   = &FspHobList;
 175
 176   DEBUG ((DEBUG_INFO, "FspMemoryInitParams - 0x%x\n", &FspMemoryInitParams));
 177   DEBUG ((DEBUG_INFO, "  NvsBufferPtr      - 0x%x\n", FspMemoryInitParams.NvsBufferPtr));
 178   DEBUG ((DEBUG_INFO, "  RtBufferPtr       - 0x%x\n", FspMemoryInitParams.RtBufferPtr));
 179   DEBUG ((DEBUG_INFO, "    StackTop        - 0x%x\n", FspRtBuffer.StackTop));
 180   DEBUG ((DEBUG_INFO, "    BootMode        - 0x%x\n", FspRtBuffer.BootMode));
 181   DEBUG ((DEBUG_INFO, "    UpdDataRgnPtr   - 0x%x\n", FspRtBuffer.UpdDataRgnPtr));
 182   DEBUG ((DEBUG_INFO, "  HobListPtr        - 0x%x\n", FspMemoryInitParams.HobListPtr));
 183
 184   Status = CallFspMemoryInit (FspHeader, &FspMemoryInitParams);
 185   DEBUG((DEBUG_INFO, "FspMemoryInit status: 0x%x\n", Status));
 186   ASSERT_EFI_ERROR (Status);
 187
 188   DEBUG ((DEBUG_INFO, "  HobListPtr (returned) - 0x%x\n", FspHobList));
 189   ASSERT (FspHobList != NULL);
 190
 191   FspHobProcessForMemoryResource (FspHobList);
 192
 193   //
 194   // FspHobList is not complete at this moment.
 195   // Save FspHobList pointer to hob, so that it can be got later
 196   //
 197   HobData = BuildGuidHob (
 198              &gFspInitDonePpiGuid,
 199              sizeof (VOID *)
 200              );
 201   ASSERT (HobData != NULL);
 202   CopyMem (HobData, &FspHobList, sizeof (FspHobList));
 203
 204   return Status;
 205 }
 206
 207 /**
 208   TemporaryRamDone() disables the use of Temporary RAM. If present, this service is invoked
 209   by the PEI Foundation after the EFI_PEI_PERMANANT_MEMORY_INSTALLED_PPI is installed.
 210
 211   @retval EFI_SUCCESS           Use of Temporary RAM was disabled.
 212   @retval EFI_INVALID_PARAMETER Temporary RAM could not be disabled.
 213
 214 **/
 215 EFI_STATUS
 216 EFIAPI
 217 PeiTemporaryRamDone (
 218   VOID
 219   )
 220 {
 221   EFI_STATUS                Status;
 222   VOID                      *TempRamExitParam;
 223   FSP_INFO_HEADER           *FspHeader;
 224
 225   FspHeader = FspFindFspHeader (PcdGet32 (PcdFlashFvFspBase));
 226   if (FspHeader == NULL) {
 227     return EFI_DEVICE_ERROR;
 228   }
 229
 230   DEBUG ((DEBUG_INFO, "PeiTemporaryRamDone enter\n"));
 231
 232   TempRamExitParam = GetTempRamExitParam ();
 233   Status = CallTempRamExit (FspHeader, TempRamExitParam);
 234   DEBUG((DEBUG_INFO, "TempRamExit status: 0x%x\n", Status));
 235   ASSERT_EFI_ERROR (Status);
 236
 237   return EFI_SUCCESS;
 238 }
 239
 240 /**
 241   This function is called after PEI core discover memory and finish migration.
 242
 243   @param[in] PeiServices    Pointer to PEI Services Table.
 244   @param[in] NotifyDesc     Pointer to the descriptor for the Notification event that
 245                             caused this function to execute.
 246   @param[in] Ppi            Pointer to the PPI data associated with this function.
 247
 248   @retval EFI_STATUS        Always return EFI_SUCCESS
 249 **/
 250 EFI_STATUS
 251 EFIAPI
 252 PeiMemoryDiscoveredNotify (
 253   IN EFI_PEI_SERVICES          **PeiServices,
 254   IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDesc,
 255   IN VOID                      *Ppi
 256   )
 257 {
 258   EFI_STATUS                Status;
 259   VOID                      *FspSiliconInitParam;
 260   FSP_INFO_HEADER           *FspHeader;
 261   VOID                      *FspHobList;
 262   EFI_HOB_GUID_TYPE         *GuidHob;
 263
 264   if (PcdGet32 (PcdFlashFvSecondFspBase) == 0) {
 265     FspHeader = FspFindFspHeader (PcdGet32 (PcdFlashFvFspBase));
 266   } else {
 267     FspHeader = FspFindFspHeader (PcdGet32 (PcdFlashFvSecondFspBase));
 268   }
 269   if (FspHeader == NULL) {
 270     return EFI_DEVICE_ERROR;
 271   }
 272
 273   DEBUG ((DEBUG_INFO, "PeiMemoryDiscoveredNotify enter\n"));
 274
 275   FspSiliconInitParam = GetFspSiliconInitParam ();
 276   Status = CallFspSiliconInit (FspHeader, FspSiliconInitParam);
 277   DEBUG((DEBUG_ERROR, "FspSiliconInit status: 0x%x\n", Status));
 278   ASSERT_EFI_ERROR (Status);
 279
 280   //
 281   // Now FspHobList complete, process it
 282   //
 283   GuidHob = GetFirstGuidHob (&gFspInitDonePpiGuid);
 284   ASSERT (GuidHob != NULL);
 285   FspHobList = *(VOID **)GET_GUID_HOB_DATA (GuidHob);
 286   DEBUG ((DEBUG_INFO, "FspHobList - 0x%x\n", FspHobList));
 287   FspHobProcessForOtherData (FspHobList);
 288
 289   //
 290   // Install FspInitDonePpi so that any other driver can consume this info.
 291   //
 292   Status = PeiServicesInstallPpi (&mPeiFspInitDonePpiV2);
 293   ASSERT_EFI_ERROR(Status);
 294
 295   return EFI_SUCCESS;
 296 }
 297
 298 /**
 299   Do FSP initialization based on FspApi version 2.
 300
 301   @param[in] FspHeader FSP header pointer.
 302
 303   @return FSP initialization status.
 304 **/
 305 EFI_STATUS
 306 PeiFspInitV2 (
 307   IN FSP_INFO_HEADER *FspHeader
 308   )
 309 {
 310   EFI_STATUS           Status;
 311   EFI_BOOT_MODE        BootMode;
 312
 313   Status = PeiFspMemoryInit (FspHeader);
 314   ASSERT_EFI_ERROR (Status);
 315
 316   //
 317   // Install TempramDonePpi to run TempRamExit
 318   //
 319   Status = PeiServicesInstallPpi (&mPeiTemporaryRamDoneDesc);
 320   ASSERT_EFI_ERROR(Status);
 321
 322   //
 323   // Register MemoryDiscovered Nofity to run FspSiliconInit
 324   //
 325   Status = PeiServicesNotifyPpi (&mPeiMemoryDiscoveredNotifyDesc);
 326   ASSERT_EFI_ERROR (Status);
 327
 328   //
 329   // Register EndOfPei Notify for S3 to run FspNotifyPhase
 330   //
 331   PeiServicesGetBootMode (&BootMode);
 332   if (BootMode == BOOT_ON_S3_RESUME) {
 333     Status = PeiServicesNotifyPpi (&mS3EndOfPeiNotifyDesc);
 334     ASSERT_EFI_ERROR (Status);
 335   }
 336
 337   return EFI_SUCCESS;
 338 }