O Google Home Developer Console fornece uma página Teste em que você pode configurar e executar testes na integração 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 o ID do fornecedor e do produto da integração precisam ser ativados e estar disponíveis em Google Home app (GHA) para a conta que está sendo usada com o Developer Console para serem testados. Consulte Como 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 específica do projeto Matter. É muito importante executar o Test Suite nas suas integrações para garantir que tudo esteja funcionando corretamente.
Na página Test, as integrações Matter que estão completas e prontas para teste são listadas em Prontas para teste.
As integrações de Matter que foram testadas estão listadas na seção Testado.
Tipos de planos de teste
Há dois tipos de planos de teste:
Os planos de teste de desenvolvimento são usados para testar dispositivos de controle usando Matter. Elas podem ser editadas, mas não podem ser enviadas para a certificação Matter.
Os planos de teste de certificação são específicos para a certificação Matter e não podem ser editados. A seleção dessa opção cria uma nova versão da integração Matter.
Use o Test Suite no Developer Console para enviar os resultados do teste para a certificação. Se você quiser executar o Test Suite para fins de teste durante o desenvolvimento, consulte a página Google Home Test Suite para a versão independente.
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 criado para uma integração vai criar a versão v.1 para essa integração. A criação de outro plano de teste vai criar 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 Develop.
Em outras palavras, em Matter > Test no Developer Console:
- Se você clicar em Testar na versão N/A da integração, uma nova versão será
criada. O número da versão será um número maior do que qualquer versão numerada
existente.
- Se não houver versões numeradas, a versão v.1 será criada.
- Se a versão v.1 existir, a versão v.2 será criada. Se a versão v.2 existir, a versão v.3 será criada e assim por diante.
- Se você clicar em Testar em uma versão numerada da integração (por exemplo, v.1), uma nova versão não será criada. Em vez disso, a versão v.1 é testada novamente.
Para mais informações, consulte Gerenciamento de versões de integração.
Criar um plano de teste
As versões de integração são um snapshot de uma integração sem 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, verifique se você fez o seguinte:
- Criou um perfil da empresa.
- Digitou o ID do fornecedor de produção (VID) para a integração.
- Configuração e branding configurados.
Se você não tiver concluído todos esses requisitos para a integração, uma versão de integração criada para testes de certificação não poderá ser certificada. Você vai precisar criar uma nova versão, o que significa refazer as etapas de teste, teste de campo e certificação.
Você também vai precisar criar uma nova versão e começar de novo se quiser atualizar sua marca antes que uma versão de integração seja certificada.
Para criar um plano de teste:
Acessar o console do desenvolvedor
Na lista de projetos, clique em Abrir ao lado do projeto com que você quer trabalhar.
No menu de navegação à esquerda da página, acesse Matter > Teste.
Clique em Testar na versão N/A da integração que você quer testar. Essa ação cria uma nova versão da integração.
Selecione um tipo de teste: Teste de desenvolvimento ou Teste de certificação.
- Selecione Teste de certificação se você estiver se preparando para a certificação no ecossistema do Google.
- Um teste de desenvolvimento não pode ser usado para certificação.
Clique em Testar. Se você receber uma tela de erro No device found (nenhum dispositivo encontrado), um dispositivo para essa integração ainda não foi comissionado no ecossistema. Consulte Solução de problemas de pareamento para mais informações.
Na tela Configure your test, informe um nome para o teste e selecione os dispositivos que você quer testar na lista.
Clique no botão Próxima: plano de teste.
Na página Criar um plano de teste, na seção Pacotes de teste, selecione os pacotes de teste que você quer executar.
Se você quiser sair do Test Suite, clique em
Voltar ao Centro para
Desenvolvedores.
Executar o plano de teste
Na página Test Suite, na página Criar um plano de teste, clique em Executar teste. A página Ambiente de teste aparece com o status e os registros de todos os testes.
Os resultados dos testes aparecem após a conclusão deles. O status de cada execução de conjunto de testes aparece ao lado dele (Aprovado, Falhou).
O painel Logs mostra o status de cada execução de teste.
Para repetir um plano de teste na página Ambiente de teste, clique em
Repetir teste na parte de cima
depois que a execução do teste for concluída.
Depois de terminar:
- Clique em Concluído para acessar a página Histórico de testes ou
- Clique em Enviar para enviar os resultados do teste para a certificação.
Conferir e interpretar os resultados do teste
Na página Histórico de testes do Test Suite, você pode conferir os resultados anteriores de um plano de desenvolvimento ou um plano de teste de certificação não enviado clicando em Refazer o teste do plano de teste desejado na seção Planos de teste. Isso leva você à página Ambiente de teste, que mostra os resultados desse teste.
Para 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 Test do Developer Console. Clique em Ver para que o histórico de testes de qualquer versão de integração listada nessa página seja direcionada para a página Histórico de testes 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 testes. | N/A | Teste esta versão do integration. |
| Testado | Pronto | Esta versão do integration foi testada e pode ser enviada para o teste de campo ou certificação. |
A versão foi testada e salva. Todos os casos de teste com falha incluem justificativas para análise do Google. |
Refazer o teste, se quiser. |
Solução de problemas
O dispositivo comissionado não aparece no Test Suite
Se você tiver pareado um dispositivo com um ID do fornecedor (VID) e um ID do produto (PID) de teste, mas ele não aparecer quando você tentar testar o dispositivo com o Test Suite em Developer Console, isso provavelmente é causado pelo uso da mesma combinação de VID e PID de teste em várias integrações.
Para resolver o problema, remova todos os dispositivos de teste de Developer Console e emparelhe o dispositivo que você quer testar novamente.
Para validar se você emparelhou o 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 Google Home Console.
O valor VID/PID que o dispositivo está transmitindo precisa corresponder ao VID/PID digitado no projeto Developer Console.
- VIDs
0xFFF1—0xFFF4estão reservados para testes. Eles podem ser usados para testes básicos de comissionamento e controle, mas não podem ser usados durante as fases de desenvolvimento a seguir:
Usando um app de engenharia de Bluetooth, como o nRF Connect para dispositivos móveis, é possível conferir o VID/PID do dispositivo de beacon no campo Dados do serviço.
Nesta captura de tela da versão Android do nRF Connect,
o VID/PID é listado como 5A23FFFE, começando no quarto byte do
campo Dados do serviço. Isso indica um VID de 5A23 e um PID de FFFE,
ambos no formato little endian.
O app BLE mostra os valores em little endian,mas os valores VID/PID que você insere no projeto Developer Console estão em big endian.
Valide se os valores e o formato corretos foram inseridos no seu projeto do Actions Console com base no que o sniffer de Bluetooth está mostrando.
Para os valores na captura de tela de exemplo, o VID e o PID no
Developer Console seriam 235A e FEFF, respectivamente.