2 Definitions to install Multiple Processor PPI.
4 Copyright (c) 2015, 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.
15 #ifndef _CPU_MP_PEI_H_
16 #define _CPU_MP_PEI_H_
20 #include <Ppi/MpServices.h>
21 #include <Ppi/SecPlatformInformation.h>
22 #include <Ppi/SecPlatformInformation2.h>
23 #include <Ppi/EndOfPeiPhase.h>
25 #include <Register/Cpuid.h>
26 #include <Register/LocalApic.h>
28 #include <Library/BaseLib.h>
29 #include <Library/BaseMemoryLib.h>
30 #include <Library/DebugLib.h>
31 #include <Library/HobLib.h>
32 #include <Library/LocalApicLib.h>
33 #include <Library/MtrrLib.h>
34 #include <Library/PcdLib.h>
35 #include <Library/PeimEntryPoint.h>
36 #include <Library/PeiServicesLib.h>
37 #include <Library/ReportStatusCodeLib.h>
38 #include <Library/SynchronizationLib.h>
39 #include <Library/TimerLib.h>
40 #include <Library/UefiCpuLib.h>
42 #include "Microcode.h"
54 // AP reset code information
57 UINT8
*RendezvousFunnelAddress
;
58 UINTN PModeEntryOffset
;
59 UINTN LModeEntryOffset
;
60 UINTN RendezvousFunnelSize
;
61 } MP_ASSEMBLY_ADDRESS_MAP
;
64 // CPU exchange information for switch BSP
67 UINT8 State
; // offset 0
68 UINTN StackPointer
; // offset 4 / 8
69 IA32_DESCRIPTOR Gdtr
; // offset 8 / 16
70 IA32_DESCRIPTOR Idtr
; // offset 14 / 26
71 } CPU_EXCHANGE_ROLE_INFO
;
73 typedef struct _PEI_CPU_MP_DATA PEI_CPU_MP_DATA
;
89 UINT32 DefaultSize
: 1;
90 UINT32 Granularity
: 1;
97 // MP CPU exchange information for AP reset code
104 IA32_DESCRIPTOR GdtrProfile
;
105 IA32_DESCRIPTOR IdtrProfile
;
108 UINTN NumApsExecuting
;
111 PEI_CPU_MP_DATA
*PeiCpuMpData
;
112 } MP_CPU_EXCHANGE_INFO
;
118 EFI_HEALTH_FLAGS Health
;
124 // PEI CPU MP Data save in memory
126 struct _PEI_CPU_MP_DATA
{
130 UINTN CpuApStackSize
;
131 MP_ASSEMBLY_ADDRESS_MAP AddressMap
;
134 UINTN BackupBufferSize
;
136 UINTN ApFunctionArgument
;
137 volatile UINT32 FinishedCount
;
138 BOOLEAN EndOfPeiFlag
;
140 CPU_EXCHANGE_ROLE_INFO BSPInfo
;
141 CPU_EXCHANGE_ROLE_INFO APInfo
;
142 MTRR_SETTINGS MtrrTable
;
143 PEI_CPU_DATA
*CpuData
;
144 volatile MP_CPU_EXCHANGE_INFO
*MpCpuExchangeInfo
;
146 extern EFI_PEI_PPI_DESCRIPTOR mPeiCpuMpPpiDesc
;
150 Assembly code to get starting address and size of the rendezvous entry for APs.
151 Information for fixing a jump instruction in the code is also returned.
153 @param AddressMap Output buffer for address map information.
158 OUT MP_ASSEMBLY_ADDRESS_MAP
*AddressMap
162 Assembly code to load GDT table and update segment accordingly.
164 @param Gdtr Pointer to GDT descriptor
169 IN IA32_DESCRIPTOR
*Gdtr
173 Assembly code to do CLI-HALT loop.
183 Get available system memory below 1MB by specified size.
185 @param PeiCpuMpData Pointer to PEI CPU MP Data
188 BackupAndPrepareWakeupBuffer(
189 IN PEI_CPU_MP_DATA
*PeiCpuMpData
193 Restore wakeup buffer data.
195 @param PeiCpuMpData Pointer to PEI CPU MP Data
199 IN PEI_CPU_MP_DATA
*PeiCpuMpData
203 Notify function on End Of Pei PPI.
205 On S3 boot, this function will restore wakeup buffer data.
206 On normal boot, this function will flag wakeup buffer to be un-used type.
208 @param PeiServices The pointer to the PEI Services Table.
209 @param NotifyDescriptor Address of the notification descriptor data structure.
210 @param Ppi Address of the PPI that was installed.
212 @retval EFI_SUCCESS When everything is OK.
217 CpuMpEndOfPeiCallback (
218 IN EFI_PEI_SERVICES
**PeiServices
,
219 IN EFI_PEI_NOTIFY_DESCRIPTOR
*NotifyDescriptor
,
224 This function will be called by BSP to wakeup AP.
226 @param PeiCpuMpData Pointer to PEI CPU MP Data
227 @param Broadcast TRUE: Send broadcast IPI to all APs
228 FALSE: Send IPI to AP by ApicId
229 @param ApicId Apic ID for the processor to be waked
230 @param Procedure The function to be invoked by AP
231 @param ProcedureArgument The argument to be passed into AP function
235 IN PEI_CPU_MP_DATA
*PeiCpuMpData
,
236 IN BOOLEAN Broadcast
,
238 IN EFI_AP_PROCEDURE Procedure
, OPTIONAL
239 IN VOID
*ProcedureArgument OPTIONAL
243 Get CPU MP Data pointer from the Guided HOB.
245 @return Pointer to Pointer to PEI CPU MP Data
253 Find the current Processor number by APIC ID.
255 @param PeiCpuMpData Pointer to PEI CPU MP Data
256 @param ProcessorNumber Return the pocessor number found
258 @retval EFI_SUCCESS ProcessorNumber is found and returned.
259 @retval EFI_NOT_FOUND ProcessorNumber is not found.
263 IN PEI_CPU_MP_DATA
*PeiCpuMpData
,
264 OUT UINTN
*ProcessorNumber
268 Collects BIST data from PPI.
270 This function collects BIST data from Sec Platform Information2 PPI
271 or SEC Platform Information PPI.
273 @param PeiServices Pointer to PEI Services Table
274 @param PeiCpuMpData Pointer to PEI CPU MP Data
278 CollectBistDataFromPpi (
279 IN CONST EFI_PEI_SERVICES
**PeiServices
,
280 IN PEI_CPU_MP_DATA
*PeiCpuMpData
284 Implementation of the PlatformInformation2 service in EFI_SEC_PLATFORM_INFORMATION2_PPI.
286 @param PeiServices The pointer to the PEI Services Table.
287 @param StructureSize The pointer to the variable describing size of the input buffer.
288 @param PlatformInformationRecord2 The pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD2.
290 @retval EFI_SUCCESS The data was successfully returned.
291 @retval EFI_BUFFER_TOO_SMALL The buffer was too small. The current buffer size needed to
292 hold the record is returned in StructureSize.
297 SecPlatformInformation2 (
298 IN CONST EFI_PEI_SERVICES
**PeiServices
,
299 IN OUT UINT64
*StructureSize
,
300 OUT EFI_SEC_PLATFORM_INFORMATION_RECORD2
*PlatformInformationRecord2