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 com o ID do fornecedor e do produto da integração precisam ser comissionados e disponível no Google Home app (GHA) para a conta usada com o Developer Console para serem testados. Consulte Parear um caso dispositivo para mais informações.
O Test Suite pode ser executado em um conjunto de dispositivos que uma configuração de projeto Matter específica. É muito importante executar Test Suite nas suas integrações para para garantir que tudo está funcionando corretamente.
Na página Testar, Matter integrações que estão concluídos e prontos para teste são listados em Pronto para testar.
Matter integrações que foram testadas estão listadas em a seção Testados.
Tipo de planos de teste
Há dois tipos de planos de teste:
Os planos de teste de desenvolvimento são usados para testar o controle de dispositivos 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 Matter e não são editáveis. Ao selecionar essa opção, uma nova versão do seu Matter.
Versões de integração
Quando você cria um plano de teste para uma nova versão da integração será criada. Isto numerado está em todas as listas de integração em Developer Console a partir da guia "Teste".
Novas versões nunca são criadas a partir de outras versões numeradas. Por exemplo, o o primeiro plano de teste criado para uma integração criará a versão v.1 para essa integração total. 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, esta versão é baseado na instância da integração sem controle de versão, assim como a versão 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 na versão N/A da integração, aparecerá uma nova versão
criados. O número da versão será um maior do que qualquer número numerado existente
mais recentes.
- 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 existe, a versão v.3 é criada e assim por diante.
- Se você clicar em Testar para ver uma versão numerada da integração (por exemplo, v.1), uma nova versão não é criada. Em vez disso, a versão v.1 é será testado novamente.
Para mais informações, consulte Integração controle de versões.
Criar um plano de teste
As versões de integração são um snapshot de uma integração sem controle de versão. Isso significa quando você cria um plano de teste para certificação e, assim, versão, todos os metadados relacionados a essa integração devem ser as informações que você quer usar para a integração iniciada.
Antes de criar um plano de teste para certificação, faça o seguintes:
- Criou um perfil da empresa.
- O ID do fornecedor da produção foi inserido (VID, na sigla em inglês) para a integração.
- Definiu a configuração e o branding.
Se você não tiver concluído todas as etapas da sua integração, A versão criada para o teste de certificação não pode ser certificada. Você terá para criar uma nova versão, o que significa refazer o teste, o teste de campo e a etapas.
Você também terá que criar uma nova versão e começar de novo se quiser atualizar seu branding antes que uma versão de integração seja certificada.
Para criar um plano de teste:
Na lista de projetos, clique em Abrir ao lado daquele que você quer com que trabalhar.
No menu de navegação no lado esquerdo da página, acesse Matter > Teste.
Clique em Testar para a versão N/A da integração que você quer testar. Isso cria uma nova versão de integração.
Selecione um tipo de Teste de desenvolvimento ou Teste de certificação.
- Selecione Teste de certificação se você estiver se preparando para receber a certificação em ecossistema do Google.
- Não é possível usar um teste de desenvolvimento para certificação.
Clique em Testar. Se você receber a tela de erro Nenhum dispositivo encontrado, será necessário usar um dispositivo para essa integração ainda não foi comissionada no ecossistema. Consulte Solução de problemas de pareamento para mais informações.
Na tela Configurar seu teste, dê um nome para o teste e, selecione os dispositivos que você quer testar na lista.
Clique no botão Próximo: plano de teste.
Na página Criar um plano de teste, na seção Pacotes de testes, selecione os conjuntos de testes que você quer executar.
Se você quiser sair do Test Suite, clique em Voltar para o centro de desenvolvedores.
Executar o plano de teste
No Test Suite, da página Criar um plano de teste, Clique em Executar teste. A página Ambiente de teste vai aparecer, com o status e registros de todos os testes.
Os resultados do teste aparecem assim que ele é concluído. O status de cada pacote de testes e a execução aparece ao lado dela ("Aprovado", "Falha").
O painel Registros mostra o status de cada execução de teste individual.
Para testar novamente um plano de teste na página Ambiente de teste, clique em Refazer teste na parte de cima depois que a execução do teste for concluída.
Quando terminar:
- Clique em Concluído para acessar a página Histórico de testes.
- Clique em Enviar para enviar os resultados do teste para certificação.
Visualizar 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 teste no plano de teste desejado na seção Planos de teste. Isso leva você à página Ambiente de teste, que exibe as os resultados desse teste.
Para um plano de certificação enviado, clique em Resultados na coluna Salvo para certificação para ver o relatório de resultados do teste.
Os resultados do teste também podem ser acessados para uma versão de integração na página Teste no Developer Console. Clique em Visualizar para acessar o Histórico de testes de qualquer versão de integração listada nessa página seja levada ao Histórico de testes. página 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 da integration está pronta para ser testada. | N/A | Teste essa versão do integration |
| Testado | Pronto | Esta versão do integration foi testada e pode ser enviados para 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ê pareou um dispositivo com um ID de fornecedor (VID) e um ID do produto (PID), mas ela não aparece quando você tenta testar o dispositivo com o recurso de Suite em Developer Console, isso provavelmente é causado por usando 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 no dispositivo que quer testar novamente.
Para verificar se você combinou o dispositivo correto, defina as colunas Fabricante e
Informações do modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) para o dispositivo
exclusivos no firmware de teste.
Consulte Informações do dispositivo para saber mais informações imprecisas ou inadequadas.
Verificar o VID/PID do dispositivo
Se quiser começar a desenvolver sua integração com o Google, crie uma e uma integração com o console do Google Home.
O valor de VID/PID que seu dispositivo está transmitindo precisa corresponder ao VID/PID inserido no projeto Developer Console.
- VIDs
0xFFF1:0xFFF4são reservados para testes. Eles podem ser usados para comissionamento e testes de controle básicos, mas eles não podem ser usados durante o seguintes fases de desenvolvimento:
Usar um aplicativo de engenharia Bluetooth como nRF Connect for Mobile, É possível consultar o VID/PID do dispositivo de beaconing no campo Dados de serviço.
Nesta captura de tela da versão Android do nRF Connect,
verá que o VID/PID está listado como 5A23FFFE a partir do quarto byte
no 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 small endian, mas os valores de VID/PID que você insere no projeto Developer Console estão em big endian.
Confira se os valores e o formato corretos foram inseridos nas ações do console com base no que o sniffer Bluetooth está mostrando.
Para os valores no exemplo de captura de tela, o VID e o PID na
Developer Console seria 235A e FEFF, respectivamente.