人類裝置配接器
人類裝置配接器 (HDA) 是手動與 藍牙測試平臺 (BTP) 互動的方式，允許搭配尚未自動化的 BTP 使用裝置。 例如，HDA 可以與購買的頭戴式裝置互動，否則無法清楚連線到 BTP。 HDA 可讓您在 Windows 裝置與原型設計硬體之間手動測試，而不需要使用外部硬體，例如 Traduci。 因此，設定所需的所有功能都是支援藍牙和您自己的測試裝置的電腦。
HDA 設定
如 BTP 軟體安裝 中所述，安裝軟體以支援 HDA。
HDA 組態檔
建立名為 的測試裝置的組態檔，例如： mytestdevice.txt。 檔案名和副檔名並不重要。 組態檔應該包含下列資訊：
name=myTestDevice
baseband=BR
br_address=B4:F1:DA:96:C0:A4
HDA 配對測試
流覽至擷取 BTP 軟體套件的資料夾，通常是 C:\BTP 。 腳本位於封裝目錄的子資料夾中。 針對所需的命令環境執行適當的腳本：
| 命令環境 | 指令碼 |
|---|---|
| 提升許可權的命令提示字元 | RunPairingTests.bat HDA,conf_file=<configuration file name> |
| 提升許可權的 PowerShell 主控台 | RunPairingTests.ps1 HDA,conf_file=<configuration file name> |
您可以新增選擇性參數 -VerboseLogs ，以提供 BTP 內部作業的更詳細資訊輸出，以協助偵錯。
HDA 手動配對
腳本會詢問裝置之前是否已配對。 如果您以 y回應，腳本會刪除配對。 如果您以 n回應，此程式會繼續執行任何動作。
Verify: SUCCEEDED(WEX::TestExecution::RuntimeParameters::TryGetValue(deviceParameterName.c_str(), deviceParametersStr)): Getting required runtime parameter 'central' [BluetoothTests::PairingTestsImpl::PairingTestsImpl]: Using central device named: MyCentralDevice [BluetoothTests::PairingTestsImpl::PairingTestsImpl]: Using peripheral device named: MyTestDevice [BluetoothTestHelpers::Pairing::Unpair]: Unpairing device with address B4F1DA96C0A4 from the device with address D83BBFAC35607 [BluetoothTestHelpers::Pairing::Unpair]: Unpaired successfully [BluetoothTestHelpers::Pairing::WaitForDisconnection]: Waiting for disconnection of device with address B4F1DA96C0A4 [BluetoothTestHelpers::Pairing::WaitForDisconnection]: Asserted: connectionModule.WaitForDisconnection(otherDeviceAddress, c_disconnectionAfterUnpairingTimeout) [BluetoothTestHelpers::Pairing::WaitForDisconnection]: Disconnected successfully Is MyTestDevice paired to the device with address D83BBFAC35607? Enter (y/n): y下列範例顯示刪除配對的 HDA。 它也會提示您刪除裝置上任何配對資訊 (名為 「MyTestDevice」) 。 一旦刪除任何配對資訊，請按任何按鍵繼續。
[BluetoothTestHelpers::Pairing::Unpair]: Unpairing device with address D83BBFAC35607 Public from the device with address D83BBFAC35607 Public If possible, delete the pairing on MyTestDevice Press any key to continue然後腳本會執行檢查來開始配對程式，然後提示使用者輸入其裝置 (名為 「MyTestDevice」) 到「頻帶 配對模式」。 將裝置置於配對模式之後，請按任何按鍵以繼續。
StartGroup: BluetoothTests::TaefPairingTests::OutgoingJustWorksPairingTest [BluetoothTests::PairingTestsImpl::OutgoingJustWorksPairingTest]: Will attempt an outgoing pairing to the peripheral device and validate that a JustWorks ceremony was used [BluetoothTestHelpers::Pairing::Pair]: Asserted: (originDeviceAssociationModule) != nullptr [BluetoothTestHelpers::Pairing::Pair]: Asserted: originDeviceAssociationModule->CanInitiatePairing() [BluetoothTestHelpers::Pairing::Pair]: Asserted: originDeviceAssociationModule->CanCheckPairingStatus() [BluetoothTestHelpers::Pairing::Pair]: Asserted: !(originDeviceAssociationModule->IsPairedTo(destinationDeviceAddress)) If not already, put MyTestDevice in BR pairing mode Press any key to continue . . .腳本會起始配對。 如果配對成功，您會看到下列輸出。 回應裝置上或測試電腦上的任何通知，以確認並完成配對。 然後，測試會提示您讓裝置脫離配對模式。 將裝置移出配對模式之後，請按下任何按鍵以繼續。
[BluetoothTestHelpers::Pairing::Pair]: Initiating pairing request from device with address D83BBFAC35607 to device with address B4F1DA96C0A4 [BluetoothTestHelpers::Pairing::DefaultPairingCeremonyHandler::OnJustWorks]: JustWorks ceremony used [BluetoothTestHelpers::Pairing::Pair]: Asserted: originDeviceAssociationModule->IsPairedTo(destinationDeviceAddress) [BluetoothTestHelpers::Pairing::Pair]: Asserted: ceremonyHandler.GetLastCeremonyUsed().has_value() [BluetoothTestHelpers::Pairing::Pair]: Asserted: ceremonyHandler.GetLastCeremonyUsed().value() == expectedCeremony [BluetoothTestHelpers::Pairing::Pair]: Paired successfully If the device is in pairing mode, exit pairing mode if possible. Press any key to continue . . .配對完成後，腳本會繼續進入測試套件中可用的測試。 如需可用測試以及如何執行它們的檔，請參閱 目前支援的 BTP 測試
HDA 記錄擷取
如果遇到問題，可以依照 GitHub 上適用于記錄擷取之 Windows 存放庫的 Busiotools中的指示擷取藍牙記錄，或在啟動測試時使用腳本選項 -VerboseLogs 來擷取藍牙記錄。