mirror of
https://github.com/oliverschmidt/contiki.git
synced 2024-08-30 04:29:11 +00:00
Using the AES interrupt allows the user process not to waste time polling for the completion of the operation. This time can be used by the user process to do something else, or to let the system enter PM0. Since the system is now free to perform various operations during a crypto operation, a protection of the crypto resource is added, and PM1+ is prohibited in order not to stall crypto operations. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau.dev@gmail.com>
142 lines
6.2 KiB
C
142 lines
6.2 KiB
C
/*
|
|
* Original file:
|
|
* Copyright (C) 2012 Texas Instruments Incorporated - http://www.ti.com/
|
|
* All rights reserved.
|
|
*
|
|
* Port to Contiki:
|
|
* Copyright (c) 2013, ADVANSEE - http://www.advansee.com/
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. 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.
|
|
*
|
|
* 3. Neither the name of the copyright holder 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 HOLDER 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.
|
|
*/
|
|
/**
|
|
* \addtogroup cc2538-aes
|
|
* @{
|
|
*
|
|
* \defgroup cc2538-ccm cc2538 AES-CCM
|
|
*
|
|
* Driver for the cc2538 AES-CCM mode of the security core
|
|
* @{
|
|
*
|
|
* \file
|
|
* Header file for the cc2538 AES-CCM driver
|
|
*/
|
|
#ifndef CCM_H_
|
|
#define CCM_H_
|
|
|
|
#include "contiki.h"
|
|
#include "dev/aes.h"
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
/*---------------------------------------------------------------------------*/
|
|
/** \name AES-CCM driver return codes
|
|
* @{
|
|
*/
|
|
#define CCM_AUTHENTICATION_FAILED 7
|
|
/** @} */
|
|
/*---------------------------------------------------------------------------*/
|
|
/** \name AES-CCM functions
|
|
* @{
|
|
*/
|
|
|
|
/** \brief Starts the CCM authentication and encryption operation
|
|
* \param len_len Number of octets in length field (2, 4 or 8)
|
|
* \param key_area Area in Key RAM where the key is stored (0 to 7)
|
|
* \param nonce Pointer to nonce (15 - \p len_len octets)
|
|
* \param adata Pointer to additional authenticated data, or \c NULL
|
|
* \param adata_len Length of additional authenticated data in octets, or \c 0
|
|
* \param pdata Pointer to message to authenticate and encrypt, or \c NULL
|
|
* \param pdata_len Length of message to authenticate and encrypt in octets, or \c 0
|
|
* \param mic_len Number of octets in authentication field (even value between 0 and 16)
|
|
* \param process Process to be polled upon completion of the operation, or \c NULL
|
|
* \return \c CRYPTO_SUCCESS if successful, or CRYPTO/AES/CCM error code
|
|
*/
|
|
uint8_t ccm_auth_encrypt_start(uint8_t len_len, uint8_t key_area,
|
|
const void *nonce, const void *adata,
|
|
uint16_t adata_len, void *pdata,
|
|
uint16_t pdata_len, uint8_t mic_len,
|
|
struct process *process);
|
|
|
|
/** \brief Checks the status of the CCM authentication and encryption operation
|
|
* \retval false Result not yet available, and no error occurred
|
|
* \retval true Result available, or error occurred
|
|
*/
|
|
uint8_t ccm_auth_encrypt_check_status(void);
|
|
|
|
/** \brief Gets the result of the CCM authentication and encryption operation
|
|
* \param mic Pointer to authentication field, or \c NULL
|
|
* \param mic_len Number of octets in authentication field (even value between 0 and 16)
|
|
* \return \c CRYPTO_SUCCESS if successful, or CRYPTO/AES/CCM error code
|
|
* \note This function must be called only after \c ccm_auth_encrypt_start().
|
|
*/
|
|
uint8_t ccm_auth_encrypt_get_result(void *mic, uint8_t mic_len);
|
|
|
|
/** \brief Starts the CCM authentication checking and decryption operation
|
|
* \param len_len Number of octets in length field (2, 4 or 8)
|
|
* \param key_area Area in Key RAM where the key is stored (0 to 7)
|
|
* \param nonce Pointer to nonce (15 - \p len_len octets)
|
|
* \param adata Pointer to additional authenticated data, or \c NULL
|
|
* \param adata_len Length of additional authenticated data in octets, or \c 0
|
|
* \param cdata Pointer to encrypted and authenticated message
|
|
* \param cdata_len Length of encrypted and authenticated message in octets
|
|
* \param mic_len Number of octets in authentication field (even value between 0 and 16)
|
|
* \param process Process to be polled upon completion of the operation, or \c NULL
|
|
* \return \c CRYPTO_SUCCESS if successful, or CRYPTO/AES/CCM error code
|
|
*/
|
|
uint8_t ccm_auth_decrypt_start(uint8_t len_len, uint8_t key_area,
|
|
const void *nonce, const void *adata,
|
|
uint16_t adata_len, void *cdata,
|
|
uint16_t cdata_len, uint8_t mic_len,
|
|
struct process *process);
|
|
|
|
/** \brief Checks the status of the CCM authentication checking and decryption operation
|
|
* \retval false Result not yet available, and no error occurred
|
|
* \retval true Result available, or error occurred
|
|
*/
|
|
uint8_t ccm_auth_decrypt_check_status(void);
|
|
|
|
/** \brief Gets the result of the CCM authentication checking and decryption operation
|
|
* \param cdata Pointer to encrypted and authenticated message
|
|
* \param cdata_len Length of encrypted and authenticated message in octets
|
|
* \param mic Pointer to authentication field, or \c NULL
|
|
* \param mic_len Number of octets in authentication field (even value between 0 and 16)
|
|
* \return \c CRYPTO_SUCCESS if successful, or CRYPTO/AES/CCM error code
|
|
* \note This function must be called only after \c ccm_auth_decrypt_start().
|
|
*/
|
|
uint8_t ccm_auth_decrypt_get_result(const void *cdata, uint16_t cdata_len,
|
|
void *mic, uint8_t mic_len);
|
|
|
|
/** @} */
|
|
|
|
#endif /* CCM_H_ */
|
|
|
|
/**
|
|
* @}
|
|
* @}
|
|
*/
|