2 Update and publish processors' BIST information.
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.
17 EFI_SEC_PLATFORM_INFORMATION2_PPI mSecPlatformInformation2Ppi
= {
18 SecPlatformInformation2
21 EFI_PEI_PPI_DESCRIPTOR mPeiSecPlatformInformation2Ppi
= {
22 (EFI_PEI_PPI_DESCRIPTOR_PPI
| EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST
),
23 &gEfiSecPlatformInformation2PpiGuid
,
24 &mSecPlatformInformation2Ppi
28 Implementation of the PlatformInformation2 service in EFI_SEC_PLATFORM_INFORMATION2_PPI.
30 @param PeiServices The pointer to the PEI Services Table.
31 @param StructureSize The pointer to the variable describing size of the input buffer.
32 @param PlatformInformationRecord2 The pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD2.
34 @retval EFI_SUCCESS The data was successfully returned.
35 @retval EFI_BUFFER_TOO_SMALL The buffer was too small. The current buffer size needed to
36 hold the record is returned in StructureSize.
41 SecPlatformInformation2 (
42 IN CONST EFI_PEI_SERVICES
**PeiServices
,
43 IN OUT UINT64
*StructureSize
,
44 OUT EFI_SEC_PLATFORM_INFORMATION_RECORD2
*PlatformInformationRecord2
47 EFI_HOB_GUID_TYPE
*GuidHob
;
51 GuidHob
= GetFirstGuidHob (&gEfiSecPlatformInformation2PpiGuid
);
52 if (GuidHob
== NULL
) {
57 DataInHob
= GET_GUID_HOB_DATA (GuidHob
);
58 DataSize
= GET_GUID_HOB_DATA_SIZE (GuidHob
);
61 // return the information from BistHob
63 if ((*StructureSize
) < (UINT64
) DataSize
) {
64 *StructureSize
= (UINT64
) DataSize
;
65 return EFI_BUFFER_TOO_SMALL
;
68 *StructureSize
= (UINT64
) DataSize
;
69 CopyMem (PlatformInformationRecord2
, DataInHob
, DataSize
);
74 Worker function to get CPUs' BIST by calling SecPlatformInformationPpi
75 or SecPlatformInformation2Ppi.
77 @param PeiServices Pointer to PEI Services Table
79 @param PpiDescriptor Return a pointer to instance of the
80 EFI_PEI_PPI_DESCRIPTOR
81 @param BistInformationData Pointer to BIST information data
82 @param BistInformationSize Return the size in bytes of BIST information
84 @retval EFI_SUCCESS Retrieve of the BIST data successfully
85 @retval EFI_NOT_FOUND No sec platform information(2) ppi export
86 @retval EFI_DEVICE_ERROR Failed to get CPU Information
91 IN CONST EFI_PEI_SERVICES
**PeiServices
,
92 IN CONST EFI_GUID
*Guid
,
93 OUT EFI_PEI_PPI_DESCRIPTOR
**PpiDescriptor
,
94 OUT VOID
**BistInformationData
,
95 OUT UINT64
*BistInformationSize OPTIONAL
99 EFI_SEC_PLATFORM_INFORMATION2_PPI
*SecPlatformInformation2Ppi
;
100 EFI_SEC_PLATFORM_INFORMATION_RECORD2
*SecPlatformInformation2
;
101 UINT64 InformationSize
;
103 Status
= PeiServicesLocatePpi (
106 PpiDescriptor
, // EFI_PEI_PPI_DESCRIPTOR
107 (VOID
**)&SecPlatformInformation2Ppi
// PPI
109 if (Status
== EFI_NOT_FOUND
) {
110 return EFI_NOT_FOUND
;
113 if (Status
== EFI_SUCCESS
) {
115 // Get the size of the sec platform information2(BSP/APs' BIST data)
118 SecPlatformInformation2
= NULL
;
119 Status
= SecPlatformInformation2Ppi
->PlatformInformation2 (
122 SecPlatformInformation2
124 if (Status
== EFI_BUFFER_TOO_SMALL
) {
125 Status
= PeiServicesAllocatePool (
126 (UINTN
) InformationSize
,
127 (VOID
**) &SecPlatformInformation2
129 if (Status
== EFI_SUCCESS
) {
131 // Retrieve BIST data
133 Status
= SecPlatformInformation2Ppi
->PlatformInformation2 (
136 SecPlatformInformation2
138 if (Status
== EFI_SUCCESS
) {
139 *BistInformationData
= SecPlatformInformation2
;
140 if (BistInformationSize
!= NULL
) {
141 *BistInformationSize
= InformationSize
;
149 return EFI_DEVICE_ERROR
;
153 Collects BIST data from PPI.
155 This function collects BIST data from Sec Platform Information2 PPI
156 or SEC Platform Information PPI.
158 @param PeiServices Pointer to PEI Services Table
162 CollectBistDataFromPpi (
163 IN CONST EFI_PEI_SERVICES
**PeiServices
167 EFI_PEI_PPI_DESCRIPTOR
*SecInformationDescriptor
;
168 EFI_SEC_PLATFORM_INFORMATION_RECORD2
*SecPlatformInformation2
;
169 EFI_SEC_PLATFORM_INFORMATION_RECORD
*SecPlatformInformation
;
171 EFI_SEC_PLATFORM_INFORMATION_CPU
*CpuInstance
;
172 EFI_SEC_PLATFORM_INFORMATION_CPU BspCpuInstance
;
173 UINTN ProcessorNumber
;
175 EFI_PROCESSOR_INFORMATION ProcessorInfo
;
176 EFI_HEALTH_FLAGS BistData
;
177 UINTN NumberOfProcessors
;
178 UINTN NumberOfEnabledProcessors
;
179 UINTN BistInformationSize
;
180 EFI_SEC_PLATFORM_INFORMATION_RECORD2
*PlatformInformationRecord2
;
181 EFI_SEC_PLATFORM_INFORMATION_CPU
*CpuInstanceInHob
;
184 MpInitLibGetNumberOfProcessors(&NumberOfProcessors
, &NumberOfEnabledProcessors
);
186 BistInformationSize
= sizeof (EFI_SEC_PLATFORM_INFORMATION_RECORD2
) +
187 sizeof (EFI_SEC_PLATFORM_INFORMATION_CPU
) * NumberOfProcessors
;
188 Status
= PeiServicesAllocatePool (
189 (UINTN
) BistInformationSize
,
190 (VOID
**) &PlatformInformationRecord2
192 ASSERT_EFI_ERROR (Status
);
193 PlatformInformationRecord2
->NumberOfCpus
= (UINT32
)NumberOfProcessors
;
195 SecPlatformInformation2
= NULL
;
196 SecPlatformInformation
= NULL
;
200 // Get BIST information from Sec Platform Information2 Ppi firstly
202 Status
= GetBistInfoFromPpi (
204 &gEfiSecPlatformInformation2PpiGuid
,
205 &SecInformationDescriptor
,
206 (VOID
*) &SecPlatformInformation2
,
209 if (Status
== EFI_SUCCESS
) {
211 // Sec Platform Information2 PPI includes BSP/APs' BIST information
213 NumberOfData
= SecPlatformInformation2
->NumberOfCpus
;
214 CpuInstance
= SecPlatformInformation2
->CpuInstance
;
217 // Otherwise, get BIST information from Sec Platform Information Ppi
219 Status
= GetBistInfoFromPpi (
221 &gEfiSecPlatformInformationPpiGuid
,
222 &SecInformationDescriptor
,
223 (VOID
*) &SecPlatformInformation
,
226 if (Status
== EFI_SUCCESS
) {
229 // SEC Platform Information only includes BSP's BIST information
230 // and does not have BSP's APIC ID
232 BspCpuInstance
.CpuLocation
= GetInitialApicId ();
233 BspCpuInstance
.InfoRecord
.IA32HealthFlags
.Uint32
= SecPlatformInformation
->IA32HealthFlags
.Uint32
;
234 CpuInstance
= &BspCpuInstance
;
236 DEBUG ((EFI_D_INFO
, "Does not find any stored CPU BIST information from PPI!\n"));
239 for (ProcessorNumber
= 0; ProcessorNumber
< NumberOfProcessors
; ProcessorNumber
++) {
240 MpInitLibGetProcessorInfo (ProcessorNumber
, &ProcessorInfo
, &BistData
);
241 for (CpuIndex
= 0; CpuIndex
< NumberOfData
; CpuIndex
++) {
242 ASSERT (CpuInstance
!= NULL
);
243 if (ProcessorInfo
.ProcessorId
== CpuInstance
[CpuIndex
].CpuLocation
) {
245 // Update processor's BIST data if it is already stored before
247 BistData
= CpuInstance
[CpuIndex
].InfoRecord
.IA32HealthFlags
;
250 if (BistData
.Uint32
!= 0) {
252 // Report Status Code that self test is failed
255 EFI_ERROR_CODE
| EFI_ERROR_MAJOR
,
256 (EFI_COMPUTING_UNIT_HOST_PROCESSOR
| EFI_CU_HP_EC_SELF_TEST
)
259 DEBUG ((EFI_D_INFO
, " APICID - 0x%08x, BIST - 0x%08x\n",
260 (UINT32
) ProcessorInfo
.ProcessorId
,
263 CpuInstanceInHob
= PlatformInformationRecord2
->CpuInstance
;
264 CpuInstanceInHob
[ProcessorNumber
].CpuLocation
= (UINT32
) ProcessorInfo
.ProcessorId
;
265 CpuInstanceInHob
[ProcessorNumber
].InfoRecord
.IA32HealthFlags
= BistData
;
269 // Build SecPlatformInformation2 PPI GUIDed HOB that also could be consumed
270 // by CPU MP driver to get CPU BIST data
273 &gEfiSecPlatformInformation2PpiGuid
,
274 PlatformInformationRecord2
,
275 (UINTN
) BistInformationSize
278 if (SecPlatformInformation2
!= NULL
&& NumberOfData
< NumberOfProcessors
) {
280 // Reinstall SecPlatformInformation2 PPI to include new BIST information
282 Status
= PeiServicesReInstallPpi (
283 SecInformationDescriptor
,
284 &mPeiSecPlatformInformation2Ppi
286 ASSERT_EFI_ERROR (Status
);
289 // Install SecPlatformInformation2 PPI to include new BIST information
291 Status
= PeiServicesInstallPpi (&mPeiSecPlatformInformation2Ppi
);
292 ASSERT_EFI_ERROR(Status
);