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
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.
18 Pei Core Main Entry Point
27 //CAR is filled with this initial value during SEC phase
29 #define INIT_CAR_VALUE 0x5AA55AA5
31 static EFI_PEI_PPI_DESCRIPTOR mMemoryDiscoveredPpi
= {
32 (EFI_PEI_PPI_DESCRIPTOR_PPI
| EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST
),
33 &gEfiPeiMemoryDiscoveredPpiGuid
,
38 // Pei Core Module Variables
41 static EFI_PEI_SERVICES mPS
= {
43 PEI_SERVICES_SIGNATURE
,
44 PEI_SERVICES_REVISION
,
45 sizeof (EFI_PEI_SERVICES
),
62 PeiFfsFindSectionData
,
67 (EFI_PEI_COPY_MEM
)CopyMem
,
68 (EFI_PEI_SET_MEM
)SetMem
,
84 IN EFI_PEI_STARTUP_DESCRIPTOR
*PeiStartupDescriptor
,
91 The entry routine to Pei Core, invoked by PeiMain during transition
92 from SEC to PEI. After switching stack in the PEI core, it will restart
93 with the old core data.
97 PeiStartupDescriptor - Information and services provided by SEC phase.
98 OldCoreData - Pointer to old core data that is used to initialize the
103 This function never returns
104 EFI_NOT_FOUND - Never reach
108 PEI_CORE_INSTANCE PrivateData
;
110 PEI_CORE_TEMP_POINTERS TempPtr
;
111 PEI_CORE_DISPATCH_DATA
*DispatchData
;
113 PEI_CORE_INSTANCE
*OldCoreData
;
116 OldCoreData
= (PEI_CORE_INSTANCE
*) Data
;
118 if (PerformanceMeasurementEnabled()) {
119 if (OldCoreData
== NULL
) {
120 mTick
= GetPerformanceCounter ();
125 // For IPF in CAR mode the real memory access is uncached,in InstallPeiMemory()
126 // the 63-bit of address is set to 1.
128 SWITCH_TO_CACHE_MODE (OldCoreData
);
130 if (OldCoreData
!= NULL
) {
131 CopyMem (&PrivateData
, OldCoreData
, sizeof (PEI_CORE_INSTANCE
));
133 ZeroMem (&PrivateData
, sizeof (PEI_CORE_INSTANCE
));
136 PrivateData
.Signature
= PEI_CORE_HANDLE_SIGNATURE
;
137 PrivateData
.PS
= &mPS
;
140 // Initialize libraries that the PeiCore is linked against
141 // BUGBUG: The FfsHeader is passed in as NULL. Do we look it up or remove it from the lib init?
143 ProcessLibraryConstructorList (NULL
, &PrivateData
.PS
);
145 InitializeMemoryServices (&PrivateData
.PS
, PeiStartupDescriptor
, OldCoreData
);
147 InitializePpiServices (&PrivateData
.PS
, OldCoreData
);
149 InitializeSecurityServices (&PrivateData
.PS
, OldCoreData
);
151 InitializeDispatcherData (&PrivateData
.PS
, OldCoreData
, PeiStartupDescriptor
);
153 if (OldCoreData
!= NULL
) {
155 PERF_END (NULL
,"PreMem", NULL
, 0);
156 PERF_START (NULL
,"PostMem", NULL
, 0);
159 // The following code dumps out interesting cache as RAM usage information
160 // so we can keep tabs on how the cache as RAM is being utilized. The
161 // DEBUG_CODE_BEGIN macro is used to prevent this code from being compiled
168 StackValue
= INIT_CAR_VALUE
;
169 for (StackPointer
= (UINTN
*) OldCoreData
->MaxTopOfCarHeap
;
170 ((UINTN
) StackPointer
< ((UINTN
) OldCoreData
->BottomOfCarHeap
+ OldCoreData
->SizeOfCacheAsRam
))
171 && StackValue
== INIT_CAR_VALUE
;
173 StackValue
= *StackPointer
;
176 DEBUG ((EFI_D_INFO
, "Total Cache as RAM: %d bytes.\n", OldCoreData
->SizeOfCacheAsRam
));
177 DEBUG ((EFI_D_INFO
, " CAR stack ever used: %d bytes.\n",
178 ((UINTN
) OldCoreData
->TopOfCarHeap
- (UINTN
) StackPointer
)
180 DEBUG ((EFI_D_INFO
, " CAR heap used: %d bytes.\n",
181 ((UINTN
) OldCoreData
->HobList
.HandoffInformationTable
->EfiFreeMemoryBottom
-
182 (UINTN
) OldCoreData
->HobList
.Raw
)
187 // Alert any listeners that there is permanent memory available
190 PERF_START (NULL
,"DisMem", NULL
, 0);
191 Status
= PeiServicesInstallPpi (&mMemoryDiscoveredPpi
);
192 PERF_END (NULL
,"DisMem", NULL
, 0);
197 // Report Status Code EFI_SW_PC_INIT
201 EFI_SOFTWARE_PEI_CORE
| EFI_SW_PC_INIT
204 PERF_START (NULL
,"PEI", NULL
, mTick
);
206 // If first pass, start performance measurement.
208 PERF_START (NULL
,"PreMem", NULL
, mTick
);
211 // If SEC provided any PPI services to PEI, install them.
213 if (PeiStartupDescriptor
->DispatchTable
!= NULL
) {
214 Status
= PeiServicesInstallPpi (PeiStartupDescriptor
->DispatchTable
);
215 ASSERT_EFI_ERROR (Status
);
219 DispatchData
= &PrivateData
.DispatchData
;
222 // Call PEIM dispatcher
224 PeiDispatcher (PeiStartupDescriptor
, &PrivateData
, DispatchData
);
227 // Check if InstallPeiMemory service was called.
229 ASSERT(PrivateData
.PeiMemoryInstalled
== TRUE
);
231 PERF_END (NULL
, "PostMem", NULL
, 0);
233 Status
= PeiServicesLocatePpi (
237 (VOID
**)&TempPtr
.DxeIpl
239 ASSERT_EFI_ERROR (Status
);
241 DEBUG ((EFI_D_INFO
, "DXE IPL Entry\n"));
242 Status
= TempPtr
.DxeIpl
->Entry (
248 ASSERT_EFI_ERROR (Status
);
250 return EFI_NOT_FOUND
;