說明

提供 PairLE 命令是為了與連接的設(shè)備進(jìn)行配對（或者，如果是從設(shè)備，則請求安全性）。該命令使用 SendPairingRequest (ConnectionBD_ADDR, LocalDeviceIsMaster) 調(diào)用 SendPairingRequest (BD_ADDR_tBD_ADDR, Boolean_t ConnectionMaster) 函數(shù)。

參數(shù)

使用此命令時不需要包含參數(shù)。參數(shù)對命令的結(jié)果沒有影響。

可能的返回值

• (0) 成功設(shè)置可配對性模式
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-56) BTPS_ERROR_GAP_NOT_INITIALIZED
• (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE
• (-66) BTPS_ERROR_INSUFFICIENT_RESOURCES
• (-107) BTPS_ERROR_INVALID_DEVICE_ROLE_MODE

API 調(diào)用

• GAP_LE_Pair_Remote_Device(BluetoothStackID, BD_ADDR, &Capabilities, GAP_LE_Event_Callback, 0)
• GAP_LE_Request_Security(BluetoothStackID, BD_ADDR, Capabilities.Bonding_Type, Capabilities.MITM, GAP_LE_Event_Callback, 0)

API 原型

• int BTPSAPI GAP_LE_Pair_Remote_Device(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_LE_Pairing_Capabilities_t *Capabilities, GAP_LE_Event_Callback_tGAP_LE_Event_Callback, unsigned long CallbackParameter)
• int BTPSAPI GAP_LE_Request_Security(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_LE_Bonding_Type_t Bonding_Type, Boolean_t MITM,GAP_LE_Event_Callback_t GAP_LE_Event_Callback, unsigned long CallbackParameter)

API 說明

提供 GAP_LE_Pair_Remote_Device 函數(shù)是為了能夠與連接的遠(yuǎn)程設(shè)備配對。該函數(shù)將以下內(nèi)容作為輸入：當(dāng)前連接的要配對的設(shè)備的地址以及本地設(shè)備的配對功能。此函數(shù)還將要在配對過程中使用的 GAP LE 事件回調(diào)信息作為輸入。如果成功，此函數(shù)返回零；如果出現(xiàn)錯誤，則返回負(fù)的錯誤代碼。該函數(shù)只能由連接的主設(shè)備（連接的發(fā)起方）發(fā)出。原因是從設(shè)備只能請求安全過程，而不能發(fā)起安全過程。提供 GAP_LE_Request_Security 函數(shù)是為了讓從設(shè)備能夠請求（連接的）主設(shè)備執(zhí)行配對操作或重新建立先前的安全性。該函數(shù)只能由從設(shè)備調(diào)用。原因是從設(shè)備只能請求發(fā)起安全性，它無法自行發(fā)起安全過程。如果成功，此函數(shù)返回零；如果出現(xiàn)錯誤，則返回負(fù)的錯誤代碼。