Merge branch 'master' of git://git.denx.de/u-boot-mips
[platform/kernel/u-boot.git] / include / aes.h
1 /*
2  * Copyright (c) 2011 The Chromium OS Authors.
3  * (C) Copyright 2010 - 2011 NVIDIA Corporation <www.nvidia.com>
4  *
5  * SPDX-License-Identifier:     GPL-2.0+
6  */
7
8 #ifndef _AES_REF_H_
9 #define _AES_REF_H_
10
11 #ifdef USE_HOSTCC
12 /* Define compat stuff for use in fw_* tools. */
13 typedef unsigned char u8;
14 typedef unsigned int u32;
15 #define debug(...) do {} while (0)
16 #endif
17
18 /*
19  * AES encryption library, with small code size, supporting only 128-bit AES
20  *
21  * AES is a stream cipher which works a block at a time, with each block
22  * in this case being AES_KEY_LENGTH bytes.
23  */
24
25 enum {
26         AES_STATECOLS   = 4,    /* columns in the state & expanded key */
27         AES_KEYCOLS     = 4,    /* columns in a key */
28         AES_ROUNDS      = 10,   /* rounds in encryption */
29
30         AES_KEY_LENGTH  = 128 / 8,
31         AES_EXPAND_KEY_LENGTH   = 4 * AES_STATECOLS * (AES_ROUNDS + 1),
32 };
33
34 /**
35  * aes_expand_key() - Expand the AES key
36  *
37  * Expand a key into a key schedule, which is then used for the other
38  * operations.
39  *
40  * @key         Key, of length AES_KEY_LENGTH bytes
41  * @expkey      Buffer to place expanded key, AES_EXPAND_KEY_LENGTH
42  */
43 void aes_expand_key(u8 *key, u8 *expkey);
44
45 /**
46  * aes_encrypt() - Encrypt single block of data with AES 128
47  *
48  * @in          Input data
49  * @expkey      Expanded key to use for encryption (from aes_expand_key())
50  * @out         Output data
51  */
52 void aes_encrypt(u8 *in, u8 *expkey, u8 *out);
53
54 /**
55  * aes_decrypt() - Decrypt single block of data with AES 128
56  *
57  * @in          Input data
58  * @expkey      Expanded key to use for decryption (from aes_expand_key())
59  * @out         Output data
60  */
61 void aes_decrypt(u8 *in, u8 *expkey, u8 *out);
62
63 /**
64  * Apply chain data to the destination using EOR
65  *
66  * Each array is of length AES_KEY_LENGTH.
67  *
68  * @cbc_chain_data      Chain data
69  * @src                 Source data
70  * @dst                 Destination data, which is modified here
71  */
72 void aes_apply_cbc_chain_data(u8 *cbc_chain_data, u8 *src, u8 *dst);
73
74 /**
75  * aes_cbc_encrypt_blocks() - Encrypt multiple blocks of data with AES CBC.
76  *
77  * @key_exp             Expanded key to use
78  * @src                 Source data to encrypt
79  * @dst                 Destination buffer
80  * @num_aes_blocks      Number of AES blocks to encrypt
81  */
82 void aes_cbc_encrypt_blocks(u8 *key_exp, u8 *src, u8 *dst, u32 num_aes_blocks);
83
84 /**
85  * Decrypt multiple blocks of data with AES CBC.
86  *
87  * @key_exp             Expanded key to use
88  * @src                 Source data to decrypt
89  * @dst                 Destination buffer
90  * @num_aes_blocks      Number of AES blocks to decrypt
91  */
92 void aes_cbc_decrypt_blocks(u8 *key_exp, u8 *src, u8 *dst, u32 num_aes_blocks);
93
94 #endif /* _AES_REF_H_ */