Adattatore dispositivo umano
L'adattatore per dispositivi umani (HDA) è un modo per interagire manualmente con la piattaforma BTP (Bluetooth Test Platform), consentendo l'uso di dispositivi con BTP che non sono ancora stati automatizzati. Ad esempio, l'HDA renderebbe possibile interagire con un visore visore acquistato che altrimenti non ha un modo chiaro per connettersi a BTP. HDA consente di eseguire test utente manuali tra un dispositivo Windows e l'hardware di prototipazione senza l'uso di hardware esterno, ad esempio Traduci. Di conseguenza, tutto ciò che è necessario per configurare è un PC che supporta Bluetooth e il proprio dispositivo di test.
Configurazione HDA
Installare il software come descritto in Configurazione software BTP per supportare HDA.
File di configurazione HDA
Creare un file di configurazione denominato dopo il dispositivo di test, ad esempio: mytestdevice.txt. Il nome file e l'estensione non sono importanti. Il file di configurazione deve contenere le informazioni seguenti:
name=myTestDevice
baseband=BR
br_address=B4:F1:DA:96:C0:A4
Test di associazione HDA
Passare alla cartella in cui è stato estratto il pacchetto software BTP, in genere C:\BTP. Gli script si trovano in una sottocartella della directory del pacchetto. Eseguire lo script appropriato per l'ambiente di comando desiderato:
| Ambiente dei comandi | Script |
|---|---|
| Prompt dei comandi con privilegi elevati | RunPairingTests.bat HDA,conf_file=<configuration file name> |
| Console di PowerShell con privilegi elevati | RunPairingTests.ps1 HDA,conf_file=<configuration file name> |
Il parametro -VerboseLogs facoltativo può essere aggiunto per fornire un output più dettagliato delle operazioni interne di BTP per facilitare il debug.
Associazione manuale HDA
Lo script chiede se il dispositivo è stato associato prima. Se si risponde con y, lo script elimina l'associazione. Se si risponde con n, il processo continua senza alcuna azione.
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): yNell'esempio seguente viene illustrato l'eliminazione dell'oggetto HDA che elimina l'associazione. Richiede inoltre di eliminare qualsiasi informazione di associazione nel dispositivo (qui denominata "MyTestDevice"). Premere qualsiasi tasto per continuare dopo l'eliminazione di eventuali informazioni di associazione.
[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 continueLo script inizia quindi il processo di associazione eseguendo controlli, quindi richiedendo all'utente di immettere il dispositivo (qui denominato "MyTestDevice") in "Modalità associazione band ". Dopo aver inserito il dispositivo in modalità di associazione, premere qualsiasi tasto per continuare.
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 . . .Lo script avvia l'associazione. Se l'associazione ha esito positivo, viene visualizzato l'output seguente. Rispondere a eventuali notifiche sul dispositivo o sul PC di test per confermare e completare l'associazione. Il test richiede quindi di uscire dalla modalità di associazione del dispositivo. Dopo aver estratto il dispositivo dalla modalità di associazione, premere qualsiasi tasto per continuare.
[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 . . .Al termine dell'associazione, lo script continua sui test disponibili nella suite di test. Documentazione sui test disponibili e su come eseguirli sono disponibili nei test BTP attualmente supportati
Acquisizione log HDA
Se si verificano problemi nei log Bluetooth, è possibile acquisire i log Bluetooth seguendo le istruzioni riportate in Busiotools per Il repository di Windows in GitHub per l'acquisizione log oppure usando l'opzione -VerboseLogs script durante l'avvio dei test.