]>
Commit | Line | Data |
---|---|---|
192f6d4c | 1 | /*++\r |
2 | \r | |
3 | Copyright (c) 2006, Intel Corporation\r | |
4 | All rights reserved. This program and the accompanying materials\r | |
5 | are licensed and made available under the terms and conditions of the BSD License\r | |
6 | which accompanies this distribution. The full text of the license may be found at\r | |
7 | http://opensource.org/licenses/bsd-license.php\r | |
8 | \r | |
9 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
10 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
11 | \r | |
12 | Module Name:\r | |
13 | \r | |
14 | Dispatcher.c\r | |
15 | \r | |
16 | Abstract:\r | |
17 | \r | |
18 | EFI PEI Core dispatch services\r | |
19 | \r | |
20 | Revision History\r | |
21 | \r | |
22 | --*/\r | |
23 | \r | |
192f6d4c | 24 | #include <PeiMain.h>\r |
25 | \r | |
b98c2ab7 | 26 | STATIC\r |
27 | VOID\r | |
28 | InvokePeiCore (\r | |
29 | VOID *Context1,\r | |
30 | VOID *Context2\r | |
31 | );\r | |
32 | \r | |
b0d803fe | 33 | \r |
34 | VOID\r | |
35 | DiscoverPeimsAndOrderWithApriori (\r | |
36 | IN PEI_CORE_INSTANCE *Private,\r | |
37 | IN EFI_PEI_FV_HANDLE VolumeHandle\r | |
38 | )\r | |
39 | /*++\r | |
40 | \r | |
41 | Routine Description:\r | |
42 | \r | |
43 | Discover all Peims and optional Apriori file in one FV. There is at most one\r | |
44 | Apriori file in one FV.\r | |
45 | \r | |
46 | Arguments:\r | |
47 | \r | |
48 | Private - Pointer to the private data passed in from caller\r | |
49 | VolumeHandle - Fv handle.\r | |
50 | Returns:\r | |
51 | \r | |
52 | NONE\r | |
53 | \r | |
54 | --*/ \r | |
55 | {\r | |
56 | EFI_STATUS Status;\r | |
57 | EFI_PEI_FV_HANDLE FileHandle;\r | |
177aabe6 | 58 | EFI_PEI_FILE_HANDLE AprioriFileHandle;\r |
b0d803fe | 59 | EFI_GUID *Apriori;\r |
60 | UINTN Index;\r | |
61 | UINTN Index2;\r | |
62 | UINTN PeimIndex;\r | |
63 | UINTN PeimCount;\r | |
64 | EFI_GUID *Guid;\r | |
177aabe6 | 65 | EFI_PEI_FV_HANDLE TempFileHandles[FixedPcdGet32 (PcdPeiCoreMaxPeimPerFv)];\r |
66 | EFI_GUID FileGuid[FixedPcdGet32 (PcdPeiCoreMaxPeimPerFv)];\r | |
b0d803fe | 67 | \r |
68 | //\r | |
69 | // Walk the FV and find all the PEIMs and the Apriori file.\r | |
70 | //\r | |
71 | AprioriFileHandle = NULL;\r | |
72 | Private->CurrentFvFileHandles[0] = NULL;\r | |
73 | Guid = NULL;\r | |
74 | FileHandle = NULL;\r | |
75 | \r | |
76 | //\r | |
77 | // If the current Fv has been scanned, directly get its cachable record.\r | |
78 | //\r | |
79 | if (Private->Fv[Private->CurrentPeimFvCount].ScanFv) {\r | |
80 | CopyMem (Private->CurrentFvFileHandles, Private->Fv[Private->CurrentPeimFvCount].FvFileHandles, sizeof (Private->CurrentFvFileHandles));\r | |
81 | return;\r | |
82 | }\r | |
83 | \r | |
84 | //\r | |
85 | // Go ahead to scan this Fv, and cache FileHandles within it.\r | |
86 | //\r | |
177aabe6 | 87 | for (PeimCount = 0; PeimCount < FixedPcdGet32 (PcdPeiCoreMaxPeimPerFv); PeimCount++) {\r |
b0d803fe | 88 | Status = PeiFindFileEx (\r |
89 | VolumeHandle, \r | |
90 | NULL, \r | |
91 | PEI_CORE_INTERNAL_FFS_FILE_DISPATCH_TYPE, \r | |
92 | &FileHandle,\r | |
93 | &AprioriFileHandle\r | |
94 | );\r | |
95 | if (Status != EFI_SUCCESS) {\r | |
96 | break;\r | |
97 | }\r | |
98 | \r | |
99 | Private->CurrentFvFileHandles[PeimCount] = FileHandle;\r | |
100 | }\r | |
101 | \r | |
102 | Private->AprioriCount = 0; \r | |
103 | if (AprioriFileHandle != NULL) {\r | |
104 | //\r | |
105 | // Read the Apriori file\r | |
106 | //\r | |
177aabe6 | 107 | Status = PeiServicesFfsFindSectionData (EFI_SECTION_RAW, AprioriFileHandle, (VOID **) &Apriori);\r |
b0d803fe | 108 | if (!EFI_ERROR (Status)) {\r |
109 | //\r | |
110 | // Calculate the number of PEIMs in the A Priori list\r | |
111 | //\r | |
112 | Private->AprioriCount = *(UINT32 *)(((EFI_FFS_FILE_HEADER *)AprioriFileHandle)->Size) & 0x00FFFFFF;\r | |
113 | Private->AprioriCount -= sizeof (EFI_FFS_FILE_HEADER) - sizeof (EFI_COMMON_SECTION_HEADER); \r | |
114 | Private->AprioriCount /= sizeof (EFI_GUID);\r | |
115 | \r | |
116 | SetMem (FileGuid, sizeof (FileGuid), 0);\r | |
117 | for (Index = 0; Index < PeimCount; Index++) {\r | |
118 | //\r | |
119 | // Make an array of file name guids that matches the FileHandle array so we can convert\r | |
120 | // quickly from file name to file handle\r | |
121 | //\r | |
122 | CopyMem (&FileGuid[Index], &((EFI_FFS_FILE_HEADER *)Private->CurrentFvFileHandles[Index])->Name,sizeof(EFI_GUID)); \r | |
123 | }\r | |
124 | \r | |
125 | //\r | |
126 | // Walk through FileGuid array to find out who is invalid PEIM guid in Apriori file.\r | |
127 | // Add avalible PEIMs in Apriori file into TempFileHandles array at first. \r | |
128 | //\r | |
129 | Index2 = 0;\r | |
130 | for (Index = 0; Index2 < Private->AprioriCount; Index++) {\r | |
131 | while (Index2 < Private->AprioriCount) {\r | |
132 | Guid = ScanGuid (FileGuid, PeimCount * sizeof (EFI_GUID), &Apriori[Index2++]);\r | |
133 | if (Guid != NULL) {\r | |
134 | break;\r | |
135 | }\r | |
136 | }\r | |
137 | if (Guid == NULL) {\r | |
138 | break; \r | |
139 | }\r | |
140 | PeimIndex = ((UINTN)Guid - (UINTN)&FileGuid[0])/sizeof (EFI_GUID);\r | |
141 | TempFileHandles[Index] = Private->CurrentFvFileHandles[PeimIndex];\r | |
142 | \r | |
143 | //\r | |
144 | // Since we have copied the file handle we can remove it from this list.\r | |
145 | //\r | |
146 | Private->CurrentFvFileHandles[PeimIndex] = NULL;\r | |
147 | }\r | |
148 | \r | |
149 | //\r | |
150 | // Update valid Aprioricount\r | |
151 | //\r | |
152 | Private->AprioriCount = Index;\r | |
153 | \r | |
154 | //\r | |
155 | // Add in any PEIMs not in the Apriori file\r | |
156 | //\r | |
157 | for (;Index < PeimCount; Index++) {\r | |
158 | for (Index2 = 0; Index2 < PeimCount; Index2++) {\r | |
159 | if (Private->CurrentFvFileHandles[Index2] != NULL) {\r | |
160 | TempFileHandles[Index] = Private->CurrentFvFileHandles[Index2];\r | |
161 | Private->CurrentFvFileHandles[Index2] = NULL;\r | |
162 | break;\r | |
163 | }\r | |
164 | }\r | |
165 | }\r | |
166 | //\r | |
167 | //Index the end of array contains re-range Pei moudle.\r | |
168 | //\r | |
169 | TempFileHandles[Index] = NULL;\r | |
170 | \r | |
171 | //\r | |
172 | // Private->CurrentFvFileHandles is currently in PEIM in the FV order.\r | |
173 | // We need to update it to start with files in the A Priori list and \r | |
174 | // then the remaining files in PEIM order. \r | |
175 | //\r | |
176 | CopyMem (Private->CurrentFvFileHandles, TempFileHandles, sizeof (Private->CurrentFvFileHandles));\r | |
177 | }\r | |
178 | }\r | |
179 | //\r | |
180 | // Cache the current Fv File Handle. So that we don't have to scan the Fv again.\r | |
181 | // Instead, we can retrieve the file handles within this Fv from cachable data.\r | |
182 | //\r | |
183 | Private->Fv[Private->CurrentPeimFvCount].ScanFv = TRUE;\r | |
184 | CopyMem (Private->Fv[Private->CurrentPeimFvCount].FvFileHandles, Private->CurrentFvFileHandles, sizeof (Private->CurrentFvFileHandles));\r | |
185 | \r | |
186 | }\r | |
187 | \r | |
188 | VOID\r | |
192f6d4c | 189 | PeiDispatcher (\r |
5aae0aa7 | 190 | IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,\r |
b0d803fe | 191 | IN PEI_CORE_INSTANCE *Private\r |
192f6d4c | 192 | )\r |
193 | \r | |
194 | /*++\r | |
195 | \r | |
196 | Routine Description:\r | |
197 | \r | |
198 | Conduct PEIM dispatch.\r | |
199 | \r | |
200 | Arguments:\r | |
201 | \r | |
5aae0aa7 | 202 | SecCoreData - Points to a data structure containing information about the PEI core's operating\r |
203 | environment, such as the size and location of temporary RAM, the stack location and\r | |
204 | the BFV location.\r | |
192f6d4c | 205 | PrivateData - Pointer to the private data passed in from caller\r |
206 | DispatchData - Pointer to PEI_CORE_DISPATCH_DATA data.\r | |
207 | \r | |
208 | Returns:\r | |
209 | \r | |
210 | EFI_SUCCESS - Successfully dispatched PEIM.\r | |
211 | EFI_NOT_FOUND - The dispatch failed.\r | |
212 | \r | |
213 | --*/\r | |
214 | {\r | |
b0d803fe | 215 | EFI_STATUS Status;\r |
216 | UINT32 Index1;\r | |
217 | UINT32 Index2;\r | |
218 | EFI_PEI_SERVICES **PeiServices;\r | |
219 | VOID *PrivateInMem;\r | |
220 | EFI_PEI_FV_HANDLE VolumeHandle; \r | |
221 | EFI_PEI_FILE_HANDLE PeiCoreFileHandle;\r | |
222 | EFI_PEI_FILE_HANDLE PeimFileHandle;\r | |
223 | UINTN FvCount;\r | |
224 | UINTN PeimCount;\r | |
225 | UINT32 AuthenticationState;\r | |
226 | EFI_PHYSICAL_ADDRESS EntryPoint;\r | |
227 | EFI_PEIM_ENTRY_POINT PeimEntryPoint;\r | |
228 | BOOLEAN PeimNeedingDispatch;\r | |
229 | BOOLEAN PeimDispatchOnThisPass;\r | |
230 | UINTN SaveCurrentPeimCount;\r | |
1053e0c5 | 231 | UINTN SaveCurrentFvCount;\r |
b0d803fe | 232 | EFI_PEI_FILE_HANDLE SaveCurrentFileHandle;\r |
233 | VOID *TopOfStack;\r | |
234 | PEI_CORE_PARAMETERS PeiCoreParameters;\r | |
235 | EFI_DEVICE_HANDLE_EXTENDED_DATA ExtendedData;\r | |
236 | \r | |
237 | \r | |
238 | PeiServices = &Private->PS;\r | |
239 | PeimEntryPoint = NULL;\r | |
240 | PeimFileHandle = NULL;\r | |
241 | \r | |
242 | if ((Private->PeiMemoryInstalled) && (Private->HobList.HandoffInformationTable->BootMode != BOOT_ON_S3_RESUME)) {\r | |
243 | //\r | |
244 | // Once real memory is available, shadow the RegisterForShadow modules. And meanwhile\r | |
245 | // update the modules' status from PEIM_STATE_REGISITER_FOR_SHADOW to PEIM_STATE_DONE.\r | |
246 | //\r | |
247 | SaveCurrentPeimCount = Private->CurrentPeimCount;\r | |
1053e0c5 | 248 | SaveCurrentFvCount = Private->CurrentPeimFvCount;\r |
b0d803fe | 249 | SaveCurrentFileHandle = Private->CurrentFileHandle;\r |
250 | \r | |
1053e0c5 | 251 | for (Index1 = 0; Index1 <= SaveCurrentFvCount; Index1++) {\r |
177aabe6 | 252 | for (Index2 = 0; (Index2 < FixedPcdGet32 (PcdPeiCoreMaxPeimPerFv)) && (Private->Fv[Index1].FvFileHandles[Index2] != NULL); Index2++) {\r |
b0d803fe | 253 | if (Private->Fv[Index1].PeimState[Index2] == PEIM_STATE_REGISITER_FOR_SHADOW) {\r |
254 | PeimFileHandle = Private->Fv[Index1].FvFileHandles[Index2]; \r | |
255 | Status = PeiLoadImage (\r | |
256 | &Private->PS, \r | |
257 | PeimFileHandle, \r | |
258 | &EntryPoint, \r | |
259 | &AuthenticationState\r | |
260 | );\r | |
261 | if (Status == EFI_SUCCESS) {\r | |
262 | //\r | |
263 | // PEIM_STATE_REGISITER_FOR_SHADOW move to PEIM_STATE_DONE\r | |
264 | //\r | |
265 | Private->Fv[Index1].PeimState[Index2]++;\r | |
1053e0c5 | 266 | Private->CurrentFileHandle = PeimFileHandle;\r |
267 | Private->CurrentPeimFvCount = Index1; \r | |
268 | Private->CurrentPeimCount = Index2; \r | |
b0d803fe | 269 | //\r |
270 | // Call the PEIM entry point\r | |
271 | //\r | |
272 | PeimEntryPoint = (EFI_PEIM_ENTRY_POINT)(UINTN)EntryPoint;\r | |
273 | \r | |
274 | PERF_START (0, "PEIM", NULL, 0);\r | |
275 | PeimEntryPoint(PeimFileHandle, &Private->PS);\r | |
276 | PERF_END (0, "PEIM", NULL, 0);\r | |
277 | } \r | |
278 | \r | |
279 | //\r | |
280 | // Process the Notify list and dispatch any notifies for\r | |
281 | // newly installed PPIs.\r | |
282 | //\r | |
283 | ProcessNotifyList (Private);\r | |
284 | }\r | |
285 | }\r | |
286 | }\r | |
1053e0c5 | 287 | Private->CurrentFileHandle = SaveCurrentFileHandle; \r |
288 | Private->CurrentPeimFvCount = SaveCurrentFvCount; \r | |
289 | Private->CurrentPeimCount = SaveCurrentPeimCount; \r | |
b0d803fe | 290 | }\r |
192f6d4c | 291 | \r |
292 | //\r | |
293 | // This is the main dispatch loop. It will search known FVs for PEIMs and\r | |
294 | // attempt to dispatch them. If any PEIM gets dispatched through a single\r | |
295 | // pass of the dispatcher, it will start over from the Bfv again to see\r | |
296 | // if any new PEIMs dependencies got satisfied. With a well ordered\r | |
297 | // FV where PEIMs are found in the order their dependencies are also\r | |
298 | // satisfied, this dipatcher should run only once.\r | |
299 | //\r | |
b0d803fe | 300 | do {\r |
301 | PeimNeedingDispatch = FALSE;\r | |
302 | PeimDispatchOnThisPass = FALSE;\r | |
303 | \r | |
304 | for (FvCount = Private->CurrentPeimFvCount; FvCount < Private->FvCount; FvCount++) {\r | |
305 | Private->CurrentPeimFvCount = FvCount;\r | |
306 | VolumeHandle = Private->Fv[FvCount].FvHeader;\r | |
192f6d4c | 307 | \r |
b0d803fe | 308 | if (Private->CurrentPeimCount == 0) {\r |
309 | //\r | |
310 | // When going through each FV, at first, search Apriori file to\r | |
311 | // reorder all PEIMs to ensure the PEIMs in Apriori file to get \r | |
312 | // dispatch at first.\r | |
313 | //\r | |
314 | DiscoverPeimsAndOrderWithApriori (Private, VolumeHandle);\r | |
315 | }\r | |
192f6d4c | 316 | \r |
317 | //\r | |
b0d803fe | 318 | // Start to dispatch all modules within the current Fv.\r |
192f6d4c | 319 | //\r |
b0d803fe | 320 | for (PeimCount = Private->CurrentPeimCount; \r |
177aabe6 | 321 | (PeimCount < FixedPcdGet32 (PcdPeiCoreMaxPeimPerFv)) && (Private->CurrentFvFileHandles[PeimCount] != NULL); \r |
b0d803fe | 322 | PeimCount++) {\r |
323 | Private->CurrentPeimCount = PeimCount;\r | |
324 | PeimFileHandle = Private->CurrentFileHandle = Private->CurrentFvFileHandles[PeimCount];\r | |
325 | \r | |
326 | if (Private->Fv[FvCount].PeimState[PeimCount] == PEIM_STATE_NOT_DISPATCHED) {\r | |
327 | if (!DepexSatisfied (Private, PeimFileHandle, PeimCount)) {\r | |
328 | PeimNeedingDispatch = TRUE;\r | |
329 | } else {\r | |
192f6d4c | 330 | Status = PeiLoadImage (\r |
b0d803fe | 331 | PeiServices, \r |
332 | PeimFileHandle, \r | |
333 | &EntryPoint, \r | |
334 | &AuthenticationState\r | |
192f6d4c | 335 | );\r |
b0d803fe | 336 | if ((Status == EFI_SUCCESS)) {\r |
192f6d4c | 337 | //\r |
338 | // The PEIM has its dependencies satisfied, and its entry point\r | |
339 | // has been found, so invoke it.\r | |
340 | //\r | |
b0d803fe | 341 | PERF_START (0, "PEIM", NULL, 0);\r |
192f6d4c | 342 | \r |
b0d803fe | 343 | ExtendedData.Handle = (EFI_HANDLE)PeimFileHandle;\r |
192f6d4c | 344 | \r |
345 | REPORT_STATUS_CODE_WITH_EXTENDED_DATA (\r | |
346 | EFI_PROGRESS_CODE,\r | |
347 | EFI_SOFTWARE_PEI_CORE | EFI_SW_PC_INIT_BEGIN,\r | |
348 | (VOID *)(&ExtendedData),\r | |
349 | sizeof (ExtendedData)\r | |
350 | );\r | |
351 | \r | |
b0d803fe | 352 | Status = VerifyPeim (Private, VolumeHandle, PeimFileHandle);\r |
353 | if (Status != EFI_SECURITY_VIOLATION && (AuthenticationState == 0)) {\r | |
354 | //\r | |
355 | // PEIM_STATE_NOT_DISPATCHED move to PEIM_STATE_DISPATCHED\r | |
356 | //\r | |
357 | Private->Fv[FvCount].PeimState[PeimCount]++;\r | |
192f6d4c | 358 | \r |
359 | //\r | |
b0d803fe | 360 | // Call the PEIM entry point\r |
192f6d4c | 361 | //\r |
b0d803fe | 362 | PeimEntryPoint = (EFI_PEIM_ENTRY_POINT)(UINTN)EntryPoint;\r |
363 | PeimEntryPoint (PeimFileHandle, PeiServices);\r | |
364 | PeimDispatchOnThisPass = TRUE;\r | |
192f6d4c | 365 | }\r |
366 | \r | |
367 | REPORT_STATUS_CODE_WITH_EXTENDED_DATA (\r | |
368 | EFI_PROGRESS_CODE,\r | |
369 | EFI_SOFTWARE_PEI_CORE | EFI_SW_PC_INIT_END,\r | |
370 | (VOID *)(&ExtendedData),\r | |
371 | sizeof (ExtendedData)\r | |
372 | );\r | |
b0d803fe | 373 | PERF_END (0, "PEIM", NULL, 0);\r |
374 | \r | |
375 | }\r | |
192f6d4c | 376 | \r |
b0d803fe | 377 | //\r |
378 | // Process the Notify list and dispatch any notifies for\r | |
379 | // newly installed PPIs.\r | |
380 | //\r | |
381 | ProcessNotifyList (Private);\r | |
382 | \r | |
383 | //\r | |
384 | // If permanent memory was discovered and installed by this\r | |
385 | // PEIM, shadow PEI Core and switch the stacks to the new memory. \r | |
386 | //\r | |
387 | if (Private->SwitchStackSignal) {\r | |
192f6d4c | 388 | \r |
389 | //\r | |
b0d803fe | 390 | // Make sure we don't retry the same PEIM that added memory\r |
192f6d4c | 391 | //\r |
b0d803fe | 392 | Private->CurrentPeimCount++;\r |
192f6d4c | 393 | \r |
394 | //\r | |
b0d803fe | 395 | // Migrate IDT from CAR into real memory, so after stack switches to\r |
396 | // the new memory, the caller can get memory version PeiServiceTable. \r | |
192f6d4c | 397 | //\r |
81c7803c | 398 | MigrateIdtTable (PeiServices);\r |
399 | \r | |
b0d803fe | 400 | //\r |
401 | // Since we are at dispatch level, only the Core's private data \r | |
402 | // is preserved, nobody else should have any data on the stack. \r | |
403 | // So we need to copy PEI core instance data to memory.\r | |
404 | //\r | |
405 | PrivateInMem = AllocateCopyPool (sizeof (PEI_CORE_INSTANCE), Private);\r | |
406 | ASSERT (PrivateInMem != NULL);\r | |
192f6d4c | 407 | \r |
408 | //\r | |
b0d803fe | 409 | // Shadow PEI Core. When permanent memory is avaiable, shadow\r |
410 | // PEI Core and PEIMs to get high performance.\r | |
192f6d4c | 411 | //\r |
b0d803fe | 412 | PeiCoreFileHandle = NULL;\r |
413 | //\r | |
414 | // Find the PEI Core in the BFV\r | |
415 | //\r | |
416 | Status = PeiFindFileEx (\r | |
417 | (EFI_PEI_FV_HANDLE)Private->Fv[0].FvHeader, \r | |
418 | NULL, \r | |
419 | EFI_FV_FILETYPE_PEI_CORE, \r | |
420 | &PeiCoreFileHandle,\r | |
421 | NULL\r | |
422 | );\r | |
423 | ASSERT_EFI_ERROR (Status);\r | |
424 | \r | |
425 | //\r | |
426 | // Shadow PEI Core into memory so it will run faster\r | |
427 | //\r | |
428 | Status = PeiLoadImage (PeiServices, PeiCoreFileHandle, &EntryPoint, &AuthenticationState);\r | |
429 | ASSERT_EFI_ERROR (Status);\r | |
430 | \r | |
431 | //\r | |
432 | // Switch to memory based stack and reenter PEI Core that has been\r | |
433 | // shadowed to memory.\r | |
434 | //\r | |
435 | //\r | |
436 | // Adjust the top of stack to be aligned at CPU_STACK_ALIGNMENT\r | |
437 | //\r | |
438 | TopOfStack = (VOID *)((UINTN)Private->StackBase + (UINTN)Private->StackSize - CPU_STACK_ALIGNMENT);\r | |
439 | TopOfStack = ALIGN_POINTER (TopOfStack, CPU_STACK_ALIGNMENT);\r | |
440 | \r | |
441 | PeiCoreParameters.SecCoreData = SecCoreData;\r | |
442 | PeiCoreParameters.PpiList = NULL;\r | |
443 | PeiCoreParameters.Data = PrivateInMem;\r | |
444 | ASSERT (PeiCoreParameters.Data != 0);\r | |
445 | \r | |
446 | PeiSwitchStacks (\r | |
447 | InvokePeiCore,\r | |
448 | (VOID*) (UINTN) PeiCore,\r | |
449 | (VOID*) &PeiCoreParameters, \r | |
450 | TopOfStack,\r | |
451 | (VOID*)(UINTN)Private->StackBase\r | |
452 | );\r | |
192f6d4c | 453 | }\r |
192f6d4c | 454 | \r |
b0d803fe | 455 | if ((Private->PeiMemoryInstalled) && (Private->Fv[FvCount].PeimState[PeimCount] == PEIM_STATE_REGISITER_FOR_SHADOW) && \\r |
456 | (Private->HobList.HandoffInformationTable->BootMode != BOOT_ON_S3_RESUME)) {\r | |
457 | //\r | |
458 | // If memory is availble we shadow images by default for performance reasons. \r | |
459 | // We call the entry point a 2nd time so the module knows it's shadowed. \r | |
460 | //\r | |
461 | //PERF_START (PeiServices, L"PEIM", PeimFileHandle, 0);\r | |
462 | PeimEntryPoint (PeimFileHandle, PeiServices);\r | |
463 | //PERF_END (PeiServices, L"PEIM", PeimFileHandle, 0);\r | |
464 | \r | |
465 | //\r | |
466 | // PEIM_STATE_REGISITER_FOR_SHADOW move to PEIM_STATE_DONE\r | |
467 | //\r | |
468 | Private->Fv[FvCount].PeimState[PeimCount]++;\r | |
192f6d4c | 469 | \r |
192f6d4c | 470 | //\r |
b0d803fe | 471 | // Process the Notify list and dispatch any notifies for\r |
472 | // newly installed PPIs.\r | |
192f6d4c | 473 | //\r |
b0d803fe | 474 | ProcessNotifyList (Private);\r |
192f6d4c | 475 | }\r |
476 | }\r | |
477 | }\r | |
192f6d4c | 478 | }\r |
192f6d4c | 479 | \r |
b0d803fe | 480 | //\r |
481 | // We set to NULL here to optimize the 2nd entry to this routine after\r | |
482 | // memory is found. This reprevents rescanning of the FV. We set to\r | |
483 | // NULL here so we start at the begining of the next FV\r | |
484 | //\r | |
485 | Private->CurrentFileHandle = NULL;\r | |
486 | Private->CurrentPeimCount = 0;\r | |
487 | //\r | |
488 | // Before walking through the next FV,Private->CurrentFvFileHandles[]should set to NULL\r | |
489 | //\r | |
490 | SetMem (Private->CurrentFvFileHandles, sizeof (Private->CurrentFvFileHandles), 0);\r | |
192f6d4c | 491 | }\r |
492 | \r | |
493 | //\r | |
b0d803fe | 494 | // Before making another pass, we should set Private->CurrentPeimFvCount =0 to go \r |
495 | // through all the FV.\r | |
192f6d4c | 496 | //\r |
b0d803fe | 497 | Private->CurrentPeimFvCount = 0;\r |
192f6d4c | 498 | \r |
499 | //\r | |
b0d803fe | 500 | // PeimNeedingDispatch being TRUE means we found a PEIM that did not get \r |
501 | // dispatched. So we need to make another pass\r | |
192f6d4c | 502 | //\r |
b0d803fe | 503 | // PeimDispatchOnThisPass being TRUE means we dispatched a PEIM on this \r |
504 | // pass. If we did not dispatch a PEIM there is no point in trying again\r | |
505 | // as it will fail the next time too (nothing has changed).\r | |
192f6d4c | 506 | //\r |
b0d803fe | 507 | } while (PeimNeedingDispatch && PeimDispatchOnThisPass);\r |
192f6d4c | 508 | \r |
192f6d4c | 509 | }\r |
510 | \r | |
511 | VOID\r | |
512 | InitializeDispatcherData (\r | |
b0d803fe | 513 | IN PEI_CORE_INSTANCE *PrivateData,\r |
192f6d4c | 514 | IN PEI_CORE_INSTANCE *OldCoreData,\r |
5aae0aa7 | 515 | IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData\r |
192f6d4c | 516 | )\r |
517 | /*++\r | |
518 | \r | |
519 | Routine Description:\r | |
520 | \r | |
521 | Initialize the Dispatcher's data members\r | |
522 | \r | |
523 | Arguments:\r | |
524 | \r | |
525 | PeiServices - The PEI core services table.\r | |
526 | OldCoreData - Pointer to old core data (before switching stack).\r | |
527 | NULL if being run in non-permament memory mode.\r | |
5aae0aa7 | 528 | SecCoreData - Points to a data structure containing information about the PEI core's operating\r |
529 | environment, such as the size and location of temporary RAM, the stack location and\r | |
530 | the BFV location.\r | |
192f6d4c | 531 | \r |
532 | Returns:\r | |
533 | \r | |
534 | None.\r | |
535 | \r | |
536 | --*/\r | |
537 | {\r | |
192f6d4c | 538 | if (OldCoreData == NULL) {\r |
b0d803fe | 539 | PeiInitializeFv (PrivateData, SecCoreData);\r |
192f6d4c | 540 | }\r |
541 | \r | |
542 | return;\r | |
543 | }\r | |
544 | \r | |
545 | \r | |
192f6d4c | 546 | BOOLEAN\r |
547 | DepexSatisfied (\r | |
b0d803fe | 548 | IN PEI_CORE_INSTANCE *Private,\r |
549 | IN EFI_PEI_FILE_HANDLE FileHandle,\r | |
550 | IN UINTN PeimCount\r | |
192f6d4c | 551 | )\r |
552 | /*++\r | |
553 | \r | |
554 | Routine Description:\r | |
555 | \r | |
556 | This routine parses the Dependency Expression, if available, and\r | |
557 | decides if the module can be executed.\r | |
558 | \r | |
559 | Arguments:\r | |
560 | PeiServices - The PEI Service Table\r | |
561 | CurrentPeimAddress - Address of the PEIM Firmware File under investigation\r | |
562 | \r | |
563 | Returns:\r | |
564 | TRUE - Can be dispatched\r | |
565 | FALSE - Cannot be dispatched\r | |
566 | \r | |
567 | --*/\r | |
568 | {\r | |
569 | EFI_STATUS Status;\r | |
b0d803fe | 570 | VOID *DepexData;\r |
571 | \r | |
572 | if (PeimCount < Private->AprioriCount) {\r | |
573 | //\r | |
574 | // If its in the A priori file then we set Depex to TRUE\r | |
575 | //\r | |
576 | return TRUE;\r | |
577 | }\r | |
578 | \r | |
579 | Status = PeiServicesFfsFindSectionData (EFI_SECTION_PEI_DEPEX, FileHandle, (VOID **) &DepexData);\r | |
192f6d4c | 580 | if (EFI_ERROR (Status)) {\r |
b0d803fe | 581 | //\r |
582 | // If there is no DEPEX, assume the module can be executed\r | |
583 | //\r | |
192f6d4c | 584 | return TRUE;\r |
585 | }\r | |
586 | \r | |
587 | //\r | |
588 | // Evaluate a given DEPEX\r | |
589 | //\r | |
b0d803fe | 590 | return PeimDispatchReadiness (&Private->PS, DepexData);\r |
192f6d4c | 591 | }\r |
592 | \r | |
14e8823a | 593 | /**\r |
594 | This routine enable a PEIM to register itself to shadow when PEI Foundation\r | |
595 | discovery permanent memory.\r | |
596 | \r | |
597 | @param FileHandle File handle of a PEIM.\r | |
598 | \r | |
599 | @retval EFI_NOT_FOUND The file handle doesn't point to PEIM itself.\r | |
600 | @retval EFI_ALREADY_STARTED Indicate that the PEIM has been registered itself.\r | |
601 | @retval EFI_SUCCESS Successfully to register itself.\r | |
602 | \r | |
603 | **/ \r | |
604 | EFI_STATUS\r | |
605 | EFIAPI\r | |
606 | PeiRegisterForShadow (\r | |
607 | IN EFI_PEI_FILE_HANDLE FileHandle\r | |
608 | )\r | |
609 | {\r | |
610 | PEI_CORE_INSTANCE *Private;\r | |
611 | Private = PEI_CORE_INSTANCE_FROM_PS_THIS (GetPeiServicesTablePointer ());\r | |
612 | \r | |
613 | if (Private->CurrentFileHandle != FileHandle) {\r | |
614 | //\r | |
615 | // The FileHandle must be for the current PEIM\r | |
616 | //\r | |
617 | return EFI_NOT_FOUND;\r | |
618 | }\r | |
619 | \r | |
620 | if (Private->Fv[Private->CurrentPeimFvCount].PeimState[Private->CurrentPeimCount] >= PEIM_STATE_REGISITER_FOR_SHADOW) {\r | |
621 | //\r | |
622 | // If the PEIM has already entered the PEIM_STATE_REGISTER_FOR_SHADOW or PEIM_STATE_DONE then it's already been started\r | |
623 | //\r | |
624 | return EFI_ALREADY_STARTED;\r | |
625 | }\r | |
626 | \r | |
627 | Private->Fv[Private->CurrentPeimFvCount].PeimState[Private->CurrentPeimCount] = PEIM_STATE_REGISITER_FOR_SHADOW;\r | |
628 | \r | |
629 | return EFI_SUCCESS;\r | |
630 | }\r | |
631 | \r | |
b0d803fe | 632 | \r |
b98c2ab7 | 633 | /**\r |
634 | This routine invoke the PeiCore's entry in new stack environment.\r | |
635 | \r | |
636 | @param Context1 The first context parameter is entry of PeiCore\r | |
637 | @param Context2 The second context parameter is parameter structure point for PeiCore\r | |
638 | \r | |
639 | **/ \r | |
640 | STATIC\r | |
641 | VOID\r | |
642 | InvokePeiCore (\r | |
643 | VOID *Context1,\r | |
644 | VOID *Context2\r | |
645 | )\r | |
646 | {\r | |
647 | PEI_CORE_ENTRY_POINT PeiCoreEntryPoint;\r | |
648 | PEI_CORE_PARAMETERS *PeiCoreParameters;\r | |
649 | \r | |
650 | //\r | |
651 | // Running on new stack in SEC Core\r | |
652 | //\r | |
653 | \r | |
654 | PeiCoreEntryPoint = (PEI_CORE_ENTRY_POINT) (UINTN) Context1;\r | |
655 | PeiCoreParameters = (PEI_CORE_PARAMETERS *)Context2;\r | |
656 | \r | |
657 | //\r | |
658 | // Call PEI Core using new stack\r | |
659 | //\r | |
660 | PeiCoreEntryPoint (\r | |
661 | PeiCoreParameters->SecCoreData,\r | |
662 | PeiCoreParameters->PpiList,\r | |
663 | PeiCoreParameters->Data\r | |
664 | );\r | |
665 | \r | |
666 | //\r | |
667 | // Never returns\r | |
668 | //\r | |
669 | ASSERT_EFI_ERROR (FALSE);\r | |
670 | }\r |