rtls_ctrl_tof.h

Go to the documentation of this file.

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

 @file  rtls_ctrl_tof.h

 @brief This file contains the functions and structures specific to
        ToF post processing
 Group: WCS, BTS
 $Target Device: DEVICES $

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


#ifndef RTLS_CTRL_TOF_H_
#define RTLS_CTRL_TOF_H_

#ifdef __cplusplus
extern "C"
{
#endif

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

#include "TOF.h"

/*********************************************************************
*  EXTERNAL VARIABLES
*/

/*********************************************************************
 * CONSTANTS
 */

#define RTLS_CTRL_TOF_RSSI_THRESHOLD_HYSTERESIS -5     
#define MAX_TOF_SAMPLES_SINGLE_CHUNK 16                

/*********************************************************************
 * MACROS
 */

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


typedef enum
{
  TOF_MODE_DIST,
  TOF_MODE_STAT,
  TOF_MODE_RAW
} tofResultMode_e;

typedef enum
{
  TOF_MODE_CONT,
  TOF_MODE_ONE_SHOT,
  TOF_MODE_AUTO
} tofRunMode_e;

typedef enum
{
  TOF_CALIB_NOT_INITIALIZED,
  TOF_CALIB_CALIBRATING,
  TOF_CALIB_CALIBRATED
} tofCalibState_e;

typedef struct
{
  int8_t          autoTofRssiTresh;   
  tofResultMode_e resultMode;         
  tofRunMode_e    runMode;            
  uint8_t         constSyncwords;     
} rtlsTofConfig_t;

typedef struct
{
  tofCalibState_e tofCalibState;  
  uint8_t runsForCalibration;     
  uint16_t calibrationOffset;     
  ToF_BurstStat *pCalibVals;      
} rtlsTofCalib_t;

typedef struct __attribute__((packed))
{
  ToF_Role        tofRole;            
  uint16_t        numBurstSamples;    
  uint8_t         numFreq;            
  rtlsTofConfig_t tofConfig;          
  uint16_t        frequencies[];      
} rtlsTofParams_t;

typedef struct __attribute__((packed))
{
  uint8_t seed[TOF_SEEDLEN];          
} rtlsTofSecSeed_t;

typedef struct __attribute__((packed))
{
  uint8_t enableTof;    
} rtlsEnableTofCmd_t;

typedef struct __attribute__((packed))
{
  uint8_t enableCalib;      
  uint16_t samplesPerFreq;  
  uint8_t calibDistance;    
} rtlsEnableTofCalib_t;

typedef struct __attribute__((packed))
{
  double distance;              
  int8_t rssi;                  
} rtlsTofResultDistance_t;

typedef struct __attribute__((packed))
{
  uint32_t tick;                
  uint8_t freqIdx;              
  int8_t rssi;                  
} rtlsTofResultRaw_t;

typedef struct __attribute__((packed))
{
  uint16_t offset;              
  uint16_t samplesLength;       
  rtlsTofResultRaw_t samples[]; 
} rtlsTofResultRawAggr_t;

typedef struct __attribute__((packed))
{
  uint16_t freq;                
  double tick;                  
  double tickVariance;          
  int8_t rssi;                  
  uint32_t numOk;               
} rtlsTofResultStat_t;

typedef struct
{
  ToF_Struct tofStruct;           
  ToF_Handle tofHandle;           
  rtlsTofConfig_t tofConfig;      
  rtlsTofCalib_t tofCalibInfo;    
  ToF_BurstStat *pTofLastRun;     
  ToF_BurstStat *pTofAverage;     
  uint8_t bTofValuesInitialized;  
  uint8_t bOneShotSuccessful;     
  uint8_t bSlaveTofParamPend;     
  uint8_t bSlaveTofEnabled;       
} rtlsTof_t;
/*********************************************************************
 * API FUNCTIONS
 */

void RTLSCtrl_postProcessTof(rtlsTof_t *tofControlBlock, int8_t rssi);

void RTLSCtrl_outputTofStat(uint8_t cmdId, uint16_t numFreq, ToF_BurstStat *tofStatArray, uint8_t rssi);

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

#ifdef __cplusplus
}
#endif

#endif /* RTLS_CTRL_TOF_H_ */