/** @file | |
This library abstract how to access TPM2 hardware device. | |
Copyright (c) 2013, Intel Corporation. All rights reserved. <BR> | |
This program and the accompanying materials | |
are licensed and made available under the terms and conditions of the BSD License | |
which accompanies this distribution. The full text of the license may be found at | |
http://opensource.org/licenses/bsd-license.php | |
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, | |
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. | |
**/ | |
#ifndef _TPM2_DEVICE_LIB_H_ | |
#define _TPM2_DEVICE_LIB_H_ | |
#include <Uefi.h> | |
/** | |
This service enables the sending of commands to the TPM2. | |
@param[in] InputParameterBlockSize Size of the TPM2 input parameter block. | |
@param[in] InputParameterBlock Pointer to the TPM2 input parameter block. | |
@param[in,out] OutputParameterBlockSize Size of the TPM2 output parameter block. | |
@param[in] OutputParameterBlock Pointer to the TPM2 output parameter block. | |
@retval EFI_SUCCESS The command byte stream was successfully sent to the device and a response was successfully received. | |
@retval EFI_DEVICE_ERROR The command was not successfully sent to the device or a response was not successfully received from the device. | |
@retval EFI_BUFFER_TOO_SMALL The output parameter block is too small. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
Tpm2SubmitCommand ( | |
IN UINT32 InputParameterBlockSize, | |
IN UINT8 *InputParameterBlock, | |
IN OUT UINT32 *OutputParameterBlockSize, | |
IN UINT8 *OutputParameterBlock | |
); | |
/** | |
This service requests use TPM2. | |
@retval EFI_SUCCESS Get the control of TPM2 chip. | |
@retval EFI_NOT_FOUND TPM2 not found. | |
@retval EFI_DEVICE_ERROR Unexpected device behavior. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
Tpm2RequestUseTpm ( | |
VOID | |
); | |
/** | |
This service enables the sending of commands to the TPM2. | |
@param[in] InputParameterBlockSize Size of the TPM2 input parameter block. | |
@param[in] InputParameterBlock Pointer to the TPM2 input parameter block. | |
@param[in,out] OutputParameterBlockSize Size of the TPM2 output parameter block. | |
@param[in] OutputParameterBlock Pointer to the TPM2 output parameter block. | |
@retval EFI_SUCCESS The command byte stream was successfully sent to the device and a response was successfully received. | |
@retval EFI_DEVICE_ERROR The command was not successfully sent to the device or a response was not successfully received from the device. | |
@retval EFI_BUFFER_TOO_SMALL The output parameter block is too small. | |
**/ | |
typedef | |
EFI_STATUS | |
(EFIAPI *TPM2_SUBMIT_COMMAND) ( | |
IN UINT32 InputParameterBlockSize, | |
IN UINT8 *InputParameterBlock, | |
IN OUT UINT32 *OutputParameterBlockSize, | |
IN UINT8 *OutputParameterBlock | |
); | |
/** | |
This service requests use TPM2. | |
@retval EFI_SUCCESS Get the control of TPM2 chip. | |
@retval EFI_NOT_FOUND TPM2 not found. | |
@retval EFI_DEVICE_ERROR Unexpected device behavior. | |
**/ | |
typedef | |
EFI_STATUS | |
(EFIAPI *TPM2_REQUEST_USE_TPM) ( | |
VOID | |
); | |
typedef struct { | |
EFI_GUID ProviderGuid; | |
TPM2_SUBMIT_COMMAND Tpm2SubmitCommand; | |
TPM2_REQUEST_USE_TPM Tpm2RequestUseTpm; | |
} TPM2_DEVICE_INTERFACE; | |
/** | |
This service register TPM2 device. | |
@param Tpm2Device TPM2 device | |
@retval EFI_SUCCESS This TPM2 device is registered successfully. | |
@retval EFI_UNSUPPORTED System does not support register this TPM2 device. | |
@retval EFI_ALREADY_STARTED System already register this TPM2 device. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
Tpm2RegisterTpm2DeviceLib ( | |
IN TPM2_DEVICE_INTERFACE *Tpm2Device | |
); | |
#endif |