Testar uma integração do Matter

O Google Home Developer Console fornece uma página Teste em que é possível configurar e executar testes na integração do Matter usando o Google Home Test Suite. O Test Suite é um aplicativo separado integrado ao Developer Console que processa todos os testes de integração.

Os dispositivos para os IDs do fornecedor e do produto da integração precisam ser comissionados e disponíveis em Google Home app (GHA) para a conta usada com o Developer Console para serem testados. Consulte Parear um dispositivo Matter para mais informações.

O Test Suite pode ser executado em um conjunto de dispositivos que pertencem a uma configuração de projeto Matter específica. É muito importante executar Test Suite nas suas integrações para garantir que tudo esteja funcionando corretamente.

Na página Testar, as integrações Matter concluídas e prontas para teste são listadas em Pronto para testar.

As integrações Matter que foram testadas estão listadas na seção Testadas.

Tipo de planos de teste

Existem dois tipos de planos de teste:

  • Os planos de teste de desenvolvimento são usados para testar dispositivos de controle usando Matter. Elas são editáveis, mas não podem ser enviadas para a certificação Matter.

  • Os planos de teste da certificação são específicos para a certificação Matter e não são editáveis. Selecionar essa opção cria uma nova versão da integração Matter.

Versões de integração

Quando você cria um plano de teste para certificação, uma nova versão da integração é criada. Essa versão numerada é listada em todas as listas de integração no Developer Console a partir da guia "Teste".

Novas versões nunca são criadas a partir de outras versões numeradas. Por exemplo, o primeiro plano de teste que você criar para uma integração criará a versão v.1 para ela. A criação de outro plano de teste vai gerar a versão v.2 para essa integração, mas essa versão não será baseada na v.1. Em vez disso, essa versão é baseada na instância sem versão da integração, assim como a v.1.

A versão N/A de uma integração representa a instância sem versão da integração, que é gerenciada na guia Desenvolver.

Em outras palavras, em Matter > Test no Developer Console:

  • Se você clicar em Testar para a versão N/A da integração, uma nova versão será criada. O número da versão será maior que qualquer versão numerada existente.
    • Se não houver versões numeradas, será criada a versão v.1.
    • Se a versão v.1 existir, será criada a v.2. Se a versão v.2 existir, a versão v.3 será criada e assim por diante.
  • Se você clicar em Testar para uma versão numerada da integração (por exemplo, v.1), uma nova versão v.1 será criada. Em vez disso, a versão v.1 é testada novamente.

Saiba mais em Controle de versão de integração.

Criar um plano de teste

As versões de integração são um resumo de uma integração sem controle de versão. Isso significa que, ao criar um plano de teste para certificação e, portanto, uma versão de integração, todos os metadados relacionados a essa integração precisam ser as informações que você quer usar para a integração lançada.

Antes de criar um plano de teste para certificação, faça o seguinte:

  1. Criou um perfil da empresa.
  2. O ID do fornecedor (VID, na sigla em inglês) de produção da integração foi inserido.
  3. Configuração e branding definidos.

Se você não tiver concluído todas essas etapas para sua integração, uma versão de integração criada para teste de certificação não poderá ser certificada. Você precisará criar uma nova versão, o que significa refazer as etapas de teste, teste de campo e certificação.

Também será necessário criar uma nova versão e começar de novo se você quiser atualizar seu branding antes de uma versão de integração ser certificada.

Para criar um plano de teste:

Acessar o Play Console

  1. Na lista de projetos, clique em Abrir ao lado do projeto em que você quer trabalhar.

  2. No menu de navegação à esquerda da página, acesse Matter > Testar.

  3. Clique em Testar para a versão N/A da integração que você quer testar. Esta ação cria uma nova versão de integração.

  4. Selecione um tipo de teste: Teste de desenvolvimento ou Teste de certificação. Como criar um novo plano de teste

    • Selecione Teste de certificação se você está se preparando para receber a certificação no ecossistema do Google.
    • Os testes de desenvolvimento não podem ser usados para certificação.
  5. Clique em Testar. Se você receber uma tela de erro Nenhum dispositivo encontrado, isso significa que um dispositivo para essa integração ainda não foi comissionado no ecossistema. Consulte Solução de problemas de pareamento para mais informações.

  6. Na tela Configure your test, forneça um nome para o teste e selecione os dispositivos que você quer testar na lista.

  7. Clique no botão Próximo: plano de teste.

  8. Na página Criar um plano de teste, na seção Pacotes de testes, selecione os conjuntos de testes que você quer executar.

