ヒューマン デバイス アダプター
ヒューマン デバイス アダプター (HDA) は、手動で操作するためのドゥイットユアセルフの方法です Bluetoothテストプラットフォーム（BTP）, まだ自動化されていない BTP を備えたデバイスの使用を可能にします。 たとえば、HDA を使用すると、BTP に接続する明確な方法がない購入済みのヘッドセットと対話できるようになります。 HDA を使用すると、外部ハードウェア (Traduci など) を使用せずに、Windows デバイスとプロトタイプ作成ハードウェアの間で手動でユーザー テストを行えます。 そのため、セットアップに必要なのは、Bluetooth と独自のテスト デバイスをサポートする PC です。
HDAのセットアップ
の説明に従ってソフトウェアをインストールします BTP ソフトウェアのセットアップ HDA をサポートするため。
HDA 構成ファイル
テストデバイスにちなんで名前を付けた構成ファイルを作成します。たとえば、次のようになります: 私のテストデバイス.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 . . .スクリプトによってペアリングが開始されます。 ペアリングが成功した場合は、次の出力が表示されます。 デバイスまたはテスト PC 上の通知に応答して、ペアリングを確認して完了します。 テストでは、デバイスをペアリング モードから外すよう求められます。 デバイスをペアリング モードから切り替えたら、任意のキーを押して続行します。
[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 ログ capture
問題が発生した場合は、次の手順で Bluetooth ログをキャプチャできます ログ キャプチャ用の GitHub 上の Busiotools ためのWindows リポジトリ, またはスクリプトオプションを使用して -VerboseLogs テストを開始するとき。