說明

PINCodeResponse 命令負責(zé)發(fā)出 GAP 身份驗證響應(yīng)，通過輸入?yún)?shù)指定其 PIN 碼值。此函數(shù)在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負值。必須存在藍牙協(xié)議棧 ID，才能嘗試調(diào)用此函數(shù)。該設(shè)備還必須正在進行由本地設(shè)備或遠程設(shè)備啟動的配對操作。

參數(shù)

PINCodeResponse 命令需要一個參數(shù)，即用于對連接進行身份驗證的 PIN 碼。這是一個字符串值，最長可達 16 位數(shù)字。配對發(fā)起方查看在配對過程中顯示的消息來調(diào)用此命令。在發(fā)起方輸入 PIN 碼后，響應(yīng)方會收到一條調(diào)用此命令的消息。

命令調(diào)用示例

• “PINCodeResponse 1234”嘗試將 PIN 碼設(shè)置為“1234”。
• “PINCodeResponse 5921302312564542”嘗試將 PIN 碼設(shè)置為“5921302312564542”。該值表示最長的 16 位 PIN 碼值。

可能的返回值

• (0) 成功的 PIN 碼響應(yīng)
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 調(diào)用

GAP_Authentication_Response(BluetoothStackID, CurrentRemoteBD_ADDR, &GAP_Authentication_Information)

API 原型

int BTPSAPI GAP_Authentication_Response(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Authentication_Information_t *GAP_Authentication_Information)

API 說明

提供此函數(shù)是為了能夠讓本地設(shè)備響應(yīng) GAP 身份驗證事件。此函數(shù)用于為指定的藍牙設(shè)備指定身份驗證信息。該函數(shù)將以下內(nèi)容作為輸入：已請求身份驗證操作的藍牙設(shè)備的藍牙協(xié)議棧 ID 以及身份驗證響應(yīng)信息（由調(diào)用方指定）。