SecurityPkg/TcgPei: Replace TpmCommLib with Tpm12DeviceLib

[mirror_edk2.git] / SecurityPkg / Tcg / TcgPei / TpmComm.h

/** @file\r
  The header file for TPM PEI driver.\r
  \r
Copyright (c) 2005 - 2016, 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 _TPM_COMM_H_\r
#define _TPM_COMM_H_\r
\r
#include <IndustryStandard/Tpm12.h>\r
#include <IndustryStandard/UefiTcgPlatform.h>\r
#include <Library/MemoryAllocationLib.h>\r
#include <Library/BaseCryptLib.h>\r
#include <Library/Tpm12DeviceLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/BaseLib.h>\r
#include <Library/BaseMemoryLib.h>\r
\r
#pragma pack(1)\r
\r
typedef struct {\r
  TPM_RQU_COMMAND_HDR   Hdr;\r
  TPM_STARTUP_TYPE      TpmSt;\r
} TPM_CMD_START_UP;\r
\r
typedef struct {\r
  TPM_RQU_COMMAND_HDR   Hdr;\r
} TPM_CMD_SELF_TEST;\r
\r
typedef struct {\r
  TPM_RQU_COMMAND_HDR   Hdr;\r
  UINT32                Capability;\r
  UINT32                CapabilityFlagSize;\r
  UINT32                CapabilityFlag;\r
} TPM_CMD_GET_CAPABILITY;\r
\r
typedef struct {\r
  TPM_RQU_COMMAND_HDR   Hdr;\r
  TPM_PCRINDEX          PcrIndex;\r
  TPM_DIGEST            TpmDigest;\r
} TPM_CMD_EXTEND;\r
\r
typedef struct {\r
  TPM_RQU_COMMAND_HDR   Hdr;\r
  TPM_PHYSICAL_PRESENCE PhysicalPresence;\r
} TPM_CMD_PHYSICAL_PRESENCE;\r
\r
#pragma pack()\r
\r
/**\r
  Send TPM_Startup command to TPM.\r
\r
  @param[in] PeiServices        Describes the list of possible PEI Services.\r
  @param[in] BootMode           Boot mode.  \r
\r
  @retval EFI_SUCCESS           Operation completed successfully.\r
  @retval EFI_TIMEOUT           The register can't run into the expected status in time.\r
  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.\r
  @retval EFI_DEVICE_ERROR      Unexpected device behavior.\r
\r
**/\r
EFI_STATUS\r
TpmCommStartup (\r
  IN      EFI_PEI_SERVICES          **PeiServices,\r
  IN      EFI_BOOT_MODE             BootMode\r
  );\r
\r
/**\r
  Send TPM_ContinueSelfTest command to TPM.\r
\r
  @param[in] PeiServices        Describes the list of possible PEI Services.\r
\r
  @retval EFI_SUCCESS           Operation completed successfully.\r
  @retval EFI_TIMEOUT           The register can't run into the expected status in time.\r
  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.\r
  @retval EFI_DEVICE_ERROR      Unexpected device behavior.\r
\r
**/\r
EFI_STATUS\r
TpmCommContinueSelfTest (\r
  IN      EFI_PEI_SERVICES          **PeiServices\r
  );\r
\r
/**\r
  Get TPM capability flags.\r
\r
  @param[in]  PeiServices       Describes the list of possible PEI Services.\r
  @param[in]  TpmHandle         TPM handle.  \r
  @param[out] Deactivated       Returns deactivated flag.\r
  @param[out] LifetimeLock      Returns physicalPresenceLifetimeLock permanent flag.  \r
  @param[out] CmdEnable         Returns physicalPresenceCMDEnable permanent flag.\r
 \r
  @retval EFI_SUCCESS           Operation completed successfully.\r
  @retval EFI_TIMEOUT           The register can't run into the expected status in time.\r
  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.\r
  @retval EFI_DEVICE_ERROR      Unexpected device behavior.\r
\r
**/\r
EFI_STATUS\r
TpmCommGetCapability (\r
  IN      EFI_PEI_SERVICES          **PeiServices,\r
     OUT  BOOLEAN                   *Deactivated, OPTIONAL\r
     OUT  BOOLEAN                   *LifetimeLock, OPTIONAL\r
     OUT  BOOLEAN                   *CmdEnable OPTIONAL\r
  );\r
\r
/**\r
  Extend a TPM PCR.\r
\r
  @param[in]  PeiServices       Describes the list of possible PEI Services.\r
  @param[in]  TpmHandle         TPM handle.  \r
  @param[in]  DigestToExtend    The 160 bit value representing the event to be recorded.  \r
  @param[in]  PcrIndex          The PCR to be updated.\r
  @param[out] NewPcrValue       New PCR value after extend.  \r
 \r
  @retval EFI_SUCCESS           Operation completed successfully.\r
  @retval EFI_TIMEOUT           The register can't run into the expected status in time.\r
  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.\r
  @retval EFI_DEVICE_ERROR      Unexpected device behavior.\r
\r
**/\r
EFI_STATUS\r
TpmCommExtend (\r
  IN      EFI_PEI_SERVICES          **PeiServices,\r
  IN      TPM_DIGEST                *DigestToExtend,\r
  IN      TPM_PCRINDEX              PcrIndex,\r
     OUT  TPM_DIGEST                *NewPcrValue\r
  );\r
\r
\r
/**\r
  Send TSC_PhysicalPresence command to TPM.\r
\r
  @param[in] PeiServices        Describes the list of possible PEI Services.\r
  @param[in] TpmHandle          TPM handle.  \r
  @param[in] PhysicalPresence   The state to set the TPMs Physical Presence flags.  \r
 \r
  @retval EFI_SUCCESS           Operation completed successfully.\r
  @retval EFI_TIMEOUT           The register can't run into the expected status in time.\r
  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.\r
  @retval EFI_DEVICE_ERROR      Unexpected device behavior.\r
\r
**/\r
EFI_STATUS\r
TpmCommPhysicalPresence (\r
  IN      EFI_PEI_SERVICES          **PeiServices,\r
  IN      TPM_PHYSICAL_PRESENCE     PhysicalPresence\r
  );\r
\r
/**\r
  Single function calculates SHA1 digest value for all raw data. It\r
  combines Sha1Init(), Sha1Update() and Sha1Final().\r
\r
  @param[in]  Data          Raw data to be digested.\r
  @param[in]  DataLen       Size of the raw data.\r
  @param[out] Digest        Pointer to a buffer that stores the final digest.\r
\r
  @retval     EFI_SUCCESS   Always successfully calculate the final digest.\r
**/\r
EFI_STATUS\r
EFIAPI\r
TpmCommHashAll (\r
  IN  CONST UINT8                   *Data,\r
  IN        UINTN                   DataLen,\r
  OUT       TPM_DIGEST              *Digest\r
  );\r
\r
#endif  // _TPM_COMM_H_\r