Compartilhar via


Obter o pacote de software da Plataforma de Teste Bluetooth da Microsoft

O pacote de software da Plataforma de Teste Bluetooth (Bluetooth Test Platform - BTP) contém tudo o que é necessário ser instalado em seu computador de teste para testar a interoperabilidade de dispositivos com Bluetooth com a pilha Bluetooth do Windows. A documentação incluída na instalação fornece informações sobre como configurar o hardware e sugere topologias para a melhor cobertura de teste. Ele também descreve os detalhes de como executar os testes e coletar logs.

Baixar o pacote de software BTP

Use o botão a seguir para baixar a versão mais recente do pacote de software BTP:

Dica

Execute o instalador no mesmo computador que você planeja usar para executar seus testes.

Após a instalação, não copie, mova ou exclua os arquivos instalados. Se você tiver um problema com a instalação, use o recurso Adicionar ou Remover Programas do Windows para desinstalar completamente o pacote BTP. Em seguida, faça uma instalação limpa com o instalador de pacotes do Windows (.msi).

Examinar as atualizações do pacote BTP por versão

A tabela a seguir descreve as alterações no pacote de software BTP para cada versão lançada.

Versão Alterações
1.14.0 - Foram adicionados testes de áudio que podem usar um arquivo de áudio personalizado para ser reproduzido em vez de um tom de teste gerado.
- Corrigido um problema que fazia o desemparelhamento do Bluefruit Feather falhar em alguns dispositivos centrais.
– Confiabilidade aprimorada do analisador de áudio Traduci em testes.
- Várias outras correções e melhorias para testar a confiabilidade.
1.12.2 – Adicionado suporte para o rádio BM62.
- Adicionadas verificações de versão de firmware explícitas para o Wi-Fi ESP32.
- Outras correções de coexistência Wi-Fi e melhorias para testar a confiabilidade.
1.11.1 - Correção de falha ao executar testes de energia HID em espera sem um botão de energia virtual instalado.
- Adicionadas verificações de versão de firmware explícitas para o Bluefruit Feather.
- Várias outras correções e melhorias para testar a confiabilidade.
1.10.1 - Adicionados testes de HID sobre estado de potência.
- Várias outras correções e melhorias para testar a confiabilidade.
1.9.0 – Suporte aprimorado para dispositivos BTP usando plug-ins DLL personalizados.
- Corrigido um problema que afetava os testes de mudo/desativação de áudio em determinados builds do Windows.
- Várias outras correções e melhorias para testar a confiabilidade.
1.8.0 - Adicionado Wi-Fi com testes de coexistência de áudio Bluetooth e HID.
- Adicionados testes de silenciar e reativar áudio.
- Adição da opção para gravar o áudio reproduzido durante testes em um arquivo local.
- Correção de um problema que poderia fazer com que o Bluefruit Feather relatasse incorretamente seu endereço Bluetooth.
- Corrigido o problema com a execução de testes de áudio atuais em builds mais antigos do Windows.
- Várias outras correções e melhorias para testar a confiabilidade.
1.7.2 - Adicionados testes de coexistência de áudio Wi-Fi e Bluetooth.
- Adicionado suporte para o Bluefruit Feather (nRF52840) com paridade total ao suporte do Bluefruit existente.
- Foram adicionados testes para todos os tipos de negociação de chaves de emparelhamento usando o Bluefruit Feather.
- Corrigido o problema em que as falhas ocorrevam em um loop apertado se um dispositivo estava desconectado no meio do teste.
- Várias correções e melhorias para testar a confiabilidade.
1.6.2 - Não é mais necessário uma instalação do WDK (Windows Driver Kit) para executar testes BTP.
- Adicionados testes hid de pressionamento de tecla rápida para capturar mais facilmente repetições de chave e outros problemas de desempenho.
- Adição de toque rápido no teclado e movimento do mouse após testes ociosos de HID que são úteis para a execução de loops.
- Adição da medição de latência de reconexão aos testes HID.
- Adicionada a reconexão após a desconexão ociosa em testes de HID.
- Várias correções e melhorias para testar a confiabilidade.
1.5.1 – Ferramentas de diagnóstico adicionadas: BTVS (Bluetooth Virtual Sniffer) e Log de Rastreamento de Eventos Bluetooth (ETL) (BTETLParse.exe).
- Várias correções e melhorias para testar a confiabilidade.
1.4.0 - Adicionado teste de latência de teclado a testes HID.
– Foram adicionados testes de mouse aos testes HID.
- Adicionados testes de cenário de áudio + HID.
- Adição de testes de bateria.
- Corrigido o problema que fazia com que os testes falhassem ao carregar ao serem executados em versões mais antigas do Windows.
- Correção de scripts que falharam ao executar em ambientes não nativos do CMD/PowerShell.
- Várias correções e melhorias para testar a confiabilidade.
1.3.1 - Adicionados testes de áudio capazes de exercer o Perfil Avançado de Distribuição de Áudio (A2DP) e o HFP (Perfil de Hands-Free).
- Adição da validação de volume de áudio e detecção de falhas por meio de uma FPGA (matriz de porta programável de campo) no Traduci.
- Testes renomeados para nomes mais curtos e mais fáceis de usar.
- Várias correções e melhorias para testar a confiabilidade.
1.2.1 - Moveu o BTP da visualização privada para o público.
- Adição de SleepTests experimentais que demonstram uma nova capacidade do Traduci de executar comandos com atraso.
- Várias correções e melhorias para testar a confiabilidade.

Ferramentas no pacote

As próximas seções listam as ferramentas fornecidas no pacote de software BTP.

Arquivos independentes de arquitetura

As ferramentas a seguir no pacote de software BTP existem como arquivos independentes.

