peripheral.h

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

 @file  peripheral.h

 @brief TI BLE GAP Peripheral Role for for RTOS Applications
        
        This GAP profile advertises and allows connections.

 Group: WCS, BTS
 $Target Device: DEVICES $

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

#ifndef PERIPHERAL_H
#define PERIPHERAL_H

#ifdef __cplusplus
extern "C"
{
#endif

/*-------------------------------------------------------------------
 * INCLUDES
 */

/*-------------------------------------------------------------------
 * CONSTANTS
 */

#define GAPROLE_PROFILEROLE         0x300  
#define GAPROLE_IRK                 0x301  
#define GAPROLE_SRK                 0x302  
#define GAPROLE_SIGNCOUNTER         0x303  
#define GAPROLE_BD_ADDR             0x304  
#define GAPROLE_ADVERT_ENABLED      0x305  
#define GAPROLE_ADVERT_OFF_TIME     0x306  
#define GAPROLE_ADVERT_DATA         0x307  
#define GAPROLE_SCAN_RSP_DATA       0x308  
#define GAPROLE_ADV_EVENT_TYPE      0x309  
#define GAPROLE_ADV_DIRECT_TYPE     0x30A  
#define GAPROLE_ADV_DIRECT_ADDR     0x30B  
#define GAPROLE_ADV_CHANNEL_MAP     0x30C  
#define GAPROLE_ADV_FILTER_POLICY   0x30D  
#define GAPROLE_CONNHANDLE          0x30E  
#define GAPROLE_RSSI_READ_RATE      0x30F  
#define GAPROLE_PARAM_UPDATE_ENABLE 0x310  
#define GAPROLE_MIN_CONN_INTERVAL   0x311  
#define GAPROLE_MAX_CONN_INTERVAL   0x312  
#define GAPROLE_SLAVE_LATENCY       0x313  
#define GAPROLE_TIMEOUT_MULTIPLIER  0x314  
#define GAPROLE_CONN_BD_ADDR        0x315  
#define GAPROLE_CONN_INTERVAL       0x316  
#define GAPROLE_CONN_LATENCY        0x317  
#define GAPROLE_CONN_TIMEOUT        0x318  
#define GAPROLE_PARAM_UPDATE_REQ    0x319  
#define GAPROLE_STATE               0x31A  
#define GAPROLE_ADV_NONCONN_ENABLED 0x31B  
#define GAPROLE_BD_ADDR_TYPE        0x31C  
#define GAPROLE_CONN_TERM_REASON    0x31D  
   

/*-------------------------------------------------------------------
 * TYPEDEFS
 */

typedef enum
{
  GAPROLE_INIT = 0,                       
  GAPROLE_STARTED,                        
  GAPROLE_ADVERTISING,                    
  GAPROLE_ADVERTISING_NONCONN,            
  GAPROLE_WAITING,                        
  GAPROLE_WAITING_AFTER_TIMEOUT,          
  GAPROLE_CONNECTED,                      
  GAPROLE_CONNECTED_ADV,                  
  GAPROLE_ERROR                           
} gaprole_States_t;

#define GAPROLE_NO_ACTION                    0 // Take no action upon unsuccessful parameter updates
#define GAPROLE_RESEND_PARAM_UPDATE          1 // Continue to resend request until successful update
#define GAPROLE_TERMINATE_LINK               2 // Terminate link upon unsuccessful parameter updates

#define GAPROLE_LINK_PARAM_UPDATE_WAIT_REMOTE_PARAMS   0 // Wait for parameter update request, respond with remote's requested parameters.
#define GAPROLE_LINK_PARAM_UPDATE_INITIATE_BOTH_PARAMS 1 // Initiate parameter update request, respond with best combination of local and remote parameters.
#define GAPROLE_LINK_PARAM_UPDATE_INITIATE_APP_PARAMS  2 // Initiate parameter update request, respond with local requested parameters only.
#define GAPROLE_LINK_PARAM_UPDATE_WAIT_APP_PARAMS      3 // Wait for parameter update request, respond with local requested parameters only.
#define GAPROLE_LINK_PARAM_UPDATE_WAIT_BOTH_PARAMS     4 // Wait for parameter update request, respond with best combination of local and remote parameters.
#define GAPROLE_LINK_PARAM_UPDATE_REJECT_REQUEST       5 // Reject all parameter update requests. 
#define GAPROLE_LINK_PARAM_UPDATE_NUM_OPTIONS          6 // Used for parameter checking.
/*-------------------------------------------------------------------
 * MACROS
 */

/*-------------------------------------------------------------------
 * Profile Callbacks
 */

typedef void (*gapRolesParamUpdateCB_t)(uint16_t connInterval,
                                        uint16_t connSlaveLatency,
                                        uint16_t connTimeout);

typedef void (*gapRolesStateNotify_t)(gaprole_States_t newState);

typedef struct
{
  gapRolesStateNotify_t    pfnStateChange;  
} gapRolesCBs_t;

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

extern bStatus_t GAPRole_SetParameter(uint16_t param, uint8_t len, void *pValue);

extern bStatus_t GAPRole_GetParameter(uint16_t param, void *pValue);

extern bStatus_t GAPRole_StartDevice(gapRolesCBs_t *pAppCallbacks);

extern bStatus_t GAPRole_TerminateConnection(void);

extern bStatus_t GAPRole_SendUpdateParam(uint16_t minConnInterval, 
                                         uint16_t maxConnInterval,
                                         uint16_t latency, uint16_t connTimeout,
                                         uint8_t handleFailure);

extern void GAPRole_RegisterAppCBs(gapRolesParamUpdateCB_t *pParamUpdateCB);

/*-------------------------------------------------------------------
 * TASK FUNCTIONS - Don't call these. These are system functions.
 */
   
extern void GAPRole_createTask(void);

/*-------------------------------------------------------------------
-------------------------------------------------------------------*/

#ifdef __cplusplus
}
#endif

#endif /* PERIPHERAL_H */