TI BLE5-Stack API Documentation  2.01.03.00
Modules | Files | Macros | Enumerations | Functions
AOA

This module implements the Angle of Arrival (AOA) More...

Modules

 AOA Structures
 

Files

file  AOA.h
 AOA interface.
 

Macros

#define ANT1   (28)
 
#define ANT2   (29)
 
#define ANT3   (30)
 
#define ANT_ARRAY   (27)
 
#define AOA_PIN(x)   (1 << (x&0xff))
 Relevant only for RTLS Passive.
 
#define AOA_RES_MAX_CTE_TIME   20
 CTE Time at maximum resolution.
 
#define AOA_RES_MAX_SIZE   512
 Relevent only for RTLS Passive. More...
 

Enumerations

enum  AoA_IQSampleState_t { SAMPLES_NOT_READY, SAMPLES_NOT_VALID, SAMPLES_READY }
 IQ Sample state - relevant for Passive.
 

Functions

uint16_t AOA_calcNumOfCteSamples (uint8_t cteTime, uint8_t cteScanOvs, uint8_t cteOffset)
 This function calculate the number of IQ samples based on the cte parameters from the CTEInfo header and our patch params. More...
 
void AOA_cteCapEnable (uint8_t cteTime, uint8_t cteScanOvs, uint8_t cteOffset)
 This function enables the CTE capture in the rf core. More...
 
uint8_t AOA_getActiveAnt (void)
 Returns active antenna id. More...
 
AoA_IQSampleState_t AOA_getSampleState (void)
 Returns active antenna id. More...
 
void AOA_init (uint8_t startAntenna)
 Initialize AoA for the defined role. More...
 
void AOA_postProcess (int8_t rssi, uint8_t channel, AoA_IQSample_Ext_t *samplesBuff)
 This function will update the final result report with rssi and channel For RTLS Passive it will also send a command to enable RF RAM so we can read the samples that we captured (if any) More...
 

Detailed Description

This module implements the Angle of Arrival (AOA)

Macro Definition Documentation

§ AOA_RES_MAX_SIZE

#define AOA_RES_MAX_SIZE   512

Relevent only for RTLS Passive.

Data Size at maximum resolution

Function Documentation

§ AOA_calcNumOfCteSamples()

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

This function calculate the number of IQ samples based on the cte parameters from the CTEInfo header and our patch params.

Parameters
cteTime- CTEInfo parameter defined in spec
cteScanOvs- used to enable CTE capturing and set the sampling rate in the IQ buffer
cteOffset- number of microseconds from the beginning of the tone until the sampling starts
Returns
uint16_t - The number of IQ samples to process

§ AOA_cteCapEnable()

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

This function enables the CTE capture in the rf core.

Parameters
cteTime- CTETime parameter defined in spec
cteScanOvs- used to enable CTE capturing and set the sampling rate in the IQ buffer
cteOffset- number of microseconds from the beginning of the tone until the sampling starts
Returns
None

§ AOA_getActiveAnt()

uint8_t AOA_getActiveAnt ( void  )

Returns active antenna id.

Returns
Pointer to raw I/Q samples

§ AOA_getSampleState()

AoA_IQSampleState_t AOA_getSampleState ( void  )

Returns active antenna id.

Returns
Pointer to Sample State

§ AOA_init()

void AOA_init ( uint8_t  startAntenna)

Initialize AoA for the defined role.

Parameters
startAntenna- start samples with antenna 1 or 2
Returns
none

§ AOA_postProcess()

void AOA_postProcess ( int8_t  rssi,
uint8_t  channel,
AoA_IQSample_Ext_t samplesBuff 
)

This function will update the final result report with rssi and channel For RTLS Passive it will also send a command to enable RF RAM so we can read the samples that we captured (if any)

Parameters
rssi- rssi to be stamped on final result
channel- channel to be stamped on final result
samplesBuff- buffer to copy samples to
© Copyright 1995-2020, Texas Instruments Incorporated. All rights reserved.
Trademarks | Privacy policy | Terms of use | Terms of sale