Esta página foi traduzida pela API Cloud Translation.

Solução de problemas do Matter

Edifício

Verificar se o smartphone é compatível

Todos os dispositivos Android O (8.1, API de nível 27) e versões mais recentes são compatíveis com Matter. Siga as etapas abaixo para verificar se o smartphone tem os módulos necessários.

Configurar o Android Debug Bridge

O Android Debug Bridge (adb) precisa ser configurado antes da solução de problemas. Para preparar o Hangout:

Instale o "adb" no seu computador.
Ative as Opções do desenvolvedor e a depuração USB no smartphone Android.

Verificar os módulos do Matter do Google Play Services (GPS)

Para verificar se você tem os módulos Google Play services Matter, faça o seguinte:

Configure o Android Debug Bridge.
Use um cabo USB para conectar o smartphone Android ao computador.
Execute este comando em um terminal para verificar se os módulos Matter necessários estão instalados:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
  
```
Se uma saída semelhante à mostrada abaixo for exibida, você tem os módulos Matter instalados:
```
com.google.android.gms.home [v222110900]
```
O número da versão acima pode ser diferente do seu dispositivo.
Execute este comando em um terminal para verificar se os módulos Thread necessários estão instalados:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
  
```
Caso uma saída parecida com a do exemplo abaixo, você tem os módulos Thread instalados:
```
com.google.android.gms.threadnetwork [v222106301]
```
O número da versão no dispositivo pode ser diferente.

Se os módulos não estiverem listados, isso significa que:

Você tem uma versão desatualizada do Android. Confira se é Android O (8.1) ou mais recente.
O download dos módulos Matter ainda não foi feito. Aguarde pelo menos 24 horas para que o download seja concluído. Verifique se o dispositivo está ligado e carregando durante esse período para que o download não atrase. Se você não receber os módulos em até 24 horas, tente fazer uma redefinição para configuração original do dispositivo para forçar o download dos módulos.

Verifique o VID/PID do seu 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.

Solução de problemas do Bluetooth Sniffer

O valor de VID/PID que seu dispositivo está beaconing precisa corresponder ao VID/PID inserido no seu projeto Google Home Developer Console.

VIDs 0xFFF1: 0xFFF4 são reservados para testes. Eles podem ser usados para comissionamento e testes de controle básicos, mas não durante as fases de desenvolvimento a seguir:
- Teste
- Teste de campo
- OTA (em inglês)

Usando um app de engenharia do 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ê verá 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 em formato pequeno endian.

O app BLE exibe os valores no small endian,mas os valores de VID/PID que você insere 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 detecção 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.

Observação:o VID de 235A não pode mais ser usado no projeto e é usado aqui para fins ilustrativos. Confira se você está usando um VID de acordo com a especificação Matter ou um dos VIDs de teste, conforme indicado na página Criar uma integração do Matter.

Verificar se o dispositivo foi criado usando uma ramificação do SDK do Matter compatível

Os hubs do Google Matter são compatíveis com o Matter 1.0 e foram testados com builds que usavam confirmações da ramificação estável v1.0-branch. Confira as notas da versão públicas para conferir as confirmações específicas recomendadas para uso com cada nova versão do hub.

Pareando

Verificar as credenciais do dispositivo

Ao usar seu próprio VID atribuído pelo Alliance, verifique se você tem as credenciais corretas no dispositivo:

declaração de certificação (CD, na sigla em inglês).
Certificado de atestado de dispositivo (DAC, na sigla em inglês) e a respectiva cadeia de certificados.

Para saber mais, consulte Criar certificados de teste do dispositivo Matter.

Verificar sua central compatível com o Matter

O hub do Matter precisa ser um dos hubs compatíveis com o Google. Ele também precisa estar em um build compatível com o Matter.

Alguns hubs também são roteadores de borda do Thread e, portanto, permitem desenvolver e testar dispositivos Thread. Outros hubs oferecem suporte apenas a dispositivos Matter Wi-Fi e Ethernet, a menos que você tenha outro roteador de borda na rede para ativar a conectividade Thread.

Para verificar o build do hub, você pode deslizar o dedo para baixo da borda superior > Roda de configuração > Informações do dispositivo > Informações técnicas > Versão do firmware do Chromecast.

O comissionamento falha com a mensagem de erro "Não foi possível entrar em contato com o Google"

Confira se você criou uma integração com a combinação correta de VID/PID no Developer Console. Consulte Criar uma integração do Matter para saber mais.

O comissionamento falha com a mensagem de erro "Não é possível acessar o dispositivo"

Se você continuar recebendo a mensagem de erro "Não foi possível acessar o dispositivo" ao comissionar um dispositivo Thread e tiver esgotado todas as opções de depuração disponíveis, remova as credenciais Thread preferenciais armazenadas no smartphone Android para uma configuração limpa em Configurações > Apps > Apps de apps > Google Play Services > Armazenamento e cache > Gerenciar espaço > LIMPAR TODOS OS DADOS.

testes

O dispositivo comissionado não aparece no pacote de testes

Se você pareou um dispositivo com um ID do fornecedor (VID) 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 pelo uso da 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 confirmar que você pareou o 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.

Se ainda assim as coisas derem errado

Se depois de seguir todas as etapas de solução de problemas o problema ainda não foi resolvido, não tem problema.

Nas etapas de solução de problemas, você coletou dados importantes sobre o dispositivo, o projeto do console e o ambiente. Com esses dados em mãos, verifique a página de suporte para saber como compartilhar seu problema da melhor forma com a comunidade e a equipe de suporte do Google Home.