UefiCpuPkg/SecCore: Support EFI_PEI_CORE_FV_LOCATION_PPI

[mirror_edk2.git] / UefiCpuPkg / SecCore / SecMain.h

/** @file\r
  Master header file for SecCore.\r
\r
  Copyright (c) 2008 - 2019, Intel Corporation. All rights reserved.<BR>\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions of the BSD License\r
  which accompanies this distribution.  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#ifndef _SEC_CORE_H_\r
#define _SEC_CORE_H_\r
\r
#include <PiPei.h>\r
\r
#include <Ppi/SecPlatformInformation2.h>\r
#include <Ppi/TemporaryRamDone.h>\r
#include <Ppi/SecPerformance.h>\r
#include <Ppi/PeiCoreFvLocation.h>\r
\r
#include <Guid/FirmwarePerformance.h>\r
\r
#include <Library/DebugLib.h>\r
#include <Library/PcdLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/PlatformSecLib.h>\r
#include <Library/UefiCpuLib.h>\r
#include <Library/PeCoffGetEntryPointLib.h>\r
#include <Library/PeCoffExtraActionLib.h>\r
#include <Library/DebugAgentLib.h>\r
#include <Library/CpuExceptionHandlerLib.h>\r
#include <Library/ReportStatusCodeLib.h>\r
#include <Library/PeiServicesTablePointerLib.h>\r
#include <Library/HobLib.h>\r
#include <Library/PeiServicesLib.h>\r
\r
#define SEC_IDT_ENTRY_COUNT  34\r
\r
typedef struct _SEC_IDT_TABLE {\r
  //\r
  // Reserved 8 bytes preceding IDT to store EFI_PEI_SERVICES**, since IDT base\r
  // address should be 8-byte alignment.\r
  // Note: For IA32, only the 4 bytes immediately preceding IDT is used to store\r
  // EFI_PEI_SERVICES**\r
  //\r
  UINT64            PeiService;\r
  UINT64            IdtTable[SEC_IDT_ENTRY_COUNT];\r
} SEC_IDT_TABLE;\r
\r
/**\r
  TemporaryRamDone() disables the use of Temporary RAM. If present, this service is invoked\r
  by the PEI Foundation after the EFI_PEI_PERMANANT_MEMORY_INSTALLED_PPI is installed.\r
\r
  @retval EFI_SUCCESS           Use of Temporary RAM was disabled.\r
  @retval EFI_INVALID_PARAMETER Temporary RAM could not be disabled.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SecTemporaryRamDone (\r
  VOID\r
  );\r
\r
/**\r
  Entry point to the C language phase of SEC. After the SEC assembly\r
  code has initialized some temporary memory and set up the stack,\r
  the control is transferred to this function.\r
\r
  @param SizeOfRam           Size of the temporary memory available for use.\r
  @param TempRamBase         Base address of temporary ram\r
  @param BootFirmwareVolume  Base address of the Boot Firmware Volume.\r
**/\r
VOID\r
NORETURN\r
EFIAPI\r
SecStartup (\r
  IN UINT32                   SizeOfRam,\r
  IN UINT32                   TempRamBase,\r
  IN VOID                     *BootFirmwareVolume\r
  );\r
\r
/**\r
  Find and return Pei Core entry point.\r
\r
  It also find SEC and PEI Core file debug information. It will report them if\r
  remote debug is enabled.\r
\r
  @param  BootFirmwareVolumePtr  Point to the boot firmware volume.\r
  @param  PeiCoreEntryPoint      Point to the PEI core entry point.\r
\r
**/\r
VOID\r
EFIAPI\r
FindAndReportEntryPoints (\r
  IN  EFI_FIRMWARE_VOLUME_HEADER       *BootFirmwareVolumePtr,\r
  OUT EFI_PEI_CORE_ENTRY_POINT         *PeiCoreEntryPoint\r
  );\r
\r
/**\r
  Auto-generated function that calls the library constructors for all of the module's\r
  dependent libraries.  This function must be called by the SEC Core once a stack has\r
  been established.\r
\r
**/\r
VOID\r
EFIAPI\r
ProcessLibraryConstructorList (\r
  VOID\r
  );\r
\r
/**\r
  Implementation of the PlatformInformation service in EFI_SEC_PLATFORM_INFORMATION_PPI.\r
\r
  @param  PeiServices                Pointer to the PEI Services Table.\r
  @param  StructureSize              Pointer to the variable describing size of the input buffer.\r
  @param  PlatformInformationRecord  Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.\r
\r
  @retval EFI_SUCCESS                The data was successfully returned.\r
  @retval EFI_BUFFER_TOO_SMALL       The buffer was too small.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SecPlatformInformationBist (\r
  IN CONST EFI_PEI_SERVICES                  **PeiServices,\r
  IN OUT UINT64                              *StructureSize,\r
     OUT EFI_SEC_PLATFORM_INFORMATION_RECORD *PlatformInformationRecord\r
  );\r
\r
/**\r
  Implementation of the PlatformInformation2 service in EFI_SEC_PLATFORM_INFORMATION2_PPI.\r
\r
  @param  PeiServices                The pointer to the PEI Services Table.\r
  @param  StructureSize              The pointer to the variable describing size of the input buffer.\r
  @param  PlatformInformationRecord2 The pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD2.\r
\r
  @retval EFI_SUCCESS                The data was successfully returned.\r
  @retval EFI_BUFFER_TOO_SMALL       The buffer was too small. The current buffer size needed to\r
                                     hold the record is returned in StructureSize.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SecPlatformInformation2Bist (\r
  IN CONST EFI_PEI_SERVICES                   **PeiServices,\r
  IN OUT UINT64                               *StructureSize,\r
     OUT EFI_SEC_PLATFORM_INFORMATION_RECORD2 *PlatformInformationRecord2\r
  );\r
\r
/**\r
  Republish SecPlatformInformationPpi/SecPlatformInformation2Ppi.\r
\r
**/\r
VOID\r
RepublishSecPlatformInformationPpi (\r
  VOID\r
  );\r
\r
/**\r
  Entry point of the notification callback function itself within the PEIM.\r
  It is to get SEC performance data and build HOB to convey the SEC performance\r
  data to DXE phase.\r
\r
  @param  PeiServices      Indirect reference to the PEI Services Table.\r
  @param  NotifyDescriptor Address of the notification descriptor data structure.\r
  @param  Ppi              Address of the PPI that was installed.\r
\r
  @return Status of the notification.\r
          The status code returned from this function is ignored.\r
**/\r
EFI_STATUS\r
EFIAPI\r
SecPerformancePpiCallBack (\r
  IN EFI_PEI_SERVICES           **PeiServices,\r
  IN EFI_PEI_NOTIFY_DESCRIPTOR  *NotifyDescriptor,\r
  IN VOID                       *Ppi\r
  );\r
\r
#endif\r