Solução de problemas do Matter

Edifício

Verifique se o smartphone é compatível

Todos os dispositivos Android O (8.1, API de nível 27) e mais recentes são compatíveis com o 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:

  1. Instale o "adb" no computador.
  2. 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:

  1. Configure o Android Debug Bridge.
  2. Use um cabo USB para conectar o smartphone Android ao computador.
  3. 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 aparecer uma saída semelhante à mostrada abaixo, 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.
  4. 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"
    Se aparecer 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 seu dispositivo pode ser diferente.

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

  1. Você tem uma versão desatualizada do Android. Verifique se o valor é Android O (8.1) ou mais recente.
  2. 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 24 horas, tente redefinir o dispositivo para a configuração original e forçar o download dos módulos.

Registros do dispositivo do hub do Fuchsia

Para ativar um hub para a recuperação de registros locais:

  1. Envie um e-mail com o número de série e o modelo dos dispositivos para o Technical Account Manager (TAM) do Google. Eles podem ser encontrados em letras minúsculas embaixo do dispositivo.
  2. Depois que ele estiver na lista de permissões, ative o recurso seguindo estas etapas:
    • No hub:
      1. Deslize de cima para baixo na tela.
      2. Toque no ícone de configurações .
      3. Encontre a versão do Fuchsia: em um Google Nest Hub (2nd gen), acesse Informações do dispositivo > Informações técnicas > Versão do Fuchsia
      4. Toque em "Versão do Fúcsia" sete vezes. Isso ativa as opções do desenvolvedor
      5. Voltar ao menu de nível superior
      6. Toque em "Opções do desenvolvedor".
      7. Toque em "Registro de parceiros".
    • O recurso vai ficar ativado por 24 horas. Depois disso, reative o recurso de geração de registros da etapa 5 em diante.
  3. Consiga o endereço IP do seu hub:
    • No hub, se tiver uma tela:
      1. Deslize de cima para baixo na tela.
      2. Toque no ícone de configurações .
      3. Encontre o endereço IP do dispositivo: em um Nest Hub (2nd gen), acesse Informações do dispositivo > Informações técnicas > Endereço IP.
    • De Google Home app (GHA) no smartphone:
      1. Toque no dispositivo para abrir a página de detalhes.
      2. Toque no ícone de configurações para abrir a página de configurações.
      3. Encontre o endereço IP do dispositivo: acesse Informações do dispositivo > Informações técnicas > Endereço IP.
  4. Para recuperar os registros do hub, faça uma solicitação GET HTTP para o hub a partir de um computador na mesma rede Wi-Fi.
    • Anote a porta e o caminho do endpoint: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • A conexão pode ser mantida aberta por apenas um minuto, mas os dados recuperados do buffer geralmente têm de 20 a 30 minutos de eventos passados.
      • O ideal é que os registros sejam extraídos usando esse método imediatamente após a conclusão de um procedimento de teste para garantir que o buffer tenha conteúdo relevante para o teste (semelhante aos relatórios de bugs do Android).

Desativar a edição de registros do Android

  • Por motivos de privacidade e segurança, esse recurso só deve ser usado para testes de engenharia.
  • Não use essa opção com usuários ou dispositivos de produção.
  • Etapas:
    1. Envie as Contas do Google dos usuários que terão registros não editados para seu TAM do Google.
    2. Depois de confirmar que sua conta foi adicionada à lista de permissões, reinicie o smartphone.

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 console do Google Home.

Solução de problemas do sniffer de Bluetooth

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

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

Ao usar um app de engenharia Bluetooth, como o nRF Connect for Mobile, é possível ver o VID/PID do dispositivo de beacon no campo Service Data.

Nesta captura de tela da versão Android do nRF Connect, é possível observar 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 (links em inglês).

O app BLE mostra os valores em small endian, mas os valores de VID/PID inseridos no projeto Developer Console ficam em big endian.

Confira se os valores e o formato corretos foram inseridos no projeto do Console do Actions com base no que o sniffer 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.

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

Os hubs da Matter do Google são compatíveis com o Matter 1.0 e foram testados com builds que usaram confirmações da ramificação estável v1.0-branch. Consulte as Notas da versão pública para ver as confirmações específicas recomendadas para 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 do dispositivo (DAC, na sigla em inglês) e a cadeia de certificados.

Para mais informações, consulte Criar certificados de teste de dispositivo Matter.

Verificar o hub 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 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, faça o seguinte: Deslize o dedo para baixo a partir 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"

Verifique 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 mais informações.

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 é possível acessar o dispositivo" ao comissionar um dispositivo Thread e tiver esgotado todas as opções de depuração disponíveis, limpe as credenciais Thread preferidas armazenadas no smartphone Android para fazer 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 de 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, isso provavelmente é 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 de Developer Console e pareie o dispositivo que você quer testar novamente.

Para confirmar que você pareou o dispositivo 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.

Se as coisas ainda 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, consulte a Página de suporte para saber a melhor forma de compartilhar seu problema com a comunidade e a equipe de suporte do Google Home.