Solução de problemas do Matter

Construção

Verificar se o smartphone é compatível

Todos os dispositivos Android O (8.1, nível 27 da API) e 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:

  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 Matter Google Play services, 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 você receber uma saída semelhante à abaixo, os módulos Matter estão 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 você receber uma saída semelhante à do exemplo a seguir, os módulos Thread estão 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 ele é Android O (8.1) ou mais recente.
  2. Os módulos Matter ainda não foram transferidos. Aguarde pelo menos 24 horas para fazer o download. Confira se o dispositivo está ligado e em carregamento durante esse período para que o download não seja atrasado. Se você não receber os módulos em 24 horas, tente redefinir o dispositivo para a configuração original para 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 seus 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 Fuchsia" sete vezes. Isso vai ativar 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 a partir da etapa 5.
  3. Consiga o endereço IP do seu hub:
    • No hub, se ele 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 extrair os registros do hub, faça uma solicitação HTTP GET para o hub em um computador na mesma rede Wi-Fi.
    • Observe 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 anteriores.
      • 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 contenha conteúdo relevante para o teste (semelhante aos relatórios de bugs do Android).

Desativar a omissã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 dispositivos ou usuários de produção.
  • Etapas:
    1. Envie as Contas do Google dos usuários que vão ter registros não editados para o TAM do Google.
    2. Depois de confirmar que sua conta foi adicionada à lista de permissões, reinicie o smartphone.

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.

Resolver problemas com o Bluetooth Sniffer

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:

Usando um app de engenharia 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 small endian, mas os valores de VID/PID inseridos no projeto Developer Console ficam 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.

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 a Matter 1.0 e foram testados com builds que usaram confirmações da ramificação estável v1.0-branch. Verifique as notas da versão pública para conferir as confirmações específicas recomendadas para uso com cada nova versão do hub.

Pareando

Verificar as credenciais do dispositivo

Quando você usa seu próprio VID atribuído por Alliance, verifique se você tem as credenciais corretas no dispositivo:

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

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

Verificar o hub compatível com o Matter

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

Alguns hubs também são roteadores de borda do Thread e permitem que você desenvolva e teste dispositivos Thread. Outros hubs têm suporte apenas para 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

A 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 VID/PID correta no Developer Console. Consulte Criar uma integração do Matter.js para mais informações.

A 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 salvas no seu smartphone Android para uma configuração limpa em Configurações > Apps > Apps do dispositivo > Serviços do Google Play > Armazenamento e cache > Gerenciar espaço > LIMPAR TODOS OS DADOS.

Teste

O dispositivo comissionado não aparece no Test Suite

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 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.

Se as coisas ainda derem errado

Se o problema não for resolvido depois de seguir todas as etapas de solução de problemas, não se preocupe.

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