获取 Microsoft 蓝牙测试平台软件包

蓝牙测试平台 (BTP) 软件包包含测试计算机上需要安装的所有内容,以测试已启用蓝牙的设备与 Windows 蓝牙堆栈的互操作性。 包含的文档提供有关如何配置硬件并建议拓扑以获得最佳测试覆盖率的信息,以及有关如何运行测试和收集日志的详细信息。

下载 BTP 软件包

单击以下按钮下载最新版本。

注意

安装程序应在将执行测试的计算机上运行。 安装后,请勿复制、移动或删除文件。 如果安装出现问题,请使用 Windows“添加或删除程序”完全卸载 BTP。 然后使用 msi 执行干净安装。

版本更新

版本 更改
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 - 改进了对使用自定义 DLL 插件的 BTP 设备的支持。
- 修复了影响某些 Windows 版本中音频静音/取消静音测试的问题。
- 对测试可靠性的几个其他修复和改进。
1.8.0 - 添加了具有蓝牙音频和 HID 共存测试的Wi-Fi。
- 添加了静音和取消静音音频测试。
- 添加了用于录制测试期间播放的音频的选项,
- 修复了可能导致 Bluefruit Feather 错误地报告其蓝牙地址的问题。
- 修复了在旧版 Windows 版本上运行当前音频测试的问题。
- 对测试可靠性的几个其他修复和改进。
1.7.2 - 添加了Wi-Fi和蓝牙音频共存测试。
- 添加了对 Bluefruit Feather (nRF52840) 的支持,并完全奇偶校验现有 Bluefruit 支持。
- 添加了对使用 Bluefruit Feather 进行所有类型的配对关键协商的测试。
- 修复了在设备被解送中测试时,在紧密循环中发生故障的问题。
- 测试可靠性的几个修补程序和改进。
1.6.2 - 不再需要 WDK 安装才能运行 BTP 测试。
- 添加了快速击键 HID 测试,以便更轻松地捕获密钥重复和其他性能问题。
- 在空闲 HID 测试后添加了快速击键和鼠标移动,这些测试对循环执行很有用。
- 向 HID 测试添加了重新连接延迟度量。
- 在空闲断开连接 HID 测试后添加了重新连接。
- 测试可靠性的几个修补程序和改进。
1.5.1 - 添加了 BTVS 和 BTETLParse 诊断工具。
- 测试可靠性的几个修补程序和改进。
1.4.0 - 向 HID 测试添加了键盘延迟测试。
- 向 HID 测试添加了鼠标测试。
- 添加了音频 + HID 方案测试。
- 添加了电池测试。
- 修复了在旧版 Windows 版本中运行时导致测试无法加载的问题。
- 修复了在非本机 CMD/PowerShell 环境中运行时失败的脚本。
- 测试可靠性的几个修补程序和改进。
1.3.1 - 添加了能够执行 A2DP 和 HFP 的音频测试。
- 在 Traduci 上通过 FPGA 添加了音频音量验证和故障检测。
- 已将测试重命名为更短且更易用的名称。
- 测试可靠性的几个修补程序和改进。
1.2.1 - 将 BTP 从个人预览版移动到公共版。
- 添加了实验性 SleepTests,演示了执行延迟命令的 Traduci 的新功能。
- 测试可靠性的几个修补程序和改进。

包中的工具

体系结构独立文件

测试工具 说明 文件名
ConfigureMachineForBtp - 作为 CMD 脚本和 PowerShell 脚本提供。
- 配置测试计算机以运行 BTP 测试。
- 在新的计算机或 OS 安装上运行第一次测试之前,应运行。

ConfigureMachineForBtp.batConfigureMachineForBtp.ps1
GetProcessorArchitectureName - 作为 PowerShell 脚本提供。
- 允许其他脚本标识当前计算机的体系结构
GetProcessorArchitectureName.ps1
RunTaefTest - 给定测试 dll 名称和测试参数,用于运行 TAEF 测试的 PowerShell 帮助程序脚本。
RunTeafTests.ps1
RunPairingTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行蓝牙配对测试。
- 如果提供,则支持自定义参数。

RunPairingTests.batRunPairingTests.ps1
RunHidTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行蓝牙 HID 测试。
- 如果提供,则支持自定义参数。

RunHidTests.batRunHidTests.ps1
RunAudioTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行音频测试,包括故障检测和音频音量验证。
- 支持自定义参数(如果提供)

RunAudioTests.batRunAudioTests.ps1
RunAudioHidScenarioTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行音频和 HID 方案测试。
- 支持自定义参数(如果提供)

RunAudioHidScenarioTests.batRunAudioHidScenarioTests.ps1
RunBatteryTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行电池测试。
- 支持自定义参数(如果提供)

RunBatteryTests.batRunBatteryTests.ps1
RunWiFiAudioScenarioTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行Wi-Fi和音频方案测试。
- 支持自定义参数(如果提供)

RunWiFiAudioScenarioTests.batRunWiFiAudioScenarioTests.ps1
RunWiFiAudioHidScenarioTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行 Wi-Fi、音频和 HID 方案测试。
- 支持自定义参数(如果提供)

RunWiFiAudioHidScenarioTests.batRunWiFiAudioHidScenarioTests.ps1
RunPowerStateTests - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行电源状态测试。
- 支持自定义参数(如果提供)

RunPowerStateTests.batRunPowerStateTests.ps1
Bluefruit Feather 固件 - 为 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