Modules
	GAP Bond Manager Callbacks

	GAP Bond Manager Constants

	GAP Bond Manager Pairing State Events

	GAP Bond Manager Parameters

	GAP Bond Manager Structures

Files
file	gapbondmgr.h

Functions
bStatus_t	GAPBondMgr_FindAddr (uint8_t pDevAddr, GAP_Peer_Addr_Types_t addrType, uint8_t pIdx, GAP_Peer_Addr_Types_t pIdentityAddrType, uint8_t pIdentityAddr)
	Search for an address in the bonding table. If the address is a random private resolvable address, attempt to resolve the random address against all IRK's in bonding table. As output parameters, return the following: More...

bStatus_t	GAPBondMgr_GenerateEccKeys (void)
	Generates ECC keys. More...

bStatus_t	GAPBondMgr_GetParameter (uint16_t param, void *pValue)

bStatus_t	GAPBondMgr_Pair (uint16_t connHandle)

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

void	GAPBondMgr_Register (gapBondCBs_t *pCB)

bStatus_t	GAPBondMgr_SCGetLocalOOBParameters (gapBondOOBData_t *localOobData)
	Get local Random number and confirm value for secure connection. More...

bStatus_t	GAPBondMgr_SCSetRemoteOOBParameters (gapBondOOBData_t *remoteOobData, uint8 OOBDataFlag)
	Set remote's OOB parameters for secure connection. More...

bStatus_t	GAPBondMgr_ServiceChangeInd (uint16_t connectionHandle, uint8_t setParam)

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

uint8_t	gapBondMgrImportBond (gapBondRec_t pBondRec, gapBondLTK_t pLocalLtk, gapBondLTK_t pDevLtk, uint8_t pIRK, uint8_t pSRK, uint32_t signCount, gapBondCharCfg_t charCfg)
	Import bond record to NV. More...

uint8_t	gapBondMgrReadBondRec (GAP_Peer_Addr_Types_t addrType, uint8_t pDevAddr, gapBondRec_t pBondRec, gapBondLTK_t pLocalLtk, gapBondLTK_t pDevLtk, uint8_t pIRK, uint8_t pSRK, uint32_t signCount, gapBondCharCfg_t *charCfg)
	Read bond record from NV. More...

Detailed Description

This module implements the GAP Bond Manager

Function Documentation

§ GAPBondMgr_FindAddr()

bStatus_t GAPBondMgr_FindAddr	(	uint8_t *	pDevAddr,
		GAP_Peer_Addr_Types_t	addrType,
		uint8_t *	pIdx,
		GAP_Peer_Addr_Types_t *	pIdentityAddrType,
		uint8_t *	pIdentityAddr
	)

Search for an address in the bonding table. If the address is a random private resolvable address, attempt to resolve the random address against all IRK's in bonding table. As output parameters, return the following:

index into bonding table if the address (or resolved address) is found
identity address type if a resolved address was found. Only valid if the input address is random private resolvable
identity address if a resolved address was found. Only valid if the input address is random private resolvable

Note that the output parameters are optional. If it is not desired for them to be returned, a NULL pointer can safely be passed.

Parameters

pDevAddr	peer's address
addrType	peer's address type
pIdx	pointer to byte to put the bond index if found
pIdentityAddrType	pointer to byte to put the identity address type if applicable
pIdentityAddr	pointer to buffer to put the identity address type if applicable

Returns: SUCCESS if the address was found or resolved to an address in the bonding table; INVALIDPARAMETER if a NULL address is passed in; bleGAPNotFound if the address was not found and didn't resolve to any addresses in the bonding table

§ GAPBondMgr_GenerateEccKeys()

bStatus_t GAPBondMgr_GenerateEccKeys ( void )

Generates ECC keys.

/ref did_244389729

Returns: SUCCESS - if processing. FAILURE - if SM is pairing

§ GAPBondMgr_GetParameter()

bStatus_t GAPBondMgr_GetParameter	(	uint16_t	param,
		void *	pValue
	)

Get a GAP Bond Manager parameter.

Note: The "pValue" field must point to a "uint16_t".

Parameters

param	Profile parameter ID: GAP Bond Manager Parameters
pValue	pointer to location to get the value. This is dependent on the parameter ID and WILL be cast to the appropriate data type (example: data type of uint16_t will be cast to uint16_t pointer).

Returns: SUCCESS; INVALIDPARAMETER

§ GAPBondMgr_Pair()

bStatus_t GAPBondMgr_Pair ( uint16_t connHandle )

Start (or re-start) the pairing process

This API can be used to initiate pairing in cases where it is not started automatically by the gapbondmgr or to re-pair after the initial pairing has occurred if, for example, the pairing requirements have changed.

Note: Pairing will occur automatically if GAPBOND_PAIRING_MODE is set to GAPBOND_PAIRING_MODE_INITIATE or GAPBOND_PAIRING_MODE is set to GAPBOND_PAIRING_MODE_WAIT_FOR_REQ and a pairing request is received. In these cases, this API is not needed and will fail since pairing is already in progress.

Parameters

connHandle connection handle to initiate pairing with

Returns: SUCCESS; bleAlreadyInRequestedMode already pairing

§ GAPBondMgr_PasscodeRsp()

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

