blob: ee0e6c275f13d4f6e2e79417f2dd08706d048773 [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/**
64 * aes_cbc_encrypt_blocks() - Encrypt multiple blocks of data with AES CBC.
65 *
66 * @key_exp Expanded key to use
67 * @src Source data to encrypt
68 * @dst Destination buffer
69 * @num_aes_blocks Number of AES blocks to encrypt
70 */
71void aes_cbc_encrypt_blocks(u8 *key_exp, u8 *src, u8 *dst, u32 num_aes_blocks);
72
Marek Vasutdc24bb62014-03-05 19:58:38 +010073/**
74 * Decrypt multiple blocks of data with AES CBC.
75 *
76 * @key_exp Expanded key to use
77 * @src Source data to decrypt
78 * @dst Destination buffer
79 * @num_aes_blocks Number of AES blocks to decrypt
80 */
81void aes_cbc_decrypt_blocks(u8 *key_exp, u8 *src, u8 *dst, u32 num_aes_blocks);
82
Yen Lin5b1a5452012-04-05 11:54:58 +000083#endif /* _AES_REF_H_ */