tof_security.h

Go to the documentation of this file.

/******************************************************************************

 @file  tof_security.h

 @brief This file contains methods to enable/disable and control TOF
 Group: WCS, BTS
 $Target Device: DEVICES $

 ******************************************************************************
 $License: BSD3 2018 $
 ******************************************************************************
 $Release Name: PACKAGE NAME $
 $Release Date: PACKAGE RELEASE DATE $
 *****************************************************************************/

#ifndef TOF_SECURITY_H_
#define TOF_SECURITY_H_

#ifdef __cplusplus
extern "C"
{
#endif

/*********************************************************************
 * INCLUDES
 */

#include <ti/drivers/AESCTRDRBG.h>

#include <stdint.h>

/*********************************************************************
 * MACROS
 */
#define NUM_ELEMENTS(x)                 (sizeof(x)/sizeof(x[0]))

/*********************************************************************
 * CONSTANTS
 */
#define TOF_SEC_FILL_BOTH_BUFFS         0x01  
#define TOF_SEC_FILL_1ST_BUFF           0x02  
#define TOF_SEC_FILL_2ND_BUFF           0x03  

#define TOF_SEC_SYNCWORD_SIZE           8     

#define TOF_SEC_DBL_BUFF_SIZE           16    

/*********************************************************************
 * TYPEDEFS
 */

typedef enum
{
  TOF_MODE_SINGLE_BUF = 0,     
  TOF_MODE_DBL_BUF             
} tofSecMode_e;

typedef enum 
{
  TOF_SEC_SUCCESS_E = 0,       
  TOF_SEC_GEN_FAIL_E,          
  TOF_SEC_AES_FAIL_E,          
  TOF_SEC_ALLOC_FAIL_E,        
  TOF_SEC_INVALID_PRMS_FAIL_E  
} tofSecErrRes_t;

typedef struct
{
  uint8_t             bUseDoubleBuffer;           
  uint16_t            syncWordSize;               
  uint16_t            totalNumOfSyncWords;        
} tofSecCfgPrms_t;

typedef struct
{
  tofSecCfgPrms_t     tofSecCfgParams;             

  // Sync Words
  uint16_t            numOfSyncWordsPerBuffer;     
  uint8_t             *pSyncWordBuffer1;           
  uint8_t             *pSyncWordBuffer2;           
  uint8_t             *pTempSyncWordBuffer;        

  // DRBG
  AESCTRDRBG_Handle   drbgHandle;                  

  // Seed
  uint8_t             seed[AESCTRDRBG_SEED_LENGTH_AES_128];      
} tofSecHandle_t;

/*********************************************************************
 * PUBLIC FUNCTIONS
 */

int TOFSecurity_paramsInit(tofSecHandle_t *tofSecHandle, tofSecCfgPrms_t *tofSecCfgPrms);

int TOFSecurity_open(tofSecHandle_t *tofSecHandle, uint8_t *seed);
int TOFSecurity_close(tofSecHandle_t *tofSecHandle);

int TOFSecurity_genSyncWords(tofSecHandle_t *tofSecHandle, uint8_t bufferToFill);

/*********************************************************************
*********************************************************************/

#ifdef __cplusplus
}
#endif

#endif // TOF_SECURITY_H_