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
,
78 IN EFI_PEI_STARTUP_DESCRIPTOR
*PeiStartupDescriptor
,
79 IN PEI_CORE_INSTANCE
*OldCoreData
85 Main entry point to Pei Core. After switching stack in the PEI core,
86 it will restart with the old core data.
90 PeiStartupDescriptor - Information and services provided by SEC phase.
91 OldCoreData - Pointer to old core data that is used to initialize the
96 This function never returns
97 EFI_NOT_FOUND - Never reach
101 PEI_CORE_INSTANCE PrivateData
;
103 PEI_CORE_TEMP_POINTERS TempPtr
;
104 PEI_CORE_DISPATCH_DATA
*DispatchData
;
109 #ifdef EFI_PEI_PERFORMANCE
110 if (OldCoreData
== NULL
) {
111 mTick
= GetPerformanceCounter ();
116 // For IPF in CAR mode the real memory access is uncached,in InstallPeiMemory()
117 // the 63-bit of address is set to 1.
119 SWITCH_TO_CACHE_MODE (OldCoreData
);
121 if (OldCoreData
!= NULL
) {
122 CopyMem (&PrivateData
, OldCoreData
, sizeof (PEI_CORE_INSTANCE
));
124 ZeroMem (&PrivateData
, sizeof (PEI_CORE_INSTANCE
));
127 PrivateData
.Signature
= PEI_CORE_HANDLE_SIGNATURE
;
128 PrivateData
.PS
= &mPS
;
131 // Initialize libraries that the PeiCore is linked against
132 // BUGBUG: The FfsHeader is passed in as NULL. Do we look it up or remove it from the lib init?
134 ProcessLibraryConstructorList (NULL
, &PrivateData
.PS
);
136 InitializeMemoryServices (&PrivateData
.PS
, PeiStartupDescriptor
, OldCoreData
);
138 InitializePpiServices (&PrivateData
.PS
, OldCoreData
);
140 InitializeSecurityServices (&PrivateData
.PS
, OldCoreData
);
142 InitializeDispatcherData (&PrivateData
.PS
, OldCoreData
, PeiStartupDescriptor
);
144 if (OldCoreData
!= NULL
) {
146 PERF_END (NULL
,"PreMem", NULL
, 0);
147 PERF_START (NULL
,"PostMem", NULL
, 0);
150 // The following code dumps out interesting cache as RAM usage information
151 // so we can keep tabs on how the cache as RAM is being utilized. The
152 // DEBUG_CODE macro is used to prevent this code from being compiled
159 StackValue
= INIT_CAR_VALUE
;
160 for (StackPointer
= (UINTN
*) OldCoreData
->MaxTopOfCarHeap
;
161 ((UINTN
) StackPointer
< ((UINTN
) OldCoreData
->BottomOfCarHeap
+ OldCoreData
->SizeOfCacheAsRam
))
162 && StackValue
== INIT_CAR_VALUE
;
164 StackValue
= *StackPointer
;
167 DEBUG ((EFI_D_INFO
, "Total Cache as RAM: %d bytes.\n", OldCoreData
->SizeOfCacheAsRam
));
168 DEBUG ((EFI_D_INFO
, " CAR stack ever used: %d bytes.\n",
169 ((UINTN
) OldCoreData
->TopOfCarHeap
- (UINTN
) StackPointer
)
171 DEBUG ((EFI_D_INFO
, " CAR heap used: %d bytes.\n",
172 ((UINTN
) OldCoreData
->HobList
.HandoffInformationTable
->EfiFreeMemoryBottom
-
173 (UINTN
) OldCoreData
->HobList
.Raw
)
178 // Alert any listeners that there is permanent memory available
180 PERF_START (NULL
,"DisMem", NULL
, 0);
181 Status
= PeiCoreInstallPpi (&mMemoryDiscoveredPpi
);
182 PERF_END (NULL
,"DisMem", NULL
, 0);
187 // Report Status Code EFI_SW_PC_INIT
191 EFI_SOFTWARE_PEI_CORE
| EFI_SW_PC_INIT
195 // If first pass, start performance measurement.
197 PERF_START (NULL
,"PreMem", NULL
, mTick
);
200 // If SEC provided any PPI services to PEI, install them.
202 if (PeiStartupDescriptor
->DispatchTable
!= NULL
) {
203 Status
= PeiCoreInstallPpi (PeiStartupDescriptor
->DispatchTable
);
204 ASSERT_EFI_ERROR (Status
);
208 DispatchData
= &PrivateData
.DispatchData
;
211 // Call PEIM dispatcher
213 PeiDispatcher (PeiStartupDescriptor
, &PrivateData
, DispatchData
);
216 // Check if InstallPeiMemory service was called.
218 ASSERT(PrivateData
.PeiMemoryInstalled
== TRUE
);
220 PERF_END (NULL
, "PostMem", NULL
, 0);
222 Status
= PeiCoreLocatePpi (
226 (VOID
**)&TempPtr
.DxeIpl
228 ASSERT_EFI_ERROR (Status
);
230 DEBUG ((EFI_D_INFO
, "DXE IPL Entry\n"));
231 Status
= TempPtr
.DxeIpl
->Entry (
237 ASSERT_EFI_ERROR (Status
);
239 return EFI_NOT_FOUND
;