UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm

[mirror_edk2.git] / ArmPkg / Include / Library / OemMiscLib.h

/** @file\r
*\r
*  Copyright (c) 2022, Ampere Computing LLC. All rights reserved.\r
*  Copyright (c) 2021, NUVIA Inc. All rights reserved.\r
*  Copyright (c) 2015, Hisilicon Limited. All rights reserved.\r
*  Copyright (c) 2015, Linaro Limited. All rights reserved.\r
*\r
*  SPDX-License-Identifier: BSD-2-Clause-Patent\r
*\r
**/\r
\r
#ifndef OEM_MISC_LIB_H_\r
#define OEM_MISC_LIB_H_\r
\r
#include <Uefi.h>\r
#include <IndustryStandard/SmBios.h>\r
\r
typedef enum {\r
  CpuCacheL1 = 1,\r
  CpuCacheL2,\r
  CpuCacheL3,\r
  CpuCacheL4,\r
  CpuCacheL5,\r
  CpuCacheL6,\r
  CpuCacheL7,\r
  CpuCacheLevelMax\r
} OEM_MISC_CPU_CACHE_LEVEL;\r
\r
typedef struct {\r
  UINT8     Voltage;       ///< Processor voltage\r
  UINT16    CurrentSpeed;  ///< Current clock speed in MHz\r
  UINT16    MaxSpeed;      ///< Maximum clock speed in MHz\r
  UINT16    ExternalClock; ///< External clock speed in MHz\r
  UINT16    CoreCount;     ///< Number of cores available\r
  UINT16    CoresEnabled;  ///< Number of cores enabled\r
  UINT16    ThreadCount;   ///< Number of threads per processor\r
} OEM_MISC_PROCESSOR_DATA;\r
\r
typedef enum {\r
  BiosVersionType00,\r
  ProductNameType01,\r
  SerialNumType01,\r
  UuidType01,\r
  SystemManufacturerType01,\r
  VersionType01,\r
  SkuNumberType01,\r
  FamilyType01,\r
  AssetTagType02,\r
  SerialNumberType02,\r
  BoardManufacturerType02,\r
  ProductNameType02,\r
  VersionType02,\r
  SkuNumberType02,\r
  ChassisLocationType02,\r
  AssetTagType03,\r
  SerialNumberType03,\r
  VersionType03,\r
  ChassisTypeType03,\r
  ManufacturerType03,\r
  SkuNumberType03,\r
  ProcessorPartNumType04,\r
  ProcessorSerialNumType04,\r
  ProcessorVersionType04,\r
  SmbiosHiiStringFieldMax\r
} OEM_MISC_SMBIOS_HII_STRING_FIELD;\r
\r
/*\r
 * The following are functions that the each platform needs to\r
 * implement in its OemMiscLib library.\r
 */\r
\r
/** Gets the CPU frequency of the specified processor.\r
\r
  @param ProcessorIndex Index of the processor to get the frequency for.\r
\r
  @return               CPU frequency in Hz\r
**/\r
UINTN\r
EFIAPI\r
OemGetCpuFreq (\r
  IN UINT8  ProcessorIndex\r
  );\r
\r
/** Gets information about the specified processor and stores it in\r
    the structures provided.\r
\r
  @param ProcessorIndex  Index of the processor to get the information for.\r
  @param ProcessorStatus Processor status.\r
  @param ProcessorCharacteristics Processor characteritics.\r
  @param MiscProcessorData        Miscellaneous processor information.\r
\r
  @return  TRUE on success, FALSE on failure.\r
**/\r
BOOLEAN\r
EFIAPI\r
OemGetProcessorInformation (\r
  IN UINTN                               ProcessorIndex,\r
  IN OUT PROCESSOR_STATUS_DATA           *ProcessorStatus,\r
  IN OUT PROCESSOR_CHARACTERISTIC_FLAGS  *ProcessorCharacteristics,\r
  IN OUT OEM_MISC_PROCESSOR_DATA         *MiscProcessorData\r
  );\r
