Solução de problemas do Matter

Construção

Verifique se o smartphone é compatível

Todos os dispositivos Android O (8.1, API de nível 27) e mais recentes estão compatível com Matter. Siga as etapas abaixo para verificar se seu celular 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. Instalar o "adb" no seu computador.
  2. Ative as Opções do desenvolvedor e o USB Depuração no seu smartphone Android.

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

Para verificar se você tem o 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 seu computador.
  3. Execute esse comando em um terminal para verificar se o código Os módulos Matter 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 ao exemplo abaixo, você tem Matter módulos instalados: 
    com.google.android.gms.home [v222110900]
    O número da versão acima pode ser diferente do número do seu dispositivo.
  4. Execute esse comando em um terminal para verificar se o código Os módulos Thread 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 semelhante ao exemplo a seguir, você terá Thread módulos 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. Certifique-se de que Android O (8,1) ou mais recente.
  2. O download dos módulos Matter ainda não foi feito. Esperar pelo menos 24 horas para o download. Confira se o dispositivo está ligado e carregando durante esse período para que o download não atrase. Se você ainda não recebeu os módulos em 24 horas, pode tentar uma redefinição para configuração original do o dispositivo 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 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 Fuchsia
      4. Toque em "Versão do Fúcsia". 7 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. Descubra 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 Dispositivo informação > 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

  • Para privacidade e segurança, esse recurso só deve ser usado para fins de 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 quiser começar a desenvolver sua integração com o Google, crie uma e uma integração com o 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 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 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 seu 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.

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

Os hubs do Google Matter são compatíveis com Matter 1.0 e foram testados com builds que usavam confirmações da ramificação estável v1.0-branch. Consulte a Versão pública notas para as confirmações específicas recomendadas para uso com a cada novo lançamento Hub.

Pareando

Verificar as credenciais do dispositivo

Ao usar seu próprio VID atribuído pelo Alliance, verifique se você ter 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 teste de dispositivo Matter do Google Cloud.

Verificar o hub compatível com o Matter

O hub do Matter precisa ser um dos com suporte do Google. Ele também deve estar em um criar compatível com o Matter.

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

Para verificar o build do hub, faça o seguinte: deslizando 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 "Não foi possível acessar o Google" mensagem de erro

Verifique se você criou uma integração com a combinação correta de VID/PID no Developer Console. Consulte Criar um caso integração para mais informações.

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

Se você continuar recebendo a mensagem "Não é possível acessar o dispositivo" mensagem de erro ao comissionar um Thread dispositivo e toda a depuração disponível foi esgotada você poderá limpar o Thread preferencial armazenado no seu smartphone Android para uma configuração limpa em Configurações > Aplicativos > Apps de apps > Google Play Services > Armazenamento e cache > Gerenciar espaço > LIMPAR TODOS OS DADOS.

Teste

O dispositivo comissionado não aparece no Pacote de testes

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.

Se as coisas ainda derem errado

Se, depois de seguir todas as etapas de solução de problemas aqui o problema ainda não aparecer, resolvido, não tem problema!

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