anyThing Connected Team / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   BREAK_SENSOR_LED

Fork of mbed-dev by mbed official

targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/inc/em_aes.h@144:ef7eb2e8f9f7, 2016-09-02 (annotated)

Committer:
<>
Date:
Fri Sep 02 15:07:44 2016 +0100
Revision:
144:ef7eb2e8f9f7
Parent:
50:a417edff4437 
This updates the lib to the mbed lib v125

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 2 * @file em_aes.h
<> 144:ef7eb2e8f9f7 3 * @brief Advanced encryption standard (AES) accelerator peripheral API.
<> 144:ef7eb2e8f9f7 4 * @version 4.2.1
<> 144:ef7eb2e8f9f7 5 *******************************************************************************
<> 144:ef7eb2e8f9f7 6 * @section License
<> 144:ef7eb2e8f9f7 7 * <b>(C) Copyright 2015 Silicon Labs, http://www.silabs.com</b>
<> 144:ef7eb2e8f9f7 8 *******************************************************************************
<> 144:ef7eb2e8f9f7 9 *
<> 144:ef7eb2e8f9f7 10 * Permission is granted to anyone to use this software for any purpose,
<> 144:ef7eb2e8f9f7 11 * including commercial applications, and to alter it and redistribute it
<> 144:ef7eb2e8f9f7 12 * freely, subject to the following restrictions:
<> 144:ef7eb2e8f9f7 13 *
<> 144:ef7eb2e8f9f7 14 * 1. The origin of this software must not be misrepresented; you must not
<> 144:ef7eb2e8f9f7 15 * claim that you wrote the original software.
<> 144:ef7eb2e8f9f7 16 * 2. Altered source versions must be plainly marked as such, and must not be
<> 144:ef7eb2e8f9f7 17 * misrepresented as being the original software.
<> 144:ef7eb2e8f9f7 18 * 3. This notice may not be removed or altered from any source distribution.
<> 144:ef7eb2e8f9f7 19 *
<> 144:ef7eb2e8f9f7 20 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
<> 144:ef7eb2e8f9f7 21 * obligation to support this Software. Silicon Labs is providing the
<> 144:ef7eb2e8f9f7 22 * Software "AS IS", with no express or implied warranties of any kind,
<> 144:ef7eb2e8f9f7 23 * including, but not limited to, any implied warranties of merchantability
<> 144:ef7eb2e8f9f7 24 * or fitness for any particular purpose or warranties against infringement
<> 144:ef7eb2e8f9f7 25 * of any proprietary rights of a third party.
<> 144:ef7eb2e8f9f7 26 *
<> 144:ef7eb2e8f9f7 27 * Silicon Labs will not be liable for any consequential, incidental, or
<> 144:ef7eb2e8f9f7 28 * special damages, or any other relief, or for any claim by any third party,
<> 144:ef7eb2e8f9f7 29 * arising from your use of this Software.
<> 144:ef7eb2e8f9f7 30 *
<> 144:ef7eb2e8f9f7 31 ******************************************************************************/
<> 144:ef7eb2e8f9f7 32
<> 144:ef7eb2e8f9f7 33 #ifndef __SILICON_LABS_EM_AES_H__
<> 144:ef7eb2e8f9f7 34 #define __SILICON_LABS_EM_AES_H__
<> 144:ef7eb2e8f9f7 35
<> 144:ef7eb2e8f9f7 36 #include "em_device.h"
<> 144:ef7eb2e8f9f7 37 #if defined(AES_COUNT) && (AES_COUNT > 0)
<> 144:ef7eb2e8f9f7 38
<> 144:ef7eb2e8f9f7 39 #include <stdbool.h>
<> 144:ef7eb2e8f9f7 40
<> 144:ef7eb2e8f9f7 41 #ifdef __cplusplus
<> 144:ef7eb2e8f9f7 42 extern "C" {
<> 144:ef7eb2e8f9f7 43 #endif
<> 144:ef7eb2e8f9f7 44
<> 144:ef7eb2e8f9f7 45 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 46 * @addtogroup EM_Library
<> 144:ef7eb2e8f9f7 47 * @{
<> 144:ef7eb2e8f9f7 48 ******************************************************************************/
<> 144:ef7eb2e8f9f7 49
<> 144:ef7eb2e8f9f7 50 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 51 * @addtogroup AES
<> 144:ef7eb2e8f9f7 52 * @{
<> 144:ef7eb2e8f9f7 53 ******************************************************************************/
<> 144:ef7eb2e8f9f7 54
<> 144:ef7eb2e8f9f7 55 /*******************************************************************************
<> 144:ef7eb2e8f9f7 56 ****************************** TYPEDEFS ***********************************
<> 144:ef7eb2e8f9f7 57 ******************************************************************************/
<> 144:ef7eb2e8f9f7 58
<> 144:ef7eb2e8f9f7 59 /**
<> 144:ef7eb2e8f9f7 60 * @brief
<> 144:ef7eb2e8f9f7 61 * AES counter modification function pointer.
<> 144:ef7eb2e8f9f7 62 * @details
<> 144:ef7eb2e8f9f7 63 * Parameters:
<> 144:ef7eb2e8f9f7 64 * @li ctr - Ptr to byte array (16 bytes) holding counter to be modified.
<> 144:ef7eb2e8f9f7 65 */
<> 144:ef7eb2e8f9f7 66 typedef void (*AES_CtrFuncPtr_TypeDef)(uint8_t *ctr);
<> 144:ef7eb2e8f9f7 67
<> 144:ef7eb2e8f9f7 68 /*******************************************************************************
<> 144:ef7eb2e8f9f7 69 ***************************** PROTOTYPES **********************************
<> 144:ef7eb2e8f9f7 70 ******************************************************************************/
<> 144:ef7eb2e8f9f7 71
<> 144:ef7eb2e8f9f7 72 void AES_CBC128(uint8_t *out,
<> 144:ef7eb2e8f9f7 73 const uint8_t *in,
<> 144:ef7eb2e8f9f7 74 unsigned int len,
<> 144:ef7eb2e8f9f7 75 const uint8_t *key,
<> 144:ef7eb2e8f9f7 76 const uint8_t *iv,
<> 144:ef7eb2e8f9f7 77 bool encrypt);
<> 144:ef7eb2e8f9f7 78
<> 144:ef7eb2e8f9f7 79 #if defined( AES_CTRL_AES256 )
<> 144:ef7eb2e8f9f7 80 void AES_CBC256(uint8_t *out,
<> 144:ef7eb2e8f9f7 81 const uint8_t *in,
<> 144:ef7eb2e8f9f7 82 unsigned int len,
<> 144:ef7eb2e8f9f7 83 const uint8_t *key,
<> 144:ef7eb2e8f9f7 84 const uint8_t *iv,
<> 144:ef7eb2e8f9f7 85 bool encrypt);
<> 144:ef7eb2e8f9f7 86 #endif
<> 144:ef7eb2e8f9f7 87
<> 144:ef7eb2e8f9f7 88 void AES_CFB128(uint8_t *out,
<> 144:ef7eb2e8f9f7 89 const uint8_t *in,
<> 144:ef7eb2e8f9f7 90 unsigned int len,
<> 144:ef7eb2e8f9f7 91 const uint8_t *key,
<> 144:ef7eb2e8f9f7 92 const uint8_t *iv,
<> 144:ef7eb2e8f9f7 93 bool encrypt);
<> 144:ef7eb2e8f9f7 94
<> 144:ef7eb2e8f9f7 95 #if defined( AES_CTRL_AES256 )
<> 144:ef7eb2e8f9f7 96 void AES_CFB256(uint8_t *out,
<> 144:ef7eb2e8f9f7 97 const uint8_t *in,
<> 144:ef7eb2e8f9f7 98 unsigned int len,
<> 144:ef7eb2e8f9f7 99 const uint8_t *key,
<> 144:ef7eb2e8f9f7 100 const uint8_t *iv,
<> 144:ef7eb2e8f9f7 101 bool encrypt);
<> 144:ef7eb2e8f9f7 102 #endif
<> 144:ef7eb2e8f9f7 103
<> 144:ef7eb2e8f9f7 104 void AES_CTR128(uint8_t *out,
<> 144:ef7eb2e8f9f7 105 const uint8_t *in,
<> 144:ef7eb2e8f9f7 106 unsigned int len,
<> 144:ef7eb2e8f9f7 107 const uint8_t *key,
<> 144:ef7eb2e8f9f7 108 uint8_t *ctr,
<> 144:ef7eb2e8f9f7 109 AES_CtrFuncPtr_TypeDef ctrFunc);
<> 144:ef7eb2e8f9f7 110
<> 144:ef7eb2e8f9f7 111 #if defined( AES_CTRL_AES256 )
<> 144:ef7eb2e8f9f7 112 void AES_CTR256(uint8_t *out,
<> 144:ef7eb2e8f9f7 113 const uint8_t *in,
<> 144:ef7eb2e8f9f7 114 unsigned int len,
<> 144:ef7eb2e8f9f7 115 const uint8_t *key,
<> 144:ef7eb2e8f9f7 116 uint8_t *ctr,
<> 144:ef7eb2e8f9f7 117 AES_CtrFuncPtr_TypeDef ctrFunc);
<> 144:ef7eb2e8f9f7 118 #endif
<> 144:ef7eb2e8f9f7 119
<> 144:ef7eb2e8f9f7 120 void AES_CTRUpdate32Bit(uint8_t *ctr);
<> 144:ef7eb2e8f9f7 121
<> 144:ef7eb2e8f9f7 122 void AES_DecryptKey128(uint8_t *out, const uint8_t *in);
<> 144:ef7eb2e8f9f7 123
<> 144:ef7eb2e8f9f7 124 #if defined( AES_CTRL_AES256 )
<> 144:ef7eb2e8f9f7 125 void AES_DecryptKey256(uint8_t *out, const uint8_t *in);
<> 144:ef7eb2e8f9f7 126 #endif
<> 144:ef7eb2e8f9f7 127
<> 144:ef7eb2e8f9f7 128 void AES_ECB128(uint8_t *out,
<> 144:ef7eb2e8f9f7 129 const uint8_t *in,
<> 144:ef7eb2e8f9f7 130 unsigned int len,
<> 144:ef7eb2e8f9f7 131 const uint8_t *key,
<> 144:ef7eb2e8f9f7 132 bool encrypt);
<> 144:ef7eb2e8f9f7 133
<> 144:ef7eb2e8f9f7 134 #if defined( AES_CTRL_AES256 )
<> 144:ef7eb2e8f9f7 135 void AES_ECB256(uint8_t *out,
<> 144:ef7eb2e8f9f7 136 const uint8_t *in,
<> 144:ef7eb2e8f9f7 137 unsigned int len,
<> 144:ef7eb2e8f9f7 138 const uint8_t *key,
<> 144:ef7eb2e8f9f7 139 bool encrypt);
<> 144:ef7eb2e8f9f7 140 #endif
<> 144:ef7eb2e8f9f7 141
<> 144:ef7eb2e8f9f7 142 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 143 * @brief
<> 144:ef7eb2e8f9f7 144 * Clear one or more pending AES interrupts.
<> 144:ef7eb2e8f9f7 145 *
<> 144:ef7eb2e8f9f7 146 * @param[in] flags
<> 144:ef7eb2e8f9f7 147 * Pending AES interrupt source to clear. Use a bitwise logic OR combination of
<> 144:ef7eb2e8f9f7 148 * valid interrupt flags for the AES module (AES_IF_nnn).
<> 144:ef7eb2e8f9f7 149 ******************************************************************************/
<> 144:ef7eb2e8f9f7 150 __STATIC_INLINE void AES_IntClear(uint32_t flags)
<> 144:ef7eb2e8f9f7 151 {
<> 144:ef7eb2e8f9f7 152 AES->IFC = flags;
<> 144:ef7eb2e8f9f7 153 }
<> 144:ef7eb2e8f9f7 154
<> 144:ef7eb2e8f9f7 155
<> 144:ef7eb2e8f9f7 156 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 157 * @brief
<> 144:ef7eb2e8f9f7 158 * Disable one or more AES interrupts.
<> 144:ef7eb2e8f9f7 159 *
<> 144:ef7eb2e8f9f7 160 * @param[in] flags
<> 144:ef7eb2e8f9f7 161 * AES interrupt sources to disable. Use a bitwise logic OR combination of
<> 144:ef7eb2e8f9f7 162 * valid interrupt flags for the AES module (AES_IF_nnn).
<> 144:ef7eb2e8f9f7 163 ******************************************************************************/
<> 144:ef7eb2e8f9f7 164 __STATIC_INLINE void AES_IntDisable(uint32_t flags)
<> 144:ef7eb2e8f9f7 165 {
<> 144:ef7eb2e8f9f7 166 AES->IEN &= ~(flags);
<> 144:ef7eb2e8f9f7 167 }
<> 144:ef7eb2e8f9f7 168
<> 144:ef7eb2e8f9f7 169
<> 144:ef7eb2e8f9f7 170 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 171 * @brief
<> 144:ef7eb2e8f9f7 172 * Enable one or more AES interrupts.
<> 144:ef7eb2e8f9f7 173 *
<> 144:ef7eb2e8f9f7 174 * @note
<> 144:ef7eb2e8f9f7 175 * Depending on the use, a pending interrupt may already be set prior to
<> 144:ef7eb2e8f9f7 176 * enabling the interrupt. Consider using AES_IntClear() prior to enabling
<> 144:ef7eb2e8f9f7 177 * if such a pending interrupt should be ignored.
<> 144:ef7eb2e8f9f7 178 *
<> 144:ef7eb2e8f9f7 179 * @param[in] flags
<> 144:ef7eb2e8f9f7 180 * AES interrupt sources to enable. Use a bitwise logic OR combination of
<> 144:ef7eb2e8f9f7 181 * valid interrupt flags for the AES module (AES_IF_nnn).
<> 144:ef7eb2e8f9f7 182 ******************************************************************************/
<> 144:ef7eb2e8f9f7 183 __STATIC_INLINE void AES_IntEnable(uint32_t flags)
<> 144:ef7eb2e8f9f7 184 {
<> 144:ef7eb2e8f9f7 185 AES->IEN |= flags;
<> 144:ef7eb2e8f9f7 186 }
<> 144:ef7eb2e8f9f7 187
<> 144:ef7eb2e8f9f7 188
<> 144:ef7eb2e8f9f7 189 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 190 * @brief
<> 144:ef7eb2e8f9f7 191 * Get pending AES interrupt flags.
<> 144:ef7eb2e8f9f7 192 *
<> 144:ef7eb2e8f9f7 193 * @note
<> 144:ef7eb2e8f9f7 194 * The event bits are not cleared by the use of this function.
<> 144:ef7eb2e8f9f7 195 *
<> 144:ef7eb2e8f9f7 196 * @return
<> 144:ef7eb2e8f9f7 197 * AES interrupt sources pending. A bitwise logic OR combination of valid
<> 144:ef7eb2e8f9f7 198 * interrupt flags for the AES module (AES_IF_nnn).
<> 144:ef7eb2e8f9f7 199 ******************************************************************************/
<> 144:ef7eb2e8f9f7 200 __STATIC_INLINE uint32_t AES_IntGet(void)
<> 144:ef7eb2e8f9f7 201 {
<> 144:ef7eb2e8f9f7 202 return AES->IF;
<> 144:ef7eb2e8f9f7 203 }
<> 144:ef7eb2e8f9f7 204
<> 144:ef7eb2e8f9f7 205
<> 144:ef7eb2e8f9f7 206 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 207 * @brief
<> 144:ef7eb2e8f9f7 208 * Get enabled and pending AES interrupt flags.
<> 144:ef7eb2e8f9f7 209 * Useful for handling more interrupt sources in the same interrupt handler.
<> 144:ef7eb2e8f9f7 210 *
<> 144:ef7eb2e8f9f7 211 * @note
<> 144:ef7eb2e8f9f7 212 * Interrupt flags are not cleared by the use of this function.
<> 144:ef7eb2e8f9f7 213 *
<> 144:ef7eb2e8f9f7 214 * @return
<> 144:ef7eb2e8f9f7 215 * Pending and enabled AES interrupt sources
<> 144:ef7eb2e8f9f7 216 * The return value is the bitwise AND of
<> 144:ef7eb2e8f9f7 217 * - the enabled interrupt sources in AES_IEN and
<> 144:ef7eb2e8f9f7 218 * - the pending interrupt flags AES_IF
<> 144:ef7eb2e8f9f7 219 ******************************************************************************/
<> 144:ef7eb2e8f9f7 220 __STATIC_INLINE uint32_t AES_IntGetEnabled(void)
<> 144:ef7eb2e8f9f7 221 {
<> 144:ef7eb2e8f9f7 222 uint32_t ien;
<> 144:ef7eb2e8f9f7 223
<> 144:ef7eb2e8f9f7 224 ien = AES->IEN;
<> 144:ef7eb2e8f9f7 225 return AES->IF & ien;
<> 144:ef7eb2e8f9f7 226 }
<> 144:ef7eb2e8f9f7 227
<> 144:ef7eb2e8f9f7 228
<> 144:ef7eb2e8f9f7 229 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 230 * @brief
<> 144:ef7eb2e8f9f7 231 * Set one or more pending AES interrupts from SW.
<> 144:ef7eb2e8f9f7 232 *
<> 144:ef7eb2e8f9f7 233 * @param[in] flags
<> 144:ef7eb2e8f9f7 234 * AES interrupt sources to set to pending. Use a bitwise logic OR combination
<> 144:ef7eb2e8f9f7 235 * of valid interrupt flags for the AES module (AES_IF_nnn).
<> 144:ef7eb2e8f9f7 236 ******************************************************************************/
<> 144:ef7eb2e8f9f7 237 __STATIC_INLINE void AES_IntSet(uint32_t flags)
<> 144:ef7eb2e8f9f7 238 {
<> 144:ef7eb2e8f9f7 239 AES->IFS = flags;
<> 144:ef7eb2e8f9f7 240 }
<> 144:ef7eb2e8f9f7 241
<> 144:ef7eb2e8f9f7 242
<> 144:ef7eb2e8f9f7 243 void AES_OFB128(uint8_t *out,
<> 144:ef7eb2e8f9f7 244 const uint8_t *in,
<> 144:ef7eb2e8f9f7 245 unsigned int len,
<> 144:ef7eb2e8f9f7 246 const uint8_t *key,
<> 144:ef7eb2e8f9f7 247 const uint8_t *iv);
<> 144:ef7eb2e8f9f7 248
<> 144:ef7eb2e8f9f7 249 #if defined( AES_CTRL_AES256 )
<> 144:ef7eb2e8f9f7 250 void AES_OFB256(uint8_t *out,
<> 144:ef7eb2e8f9f7 251 const uint8_t *in,
<> 144:ef7eb2e8f9f7 252 unsigned int len,
<> 144:ef7eb2e8f9f7 253 const uint8_t *key,
<> 144:ef7eb2e8f9f7 254 const uint8_t *iv);
<> 144:ef7eb2e8f9f7 255 #endif
<> 144:ef7eb2e8f9f7 256
<> 144:ef7eb2e8f9f7 257
<> 144:ef7eb2e8f9f7 258 /** @} (end addtogroup AES) */
<> 144:ef7eb2e8f9f7 259 /** @} (end addtogroup EM_Library) */
<> 144:ef7eb2e8f9f7 260
<> 144:ef7eb2e8f9f7 261 #ifdef __cplusplus
<> 144:ef7eb2e8f9f7 262 }
<> 144:ef7eb2e8f9f7 263 #endif
<> 144:ef7eb2e8f9f7 264
<> 144:ef7eb2e8f9f7 265 #endif /* defined(AES_COUNT) && (AES_COUNT > 0) */
<> 144:ef7eb2e8f9f7 266 #endif /* __SILICON_LABS_EM_AES_H__ */
<> 144:ef7eb2e8f9f7 267
<> 144:ef7eb2e8f9f7 268