\r
/** Gets information about the cache at the specified cache level.\r
\r
  @param ProcessorIndex The processor to get information for.\r
  @param CacheLevel     The cache level to get information for.\r
  @param DataCache  Whether the cache is a data cache.\r
  @param UnifiedCache Whether the cache is a unified cache.\r
  @param SmbiosCacheTable The SMBIOS Type7 cache information structure.\r
\r
  @return TRUE on success, FALSE on failure.\r
**/\r
BOOLEAN\r
EFIAPI\r
OemGetCacheInformation (\r
  IN UINT8                   ProcessorIndex,\r
  IN UINT8                   CacheLevel,\r
  IN BOOLEAN                 DataCache,\r
  IN BOOLEAN                 UnifiedCache,\r
  IN OUT SMBIOS_TABLE_TYPE7  *SmbiosCacheTable\r
  );\r
\r
/** Gets the maximum number of processors supported by the platform.\r
\r
  @return The maximum number of processors.\r
**/\r
UINT8\r
EFIAPI\r
OemGetMaxProcessors (\r
  VOID\r
  );\r
\r
/** Gets the type of chassis for the system.\r
\r
  @retval The type of the chassis.\r
**/\r
MISC_CHASSIS_TYPE\r
EFIAPI\r
OemGetChassisType (\r
  VOID\r
  );\r
\r
/** Returns whether the specified processor is present or not.\r
\r
  @param ProcessIndex The processor index to check.\r
\r
  @return TRUE is the processor is present, FALSE otherwise.\r
**/\r
BOOLEAN\r
EFIAPI\r
OemIsProcessorPresent (\r
  IN UINTN  ProcessorIndex\r
  );\r
\r
/** Updates the HII string for the specified field.\r
\r
  @param HiiHandle     The HII handle.\r
  @param TokenToUpdate The string to update.\r
  @param Field         The field to get information about.\r
**/\r
VOID\r
EFIAPI\r
OemUpdateSmbiosInfo (\r
  IN EFI_HII_HANDLE                    HiiHandle,\r
  IN EFI_STRING_ID                     TokenToUpdate,\r
  IN OEM_MISC_SMBIOS_HII_STRING_FIELD  Field\r
  );\r
\r
/** Fetches the Type 32 boot information status.\r
\r
  @return Boot status.\r
**/\r
MISC_BOOT_INFORMATION_STATUS_DATA_TYPE\r
EFIAPI\r
OemGetBootStatus (\r
  VOID\r
  );\r
\r
/** Fetches the chassis status when it was last booted.\r
\r
 @return Chassis status.\r
**/\r
MISC_CHASSIS_STATE\r
EFIAPI\r
OemGetChassisBootupState (\r
  VOID\r
  );\r
\r
/** Fetches the chassis power supply/supplies status when last booted.\r
\r
 @return Chassis power supply/supplies status.\r
**/\r
MISC_CHASSIS_STATE\r
EFIAPI\r
OemGetChassisPowerSupplyState (\r
  VOID\r
  );\r
\r
/** Fetches the chassis thermal status when last booted.\r
\r
 @return Chassis thermal status.\r
**/\r
MISC_CHASSIS_STATE\r
EFIAPI\r
OemGetChassisThermalState (\r
  VOID\r
  );\r
\r
/** Fetches the chassis security status when last booted.\r
\r
 @return Chassis security status.\r
**/\r
MISC_CHASSIS_SECURITY_STATE\r
EFIAPI\r
OemGetChassisSecurityStatus (\r
  VOID\r
  );\r
\r
/** Fetches the chassis height in RMUs (Rack Mount Units).\r
\r
  @return The height of the chassis.\r
**/\r
UINT8\r
EFIAPI\r
OemGetChassisHeight (\r
  VOID\r
  );\r
\r
/** Fetches the number of power cords.\r
\r
  @return The number of power cords.\r
**/\r
UINT8\r
EFIAPI\r
OemGetChassisNumPowerCords (\r
  VOID\r
  );\r
\r
/**\r
  Fetches the system UUID.\r
\r
  @param[out] SystemUuid     The pointer to the buffer to store the System UUID.\r
\r
**/\r
VOID\r
EFIAPI\r
OemGetSystemUuid (\r
  OUT GUID  *SystemUuid\r
  );\r
\r
/** Fetches the BIOS release.\r
\r
  @return The BIOS release.\r
**/\r
UINT16\r
EFIAPI\r
OemGetBiosRelease (\r
  VOID\r
  );\r
\r
/** Fetches the embedded controller firmware release.\r
\r
  @return The embedded controller firmware release.\r
**/\r
UINT16\r
EFIAPI\r
OemGetEmbeddedControllerFirmwareRelease (\r
  VOID\r
  );\r
\r
#endif // OEM_MISC_LIB_H_\r