SecurityPkg/Library/TpmCommLib/TisPc.c File Reference


Functions

BOOLEAN TisPcPresenceCheck (IN TIS_PC_REGISTERS_PTR TisReg)
EFI_STATUS EFIAPI TisPcWaitRegisterBits (IN UINT8 *Register, IN UINT8 BitSet, IN UINT8 BitClear, IN UINT32 TimeOut)
EFI_STATUS EFIAPI TisPcReadBurstCount (IN TIS_PC_REGISTERS_PTR TisReg, OUT UINT16 *BurstCount)
EFI_STATUS EFIAPI TisPcPrepareCommand (IN TIS_PC_REGISTERS_PTR TisReg)
EFI_STATUS EFIAPI TisPcRequestUseTpm (IN TIS_PC_REGISTERS_PTR TisReg)

Detailed Description

Basic TIS (TPM Interface Specification) functions.

Copyright (c) 2005 - 2012, Intel Corporation. All rights reserved.
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.


Function Documentation

EFI_STATUS EFIAPI TisPcPrepareCommand ( IN TIS_PC_REGISTERS_PTR  TisReg  ) 

Set TPM chip to ready state by sending ready command TIS_PC_STS_READY to Status Register in time.

Parameters:
[in] TisReg Pointer to TIS register.
Return values:
EFI_SUCCESS TPM chip enters into ready state.
EFI_INVALID_PARAMETER TisReg is NULL.
EFI_TIMEOUT TPM chip can't be set to ready state in time.

References EFI_STATUS(), TIS_PC_STS_READY, TIS_TIMEOUT_B, TisPcWaitRegisterBits(), and UINTN().

Referenced by TisPcSend(), and TisTpmCommand().

BOOLEAN TisPcPresenceCheck ( IN TIS_PC_REGISTERS_PTR  TisReg  ) 

Check whether TPM chip exist.

Parameters:
[in] TisReg Pointer to TIS register.
Return values:
TRUE TPM chip exists.
FALSE TPM chip is not found.

References BOOLEAN(), and UINTN().

EFI_STATUS EFIAPI TisPcReadBurstCount ( IN TIS_PC_REGISTERS_PTR  TisReg,
OUT UINT16 *  BurstCount 
)

Get BurstCount by reading the burstCount field of a TIS regiger in the time of default TIS_TIMEOUT_D.

Parameters:
[in] TisReg Pointer to TIS register.
[out] BurstCount Pointer to a buffer to store the got BurstConut.
Return values:
EFI_SUCCESS Get BurstCount.
EFI_INVALID_PARAMETER TisReg is NULL or BurstCount is NULL.
EFI_TIMEOUT BurstCount can't be got in time.

References TIS_TIMEOUT_D, and UINTN().

Referenced by TisPcReceive(), TisPcSend(), and TisTpmCommand().

EFI_STATUS EFIAPI TisPcRequestUseTpm ( IN TIS_PC_REGISTERS_PTR  TisReg  ) 

Get the control of TPM chip by sending requestUse command TIS_PC_ACC_RQUUSE to ACCESS Register in the time of default TIS_TIMEOUT_A.

Parameters:
[in] TisReg Pointer to TIS register.
Return values:
EFI_SUCCESS Get the control of TPM chip.
EFI_INVALID_PARAMETER TisReg is NULL.
EFI_NOT_FOUND TPM chip doesn't exit.
EFI_TIMEOUT Can't get the TPM control in time.

References EFI_STATUS(), TIS_PC_ACC_ACTIVE, TIS_PC_ACC_RQUUSE, TIS_PC_VALID, TIS_TIMEOUT_A, TisPcPresenceCheck(), TisPcWaitRegisterBits(), and UINTN().

Referenced by DriverEntry(), DTpm2RequestUseTpm(), PeimEntryMA(), PeimEntryMP(), and TcgConfigDriverEntryPoint().

EFI_STATUS EFIAPI TisPcWaitRegisterBits ( IN UINT8 *  Register,
IN UINT8  BitSet,
IN UINT8  BitClear,
IN UINT32  TimeOut 
)

Check whether the value of a TPM chip register satisfies the input BIT setting.

Parameters:
[in] Register Address port of register to be checked.
[in] BitSet Check these data bits are set.
[in] BitClear Check these data bits are clear.
[in] TimeOut The max wait time (unit MicroSecond) when checking register.
Return values:
EFI_SUCCESS The register satisfies the check bit.
EFI_TIMEOUT The register can't run into the expected status in time.

References UINTN().

Referenced by TisPcPrepareCommand(), TisPcReceive(), TisPcRequestUseTpm(), TisPcSend(), and TisTpmCommand().


Generated on Thu Sep 24 23:44:24 2015 for SecurityPkg[ALL] by  doxygen 1.5.7.1