gapbondmgr.h

Go to the documentation of this file.

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

 Group: WCS, BTS
 $Target Device: DEVICES $

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

#ifndef GAPBONDMGR_H
#define GAPBONDMGR_H

#ifdef __cplusplus
extern "C"
{
#endif

/*-------------------------------------------------------------------
 * INCLUDES
 */
#include "gap.h"

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

#if !defined (GAP_BONDINGS_MAX)
  #define GAP_BONDINGS_MAX    10    
#endif

#if !defined (GAP_CHAR_CFG_MAX)
  #define GAP_CHAR_CFG_MAX    4    
#endif

#define GAPBOND_PAIRING_MODE          0x400

#define GAPBOND_INITIATE_WAIT         0x401

#define GAPBOND_MITM_PROTECTION       0x402

#define GAPBOND_IO_CAPABILITIES       0x403

#define GAPBOND_OOB_ENABLED           0x404

#define GAPBOND_OOB_DATA              0x405

#define GAPBOND_BONDING_ENABLED       0x406

#define GAPBOND_KEY_DIST_LIST         0x407

#define GAPBOND_DEFAULT_PASSCODE      0x408

#define GAPBOND_ERASE_ALLBONDS        0x409

#define GAPBOND_AUTO_FAIL_PAIRING     0x40A
#define GAPBOND_AUTO_FAIL_REASON      0x40B

#define GAPBOND_KEYSIZE               0x40C

#define GAPBOND_AUTO_SYNC_WL          0x40D

#define GAPBOND_BOND_COUNT            0x40E

#define GAPBOND_BOND_FAIL_ACTION      0x40F

#define GAPBOND_ERASE_SINGLEBOND      0x410

#define GAPBOND_SECURE_CONNECTION     0x411

#define GAPBOND_ECCKEY_REGEN_POLICY   0x412

#define GAPBOND_ECC_KEYS              0x413

#define GAPBOND_REMOTE_OOB_SC_ENABLED 0x414

#define GAPBOND_REMOTE_OOB_SC_DATA    0x415

#define GAPBOND_LOCAL_OOB_SC_ENABLED  0x416

#define GAPBOND_LOCAL_OOB_SC_DATA     0x417

#define GAPBOND_LRU_BOND_REPLACEMENT  0x418

#define GAPBOND_PAIRING_MODE_NO_PAIRING          0x00  
#define GAPBOND_PAIRING_MODE_WAIT_FOR_REQ        0x01  
#define GAPBOND_PAIRING_MODE_INITIATE            0x02  

#define GAPBOND_IO_CAP_DISPLAY_ONLY              0x00  
#define GAPBOND_IO_CAP_DISPLAY_YES_NO            0x01  
#define GAPBOND_IO_CAP_KEYBOARD_ONLY             0x02  
#define GAPBOND_IO_CAP_NO_INPUT_NO_OUTPUT        0x03  
#define GAPBOND_IO_CAP_KEYBOARD_DISPLAY          0x04  

#define GAPBOND_KEYDIST_SENCKEY                  0x01  
#define GAPBOND_KEYDIST_SIDKEY                   0x02  
#define GAPBOND_KEYDIST_SSIGN                    0x04  
#define GAPBOND_KEYDIST_SLINK                    0x08  
#define GAPBOND_KEYDIST_MENCKEY                  0x10  
#define GAPBOND_KEYDIST_MIDKEY                   0x20  
#define GAPBOND_KEYDIST_MSIGN                    0x40  
#define GAPBOND_KEYDIST_MLINK                    0x80  

#define GAPBOND_PAIRING_STATE_STARTED             0x00

#define GAPBOND_PAIRING_STATE_COMPLETE            0x01

#define GAPBOND_PAIRING_STATE_BONDED              0x02
#define GAPBOND_PAIRING_STATE_BOND_SAVED          0x03  
#define GAPBOND_PAIRING_STATE_CAR_READ            0x04  

#define SMP_PAIRING_FAILED_PASSKEY_ENTRY_FAILED   0x01 
#define SMP_PAIRING_FAILED_OOB_NOT_AVAIL          0x02 
#define SMP_PAIRING_FAILED_AUTH_REQ               0x03 
#define SMP_PAIRING_FAILED_CONFIRM_VALUE          0x04 
#define SMP_PAIRING_FAILED_NOT_SUPPORTED          0x05 
#define SMP_PAIRING_FAILED_ENC_KEY_SIZE           0x06 
#define SMP_PAIRING_FAILED_CMD_NOT_SUPPORTED      0x07 
#define SMP_PAIRING_FAILED_UNSPECIFIED            0x08 
#define SMP_PAIRING_FAILED_REPEATED_ATTEMPTS      0x09 
#define SMP_PAIRING_FAILED_INVALID_PARAMETERS     0x0A 
#define SMP_PAIRING_FAILED_DHKEY_CHECK_FAILED     0x0B 
#define SMP_PAIRING_FAILED_NUM_COMPARISON_FAILED  0x0C 

#define GAPBOND_FAIL_NO_ACTION                         0x00 
#define GAPBOND_FAIL_INITIATE_PAIRING                  0x01 
#define GAPBOND_FAIL_TERMINATE_LINK                    0x02 
#define GAPBOND_FAIL_TERMINATE_ERASE_BONDS             0x03 

#define GAPBOND_SECURE_CONNECTION_NONE                 0x00 
#define GAPBOND_SECURE_CONNECTION_ALLOW                0x01 
#define GAPBOND_SECURE_CONNECTION_ONLY                 0x02 

#define GAPBOND_REGENERATE_ALWAYS                       0x00 
#define GAPBOND_REGENERATE_NEVER                        0xFF 

// ECC Key Length
#define ECC_KEYLEN                                     32   


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

typedef void (*pfnPasscodeCB_t)
(
  uint8_t* deviceAddr,
  uint16_t connectionHandle,
  uint8_t  uiInputs,
  uint8_t  uiOutputs,
  uint32_t numComparison
);

typedef void (*pfnPairStateCB_t)
(
  uint16_t connectionHandle,
  uint8_t  state,
  uint8_t  status
);

/*
 * @brief GAPBondMgr Callback Structure
 *
 * This must be setup by the application and passed to the GAPRole when
 * @ref GAPBondMgr_Register is called.
 */
typedef struct
{
  pfnPasscodeCB_t     passcodeCB;       
  pfnPairStateCB_t    pairStateCB;      
} gapBondCBs_t;

typedef struct
{
  uint8_t privateKey[ECC_KEYLEN];           
  uint8_t publicKeyX[ECC_KEYLEN];           
  uint8_t publicKeyY[ECC_KEYLEN];           
} gapBondEccKeys_t;

typedef struct
{
  uint8_t addr[B_ADDR_LEN];    
  uint8_t confirm[KEYLEN]; 
  uint8_t oob[KEYLEN];     
} gapBondOobSC_t;

/*-------------------------------------------------------------------
 * MACROS
 */

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

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

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

extern bStatus_t GAPBondMgr_LinkEst(uint8_t addrType, uint8_t *pDevAddr, uint16_t connHandle, uint8_t role);

extern void GAPBondMgr_LinkTerm(uint16_t connHandle);

extern void GAPBondMgr_SlaveReqSecurity(uint16_t connHandle, uint8_t authReq);

extern uint8_t GAPBondMgr_ResolveAddr(uint8_t addrType, uint8_t *pDevAddr, uint8_t *pResolvedAddr);

extern bStatus_t GAPBondMgr_ServiceChangeInd(uint16_t connectionHandle, uint8_t setParam);

extern bStatus_t GAPBondMgr_UpdateCharCfg(uint16_t connectionHandle, uint16_t attrHandle, uint16_t value);

extern void GAPBondMgr_Register(gapBondCBs_t *pCB);

extern bStatus_t GAPBondMgr_PasscodeRsp(uint16_t connectionHandle, uint8_t status, uint32_t passcode);

extern bStatus_t GAPBondMgr_ReadCentAddrResChar(uint16_t connectionHandle);

extern uint8_t GAPBondMgr_SupportsEnhancedPriv(uint8_t *pPeerIdAddr);

extern uint8_t GAPBondMgr_ProcessGAPMsg(gapEventHdr_t *pMsg);

extern uint8_t GAPBondMgr_CheckNVLen(uint8_t id, uint8_t len);

extern bStatus_t GAPBondMgr_syncResolvingList(void);


/*-------------------------------------------------------------------
 * TASK FUNCTIONS - Don't call these. These are system functions.
 */

extern void GAPBondMgr_Init(uint8_t task_id);

extern uint16_t GAPBondMgr_ProcessEvent(uint8_t task_id, uint16_t events);

extern bStatus_t GAPBondMgr_Pair(uint16_t connHandle);


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

#ifdef __cplusplus
}
#endif

#endif /* GAPBONDMGR_H */