Ferramenta de teste Descrição Arquivos de ferramentas
ConfigurarMachineForBtp - Fornecido como um script CMD e um script do PowerShell.
– Configura um computador de teste para executar testes BTP. /br>- Destinado a ser executado antes da primeira execução de teste em uma nova instalação do sistema operacional ou computador.

ConfigureMachineForBtp.batConfigureMachineForBtp.ps1
GetProcessorArchitectureName – Fornecido como um script do PowerShell.
- Permite que outros scripts identifiquem a arquitetura do computador atual.
GetProcessorArchitectureName.ps1
RunTaefTest Script auxiliar do PowerShell para executar testes TAEF, considerando o nome da DLL de teste e os parâmetros de teste. RunTeafTests.ps1
RunPairingTests - Fornecido como um script CMD e um script do PowerShell.
- Executa os testes de emparelhamento Bluetooth.
– Dá suporte a argumentos personalizados, se fornecidos.

RunPairingTests.batRunPairingTests.ps1
RunHidTests - Fornecido como um script CMD e um script do PowerShell.
- Executa os testes Bluetooth HID.
– Dá suporte a argumentos personalizados, se fornecidos.

RunHidTests.batRunHidTests.ps1
RunAudioTests - Fornecido como um script CMD e um script do PowerShell.
– Executa testes de áudio, incluindo detecção de falhas e validação de volume de áudio.
– Dá suporte a argumentos personalizados, se fornecidos.
RunAudioTests.bat
RunAudioTests.ps1
RunAudioHidScenarioTests - Fornecido como um script CMD e um script do PowerShell.
– Executa testes de cenário hid e áudio.
– Dá suporte a argumentos personalizados, se fornecidos.

RunAudioHidScenarioTests.batRunAudioHidScenarioTests.ps1
RunBatteryTests - Fornecido como um script CMD e um script do PowerShell.
- Executa testes de bateria.
– Dá suporte a argumentos personalizados, se fornecidos.

RunBatteryTests.batRunBatteryTests.ps1
RunWiFiAudioScenarioTests - Fornecido como um script CMD e um script do PowerShell.
– Executa Wi-Fi e testes de cenário de áudio.
– Dá suporte a argumentos personalizados, se fornecidos.

RunWiFiAudioScenarioTests.batRunWiFiAudioScenarioTests.ps1
RunWiFiAudioHidScenarioTests - Fornecido como um script CMD e um script do PowerShell.
– Executa testes de cenário de Wi-Fi, áudio e HID.
– Dá suporte a argumentos personalizados, se fornecidos.

RunWiFiAudioHidScenarioTests.batRunWiFiAudioHidScenarioTests.ps1
RunPowerStateTests - Fornecido como um script CMD e um script do PowerShell.
- Executa os testes de estado de energia.
– Dá suporte a argumentos personalizados, se fornecidos.

RunPowerStateTests.batRunPowerStateTests.ps1
Firmware Bluefruit Feather Binários compilados para o dispositivo Bluefruit Feather. BtpBluefruit_nRF52840.ino.zip
ESP32 Firmware Binários compilados para o dispositivo ESP32wifi. WiFi-ESP32.ino.bin
WiFi-ESP32.ino.partitions.bin

Binários dependentes da arquitetura

Os arquivos listados nesta tabela estão disponíveis nas arquiteturas X86, AMD64 e Arm64. O instalador extrai uma instância de cada arquivo por arquitetura.

Ferramenta de teste Descrição Arquivo de ferramenta
TAEF Para obter mais informações, consulte TAEF (Estrutura de Criação e Execução de Teste). C:\BTP\<version>\TAEF
BtpDevicePlugin Binário necessário para dar suporte a testes que usam uma rádio Bluetooth do Windows local. Microsoft.Bluetooth.TestPlatform.BtpDevicePlugin.dll
GenericSerialIO Binário necessário para dar suporte a dispositivos BTP que utilizam comunicação serial no Windows. Microsoft.Bluetooth.TestPlatform.GenericSerialIO.dll
HidTests Binário de teste para os testes de HID do Bluetooth.
- Pode ser executado com TAEF ou usando os scripts fornecidos.
TaefHidTests.dll
PairingTests Binário de teste para testes de emparelhamento Bluetooth.
- Pode ser executado com TAEF ou usando os scripts fornecidos.
TaefPairingTests.dll
AudioTests Binário de teste para testes de áudio Bluetooth.
- Pode ser executado com TAEF.
TaefAudioTests.dll
AudioHidScenarioTests – Binary de teste para testes de cenários de Áudio Bluetooth e HID.
- Pode ser executado com TAEF.
TaefAudioHidScenarioTests.dll
BatteryTests – Teste binário para testes de bateria Bluetooth.
- Pode ser executado com TAEF.
TaefBatteryTests.dll
WiFiCoexScenarioTests – Teste binário para testes de coexistência de Bluetooth e Wi-Fi.
- Pode ser executado com TAEF.
TaefWiFiCoexScenarioTests.dll
PowerStateTests Binário de teste para testes de estado de energia do Bluetooth.
- Pode ser executado com TAEF.
TaefPowerStateTests.dll
TraduciCmd - Ferramenta de linha de comando para consultar e alterar o estado do Traduci, incluindo comandos de depuração.
- Usado para atualização de firmware para hardware Traduci.
TraduciCmd.exe
BTETLParse Ferramenta de linha de comando para extrair rastreamentos de HCI (Interface do Controlador de Host) de arquivos ETL com suporte. BTETLParse.exe
BTVS - Ferramenta gráfica para transmitir rastreamentos HCI ao vivo em formatos com suporte (como Ellisys, Frontline e Wireshark).
- Disponível apenas para a arquitetura x86.
btvs.exe