2 CPU MP Initialize Library common functions.
4 Copyright (c) 2016 - 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_GUID mCpuInitMpLibHobGuid
= CPU_INIT_MP_LIB_HOB_GUID
;
20 The function will check if BSP Execute Disable is enabled.
22 DxeIpl may have enabled Execute Disable for BSP, APs need to
23 get the status and sync up the settings.
24 If BSP's CR0.Paging is not set, BSP execute Disble feature is
27 @retval TRUE BSP Execute Disable is enabled.
28 @retval FALSE BSP Execute Disable is not enabled.
31 IsBspExecuteDisableEnabled (
36 CPUID_EXTENDED_CPU_SIG_EDX Edx
;
37 MSR_IA32_EFER_REGISTER EferMsr
;
42 Cr0
.UintN
= AsmReadCr0 ();
43 if (Cr0
.Bits
.PG
!= 0) {
45 // If CR0 Paging bit is set
47 AsmCpuid (CPUID_EXTENDED_FUNCTION
, &Eax
, NULL
, NULL
, NULL
);
48 if (Eax
>= CPUID_EXTENDED_CPU_SIG
) {
49 AsmCpuid (CPUID_EXTENDED_CPU_SIG
, NULL
, NULL
, NULL
, &Edx
.Uint32
);
52 // Bit 20: Execute Disable Bit available.
54 if (Edx
.Bits
.NX
!= 0) {
55 EferMsr
.Uint64
= AsmReadMsr64 (MSR_IA32_EFER
);
58 // Bit 11: Execute Disable Bit enable.
60 if (EferMsr
.Bits
.NXE
!= 0) {
71 Worker function for SwitchBSP().
73 Worker function for SwitchBSP(), assigned to the AP which is intended
76 @param[in] Buffer Pointer to CPU MP Data
84 CPU_MP_DATA
*DataInHob
;
86 DataInHob
= (CPU_MP_DATA
*) Buffer
;
87 AsmExchangeRole (&DataInHob
->APInfo
, &DataInHob
->BSPInfo
);
91 Get the Application Processors state.
93 @param[in] CpuData The pointer to CPU_AP_DATA of specified AP
99 IN CPU_AP_DATA
*CpuData
102 return CpuData
->State
;
106 Set the Application Processors state.
108 @param[in] CpuData The pointer to CPU_AP_DATA of specified AP
109 @param[in] State The AP status
113 IN CPU_AP_DATA
*CpuData
,
117 AcquireSpinLock (&CpuData
->ApLock
);
118 CpuData
->State
= State
;
119 ReleaseSpinLock (&CpuData
->ApLock
);
123 Save BSP's local APIC timer setting.
125 @param[in] CpuMpData Pointer to CPU MP Data
128 SaveLocalApicTimerSetting (
129 IN CPU_MP_DATA
*CpuMpData
133 // Record the current local APIC timer setting of BSP
136 &CpuMpData
->DivideValue
,
137 &CpuMpData
->PeriodicMode
,
140 CpuMpData
->CurrentTimerCount
= GetApicTimerCurrentCount ();
141 CpuMpData
->TimerInterruptState
= GetApicTimerInterruptState ();
145 Sync local APIC timer setting from BSP to AP.
147 @param[in] CpuMpData Pointer to CPU MP Data
150 SyncLocalApicTimerSetting (
151 IN CPU_MP_DATA
*CpuMpData
155 // Sync local APIC timer setting from BSP to AP
157 InitializeApicTimer (
158 CpuMpData
->DivideValue
,
159 CpuMpData
->CurrentTimerCount
,
160 CpuMpData
->PeriodicMode
,
164 // Disable AP's local APIC timer interrupt
166 DisableApicTimerInterrupt ();
170 Save the volatile registers required to be restored following INIT IPI.
172 @param[out] VolatileRegisters Returns buffer saved the volatile resisters
175 SaveVolatileRegisters (
176 OUT CPU_VOLATILE_REGISTERS
*VolatileRegisters
179 CPUID_VERSION_INFO_EDX VersionInfoEdx
;
181 VolatileRegisters
->Cr0
= AsmReadCr0 ();
182 VolatileRegisters
->Cr3
= AsmReadCr3 ();
183 VolatileRegisters
->Cr4
= AsmReadCr4 ();
185 AsmCpuid (CPUID_VERSION_INFO
, NULL
, NULL
, NULL
, &VersionInfoEdx
.Uint32
);
186 if (VersionInfoEdx
.Bits
.DE
!= 0) {
188 // If processor supports Debugging Extensions feature
189 // by CPUID.[EAX=01H]:EDX.BIT2
191 VolatileRegisters
->Dr0
= AsmReadDr0 ();
192 VolatileRegisters
->Dr1
= AsmReadDr1 ();
193 VolatileRegisters
->Dr2
= AsmReadDr2 ();
194 VolatileRegisters
->Dr3
= AsmReadDr3 ();
195 VolatileRegisters
->Dr6
= AsmReadDr6 ();
196 VolatileRegisters
->Dr7
= AsmReadDr7 ();
199 AsmReadGdtr (&VolatileRegisters
->Gdtr
);
200 AsmReadIdtr (&VolatileRegisters
->Idtr
);
201 VolatileRegisters
->Tr
= AsmReadTr ();
205 Restore the volatile registers following INIT IPI.
207 @param[in] VolatileRegisters Pointer to volatile resisters
208 @param[in] IsRestoreDr TRUE: Restore DRx if supported
209 FALSE: Do not restore DRx
212 RestoreVolatileRegisters (
213 IN CPU_VOLATILE_REGISTERS
*VolatileRegisters
,
214 IN BOOLEAN IsRestoreDr
217 CPUID_VERSION_INFO_EDX VersionInfoEdx
;
218 IA32_TSS_DESCRIPTOR
*Tss
;
220 AsmWriteCr0 (VolatileRegisters
->Cr0
);
221 AsmWriteCr3 (VolatileRegisters
->Cr3
);
222 AsmWriteCr4 (VolatileRegisters
->Cr4
);
225 AsmCpuid (CPUID_VERSION_INFO
, NULL
, NULL
, NULL
, &VersionInfoEdx
.Uint32
);
226 if (VersionInfoEdx
.Bits
.DE
!= 0) {
228 // If processor supports Debugging Extensions feature
229 // by CPUID.[EAX=01H]:EDX.BIT2
231 AsmWriteDr0 (VolatileRegisters
->Dr0
);
232 AsmWriteDr1 (VolatileRegisters
->Dr1
);
233 AsmWriteDr2 (VolatileRegisters
->Dr2
);
234 AsmWriteDr3 (VolatileRegisters
->Dr3
);
235 AsmWriteDr6 (VolatileRegisters
->Dr6
);
236 AsmWriteDr7 (VolatileRegisters
->Dr7
);
240 AsmWriteGdtr (&VolatileRegisters
->Gdtr
);
241 AsmWriteIdtr (&VolatileRegisters
->Idtr
);
242 if (VolatileRegisters
->Tr
!= 0 &&
243 VolatileRegisters
->Tr
< VolatileRegisters
->Gdtr
.Limit
) {
244 Tss
= (IA32_TSS_DESCRIPTOR
*)(VolatileRegisters
->Gdtr
.Base
+
245 VolatileRegisters
->Tr
);
246 if (Tss
->Bits
.P
== 1) {
247 Tss
->Bits
.Type
&= 0xD; // 1101 - Clear busy bit just in case
248 AsmWriteTr (VolatileRegisters
->Tr
);
254 Detect whether Mwait-monitor feature is supported.
256 @retval TRUE Mwait-monitor feature is supported.
257 @retval FALSE Mwait-monitor feature is not supported.
264 CPUID_VERSION_INFO_ECX VersionInfoEcx
;
266 AsmCpuid (CPUID_VERSION_INFO
, NULL
, NULL
, &VersionInfoEcx
.Uint32
, NULL
);
267 return (VersionInfoEcx
.Bits
.MONITOR
== 1) ? TRUE
: FALSE
;
273 @param[out] MonitorFilterSize Returns the largest monitor-line size in bytes.
275 @return The AP loop mode.
279 OUT UINT32
*MonitorFilterSize
283 CPUID_MONITOR_MWAIT_EBX MonitorMwaitEbx
;
285 ASSERT (MonitorFilterSize
!= NULL
);
287 ApLoopMode
= PcdGet8 (PcdCpuApLoopMode
);
288 ASSERT (ApLoopMode
>= ApInHltLoop
&& ApLoopMode
<= ApInRunLoop
);
289 if (ApLoopMode
== ApInMwaitLoop
) {
290 if (!IsMwaitSupport ()) {
292 // If processor does not support MONITOR/MWAIT feature,
293 // force AP in Hlt-loop mode
295 ApLoopMode
= ApInHltLoop
;
299 if (ApLoopMode
!= ApInMwaitLoop
) {
300 *MonitorFilterSize
= sizeof (UINT32
);
303 // CPUID.[EAX=05H]:EBX.BIT0-15: Largest monitor-line size in bytes
304 // CPUID.[EAX=05H].EDX: C-states supported using MWAIT
306 AsmCpuid (CPUID_MONITOR_MWAIT
, NULL
, &MonitorMwaitEbx
.Uint32
, NULL
, NULL
);
307 *MonitorFilterSize
= MonitorMwaitEbx
.Bits
.LargestMonitorLineSize
;
314 Sort the APIC ID of all processors.
316 This function sorts the APIC ID of all processors so that processor number is
317 assigned in the ascending order of APIC ID which eases MP debugging.
319 @param[in] CpuMpData Pointer to PEI CPU MP Data
323 IN CPU_MP_DATA
*CpuMpData
330 CPU_INFO_IN_HOB CpuInfo
;
332 CPU_INFO_IN_HOB
*CpuInfoInHob
;
334 ApCount
= CpuMpData
->CpuCount
- 1;
335 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
337 for (Index1
= 0; Index1
< ApCount
; Index1
++) {
340 // Sort key is the hardware default APIC ID
342 ApicId
= CpuInfoInHob
[Index1
].ApicId
;
343 for (Index2
= Index1
+ 1; Index2
<= ApCount
; Index2
++) {
344 if (ApicId
> CpuInfoInHob
[Index2
].ApicId
) {
346 ApicId
= CpuInfoInHob
[Index2
].ApicId
;
349 if (Index3
!= Index1
) {
350 CopyMem (&CpuInfo
, &CpuInfoInHob
[Index3
], sizeof (CPU_INFO_IN_HOB
));
352 &CpuInfoInHob
[Index3
],
353 &CpuInfoInHob
[Index1
],
354 sizeof (CPU_INFO_IN_HOB
)
356 CopyMem (&CpuInfoInHob
[Index1
], &CpuInfo
, sizeof (CPU_INFO_IN_HOB
));
361 // Get the processor number for the BSP
363 ApicId
= GetInitialApicId ();
364 for (Index1
= 0; Index1
< CpuMpData
->CpuCount
; Index1
++) {
365 if (CpuInfoInHob
[Index1
].ApicId
== ApicId
) {
366 CpuMpData
->BspNumber
= (UINT32
) Index1
;
374 Enable x2APIC mode on APs.
376 @param[in, out] Buffer Pointer to private data buffer.
384 SetApicMode (LOCAL_APIC_MODE_X2APIC
);
390 @param[in, out] Buffer Pointer to private data buffer.
398 CPU_MP_DATA
*CpuMpData
;
400 CpuMpData
= (CPU_MP_DATA
*) Buffer
;
402 // Load microcode on AP
404 MicrocodeDetect (CpuMpData
);
406 // Sync BSP's MTRR table to AP
408 MtrrSetAllMtrrs (&CpuMpData
->MtrrTable
);
412 Find the current Processor number by APIC ID.
414 @param[in] CpuMpData Pointer to PEI CPU MP Data
415 @param[out] ProcessorNumber Return the pocessor number found
417 @retval EFI_SUCCESS ProcessorNumber is found and returned.
418 @retval EFI_NOT_FOUND ProcessorNumber is not found.
422 IN CPU_MP_DATA
*CpuMpData
,
423 OUT UINTN
*ProcessorNumber
426 UINTN TotalProcessorNumber
;
428 CPU_INFO_IN_HOB
*CpuInfoInHob
;
430 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
432 TotalProcessorNumber
= CpuMpData
->CpuCount
;
433 for (Index
= 0; Index
< TotalProcessorNumber
; Index
++) {
434 if (CpuInfoInHob
[Index
].ApicId
== GetApicId ()) {
435 *ProcessorNumber
= Index
;
439 return EFI_NOT_FOUND
;
443 This function will get CPU count in the system.
445 @param[in] CpuMpData Pointer to PEI CPU MP Data
447 @return CPU count detected
450 CollectProcessorCount (
451 IN CPU_MP_DATA
*CpuMpData
457 // Send 1st broadcast IPI to APs to wakeup APs
459 CpuMpData
->InitFlag
= ApInitConfig
;
460 CpuMpData
->X2ApicEnable
= FALSE
;
461 WakeUpAP (CpuMpData
, TRUE
, 0, NULL
, NULL
);
462 CpuMpData
->InitFlag
= ApInitDone
;
463 ASSERT (CpuMpData
->CpuCount
<= PcdGet32 (PcdCpuMaxLogicalProcessorNumber
));
465 // Wait for all APs finished the initialization
467 while (CpuMpData
->FinishedCount
< (CpuMpData
->CpuCount
- 1)) {
471 if (CpuMpData
->CpuCount
> 255) {
473 // If there are more than 255 processor found, force to enable X2APIC
475 CpuMpData
->X2ApicEnable
= TRUE
;
477 if (CpuMpData
->X2ApicEnable
) {
478 DEBUG ((DEBUG_INFO
, "Force x2APIC mode!\n"));
480 // Wakeup all APs to enable x2APIC mode
482 WakeUpAP (CpuMpData
, TRUE
, 0, ApFuncEnableX2Apic
, NULL
);
484 // Wait for all known APs finished
486 while (CpuMpData
->FinishedCount
< (CpuMpData
->CpuCount
- 1)) {
490 // Enable x2APIC on BSP
492 SetApicMode (LOCAL_APIC_MODE_X2APIC
);
494 // Set BSP/Aps state to IDLE
496 for (Index
= 0; Index
< CpuMpData
->CpuCount
; Index
++) {
497 SetApState (&CpuMpData
->CpuData
[Index
], CpuStateIdle
);
500 DEBUG ((DEBUG_INFO
, "APIC MODE is %d\n", GetApicMode ()));
502 // Sort BSP/Aps by CPU APIC ID in ascending order
504 SortApicId (CpuMpData
);
506 DEBUG ((DEBUG_INFO
, "MpInitLib: Find %d processors in system.\n", CpuMpData
->CpuCount
));
508 return CpuMpData
->CpuCount
;
512 Initialize CPU AP Data when AP is wakeup at the first time.
514 @param[in, out] CpuMpData Pointer to PEI CPU MP Data
515 @param[in] ProcessorNumber The handle number of processor
516 @param[in] BistData Processor BIST data
517 @param[in] ApTopOfStack Top of AP stack
522 IN OUT CPU_MP_DATA
*CpuMpData
,
523 IN UINTN ProcessorNumber
,
525 IN UINT64 ApTopOfStack
528 CPU_INFO_IN_HOB
*CpuInfoInHob
;
530 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
531 CpuInfoInHob
[ProcessorNumber
].InitialApicId
= GetInitialApicId ();
532 CpuInfoInHob
[ProcessorNumber
].ApicId
= GetApicId ();
533 CpuInfoInHob
[ProcessorNumber
].Health
= BistData
;
534 CpuInfoInHob
[ProcessorNumber
].ApTopOfStack
= ApTopOfStack
;
536 CpuMpData
->CpuData
[ProcessorNumber
].Waiting
= FALSE
;
537 CpuMpData
->CpuData
[ProcessorNumber
].CpuHealthy
= (BistData
== 0) ? TRUE
: FALSE
;
538 if (CpuInfoInHob
[ProcessorNumber
].InitialApicId
>= 0xFF) {
540 // Set x2APIC mode if there are any logical processor reporting
541 // an Initial APIC ID of 255 or greater.
543 AcquireSpinLock(&CpuMpData
->MpLock
);
544 CpuMpData
->X2ApicEnable
= TRUE
;
545 ReleaseSpinLock(&CpuMpData
->MpLock
);
548 InitializeSpinLock(&CpuMpData
->CpuData
[ProcessorNumber
].ApLock
);
549 SetApState (&CpuMpData
->CpuData
[ProcessorNumber
], CpuStateIdle
);
553 This function will be called from AP reset code if BSP uses WakeUpAP.
555 @param[in] ExchangeInfo Pointer to the MP exchange info buffer
556 @param[in] ApIndex Number of current executing AP
561 IN MP_CPU_EXCHANGE_INFO
*ExchangeInfo
,
565 CPU_MP_DATA
*CpuMpData
;
566 UINTN ProcessorNumber
;
567 EFI_AP_PROCEDURE Procedure
;
570 volatile UINT32
*ApStartupSignalBuffer
;
571 CPU_INFO_IN_HOB
*CpuInfoInHob
;
573 UINTN CurrentApicMode
;
576 // AP finished assembly code and begin to execute C code
578 CpuMpData
= ExchangeInfo
->CpuMpData
;
581 // AP's local APIC settings will be lost after received INIT IPI
582 // We need to re-initialize them at here
584 ProgramVirtualWireMode ();
586 // Mask the LINT0 and LINT1 so that AP doesn't enter the system timer interrupt handler.
588 DisableLvtInterrupts ();
589 SyncLocalApicTimerSetting (CpuMpData
);
591 CurrentApicMode
= GetApicMode ();
593 if (CpuMpData
->InitFlag
== ApInitConfig
) {
597 InterlockedIncrement ((UINT32
*) &CpuMpData
->CpuCount
);
598 ProcessorNumber
= ApIndex
;
600 // This is first time AP wakeup, get BIST information from AP stack
602 ApTopOfStack
= CpuMpData
->Buffer
+ (ProcessorNumber
+ 1) * CpuMpData
->CpuApStackSize
;
603 BistData
= *(UINT32
*) ((UINTN
) ApTopOfStack
- sizeof (UINTN
));
605 // Do some AP initialize sync
607 ApInitializeSync (CpuMpData
);
609 // Sync BSP's Control registers to APs
611 RestoreVolatileRegisters (&CpuMpData
->CpuData
[0].VolatileRegisters
, FALSE
);
612 InitializeApData (CpuMpData
, ProcessorNumber
, BistData
, ApTopOfStack
);
613 ApStartupSignalBuffer
= CpuMpData
->CpuData
[ProcessorNumber
].StartupApSignal
;
616 // Execute AP function if AP is ready
618 GetProcessorNumber (CpuMpData
, &ProcessorNumber
);
620 // Clear AP start-up signal when AP waken up
622 ApStartupSignalBuffer
= CpuMpData
->CpuData
[ProcessorNumber
].StartupApSignal
;
623 InterlockedCompareExchange32 (
624 (UINT32
*) ApStartupSignalBuffer
,
628 if (CpuMpData
->ApLoopMode
== ApInHltLoop
) {
630 // Restore AP's volatile registers saved
632 RestoreVolatileRegisters (&CpuMpData
->CpuData
[ProcessorNumber
].VolatileRegisters
, TRUE
);
635 if (GetApState (&CpuMpData
->CpuData
[ProcessorNumber
]) == CpuStateReady
) {
636 Procedure
= (EFI_AP_PROCEDURE
)CpuMpData
->CpuData
[ProcessorNumber
].ApFunction
;
637 Parameter
= (VOID
*) CpuMpData
->CpuData
[ProcessorNumber
].ApFunctionArgument
;
638 if (Procedure
!= NULL
) {
639 SetApState (&CpuMpData
->CpuData
[ProcessorNumber
], CpuStateBusy
);
641 // Enable source debugging on AP function
645 // Invoke AP function here
647 Procedure (Parameter
);
648 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
649 if (CpuMpData
->SwitchBspFlag
) {
651 // Re-get the processor number due to BSP/AP maybe exchange in AP function
653 GetProcessorNumber (CpuMpData
, &ProcessorNumber
);
654 CpuMpData
->CpuData
[ProcessorNumber
].ApFunction
= 0;
655 CpuMpData
->CpuData
[ProcessorNumber
].ApFunctionArgument
= 0;
656 ApStartupSignalBuffer
= CpuMpData
->CpuData
[ProcessorNumber
].StartupApSignal
;
657 CpuInfoInHob
[ProcessorNumber
].ApTopOfStack
= CpuInfoInHob
[CpuMpData
->NewBspNumber
].ApTopOfStack
;
659 if (CpuInfoInHob
[ProcessorNumber
].ApicId
!= GetApicId () ||
660 CpuInfoInHob
[ProcessorNumber
].InitialApicId
!= GetInitialApicId ()) {
661 if (CurrentApicMode
!= GetApicMode ()) {
663 // If APIC mode change happened during AP function execution,
664 // we do not support APIC ID value changed.
670 // Re-get the CPU APICID and Initial APICID if they are changed
672 CpuInfoInHob
[ProcessorNumber
].ApicId
= GetApicId ();
673 CpuInfoInHob
[ProcessorNumber
].InitialApicId
= GetInitialApicId ();
678 SetApState (&CpuMpData
->CpuData
[ProcessorNumber
], CpuStateFinished
);
683 // AP finished executing C code
685 InterlockedIncrement ((UINT32
*) &CpuMpData
->FinishedCount
);
686 InterlockedDecrement ((UINT32
*) &CpuMpData
->MpCpuExchangeInfo
->NumApsExecuting
);
689 // Place AP is specified loop mode
691 if (CpuMpData
->ApLoopMode
== ApInHltLoop
) {
693 // Save AP volatile registers
695 SaveVolatileRegisters (&CpuMpData
->CpuData
[ProcessorNumber
].VolatileRegisters
);
697 // Place AP in HLT-loop
700 DisableInterrupts ();
706 DisableInterrupts ();
707 if (CpuMpData
->ApLoopMode
== ApInMwaitLoop
) {
709 // Place AP in MWAIT-loop
711 AsmMonitor ((UINTN
) ApStartupSignalBuffer
, 0, 0);
712 if (*ApStartupSignalBuffer
!= WAKEUP_AP_SIGNAL
) {
714 // Check AP start-up signal again.
715 // If AP start-up signal is not set, place AP into
716 // the specified C-state
718 AsmMwait (CpuMpData
->ApTargetCState
<< 4, 0);
720 } else if (CpuMpData
->ApLoopMode
== ApInRunLoop
) {
722 // Place AP in Run-loop
730 // If AP start-up signal is written, AP is waken up
731 // otherwise place AP in loop again
733 if (*ApStartupSignalBuffer
== WAKEUP_AP_SIGNAL
) {
741 Wait for AP wakeup and write AP start-up signal till AP is waken up.
743 @param[in] ApStartupSignalBuffer Pointer to AP wakeup signal
747 IN
volatile UINT32
*ApStartupSignalBuffer
751 // If AP is waken up, StartupApSignal should be cleared.
752 // Otherwise, write StartupApSignal again till AP waken up.
754 while (InterlockedCompareExchange32 (
755 (UINT32
*) ApStartupSignalBuffer
,
764 This function will fill the exchange info structure.
766 @param[in] CpuMpData Pointer to CPU MP Data
770 FillExchangeInfoData (
771 IN CPU_MP_DATA
*CpuMpData
774 volatile MP_CPU_EXCHANGE_INFO
*ExchangeInfo
;
776 ExchangeInfo
= CpuMpData
->MpCpuExchangeInfo
;
777 ExchangeInfo
->Lock
= 0;
778 ExchangeInfo
->StackStart
= CpuMpData
->Buffer
;
779 ExchangeInfo
->StackSize
= CpuMpData
->CpuApStackSize
;
780 ExchangeInfo
->BufferStart
= CpuMpData
->WakeupBuffer
;
781 ExchangeInfo
->ModeOffset
= CpuMpData
->AddressMap
.ModeEntryOffset
;
783 ExchangeInfo
->CodeSegment
= AsmReadCs ();
784 ExchangeInfo
->DataSegment
= AsmReadDs ();
786 ExchangeInfo
->Cr3
= AsmReadCr3 ();
788 ExchangeInfo
->CFunction
= (UINTN
) ApWakeupFunction
;
789 ExchangeInfo
->ApIndex
= 0;
790 ExchangeInfo
->NumApsExecuting
= 0;
791 ExchangeInfo
->InitFlag
= (UINTN
) CpuMpData
->InitFlag
;
792 ExchangeInfo
->CpuInfo
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
793 ExchangeInfo
->CpuMpData
= CpuMpData
;
795 ExchangeInfo
->EnableExecuteDisable
= IsBspExecuteDisableEnabled ();
797 ExchangeInfo
->InitializeFloatingPointUnitsAddress
= (UINTN
)InitializeFloatingPointUnits
;
800 // Get the BSP's data of GDT and IDT
802 AsmReadGdtr ((IA32_DESCRIPTOR
*) &ExchangeInfo
->GdtrProfile
);
803 AsmReadIdtr ((IA32_DESCRIPTOR
*) &ExchangeInfo
->IdtrProfile
);
807 Helper function that waits until the finished AP count reaches the specified
808 limit, or the specified timeout elapses (whichever comes first).
810 @param[in] CpuMpData Pointer to CPU MP Data.
811 @param[in] FinishedApLimit The number of finished APs to wait for.
812 @param[in] TimeLimit The number of microseconds to wait for.
815 TimedWaitForApFinish (
816 IN CPU_MP_DATA
*CpuMpData
,
817 IN UINT32 FinishedApLimit
,
822 Get available system memory below 1MB by specified size.
824 @param[in] CpuMpData The pointer to CPU MP Data structure.
827 BackupAndPrepareWakeupBuffer(
828 IN CPU_MP_DATA
*CpuMpData
832 (VOID
*) CpuMpData
->BackupBuffer
,
833 (VOID
*) CpuMpData
->WakeupBuffer
,
834 CpuMpData
->BackupBufferSize
837 (VOID
*) CpuMpData
->WakeupBuffer
,
838 (VOID
*) CpuMpData
->AddressMap
.RendezvousFunnelAddress
,
839 CpuMpData
->AddressMap
.RendezvousFunnelSize
844 Restore wakeup buffer data.
846 @param[in] CpuMpData The pointer to CPU MP Data structure.
850 IN CPU_MP_DATA
*CpuMpData
854 (VOID
*) CpuMpData
->WakeupBuffer
,
855 (VOID
*) CpuMpData
->BackupBuffer
,
856 CpuMpData
->BackupBufferSize
861 Allocate reset vector buffer.
863 @param[in, out] CpuMpData The pointer to CPU MP Data structure.
866 AllocateResetVector (
867 IN OUT CPU_MP_DATA
*CpuMpData
870 UINTN ApResetVectorSize
;
872 if (CpuMpData
->WakeupBuffer
== (UINTN
) -1) {
873 ApResetVectorSize
= CpuMpData
->AddressMap
.RendezvousFunnelSize
+
874 sizeof (MP_CPU_EXCHANGE_INFO
);
876 CpuMpData
->WakeupBuffer
= GetWakeupBuffer (ApResetVectorSize
);
877 CpuMpData
->MpCpuExchangeInfo
= (MP_CPU_EXCHANGE_INFO
*) (UINTN
)
878 (CpuMpData
->WakeupBuffer
+ CpuMpData
->AddressMap
.RendezvousFunnelSize
);
880 BackupAndPrepareWakeupBuffer (CpuMpData
);
884 Free AP reset vector buffer.
886 @param[in] CpuMpData The pointer to CPU MP Data structure.
890 IN CPU_MP_DATA
*CpuMpData
893 RestoreWakeupBuffer (CpuMpData
);
897 This function will be called by BSP to wakeup AP.
899 @param[in] CpuMpData Pointer to CPU MP Data
900 @param[in] Broadcast TRUE: Send broadcast IPI to all APs
901 FALSE: Send IPI to AP by ApicId
902 @param[in] ProcessorNumber The handle number of specified processor
903 @param[in] Procedure The function to be invoked by AP
904 @param[in] ProcedureArgument The argument to be passed into AP function
908 IN CPU_MP_DATA
*CpuMpData
,
909 IN BOOLEAN Broadcast
,
910 IN UINTN ProcessorNumber
,
911 IN EFI_AP_PROCEDURE Procedure
, OPTIONAL
912 IN VOID
*ProcedureArgument OPTIONAL
915 volatile MP_CPU_EXCHANGE_INFO
*ExchangeInfo
;
917 CPU_AP_DATA
*CpuData
;
918 BOOLEAN ResetVectorRequired
;
919 CPU_INFO_IN_HOB
*CpuInfoInHob
;
921 CpuMpData
->FinishedCount
= 0;
922 ResetVectorRequired
= FALSE
;
924 if (CpuMpData
->ApLoopMode
== ApInHltLoop
||
925 CpuMpData
->InitFlag
!= ApInitDone
) {
926 ResetVectorRequired
= TRUE
;
927 AllocateResetVector (CpuMpData
);
928 FillExchangeInfoData (CpuMpData
);
929 SaveLocalApicTimerSetting (CpuMpData
);
930 } else if (CpuMpData
->ApLoopMode
== ApInMwaitLoop
) {
932 // Get AP target C-state each time when waking up AP,
933 // for it maybe updated by platform again
935 CpuMpData
->ApTargetCState
= PcdGet8 (PcdCpuApTargetCstate
);
938 ExchangeInfo
= CpuMpData
->MpCpuExchangeInfo
;
941 for (Index
= 0; Index
< CpuMpData
->CpuCount
; Index
++) {
942 if (Index
!= CpuMpData
->BspNumber
) {
943 CpuData
= &CpuMpData
->CpuData
[Index
];
944 CpuData
->ApFunction
= (UINTN
) Procedure
;
945 CpuData
->ApFunctionArgument
= (UINTN
) ProcedureArgument
;
946 SetApState (CpuData
, CpuStateReady
);
947 if (CpuMpData
->InitFlag
!= ApInitConfig
) {
948 *(UINT32
*) CpuData
->StartupApSignal
= WAKEUP_AP_SIGNAL
;
952 if (ResetVectorRequired
) {
956 SendInitSipiSipiAllExcludingSelf ((UINT32
) ExchangeInfo
->BufferStart
);
958 if (CpuMpData
->InitFlag
== ApInitConfig
) {
960 // Here support two methods to collect AP count through adjust
961 // PcdCpuApInitTimeOutInMicroSeconds values.
963 // one way is set a value to just let the first AP to start the
964 // initialization, then through the later while loop to wait all Aps
965 // finsh the initialization.
966 // The other way is set a value to let all APs finished the initialzation.
967 // In this case, the later while loop is useless.
969 TimedWaitForApFinish (
971 PcdGet32 (PcdCpuMaxLogicalProcessorNumber
) - 1,
972 PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds
)
975 while (CpuMpData
->MpCpuExchangeInfo
->NumApsExecuting
!= 0) {
980 // Wait all APs waken up if this is not the 1st broadcast of SIPI
982 for (Index
= 0; Index
< CpuMpData
->CpuCount
; Index
++) {
983 CpuData
= &CpuMpData
->CpuData
[Index
];
984 if (Index
!= CpuMpData
->BspNumber
) {
985 WaitApWakeup (CpuData
->StartupApSignal
);
990 CpuData
= &CpuMpData
->CpuData
[ProcessorNumber
];
991 CpuData
->ApFunction
= (UINTN
) Procedure
;
992 CpuData
->ApFunctionArgument
= (UINTN
) ProcedureArgument
;
993 SetApState (CpuData
, CpuStateReady
);
995 // Wakeup specified AP
997 ASSERT (CpuMpData
->InitFlag
!= ApInitConfig
);
998 *(UINT32
*) CpuData
->StartupApSignal
= WAKEUP_AP_SIGNAL
;
999 if (ResetVectorRequired
) {
1000 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
1002 CpuInfoInHob
[ProcessorNumber
].ApicId
,
1003 (UINT32
) ExchangeInfo
->BufferStart
1007 // Wait specified AP waken up
1009 WaitApWakeup (CpuData
->StartupApSignal
);
1012 if (ResetVectorRequired
) {
1013 FreeResetVector (CpuMpData
);
1018 Calculate timeout value and return the current performance counter value.
1020 Calculate the number of performance counter ticks required for a timeout.
1021 If TimeoutInMicroseconds is 0, return value is also 0, which is recognized
1024 @param[in] TimeoutInMicroseconds Timeout value in microseconds.
1025 @param[out] CurrentTime Returns the current value of the performance counter.
1027 @return Expected time stamp counter for timeout.
1028 If TimeoutInMicroseconds is 0, return value is also 0, which is recognized
1034 IN UINTN TimeoutInMicroseconds
,
1035 OUT UINT64
*CurrentTime
1038 UINT64 TimeoutInSeconds
;
1039 UINT64 TimestampCounterFreq
;
1042 // Read the current value of the performance counter
1044 *CurrentTime
= GetPerformanceCounter ();
1047 // If TimeoutInMicroseconds is 0, return value is also 0, which is recognized
1050 if (TimeoutInMicroseconds
== 0) {
1055 // GetPerformanceCounterProperties () returns the timestamp counter's frequency
1058 TimestampCounterFreq
= GetPerformanceCounterProperties (NULL
, NULL
);
1061 // Check the potential overflow before calculate the number of ticks for the timeout value.
1063 if (DivU64x64Remainder (MAX_UINT64
, TimeoutInMicroseconds
, NULL
) < TimestampCounterFreq
) {
1065 // Convert microseconds into seconds if direct multiplication overflows
1067 TimeoutInSeconds
= DivU64x32 (TimeoutInMicroseconds
, 1000000);
1069 // Assertion if the final tick count exceeds MAX_UINT64
1071 ASSERT (DivU64x64Remainder (MAX_UINT64
, TimeoutInSeconds
, NULL
) >= TimestampCounterFreq
);
1072 return MultU64x64 (TimestampCounterFreq
, TimeoutInSeconds
);
1075 // No overflow case, multiply the return value with TimeoutInMicroseconds and then divide
1076 // it by 1,000,000, to get the number of ticks for the timeout value.
1080 TimestampCounterFreq
,
1081 TimeoutInMicroseconds
1089 Checks whether timeout expires.
1091 Check whether the number of elapsed performance counter ticks required for
1092 a timeout condition has been reached.
1093 If Timeout is zero, which means infinity, return value is always FALSE.
1095 @param[in, out] PreviousTime On input, the value of the performance counter
1096 when it was last read.
1097 On output, the current value of the performance
1099 @param[in] TotalTime The total amount of elapsed time in performance
1101 @param[in] Timeout The number of performance counter ticks required
1102 to reach a timeout condition.
1104 @retval TRUE A timeout condition has been reached.
1105 @retval FALSE A timeout condition has not been reached.
1110 IN OUT UINT64
*PreviousTime
,
1111 IN UINT64
*TotalTime
,
1124 GetPerformanceCounterProperties (&Start
, &End
);
1125 Cycle
= End
- Start
;
1130 CurrentTime
= GetPerformanceCounter();
1131 Delta
= (INT64
) (CurrentTime
- *PreviousTime
);
1138 *TotalTime
+= Delta
;
1139 *PreviousTime
= CurrentTime
;
1140 if (*TotalTime
> Timeout
) {
1147 Helper function that waits until the finished AP count reaches the specified
1148 limit, or the specified timeout elapses (whichever comes first).
1150 @param[in] CpuMpData Pointer to CPU MP Data.
1151 @param[in] FinishedApLimit The number of finished APs to wait for.
1152 @param[in] TimeLimit The number of microseconds to wait for.
1155 TimedWaitForApFinish (
1156 IN CPU_MP_DATA
*CpuMpData
,
1157 IN UINT32 FinishedApLimit
,
1162 // CalculateTimeout() and CheckTimeout() consider a TimeLimit of 0
1163 // "infinity", so check for (TimeLimit == 0) explicitly.
1165 if (TimeLimit
== 0) {
1169 CpuMpData
->TotalTime
= 0;
1170 CpuMpData
->ExpectedTime
= CalculateTimeout (
1172 &CpuMpData
->CurrentTime
1174 while (CpuMpData
->FinishedCount
< FinishedApLimit
&&
1176 &CpuMpData
->CurrentTime
,
1177 &CpuMpData
->TotalTime
,
1178 CpuMpData
->ExpectedTime
1183 if (CpuMpData
->FinishedCount
>= FinishedApLimit
) {
1186 "%a: reached FinishedApLimit=%u in %Lu microseconds\n",
1189 DivU64x64Remainder (
1190 MultU64x32 (CpuMpData
->TotalTime
, 1000000),
1191 GetPerformanceCounterProperties (NULL
, NULL
),
1199 Reset an AP to Idle state.
1201 Any task being executed by the AP will be aborted and the AP
1202 will be waiting for a new task in Wait-For-SIPI state.
1204 @param[in] ProcessorNumber The handle number of processor.
1207 ResetProcessorToIdleState (
1208 IN UINTN ProcessorNumber
1211 CPU_MP_DATA
*CpuMpData
;
1213 CpuMpData
= GetCpuMpData ();
1215 CpuMpData
->InitFlag
= ApInitReconfig
;
1216 WakeUpAP (CpuMpData
, FALSE
, ProcessorNumber
, NULL
, NULL
);
1217 while (CpuMpData
->FinishedCount
< 1) {
1220 CpuMpData
->InitFlag
= ApInitDone
;
1222 SetApState (&CpuMpData
->CpuData
[ProcessorNumber
], CpuStateIdle
);
1226 Searches for the next waiting AP.
1228 Search for the next AP that is put in waiting state by single-threaded StartupAllAPs().
1230 @param[out] NextProcessorNumber Pointer to the processor number of the next waiting AP.
1232 @retval EFI_SUCCESS The next waiting AP has been found.
1233 @retval EFI_NOT_FOUND No waiting AP exists.
1237 GetNextWaitingProcessorNumber (
1238 OUT UINTN
*NextProcessorNumber
1241 UINTN ProcessorNumber
;
1242 CPU_MP_DATA
*CpuMpData
;
1244 CpuMpData
= GetCpuMpData ();
1246 for (ProcessorNumber
= 0; ProcessorNumber
< CpuMpData
->CpuCount
; ProcessorNumber
++) {
1247 if (CpuMpData
->CpuData
[ProcessorNumber
].Waiting
) {
1248 *NextProcessorNumber
= ProcessorNumber
;
1253 return EFI_NOT_FOUND
;
1256 /** Checks status of specified AP.
1258 This function checks whether the specified AP has finished the task assigned
1259 by StartupThisAP(), and whether timeout expires.
1261 @param[in] ProcessorNumber The handle number of processor.
1263 @retval EFI_SUCCESS Specified AP has finished task assigned by StartupThisAPs().
1264 @retval EFI_TIMEOUT The timeout expires.
1265 @retval EFI_NOT_READY Specified AP has not finished task and timeout has not expired.
1269 IN UINTN ProcessorNumber
1272 CPU_MP_DATA
*CpuMpData
;
1273 CPU_AP_DATA
*CpuData
;
1275 CpuMpData
= GetCpuMpData ();
1276 CpuData
= &CpuMpData
->CpuData
[ProcessorNumber
];
1279 // Check the CPU state of AP. If it is CpuStateFinished, then the AP has finished its task.
1280 // Only BSP and corresponding AP access this unit of CPU Data. This means the AP will not modify the
1281 // value of state after setting the it to CpuStateFinished, so BSP can safely make use of its value.
1284 // If the AP finishes for StartupThisAP(), return EFI_SUCCESS.
1286 if (GetApState(CpuData
) == CpuStateFinished
) {
1287 if (CpuData
->Finished
!= NULL
) {
1288 *(CpuData
->Finished
) = TRUE
;
1290 SetApState (CpuData
, CpuStateIdle
);
1294 // If timeout expires for StartupThisAP(), report timeout.
1296 if (CheckTimeout (&CpuData
->CurrentTime
, &CpuData
->TotalTime
, CpuData
->ExpectedTime
)) {
1297 if (CpuData
->Finished
!= NULL
) {
1298 *(CpuData
->Finished
) = FALSE
;
1301 // Reset failed AP to idle state
1303 ResetProcessorToIdleState (ProcessorNumber
);
1308 return EFI_NOT_READY
;
1312 Checks status of all APs.
1314 This function checks whether all APs have finished task assigned by StartupAllAPs(),
1315 and whether timeout expires.
1317 @retval EFI_SUCCESS All APs have finished task assigned by StartupAllAPs().
1318 @retval EFI_TIMEOUT The timeout expires.
1319 @retval EFI_NOT_READY APs have not finished task and timeout has not expired.
1326 UINTN ProcessorNumber
;
1327 UINTN NextProcessorNumber
;
1330 CPU_MP_DATA
*CpuMpData
;
1331 CPU_AP_DATA
*CpuData
;
1333 CpuMpData
= GetCpuMpData ();
1335 NextProcessorNumber
= 0;
1338 // Go through all APs that are responsible for the StartupAllAPs().
1340 for (ProcessorNumber
= 0; ProcessorNumber
< CpuMpData
->CpuCount
; ProcessorNumber
++) {
1341 if (!CpuMpData
->CpuData
[ProcessorNumber
].Waiting
) {
1345 CpuData
= &CpuMpData
->CpuData
[ProcessorNumber
];
1347 // Check the CPU state of AP. If it is CpuStateFinished, then the AP has finished its task.
1348 // Only BSP and corresponding AP access this unit of CPU Data. This means the AP will not modify the
1349 // value of state after setting the it to CpuStateFinished, so BSP can safely make use of its value.
1351 if (GetApState(CpuData
) == CpuStateFinished
) {
1352 CpuMpData
->RunningCount
++;
1353 CpuMpData
->CpuData
[ProcessorNumber
].Waiting
= FALSE
;
1354 SetApState(CpuData
, CpuStateIdle
);
1357 // If in Single Thread mode, then search for the next waiting AP for execution.
1359 if (CpuMpData
->SingleThread
) {
1360 Status
= GetNextWaitingProcessorNumber (&NextProcessorNumber
);
1362 if (!EFI_ERROR (Status
)) {
1366 (UINT32
) NextProcessorNumber
,
1367 CpuMpData
->Procedure
,
1368 CpuMpData
->ProcArguments
1376 // If all APs finish, return EFI_SUCCESS.
1378 if (CpuMpData
->RunningCount
== CpuMpData
->StartCount
) {
1383 // If timeout expires, report timeout.
1386 &CpuMpData
->CurrentTime
,
1387 &CpuMpData
->TotalTime
,
1388 CpuMpData
->ExpectedTime
)
1391 // If FailedCpuList is not NULL, record all failed APs in it.
1393 if (CpuMpData
->FailedCpuList
!= NULL
) {
1394 *CpuMpData
->FailedCpuList
=
1395 AllocatePool ((CpuMpData
->StartCount
- CpuMpData
->FinishedCount
+ 1) * sizeof (UINTN
));
1396 ASSERT (*CpuMpData
->FailedCpuList
!= NULL
);
1400 for (ProcessorNumber
= 0; ProcessorNumber
< CpuMpData
->CpuCount
; ProcessorNumber
++) {
1402 // Check whether this processor is responsible for StartupAllAPs().
1404 if (CpuMpData
->CpuData
[ProcessorNumber
].Waiting
) {
1406 // Reset failed APs to idle state
1408 ResetProcessorToIdleState (ProcessorNumber
);
1409 CpuMpData
->CpuData
[ProcessorNumber
].Waiting
= FALSE
;
1410 if (CpuMpData
->FailedCpuList
!= NULL
) {
1411 (*CpuMpData
->FailedCpuList
)[ListIndex
++] = ProcessorNumber
;
1415 if (CpuMpData
->FailedCpuList
!= NULL
) {
1416 (*CpuMpData
->FailedCpuList
)[ListIndex
] = END_OF_CPU_LIST
;
1420 return EFI_NOT_READY
;
1424 MP Initialize Library initialization.
1426 This service will allocate AP reset vector and wakeup all APs to do APs
1429 This service must be invoked before all other MP Initialize Library
1430 service are invoked.
1432 @retval EFI_SUCCESS MP initialization succeeds.
1433 @retval Others MP initialization fails.
1438 MpInitLibInitialize (
1442 CPU_MP_DATA
*OldCpuMpData
;
1443 CPU_INFO_IN_HOB
*CpuInfoInHob
;
1444 UINT32 MaxLogicalProcessorNumber
;
1446 MP_ASSEMBLY_ADDRESS_MAP AddressMap
;
1448 UINT32 MonitorFilterSize
;
1451 CPU_MP_DATA
*CpuMpData
;
1453 UINT8
*MonitorBuffer
;
1455 UINTN ApResetVectorSize
;
1456 UINTN BackupBufferAddr
;
1458 OldCpuMpData
= GetCpuMpDataFromGuidedHob ();
1459 if (OldCpuMpData
== NULL
) {
1460 MaxLogicalProcessorNumber
= PcdGet32(PcdCpuMaxLogicalProcessorNumber
);
1462 MaxLogicalProcessorNumber
= OldCpuMpData
->CpuCount
;
1464 ASSERT (MaxLogicalProcessorNumber
!= 0);
1466 AsmGetAddressMap (&AddressMap
);
1467 ApResetVectorSize
= AddressMap
.RendezvousFunnelSize
+ sizeof (MP_CPU_EXCHANGE_INFO
);
1468 ApStackSize
= PcdGet32(PcdCpuApStackSize
);
1469 ApLoopMode
= GetApLoopMode (&MonitorFilterSize
);
1471 BufferSize
= ApStackSize
* MaxLogicalProcessorNumber
;
1472 BufferSize
+= MonitorFilterSize
* MaxLogicalProcessorNumber
;
1473 BufferSize
+= sizeof (CPU_MP_DATA
);
1474 BufferSize
+= ApResetVectorSize
;
1475 BufferSize
+= (sizeof (CPU_AP_DATA
) + sizeof (CPU_INFO_IN_HOB
))* MaxLogicalProcessorNumber
;
1476 MpBuffer
= AllocatePages (EFI_SIZE_TO_PAGES (BufferSize
));
1477 ASSERT (MpBuffer
!= NULL
);
1478 ZeroMem (MpBuffer
, BufferSize
);
1479 Buffer
= (UINTN
) MpBuffer
;
1481 MonitorBuffer
= (UINT8
*) (Buffer
+ ApStackSize
* MaxLogicalProcessorNumber
);
1482 BackupBufferAddr
= (UINTN
) MonitorBuffer
+ MonitorFilterSize
* MaxLogicalProcessorNumber
;
1483 CpuMpData
= (CPU_MP_DATA
*) (BackupBufferAddr
+ ApResetVectorSize
);
1484 CpuMpData
->Buffer
= Buffer
;
1485 CpuMpData
->CpuApStackSize
= ApStackSize
;
1486 CpuMpData
->BackupBuffer
= BackupBufferAddr
;
1487 CpuMpData
->BackupBufferSize
= ApResetVectorSize
;
1488 CpuMpData
->WakeupBuffer
= (UINTN
) -1;
1489 CpuMpData
->CpuCount
= 1;
1490 CpuMpData
->BspNumber
= 0;
1491 CpuMpData
->WaitEvent
= NULL
;
1492 CpuMpData
->SwitchBspFlag
= FALSE
;
1493 CpuMpData
->CpuData
= (CPU_AP_DATA
*) (CpuMpData
+ 1);
1494 CpuMpData
->CpuInfoInHob
= (UINT64
) (UINTN
) (CpuMpData
->CpuData
+ MaxLogicalProcessorNumber
);
1495 CpuMpData
->MicrocodePatchAddress
= PcdGet64 (PcdCpuMicrocodePatchAddress
);
1496 CpuMpData
->MicrocodePatchRegionSize
= PcdGet64 (PcdCpuMicrocodePatchRegionSize
);
1497 InitializeSpinLock(&CpuMpData
->MpLock
);
1499 // Save BSP's Control registers to APs
1501 SaveVolatileRegisters (&CpuMpData
->CpuData
[0].VolatileRegisters
);
1503 // Set BSP basic information
1505 InitializeApData (CpuMpData
, 0, 0, CpuMpData
->Buffer
+ ApStackSize
);
1507 // Save assembly code information
1509 CopyMem (&CpuMpData
->AddressMap
, &AddressMap
, sizeof (MP_ASSEMBLY_ADDRESS_MAP
));
1511 // Finally set AP loop mode
1513 CpuMpData
->ApLoopMode
= ApLoopMode
;
1514 DEBUG ((DEBUG_INFO
, "AP Loop Mode is %d\n", CpuMpData
->ApLoopMode
));
1516 // Set up APs wakeup signal buffer
1518 for (Index
= 0; Index
< MaxLogicalProcessorNumber
; Index
++) {
1519 CpuMpData
->CpuData
[Index
].StartupApSignal
=
1520 (UINT32
*)(MonitorBuffer
+ MonitorFilterSize
* Index
);
1523 // Load Microcode on BSP
1525 MicrocodeDetect (CpuMpData
);
1527 // Store BSP's MTRR setting
1529 MtrrGetAllMtrrs (&CpuMpData
->MtrrTable
);
1531 // Enable the local APIC for Virtual Wire Mode.
1533 ProgramVirtualWireMode ();
1535 if (OldCpuMpData
== NULL
) {
1536 if (MaxLogicalProcessorNumber
> 1) {
1538 // Wakeup all APs and calculate the processor count in system
1540 CollectProcessorCount (CpuMpData
);
1544 // APs have been wakeup before, just get the CPU Information
1547 CpuMpData
->CpuCount
= OldCpuMpData
->CpuCount
;
1548 CpuMpData
->BspNumber
= OldCpuMpData
->BspNumber
;
1549 CpuMpData
->InitFlag
= ApInitReconfig
;
1550 CpuMpData
->CpuInfoInHob
= OldCpuMpData
->CpuInfoInHob
;
1551 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
1552 for (Index
= 0; Index
< CpuMpData
->CpuCount
; Index
++) {
1553 InitializeSpinLock(&CpuMpData
->CpuData
[Index
].ApLock
);
1554 if (CpuInfoInHob
[Index
].InitialApicId
>= 255 || Index
> 254) {
1555 CpuMpData
->X2ApicEnable
= TRUE
;
1557 CpuMpData
->CpuData
[Index
].CpuHealthy
= (CpuInfoInHob
[Index
].Health
== 0)? TRUE
:FALSE
;
1558 CpuMpData
->CpuData
[Index
].ApFunction
= 0;
1560 &CpuMpData
->CpuData
[Index
].VolatileRegisters
,
1561 &CpuMpData
->CpuData
[0].VolatileRegisters
,
1562 sizeof (CPU_VOLATILE_REGISTERS
)
1565 if (MaxLogicalProcessorNumber
> 1) {
1567 // Wakeup APs to do some AP initialize sync
1569 WakeUpAP (CpuMpData
, TRUE
, 0, ApInitializeSync
, CpuMpData
);
1571 // Wait for all APs finished initialization
1573 while (CpuMpData
->FinishedCount
< (CpuMpData
->CpuCount
- 1)) {
1576 CpuMpData
->InitFlag
= ApInitDone
;
1577 for (Index
= 0; Index
< CpuMpData
->CpuCount
; Index
++) {
1578 SetApState (&CpuMpData
->CpuData
[Index
], CpuStateIdle
);
1584 // Initialize global data for MP support
1586 InitMpGlobalData (CpuMpData
);
1592 Gets detailed MP-related information on the requested processor at the
1593 instant this call is made. This service may only be called from the BSP.
1595 @param[in] ProcessorNumber The handle number of processor.
1596 @param[out] ProcessorInfoBuffer A pointer to the buffer where information for
1597 the requested processor is deposited.
1598 @param[out] HealthData Return processor health data.
1600 @retval EFI_SUCCESS Processor information was returned.
1601 @retval EFI_DEVICE_ERROR The calling processor is an AP.
1602 @retval EFI_INVALID_PARAMETER ProcessorInfoBuffer is NULL.
1603 @retval EFI_NOT_FOUND The processor with the handle specified by
1604 ProcessorNumber does not exist in the platform.
1605 @retval EFI_NOT_READY MP Initialize Library is not initialized.
1610 MpInitLibGetProcessorInfo (
1611 IN UINTN ProcessorNumber
,
1612 OUT EFI_PROCESSOR_INFORMATION
*ProcessorInfoBuffer
,
1613 OUT EFI_HEALTH_FLAGS
*HealthData OPTIONAL
1616 CPU_MP_DATA
*CpuMpData
;
1618 CPU_INFO_IN_HOB
*CpuInfoInHob
;
1620 CpuMpData
= GetCpuMpData ();
1621 CpuInfoInHob
= (CPU_INFO_IN_HOB
*) (UINTN
) CpuMpData
->CpuInfoInHob
;
1624 // Check whether caller processor is BSP
1626 MpInitLibWhoAmI (&CallerNumber
);
1627 if (CallerNumber
!= CpuMpData
->BspNumber
) {
1628 return EFI_DEVICE_ERROR
;
1631 if (ProcessorInfoBuffer
== NULL
) {
1632 return EFI_INVALID_PARAMETER
;
1635 if (ProcessorNumber
>= CpuMpData
->CpuCount
) {
1636 return EFI_NOT_FOUND
;
1639 ProcessorInfoBuffer
->ProcessorId
= (UINT64
) CpuInfoInHob
[ProcessorNumber
].ApicId
;
1640 ProcessorInfoBuffer
->StatusFlag
= 0;
1641 if (ProcessorNumber
== CpuMpData
->BspNumber
) {
1642 ProcessorInfoBuffer
->StatusFlag
|= PROCESSOR_AS_BSP_BIT
;
1644 if (CpuMpData
->CpuData
[ProcessorNumber
].CpuHealthy
) {
1645 ProcessorInfoBuffer
->StatusFlag
|= PROCESSOR_HEALTH_STATUS_BIT
;
1647 if (GetApState (&CpuMpData
->CpuData
[ProcessorNumber
]) == CpuStateDisabled
) {
1648 ProcessorInfoBuffer
->StatusFlag
&= ~PROCESSOR_ENABLED_BIT
;
1650 ProcessorInfoBuffer
->StatusFlag
|= PROCESSOR_ENABLED_BIT
;
1654 // Get processor location information
1656 GetProcessorLocationByApicId (
1657 CpuInfoInHob
[ProcessorNumber
].ApicId
,
1658 &ProcessorInfoBuffer
->Location
.Package
,
1659 &ProcessorInfoBuffer
->Location
.Core
,
1660 &ProcessorInfoBuffer
->Location
.Thread
1663 if (HealthData
!= NULL
) {
1664 HealthData
->Uint32
= CpuInfoInHob
[ProcessorNumber
].Health
;
1671 Worker function to switch the requested AP to be the BSP from that point onward.
1673 @param[in] ProcessorNumber The handle number of AP that is to become the new BSP.
1674 @param[in] EnableOldBSP If TRUE, then the old BSP will be listed as an
1675 enabled AP. Otherwise, it will be disabled.
1677 @retval EFI_SUCCESS BSP successfully switched.
1678 @retval others Failed to switch BSP.
1683 IN UINTN ProcessorNumber
,
1684 IN BOOLEAN EnableOldBSP
1687 CPU_MP_DATA
*CpuMpData
;
1690 MSR_IA32_APIC_BASE_REGISTER ApicBaseMsr
;
1691 BOOLEAN OldInterruptState
;
1692 BOOLEAN OldTimerInterruptState
;
1695 // Save and Disable Local APIC timer interrupt
1697 OldTimerInterruptState
= GetApicTimerInterruptState ();
1698 DisableApicTimerInterrupt ();
1700 // Before send both BSP and AP to a procedure to exchange their roles,
1701 // interrupt must be disabled. This is because during the exchange role
1702 // process, 2 CPU may use 1 stack. If interrupt happens, the stack will
1703 // be corrupted, since interrupt return address will be pushed to stack
1706 OldInterruptState
= SaveAndDisableInterrupts ();
1709 // Mask LINT0 & LINT1 for the old BSP
1711 DisableLvtInterrupts ();
1713 CpuMpData
= GetCpuMpData ();
1716 // Check whether caller processor is BSP
1718 MpInitLibWhoAmI (&CallerNumber
);
1719 if (CallerNumber
!= CpuMpData
->BspNumber
) {
1720 return EFI_DEVICE_ERROR
;
1723 if (ProcessorNumber
>= CpuMpData
->CpuCount
) {
1724 return EFI_NOT_FOUND
;
1728 // Check whether specified AP is disabled
1730 State
= GetApState (&CpuMpData
->CpuData
[ProcessorNumber
]);
1731 if (State
== CpuStateDisabled
) {
1732 return EFI_INVALID_PARAMETER
;
1736 // Check whether ProcessorNumber specifies the current BSP
1738 if (ProcessorNumber
== CpuMpData
->BspNumber
) {
1739 return EFI_INVALID_PARAMETER
;
1743 // Check whether specified AP is busy
1745 if (State
== CpuStateBusy
) {
1746 return EFI_NOT_READY
;
1749 CpuMpData
->BSPInfo
.State
= CPU_SWITCH_STATE_IDLE
;
1750 CpuMpData
->APInfo
.State
= CPU_SWITCH_STATE_IDLE
;
1751 CpuMpData
->SwitchBspFlag
= TRUE
;
1752 CpuMpData
->NewBspNumber
= ProcessorNumber
;
1755 // Clear the BSP bit of MSR_IA32_APIC_BASE
1757 ApicBaseMsr
.Uint64
= AsmReadMsr64 (MSR_IA32_APIC_BASE
);
1758 ApicBaseMsr
.Bits
.BSP
= 0;
1759 AsmWriteMsr64 (MSR_IA32_APIC_BASE
, ApicBaseMsr
.Uint64
);
1762 // Need to wakeUp AP (future BSP).
1764 WakeUpAP (CpuMpData
, FALSE
, ProcessorNumber
, FutureBSPProc
, CpuMpData
);
1766 AsmExchangeRole (&CpuMpData
->BSPInfo
, &CpuMpData
->APInfo
);
1769 // Set the BSP bit of MSR_IA32_APIC_BASE on new BSP
1771 ApicBaseMsr
.Uint64
= AsmReadMsr64 (MSR_IA32_APIC_BASE
);
1772 ApicBaseMsr
.Bits
.BSP
= 1;
1773 AsmWriteMsr64 (MSR_IA32_APIC_BASE
, ApicBaseMsr
.Uint64
);
1774 ProgramVirtualWireMode ();
1777 // Wait for old BSP finished AP task
1779 while (GetApState (&CpuMpData
->CpuData
[CallerNumber
]) != CpuStateFinished
) {
1783 CpuMpData
->SwitchBspFlag
= FALSE
;
1785 // Set old BSP enable state
1787 if (!EnableOldBSP
) {
1788 SetApState (&CpuMpData
->CpuData
[CallerNumber
], CpuStateDisabled
);
1790 SetApState (&CpuMpData
->CpuData
[CallerNumber
], CpuStateIdle
);
1793 // Save new BSP number
1795 CpuMpData
->BspNumber
= (UINT32
) ProcessorNumber
;
1798 // Restore interrupt state.
1800 SetInterruptState (OldInterruptState
);
1802 if (OldTimerInterruptState
) {
1803 EnableApicTimerInterrupt ();
1810 Worker function to let the caller enable or disable an AP from this point onward.
1811 This service may only be called from the BSP.
1813 @param[in] ProcessorNumber The handle number of AP.
1814 @param[in] EnableAP Specifies the new state for the processor for
1815 enabled, FALSE for disabled.
1816 @param[in] HealthFlag If not NULL, a pointer to a value that specifies
1817 the new health status of the AP.
1819 @retval EFI_SUCCESS The specified AP was enabled or disabled successfully.
1820 @retval others Failed to Enable/Disable AP.
1824 EnableDisableApWorker (
1825 IN UINTN ProcessorNumber
,
1826 IN BOOLEAN EnableAP
,
1827 IN UINT32
*HealthFlag OPTIONAL
1830 CPU_MP_DATA
*CpuMpData
;
1833 CpuMpData
= GetCpuMpData ();
1836 // Check whether caller processor is BSP
1838 MpInitLibWhoAmI (&CallerNumber
);
1839 if (CallerNumber
!= CpuMpData
->BspNumber
) {
1840 return EFI_DEVICE_ERROR
;
1843 if (ProcessorNumber
== CpuMpData
->BspNumber
) {
1844 return EFI_INVALID_PARAMETER
;
1847 if (ProcessorNumber
>= CpuMpData
->CpuCount
) {
1848 return EFI_NOT_FOUND
;
1852 SetApState (&CpuMpData
->CpuData
[ProcessorNumber
], CpuStateDisabled
);
1854 ResetProcessorToIdleState (ProcessorNumber
);
1857 if (HealthFlag
!= NULL
) {
1858 CpuMpData
->CpuData
[ProcessorNumber
].CpuHealthy
=
1859 (BOOLEAN
) ((*HealthFlag
& PROCESSOR_HEALTH_STATUS_BIT
) != 0);
1866 This return the handle number for the calling processor. This service may be
1867 called from the BSP and APs.
1869 @param[out] ProcessorNumber Pointer to the handle number of AP.
1870 The range is from 0 to the total number of
1871 logical processors minus 1. The total number of
1872 logical processors can be retrieved by
1873 MpInitLibGetNumberOfProcessors().
1875 @retval EFI_SUCCESS The current processor handle number was returned
1877 @retval EFI_INVALID_PARAMETER ProcessorNumber is NULL.
1878 @retval EFI_NOT_READY MP Initialize Library is not initialized.
1884 OUT UINTN
*ProcessorNumber
1887 CPU_MP_DATA
*CpuMpData
;
1889 if (ProcessorNumber
== NULL
) {
1890 return EFI_INVALID_PARAMETER
;
1893 CpuMpData
= GetCpuMpData ();
1895 return GetProcessorNumber (CpuMpData
, ProcessorNumber
);
1899 Retrieves the number of logical processor in the platform and the number of
1900 those logical processors that are enabled on this boot. This service may only
1901 be called from the BSP.
1903 @param[out] NumberOfProcessors Pointer to the total number of logical
1904 processors in the system, including the BSP
1906 @param[out] NumberOfEnabledProcessors Pointer to the number of enabled logical
1907 processors that exist in system, including
1910 @retval EFI_SUCCESS The number of logical processors and enabled
1911 logical processors was retrieved.
1912 @retval EFI_DEVICE_ERROR The calling processor is an AP.
1913 @retval EFI_INVALID_PARAMETER NumberOfProcessors is NULL and NumberOfEnabledProcessors
1915 @retval EFI_NOT_READY MP Initialize Library is not initialized.
1920 MpInitLibGetNumberOfProcessors (
1921 OUT UINTN
*NumberOfProcessors
, OPTIONAL
1922 OUT UINTN
*NumberOfEnabledProcessors OPTIONAL
1925 CPU_MP_DATA
*CpuMpData
;
1927 UINTN ProcessorNumber
;
1928 UINTN EnabledProcessorNumber
;
1931 CpuMpData
= GetCpuMpData ();
1933 if ((NumberOfProcessors
== NULL
) && (NumberOfEnabledProcessors
== NULL
)) {
1934 return EFI_INVALID_PARAMETER
;
1938 // Check whether caller processor is BSP
1940 MpInitLibWhoAmI (&CallerNumber
);
1941 if (CallerNumber
!= CpuMpData
->BspNumber
) {
1942 return EFI_DEVICE_ERROR
;
1945 ProcessorNumber
= CpuMpData
->CpuCount
;
1946 EnabledProcessorNumber
= 0;
1947 for (Index
= 0; Index
< ProcessorNumber
; Index
++) {
1948 if (GetApState (&CpuMpData
->CpuData
[Index
]) != CpuStateDisabled
) {
1949 EnabledProcessorNumber
++;
1953 if (NumberOfProcessors
!= NULL
) {
1954 *NumberOfProcessors
= ProcessorNumber
;
1956 if (NumberOfEnabledProcessors
!= NULL
) {
1957 *NumberOfEnabledProcessors
= EnabledProcessorNumber
;
1965 Worker function to execute a caller provided function on all enabled APs.
1967 @param[in] Procedure A pointer to the function to be run on
1968 enabled APs of the system.
1969 @param[in] SingleThread If TRUE, then all the enabled APs execute
1970 the function specified by Procedure one by
1971 one, in ascending order of processor handle
1972 number. If FALSE, then all the enabled APs
1973 execute the function specified by Procedure
1975 @param[in] WaitEvent The event created by the caller with CreateEvent()
1977 @param[in] TimeoutInMicroseconds Indicates the time limit in microseconds for
1978 APs to return from Procedure, either for
1979 blocking or non-blocking mode.
1980 @param[in] ProcedureArgument The parameter passed into Procedure for
1982 @param[out] FailedCpuList If all APs finish successfully, then its
1983 content is set to NULL. If not all APs
1984 finish before timeout expires, then its
1985 content is set to address of the buffer
1986 holding handle numbers of the failed APs.
1988 @retval EFI_SUCCESS In blocking mode, all APs have finished before
1989 the timeout expired.
1990 @retval EFI_SUCCESS In non-blocking mode, function has been dispatched
1992 @retval others Failed to Startup all APs.
1996 StartupAllAPsWorker (
1997 IN EFI_AP_PROCEDURE Procedure
,
1998 IN BOOLEAN SingleThread
,
1999 IN EFI_EVENT WaitEvent OPTIONAL
,
2000 IN UINTN TimeoutInMicroseconds
,
2001 IN VOID
*ProcedureArgument OPTIONAL
,
2002 OUT UINTN
**FailedCpuList OPTIONAL
2006 CPU_MP_DATA
*CpuMpData
;
2007 UINTN ProcessorCount
;
2008 UINTN ProcessorNumber
;
2010 CPU_AP_DATA
*CpuData
;
2011 BOOLEAN HasEnabledAp
;
2014 CpuMpData
= GetCpuMpData ();
2016 if (FailedCpuList
!= NULL
) {
2017 *FailedCpuList
= NULL
;
2020 if (CpuMpData
->CpuCount
== 1) {
2021 return EFI_NOT_STARTED
;
2024 if (Procedure
== NULL
) {
2025 return EFI_INVALID_PARAMETER
;
2029 // Check whether caller processor is BSP
2031 MpInitLibWhoAmI (&CallerNumber
);
2032 if (CallerNumber
!= CpuMpData
->BspNumber
) {
2033 return EFI_DEVICE_ERROR
;
2039 CheckAndUpdateApsStatus ();
2041 ProcessorCount
= CpuMpData
->CpuCount
;
2042 HasEnabledAp
= FALSE
;
2044 // Check whether all enabled APs are idle.
2045 // If any enabled AP is not idle, return EFI_NOT_READY.
2047 for (ProcessorNumber
= 0; ProcessorNumber
< ProcessorCount
; ProcessorNumber
++) {
2048 CpuData
= &CpuMpData
->CpuData
[ProcessorNumber
];
2049 if (ProcessorNumber
!= CpuMpData
->BspNumber
) {
2050 ApState
= GetApState (CpuData
);
2051 if (ApState
!= CpuStateDisabled
) {
2052 HasEnabledAp
= TRUE
;
2053 if (ApState
!= CpuStateIdle
) {
2055 // If any enabled APs are busy, return EFI_NOT_READY.
2057 return EFI_NOT_READY
;
2063 if (!HasEnabledAp
) {
2065 // If no enabled AP exists, return EFI_NOT_STARTED.
2067 return EFI_NOT_STARTED
;
2070 CpuMpData
->StartCount
= 0;
2071 for (ProcessorNumber
= 0; ProcessorNumber
< ProcessorCount
; ProcessorNumber
++) {
2072 CpuData
= &CpuMpData
->CpuData
[ProcessorNumber
];
2073 CpuData
->Waiting
= FALSE
;
2074 if (ProcessorNumber
!= CpuMpData
->BspNumber
) {
2075 if (CpuData
->State
== CpuStateIdle
) {
2077 // Mark this processor as responsible for current calling.
2079 CpuData
->Waiting
= TRUE
;
2080 CpuMpData
->StartCount
++;
2085 CpuMpData
->Procedure
= Procedure
;
2086 CpuMpData
->ProcArguments
= ProcedureArgument
;
2087 CpuMpData
->SingleThread
= SingleThread
;
2088 CpuMpData
->FinishedCount
= 0;
2089 CpuMpData
->RunningCount
= 0;
2090 CpuMpData
->FailedCpuList
= FailedCpuList
;
2091 CpuMpData
->ExpectedTime
= CalculateTimeout (
2092 TimeoutInMicroseconds
,
2093 &CpuMpData
->CurrentTime
2095 CpuMpData
->TotalTime
= 0;
2096 CpuMpData
->WaitEvent
= WaitEvent
;
2098 if (!SingleThread
) {
2099 WakeUpAP (CpuMpData
, TRUE
, 0, Procedure
, ProcedureArgument
);
2101 for (ProcessorNumber
= 0; ProcessorNumber
< ProcessorCount
; ProcessorNumber
++) {
2102 if (ProcessorNumber
== CallerNumber
) {
2105 if (CpuMpData
->CpuData
[ProcessorNumber
].Waiting
) {
2106 WakeUpAP (CpuMpData
, FALSE
, ProcessorNumber
, Procedure
, ProcedureArgument
);
2112 Status
= EFI_SUCCESS
;
2113 if (WaitEvent
== NULL
) {
2115 Status
= CheckAllAPs ();
2116 } while (Status
== EFI_NOT_READY
);
2123 Worker function to let the caller get one enabled AP to execute a caller-provided
2126 @param[in] Procedure A pointer to the function to be run on
2127 enabled APs of the system.
2128 @param[in] ProcessorNumber The handle number of the AP.
2129 @param[in] WaitEvent The event created by the caller with CreateEvent()
2131 @param[in] TimeoutInMicroseconds Indicates the time limit in microseconds for
2132 APs to return from Procedure, either for
2133 blocking or non-blocking mode.
2134 @param[in] ProcedureArgument The parameter passed into Procedure for
2136 @param[out] Finished If AP returns from Procedure before the
2137 timeout expires, its content is set to TRUE.
2138 Otherwise, the value is set to FALSE.
2140 @retval EFI_SUCCESS In blocking mode, specified AP finished before
2141 the timeout expires.
2142 @retval others Failed to Startup AP.
2146 StartupThisAPWorker (
2147 IN EFI_AP_PROCEDURE Procedure
,
2148 IN UINTN ProcessorNumber
,
2149 IN EFI_EVENT WaitEvent OPTIONAL
,
2150 IN UINTN TimeoutInMicroseconds
,
2151 IN VOID
*ProcedureArgument OPTIONAL
,
2152 OUT BOOLEAN
*Finished OPTIONAL
2156 CPU_MP_DATA
*CpuMpData
;
2157 CPU_AP_DATA
*CpuData
;
2160 CpuMpData
= GetCpuMpData ();
2162 if (Finished
!= NULL
) {
2167 // Check whether caller processor is BSP
2169 MpInitLibWhoAmI (&CallerNumber
);
2170 if (CallerNumber
!= CpuMpData
->BspNumber
) {
2171 return EFI_DEVICE_ERROR
;
2175 // Check whether processor with the handle specified by ProcessorNumber exists
2177 if (ProcessorNumber
>= CpuMpData
->CpuCount
) {
2178 return EFI_NOT_FOUND
;
2182 // Check whether specified processor is BSP
2184 if (ProcessorNumber
== CpuMpData
->BspNumber
) {
2185 return EFI_INVALID_PARAMETER
;
2189 // Check parameter Procedure
2191 if (Procedure
== NULL
) {
2192 return EFI_INVALID_PARAMETER
;
2198 CheckAndUpdateApsStatus ();
2201 // Check whether specified AP is disabled
2203 if (GetApState (&CpuMpData
->CpuData
[ProcessorNumber
]) == CpuStateDisabled
) {
2204 return EFI_INVALID_PARAMETER
;
2208 // If WaitEvent is not NULL, execute in non-blocking mode.
2209 // BSP saves data for CheckAPsStatus(), and returns EFI_SUCCESS.
2210 // CheckAPsStatus() will check completion and timeout periodically.
2212 CpuData
= &CpuMpData
->CpuData
[ProcessorNumber
];
2213 CpuData
->WaitEvent
= WaitEvent
;
2214 CpuData
->Finished
= Finished
;
2215 CpuData
->ExpectedTime
= CalculateTimeout (TimeoutInMicroseconds
, &CpuData
->CurrentTime
);
2216 CpuData
->TotalTime
= 0;
2218 WakeUpAP (CpuMpData
, FALSE
, ProcessorNumber
, Procedure
, ProcedureArgument
);
2221 // If WaitEvent is NULL, execute in blocking mode.
2222 // BSP checks AP's state until it finishes or TimeoutInMicrosecsond expires.
2224 Status
= EFI_SUCCESS
;
2225 if (WaitEvent
== NULL
) {
2227 Status
= CheckThisAP (ProcessorNumber
);
2228 } while (Status
== EFI_NOT_READY
);
2235 Get pointer to CPU MP Data structure from GUIDed HOB.
2237 @return The pointer to CPU MP Data structure.
2240 GetCpuMpDataFromGuidedHob (
2244 EFI_HOB_GUID_TYPE
*GuidHob
;
2246 CPU_MP_DATA
*CpuMpData
;
2249 GuidHob
= GetFirstGuidHob (&mCpuInitMpLibHobGuid
);
2250 if (GuidHob
!= NULL
) {
2251 DataInHob
= GET_GUID_HOB_DATA (GuidHob
);
2252 CpuMpData
= (CPU_MP_DATA
*) (*(UINTN
*) DataInHob
);