Kinetis Bootloader  2.0.0
Common bootloader for Kinetis devices
aes_security.h
1 /*
2  * Copyright (c) 2014, Freescale Semiconductor, Inc.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without modification,
6  * are permitted provided that the following conditions are met:
7  *
8  * o Redistributions of source code must retain the above copyright notice, this list
9  * of conditions and the following disclaimer.
10  *
11  * o Redistributions in binary form must reproduce the above copyright notice, this
12  * list of conditions and the following disclaimer in the documentation and/or
13  * other materials provided with the distribution.
14  *
15  * o Neither the name of Freescale Semiconductor, Inc. nor the names of its
16  * contributors may be used to endorse or promote products derived from this
17  * software without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
23  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
24  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
26  * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #ifndef _aes_security_h
32 #define _aes_security_h
33 
34 #include "bootloader_common.h"
35 
38 
40 // Definitions
42 
43 #define AES_128_KEY_SIZE 16 // bytes
44 #define AES_128_KEY_SIZE_WORDS 4 // 32 bit words
45 #define AES_BLOCK_SIZE_WORDS 4 // 32 bit words
46 #define AES_BLOCK_SIZE 16 // bytes
47 #define AES_128_KEY_SCHEDULE_SIZE_WORDS 44 // 32 bit words
48 
49 #define AES_SECURITY_SUPPORTED (defined(CAU_BASE) || defined(LTC0_BASE) || FSL_FEATURE_SIM_HAS_MISCCTRL_LTCEN)
50 
51 typedef struct mmcau_function_info
52 {
53  uint32_t tag; // 'kcau' = 0x
54  uint32_t length; // number of bytes to copy, this number will be copied from the start of aes_init
55  uint32_t aes_init_start;
56  uint32_t aes_encrypt_start;
57  uint32_t aes_decrypt_start;
59 
61 {
63  kMmcauInfoTag = FOUR_CHAR_CODE('k', 'c', 'a', 'u')
64 };
65 
67 // API
69 
70 #if defined(__cplusplus)
71 extern "C" {
72 #endif
73 
75 
76 
79 void aes_init(uint32_t *key);
80 
84 void aes_encrypt(uint32_t *in, uint32_t *key, uint32_t *out);
85 
89 void aes_decrypt(uint32_t *in, uint32_t *key, uint32_t *out);
91 
92 #if defined(__cplusplus)
93 }
94 #endif
95 
97 
98 #endif // _aes_security_h
99 // EOF
Tag value used to validate the bootloader configuration data.
Definition: aes_security.h:63
Definition: aes_security.h:51
void aes_init(uint32_t *key)
An initialization function for the decryption peripheral Warning: The key must be word aligned...
Definition: aes_security.c:79
_mmcau_info_tag
Definition: aes_security.h:60
void aes_decrypt(uint32_t *in, uint32_t *key, uint32_t *out)
Decrypts a 16 byte block of data in and out may use the same address so decrypting in place is suppor...
Definition: aes_security.c:138
void aes_encrypt(uint32_t *in, uint32_t *key, uint32_t *out)
Encrypts a 16 byte block of data in and out may use the same address so encrypting in place is suppor...
Definition: aes_security.c:113