rtls_ctrl_api.h

Go to the documentation of this file.

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

 @file  rtls_ctrl_api.h

 @brief This file contains the RTLS Control API's

 Group: WCS, BTS
 $Target Device: DEVICES $

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

#ifndef RTLS_CTRL_API_H_
#define RTLS_CTRL_API_H_

#ifdef __cplusplus
extern "C"
{
#endif

/*********************************************************************
 * INCLUDES
 */
#include <stdint.h>

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

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

// RTLS Application Command Opcodes
#define RTLS_REQ_ENABLE_SYNC    0x1          
#define RTLS_REQ_CONN           0x2          
#define RTLS_REQ_SCAN           0x3          
#define RTLS_REQ_SEND_DATA      0x4          
#define RTLS_REQ_TERMINATE_LINK 0x5          
#define RTLS_REQ_SET_AOA_PARAMS 0x6          
#define RTLS_REQ_AOA_ENABLE     0x7          

// Chip Identifier Address
#define CHIP_ID_ADDR ((uint8_t *)(0x50001000 + 0x2E8)) 
#define CHIP_ID_SIZE  6                                

#define RTLS_FALSE    0        
#define RTLS_TRUE     1        

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

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

typedef void (*pfnRtlsAppCb)(uint8_t *cmd);

typedef enum
{
  RTLS_SUCCESS,
  RTLS_FAIL,
  RTLS_LINK_LOST,
  RTLS_LINK_ESTAB_FAIL,
  RTLS_LINK_TERMINATED,
  RTLS_OUT_OF_MEMORY,
  RTLS_ILLEGAL_CMD
} rtlsStatus_e;

typedef enum
{
  RTLS_CAP_NOT_INITIALIZED = 0x00000000,
  RTLS_CAP_CM              = 0x00000001,
  RTLS_CAP_AOA_TX          = 0x00000002,
  RTLS_CAP_AOA_RX          = 0x00000004,
  RTLS_CAP_TOF_SLAVE       = 0x00000008,
  RTLS_CAP_TOF_PASSIVE     = 0x00000010,
  RTLS_CAP_TOF_MASTER      = 0x00000020,
  RTLS_CAP_RTLS_SLAVE      = 0x00000040,
  RTLS_CAP_RTLS_MASTER     = 0x00000080,
  RTLS_CAP_RTLS_PASSIVE    = 0x00000100
} rtlsCapabilities_e;

typedef struct
{
  rtlsCapabilities_e rtlsCapab;        
  uint8_t identifier[CHIP_ID_SIZE];    
  pfnRtlsAppCb rtlsAppCb;              
} rtlsConfiguration_t;

typedef struct
{
  uint8_t reqOp;           
  uint8_t *pData;          
} rtlsCtrlReq_t;

typedef struct
{
  uint8_t cmdOp;           
  uint16_t payloadLen;     
  uint8_t pPayload[];      
} rtlsPacket_t;

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

void RTLSCtrl_open(rtlsConfiguration_t *rtlsConfig);

void RTLSCtrl_scanResultEvt(rtlsStatus_e status, uint8_t *scanResult, uint8_t size);

void RTLSCtrl_connResultEvt(uint8_t status);

void RTLSCtrl_connInfoEvt(uint8_t *connInfo, uint16_t connInfoLen);

void RTLSCtrl_processRtlsPacket(uint8_t *pPkt);

void RTLSCtrl_syncEventNotify(rtlsStatus_e status, uint32_t timeToNextEvent, int8_t rssi, uint8_t channel);

void RTLSCtrl_processDataSent(uint8_t status);

void RTLSCtrl_aoaResultEvt(int8_t rssi, uint8_t channel, uint16_t numIqSamples, uint8_t sampleRate, uint8_t numAnt, uint8_t antArraySwitchIo, uint16_t *pI, uint16_t *pQ);

void RTLSCtrl_sendDebugEvent(uint8_t *debug_string, uint32_t debug_value);

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


#ifdef __cplusplus
}
#endif

#endif /* RTLS_CTRL_API_H_ */