Respond to a passcode request.

Parameters

connectionHandle	connection handle of the connected device or 0xFFFF if all devices in database.
status	SUCCESS if passcode is available, otherwise see Pairing failure status values.
passcode	integer value containing the passcode.

Returns: SUCCESS bond record found and changed,; bleIncorrectMode Link not found.; INVALIDPARAMETER : passcode is out of range; bleMemAllocError : heap is out of memory

§ GAPBondMgr_Register()

void GAPBondMgr_Register ( gapBondCBs_t * pCB )

Register callback functions with the bond manager.

Parameters

pCB	pointer to callback function structure.

§ GAPBondMgr_SCGetLocalOOBParameters()

bStatus_t GAPBondMgr_SCGetLocalOOBParameters ( gapBondOOBData_t * localOobData )

Get local Random number and confirm value for secure connection.

/ref did_244389729

Parameters

localOobData - Struct holding local's random number and confirm value

Returns: SUCCESS - Finished successfully. FAILURE - One of the parameters returned FAILURE

§ GAPBondMgr_SCSetRemoteOOBParameters()

bStatus_t GAPBondMgr_SCSetRemoteOOBParameters	(	gapBondOOBData_t *	remoteOobData,
		uint8	OOBDataFlag
	)

Set remote's OOB parameters for secure connection.

/ref did_244389729

Parameters

remoteOobData	- struct holding remote random number and confirm value
OOBDataFlag	- 1 - OOB Authentication data from remote device present, else 0

Returns: SUCCESS - Finished successfully. FAILURE - If OOBDataFlag is set but remote's OOB parameters are not or if OOBDataFlag is not set but OOB parameters are set.

§ GAPBondMgr_ServiceChangeInd()

bStatus_t GAPBondMgr_ServiceChangeInd	(	uint16_t	connectionHandle,
		uint8_t	setParam
	)

Set/clear the service change indication in a bond record.

Parameters

connectionHandle	connection handle of the connected device or 0xFFFF if all devices in database.
setParam	TRUE to set the service change indication, FALSE to clear it.

Returns: SUCCESS bond record found and changed,; bleNoResources bond record not found; bleNotConnected connection not found connectionHandle is invalid (for non-0xFFFF connectionHandle).

§ GAPBondMgr_SetParameter()

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

Set a GAP Bond Manager parameter.

Note: The "len" field must be set to the size of a "uint16_t" and the "pValue" field must point to a "uint16_t".

Parameters

param	GAP Bond Manager Parameters
len	length of data to write
pValue	pointer to data to write. This is dependent on the parameter ID and WILL be cast to the appropriate data type (example: data type of uint16_t will be cast to uint16_t pointer).

Returns: SUCCESS; INVALIDPARAMETER

§ gapBondMgrImportBond()

uint8_t gapBondMgrImportBond	(	gapBondRec_t *	pBondRec,
		gapBondLTK_t *	pLocalLtk,
		gapBondLTK_t *	pDevLtk,
		uint8_t *	pIRK,
		uint8_t *	pSRK,
		uint32_t	signCount,
		gapBondCharCfg_t *	charCfg
	)

Import bond record to NV.

Parameters

pBondRec	- basic bond record
pLocalLTK	- LTK used by the device that has the same public address as current device
pDevLTK	- LTK used by the peer device during pairing
pIRK	- IRK used by the peer device during pairing
pSRK	- SRK used by the peer device during pairing
signCounter	- Sign counter used by the peer device during pairing
charCfg	- GATT characteristic configuration

Returns: SUCCESS if bond was imported @ bleNoResources if there are no empty slots

§ gapBondMgrReadBondRec()

uint8_t gapBondMgrReadBondRec	(	GAP_Peer_Addr_Types_t	addrType,
		uint8_t *	pDevAddr,
		gapBondRec_t *	pBondRec,
		gapBondLTK_t *	pLocalLtk,
		gapBondLTK_t *	pDevLtk,
		uint8_t *	pIRK,
		uint8_t *	pSRK,
		uint32_t	signCount,
		gapBondCharCfg_t *	charCfg
	)

Read bond record from NV.

Parameters

pBondRec	- basic bond record
pLocalLTK	- LTK used by this device during pairing
pDevLTK	- LTK used by the peer device during pairing
pIRK	- IRK used by the peer device during pairing
pSRK	- SRK used by the peer device during pairing
signCounter	- Sign counter used by the peer device during pairing
charCfg	- GATT characteristic configuration

Returns: SUCCESS if bond was extracted bleGAPNotFound if there is no bond record

Modules

Files

Functions

Detailed Description

Function Documentation

§ GAPBondMgr_FindAddr()

§ GAPBondMgr_GenerateEccKeys()

§ GAPBondMgr_GetParameter()

§ GAPBondMgr_Pair()

§ GAPBondMgr_PasscodeRsp()

§ GAPBondMgr_Register()

§ GAPBondMgr_SCGetLocalOOBParameters()

§ GAPBondMgr_SCSetRemoteOOBParameters()

§ GAPBondMgr_ServiceChangeInd()

§ GAPBondMgr_SetParameter()

§ gapBondMgrImportBond()

§ gapBondMgrReadBondRec()