說明

要使用 OOB 方法執(zhí)行 LE SC 配對，請在配對過程開始之前生成本地隨機值和確認(rèn)值。以下函數(shù)允許用戶生成 OOB 本地參數(shù)。該函數(shù)不得在配對過程中使用。這僅適用于 LE SC 配對。此函數(shù)在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負(fù)值。

參數(shù)

無需任何參數(shù)。

命令調(diào)用示例

“SCGenerateOOBLocalParams”嘗試在配對過程開始前生成本地隨機值和確認(rèn)值。

可能的返回值

• (0) 成功。
• (-4) FUNCTION_ERROR。
• (-8) INVALID_STACK_ID_ERROR。
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID。
• (-56) BTPS_ERROR_GAP_NOT_INITIALIZED。
• (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE。
• (-117) BTPS_ERROR_PAIRING_ACTIVE。
• (-120) BTPS_ERROR_FEATURE_NOT_CURRENTLY_ACTIVE。

API 調(diào)用

GAP_LE_SC_OOB_Generate_Parameters(BluetoothStackID, &OOBLocalRandom, &OOBLocalConfirmation)

API 原型

int BTPSAPI GAP_LE_SC_OOB_Generate_Parameters(unsigned int BluetoothStackID, SM_Random_Value_t *OOB_Local_Rand_Result, SM_Confirm_Value_t*OOB_Local_Confirm_Result)

API 說明

提供以下函數(shù)是為了能夠在帶外 (OOB) 關(guān)聯(lián)方法中使用 LE 安全連接 (SC) 配對。上層使用此函數(shù)生成藍(lán)牙規(guī)范中定義的本地 OOB 隨機值和 OOB 確認(rèn)值（ra/rb 和 Ca/Cb）。該函數(shù)將以下內(nèi)容作為參數(shù)：藍(lán)牙設(shè)備的藍(lán)牙協(xié)議棧 ID 以及指向緩沖區(qū)的指針（用于接收生成的本地 OOB 隨機值和 OOB 確認(rèn)值）。如果成功，此函數(shù)返回零；否則返回負(fù)的錯誤代碼。