藍牙測試平臺 （BTP） 軟體套件包含必須安裝在測試機器上的所有專案，以測試已啟用藍牙的裝置與 Windows 藍牙堆疊的互作性。 安裝過程中所包含的文件提供有關如何設定硬體及建議拓撲結構以取得最佳測試涵蓋範圍的相關資訊。 它也會說明如何執行測試和收集記錄的詳細數據。
下載 BTP 軟體套件
使用下列按鈕下載最新版的 BTP 軟體套件：
小提示
在您打算用來執行測試的相同電腦上執行安裝程式。
安裝之後，請勿複製、移動或刪除已安裝的檔案。 如果您的安裝發生問題，請使用 Windows 新增或移除程式 功能來完全卸載 BTP 套件。 然後，使用 Windows 套件安裝程式執行全新安裝 （.msi）。
依版本查看 BTP 套件更新
下表描述每個發行版本的 BTP 軟體套件變更。
| 版本 | 變化 |
|---|---|
| 1.14.0 | - 已新增音訊測試，可使用自定義音訊檔案進行播放，而不是產生的測試音調。
- 已修正某些中央裝置在解除配對 Bluefruit Feather 時失敗的問題。 - 改善了測試中 Traduci 音訊分析器的可靠性。 - 多項其他修正及用於提高測試可靠性的改善。 |
| 1.12.2 | - 已新增對 BM62 無線電的支援。
- 新增ESP32 Wi-Fi的明確韌體版本檢查。 - 其他 Wi-Fi 共存問題修正和改善，以提高測試的可靠性。 |
| 1.11.1 | - 已修正在沒有已安裝虛擬電源按鈕的情況下執行待命 HID 電源測試時的當機問題。
- 已新增 Bluefruit Feather 的明確韌體版本檢查。 - 多項其他修正及用於提高測試可靠性的改善。 |
| 1.10.1 | - 新增電源狀態 HID 測試。
- 多項其他修正及用於提高測試可靠性的改善。 |
| 1.9.0 | - 已改善對 BTP 裝置的支援，方法是使用自定義 DLL 外掛程式。
- 修正了在特定 Windows 組建中影響音訊靜音/取消靜音測試的問題。 - 多項其他修正及用於提高測試可靠性的改善。 |
| 1.8.0 | 新增 Wi-Fi 項目，進行藍牙音訊與 HID 共存測試。
- 已新增靜音和取消靜音音訊測試。 - 已新增選項，以將測試期間播放的音訊錄製到本機檔案。 - 已修正可能導致 Bluefruit Feather 錯誤報告其藍牙地址的問題。 - 修正在舊版 Windows 組建上執行目前音訊測試的問題。 - 多項其他修正及用於提高測試可靠性的改善。 |
| 1.7.2 | - 已新增 Wi-Fi 和藍牙音訊共存測試。
- 已新增對 Bluefruit Feather（nRF52840）的支援，並提供與現有 Bluefruit 支援相同的完整性。 - 已使用 Bluefruit Feather 新增所有類型的配對密鑰交涉測試。 - 已修正當裝置在測試中未拔下時，會在緊密迴圈中發生失敗的問題。 - 多項修正和提升，以提高測試可靠性。 |
| 1.6.2 | - 不再需要 Windows 驅動程式套件 （WDK） 安裝來執行 BTP 測試。
- 新增快速擊鍵 HID 測試，以更輕鬆地攔截按鍵重複和其他效能問題。 - 在閒置 HID 測試後，新增快速按鍵和滑鼠移動，這些功能對循環執行很有用。 - 已將重新連線延遲測量新增至 HID 測試中。 - 在閑置中斷連線 HID 測試之後新增重新連線。 - 多項修正和提升，以提高測試可靠性。 |
| 1.5.1 | - 已新增藍牙虛擬探查器 （BTVS） 和藍牙事件追蹤記錄檔 （ETL） 剖析 （BTETLParse.exe） 診斷工具。
- 多項修正和提升，以提高測試可靠性。 |
| 1.4.0 | - 已將鍵盤延遲測試新增至 HID 測試。
- 已將滑鼠測試新增至 HID 測試。 - 新增音訊 + HID 案例測試。 - 已新增電池測試。 - 修正在舊版 Windows 版本中執行時，導致測試無法載入的問題。 - 修正在非原生 CMD/PowerShell 環境中執行時失敗的腳本。 - 多項修正和提升，以提高測試可靠性。 |
| 1.3.1 | - 新增了能夠執行進階音訊分配設定檔（A2DP）和 Hands-Free 設定檔（HFP）的音訊測試。
- 在 Traduci 上透過現場可程式化閘陣列（FPGA），新增音訊音量驗證及毛刺偵測功能。 - 將測試重新命名為較短且更方便用戶的名稱。 - 多項修正和提升，以提高測試可靠性。 |
| 1.2.1 | - 將 BTP 從私人預覽移至公開。
- 新增實驗性的 SleepTests，以展示 Traduci 執行延遲命令的新功能。 - 多項修正和提升，以提高測試可靠性。 |
套件中的工具
下一節列出 BTP 軟體套件中提供的工具。
架構獨立檔案
BTP 軟體套件中的下列工具會以獨立檔案的形式存在。
| 測試工具 | 說明 | 工具檔 |
|---|---|---|
| ConfigureMachineForBtp | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 設定執行 BTP 測試的測試機器。 /br>- 應在新的機器或作業系統安裝後、首次執行測試之前運行。 |
ConfigureMachineForBtp.bat ConfigureMachineForBtp.ps1 |
| GetProcessorArchitectureName | - 以 PowerShell 腳本的形式提供。
- 允許其他文稿識別目前計算機的架構。 |
GetProcessorArchitectureName.ps1 |
| RunTaefTest | PowerShell 協助腳本，用於根據測試 DLL 名稱和測試參數執行 TAEF 測試。 | RunTeafTests.ps1 |
| RunPairingTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行藍牙配對測試。 - 如果提供，支援自定義自變數。 |
RunPairingTests.bat RunPairingTests.ps1 |
| RunHidTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行藍牙 HID 測試。 - 如果提供，支援自定義自變數。 |
RunHidTests.bat RunHidTests.ps1 |
| RunAudioTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行音訊測試，包括故障偵測和音訊音量驗證。 - 如果提供，支援自定義自變數。 |
RunAudioTests.bat RunAudioTests.ps1 |
| RunAudioHidScenarioTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行音訊和 HID 案例測試。 - 如果提供，支援自定義自變數。 |
RunAudioHidScenarioTests.bat RunAudioHidScenarioTests.ps1 |
| RunBatteryTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行電池測試。 - 如果提供，支援自定義自變數。 |
RunBatteryTests.bat RunBatteryTests.ps1 |
| RunWiFiAudioScenarioTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行 Wi-Fi 和音訊案例測試。 - 如果提供，支援自定義自變數。 |
RunWiFiAudioScenarioTests.bat RunWiFiAudioScenarioTests.ps1 |
| RunWiFiAudioHidScenarioTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行Wi-Fi、音訊和 HID 案例測試。 - 如果提供，支援自定義自變數。 |
RunWiFiAudioHidScenarioTests.bat RunWiFiAudioHidScenarioTests.ps1 |
| RunPowerStateTests | - 以 CMD 腳本和 PowerShell 腳本的形式提供。
- 執行電源狀態測試。 - 如果提供，支援自定義自變數。 |
RunPowerStateTests.bat RunPowerStateTests.ps1 |
| Bluefruit Feather Firmware | Bluefruit Feather 裝置的已編譯二進位檔。 | BtpBluefruit_nRF52840.ino.zip |
| ESP32 韌體 | ESP32wifi 裝置的已編譯二進位檔。 |
WiFi-ESP32.ino.bin WiFi-ESP32.ino.partitions.bin |
架構相依二進位檔
下表所列的檔案適用於 X86、AMD64 和 Arm64 架構。 安裝程式會為每個架構擷取每個檔案的一個實例。
| 測試工具 | 說明 | 工具檔 |
|---|---|---|
| TAEF | 如需詳細資訊，請參閱 測試撰寫和執行架構 （TAEF） 。 | C：\BTP\<version>\TAEF |
| BtpDevicePlugin | 支援使用本機 Windows 藍牙無線電的測試所需的二進位檔。 | Microsoft.Bluetooth.TestPlatform.BtpDevicePlugin.dll |
| GenericSerialIO | 支援使用 Windows 序列通訊的 BTP 裝置所需的二進位檔。 | Microsoft.Bluetooth.TestPlatform.GenericSerialIO.dll |
| HidTests | - 用於藍牙 HID 測試的測試二進位檔。 - 可以使用TAEF或使用提供的腳本來執行。 |
TaefHidTests.dll |
| PairingTests | - 用於藍牙配對測試的二進位檔。 - 可以使用TAEF或使用提供的腳本來執行。 |
TaefPairingTests.dll |
| AudioTests | - 藍牙音訊測試用的二進位檔。 - 可以搭配 TAEF 執行。 |
TaefAudioTests.dll |
| AudioHidScenarioTests | - 針對藍牙音訊和 HID 場景測試的測試二進位檔。 - 可以搭配 TAEF 執行。 |
TaefAudioHidScenarioTests.dll |
| BatteryTests | 針對藍牙電池測試的二進位檔案。 - 可以搭配 TAEF 執行。 |
TaefBatteryTests.dll |
| WiFiCoexScenarioTests | - 針對藍牙和 Wi-Fi 共存測試測試測試，測試二進位檔。 - 可以搭配 TAEF 執行。 |
TaefWiFiCoexScenarioTests.dll |
| PowerStateTests | - 測試藍牙電源狀態測試的二進位檔。 - 可以搭配 TAEF 執行。 |
TaefPowerStateTests.dll |
| TraduciCmd | - 用於查詢和變更 Traduci 狀態的命令行工具，包括偵錯命令。 - 用於 Traduci 硬體的韌體更新。 |
TraduciCmd.exe |
| BTETLParse | 從支援的 ETL 檔案擷取主機控制器介面 （HCI） 追蹤的命令行工具。 | BTETLParse.exe |
| BTVS | - 以支援的格式串流即時 HCI 追蹤的圖形化工具（例如 Ellisys、Frontline 和 Wireshark）。 - 僅適用於 x86 架構。 |
btvs.exe |