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>
#include "ant_array2_config_boostxl_rev1v1.h"

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

#define AOA_RES_MAX_SIZE                 512       
#define AOA_RES_MAX_CTE_TIME             20        

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

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

// Antenna configuration for BOOSTXL-AOA
#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_t;

typedef struct
{
  int16_t *pairAngle;       
  int8_t rssi;              
  uint8_t ch;               
} AoA_AntennaResult_t;

typedef struct
{
  // Note that Passive takes the samples directly from RF core RAM
  // Hence the format is different than the Master
#ifdef RTLS_PASSIVE
  int16_t q;  
  int16_t i;  
#else
  int16_t i;  
  int16_t q;  
#endif
} AoA_IQSample_Ext_t;

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

typedef enum
{
  SAMPLES_NOT_READY,
  SAMPLES_NOT_VALID,
  SAMPLES_READY
} AoA_IQSampleState_t;

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

#ifdef RTLS_PASSIVE

void AOA_getPairAngles(AoA_AntennaConfig_t *antConfig, AoA_AntennaResult_t *antResult);
#elif RTLS_MASTER
/***
* @brief   Extract results and estimates an angle between two antennas
*
* @param   antConfig - antenna configuration provided from antenna files
* @param   antResult - struct to write results into
* @param   numIqSamples - number of I and Q samples
* @param   sampleRate - sample rate that was used to capture (1,2,3 or 4 Mhz)
* @param   sampleSize - sample size 1 = 8 bit, 2 = 16 bit
* @param   numAnt - number of antennas in capture array
* @param   pIQ - pointer to IQ samples
*
* @return  none
*/
void AOA_getPairAngles(AoA_AntennaConfig_t *antConfig, AoA_AntennaResult_t *antResult, uint16_t numIqSamples, uint8_t sampleRate, uint8_t sampleSize, uint8_t slotDuration, uint8_t numAnt, int8_t *pIQ);
#endif

void AOA_init(uint8_t startAntenna);

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_Ext_t *samplesBuff);

#ifdef RTLS_PASSIVE

AoA_IQSample_Ext_t *AOA_getRawSamples(void);
#endif

uint8_t AOA_getActiveAnt(void);

AoA_IQSampleState_t AOA_getSampleState(void);
/*********************************************************************
*********************************************************************/

#ifdef __cplusplus
}
#endif

#endif /* AOA_H_ */