MdeModulePkg/Core/Pei/PeiMain/PeiMain.c

   1 /*++
   2
   3 Copyright (c) 2006, Intel Corporation
   4 All rights reserved. This program and the accompanying materials
   5 are licensed and made available under the terms and conditions of the BSD License
   6 which accompanies this distribution.  The full text of the license may be found at
   7 http://opensource.org/licenses/bsd-license.php
   8
   9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  11
  12 Module Name:
  13
  14   PeiMain.c
  15
  16 Abstract:
  17
  18   Pei Core Main Entry Point
  19
  20 Revision History
  21
  22 --*/
  23
  24 #include <PeiMain.h>
  25
  26 //
  27 //CAR is filled with this initial value during SEC phase
  28 //
  29 #define INIT_CAR_VALUE 0x5AA55AA5
  30
  31 static EFI_PEI_PPI_DESCRIPTOR mMemoryDiscoveredPpi = {
  32   (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
  33   &gEfiPeiMemoryDiscoveredPpiGuid,
  34   NULL
  35 };
  36
  37 //
  38 // Pei Core Module Variables
  39 //
  40 //
  41 static EFI_PEI_SERVICES  mPS = {
  42   {
  43     PEI_SERVICES_SIGNATURE,
  44     PEI_SERVICES_REVISION,
  45     sizeof (EFI_PEI_SERVICES),
  46     0,
  47     0
  48   },
  49   PeiInstallPpi,
  50   PeiReInstallPpi,
  51   PeiLocatePpi,
  52   PeiNotifyPpi,
  53
  54   PeiGetBootMode,
  55   PeiSetBootMode,
  56
  57   PeiGetHobList,
  58   PeiCreateHob,
  59
  60   PeiFvFindNextVolume,
  61   PeiFfsFindNextFile,
  62   PeiFfsFindSectionData,
  63
  64   PeiInstallPeiMemory,
  65   PeiAllocatePages,
  66   PeiAllocatePool,
  67   (EFI_PEI_COPY_MEM)CopyMem,
  68   (EFI_PEI_SET_MEM)SetMem,
  69
  70   PeiReportStatusCode,
  71   PeiResetSystem,
  72
  73   NULL,
  74   NULL,
  75
  76   PeiFfsFindFileByName,
  77   PeiFfsGetFileInfo,
  78   PeiFfsGetVolumeInfo,
  79   PeiRegisterForShadow
  80 };
  81
  82 EFI_STATUS
  83 EFIAPI
  84 PeiCore (
  85   IN CONST EFI_SEC_PEI_HAND_OFF        *SecCoreData,
  86   IN CONST EFI_PEI_PPI_DESCRIPTOR      *PpiList,
  87   IN VOID                              *Data
  88   )
  89 /*++
  90
  91 Routine Description:
  92
  93   The entry routine to Pei Core, invoked by PeiMain during transition
  94   from SEC to PEI. After switching stack in the PEI core, it will restart
  95   with the old core data.
  96
  97 Arguments:
  98
  99   SecCoreData          - Points to a data structure containing information about the PEI core's operating
 100                          environment, such as the size and location of temporary RAM, the stack location and
 101                          the BFV location.
 102   PpiList              - Points to a list of one or more PPI descriptors to be installed initially by the PEI core.
 103                          An empty PPI list consists of a single descriptor with the end-tag
 104                          EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST. As part of its initialization
 105                          phase, the PEI Foundation will add these SEC-hosted PPIs to its PPI database such
 106                          that both the PEI Foundation and any modules can leverage the associated service
 107                          calls and/or code in these early PPIs
 108   Data                 - Pointer to old core data that is used to initialize the
 109                          core's data areas.
 110
 111 Returns:
 112
 113   This function never returns
 114   EFI_NOT_FOUND        - Never reach
 115
 116 --*/
 117 {
 118   PEI_CORE_INSTANCE                                     PrivateData;
 119   EFI_STATUS                                            Status;
 120   PEI_CORE_TEMP_POINTERS                                TempPtr;
 121   UINT64                                                mTick;
 122   PEI_CORE_INSTANCE                                     *OldCoreData;
 123   EFI_PEI_CPU_IO_PPI                                    *CpuIo;
 124   EFI_PEI_PCI_CFG2_PPI                                  *PciCfg;
 125   PEI_CORE_ENTRY_POINT                                  ShadowedPeiCore;
 126
 127   mTick = 0;
 128   OldCoreData = (PEI_CORE_INSTANCE *) Data;
 129
 130   if (PerformanceMeasurementEnabled()) {
 131     if (OldCoreData == NULL) {
 132       mTick = GetPerformanceCounter ();
 133     }
 134   }
 135
 136   if (OldCoreData != NULL) {
 137     ShadowedPeiCore = (PEI_CORE_ENTRY_POINT) (UINTN) OldCoreData->ShadowedPeiCore;
 138     if (ShadowedPeiCore != NULL) {
 139       OldCoreData->ShadowedPeiCore = NULL;
 140       ShadowedPeiCore (
 141         SecCoreData,
 142         PpiList,
 143         OldCoreData
 144         );
 145     }
 146
 147     CopyMem (&PrivateData, OldCoreData, sizeof (PEI_CORE_INSTANCE));
 148
 149     CpuIo = (VOID*)PrivateData.ServiceTableShadow.CpuIo;
 150     PciCfg = (VOID*)PrivateData.ServiceTableShadow.PciCfg;
 151
 152     CopyMem (&PrivateData.ServiceTableShadow, &mPS, sizeof (mPS));
 153
 154     PrivateData.ServiceTableShadow.CpuIo  = CpuIo;
 155     PrivateData.ServiceTableShadow.PciCfg = PciCfg;
 156   } else {
 157     ZeroMem (&PrivateData, sizeof (PEI_CORE_INSTANCE));
 158     PrivateData.Signature = PEI_CORE_HANDLE_SIGNATURE;
 159     CopyMem (&PrivateData.ServiceTableShadow, &mPS, sizeof (mPS));
 160   }
 161
 162   PrivateData.PS = &PrivateData.ServiceTableShadow;
 163
 164   //
 165   // Initialize libraries that the PeiCore is linked against
 166   // BUGBUG: The FileHandle is passed in as NULL.  Do we look it up or remove it from the lib init?
 167   //
 168   ProcessLibraryConstructorList (NULL, &PrivateData.PS);
 169
 170   InitializeMemoryServices (&PrivateData, SecCoreData, OldCoreData);
 171
 172   InitializePpiServices (&PrivateData, OldCoreData);
 173
 174   //
 175   // Save PeiServicePointer so that it can be retrieved anywhere.
 176   //
 177   SetPeiServicesTablePointer(&PrivateData.PS);
 178
 179   if (OldCoreData != NULL) {
 180
 181     PERF_END (NULL,"PreMem", NULL, 0);
 182     PERF_START (NULL,"PostMem", NULL, 0);
 183
 184     //
 185     // Alert any listeners that there is permanent memory available
 186     //
 187
 188     PERF_START (NULL,"DisMem", NULL, 0);
 189     Status = PeiServicesInstallPpi (&mMemoryDiscoveredPpi);
 190     PERF_END (NULL,"DisMem", NULL, 0);
 191
 192   } else {
 193
 194     //
 195     // Report Status Code EFI_SW_PC_INIT
 196     //
 197     REPORT_STATUS_CODE (
 198       EFI_PROGRESS_CODE,
 199       FixedPcdGet32 (PcdStatusCodeValuePeiCoreEntry)
 200       );
 201
 202     PERF_START (NULL,"PEI", NULL, mTick);
 203     //
 204     // If first pass, start performance measurement.
 205     //
 206     PERF_START (NULL,"PreMem", NULL, mTick);
 207
 208     //
 209     // If SEC provided any PPI services to PEI, install them.
 210     //
 211     if (PpiList != NULL) {
 212       Status = PeiServicesInstallPpi (PpiList);
 213       ASSERT_EFI_ERROR (Status);
 214     }
 215   }
 216
 217   InitializeSecurityServices (&PrivateData.PS, OldCoreData);
 218
 219   InitializeDispatcherData (&PrivateData, OldCoreData, SecCoreData);
 220
 221   //
 222   // Install Pei Load File PPI.
 223   //
 224   InitializeImageServices (&PrivateData, OldCoreData);
 225
 226   //
 227   // Call PEIM dispatcher
 228   //
 229   PeiDispatcher (SecCoreData, &PrivateData);
 230
 231   //
 232   // Check if InstallPeiMemory service was called.
 233   //
 234   ASSERT(PrivateData.PeiMemoryInstalled == TRUE);
 235
 236   PERF_END (NULL, "PostMem", NULL, 0);
 237
 238   Status = PeiServicesLocatePpi (
 239              &gEfiDxeIplPpiGuid,
 240              0,
 241              NULL,
 242              (VOID **)&TempPtr.DxeIpl
 243              );
 244   ASSERT_EFI_ERROR (Status);
 245
 246   DEBUG ((EFI_D_INFO, "DXE IPL Entry\n"));
 247   Status = TempPtr.DxeIpl->Entry (
 248                              TempPtr.DxeIpl,
 249                              &PrivateData.PS,
 250                              PrivateData.HobList
 251                              );
 252
 253   ASSERT_EFI_ERROR (Status);
 254
 255   return EFI_NOT_FOUND;
 256 }
 257
 258