xref: /aosp_15_r20/external/ms-tpm-20-ref/TPMCmd/tpm/include/Wolf/TpmToWolfSym.h (revision 5c591343844d1f9da7da26467c4bf7efc8a7a413)
1*5c591343SA. Cody Schuffelen /* Microsoft Reference Implementation for TPM 2.0
2*5c591343SA. Cody Schuffelen  *
3*5c591343SA. Cody Schuffelen  *  The copyright in this software is being made available under the BSD License,
4*5c591343SA. Cody Schuffelen  *  included below. This software may be subject to other third party and
5*5c591343SA. Cody Schuffelen  *  contributor rights, including patent rights, and no such rights are granted
6*5c591343SA. Cody Schuffelen  *  under this license.
7*5c591343SA. Cody Schuffelen  *
8*5c591343SA. Cody Schuffelen  *  Copyright (c) Microsoft Corporation
9*5c591343SA. Cody Schuffelen  *
10*5c591343SA. Cody Schuffelen  *  All rights reserved.
11*5c591343SA. Cody Schuffelen  *
12*5c591343SA. Cody Schuffelen  *  BSD License
13*5c591343SA. Cody Schuffelen  *
14*5c591343SA. Cody Schuffelen  *  Redistribution and use in source and binary forms, with or without modification,
15*5c591343SA. Cody Schuffelen  *  are permitted provided that the following conditions are met:
16*5c591343SA. Cody Schuffelen  *
17*5c591343SA. Cody Schuffelen  *  Redistributions of source code must retain the above copyright notice, this list
18*5c591343SA. Cody Schuffelen  *  of conditions and the following disclaimer.
19*5c591343SA. Cody Schuffelen  *
20*5c591343SA. Cody Schuffelen  *  Redistributions in binary form must reproduce the above copyright notice, this
21*5c591343SA. Cody Schuffelen  *  list of conditions and the following disclaimer in the documentation and/or other
22*5c591343SA. Cody Schuffelen  *  materials provided with the distribution.
23*5c591343SA. Cody Schuffelen  *
24*5c591343SA. Cody Schuffelen  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ""AS IS""
25*5c591343SA. Cody Schuffelen  *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26*5c591343SA. Cody Schuffelen  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
27*5c591343SA. Cody Schuffelen  *  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
28*5c591343SA. Cody Schuffelen  *  ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
29*5c591343SA. Cody Schuffelen  *  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30*5c591343SA. Cody Schuffelen  *  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
31*5c591343SA. Cody Schuffelen  *  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
32*5c591343SA. Cody Schuffelen  *  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
33*5c591343SA. Cody Schuffelen  *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34*5c591343SA. Cody Schuffelen  */
35*5c591343SA. Cody Schuffelen 
36*5c591343SA. Cody Schuffelen //** Introduction
37*5c591343SA. Cody Schuffelen //
38*5c591343SA. Cody Schuffelen // This header file is used to 'splice' the wolfcrypt library into the TPM code.
39*5c591343SA. Cody Schuffelen 
40*5c591343SA. Cody Schuffelen #ifndef SYM_LIB_DEFINED
41*5c591343SA. Cody Schuffelen #define SYM_LIB_DEFINED
42*5c591343SA. Cody Schuffelen 
43*5c591343SA. Cody Schuffelen #define SYM_LIB_WOLF
44*5c591343SA. Cody Schuffelen 
45*5c591343SA. Cody Schuffelen #define SYM_ALIGNMENT   RADIX_BYTES
46*5c591343SA. Cody Schuffelen 
47*5c591343SA. Cody Schuffelen #include <wolfssl/wolfcrypt/aes.h>
48*5c591343SA. Cody Schuffelen #include <wolfssl/wolfcrypt/des3.h>
49*5c591343SA. Cody Schuffelen 
50*5c591343SA. Cody Schuffelen //***************************************************************
51*5c591343SA. Cody Schuffelen //** Links to the wolfCrypt AES code
52*5c591343SA. Cody Schuffelen //***************************************************************
53*5c591343SA. Cody Schuffelen #if ALG_SM4
54*5c591343SA. Cody Schuffelen #undef ALG_SM4
55*5c591343SA. Cody Schuffelen #define ALG_SM4 ALG_NO
56*5c591343SA. Cody Schuffelen //#error "SM4 is not available"
57*5c591343SA. Cody Schuffelen #endif
58*5c591343SA. Cody Schuffelen 
59*5c591343SA. Cody Schuffelen #if ALG_CAMELLIA
60*5c591343SA. Cody Schuffelen #undef ALG_CAMELLIA
61*5c591343SA. Cody Schuffelen #define ALG_CAMELLIA ALG_NO
62*5c591343SA. Cody Schuffelen //#error "Camellia is not available"
63*5c591343SA. Cody Schuffelen #endif
64*5c591343SA. Cody Schuffelen 
65*5c591343SA. Cody Schuffelen // Define the order of parameters to the library functions that do block encryption
66*5c591343SA. Cody Schuffelen // and decryption.
67*5c591343SA. Cody Schuffelen typedef void(*TpmCryptSetSymKeyCall_t)(
68*5c591343SA. Cody Schuffelen     void        *keySchedule,
69*5c591343SA. Cody Schuffelen     BYTE        *out,
70*5c591343SA. Cody Schuffelen     const BYTE  *in
71*5c591343SA. Cody Schuffelen     );
72*5c591343SA. Cody Schuffelen 
73*5c591343SA. Cody Schuffelen // The Crypt functions that call the block encryption function use the parameters
74*5c591343SA. Cody Schuffelen // in the order:
75*5c591343SA. Cody Schuffelen //  1) keySchedule
76*5c591343SA. Cody Schuffelen //  2) in buffer
77*5c591343SA. Cody Schuffelen //  3) out buffer
78*5c591343SA. Cody Schuffelen // Since wolfcrypt uses the order in encryptoCall_t above, need to swizzle the
79*5c591343SA. Cody Schuffelen // values to the order required by the library.
80*5c591343SA. Cody Schuffelen #define SWIZZLE(keySchedule, in, out)                                   \
81*5c591343SA. Cody Schuffelen     (void *)(keySchedule), (BYTE *)(out), (const BYTE *)(in)
82*5c591343SA. Cody Schuffelen 
83*5c591343SA. Cody Schuffelen // Macros to set up the encryption/decryption key schedules
84*5c591343SA. Cody Schuffelen //
85*5c591343SA. Cody Schuffelen // AES:
86*5c591343SA. Cody Schuffelen #define TpmCryptSetEncryptKeyAES(key, keySizeInBits, schedule)            \
87*5c591343SA. Cody Schuffelen     wc_AesSetKeyDirect((tpmKeyScheduleAES *)(schedule), key, BITS_TO_BYTES(keySizeInBits), 0, AES_ENCRYPTION)
88*5c591343SA. Cody Schuffelen #define TpmCryptSetDecryptKeyAES(key, keySizeInBits, schedule)            \
89*5c591343SA. Cody Schuffelen     wc_AesSetKeyDirect((tpmKeyScheduleAES *)(schedule), key, BITS_TO_BYTES(keySizeInBits), 0, AES_DECRYPTION)
90*5c591343SA. Cody Schuffelen 
91*5c591343SA. Cody Schuffelen // TDES:
92*5c591343SA. Cody Schuffelen #define TpmCryptSetEncryptKeyTDES(key, keySizeInBits, schedule)            \
93*5c591343SA. Cody Schuffelen     TDES_setup_encrypt_key((key), (keySizeInBits), (tpmKeyScheduleTDES *)(schedule))
94*5c591343SA. Cody Schuffelen #define TpmCryptSetDecryptKeyTDES(key, keySizeInBits, schedule)            \
95*5c591343SA. Cody Schuffelen     TDES_setup_decrypt_key((key), (keySizeInBits), (tpmKeyScheduleTDES *)(schedule))
96*5c591343SA. Cody Schuffelen 
97*5c591343SA. Cody Schuffelen // Macros to alias encryption calls to specific algorithms. This should be used
98*5c591343SA. Cody Schuffelen // sparingly. Currently, only used by CryptRand.c
99*5c591343SA. Cody Schuffelen //
100*5c591343SA. Cody Schuffelen // When using these calls, to call the AES block encryption code, the caller
101*5c591343SA. Cody Schuffelen // should use:
102*5c591343SA. Cody Schuffelen //      TpmCryptEncryptAES(SWIZZLE(keySchedule, in, out));
103*5c591343SA. Cody Schuffelen #define TpmCryptEncryptAES          wc_AesEncryptDirect
104*5c591343SA. Cody Schuffelen #define TpmCryptDecryptAES          wc_AesDecryptDirect
105*5c591343SA. Cody Schuffelen #define tpmKeyScheduleAES           Aes
106*5c591343SA. Cody Schuffelen 
107*5c591343SA. Cody Schuffelen #define TpmCryptEncryptTDES         TDES_encrypt
108*5c591343SA. Cody Schuffelen #define TpmCryptDecryptTDES         TDES_decrypt
109*5c591343SA. Cody Schuffelen #define tpmKeyScheduleTDES          Des3
110*5c591343SA. Cody Schuffelen 
111*5c591343SA. Cody Schuffelen typedef union tpmCryptKeySchedule_t tpmCryptKeySchedule_t;
112*5c591343SA. Cody Schuffelen 
113*5c591343SA. Cody Schuffelen #if ALG_TDES
114*5c591343SA. Cody Schuffelen #include "TpmToWolfDesSupport_fp.h"
115*5c591343SA. Cody Schuffelen #endif
116*5c591343SA. Cody Schuffelen 
117*5c591343SA. Cody Schuffelen // This definition would change if there were something to report
118*5c591343SA. Cody Schuffelen #define SymLibSimulationEnd()
119*5c591343SA. Cody Schuffelen 
120*5c591343SA. Cody Schuffelen #endif // SYM_LIB_DEFINED
121