Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / tpm2-tss / c27ac555778b75283206bfdc267a0845c74cb026
commitc27ac555778b75283206bfdc267a0845c74cb026[log] [tgz]
authorPhilip Tricca <philip.b.tricca@intel.com>Mon Apr 18 11:00:52 2016 -0700
committerPhilip Tricca <philip.b.tricca@intel.com>Mon Apr 18 20:20:47 2016 -0700
tree3f70e8529006ff071a33eaa0d34f0da09fe47e8f
parentb6617089e52d561f174678689d29ace94ba5308e [diff]
tss2_tcti.h: Add macros to simplify access to data in the common TCTI structure.

Accessing data in the common TCTI structure requires some acrobatics.
This takes the shape of a cast, some dereferencing and a pile of
parentheses. This makes simple things like a function invocation very
difficult to read. What's not as obvious is the safety of such
operations because it's easy to forget to check for error conditions.

The spec offers an example macro for invoking functions from the common
TCTI structure. This code uses that macro, adding support for the other
functions.

Signed-off-by: Philip Tricca <philip.b.tricca@intel.com>
1 file changed
tree: 3f70e8529006ff071a33eaa0d34f0da09fe47e8f
  1. common/
  2. include/
  3. resourcemgr/
  4. sysapi/
  5. tcti/
  6. test/
  7. .gitattributes
  8. .gitignore
  9. arch.md
  10. archandlayout.md
  11. bootstrap
  12. buildwindows.md
  13. ChangeLog
  14. configure.ac
  15. INSTALL
  16. layout.md
  17. LICENSE
  18. Makefile.am
  19. README.md
  20. run.md
  21. simulator.md
  22. TSS block diagram.png
  23. TSS layout.png
  24. tss.sln
  25. tss.vcxproj
README.md

TPM (Trusted Platform Module) 2.0 Software Stack (TSS):

This stack consists of the following layers from top to bottom:

  • Feature API (FAPI), see specification 0.12, (published but still in progress and unimplemented)
  • Enhanced System API (ESAPI), (specification in progress and unimplemented)
  • System API (SAPI), see 1.0 specification, (public, 0.97 implementation complete). This layer implements the system layer API level of the TSS 2.0 specification. These functions can be used to access all TPM 2.0 functions as described in Part 3 of the TPM 2.0 specification. The usefulness of this code extends to all users of the TPM, even those not planning to use the upper layers of the TSS.
  • TPM Command Transmission Interface (TCTI), used by SAPI to communicate with next lower layer (either the TAB/RM or TPM 2.0 device driver), see SAPI specification
  • Trusted Access Broker/Resource Manager (TAB/RM), see 0.91 specification, (public, implementation complete). This layer sits between the system API library code and the TPM. It is a daemon that handles all multi-process coordination and manages the TPM's internal resources transparently to applications.

Since the FAPI and ESAPI haven't been implemented yet, this repository only contains the SAPI and layers below it, plus a test application for exercising the SAPI.

The test application, tpmclient, tests many of the commands against the TPM 2.0 simulator. The tpmclient application can be altered and used as a sandbox to test and develop any TPM 2.0 command sequences, and provides an excellent development and learning vehicle.

Build and Installation Instructions:

Run Instructions

Architecture/Block Diagram

Code Layout

Resources

TPM 2.0 specifications can be found at Trusted Computing Group.