2 Master header file for SecCore.
4 Copyright (c) 2008 - 2019, Intel Corporation. All rights reserved.<BR>
5 SPDX-License-Identifier: BSD-2-Clause-Patent
14 #include <Ppi/SecPlatformInformation2.h>
15 #include <Ppi/TemporaryRamDone.h>
16 #include <Ppi/SecPerformance.h>
17 #include <Ppi/PeiCoreFvLocation.h>
18 #include <Ppi/RepublishSecPpi.h>
20 #include <Guid/FirmwarePerformance.h>
22 #include <Library/DebugLib.h>
23 #include <Library/PcdLib.h>
24 #include <Library/BaseMemoryLib.h>
25 #include <Library/PlatformSecLib.h>
26 #include <Library/CpuLib.h>
27 #include <Library/UefiCpuLib.h>
28 #include <Library/PeCoffGetEntryPointLib.h>
29 #include <Library/PeCoffExtraActionLib.h>
30 #include <Library/DebugAgentLib.h>
31 #include <Library/CpuExceptionHandlerLib.h>
32 #include <Library/ReportStatusCodeLib.h>
33 #include <Library/PeiServicesTablePointerLib.h>
34 #include <Library/HobLib.h>
35 #include <Library/PeiServicesLib.h>
37 #define SEC_IDT_ENTRY_COUNT 34
39 typedef struct _SEC_IDT_TABLE
{
41 // Reserved 8 bytes preceding IDT to store EFI_PEI_SERVICES**, since IDT base
42 // address should be 8-byte alignment.
43 // Note: For IA32, only the 4 bytes immediately preceding IDT is used to store
47 UINT64 IdtTable
[SEC_IDT_ENTRY_COUNT
];
51 TemporaryRamDone() disables the use of Temporary RAM. If present, this service is invoked
52 by the PEI Foundation after the EFI_PEI_PERMANANT_MEMORY_INSTALLED_PPI is installed.
54 @retval EFI_SUCCESS Use of Temporary RAM was disabled.
55 @retval EFI_INVALID_PARAMETER Temporary RAM could not be disabled.
65 Entry point to the C language phase of SEC. After the SEC assembly
66 code has initialized some temporary memory and set up the stack,
67 the control is transferred to this function.
69 @param SizeOfRam Size of the temporary memory available for use.
70 @param TempRamBase Base address of temporary ram
71 @param BootFirmwareVolume Base address of the Boot Firmware Volume.
78 IN UINT32 TempRamBase
,
79 IN VOID
*BootFirmwareVolume
83 Find and return Pei Core entry point.
85 It also find SEC and PEI Core file debug information. It will report them if
86 remote debug is enabled.
88 @param SecCoreFirmwareVolumePtr Point to the firmware volume for finding SecCore.
89 @param PeiCoreFirmwareVolumePtr Point to the firmware volume for finding PeiCore.
90 @param PeiCoreEntryPoint The entry point of the PEI core.
95 FindAndReportEntryPoints (
96 IN EFI_FIRMWARE_VOLUME_HEADER
*SecCoreFirmwareVolumePtr
,
97 IN EFI_FIRMWARE_VOLUME_HEADER
*PeiCoreFirmwareVolumePtr
,
98 OUT EFI_PEI_CORE_ENTRY_POINT
*PeiCoreEntryPoint
102 Auto-generated function that calls the library constructors for all of the module's
103 dependent libraries. This function must be called by the SEC Core once a stack has
109 ProcessLibraryConstructorList (
114 Implementation of the PlatformInformation service in EFI_SEC_PLATFORM_INFORMATION_PPI.
116 @param PeiServices Pointer to the PEI Services Table.
117 @param StructureSize Pointer to the variable describing size of the input buffer.
118 @param PlatformInformationRecord Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.
120 @retval EFI_SUCCESS The data was successfully returned.
121 @retval EFI_BUFFER_TOO_SMALL The buffer was too small.
126 SecPlatformInformationBist (
127 IN CONST EFI_PEI_SERVICES
**PeiServices
,
128 IN OUT UINT64
*StructureSize
,
129 OUT EFI_SEC_PLATFORM_INFORMATION_RECORD
*PlatformInformationRecord
133 Implementation of the PlatformInformation2 service in EFI_SEC_PLATFORM_INFORMATION2_PPI.
135 @param PeiServices The pointer to the PEI Services Table.
136 @param StructureSize The pointer to the variable describing size of the input buffer.
137 @param PlatformInformationRecord2 The pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD2.
139 @retval EFI_SUCCESS The data was successfully returned.
140 @retval EFI_BUFFER_TOO_SMALL The buffer was too small. The current buffer size needed to
141 hold the record is returned in StructureSize.
146 SecPlatformInformation2Bist (
147 IN CONST EFI_PEI_SERVICES
**PeiServices
,
148 IN OUT UINT64
*StructureSize
,
149 OUT EFI_SEC_PLATFORM_INFORMATION_RECORD2
*PlatformInformationRecord2
153 Republish SecPlatformInformationPpi/SecPlatformInformation2Ppi.
157 RepublishSecPlatformInformationPpi (
162 Entry point of the notification callback function itself within the PEIM.
163 It is to get SEC performance data and build HOB to convey the SEC performance
166 @param PeiServices Indirect reference to the PEI Services Table.
167 @param NotifyDescriptor Address of the notification descriptor data structure.
168 @param Ppi Address of the PPI that was installed.
170 @return Status of the notification.
171 The status code returned from this function is ignored.
175 SecPerformancePpiCallBack (
176 IN EFI_PEI_SERVICES
**PeiServices
,
177 IN EFI_PEI_NOTIFY_DESCRIPTOR
*NotifyDescriptor
,