CryptoCC32XX.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2016, Texas Instruments Incorporated
 * 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 Texas Instruments Incorporated 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.
 */
#ifndef ti_drivers_crypto_CryptoCC32XX__include
#define ti_drivers_crypto_CryptoCC32XX__include

#ifdef __cplusplus
extern "C" {
#endif


#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>
#include <ti/drivers/dpl/HwiP.h>
#include <ti/drivers/dpl/SemaphoreP.h>


#define CryptoCC32XX_CMD_RESERVED             32

#define CryptoCC32XX_STATUS_RESERVED          -32

#define CryptoCC32XX_STATUS_SUCCESS           0

#define CryptoCC32XX_STATUS_ERROR             -1

#define CryptoCC32XX_STATUS_UNDEFINEDCMD      -2

#define CryptoCC32XX_STATUS_ERROR_VERIFY      -3

#define CryptoCC32XX_STATUS_ERROR_NOT_SUPPORTED -4


#define CryptoCC32XX_MAX_TYPES                3


typedef enum
{
    CryptoCC32XX_AES = 0x01,     
    CryptoCC32XX_DES = 0x02,     
    CryptoCC32XX_HMAC = 0x04,    
}CryptoCC32XX_Type;

typedef enum
{
    CryptoCC32XX_AES_ECB = (CryptoCC32XX_AES << 8) | 1, 
    CryptoCC32XX_AES_CBC,                         
    CryptoCC32XX_AES_CTR,                         
    CryptoCC32XX_AES_ICM,                         
    CryptoCC32XX_AES_CFB,                         
    CryptoCC32XX_AES_GCM,                         
    CryptoCC32XX_AES_CCM,                         
    CryptoCC32XX_DES_ECB = (CryptoCC32XX_DES << 8) | 1, 
    CryptoCC32XX_DES_CBC,                         
    CryptoCC32XX_DES_CFB,                         
}CryptoCC32XX_EncryptMethod;

typedef enum
{
    CryptoCC32XX_HMAC_MD5 = (CryptoCC32XX_HMAC << 8) | 1,   
    CryptoCC32XX_HMAC_SHA1,                           
    CryptoCC32XX_HMAC_SHA224,                         
    CryptoCC32XX_HMAC_SHA256                          
}CryptoCC32XX_HmacMethod;

typedef enum
{
    CryptoCC32XX_AES_KEY_SIZE_128BIT,
    CryptoCC32XX_AES_KEY_SIZE_192BIT,
    CryptoCC32XX_AES_KEY_SIZE_256BIT

}CryptoCC32XX_AesKeySize;

typedef enum
{
    CryptoCC32XX_DES_KEY_SIZE_SINGLE,
    CryptoCC32XX_DES_KEY_SIZE_TRIPLE

}CryptoCC32XX_DesKeySize;


typedef struct
{
    uint8_t                 *pKey2;     
    CryptoCC32XX_AesKeySize       key2Size;   
    size_t                  len;        
}CryptoCC32XX_AesAadInputParams;

typedef union
{
    CryptoCC32XX_AesAadInputParams    input;   
    uint8_t                     tag[16]; 
}CryptoCC32XX_AesAadParams;

typedef struct
{
    const uint8_t           *pKey;       
    CryptoCC32XX_AesKeySize       keySize;    
    void                    *pIV;       
    CryptoCC32XX_AesAadParams     aadParams;
}CryptoCC32XX_AesParams;

typedef struct
{
    const uint8_t           *pKey;       
    CryptoCC32XX_DesKeySize       keySize;    
    void                    *pIV;       
}CryptoCC32XX_DesParams;

typedef union
{
    CryptoCC32XX_AesParams        aes;
    CryptoCC32XX_DesParams        des;
}CryptoCC32XX_EncryptParams;

typedef struct
{
    uint8_t                 *pKey; 
    uint8_t                 moreData;  
    void                    *pContext;
}CryptoCC32XX_HmacParams;

typedef struct CryptoCC32XX_Config    *CryptoCC32XX_Handle;


typedef struct CryptoCC32XX_Object {
    /* Interrupt handles */
    HwiP_Handle     hwiHandle[CryptoCC32XX_MAX_TYPES];
    /* flag to indicate module is open */
    bool            isOpen;
    /* Semaphore handles */
    SemaphoreP_Handle   sem[CryptoCC32XX_MAX_TYPES];
} CryptoCC32XX_Object;


typedef struct CryptoCC32XX_Config {

    void               *object;

} CryptoCC32XX_Config;


void CryptoCC32XX_close(CryptoCC32XX_Handle handle);

void CryptoCC32XX_init(void);

CryptoCC32XX_Handle CryptoCC32XX_open(uint32_t index, uint32_t types);

int32_t CryptoCC32XX_encrypt(  CryptoCC32XX_Handle handle, CryptoCC32XX_EncryptMethod method ,
                            void *pInBuff, size_t inLen,
                            void *pOutBuff , size_t *outLen , CryptoCC32XX_EncryptParams *pParams);

int32_t CryptoCC32XX_decrypt(  CryptoCC32XX_Handle handle, CryptoCC32XX_EncryptMethod method ,
                            void *pInBuff, size_t inLen,
                            void *pOutBuff , size_t *outLen , CryptoCC32XX_EncryptParams *pParams);

int32_t CryptoCC32XX_sign( CryptoCC32XX_Handle handle, CryptoCC32XX_HmacMethod method ,
                        void *pBuff, size_t len,
                        uint8_t *pSignature, CryptoCC32XX_HmacParams *pParams);

int32_t CryptoCC32XX_verify(   CryptoCC32XX_Handle handle, CryptoCC32XX_HmacMethod method ,
                            void *pBuff, size_t len,
                            uint8_t *pSignature, CryptoCC32XX_HmacParams *pParams);


#ifdef __cplusplus
}
#endif

#endif /* ti_drivers_CryptoCC32XX__include */