Criar um plano de teste

Se você quiser sair do Test Suite, clique em Retornar ao Centro para Desenvolvedores.

Executar o plano de teste

No Test Suite, na página Criar um plano de teste, clique em Executar teste. A página Ambiente de teste será exibida com o status e os registros de todos os testes.

Os resultados serão exibidos assim que os testes forem concluídos. O status de cada execução do pacote de testes é exibido ao lado dele (Aprovado, Com falha).

O painel Registros mostra o status de cada execução de teste individual.

Resultados do teste

Para testar novamente um plano de teste na página Ambiente de teste, clique em Testar novamente na parte de cima após a conclusão da execução do teste.

Após a conclusão:

Visualizar e interpretar os resultados do seu teste

Na página Histórico de testes em Test Suite, é possível ver resultados de testes anteriores de um plano de desenvolvimento ou de um plano de teste de certificação não enviado clicando em Testar novamente no plano desejado na seção Planos de teste. Isso leva você à página Ambiente de teste, que exibe os resultados desse teste.

Histórico de testes

Em um plano de certificação enviado, clique em Resultados na seção Salvos para certificação para conferir o relatório de resultados do teste.

Os resultados do teste também podem ser acessados para uma versão de integração na guia Teste em Developer Console. Clique em Ver para consultar o Histórico de teste de qualquer versão de integração listada nessa página para acessar a página Histórico de teste no Test Suite.

Status do console

Os seguintes status do Console são encontrados na fase de teste:

Section Status Descrição Requisito O que fazer agora
Pronto para testar Pronto Esta versão do integration está pronta para teste. N/A Teste essa versão do integration.
Testado Pronto Esta versão do integration foi testada e pode ser enviada para teste de campo ou certificação.

A versão foi testada e salva.

Todos os casos de teste reprovados incluem justificativas para a análise do Google.

Teste novamente, se quiser.

Solução de problemas

O dispositivo comissionado não aparece no pacote de testes

Se você pareou um dispositivo com um ID do fornecedor (VID, na sigla em inglês) e um ID do produto (PID, na sigla em inglês) de teste, mas ele não aparece quando você tenta testar o dispositivo com o Pacote de testes no Developer Console, é provável que isso seja causado ao usar a mesma combinação de VID e PID de teste em várias integrações.

Para resolver problemas, remova todos os dispositivos de teste do Developer Console e pareie o dispositivo que você quer testar novamente.

Para validar o pareamento do dispositivo correto, defina as informações do fabricante e do modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) do dispositivo para valores exclusivos no firmware de teste.

Consulte Informações do dispositivo para mais informações.

Verificar o VID/PID do dispositivo

Se você quiser começar a desenvolver sua integração com o Google, crie um projeto e uma integração no console do Google Home.

Solução de problemas do Bluetooth Sniffer

O valor de VID/PID que o dispositivo está beacon precisa corresponder ao VID/PID inserido no seu projeto do Developer Console.

  • VIDs 0xFFF10xFFF4 são reservados para testes. Elas podem ser usadas para comissionamento básico e testes de controle, mas não durante as seguintes fases de desenvolvimento:

Com um app de engenharia de Bluetooth, como o nRF Connect for Mobile, é possível ver o VID/PID do dispositivo de beacon no campo Dados de serviço.

Nesta captura de tela da versão Android do nRF Connect, você vai notar que o VID/PID está listado como 5A23FFFE a partir do quarto byte do campo Dados de serviço. Isso indica um VID de 5A23 e um PID de FFFE, ambos no formato Little endian.

O app BLE exibe os valores no small endian, mas os valores de VID/PID inseridos no projeto Developer Console estão no big endian.

Valide se os valores e o formato corretos foram inseridos no projeto do Console do Actions com base no que o detector de Bluetooth está mostrando.

Para os valores na captura de tela de exemplo, o VID e o PID em Developer Console seriam 235A e FEFF, respectivamente.