蓝牙测试平台（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 | - 通过使用自定义 DLL 插件改进了对 BTP 设备的支持。
- 修复了在某些 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 软件包中的以下工具作为独立文件存在。
| 测试工具 | DESCRIPTION | 工具文件 |
|---|---|---|
| ConfigureMachineForBtp | - 作为 CMD 脚本和 PowerShell 脚本提供。
- 配置测试计算机以运行 BTP 测试。 /br>- 旨在新计算机或操作系统安装后，首次测试之前运行。 |
ConfigureMachineForBtp.batConfigureMachineForBtp.ps1 |
| GetProcessorArchitectureName | - 作为 PowerShell 脚本提供。
- 允许其他脚本标识当前计算机的体系结构。 |
GetProcessorArchitectureName.ps1 |
| RunTaefTest | PowerShell 帮助脚本，用于根据测试 DLL 名称和测试参数运行 TAEF 测试。 | RunTeafTests.ps1 |
| RunPairingTests | - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行蓝牙配对测试。 - 支持自定义参数（如果提供）。 |
RunPairingTests.batRunPairingTests.ps1 |
| RunHidTests | - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行蓝牙 HID 测试。 - 支持自定义参数（如果提供）。 |
RunHidTests.batRunHidTests.ps1 |
| RunAudioTests | - 作为 CMD 脚本和 PowerShell 脚本提供。
- 运行音频测试，包括故障检测和音频音量验证。 - 支持自定义参数（如果提供）。 |
RunAudioTests.bat RunAudioTests.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 体系结构中可用。 安装程序为每个体系结构提取每个文件的一个实例。
| 测试工具 | DESCRIPTION | 工具文件 |
|---|---|---|
| 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 | - 用于以受支持的格式（如 Ellisys、Frontline 和 Wireshark）流式传输实时 HCI 跟踪的图形工具。 - 仅适用于 x86 体系结构。 |
btvs.exe |