rtls_ctrl_aoa.h

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

 @file  rtls_ctrl_aoa.h

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

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

#ifndef RTLS_CTRL_AOA_H_
#define RTLS_CTRL_AOA_H_

#ifdef __cplusplus
extern "C"
{
#endif

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

#include "rtls_aoa_api.h"
#include "rtls_ctrl_api.h"
#include "rtls_ctrl.h"

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

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

#define MAX_SAMPLES_SINGLE_CHUNK 32     
#define SYNC_HANDLE_MASK         0x1000
#define REVERSE_SYNC_HANDLE      0x0FFF
/*********************************************************************
 * MACROS
 */

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

typedef enum
{
  AOA_RESPONDER,    
  AOA_COORDINATOR,  
  AOA_PASSIVE       
} AoA_Role_t;

typedef struct
{
  int16_t i;  
  int16_t q;  
} AoA_IQSample_Ext_t;

typedef struct
{
  int8_t i;  
  int8_t q;  
} AoA_IQSample_t;

typedef enum
{
  AOA_MODE_RAW
} aoaResultMode_e;

// AoA Parameters - Received from RTLS Node Manager
typedef struct __attribute__((packed))
{
  AoA_Role_t aoaRole;         
  aoaResultMode_e resultMode; 
  rtlsAoaConfigReq_t config;  
} rtlsAoaParams_t;

typedef struct __attribute__((packed))
{
  AoA_Role_t aoaRole;
  aoaResultMode_e resultMode;
  rtlsCLAoaEnableReq_t clParams;
} rtlsCLAoaParams_t;

typedef struct __attribute__((packed))
{
  uint16_t handle;              
  int8_t  rssi;                 
  uint8_t antenna;              
  uint8_t channel;              
  uint16_t offset;              
  uint16_t samplesLength;       
  AoA_IQSample_Ext_t samples[]; 
} rtlsAoaResultRaw_t;

// AoA post process event
typedef struct
{
  uint16_t handle;             
  int8_t rssi;                 
  uint8_t channel;             
  uint16_t numIqSamples;       
  uint8_t sampleRate;          
  uint8_t sampleSize;          
  uint8_t sampleCtrl;          
  uint8_t slotDuration;        
  uint8_t numAnt;              
  int8_t *pIQ;                 
} rtlsAoaIqEvt_t;

typedef struct
{
  AoA_Role_t aoaRole;          
  aoaResultMode_e resultMode;  
  uint8_t sampleCtrl;          
} rtlsAoa_t;

// A single AoA sample
typedef struct
{
  int16_t angle;
  int16_t currentangle;
  int8_t  rssi;
  uint8_t channel;
  uint8_t antenna;
} AoA_Sample_t;

// Moving average structure
typedef struct
{
  int16_t array[6];
  uint8_t idx;
  uint8_t numEntries;
  uint8_t currentAntennaArray;
  int16_t currentAoA;
  int8_t  currentRssi;
  uint8_t currentCh;
  int32_t AoAsum;
  int16_t AoA;
} AoA_movingAverage_t;

typedef struct
{
  uint8_t sampleCtrl;
  uint8_t resultMode;
} AoA_controlBlock_t;

/*********************************************************************
 * API FUNCTIONS
 */


void RTLSCtrl_postProcessAoa(rtlsAoaIqEvt_t *pEvt);

rtlsStatus_e RTLSCtrl_initAoa(uint8_t maxConnections, uint8_t sampleCtrl, uint8_t numAnt, uint8_t *pAntPattern, aoaResultMode_e resultMode);
rtlsStatus_e RTLSCtrl_clInitAoa(aoaResultMode_e resultMode, uint8_t sampleCtrl, uint8_t numAnt, uint8_t *pAntPattern, uint16_t syncHandle);

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

#ifdef __cplusplus
}
#endif

#endif /* RTLS_CTRL_AOA_H_ */