Common PinWeaver Code

This directory contains reference PinWeaver code that can be used across implementation platforms.

It consists of:

• PinWeaver reference code:
  • pinweaver.h - PinWeaver embedded API definition
  • pinweaver.c - implementation
  • pinweaver_eal.h - API for Environment Abstraction Layer (EAL) used by PinWeaver
    • note that some types used in this API are platform-specific and are defined in eal/**/pinweaver_eal_types.h
  • pinweaver_types.h - header that is shared by PinWeaver implementation and PinWeaver clients that call it through platform-specific interface.
• Environment Abstraction Layer (EAL) implementations - in eal/ folder
  • eal/cr50 - implementation for cr50
    • pinweaver_eal_types.h - cr50-specific EAL API types
    • pinweaver_eal.c - cr50 implementation of EAL
  • eal/tpm_storage - implementation for platforms that use TPM as PinWeaver data storage
    • pinweaver_eal_types.h - TPM-storage-specific EAL API types
    • pinweaver_eal_tpm.h - additional EAL functions required by TPM storage
    • pinweaver_eal_linux.c - implementation of non-storage EAL methods for Linux case
    • tpm_storage_stubs.c - empty implementation of storage EAL methods
    • tpm_storage.c - implementation of storage EAL methods on top of TSS
    • mini_trunks/ - mini-TSS (TPM client software stack) used by TPM storage implementation
      • created from trunks TSS used by ChromeOS reduced to the minimal required set of TPM commands and ported from C++ to C
      • relies on pinweaver_eal.h + pinweaver_eal_tpm.h EAL methods
      • TSS API is defined in tss.h + *authorization_delegate.h

A platform implementation that uses TPM storage EAL option needs to implement all EAL methods implemented in pinweaver_eal_linux.c (or use it as-is, if Linux compatible).