commit	085d79278681838b94376ebc15ca58a58824d684	[log] [tgz]
author	DavidWooten <david.wooten@ieee.org>	Fri Jul 26 21:51:34 2019 -0400
committer	DavidWooten <david.wooten@ieee.org>	Fri Jul 26 21:51:34 2019 -0400
tree	286bae4ce2aa1de45149cdaa3292dbdcb2a4e92d
parent	777151ffbf3cddf0dd80bc4f6788a22d9caa9c45 [diff]
parent	b12fbfab872eb24578657d11e457fc684f70e206 [diff]

tree: 286bae4ce2aa1de45149cdaa3292dbdcb2a4e92d

README.md

MS TPM 2.0 Reference Implementation

This is the official TCG reference implementation of the TPM 2.0 Specification. The project contains complete source code of the reference implementation with a Microsoft Visual Studio solution and Linux autotools build scripts.

See the definition of the SPEC_VERSION, SPEC_YEAR and SPEC_DAY_OF_YEAR values in the TpmTypes.h header for the exact revision/date of the TPM 2.0 specification, which the given source tree snapshot corresponds to.

Visual Studio build

Before building the Visual Studio solution:

Uncomment and update the definitions of the following macros in the VendorString.h header:

MANUFACTURER
VENDOR_STRING_1
FIRMWARE_V1 and FIRMWARE_V2

Setup the underlying cryptographic library:

OpenSSL library

Create TPMCmd/lib folder and place a static OpenSSL library (libeay32.lib or libcrypto.lib) there. This may be either complete static library, or import library accompanying the corresponding DLL. In the latter case you'll need to copy the OpenSSL DLL into the standard Windows search path, so that it is available when you run the simulator executable (e.g. copy it into the same folder where simulator.exe is located).
If you use libcrypto.lib, you'll need to either update Linker|Input|Additional Dependencies property of the Tpm project in the simulator solution or, alternatively, rename libcrypto.lib to libeay32.lib.
Recommended version of OpenSSL is 1.0.2d or higher.
Create TPMCmd/OsslInclude/openssl folder and copy there the contents of the openssl/include/openssl folder of the OpenSSL source tree used to build the static library used on the step 2).
Build the solution with either Debug or Release as the active configuration.

Wolfcrypt library (wolfSSL)

WolfSSL is included as a submodule. Initialize and update the submodule to fetch the project and checkout the appropriate commit.
```
 > git submodule init
 > git submodule update
```
The current commit will point the minimum recommended version of wolfSSL. Moving to a more recent tag or commit should also be supported but might not be tested.
Build the solution with either WolfDebug or WolfRelease as the active configuration, either from inside the Visual Studio or with the following command line:
```
 > msbuild TPMCmd\simulator.sln /p:Configuration=WolfDebug
```

Linux build

Follows the common ./bootstrap && ./configure && make convention.

Note that autotools scripts require the following prerequisite packages: autoconf-archive, pkg-config. Their absence is not automatically detected. The build also requires libssl-dev package to be installed.