2 Pei Core Main Entry Point
4 Copyright (c) 2006, Intel Corporation
5 All rights reserved. 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
,
68 This routine is invoked by main entry of PeiMain module during transition
69 from SEC to PEI. After switching stack in the PEI core, it will restart
70 with the old core data.
72 @param SecCoreData Points to a data structure containing information about the PEI core's operating
73 environment, such as the size and location of temporary RAM, the stack location and
75 @param PpiList Points to a list of one or more PPI descriptors to be installed initially by the PEI core.
76 An empty PPI list consists of a single descriptor with the end-tag
77 EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST. As part of its initialization
78 phase, the PEI Foundation will add these SEC-hosted PPIs to its PPI database such
79 that both the PEI Foundation and any modules can leverage the associated service
80 calls and/or code in these early PPIs
81 @param Data Pointer to old core data that is used to initialize the
83 If NULL, it is first PeiCore entering.
89 IN CONST EFI_SEC_PEI_HAND_OFF
*SecCoreData
,
90 IN CONST EFI_PEI_PPI_DESCRIPTOR
*PpiList
,
94 PEI_CORE_INSTANCE PrivateData
;
96 PEI_CORE_TEMP_POINTERS TempPtr
;
98 PEI_CORE_INSTANCE
*OldCoreData
;
99 EFI_PEI_CPU_IO_PPI
*CpuIo
;
100 EFI_PEI_PCI_CFG2_PPI
*PciCfg
;
101 PEICORE_FUNCTION_POINTER ShadowedPeiCore
;
104 OldCoreData
= (PEI_CORE_INSTANCE
*) Data
;
107 // Record the system tick for first entering PeiCore.
108 // This tick is duration of executing platform seccore module.
110 if (PerformanceMeasurementEnabled()) {
111 if (OldCoreData
== NULL
) {
112 Tick
= GetPerformanceCounter ();
116 if (OldCoreData
!= NULL
) {
117 ShadowedPeiCore
= (PEICORE_FUNCTION_POINTER
) (UINTN
) OldCoreData
->ShadowedPeiCore
;
120 // PeiCore has been shadowed to memory for first entering, so
121 // just jump to PeiCore in memory here.
123 if (ShadowedPeiCore
!= NULL
) {
124 OldCoreData
->ShadowedPeiCore
= NULL
;
132 CopyMem (&PrivateData
, OldCoreData
, sizeof (PEI_CORE_INSTANCE
));
134 CpuIo
= (VOID
*)PrivateData
.ServiceTableShadow
.CpuIo
;
135 PciCfg
= (VOID
*)PrivateData
.ServiceTableShadow
.PciCfg
;
137 CopyMem (&PrivateData
.ServiceTableShadow
, &gPs
, sizeof (gPs
));
139 PrivateData
.ServiceTableShadow
.CpuIo
= CpuIo
;
140 PrivateData
.ServiceTableShadow
.PciCfg
= PciCfg
;
143 // If OldCoreData is NULL, means current is first Peicore's entering.
146 ZeroMem (&PrivateData
, sizeof (PEI_CORE_INSTANCE
));
147 PrivateData
.Signature
= PEI_CORE_HANDLE_SIGNATURE
;
148 CopyMem (&PrivateData
.ServiceTableShadow
, &gPs
, sizeof (gPs
));
151 PrivateData
.PS
= &PrivateData
.ServiceTableShadow
;
154 // Initialize libraries that the PeiCore is linked against
156 ProcessLibraryConstructorList (NULL
, (CONST EFI_PEI_SERVICES
**)&PrivateData
.PS
);
158 InitializeMemoryServices (&PrivateData
, SecCoreData
, OldCoreData
);
160 InitializePpiServices (&PrivateData
, OldCoreData
);
163 // Save PeiServicePointer so that it can be retrieved anywhere.
165 SetPeiServicesTablePointer((CONST EFI_PEI_SERVICES
**) &PrivateData
.PS
);
167 if (OldCoreData
!= NULL
) {
169 PERF_END (NULL
,"PreMem", NULL
, 0);
170 PERF_START (NULL
,"PostMem", NULL
, 0);
173 // Alert any listeners that there is permanent memory available
176 PERF_START (NULL
,"DisMem", NULL
, 0);
177 Status
= PeiServicesInstallPpi (&mMemoryDiscoveredPpi
);
178 PERF_END (NULL
,"DisMem", NULL
, 0);
183 // Report Status Code EFI_SW_PC_INIT
187 FixedPcdGet32 (PcdStatusCodeValuePeiCoreEntry
)
190 PERF_START (NULL
, "SEC", NULL
, 1);
191 PERF_END (NULL
, "SEC", NULL
, Tick
);
193 PERF_START (NULL
,"PEI", NULL
, Tick
);
195 // If first pass, start performance measurement.
197 PERF_START (NULL
,"PreMem", NULL
, Tick
);
200 // If SEC provided any PPI services to PEI, install them.
202 if (PpiList
!= NULL
) {
203 Status
= PeiServicesInstallPpi (PpiList
);
204 ASSERT_EFI_ERROR (Status
);
208 InitializeSecurityServices (&PrivateData
.PS
, OldCoreData
);
210 InitializeDispatcherData (&PrivateData
, OldCoreData
, SecCoreData
);
213 // Install Pei Load File PPI.
215 InitializeImageServices (&PrivateData
, OldCoreData
);
218 // Call PEIM dispatcher
220 PeiDispatcher (SecCoreData
, &PrivateData
);
223 // Check if InstallPeiMemory service was called.
225 ASSERT(PrivateData
.PeiMemoryInstalled
== TRUE
);
228 // Till now, PEI phase will be finished, get performace count
229 // for computing duration of PEI phase
231 PERF_END (NULL
, "PostMem", NULL
, 0);
233 Status
= PeiServicesLocatePpi (
237 (VOID
**)&TempPtr
.DxeIpl
239 ASSERT_EFI_ERROR (Status
);
242 // Enter DxeIpl to load Dxe core.
244 DEBUG ((EFI_D_INFO
, "DXE IPL Entry\n"));
245 Status
= TempPtr
.DxeIpl
->Entry (
251 // Should never reach here.
253 ASSERT_EFI_ERROR (Status
);