O Google Home Developer Console oferece uma página Test em que você pode configurar e executar testes na sua Matter integração 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 o ID do produto da integração precisam ser provisionados e estar 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 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 concluídas e prontas para teste são listadas em Ready to test.
As integrações Matter que foram testadas são listadas em a seção Tested.
Tipos de planos de teste
Estes tipos de planos de teste estão disponíveis:
Os planos de teste de desenvolvimento são usados para testar o controle de dispositivos usando Matter. Eles podem ser editados, mas não podem ser enviados para Matter certificação.
Os planos de teste de certificação são especificamente para a certificação Matter e não podem ser editados. A seleção dessa opção cria uma nova versão da sua Matter integração.
Os planos de teste CSA Interop permitem pular a fase de teste e usar os resultados do laboratório de testes de interoperabilidade Connectivity Standards Alliance (Alliance). Essa opção de teste está disponível para todos os tipos de dispositivos compatíveis.
Use o Test Suite no Developer Console para enviar os resultados do teste para certificação. Se você quiser executar o Test Suite para fins de teste durante o desenvolvimento, consulte a página do 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 "Test".
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 não versionada da integração, assim como a v.1.
A versão N/A de uma integração representa a instância não versionada da integração, que é gerenciada na guia Develop.
Em outras palavras, em Matter > Test no Developer Console:
- Se você clicar em Test para a versão N/A da integração, uma nova versão será criada. O número da versão será um 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 Test para 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 será testada novamente.
Para mais informações, consulte Versionamento de integração.
Criar um plano de teste
As versões de integração são um snapshot de uma integração não versionada. 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:
- Criar um perfil da empresa.
- Insira o ID do fornecedor (VID) de produção para a integração.
- Configurar a configuração e a marca.
Se você não tiver concluído todas essas etapas para sua integração, uma versão de integração criada para testes de certificação não poderá ser certificada. Você terá que criar uma nova versão, o que significa refazer as etapas de teste, teste de campo e certificação.
Você também terá que 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:
Na lista de projetos, clique em Open ao lado do projeto com que você quer trabalhar.
No menu de navegação à esquerda da página, acesse Matter > Test.
Clique em Test para a versão N/A da integração que você quer testar. Essa ação cria uma nova versão de integração.
Selecione um tipo de teste e clique em Test.
- Selecione Certification test se estiver se preparando para a certificação no ecossistema do Google.
- Um Development test não pode ser usado para certificação.
- Selecione CSA Interop test para usar os resultados do seu Alliance Test Lab de interoperabilidade para pular as fases de teste e teste de campo no fluxo de integração do Matter.
Na tela Configure your test, forneça um nome para o teste e clique em Automatically pair device para selecionar um dispositivo a ser pareado.
Para um dispositivo Android:
- Confira se você instalou GHA no smartphone.
- Conecte o smartphone com um cabo USB à máquina host.
- Você precisa
ativar a depuração USB no dispositivo
O
APKcom.chip.interop.moblysnippetserá baixado e instalado automaticamente. - Depois que o smartphone estiver conectado, insira o código de pareamento e o Device name para parear automaticamente o dispositivo.
Para um dispositivo iOS:
- Você precisará parear o dispositivo manualmente. Consulte a seção do app Google Home para instruções sobre como parear manualmente.
- Se você tiver um dispositivo, talvez seja necessário desparear o dispositivo e parear novamente ou parear um novo dispositivo.
Clique no botão Next: Test plan.
Na página Create a test plan, na seção Test suites, selecione os pacotes de testes que você quer executar.
Se você quiser sair do Test Suite, clique em
Return to Developer
Center.
Executar o plano de teste
No Test Suite, na página Create a test plan, clique em Run Test. A página ambiente de teste aparece com o status e os registros de todos os testes.
Os resultados do teste aparecem quando os testes são concluídos. O status de cada execução do pacote de testes aparece ao lado dele (Passed, Failed).
O painel Logs mostra o status de cada execução do teste individual.
Para testar novamente um plano de teste na página ambiente de teste, clique em
Retest na parte de cima
depois que a execução do teste for concluída.
Depois de terminar:
- Clique em Done para acessar a página Test history ou
- Clique em Submit para enviar os resultados do teste para certificação.
Conferir e interpretar os resultados do teste
Na página Test history do Test Suite, você pode conferir os resultados de testes anteriores de um plano de desenvolvimento ou um plano de teste de certificação não enviado clicando em Retest para o plano de teste desejado na seção Test plans. Isso leva você à página Test Environment , que mostra os resultados desse teste.
Para um plano de certificação enviado, clique em Results na seção Saved for certification 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 View para o Test history de qualquer versão de integração listada nessa página para acessar a página Test history 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 em seguida |
|---|---|---|---|---|
| Pronto para testar | Pronto | Esta versão do integration está pronta para teste. | N/A | Teste esta versão do integration. |
| Testado | Pronto | Esta versão do integration foi testada e pode ser enviada para Field Trial ou certificação. |
A versão foi testada e salva. Todos os casos de teste com falha incluem justificativas para análise do Google. |
Teste novamente, se quiser. |
Testar novamente
Certificação
Se você precisar testar novamente para certificação, pareie o dispositivo depois de iniciar o novo teste.
Desenvolvimento
Se você precisar testar novamente para desenvolvimento, poderá usar o dispositivo atual sem parear novamente.
Solução de problemas
O dispositivo provisionado não aparece no Test Suite
Se você pareou um dispositivo com um ID do fornecedor (VID) e um ID do produto (PID) de teste, mas ele não aparece quando você tenta testar o dispositivo com o Test Suite em Developer Console, é provável que isso seja 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 do Developer Console e pareie o dispositivo que você quer testar novamente.
Para validar se você pareou o correto, defina as informações do fabricante e do modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) do dispositivo como 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 de VID/PID que o dispositivo está transmitindo precisa corresponder ao VID/PID inserido no projeto Developer Console.
- Os VIDs
0xFFF1—0xFFF4são reservados para testes. Eles podem ser usados para testes básicos de provisionamento e controle, mas não podem ser usados durante as seguintes fases de desenvolvimento:
Usando um app de engenharia Bluetooth, como nRF Connect for Mobile, você pode conferir o VID/PID do dispositivo de beacon no campo Service Data.
Nesta captura de tela da versão Android do nRF Connect, você verá que o VID/PID é listado como 5A23FFFE a partir do quarto byte do campo Service Data. 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 de VID/PID inseridos no projeto Developer Console estão em big endian.
Valide se os valores e o formato corretos foram inseridos no projeto do Actions Console com base no que o sniffer 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.