2 Pei Core Main Entry Point
4 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 EFI_PEI_PPI_DESCRIPTOR mMemoryDiscoveredPpi
= {
18 (EFI_PEI_PPI_DESCRIPTOR_PPI
| EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST
),
19 &gEfiPeiMemoryDiscoveredPpiGuid
,
24 /// Pei service instance
26 EFI_PEI_SERVICES gPs
= {
28 PEI_SERVICES_SIGNATURE
,
29 PEI_SERVICES_REVISION
,
30 sizeof (EFI_PEI_SERVICES
),
47 PeiFfsFindSectionData
,
52 (EFI_PEI_COPY_MEM
)CopyMem
,
53 (EFI_PEI_SET_MEM
)SetMem
,
59 &gPeiDefaultPciCfg2Ppi
,
65 PeiFfsFindSectionData3
,
72 Shadow PeiCore module from flash to installed memory.
74 @param PrivateData PeiCore's private data structure
76 @return PeiCore function address after shadowing.
78 PEICORE_FUNCTION_POINTER
80 IN PEI_CORE_INSTANCE
*PrivateData
83 EFI_PEI_FILE_HANDLE PeiCoreFileHandle
;
84 EFI_PHYSICAL_ADDRESS EntryPoint
;
86 UINT32 AuthenticationState
;
88 PeiCoreFileHandle
= NULL
;
91 // Find the PEI Core in the BFV
93 Status
= PrivateData
->Fv
[0].FvPpi
->FindFileByType (
94 PrivateData
->Fv
[0].FvPpi
,
95 EFI_FV_FILETYPE_PEI_CORE
,
96 PrivateData
->Fv
[0].FvHandle
,
99 ASSERT_EFI_ERROR (Status
);
102 // Shadow PEI Core into memory so it will run faster
104 Status
= PeiLoadImage (
105 GetPeiServicesTablePointer (),
106 *((EFI_PEI_FILE_HANDLE
*)&PeiCoreFileHandle
),
107 PEIM_STATE_REGISTER_FOR_SHADOW
,
111 ASSERT_EFI_ERROR (Status
);
114 // Compute the PeiCore's function address after shaowed PeiCore.
115 // _ModuleEntryPoint is PeiCore main function entry
117 return (PEICORE_FUNCTION_POINTER
)((UINTN
) EntryPoint
+ (UINTN
) PeiCore
- (UINTN
) _ModuleEntryPoint
);
121 This routine is invoked by main entry of PeiMain module during transition
122 from SEC to PEI. After switching stack in the PEI core, it will restart
123 with the old core data.
125 @param SecCoreDataPtr Points to a data structure containing information about the PEI core's operating
126 environment, such as the size and location of temporary RAM, the stack location and
128 @param PpiList Points to a list of one or more PPI descriptors to be installed initially by the PEI core.
129 An empty PPI list consists of a single descriptor with the end-tag
130 EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST. As part of its initialization
131 phase, the PEI Foundation will add these SEC-hosted PPIs to its PPI database such
132 that both the PEI Foundation and any modules can leverage the associated service
133 calls and/or code in these early PPIs
134 @param Data Pointer to old core data that is used to initialize the
136 If NULL, it is first PeiCore entering.
142 IN CONST EFI_SEC_PEI_HAND_OFF
*SecCoreDataPtr
,
143 IN CONST EFI_PEI_PPI_DESCRIPTOR
*PpiList
,
147 PEI_CORE_INSTANCE PrivateData
;
148 EFI_SEC_PEI_HAND_OFF
*SecCoreData
;
149 EFI_SEC_PEI_HAND_OFF NewSecCoreData
;
151 PEI_CORE_TEMP_POINTERS TempPtr
;
152 PEI_CORE_INSTANCE
*OldCoreData
;
153 EFI_PEI_CPU_IO_PPI
*CpuIo
;
154 EFI_PEI_PCI_CFG2_PPI
*PciCfg
;
155 EFI_HOB_HANDOFF_INFO_TABLE
*HandoffInformationTable
;
156 EFI_PEI_TEMPORARY_RAM_DONE_PPI
*TemporaryRamDonePpi
;
160 // Retrieve context passed into PEI Core
162 OldCoreData
= (PEI_CORE_INSTANCE
*) Data
;
163 SecCoreData
= (EFI_SEC_PEI_HAND_OFF
*) SecCoreDataPtr
;
166 // Perform PEI Core phase specific actions.
168 if (OldCoreData
== NULL
) {
170 // If OldCoreData is NULL, means current is the first entry into the PEI Core before memory is available.
172 ZeroMem (&PrivateData
, sizeof (PEI_CORE_INSTANCE
));
173 PrivateData
.Signature
= PEI_CORE_HANDLE_SIGNATURE
;
174 CopyMem (&PrivateData
.ServiceTableShadow
, &gPs
, sizeof (gPs
));
177 // Memory is available to the PEI Core. See if the PEI Core has been shadowed to memory yet.
179 if (OldCoreData
->ShadowedPeiCore
== NULL
) {
181 // Fixup the PeiCore's private data
183 OldCoreData
->Ps
= &OldCoreData
->ServiceTableShadow
;
184 OldCoreData
->CpuIo
= &OldCoreData
->ServiceTableShadow
.CpuIo
;
185 if (OldCoreData
->HeapOffsetPositive
) {
186 OldCoreData
->HobList
.Raw
= (VOID
*)(OldCoreData
->HobList
.Raw
+ OldCoreData
->HeapOffset
);
187 if (OldCoreData
->UnknownFvInfo
!= NULL
) {
188 OldCoreData
->UnknownFvInfo
= (PEI_CORE_UNKNOW_FORMAT_FV_INFO
*) ((UINT8
*) OldCoreData
->UnknownFvInfo
+ OldCoreData
->HeapOffset
);
190 if (OldCoreData
->CurrentFvFileHandles
!= NULL
) {
191 OldCoreData
->CurrentFvFileHandles
= (EFI_PEI_FILE_HANDLE
*) ((UINT8
*) OldCoreData
->CurrentFvFileHandles
+ OldCoreData
->HeapOffset
);
193 if (OldCoreData
->PpiData
.PpiList
.PpiPtrs
!= NULL
) {
194 OldCoreData
->PpiData
.PpiList
.PpiPtrs
= (PEI_PPI_LIST_POINTERS
*) ((UINT8
*) OldCoreData
->PpiData
.PpiList
.PpiPtrs
+ OldCoreData
->HeapOffset
);
196 if (OldCoreData
->PpiData
.CallbackNotifyList
.NotifyPtrs
!= NULL
) {
197 OldCoreData
->PpiData
.CallbackNotifyList
.NotifyPtrs
= (PEI_PPI_LIST_POINTERS
*) ((UINT8
*) OldCoreData
->PpiData
.CallbackNotifyList
.NotifyPtrs
+ OldCoreData
->HeapOffset
);
199 if (OldCoreData
->PpiData
.DispatchNotifyList
.NotifyPtrs
!= NULL
) {
200 OldCoreData
->PpiData
.DispatchNotifyList
.NotifyPtrs
= (PEI_PPI_LIST_POINTERS
*) ((UINT8
*) OldCoreData
->PpiData
.DispatchNotifyList
.NotifyPtrs
+ OldCoreData
->HeapOffset
);
202 OldCoreData
->Fv
= (PEI_CORE_FV_HANDLE
*) ((UINT8
*) OldCoreData
->Fv
+ OldCoreData
->HeapOffset
);
203 for (Index
= 0; Index
< OldCoreData
->FvCount
; Index
++) {
204 if (OldCoreData
->Fv
[Index
].PeimState
!= NULL
) {
205 OldCoreData
->Fv
[Index
].PeimState
= (UINT8
*) OldCoreData
->Fv
[Index
].PeimState
+ OldCoreData
->HeapOffset
;
207 if (OldCoreData
->Fv
[Index
].FvFileHandles
!= NULL
) {
208 OldCoreData
->Fv
[Index
].FvFileHandles
= (EFI_PEI_FILE_HANDLE
*) ((UINT8
*) OldCoreData
->Fv
[Index
].FvFileHandles
+ OldCoreData
->HeapOffset
);
211 OldCoreData
->TempFileGuid
= (EFI_GUID
*) ((UINT8
*) OldCoreData
->TempFileGuid
+ OldCoreData
->HeapOffset
);
212 OldCoreData
->TempFileHandles
= (EFI_PEI_FILE_HANDLE
*) ((UINT8
*) OldCoreData
->TempFileHandles
+ OldCoreData
->HeapOffset
);
214 OldCoreData
->HobList
.Raw
= (VOID
*)(OldCoreData
->HobList
.Raw
- OldCoreData
->HeapOffset
);
215 if (OldCoreData
->UnknownFvInfo
!= NULL
) {
216 OldCoreData
->UnknownFvInfo
= (PEI_CORE_UNKNOW_FORMAT_FV_INFO
*) ((UINT8
*) OldCoreData
->UnknownFvInfo
- OldCoreData
->HeapOffset
);
218 if (OldCoreData
->CurrentFvFileHandles
!= NULL
) {
219 OldCoreData
->CurrentFvFileHandles
= (EFI_PEI_FILE_HANDLE
*) ((UINT8
*) OldCoreData
->CurrentFvFileHandles
- OldCoreData
->HeapOffset
);
221 if (OldCoreData
->PpiData
.PpiList
.PpiPtrs
!= NULL
) {
222 OldCoreData
->PpiData
.PpiList
.PpiPtrs
= (PEI_PPI_LIST_POINTERS
*) ((UINT8
*) OldCoreData
->PpiData
.PpiList
.PpiPtrs
- OldCoreData
->HeapOffset
);
224 if (OldCoreData
->PpiData
.CallbackNotifyList
.NotifyPtrs
!= NULL
) {
225 OldCoreData
->PpiData
.CallbackNotifyList
.NotifyPtrs
= (PEI_PPI_LIST_POINTERS
*) ((UINT8
*) OldCoreData
->PpiData
.CallbackNotifyList
.NotifyPtrs
- OldCoreData
->HeapOffset
);
227 if (OldCoreData
->PpiData
.DispatchNotifyList
.NotifyPtrs
!= NULL
) {
228 OldCoreData
->PpiData
.DispatchNotifyList
.NotifyPtrs
= (PEI_PPI_LIST_POINTERS
*) ((UINT8
*) OldCoreData
->PpiData
.DispatchNotifyList
.NotifyPtrs
- OldCoreData
->HeapOffset
);
230 OldCoreData
->Fv
= (PEI_CORE_FV_HANDLE
*) ((UINT8
*) OldCoreData
->Fv
- OldCoreData
->HeapOffset
);
231 for (Index
= 0; Index
< OldCoreData
->FvCount
; Index
++) {
232 if (OldCoreData
->Fv
[Index
].PeimState
!= NULL
) {
233 OldCoreData
->Fv
[Index
].PeimState
= (UINT8
*) OldCoreData
->Fv
[Index
].PeimState
- OldCoreData
->HeapOffset
;
235 if (OldCoreData
->Fv
[Index
].FvFileHandles
!= NULL
) {
236 OldCoreData
->Fv
[Index
].FvFileHandles
= (EFI_PEI_FILE_HANDLE
*) ((UINT8
*) OldCoreData
->Fv
[Index
].FvFileHandles
- OldCoreData
->HeapOffset
);
239 OldCoreData
->TempFileGuid
= (EFI_GUID
*) ((UINT8
*) OldCoreData
->TempFileGuid
- OldCoreData
->HeapOffset
);
240 OldCoreData
->TempFileHandles
= (EFI_PEI_FILE_HANDLE
*) ((UINT8
*) OldCoreData
->TempFileHandles
- OldCoreData
->HeapOffset
);
244 // Fixup for PeiService's address
246 SetPeiServicesTablePointer ((CONST EFI_PEI_SERVICES
**)&OldCoreData
->Ps
);
249 // Initialize libraries that the PEI Core is linked against
251 ProcessLibraryConstructorList (NULL
, (CONST EFI_PEI_SERVICES
**)&OldCoreData
->Ps
);
254 // Update HandOffHob for new installed permanent memory
256 HandoffInformationTable
= OldCoreData
->HobList
.HandoffInformationTable
;
257 if (OldCoreData
->HeapOffsetPositive
) {
258 HandoffInformationTable
->EfiEndOfHobList
= HandoffInformationTable
->EfiEndOfHobList
+ OldCoreData
->HeapOffset
;
260 HandoffInformationTable
->EfiEndOfHobList
= HandoffInformationTable
->EfiEndOfHobList
- OldCoreData
->HeapOffset
;
262 HandoffInformationTable
->EfiMemoryTop
= OldCoreData
->PhysicalMemoryBegin
+ OldCoreData
->PhysicalMemoryLength
;
263 HandoffInformationTable
->EfiMemoryBottom
= OldCoreData
->PhysicalMemoryBegin
;
264 HandoffInformationTable
->EfiFreeMemoryTop
= OldCoreData
->FreePhysicalMemoryTop
;
265 HandoffInformationTable
->EfiFreeMemoryBottom
= HandoffInformationTable
->EfiEndOfHobList
+ sizeof (EFI_HOB_GENERIC_HEADER
);
268 // We need convert MemoryBaseAddress in memory allocation HOBs
270 ConvertMemoryAllocationHobs (OldCoreData
);
273 // We need convert the PPI descriptor's pointer
275 ConvertPpiPointers (SecCoreData
, OldCoreData
);
278 // After the whole temporary memory is migrated, then we can allocate page in
281 OldCoreData
->PeiMemoryInstalled
= TRUE
;
284 // Indicate that PeiCore reenter
286 OldCoreData
->PeimDispatcherReenter
= TRUE
;
288 if (PcdGet64(PcdLoadModuleAtFixAddressEnable
) != 0 && (OldCoreData
->HobList
.HandoffInformationTable
->BootMode
!= BOOT_ON_S3_RESUME
)) {
290 // if Loading Module at Fixed Address is enabled, allocate the PEI code memory range usage bit map array.
291 // Every bit in the array indicate the status of the corresponding memory page available or not
293 OldCoreData
->PeiCodeMemoryRangeUsageBitMap
= AllocateZeroPool (((PcdGet32(PcdLoadFixAddressPeiCodePageNumber
)>>6) + 1)*sizeof(UINT64
));
297 // Shadow PEI Core. When permanent memory is avaiable, shadow
298 // PEI Core and PEIMs to get high performance.
300 OldCoreData
->ShadowedPeiCore
= (PEICORE_FUNCTION_POINTER
) (UINTN
) PeiCore
;
301 if ((HandoffInformationTable
->BootMode
== BOOT_ON_S3_RESUME
&& PcdGetBool (PcdShadowPeimOnS3Boot
))
302 || (HandoffInformationTable
->BootMode
!= BOOT_ON_S3_RESUME
&& PcdGetBool (PcdShadowPeimOnBoot
))) {
303 OldCoreData
->ShadowedPeiCore
= ShadowPeiCore (OldCoreData
);
307 // PEI Core has now been shadowed to memory. Restart PEI Core in memory.
309 OldCoreData
->ShadowedPeiCore (SecCoreData
, PpiList
, OldCoreData
);
312 // Should never reach here.
321 // Memory is available to the PEI Core and the PEI Core has been shadowed to memory.
323 CopyMem (&NewSecCoreData
, SecCoreDataPtr
, sizeof (NewSecCoreData
));
324 SecCoreData
= &NewSecCoreData
;
326 CopyMem (&PrivateData
, OldCoreData
, sizeof (PrivateData
));
328 CpuIo
= (VOID
*)PrivateData
.ServiceTableShadow
.CpuIo
;
329 PciCfg
= (VOID
*)PrivateData
.ServiceTableShadow
.PciCfg
;
331 CopyMem (&PrivateData
.ServiceTableShadow
, &gPs
, sizeof (gPs
));
333 PrivateData
.ServiceTableShadow
.CpuIo
= CpuIo
;
334 PrivateData
.ServiceTableShadow
.PciCfg
= PciCfg
;
338 // Cache a pointer to the PEI Services Table that is either in temporary memory or permanent memory
340 PrivateData
.Ps
= &PrivateData
.ServiceTableShadow
;
343 // Save PeiServicePointer so that it can be retrieved anywhere.
345 SetPeiServicesTablePointer ((CONST EFI_PEI_SERVICES
**)&PrivateData
.Ps
);
348 // Initialize libraries that the PEI Core is linked against
350 ProcessLibraryConstructorList (NULL
, (CONST EFI_PEI_SERVICES
**)&PrivateData
.Ps
);
353 // Initialize PEI Core Services
355 InitializeMemoryServices (&PrivateData
, SecCoreData
, OldCoreData
);
358 // Update performance measurements
360 if (OldCoreData
== NULL
) {
361 PERF_EVENT ("SEC"); // Means the end of SEC phase.
364 // If first pass, start performance measurement.
366 PERF_CROSSMODULE_BEGIN ("PEI");
367 PERF_INMODULE_BEGIN ("PreMem");
370 PERF_INMODULE_END ("PreMem");
371 PERF_INMODULE_BEGIN ("PostMem");
375 // Complete PEI Core Service initialization
377 InitializeSecurityServices (&PrivateData
.Ps
, OldCoreData
);
378 InitializeDispatcherData (&PrivateData
, OldCoreData
, SecCoreData
);
379 InitializeImageServices (&PrivateData
, OldCoreData
);
382 // Perform PEI Core Phase specific actions
384 if (OldCoreData
== NULL
) {
386 // Report Status Code EFI_SW_PC_INIT
390 (EFI_SOFTWARE_PEI_CORE
| EFI_SW_PC_INIT
)
394 // If SEC provided the PpiList, process it.
396 if (PpiList
!= NULL
) {
397 ProcessPpiListFromSec ((CONST EFI_PEI_SERVICES
**) &PrivateData
.Ps
, PpiList
);
401 // Try to locate Temporary RAM Done Ppi.
403 Status
= PeiServicesLocatePpi (
404 &gEfiTemporaryRamDonePpiGuid
,
407 (VOID
**)&TemporaryRamDonePpi
409 if (!EFI_ERROR (Status
)) {
411 // Disable the use of Temporary RAM after the transition from Temporary RAM to Permanent RAM is complete.
413 TemporaryRamDonePpi
->TemporaryRamDone ();
417 // Alert any listeners that there is permanent memory available
419 PERF_INMODULE_BEGIN ("DisMem");
420 Status
= PeiServicesInstallPpi (&mMemoryDiscoveredPpi
);
423 // Process the Notify list and dispatch any notifies for the Memory Discovered PPI
425 ProcessDispatchNotifyList (&PrivateData
);
427 PERF_INMODULE_END ("DisMem");
431 // Call PEIM dispatcher
433 PeiDispatcher (SecCoreData
, &PrivateData
);
435 if (PrivateData
.HobList
.HandoffInformationTable
->BootMode
!= BOOT_ON_S3_RESUME
) {
437 // Check if InstallPeiMemory service was called on non-S3 resume boot path.
439 ASSERT(PrivateData
.PeiMemoryInstalled
== TRUE
);
443 // Measure PEI Core execution time.
445 PERF_INMODULE_END ("PostMem");
448 // Lookup DXE IPL PPI
450 Status
= PeiServicesLocatePpi (
454 (VOID
**)&TempPtr
.DxeIpl
456 ASSERT_EFI_ERROR (Status
);
458 if (EFI_ERROR (Status
)) {
460 // Report status code to indicate DXE IPL PPI could not be found.
463 EFI_ERROR_CODE
| EFI_ERROR_MAJOR
,
464 (EFI_SOFTWARE_PEI_CORE
| EFI_SW_PEI_CORE_EC_DXEIPL_NOT_FOUND
)
470 // Enter DxeIpl to load Dxe core.
472 DEBUG ((EFI_D_INFO
, "DXE IPL Entry\n"));
473 Status
= TempPtr
.DxeIpl
->Entry (
479 // Should never reach here.
481 ASSERT_EFI_ERROR (Status
);