blob: 6315c02aa93d9fc6a4cda3f52f4912c8ebe2e5a0
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_ */ |
95 |