AOA.h

Go to the documentation of this file.

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

 @file  AOA.h

 @brief This file contains typedefs and API functions of AOA.c
 Group: WCS, BTS
 $Target Device: DEVICES $

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

#ifndef AOA_H_
#define AOA_H_

#ifdef __cplusplus
extern "C"
{
#endif

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

#include <stdint.h>
#include <driverlib/ioc.h>
   
/*********************************************************************
 * CONSTANTS
 */

#define AOA_RES_MAX_SIZE                 512       
#define AOA_RES_MAX_CTE_TIME             20        
#define AOA_NUM_ANTENNAS                 3         

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

#define AOA_PIN(x)                       (1 << (x&0xff))

// Antenna array ID's
#define ANT_ARRAY_1 1
#define ANT_ARRAY_2 2

// Passive antenna configuration
#define ANT_ARRAY (27)
#define ANT1      (28)
#define ANT2      (29)
#define ANT3      (30)

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

typedef enum
{
  AOA_ROLE_SLAVE,    
  AOA_ROLE_MASTER,   
  AOA_ROLE_PASSIVE   
} AoA_Role;

typedef struct
{
  uint32_t *signalStrength; 
  int16_t *pairAngle;       
  int8_t *channelOffset;    
  int8_t rssi;              
  uint8_t ch;               
  uint8_t updated;          
} AoA_AntennaResult;

typedef struct
{
  AoA_AntennaResult *antA1Result;    
  AoA_AntennaResult *antA2Result;    
} AoA_Results_t;

typedef struct
{
  uint8_t a ;    
  uint8_t b ;    
  float d;       
  int8_t sign;   
  int8_t offset; 
  float gain;    
} AoA_AntennaPair;

typedef struct
{
  uint8_t numAntennas;    
  uint8_t numPairs;       
  AoA_AntennaPair *pairs; 
} AoA_AntennaConfig;

typedef struct
{
  int16_t q;  
  int16_t i;  
} AoA_IQSample;
typedef enum
{
  SAMPLES_NOT_READY,
  SAMPLES_NOT_VALID,
  SAMPLES_READY
} AoA_IQSampleState;

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

extern AoA_AntennaConfig BOOSTXL_AoA_Config_ArrayA1;    
extern AoA_AntennaResult BOOSTXL_AoA_Result_ArrayA1;    

extern AoA_AntennaConfig BOOSTXL_AoA_Config_ArrayA2;    
extern AoA_AntennaResult BOOSTXL_AoA_Result_ArrayA2;    

#ifdef RTLS_PASSIVE

void AOA_getPairAngles(void);
#elif RTLS_MASTER

void AOA_getPairAngles(uint16_t numIqSamples, uint8_t sampleRate, uint8_t numAnt, uint16_t *pI, uint16_t *pQ);
#endif

void AOA_cteCapDisable(void);

void AOA_setupNextRun(uint8_t antArraySwitchIo);

void AOA_init(AoA_Results_t *aoaResults);

void AOA_cteCapEnable(uint8_t cteTime, uint8_t cteScanOvs, uint8_t cteOffset);

uint16_t AOA_calcNumOfCteSamples(uint8_t cteTime, uint8_t cteScanOvs, uint8_t cteOffset);

void AOA_postProcess(int8_t rssi, uint8_t channel, AoA_IQSample *samplesBuff);

AoA_IQSample *AOA_getRawSamples(void);

uint8_t AOA_getActiveAnt(void);

AoA_IQSampleState AOA_getSampleState(void);
/*********************************************************************
*********************************************************************/

#ifdef __cplusplus
}
#endif

#endif /* AOA_H_ */