temp: nano33ble: add edk

Author: facchinm

variants/arduino_nano_33_ble_sense/includes.txt

@@ -0,0 +1,20 @@
+-iwithprefixbefore/llext-edk/include/zephyr/include/generated/zephyr 
+-iwithprefixbefore/llext-edk/include/zephyr/include 
+-iwithprefixbefore/llext-edk/include/zephyr/include/generated 
+-iwithprefixbefore/llext-edk/include/zephyr/soc/nordic 
+-iwithprefixbefore/llext-edk/include/zephyr/lib/libc/common/include 
+-iwithprefixbefore/llext-edk/include/zephyr/lib/posix/options/getopt/ 
+-iwithprefixbefore/llext-edk/include/zephyr/soc/nordic/nrf52/. 
+-iwithprefixbefore/llext-edk/include/zephyr/soc/nordic/common/. 
+-iwithprefixbefore/llext-edk/include/zephyr/subsys/usb/device 
+-iwithprefixbefore/llext-edk/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue 
+-iwithprefixbefore/llext-edk/include/zephyr/subsys/bluetooth 
+-iwithprefixbefore/llext-edk/include/zephyr/drivers/usb/common/nrf_usbd_common/. 
+-iwithprefixbefore/llext-edk/include/zephyr-arduino-core/include 
+-iwithprefixbefore/llext-edk/include/modules/hal/cmsis/CMSIS/Core/Include 
+-iwithprefixbefore/llext-edk/include/zephyr/modules/cmsis/. 
+-iwithprefixbefore/llext-edk/include/modules/hal/nordic/nrfx 
+-iwithprefixbefore/llext-edk/include/modules/hal/nordic/nrfx/drivers/include 
+-iwithprefixbefore/llext-edk/include/modules/hal/nordic/nrfx/mdk 
+-iwithprefixbefore/llext-edk/include/zephyr/modules/hal_nordic/nrfx/. 
+-iwithprefixbefore/llext-edk/include/modules/crypto/tinycrypt/lib/include

variants/arduino_nano_33_ble_sense/llext-edk/Makefile.cflags

@@ -0,0 +1,11 @@
+LLEXT_CFLAGS = -fno-strict-aliasing -fno-printf-return-value -fno-common -fdiagnostics-color=always -mcpu=cortex-m4 -mthumb -mabi=aapcs -mfp16-format=ieee -mtp=soft -Wall -Wformat -Wformat-security -Wformat -Wno-format-zero-length -Wdouble-promotion -Wno-pointer-sign -Wpointer-arith -Wexpansion-to-defined -Wno-unused-but-set-variable -Werror=implicit-int -fno-asynchronous-unwind-tables -ftls-model=local-exec -fno-reorder-functions --param=min-pagesize=0 -fno-defer-pop --specs=picolibc.specs -D_POSIX_THREADS -std=c99 -mlong-calls -mthumb -nodefaultlibs -imacros$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/zephyr/toolchain/zephyr_stdint.h -DLL_EXTENSION_BUILD -imacros$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated/zephyr/autoconf.h -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated/zephyr -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/lib/libc/common/include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/lib/posix/options/getopt/ -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic/nrf52/. -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic/common/. -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/usb/device -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/bluetooth -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/drivers/usb/common/nrf_usbd_common/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/cmsis/CMSIS/Core/Include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/modules/cmsis/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx/drivers/include -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx/mdk -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/modules/hal_nordic/nrfx/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/crypto/tinycrypt/lib/include
+
+LLEXT_ALL_INCLUDE_CFLAGS = -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated/zephyr -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/lib/libc/common/include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/lib/posix/options/getopt/ -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic/nrf52/. -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic/common/. -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/usb/device -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/bluetooth -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/drivers/usb/common/nrf_usbd_common/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/cmsis/CMSIS/Core/Include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/modules/cmsis/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx/drivers/include -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx/mdk -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/modules/hal_nordic/nrfx/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/crypto/tinycrypt/lib/include
+
+LLEXT_INCLUDE_CFLAGS = -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/lib/libc/common/include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/lib/posix/options/getopt/ -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic/nrf52/. -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/soc/nordic/common/. -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/usb/device -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/subsys/bluetooth -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/drivers/usb/common/nrf_usbd_common/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/cmsis/CMSIS/Core/Include -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/modules/cmsis/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx/drivers/include -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/hal/nordic/nrfx/mdk -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/modules/hal_nordic/nrfx/. -I$(LLEXT_EDK_INSTALL_DIR)/include/modules/crypto/tinycrypt/lib/include
+
+LLEXT_GENERATED_INCLUDE_CFLAGS = -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated/zephyr -I$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated
+
+LLEXT_BASE_CFLAGS = -fno-strict-aliasing -fno-printf-return-value -fno-common -fdiagnostics-color=always -mcpu=cortex-m4 -mthumb -mabi=aapcs -mfp16-format=ieee -mtp=soft -Wall -Wformat -Wformat-security -Wformat -Wno-format-zero-length -Wdouble-promotion -Wno-pointer-sign -Wpointer-arith -Wexpansion-to-defined -Wno-unused-but-set-variable -Werror=implicit-int -fno-asynchronous-unwind-tables -ftls-model=local-exec -fno-reorder-functions --param=min-pagesize=0 -fno-defer-pop --specs=picolibc.specs -D_POSIX_THREADS -std=c99 -mlong-calls -mthumb -nodefaultlibs -imacros$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/zephyr/toolchain/zephyr_stdint.h -DLL_EXTENSION_BUILD
+
+LLEXT_GENERATED_IMACROS_CFLAGS = -imacros$(LLEXT_EDK_INSTALL_DIR)/include/zephyr/include/generated/zephyr/autoconf.h

