blob: 6315c02aa93d9fc6a4cda3f52f4912c8ebe2e5a0 [file] [log] [blame]
Yen Lin5b1a5452012-04-05 11:54:58 +00001/*
2 * Copyright (c) 2011 The Chromium OS Authors.
3 * (C) Copyright 2010 - 2011 NVIDIA Corporation <www.nvidia.com>
4 *
Wolfgang Denk1a459662013-07-08 09:37:19 +02005 * SPDX-License-Identifier: GPL-2.0+
Yen Lin5b1a5452012-04-05 11:54:58 +00006 */
7
8#ifndef _AES_REF_H_
9#define _AES_REF_H_
10
Marek Vasuta8a752c2014-03-05 19:59:52 +010011#ifdef USE_HOSTCC
12/* Define compat stuff for use in fw_* tools. */
13typedef unsigned char u8;
14typedef unsigned int u32;
15#define debug(...) do {} while (0)
16#endif
17
Yen Lin5b1a5452012-04-05 11:54:58 +000018/*
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
25enum {
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/**
Marek Vasut957ba852014-03-05 19:58:36 +010035 * aes_expand_key() - Expand the AES key
36 *
Yen Lin5b1a5452012-04-05 11:54:58 +000037 * Expand a key into a key schedule, which is then used for the other
38 * operations.
39 *
Marek Vasut957ba852014-03-05 19:58:36 +010040 * @key Key, of length AES_KEY_LENGTH bytes
41 * @expkey Buffer to place expanded key, AES_EXPAND_KEY_LENGTH
Yen Lin5b1a5452012-04-05 11:54:58 +000042 */
43void aes_expand_key(u8 *key, u8 *expkey);
44
45/**
Marek Vasut957ba852014-03-05 19:58:36 +010046 * aes_encrypt() - Encrypt single block of data with AES 128
Yen Lin5b1a5452012-04-05 11:54:58 +000047 *
Marek Vasut957ba852014-03-05 19:58:36 +010048 * @in Input data
49 * @expkey Expanded key to use for encryption (from aes_expand_key())
50 * @out Output data
Yen Lin5b1a5452012-04-05 11:54:58 +000051 */
52void aes_encrypt(u8 *in, u8 *expkey, u8 *out);
53
54/**
Marek Vasut957ba852014-03-05 19:58:36 +010055 * aes_decrypt() - Decrypt single block of data with AES 128
Yen Lin5b1a5452012-04-05 11:54:58 +000056 *
Marek Vasut957ba852014-03-05 19:58:36 +010057 * @in Input data
58 * @expkey Expanded key to use for decryption (from aes_expand_key())
59 * @out Output data
Yen Lin5b1a5452012-04-05 11:54:58 +000060 */
61void aes_decrypt(u8 *in, u8 *expkey, u8 *out);
62
Marek Vasut6e7b9f42014-03-05 19:58:37 +010063/**
Stephen Warren53eb7682014-04-18 10:28:58 -060064 * 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 */
72void aes_apply_cbc_chain_data(u8 *cbc_chain_data, u8 *src, u8 *dst);
73
74/**
Marek Vasut6e7b9f42014-03-05 19:58:37 +010075 * 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 */
82void aes_cbc_encrypt_blocks(u8 *key_exp, u8 *src, u8 *dst, u32 num_aes_blocks);
83
Marek Vasutdc24bb62014-03-05 19:58:38 +010084/**
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 */
92void aes_cbc_decrypt_blocks(u8 *key_exp, u8 *src, u8 *dst, u32 num_aes_blocks);
93
Yen Lin5b1a5452012-04-05 11:54:58 +000094#endif /* _AES_REF_H_ */