【PHY6222】绑定详解-编程知识

1.函数详解

bStatus_t GAPBondMgr_SetParameter( uint16 param, uint8 len, void* pValue )

设置绑定参数。

bStatus_t GAPBondMgr_GetParameter( uint16 param, void* pValue )

获取绑定参数。

param：

GAPBOND_PAIRING_MODE，配对模式，可以选择：

GAPBOND_PAIRING_MODE_NO_PAIRING，不允许配对

GAPBOND_PAIRING_MODE_WAIT_FOR_REQ，等待配对请求(被动)

GAPBOND_PAIRING_MODE_INITIATE，直接发起配对请求(主动)

GAPBOND_INITIATE_WAIT，等待配对的时间，单位ms，默认是1000ms

GAPBOND_MITM_PROTECTION，是否启用中间人保护

GAPBOND_IO_CAPABILITIES，IO能力设置，可以选择：

GAPBOND_IO_CAP_DISPLAY_ONLY，仅仅可以显示

GAPBOND_IO_CAP_DISPLAY_YES_NO，仅仅可以显示YES和NO

GAPBOND_IO_CAP_KEYBOARD_ONLY，仅仅具有键盘输入

GAPBOND_IO_CAP_NO_INPUT_NO_OUTPUT，既没输入也没输出

GAPBOND_IO_CAP_KEYBOARD_DISPLAY，既有显示也有键盘输入

GAPBOND_OOB_ENABLED，使能OOB配对方式

GAPBOND_OOB_DATA，OOB数据，即密钥，详细参考蓝牙传统OOB配对方式。

GAPBOND_BONDING_ENABLED，使能绑定，将会在配对之后发起绑定请求

GAPBOND_KEY_DIST_LIST，绑定过程中分发的密钥种类，多选。支持以下参数：

GAPBOND_KEYDIST_SENCKEY，从机加密密钥(LTK)

GAPBOND_KEYDIST_SIDKEY，从机IRK和ID信息(EDIV和Rand)

GAPBOND_KEYDIST_SSIGN，从机CSRK

GAPBOND_KEYDIST_MENCKEY，主机加密密钥

GAPBOND_KEYDIST_MIDKEY，主机IRK和ID信息

GAPBOND_KEYDIST_MSIGN，主机CSRK

GAPBOND_DEFAULT_PASSCODE，PIN码

GAPBOND_ERASE_ALLBONDS，擦除所有绑定信息

GAPBOND_AUTO_FAIL_PAIRING，测试用，在收到配对请求时直接回复配对失败

GAPBOND_AUTO_FAIL_REASON，测试用，回复配对失败的原因，可以选择：

SMP_PAIRING_FAILED_PASSKEY_ENTRY_FAILED，密钥输入失败，例如用户取消了输入

SMP_PAIRING_FAILED_OOB_NOT_AVAIL，OOB数据不可用

SMP_PAIRING_FAILED_AUTH_REQ，IO能力不满足身份认证需求，配对失败

SMP_PAIRING_FAILED_CONFIRM_VALUE，确认值和计算得到的不同

SMP_PAIRING_FAILED_NOT_SUPPORTED，设备不支持配对

SMP_PAIRING_FAILED_ENC_KEY_SIZE，协商密钥长度不能满足安全需求

SMP_PAIRING_FAILED_CMD_NOT_SUPPORTED，收到的SMP命令当前设备不支持

SMP_PAIRING_FAILED_UNSPECIFIED，未说明配对失败原因

SMP_PAIRING_FAILED_REPEATED_ATTEMPTS，配对和身份认证过程不能执行，因为距离上次时间太短

GAPBOND_KEYSIZE，配对密钥长度

GAPBOND_AUTO_SYNC_WL，清除当前白名单，并重新从Flash中读取绑定设备添加到白名单

GAPBOND_BOND_COUNT，获取当前绑定设备数量

GAPBOND_BOND_FAIL_ACTION，中心设备在绑定失败的时候采取的措施，可以选择：

GAPBOND_FAIL_NO_ACTION，不进行任何操作

GAPBOND_FAIL_INITIATE_PAIRING，启动配对

GAPBOND_FAIL_TERMINATE_LINK，终止连接

GAPBOND_FAIL_TERMINATE_ERASE_BONDS，终止连接并擦除设备上所有绑定信息

void GAPBondMgr_Init( uint8 task_id )

绑定相关初始化，里面只读取了绑定信息。详细见：gapBondMgrReadBonds

uint16 GAPBondMgr_ProcessEvent( uint8 task_id, uint16 events )

处理绑定相关事件。可以看到只处理了SYS_EVENT_MSG类型的信息，详细见gapBondMgr_ProcessOSALMsg

static void gapBondMgrReadBonds( void )

static void gapBondMgr_SyncWhiteList( void )

static void gapBondSetupPrivFlag( void )

static uint8 gapBondMgrBondTotal( void )

static uint8 gapBondMgr_ProcessOSALMsg( osal_event_hdr_t* pMsg )

uint8 GAPBondMgr_ProcessGAPMsg( gapEventHdr_t* pMsg )

void GAPBondMgr_Register( gapBondCBs_t* pCB )

注册配对/绑定状态改变通知的回调函数(pGapBondCB->pairStateCB)和请求PIN码的回调函数(pGapBondCB->passcodeCB)，被注册的两个函数会在上面的函数GAPBondMgr_ProcessGAPMsg中调用。

bStatus_t GAPBondMgr_PasscodeRsp( uint16 connectionHandle, uint8 status, uint32 passcode )

更新pin码函数，可以在请求pin码的回调函数(pGapBondCB->passcodeCB)中调用。

static uint8 gapBondMgrAddBond( gapBondRec_t* pBondRec, gapAuthCompleteEvent_t* pPkt )

添加绑定信息函数。

经过上面的操作，假如是一个新的绑定，已经获得了一个空的可以保存绑定信息的index，后续绑定信息会保存于此。

static void gapBondRecvEvt(uint16 connHandle, gapBondRec_t* pBondRec, gapAuthCompleteEvent_t* pPkt )

在gapBondRecvEvt中也调用了gapBondMgrAddBond，但是在GAPBondMgr_ProcessGAPMsg中gapBondMgrAddBond和gapBondRecvEvt是同时调用的，通过对gapBondMgrAddBond函数的分析可以知道，第一次进入gapBondMgrAddBond函数时，pAuthEvt[pPkt->connectionHandle]应该为空，此时保存了mainRecord、gattCfg以及pAuthEvt[pPkt->connectionHandle]设置为当前信息，在gapBondRecvEvt中的gapBondMgrAddBond中进入时pAuthEvt[pPkt->connectionHandle]已经不为空了，然后才保存TLK、IRK等余下的信息。