variants/arduino_nano_33_ble_sense/llext-edk/cmake.cflags

@@ -0,0 +1,11 @@
+set(LLEXT_CFLAGS -fno-strict-aliasing;-fno-printf-return-value;-fno-common;-fdiagnostics-color=always;-mcpu=cortex-m4;-mthumb;-mabi=aapcs;-mfp16-format=ieee;-mtp=soft;-Wall;-Wformat;-Wformat-security;-Wformat;-Wno-format-zero-length;-Wdouble-promotion;-Wno-pointer-sign;-Wpointer-arith;-Wexpansion-to-defined;-Wno-unused-but-set-variable;-Werror=implicit-int;-fno-asynchronous-unwind-tables;-ftls-model=local-exec;-fno-reorder-functions;--param=min-pagesize=0;-fno-defer-pop;--specs=picolibc.specs;-D_POSIX_THREADS;-std=c99;-mlong-calls;-mthumb;-nodefaultlibs;-imacros${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/zephyr/toolchain/zephyr_stdint.h;-DLL_EXTENSION_BUILD;-imacros${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated/zephyr/autoconf.h;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated/zephyr;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/lib/libc/common/include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/lib/posix/options/getopt/;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic/nrf52/.;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic/common/.;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/usb/device;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/bluetooth;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/drivers/usb/common/nrf_usbd_common/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/cmsis/CMSIS/Core/Include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/modules/cmsis/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx/drivers/include;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx/mdk;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/modules/hal_nordic/nrfx/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/crypto/tinycrypt/lib/include)
+
+set(LLEXT_ALL_INCLUDE_CFLAGS -I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated/zephyr;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/lib/libc/common/include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/lib/posix/options/getopt/;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic/nrf52/.;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic/common/.;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/usb/device;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/bluetooth;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/drivers/usb/common/nrf_usbd_common/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/cmsis/CMSIS/Core/Include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/modules/cmsis/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx/drivers/include;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx/mdk;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/modules/hal_nordic/nrfx/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/crypto/tinycrypt/lib/include)
+
+set(LLEXT_INCLUDE_CFLAGS -I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/lib/libc/common/include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/lib/posix/options/getopt/;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic/nrf52/.;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/soc/nordic/common/.;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/usb/device;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/bluetooth/controller/ll_sw/nordic/hal/nrf5/nrfx_glue;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/subsys/bluetooth;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/drivers/usb/common/nrf_usbd_common/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/cmsis/CMSIS/Core/Include;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/modules/cmsis/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx/drivers/include;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/hal/nordic/nrfx/mdk;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/modules/hal_nordic/nrfx/.;-I${CMAKE_CURRENT_LIST_DIR}/include/modules/crypto/tinycrypt/lib/include)
+
+set(LLEXT_GENERATED_INCLUDE_CFLAGS -I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated/zephyr;-I${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated)
+
+set(LLEXT_BASE_CFLAGS -fno-strict-aliasing;-fno-printf-return-value;-fno-common;-fdiagnostics-color=always;-mcpu=cortex-m4;-mthumb;-mabi=aapcs;-mfp16-format=ieee;-mtp=soft;-Wall;-Wformat;-Wformat-security;-Wformat;-Wno-format-zero-length;-Wdouble-promotion;-Wno-pointer-sign;-Wpointer-arith;-Wexpansion-to-defined;-Wno-unused-but-set-variable;-Werror=implicit-int;-fno-asynchronous-unwind-tables;-ftls-model=local-exec;-fno-reorder-functions;--param=min-pagesize=0;-fno-defer-pop;--specs=picolibc.specs;-D_POSIX_THREADS;-std=c99;-mlong-calls;-mthumb;-nodefaultlibs;-imacros${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/zephyr/toolchain/zephyr_stdint.h;-DLL_EXTENSION_BUILD)
+
+set(LLEXT_GENERATED_IMACROS_CFLAGS -imacros${CMAKE_CURRENT_LIST_DIR}/include/zephyr/include/generated/zephyr/autoconf.h)

variants/arduino_nano_33_ble_sense/llext-edk/include/modules/crypto/tinycrypt/lib/include/tinycrypt/aes.h

@@ -0,0 +1,130 @@
+/* aes.h - TinyCrypt interface to an AES-128 implementation */
+
+/*
+ *  Copyright (C) 2017 by Intel Corporation, All Rights Reserved.
+ *
+ *  Redistribution and use in source and binary forms, with or without
+ *  modification, are permitted provided that the following conditions are met:
+ *
+ *    - Redistributions of source code must retain the above copyright notice,
+ *     this list of conditions and the following disclaimer.
+ *
+ *    - Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ *    - Neither the name of Intel Corporation nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ *  POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file
+ * @brief -- Interface to an AES-128 implementation.
+ *
+ *  Overview:   AES-128 is a NIST approved block cipher specified in
+ *              FIPS 197. Block ciphers are deterministic algorithms that
+ *              perform a transformation specified by a symmetric key in fixed-
+ *              length data sets, also called blocks.
+ *
+ *  Security:   AES-128 provides approximately 128 bits of security.
+ *
+ *  Usage:      1) call tc_aes128_set_encrypt/decrypt_key to set the key.
+ *
+ *              2) call tc_aes_encrypt/decrypt to process the data.
+ */
+
+#ifndef __TC_AES_H__
+#define __TC_AES_H__
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define Nb (4)  /* number of columns (32-bit words) comprising the state */
+#define Nk (4)  /* number of 32-bit words comprising the key */
+#define Nr (10) /* number of rounds */
+#define TC_AES_BLOCK_SIZE (Nb*Nk)
+#define TC_AES_KEY_SIZE (Nb*Nk)
+
+typedef struct tc_aes_key_sched_struct {
+	unsigned int words[Nb*(Nr+1)];
+} *TCAesKeySched_t;
+
+/**
+ *  @brief Set AES-128 encryption key
+ *  Uses key k to initialize s
+ *  @return  returns TC_CRYPTO_SUCCESS (1)
+ *           returns TC_CRYPTO_FAIL (0) if: s == NULL or k == NULL
+ *  @note       This implementation skips the additional steps required for keys
+ *              larger than 128 bits, and must not be used for AES-192 or
+ *              AES-256 key schedule -- see FIPS 197 for details
+ *  @param      s IN/OUT -- initialized struct tc_aes_key_sched_struct
+ *  @param      k IN -- points to the AES key
+ */
+int tc_aes128_set_encrypt_key(TCAesKeySched_t s, const uint8_t *k);
+
+/**
+ *  @brief AES-128 Encryption procedure
+ *  Encrypts contents of in buffer into out buffer under key;
+ *              schedule s
+ *  @note Assumes s was initialized by aes_set_encrypt_key;
+ *              out and in point to 16 byte buffers
+ *  @return  returns TC_CRYPTO_SUCCESS (1)
+ *           returns TC_CRYPTO_FAIL (0) if: out == NULL or in == NULL or s == NULL
+ *  @param out IN/OUT -- buffer to receive ciphertext block
+ *  @param in IN -- a plaintext block to encrypt
+ *  @param s IN -- initialized AES key schedule
+ */
+int tc_aes_encrypt(uint8_t *out, const uint8_t *in, 
+		   const TCAesKeySched_t s);
+
+/**
+ *  @brief Set the AES-128 decryption key
+ *  Uses key k to initialize s
+ *  @return returns TC_CRYPTO_SUCCESS (1)
+ *          returns TC_CRYPTO_FAIL (0) if: s == NULL or k == NULL
+ *  @note       This is the implementation of the straightforward inverse cipher
+ *              using the cipher documented in FIPS-197 figure 12, not the
+ *              equivalent inverse cipher presented in Figure 15
+ *  @warning    This routine skips the additional steps required for keys larger
+ *              than 128, and must not be used for AES-192 or AES-256 key
+ *              schedule -- see FIPS 197 for details
+ *  @param s  IN/OUT -- initialized struct tc_aes_key_sched_struct
+ *  @param k  IN -- points to the AES key
+ */
+int tc_aes128_set_decrypt_key(TCAesKeySched_t s, const uint8_t *k);
+
+/**
+ *  @brief AES-128 Encryption procedure
+ *  Decrypts in buffer into out buffer under key schedule s
+ *  @return returns TC_CRYPTO_SUCCESS (1)
+ *          returns TC_CRYPTO_FAIL (0) if: out is NULL or in is NULL or s is NULL
+ *  @note   Assumes s was initialized by aes_set_encrypt_key
+ *          out and in point to 16 byte buffers
+ *  @param out IN/OUT -- buffer to receive ciphertext block
+ *  @param in IN -- a plaintext block to encrypt
+ *  @param s IN -- initialized AES key schedule
+ */
+int tc_aes_decrypt(uint8_t *out, const uint8_t *in, 
+		   const TCAesKeySched_t s);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __TC_AES_H__ */