说明

提供 PairLE 命令是为了与连接的设备进行配对（或者，如果是从设备，则请求安全性）。该命令使用 SendPairingRequest (ConnectionBD_ADDR, LocalDeviceIsMaster) 调用 SendPairingRequest (BD_ADDR_tBD_ADDR, Boolean_t ConnectionMaster) 函数。

参数

使用此命令时不需要包含参数。参数对命令的结果没有影响。

可能的返回值

• (0) 成功设置可配对性模式
• (-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 调用

• 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 函数是为了能够与连接的远程设备配对。该函数将以下内容作为输入：当前连接的要配对的设备的地址以及本地设备的配对功能。此函数还将要在配对过程中使用的 GAP LE 事件回调信息作为输入。如果成功，此函数返回零；如果出现错误，则返回负的错误代码。该函数只能由连接的主设备（连接的发起方）发出。原因是从设备只能请求安全过程，而不能发起安全过程。提供 GAP_LE_Request_Security 函数是为了让从设备能够请求（连接的）主设备执行配对操作或重新建立先前的安全性。该函数只能由从设备调用。原因是从设备只能请求发起安全性，它无法自行发起安全过程。如果成功，此函数返回零；如果出现错误，则返回负的错误代码。