| /***************************************************************************//** |
| * @file em_crypto.h |
| * @brief Cryptography accelerator peripheral API |
| * @version 5.6.0 |
| ******************************************************************************* |
| * # License |
| * <b>Copyright 2016 Silicon Laboratories, Inc. www.silabs.com</b> |
| ******************************************************************************* |
| * |
| * Permission is granted to anyone to use this software for any purpose, |
| * including commercial applications, and to alter it and redistribute it |
| * freely, subject to the following restrictions: |
| * |
| * 1. The origin of this software must not be misrepresented; you must not |
| * claim that you wrote the original software. |
| * 2. Altered source versions must be plainly marked as such, and must not be |
| * misrepresented as being the original software. |
| * 3. This notice may not be removed or altered from any source distribution. |
| * |
| * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no |
| * obligation to support this Software. Silicon Labs is providing the |
| * Software "AS IS", with no express or implied warranties of any kind, |
| * including, but not limited to, any implied warranties of merchantability |
| * or fitness for any particular purpose or warranties against infringement |
| * of any proprietary rights of a third party. |
| * |
| * Silicon Labs will not be liable for any consequential, incidental, or |
| * special damages, or any other relief, or for any claim by any third party, |
| * arising from your use of this Software. |
| * |
| ******************************************************************************/ |
| #ifndef EM_CRYPTO_H |
| #define EM_CRYPTO_H |
| |
| #include "em_device.h" |
| |
| #if defined(CRYPTO_COUNT) && (CRYPTO_COUNT > 0) |
| |
| #include "em_bus.h" |
| #include <stdbool.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /***************************************************************************//** |
| * @addtogroup emlib |
| * @{ |
| ******************************************************************************/ |
| |
| /***************************************************************************//** |
| * @addtogroup CRYPTO |
| * |
| * @brief Cryptography accelerator peripheral API |
| * |
| * @details |
| * For cryptographic support, users should consider the |
| * crypto APIs of the mbedTLS library provided by Silicon Labs instead of the |
| * interface provided in em_crypto.h. The mbedTLS library provides a much |
| * richer crypto API, including hardware acceleration of several functions. |
| * |
| * The main purpose of em_crypto.h is to implement a thin software interface |
| * for the CRYPTO hardware functions especially for the accelerated APIs of |
| * the mbedTLS library. Additionally em_crypto.h implement the AES API of the |
| * em_aes.h (supported by classic EFM32) for backwards compatibility. The |
| * following list summarizes the em_crypto.h inteface: |
| * @li AES (Advanced Encryption Standard) @ref crypto_aes |
| * @li SHA (Secure Hash Algorithm) @ref crypto_sha |
| * @li Big Integer multiplier @ref crypto_mul |
| * @li Functions for loading data and executing instruction sequences @ref crypto_exec |
| * |
| * @n @section crypto_aes AES |
| * The AES APIs include support for AES-128 and AES-256 with block cipher |
| * modes: |
| * @li CBC - Cipher Block Chaining mode |
| * @li CFB - Cipher Feedback mode |
| * @li CTR - Counter mode |
| * @li ECB - Electronic Code Book mode |
| * @li OFB - Output Feedback mode |
| * |
| * For the AES APIs input/output data (plaintext, ciphertext, key, and so on) are |
| * treated as byte arrays, starting with most significant byte. In other words, 32 bytes |
| * of plaintext (B0...B31) is located in memory in the same order, with B0 at |
| * the lower address and B31 at the higher address. |
| * |
| * Byte arrays must always be a multiple of AES block size, ie. a multiple |
| * of 16. Padding, if required, is done at the end of the byte array. |
| * |
| * Byte arrays should be word (32 bit) aligned for performance |
| * considerations, since the array is accessed with 32 bit access type. |
| * The core MCUs supports unaligned accesses, but with a performance penalty. |
| * |
| * It is possible to specify the same output buffer as input buffer as long |
| * as they point to the same address. In that case the provided input buffer |
| * is replaced with the encrypted/decrypted output. Notice that the buffers |
| * must be exactly overlapping. If partly overlapping, the behavior is |
| * undefined. |
| * |
| * It is up to the user to use a cipher mode according to its requirements |
| * to avoid breaking security. See the specific cipher mode |
| * theory for details. |
| * |
| * References: |
| * @li Wikipedia - Cipher modes, en.wikipedia.org/wiki/Cipher_modes |
| * |
| * @li Recommendation for Block Cipher Modes of Operation, |
| * NIST Special Publication 800-38A, 2001 Edition, |
| * csrc.nist.gov/publications/nistpubs/800-38a/sp800-38a.pdf |
| * |
| * @li Recommendation for Block Cipher Modes of Operation, |
| * csrc.nist.gov/publications/fips/fips180-4/fips-180-4.pdf |
| * |
| * @n @section crypto_sha SHA |
| * The SHA APIs include support for |
| * @li SHA-1 @ref CRYPTO_SHA_1 |
| * @li SHA-256 @ref CRYPTO_SHA_256 |
| * |
| * The SHA-1 implementation is FIPS-180-1 compliant, ref: |
| * @li Wikipedia - SHA-1, en.wikipedia.org/wiki/SHA-1 |
| * @li SHA-1 spec - www.itl.nist.gov/fipspubs/fip180-1.htm |
| * |
| * The SHA-256 implementation is FIPS-180-2 compliant, ref: |
| * @li Wikipedia - SHA-2, en.wikipedia.org/wiki/SHA-2 |
| * @li SHA-2 spec - csrc.nist.gov/publications/fips/fips180-2/fips180-2.pdf |
| * |
| * @n @section crypto_mul CRYPTO_Mul |
| * @ref CRYPTO_Mul is a function for multiplying big integers that are |
| * bigger than the operand size of the MUL instruction, which is 128 bits. |
| * CRYPTO_Mul multiplies all partial operands of the input operands using |
| * MUL to form a resulting number which may be twice the size of |
| * the operands. |
| * |
| * CRPYTO_Mul is typically used by RSA implementations, which perform a |
| * huge amount of multiplication and square operations to |
| * implement modular exponentiation. |
| * Some RSA implementations use a number representation including arrays |
| * of 32bit words of variable size. Compile with |
| * -D USE_VARIABLE_SIZED_DATA_LOADS in order to load these numbers |
| * directly into CRYPTO without converting the number representation. |
| * |
| * @n @section crypto_exec Load and Execute Instruction Sequences |
| * The functions for loading data and executing instruction sequences can |
| * be used to implement complex algorithms like elliptic curve cryptography |
| * (ECC)) and authenticated encryption algorithms. There are two typical |
| * modes of operation: |
| * @li Multi-sequence operation |
| * @li Single static instruction sequence operation |
| * |
| * In multi-sequence mode the software starts by loading input data, |
| * an instruction sequence, execute, and finally read the result. This |
| * process is repeated until the full crypto operation is complete. |
| * |
| * When using a single static instruction sequence, only one |
| * instruction sequence is loaded initially. The sequence can be set up |
| * to run multiple times. Data can be loaded during the execution of the |
| * sequence by using DMA, BUFC and/or programmed I/O directly from the MCU |
| * core. For details about how to program the instruction sequences, see |
| * the reference manual of the particular Silicon Labs device. |
| * |
| * To load input data to the CRYPTO module, use any of the following |
| * functions: |
| * @li @ref CRYPTO_DataWrite - Write 128 bits to a DATA register. |
| * @li @ref CRYPTO_DDataWrite - Write 256 bits to a DDATA register. |
| * @li @ref CRYPTO_QDataWrite - Write 512 bits to a QDATA register. |
| * |
| * In order to read output data from the CRYPTO module use any of the |
| * following functions: |
| * @li @ref CRYPTO_DataRead - Read 128 bits from a DATA register. |
| * @li @ref CRYPTO_DDataRead - Read 256 bits from a DDATA register. |
| * @li @ref CRYPTO_QDataRead - Read 512 bits from a QDATA register. |
| * |
| * To load an instruction sequence to the CRYPTO module, use |
| * @ref CRYPTO_InstructionSequenceLoad. |
| * |
| * To execute the current instruction sequence in the CRYPTO module, |
| * use @ref CRYPTO_InstructionSequenceExecute. |
| * |
| * To check whether an instruction sequence has completed, |
| * use @ref CRYPTO_InstructionSequenceDone. |
| * |
| * To wait for an instruction sequence to complete, |
| * use @ref CRYPTO_InstructionSequenceWait. |
| * |
| * To optimally load (with regards to speed) and execute an |
| * instruction sequence, use any of the CRYPTO_EXECUTE_X macros (where X is |
| * in the range 1-20) defined in @ref em_crypto.h. E.g. CRYPTO_EXECUTE_19. |
| * @{ |
| ******************************************************************************/ |
| |
| /******************************************************************************* |
| ****************************** DEFINES *********************************** |
| ******************************************************************************/ |
| |
| /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
| /** Default CRYPTO instance for deprecated AES functions. */ |
| #if !defined(DEFAULT_CRYPTO) |
| #if defined(CRYPTO) |
| #define DEFAULT_CRYPTO CRYPTO |
| #elif defined(CRYPTO0) |
| #define DEFAULT_CRYPTO CRYPTO0 |
| #endif |
| #endif |
| |
| /** Data sizes used by CRYPTO operations. */ |
| #define CRYPTO_DATA_SIZE_IN_BITS (128) |
| #define CRYPTO_DATA_SIZE_IN_BYTES (CRYPTO_DATA_SIZE_IN_BITS / 8) |
| #define CRYPTO_DATA_SIZE_IN_32BIT_WORDS (CRYPTO_DATA_SIZE_IN_BYTES / sizeof(uint32_t)) |
| |
| #define CRYPTO_KEYBUF_SIZE_IN_BITS (256) |
| #define CRYPTO_KEYBUF_SIZE_IN_BYTES (CRYPTO_DDATA_SIZE_IN_BITS / 8) |
| #define CRYPTO_KEYBUF_SIZE_IN_32BIT_WORDS (CRYPTO_DDATA_SIZE_IN_BYTES / sizeof(uint32_t)) |
| |
| #define CRYPTO_DDATA_SIZE_IN_BITS (256) |
| #define CRYPTO_DDATA_SIZE_IN_BYTES (CRYPTO_DDATA_SIZE_IN_BITS / 8) |
| #define CRYPTO_DDATA_SIZE_IN_32BIT_WORDS (CRYPTO_DDATA_SIZE_IN_BYTES / sizeof(uint32_t)) |
| |
| #define CRYPTO_QDATA_SIZE_IN_BITS (512) |
| #define CRYPTO_QDATA_SIZE_IN_BYTES (CRYPTO_QDATA_SIZE_IN_BITS / 8) |
| #define CRYPTO_QDATA_SIZE_IN_32BIT_WORDS (CRYPTO_QDATA_SIZE_IN_BYTES / sizeof(uint32_t)) |
| |
| #define CRYPTO_DATA260_SIZE_IN_32BIT_WORDS (9) |
| |
| /** SHA-1 digest sizes */ |
| #define CRYPTO_SHA1_DIGEST_SIZE_IN_BITS (160) |
| #define CRYPTO_SHA1_DIGEST_SIZE_IN_BYTES (CRYPTO_SHA1_DIGEST_SIZE_IN_BITS / 8) |
| |
| /** SHA-256 digest sizes */ |
| #define CRYPTO_SHA256_DIGEST_SIZE_IN_BITS (256) |
| #define CRYPTO_SHA256_DIGEST_SIZE_IN_BYTES (CRYPTO_SHA256_DIGEST_SIZE_IN_BITS / 8) |
| |
| /** |
| * Read and write all 260 bits of DDATA0 when in 260 bit mode. |
| */ |
| #define CRYPTO_DDATA0_260_BITS_READ(crypto, bigint260) CRYPTO_DData0Read260(crypto, bigint260) |
| #define CRYPTO_DDATA0_260_BITS_WRITE(crypto, bigint260) CRYPTO_DData0Write260(crypto, bigint260) |
| /** @endcond */ |
| |
| /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
| /** |
| * Instruction sequence load macros CRYPTO_SEQ_LOAD_X (where X is in the range |
| * 1-20), for example, @ref CRYPTO_SEQ_LOAD_20. |
| * Use these macros for faster execution than the function API. |
| */ |
| #define CRYPTO_SEQ_LOAD_1(crypto, a1) { \ |
| crypto->SEQ0 = a1 | (CRYPTO_CMD_INSTR_END << 8); } |
| #define CRYPTO_SEQ_LOAD_2(crypto, a1, a2) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (CRYPTO_CMD_INSTR_END << 16); } |
| #define CRYPTO_SEQ_LOAD_3(crypto, a1, a2, a3) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (CRYPTO_CMD_INSTR_END << 24); } |
| #define CRYPTO_SEQ_LOAD_4(crypto, a1, a2, a3, a4) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = CRYPTO_CMD_INSTR_END; } |
| #define CRYPTO_SEQ_LOAD_5(crypto, a1, a2, a3, a4, a5) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (CRYPTO_CMD_INSTR_END << 8); } |
| #define CRYPTO_SEQ_LOAD_6(crypto, a1, a2, a3, a4, a5, a6) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (CRYPTO_CMD_INSTR_END << 16); } |
| #define CRYPTO_SEQ_LOAD_7(crypto, a1, a2, a3, a4, a5, a6, a7) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (CRYPTO_CMD_INSTR_END << 24); } |
| #define CRYPTO_SEQ_LOAD_8(crypto, a1, a2, a3, a4, a5, a6, a7, a8) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = CRYPTO_CMD_INSTR_END; } |
| #define CRYPTO_SEQ_LOAD_9(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (CRYPTO_CMD_INSTR_END << 8); } |
| #define CRYPTO_SEQ_LOAD_10(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (CRYPTO_CMD_INSTR_END << 16); } |
| #define CRYPTO_SEQ_LOAD_11(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (CRYPTO_CMD_INSTR_END << 24); } |
| #define CRYPTO_SEQ_LOAD_12(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = CRYPTO_CMD_INSTR_END; } |
| #define CRYPTO_SEQ_LOAD_13(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (CRYPTO_CMD_INSTR_END << 8); } |
| #define CRYPTO_SEQ_LOAD_14(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (CRYPTO_CMD_INSTR_END << 16); } |
| #define CRYPTO_SEQ_LOAD_15(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (CRYPTO_CMD_INSTR_END << 24); } |
| #define CRYPTO_SEQ_LOAD_16(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = CRYPTO_CMD_INSTR_END; } |
| #define CRYPTO_SEQ_LOAD_17(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (CRYPTO_CMD_INSTR_END << 8); } |
| #define CRYPTO_SEQ_LOAD_18(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (a18 << 8) | (CRYPTO_CMD_INSTR_END << 16); } |
| #define CRYPTO_SEQ_LOAD_19(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (a18 << 8) | (a19 << 16) | (CRYPTO_CMD_INSTR_END << 24); } |
| #define CRYPTO_SEQ_LOAD_20(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (a18 << 8) | (a19 << 16) | (a20 << 24); } |
| /** @endcond */ |
| |
| /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
| /** |
| * Instruction sequence execution macros CRYPTO_EXECUTE_X (where X is in range |
| * 1-20), for example @ref CRYPTO_EXECUTE_19. |
| * Use these macros for faster execution than the function API. |
| */ |
| #define CRYPTO_EXECUTE_1(crypto, a1) { \ |
| crypto->SEQ0 = a1 | (CRYPTO_CMD_INSTR_EXEC << 8); } |
| #define CRYPTO_EXECUTE_2(crypto, a1, a2) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (CRYPTO_CMD_INSTR_EXEC << 16); } |
| #define CRYPTO_EXECUTE_3(crypto, a1, a2, a3) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (CRYPTO_CMD_INSTR_EXEC << 24); } |
| #define CRYPTO_EXECUTE_4(crypto, a1, a2, a3, a4) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = CRYPTO_CMD_INSTR_EXEC; } |
| #define CRYPTO_EXECUTE_5(crypto, a1, a2, a3, a4, a5) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (CRYPTO_CMD_INSTR_EXEC << 8); } |
| #define CRYPTO_EXECUTE_6(crypto, a1, a2, a3, a4, a5, a6) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (CRYPTO_CMD_INSTR_EXEC << 16); } |
| #define CRYPTO_EXECUTE_7(crypto, a1, a2, a3, a4, a5, a6, a7) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (CRYPTO_CMD_INSTR_EXEC << 24); } |
| #define CRYPTO_EXECUTE_8(crypto, a1, a2, a3, a4, a5, a6, a7, a8) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = CRYPTO_CMD_INSTR_EXEC; } |
| #define CRYPTO_EXECUTE_9(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (CRYPTO_CMD_INSTR_EXEC << 8); } |
| #define CRYPTO_EXECUTE_10(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (CRYPTO_CMD_INSTR_EXEC << 16); } |
| #define CRYPTO_EXECUTE_11(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (CRYPTO_CMD_INSTR_EXEC << 24); } |
| #define CRYPTO_EXECUTE_12(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = CRYPTO_CMD_INSTR_EXEC; } |
| #define CRYPTO_EXECUTE_13(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (CRYPTO_CMD_INSTR_EXEC << 8); } |
| #define CRYPTO_EXECUTE_14(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (CRYPTO_CMD_INSTR_EXEC << 16); } |
| #define CRYPTO_EXECUTE_15(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (CRYPTO_CMD_INSTR_EXEC << 24); } |
| #define CRYPTO_EXECUTE_16(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = CRYPTO_CMD_INSTR_EXEC; } |
| #define CRYPTO_EXECUTE_17(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (CRYPTO_CMD_INSTR_EXEC << 8); } |
| #define CRYPTO_EXECUTE_18(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (a18 << 8) | (CRYPTO_CMD_INSTR_EXEC << 16); } |
| #define CRYPTO_EXECUTE_19(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (a18 << 8) | (a19 << 16) | (CRYPTO_CMD_INSTR_EXEC << 24); } |
| #define CRYPTO_EXECUTE_20(crypto, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) { \ |
| crypto->SEQ0 = a1 | (a2 << 8) | (a3 << 16) | (a4 << 24); \ |
| crypto->SEQ1 = a5 | (a6 << 8) | (a7 << 16) | (a8 << 24); \ |
| crypto->SEQ2 = a9 | (a10 << 8) | (a11 << 16) | (a12 << 24); \ |
| crypto->SEQ3 = a13 | (a14 << 8) | (a15 << 16) | (a16 << 24); \ |
| crypto->SEQ4 = a17 | (a18 << 8) | (a19 << 16) | (a20 << 24); \ |
| CRYPTO_InstructionSequenceExecute(crypto); } |
| /** @endcond */ |
| |
| /******************************************************************************* |
| ****************************** TYPEDEFS *********************************** |
| ******************************************************************************/ |
| |
| /** |
| * CRYPTO data types used for data load functions. This data type is |
| * capable of storing a 128 bits value as used in the crypto DATA |
| * registers. |
| */ |
| typedef uint32_t CRYPTO_Data_TypeDef[CRYPTO_DATA_SIZE_IN_32BIT_WORDS]; |
| |
| /** |
| * CRYPTO data type used for data load functions. This data type |
| * is capable of storing a 256 bits value as used in the crypto DDATA |
| * registers. |
| */ |
| typedef uint32_t CRYPTO_DData_TypeDef[CRYPTO_DDATA_SIZE_IN_32BIT_WORDS]; |
| |
| /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
| typedef uint32_t* CRYPTO_DDataPtr_TypeDef; |
| /** @endcond */ |
| |
| /** |
| * CRYPTO data type used for data load functions. This data type is |
| * capable of storing a 512 bits value as used in the crypto QDATA |
| * registers. |
| */ |
| typedef uint32_t CRYPTO_QData_TypeDef[CRYPTO_QDATA_SIZE_IN_32BIT_WORDS]; |
| |
| /** |
| * CRYPTO data type used for data load functions. This data type is |
| * capable of storing a 260 bits value as used by the @ref CRYPTO_DData0Write260 |
| * function. |
| * |
| * Note that this data type is multiple of 32 bit words, so the |
| * actual storage used by this type is 32x9=288 bits. |
| */ |
| typedef uint32_t CRYPTO_Data260_TypeDef[CRYPTO_DATA260_SIZE_IN_32BIT_WORDS]; |
| |
| /** |
| * CRYPTO data type used for data load functions. This data type is |
| * capable of storing 256 bits as used in the crypto KEYBUF register. |
| */ |
| typedef uint32_t CRYPTO_KeyBuf_TypeDef[CRYPTO_KEYBUF_SIZE_IN_32BIT_WORDS]; |
| |
| /** |
| * CRYPTO 128 bit Data register pointer type. The 128 bit registers are used to |
| * load 128 bit values as input and output data for cryptographic and big |
| * integer arithmetic functions of the CRYPTO module. |
| */ |
| typedef volatile uint32_t* CRYPTO_DataReg_TypeDef; |
| |
| /** |
| * CRYPTO 256 bit DData (Double Data) register pointer type. The 256 bit |
| * registers are used to load 256 bit values as input and output data for |
| * cryptographic and big integer arithmetic functions of the CRYPTO module. |
| */ |
| typedef volatile uint32_t* CRYPTO_DDataReg_TypeDef; |
| |
| /** |
| * CRYPTO 512 bit QData (Quad data) register pointer type. The 512 bit |
| * registers are used to load 512 bit values as input and output data for |
| * cryptographic and big integer arithmetic functions of the CRYPTO module. |
| */ |
| typedef volatile uint32_t* CRYPTO_QDataReg_TypeDef; |
| |
| /** CRYPTO modulus identifiers. */ |
| typedef enum { |
| cryptoModulusBin256 = CRYPTO_WAC_MODULUS_BIN256, /**< Generic 256 bit modulus 2^256 */ |
| cryptoModulusBin128 = CRYPTO_WAC_MODULUS_BIN128, /**< Generic 128 bit modulus 2^128 */ |
| cryptoModulusGcmBin128 = CRYPTO_WAC_MODULUS_GCMBIN128, /**< GCM 128 bit modulus = 2^128 + 2^7 + 2^2 + 2 + 1 */ |
| cryptoModulusEccB233 = CRYPTO_WAC_MODULUS_ECCBIN233P, /**< ECC B233 prime modulus = 2^233 + 2^74 + 1 */ |
| cryptoModulusEccB163 = CRYPTO_WAC_MODULUS_ECCBIN163P, /**< ECC B163 prime modulus = 2^163 + 2^7 + 2^6 + 2^3 + 1 */ |
| cryptoModulusEccP256 = CRYPTO_WAC_MODULUS_ECCPRIME256P, /**< ECC P256 prime modulus = 2^256 - 2^224 + 2^192 + 2^96 - 1 */ |
| cryptoModulusEccP224 = CRYPTO_WAC_MODULUS_ECCPRIME224P, /**< ECC P224 prime modulus = 2^224 - 2^96 - 1 */ |
| cryptoModulusEccP192 = CRYPTO_WAC_MODULUS_ECCPRIME192P, /**< ECC P192 prime modulus = 2^192 - 2^64 - 1 */ |
| cryptoModulusEccB233Order = CRYPTO_WAC_MODULUS_ECCBIN233N, /**< ECC B233 order modulus */ |
| cryptoModulusEccB233KOrder = CRYPTO_WAC_MODULUS_ECCBIN233KN, /**< ECC B233K order modulus */ |
| cryptoModulusEccB163Order = CRYPTO_WAC_MODULUS_ECCBIN163N, /**< ECC B163 order modulus */ |
| cryptoModulusEccB163KOrder = CRYPTO_WAC_MODULUS_ECCBIN163KN, /**< ECC B163K order modulus */ |
| cryptoModulusEccP256Order = CRYPTO_WAC_MODULUS_ECCPRIME256N, /**< ECC P256 order modulus */ |
| cryptoModulusEccP224Order = CRYPTO_WAC_MODULUS_ECCPRIME224N, /**< ECC P224 order modulus */ |
| cryptoModulusEccP192Order = CRYPTO_WAC_MODULUS_ECCPRIME192N /**< ECC P192 order modulus */ |
| } CRYPTO_ModulusId_TypeDef; |
| |
| /** CRYPTO multiplication widths for wide arithmetic operations. */ |
| typedef enum { |
| cryptoMulOperand256Bits = CRYPTO_WAC_MULWIDTH_MUL256, /**< 256 bits operands */ |
| cryptoMulOperand128Bits = CRYPTO_WAC_MULWIDTH_MUL128, /**< 128 bits operands */ |
| cryptoMulOperandModulusBits = CRYPTO_WAC_MULWIDTH_MULMOD /**< MUL operand width |
| is specified by the |
| modulus type.*/ |
| } CRYPTO_MulOperandWidth_TypeDef; |
| |
| /** CRYPTO result widths for MUL operations. */ |
| typedef enum { |
| cryptoResult128Bits = CRYPTO_WAC_RESULTWIDTH_128BIT, /**< Multiplication result width is 128 bits*/ |
| cryptoResult256Bits = CRYPTO_WAC_RESULTWIDTH_256BIT, /**< Multiplication result width is 256 bits*/ |
| cryptoResult260Bits = CRYPTO_WAC_RESULTWIDTH_260BIT /**< Multiplication result width is 260 bits*/ |
| } CRYPTO_ResultWidth_TypeDef; |
| |
| /** CRYPTO result widths for MUL operations. */ |
| typedef enum { |
| cryptoInc1byte = CRYPTO_CTRL_INCWIDTH_INCWIDTH1, /**< inc width is 1 byte*/ |
| cryptoInc2byte = CRYPTO_CTRL_INCWIDTH_INCWIDTH2, /**< inc width is 2 byte*/ |
| cryptoInc3byte = CRYPTO_CTRL_INCWIDTH_INCWIDTH3, /**< inc width is 3 byte*/ |
| cryptoInc4byte = CRYPTO_CTRL_INCWIDTH_INCWIDTH4 /**< inc width is 4 byte*/ |
| } CRYPTO_IncWidth_TypeDef; |
| |
| /** CRYPTO key width. */ |
| typedef enum { |
| cryptoKey128Bits = 8, /**< Key width is 128 bits*/ |
| cryptoKey256Bits = 16, /**< Key width is 256 bits*/ |
| } CRYPTO_KeyWidth_TypeDef; |
| |
| /** |
| * The maximum number of crypto instructions in an instruction sequence. |
| */ |
| #define CRYPTO_MAX_SEQUENCE_INSTRUCTIONS (20) |
| |
| /** |
| * Instruction sequence type. |
| * Fill in the desired operations from step1, step2, and so on. |
| * The CRYPTO_CMD_INSTR_END marks the end of the sequence. |
| * Bit fields are used to format the memory layout of the struct equal to the |
| * sequence registers in the CRYPTO module. |
| */ |
| typedef uint8_t CRYPTO_InstructionSequence_TypeDef[CRYPTO_MAX_SEQUENCE_INSTRUCTIONS]; |
| |
| /** Default instruction sequence consisting of all ENDs. The user can |
| initialize the instruction sequence with this default value set and fill |
| in the desired operations from step 1. The first END instruction marks |
| the end of the sequence. */ |
| #define CRYPTO_INSTRUCTIONSEQUENSE_DEFAULT \ |
| { CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, \ |
| CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, \ |
| CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, \ |
| CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, \ |
| CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, \ |
| CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END, \ |
| CRYPTO_CMD_INSTR_END, CRYPTO_CMD_INSTR_END } |
| |
| /** SHA-1 Digest type. */ |
| typedef uint8_t CRYPTO_SHA1_Digest_TypeDef[CRYPTO_SHA1_DIGEST_SIZE_IN_BYTES]; |
| |
| /** SHA-256 Digest type. */ |
| typedef uint8_t CRYPTO_SHA256_Digest_TypeDef[CRYPTO_SHA256_DIGEST_SIZE_IN_BYTES]; |
| |
| /** |
| * @brief |
| * AES counter modification function pointer. |
| * |
| * @note |
| * This is defined for backwards compatibility with EFM32 em_aes.h. |
| * The CRYPTO implementation of counter mode does not support counter update |
| * callbacks. |
| * |
| * @param[in] ctr A counter value to be modified. |
| */ |
| typedef void (*CRYPTO_AES_CtrFuncPtr_TypeDef)(uint8_t * ctr); |
| |
| /******************************************************************************* |
| ***************************** PROTOTYPES ********************************** |
| ******************************************************************************/ |
| |
| /***************************************************************************//** |
| * @brief |
| * Set the modulus type used for wide arithmetic operations. |
| * |
| * @details |
| * This function sets the modulus type to be used by the modulus instructions |
| * of the CRYPTO module. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] modType |
| * A modulus type. |
| ******************************************************************************/ |
| void CRYPTO_ModulusSet(CRYPTO_TypeDef * crypto, |
| CRYPTO_ModulusId_TypeDef modType); |
| |
| /***************************************************************************//** |
| * @brief |
| * Set the number of bits in the operands of the MUL instruction. |
| * |
| * @details |
| * This function sets the number of bits to be used in the operands of |
| * the MUL instruction. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] mulOperandWidth |
| * Multiplication width in bits. |
| ******************************************************************************/ |
| __STATIC_INLINE |
| void CRYPTO_MulOperandWidthSet(CRYPTO_TypeDef *crypto, |
| CRYPTO_MulOperandWidth_TypeDef mulOperandWidth) |
| { |
| uint32_t temp = crypto->WAC & (~_CRYPTO_WAC_MULWIDTH_MASK); |
| crypto->WAC = temp | (uint32_t)mulOperandWidth; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Set the width of the results of the non-modulus instructions. |
| * |
| * @details |
| * This function sets the result width of the non-modulus instructions. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] resultWidth |
| * A result width of non-modulus instructions. |
| ******************************************************************************/ |
| __STATIC_INLINE |
| void CRYPTO_ResultWidthSet(CRYPTO_TypeDef *crypto, |
| CRYPTO_ResultWidth_TypeDef resultWidth) |
| { |
| uint32_t temp = crypto->WAC & (~_CRYPTO_WAC_RESULTWIDTH_MASK); |
| crypto->WAC = temp | (uint32_t)resultWidth; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Set the width of the DATA1 increment instruction DATA1INC. |
| * |
| * @details |
| * This function sets the width of the DATA1 increment instruction |
| * @ref CRYPTO_CMD_INSTR_DATA1INC. |
| * |
| * @param[in] crypto |
| * A pointer to CRYPTO peripheral register block. |
| * |
| * @param[in] incWidth |
| * An incrementation width. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_IncWidthSet(CRYPTO_TypeDef *crypto, |
| CRYPTO_IncWidth_TypeDef incWidth) |
| { |
| uint32_t temp = crypto->CTRL & (~_CRYPTO_CTRL_INCWIDTH_MASK); |
| crypto->CTRL = temp | (uint32_t)incWidth; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Write a 128 bit value into a crypto register. |
| * |
| * @note |
| * This function provides a low-level API for writing to the multi-word |
| * registers in the crypto peripheral. Applications should use |
| * @ref CRYPTO_DataWrite, @ref CRYPTO_DDataWrite or @ref CRYPTO_QDataWrite |
| * for writing to DATA, DDATA, and QDATA registers. |
| * |
| * @param[in] reg |
| * A pointer to the crypto register. |
| * |
| * @param[in] val |
| * This is a pointer to 4 32 bit integers that contains the 128 bit value |
| * which will be written to the crypto register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_BurstToCrypto(volatile uint32_t * reg, |
| const uint32_t * val) |
| { |
| /* Load data from memory into local registers. */ |
| register uint32_t v0 = val[0]; |
| register uint32_t v1 = val[1]; |
| register uint32_t v2 = val[2]; |
| register uint32_t v3 = val[3]; |
| /* Store data to CRYPTO */ |
| *reg = v0; |
| *reg = v1; |
| *reg = v2; |
| *reg = v3; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Read a 128 bit value from a crypto register. |
| * |
| * @note |
| * This function provides a low-level API for reading one of the multi-word |
| * registers in the crypto peripheral. Applications should use |
| * @ref CRYPTO_DataRead, @ref CRYPTO_DDataRead or @ref CRYPTO_QDataRead |
| * for reading the value of DATA, DDATA, and QDATA registers. |
| * |
| * @param[in] reg |
| * A pointer to the crypto register. |
| * |
| * @param[out] val |
| * This is a pointer to an array that is capable of holding 4 32 bit integers |
| * that will be filled with the 128 bit value from the crypto register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_BurstFromCrypto(volatile uint32_t * reg, uint32_t * val) |
| { |
| /* Load data from CRYPTO into local registers. */ |
| register uint32_t v0 = *reg; |
| register uint32_t v1 = *reg; |
| register uint32_t v2 = *reg; |
| register uint32_t v3 = *reg; |
| /* Store data to memory */ |
| val[0] = v0; |
| val[1] = v1; |
| val[2] = v2; |
| val[3] = v3; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Write 128 bits of data to a DATAX register in the CRYPTO module. |
| * |
| * @details |
| * Write 128 bits of data to a DATAX register in the crypto module. The data |
| * value is typically input to a big integer operation (see crypto |
| * instructions). |
| * |
| * @param[in] dataReg The 128 bit DATA register. |
| * @param[in] val Value of the data to write to the DATA register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_DataWrite(CRYPTO_DataReg_TypeDef dataReg, |
| const CRYPTO_Data_TypeDef val) |
| { |
| CRYPTO_BurstToCrypto(dataReg, val); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Read 128 bits of data from a DATAX register in the CRYPTO module. |
| * |
| * @details |
| * Read 128 bits of data from a DATAX register in the crypto module. The data |
| * value is typically output from a big integer operation (see crypto |
| * instructions) |
| * |
| * @param[in] dataReg The 128 bit DATA register. |
| * @param[out] val Location where to store the value in memory. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_DataRead(CRYPTO_DataReg_TypeDef dataReg, |
| CRYPTO_Data_TypeDef val) |
| { |
| CRYPTO_BurstFromCrypto(dataReg, val); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Write 256 bits of data to a DDATAX register in the CRYPTO module. |
| * |
| * @details |
| * Write 256 bits of data into a DDATAX (Double Data) register in the crypto |
| * module. The data value is typically input to a big integer operation (see |
| * crypto instructions). |
| * |
| * @param[in] ddataReg The 256 bit DDATA register. |
| * @param[in] val Value of the data to write to the DDATA register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_DDataWrite(CRYPTO_DDataReg_TypeDef ddataReg, |
| const CRYPTO_DData_TypeDef val) |
| { |
| CRYPTO_BurstToCrypto(ddataReg, &val[0]); |
| CRYPTO_BurstToCrypto(ddataReg, &val[4]); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Read 256 bits of data from a DDATAX register in the CRYPTO module. |
| * |
| * @details |
| * Read 256 bits of data from a DDATAX (Double Data) register in the crypto |
| * module. The data value is typically output from a big integer operation |
| * (see crypto instructions). |
| * |
| * @param[in] ddataReg The 256 bit DDATA register. |
| * @param[out] val Location where to store the value in memory. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_DDataRead(CRYPTO_DDataReg_TypeDef ddataReg, |
| CRYPTO_DData_TypeDef val) |
| { |
| CRYPTO_BurstFromCrypto(ddataReg, &val[0]); |
| CRYPTO_BurstFromCrypto(ddataReg, &val[4]); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Write 512 bits of data to a QDATAX register in the CRYPTO module. |
| * |
| * @details |
| * Write 512 bits of data into a QDATAX (Quad Data) register in the crypto module |
| * The data value is typically input to a big integer operation (see crypto |
| * instructions). |
| * |
| * @param[in] qdataReg The 512 bits QDATA register. |
| * @param[in] val Value of the data to write to the QDATA register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_QDataWrite(CRYPTO_QDataReg_TypeDef qdataReg, |
| const CRYPTO_QData_TypeDef val) |
| { |
| CRYPTO_BurstToCrypto(qdataReg, &val[0]); |
| CRYPTO_BurstToCrypto(qdataReg, &val[4]); |
| CRYPTO_BurstToCrypto(qdataReg, &val[8]); |
| CRYPTO_BurstToCrypto(qdataReg, &val[12]); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Read 512 bits of data from a QDATAX register in the CRYPTO module. |
| * |
| * @details |
| * Read 512 bits of data from a QDATAX register in the crypto module. The data |
| * value is typically input to a big integer operation (see crypto |
| * instructions). |
| * |
| * @param[in] qdataReg The 512 bits QDATA register. |
| * @param[in] val Value of the data to write to the QDATA register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_QDataRead(CRYPTO_QDataReg_TypeDef qdataReg, |
| CRYPTO_QData_TypeDef val) |
| { |
| CRYPTO_BurstFromCrypto(qdataReg, &val[0]); |
| CRYPTO_BurstFromCrypto(qdataReg, &val[4]); |
| CRYPTO_BurstFromCrypto(qdataReg, &val[8]); |
| CRYPTO_BurstFromCrypto(qdataReg, &val[12]); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Set the key value to be used by the CRYPTO module. |
| * |
| * @details |
| * Write 128 or 256 bit key to the KEYBUF register in the crypto module. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] val |
| * Value of the data to write to the KEYBUF register. |
| * |
| * @param[in] keyWidth |
| * Key width - 128 or 256 bits. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_KeyBufWrite(CRYPTO_TypeDef *crypto, |
| CRYPTO_KeyBuf_TypeDef val, |
| CRYPTO_KeyWidth_TypeDef keyWidth) |
| { |
| if (keyWidth == cryptoKey256Bits) { |
| /* Set AES-256 mode */ |
| BUS_RegBitWrite(&crypto->CTRL, _CRYPTO_CTRL_AES_SHIFT, _CRYPTO_CTRL_AES_AES256); |
| /* Load key in KEYBUF register (= DDATA4) */ |
| CRYPTO_DDataWrite(&crypto->DDATA4, val); |
| } else { |
| /* Set AES-128 mode */ |
| BUS_RegBitWrite(&crypto->CTRL, _CRYPTO_CTRL_AES_SHIFT, _CRYPTO_CTRL_AES_AES128); |
| CRYPTO_BurstToCrypto(&crypto->KEYBUF, &val[0]); |
| } |
| } |
| |
| void CRYPTO_KeyRead(CRYPTO_TypeDef *crypto, |
| CRYPTO_KeyBuf_TypeDef val, |
| CRYPTO_KeyWidth_TypeDef keyWidth); |
| |
| /***************************************************************************//** |
| * @brief |
| * Quick write 128 bit key to the CRYPTO module. |
| * |
| * @details |
| * Quick write 128 bit key to the KEYBUF register in the CRYPTO module. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] val |
| * Value of the data to write to the KEYBUF register. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_KeyBuf128Write(CRYPTO_TypeDef *crypto, |
| const uint32_t * val) |
| { |
| CRYPTO_BurstToCrypto(&crypto->KEYBUF, val); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Quick read access of the carry bit from arithmetic operations. |
| * |
| * @details |
| * This function reads the carry bit of the CRYPTO ALU. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @return |
| * Returns 'true' if carry is 1, and 'false' if carry is 0. |
| ******************************************************************************/ |
| __STATIC_INLINE bool CRYPTO_CarryIsSet(CRYPTO_TypeDef *crypto) |
| { |
| return ((crypto->DSTATUS & _CRYPTO_DSTATUS_CARRY_MASK) |
| >> _CRYPTO_DSTATUS_CARRY_SHIFT) != 0UL; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Quick read access of the 4 LSbits of the DDATA0 register. |
| * |
| * @details |
| * This function quickly retrieves the 4 least significant bits of the |
| * DDATA0 register via the DDATA0LSBS bit field in the DSTATUS register. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @return |
| * Returns the 4 LSbits of DDATA0. |
| ******************************************************************************/ |
| __STATIC_INLINE uint8_t CRYPTO_DData0_4LSBitsRead(CRYPTO_TypeDef *crypto) |
| { |
| return (uint8_t)((crypto->DSTATUS & _CRYPTO_DSTATUS_DDATA0LSBS_MASK) |
| >> _CRYPTO_DSTATUS_DDATA0LSBS_SHIFT); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Read 260 bits from the DDATA0 register. |
| * |
| * @details |
| * This functions reads 260 bits from the DDATA0 register in the CRYPTO |
| * module. The data value is typically output from a big integer operation |
| * (see crypto instructions) when the result width is set to 260 bits by |
| * calling @ref CRYPTO_ResultWidthSet(cryptoResult260Bits); |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[out] val |
| * A location to store the value in memory. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_DData0Read260(CRYPTO_TypeDef *crypto, |
| CRYPTO_Data260_TypeDef val) |
| { |
| CRYPTO_DDataRead(&crypto->DDATA0, val); |
| val[8] = (crypto->DSTATUS & _CRYPTO_DSTATUS_DDATA0MSBS_MASK) |
| >> _CRYPTO_DSTATUS_DDATA0MSBS_SHIFT; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Write 260 bits to the DDATA0 register. |
| * |
| * @details |
| * This functions writes 260 bits to the DDATA0 register in the CRYPTO |
| * module. The data value is typically input to a big integer operation |
| * (see crypto instructions) when the result width is set to 260 bits by |
| * calling @ref CRYPTO_ResultWidthSet(cryptoResult260Bits); |
| * |
| * @param[in] crypto |
| * Pointer to CRYPTO peripheral register block. |
| * |
| * @param[out] val |
| * Location where of the value in memory. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_DData0Write260(CRYPTO_TypeDef *crypto, |
| const CRYPTO_Data260_TypeDef val) |
| { |
| CRYPTO_DDataWrite(&crypto->DDATA0, val); |
| crypto->DDATA0BYTE32 = val[8] & _CRYPTO_DDATA0BYTE32_DDATA0BYTE32_MASK; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Quick read the MSbit of the DDATA1 register. |
| * |
| * @details |
| * This function reads the most significant bit (bit 255) of the DDATA1 |
| * register via the DDATA1MSB bit field in the DSTATUS register. This can |
| * be used to quickly check the signedness of a big integer resident in the |
| * CRYPTO module. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @return |
| * Returns 'true' if MSbit is 1, and 'false' if MSbit is 0. |
| ******************************************************************************/ |
| __STATIC_INLINE bool CRYPTO_DData1_MSBitRead(CRYPTO_TypeDef *crypto) |
| { |
| return ((crypto->DSTATUS & _CRYPTO_DSTATUS_DDATA1MSB_MASK) |
| >> _CRYPTO_DSTATUS_DDATA1MSB_SHIFT) != 0UL; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Load a sequence of instructions to be executed on the current values in |
| * the data registers. |
| * |
| * @details |
| * This function loads a sequence of instructions to the crypto module. The |
| * instructions will be executed when the CRYPTO_InstructionSequenceExecute |
| * function is called. The first END marks the end of the sequence. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] instructionSequence |
| * An instruction sequence to load. |
| ******************************************************************************/ |
| __STATIC_INLINE |
| void CRYPTO_InstructionSequenceLoad(CRYPTO_TypeDef *crypto, |
| const CRYPTO_InstructionSequence_TypeDef instructionSequence) |
| { |
| const uint32_t * pas = (const uint32_t *) instructionSequence; |
| |
| crypto->SEQ0 = pas[0]; |
| crypto->SEQ1 = pas[1]; |
| crypto->SEQ2 = pas[2]; |
| crypto->SEQ3 = pas[3]; |
| crypto->SEQ4 = pas[4]; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Execute the current programmed instruction sequence. |
| * |
| * @details |
| * This function starts the execution of the current instruction sequence |
| * in the CRYPTO module. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_InstructionSequenceExecute(CRYPTO_TypeDef *crypto) |
| { |
| /* Start the command sequence. */ |
| crypto->CMD = CRYPTO_CMD_SEQSTART; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Check whether the execution of an instruction sequence has completed. |
| * |
| * @details |
| * This function checks whether an instruction sequence has completed. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @return |
| * Returns 'true' if the instruction sequence is done, and 'false' if not. |
| ******************************************************************************/ |
| __STATIC_INLINE bool CRYPTO_InstructionSequenceDone(CRYPTO_TypeDef *crypto) |
| { |
| /* Return true if operation has completed. */ |
| return (crypto->STATUS |
| & (CRYPTO_STATUS_INSTRRUNNING | CRYPTO_STATUS_SEQRUNNING)) == 0UL; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Wait for completion of the current sequence of instructions. |
| * |
| * @details |
| * This function "busy"-waits until the execution of the ongoing instruction |
| * sequence has completed. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_InstructionSequenceWait(CRYPTO_TypeDef *crypto) |
| { |
| while (!CRYPTO_InstructionSequenceDone(crypto)) { |
| } |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Wait for completion of the current command. |
| * |
| * @details |
| * This function "busy"-waits until the execution of the ongoing instruction |
| * has completed. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_InstructionWait(CRYPTO_TypeDef *crypto) |
| { |
| /* Wait for completion */ |
| while ((crypto->IF & CRYPTO_IF_INSTRDONE) == 0UL) { |
| } |
| crypto->IFC = CRYPTO_IF_INSTRDONE; |
| } |
| |
| void CRYPTO_SHA_1(CRYPTO_TypeDef *crypto, |
| const uint8_t *msg, |
| uint64_t msgLen, |
| CRYPTO_SHA1_Digest_TypeDef digest); |
| |
| void CRYPTO_SHA_256(CRYPTO_TypeDef *crypto, |
| const uint8_t *msg, |
| uint64_t msgLen, |
| CRYPTO_SHA256_Digest_TypeDef digest); |
| |
| void CRYPTO_Mul(CRYPTO_TypeDef *crypto, |
| uint32_t * A, int aSize, |
| uint32_t * B, int bSize, |
| uint32_t * R, int rSize); |
| |
| void CRYPTO_AES_CBC128(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt); |
| |
| void CRYPTO_AES_CBC256(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt); |
| |
| void CRYPTO_AES_CFB128(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt); |
| |
| void CRYPTO_AES_CFB256(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt); |
| |
| void CRYPTO_AES_CTR128(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| uint8_t * ctr, |
| CRYPTO_AES_CtrFuncPtr_TypeDef ctrFunc); |
| |
| void CRYPTO_AES_CTR256(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| uint8_t * ctr, |
| CRYPTO_AES_CtrFuncPtr_TypeDef ctrFunc); |
| |
| void CRYPTO_AES_CTRUpdate32Bit(uint8_t * ctr); |
| void CRYPTO_AES_DecryptKey128(CRYPTO_TypeDef *crypto, uint8_t * out, const uint8_t * in); |
| void CRYPTO_AES_DecryptKey256(CRYPTO_TypeDef *crypto, uint8_t * out, const uint8_t * in); |
| |
| void CRYPTO_AES_ECB128(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| bool encrypt); |
| |
| void CRYPTO_AES_ECB256(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| bool encrypt); |
| |
| void CRYPTO_AES_OFB128(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv); |
| |
| void CRYPTO_AES_OFB256(CRYPTO_TypeDef *crypto, |
| uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv); |
| |
| /***************************************************************************//** |
| * @brief |
| * Clear one or more pending CRYPTO interrupts. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] flags |
| * A pending CRYPTO interrupt source to clear. Use a bitwise logic OR combination of |
| * valid interrupt flags for the CRYPTO module (CRYPTO_IF_nnn). |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_IntClear(CRYPTO_TypeDef *crypto, uint32_t flags) |
| { |
| crypto->IFC = flags; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Disable one or more CRYPTO interrupts. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] flags |
| * CRYPTO interrupt sources to disable. Use a bitwise logic OR combination of |
| * valid interrupt flags for the CRYPTO module (CRYPTO_IF_nnn). |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_IntDisable(CRYPTO_TypeDef *crypto, uint32_t flags) |
| { |
| crypto->IEN &= ~(flags); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Enable one or more CRYPTO interrupts. |
| * |
| * @note |
| * Depending on the use, a pending interrupt may already be set prior to |
| * enabling the interrupt. Consider using CRYPTO_IntClear() prior to enabling |
| * if such a pending interrupt should be ignored. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] flags |
| * CRYPTO interrupt sources to enable. Use a bitwise logic OR combination of |
| * valid interrupt flags for the CRYPTO module (CRYPTO_IF_nnn). |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_IntEnable(CRYPTO_TypeDef *crypto, uint32_t flags) |
| { |
| crypto->IEN |= flags; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Get pending CRYPTO interrupt flags. |
| * |
| * @note |
| * The event bits are not cleared by the use of this function. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @return |
| * CRYPTO interrupt sources pending. A bitwise logic OR combination of valid |
| * interrupt flags for the CRYPTO module (CRYPTO_IF_nnn). |
| ******************************************************************************/ |
| __STATIC_INLINE uint32_t CRYPTO_IntGet(CRYPTO_TypeDef *crypto) |
| { |
| return crypto->IF; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Get enabled and pending CRYPTO interrupt flags. |
| * Useful for handling more interrupt sources in the same interrupt handler. |
| * |
| * @note |
| * Interrupt flags are not cleared by the use of this function. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @return |
| * Pending and enabled CRYPTO interrupt sources |
| * The return value is the bitwise AND of |
| * - the enabled interrupt sources in CRYPTO_IEN and |
| * - the pending interrupt flags CRYPTO_IF |
| ******************************************************************************/ |
| __STATIC_INLINE uint32_t CRYPTO_IntGetEnabled(CRYPTO_TypeDef *crypto) |
| { |
| uint32_t tmp; |
| |
| /* Store IEN in temporary variable in order to define explicit order |
| * of volatile accesses. */ |
| tmp = crypto->IEN; |
| |
| /* Bitwise AND of pending and enabled interrupts */ |
| return crypto->IF & tmp; |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Set one or more pending CRYPTO interrupts from software. |
| * |
| * @param[in] crypto |
| * A pointer to the CRYPTO peripheral register block. |
| * |
| * @param[in] flags |
| * CRYPTO interrupt sources to set to pending. Use a bitwise logic OR combination |
| * of valid interrupt flags for the CRYPTO module (CRYPTO_IF_nnn). |
| ******************************************************************************/ |
| __STATIC_INLINE void CRYPTO_IntSet(CRYPTO_TypeDef *crypto, uint32_t flags) |
| { |
| crypto->IFS = flags; |
| } |
| |
| /******************************************************************************* |
| ***** Static inline wrappers for CRYPTO AES functions to ***** |
| ***** preserve backwards compatibility with AES module API functions. ***** |
| ******************************************************************************/ |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Cipher-block chaining (CBC) cipher mode encryption/decryption, |
| * 128 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CBC128 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CBC128(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt) |
| { |
| CRYPTO_AES_CBC128(DEFAULT_CRYPTO, out, in, len, key, iv, encrypt); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Cipher-block chaining (CBC) cipher mode encryption/decryption, 256 bit |
| * key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CBC256 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CBC256(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt) |
| { |
| CRYPTO_AES_CBC256(DEFAULT_CRYPTO, out, in, len, key, iv, encrypt); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Cipher feedback (CFB) cipher mode encryption/decryption, 128 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CFB128 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CFB128(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt) |
| { |
| CRYPTO_AES_CFB128(DEFAULT_CRYPTO, out, in, len, key, iv, encrypt); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Cipher feedback (CFB) cipher mode encryption/decryption, 256 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CFB256 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CFB256(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv, |
| bool encrypt) |
| { |
| CRYPTO_AES_CFB256(DEFAULT_CRYPTO, out, in, len, key, iv, encrypt); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Counter (CTR) cipher mode encryption/decryption, 128 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CTR128 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CTR128(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| uint8_t * ctr, |
| CRYPTO_AES_CtrFuncPtr_TypeDef ctrFunc) |
| { |
| CRYPTO_AES_CTR128(DEFAULT_CRYPTO, out, in, len, key, ctr, ctrFunc); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Counter (CTR) cipher mode encryption/decryption, 256 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CTR256 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CTR256(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| uint8_t * ctr, |
| CRYPTO_AES_CtrFuncPtr_TypeDef ctrFunc) |
| { |
| CRYPTO_AES_CTR256(DEFAULT_CRYPTO, out, in, len, key, ctr, ctrFunc); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Update last 32 bits of 128 bit counter, by incrementing with 1. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_CTRUpdate32Bit instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_CTRUpdate32Bit(uint8_t * ctr) |
| { |
| CRYPTO_AES_CTRUpdate32Bit(ctr); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Generate 128 bit AES decryption key from 128 bit encryption key. The |
| * decryption key is used for some cipher modes when decrypting. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_DecryptKey128 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_DecryptKey128(uint8_t * out, const uint8_t * in) |
| { |
| CRYPTO_AES_DecryptKey128(DEFAULT_CRYPTO, out, in); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * Generate 256 bit AES decryption key from 256 bit encryption key. The |
| * decryption key is used for some cipher modes when decrypting. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_DecryptKey256 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_DecryptKey256(uint8_t * out, const uint8_t * in) |
| { |
| CRYPTO_AES_DecryptKey256(DEFAULT_CRYPTO, out, in); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Electronic Codebook (ECB) cipher mode encryption/decryption, |
| * 128 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_ECB128 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_ECB128(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| bool encrypt) |
| { |
| CRYPTO_AES_ECB128(DEFAULT_CRYPTO, out, in, len, key, encrypt); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Electronic Codebook (ECB) cipher mode encryption/decryption, |
| * 256 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_ECB256 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_ECB256(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| bool encrypt) |
| { |
| CRYPTO_AES_ECB256(DEFAULT_CRYPTO, out, in, len, key, encrypt); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Output feedback (OFB) cipher mode encryption/decryption, 128 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_OFB128 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_OFB128(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv) |
| { |
| CRYPTO_AES_OFB128(DEFAULT_CRYPTO, out, in, len, key, iv); |
| } |
| |
| /***************************************************************************//** |
| * @brief |
| * AES Output feedback (OFB) cipher mode encryption/decryption, 256 bit key. |
| * |
| * @deprecated |
| * This function preserves backwards compatibility. Use |
| * @ref CRYPTO_AES_OFB256 instead. |
| ******************************************************************************/ |
| __STATIC_INLINE void AES_OFB256(uint8_t * out, |
| const uint8_t * in, |
| unsigned int len, |
| const uint8_t * key, |
| const uint8_t * iv) |
| { |
| CRYPTO_AES_OFB256(DEFAULT_CRYPTO, out, in, len, key, iv); |
| } |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| /** @} (end addtogroup CRYPTO) */ |
| /** @} (end addtogroup emlib) */ |
| |
| #endif /* defined(CRYPTO_COUNT) && (CRYPTO_COUNT > 0) */ |
| |
| #endif /* EM_CRYPTO_H */ |