Primeiros passos com o Matter

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

  Versão da prévia para desenvolvedores  

Com o programa de desenvolvedores do Google Home, os fabricantes podem conectar dispositivos de casa inteligente ao ecossistema do Google Home. Estamos expandindo o caminho local de fulfillment da casa inteligente com a capacidade de adicionar Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the Google Nest Hub (2nd gen) .

Esta documentação descreve como dar os primeiros passos na criação e integração de uma plataforma compatível com Matter no ecossistema do Google Home.

Exonerações de Responsabilidade

Com relação aos procedimentos descritos nesta prévia para desenvolvedores de Matter, esteja ciente do seguinte:

  • A conta usada para desenvolvimento só pode ter um hub Matter ativado conectado para teste. Vários hubs ativados para Matter conectados ao mesmo tempo ou à mesma estrutura durante o teste podem gerar um comportamento imprevisível.
  • Todos os procedimentos pressupõem o uso de uma máquina Linux com Ubuntu 20.04 para criar e atualizar amostras de Matter, que foram testadas pelo Google. Embora as máquinas MacOS sejam compatíveis, o Linux é recomendado. Instruções específicas para Mac são chamadas nos procedimentos conforme necessário.
  • Somente a versão do Android do GHA é compatível.

Definições

Os seguintes termos são usados ao longo desta documentação:

Roteador de borda
Um hub que implementa um Thread Border Router for Thread-enabled devices.
Hub
Um Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
compatível
Dispositivo com Matter
Um dispositivo ou uma placa de desenvolvimento que foi atualizada com um app de build ou de exemplo Matter ativado.
Dispositivo móvel
O smartphone de teste usado para auxiliar no pareamento. No momento, este é um Android phone.

Pré-requisitos

Extensões de ambiente de desenvolvimento integrado recomendadas para desenvolvimento em casos

Para integrar totalmente um dispositivo compatível com Matter ao ecossistema do Google Home, o desenvolvedor precisa ter:

  1. Um hub do Google com suporte para linhas de execução que funciona como um roteador de borda para dispositivos compatíveis com linhas de execução e como um caminho de fulfillment local para rotear intents da casa inteligente.
  2. Um dispositivo móvel (smartphone de teste) que atenda aos requisitos mínimos:
    • Android O (8.1, API de nível 27) ou mais recente (suporte para iOS será adicionado posteriormente)
    • Recurso BLE
  3. Um ID do fornecedor (VID, na sigla em inglês) e um ID do produto (PID, na sigla em inglês) para o dispositivo Matter ativado.
  4. Um dispositivo com o Matter ativado. Esse dispositivo precisa ser um dos Matter tipos de dispositivo com suporte no ecossistema do Google Home e pode ser:
    • Seu próprio produto com firmware ativado Matter.
    • Uma placa de desenvolvimento de uma plataforma de fornecedor compatível que pode servir como um dispositivo habilitado para Matter para verificação completa. As seguintes plataformas são compatíveis:
Tabela: Matter exemplos de fornecedores de componentes eletrônicos
Fornecedor Plataforma Guias Suporte do Thread
Laboratório Bouffalo BL602 Guia de início rápido
BL702 Guia de início rápido
Espressif ESP32 Início rápido
Teste OTA
Semicondutor nórdico nRF52840 DK Início rápido
Teste OTA
NXP; Kit de desenvolvimento IOTZTB-DK006 Guia de início rápido
Realtek Série Ameba D Guia de início rápido
Silicon Labs Kit de primeiros passos Zigbee e Thread do EFR32MG Guia de início rápido
Kit de desenvolvimento EFR32MG24 Guia de início rápido
Telink TLSR9518 Guia de início rápido

ID do fornecedor

Por padrão, é possível usar um dos VIDs alocados pela CSA para fins de teste. Selecione uma destas opções: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Se quiser usar um VID de produção para que sua integração seja certificada e lançada, primeiro ele precisa ser verificado pelo Google para garantir que tenha sido emitido pelo CSA.

Esse VID deve ser implementado no firmware do dispositivo.

Um dispositivo Matter só pode ser pareado com o ecossistema do Google Home em determinados cenários de ID do fornecedor e tipo de dispositivo.

  • Um VID de teste não pode ser usado em um dispositivo de consumo.
  • Para que um dispositivo de produção (consumidor) seja pareado, ele precisa ser certificado na DCL de CSA.
  • Para fins de desenvolvimento e teste em campo, um dispositivo precisa ser registrado no Google Home Developer Console .
Tabela: IDs de fornecedor (VID, na sigla em inglês) e cenários de pareamento de tipo de dispositivo
Que tipos de usuários podem colocar o dispositivo no ecossistema do Google Home?
Tipo de VID Status de registro e certificação da VID Produção
(usuários consumidores)
Desenvolvimento
(desenvolvedores, usuários de teste de campo)
Teste Não registrado (não pode ser certificado) POLÍTICA SOBRE SAÚDE E MEDICAMENTOS POLÍTICA SOBRE SAÚDE E MEDICAMENTOS
Teste Registrado em Developer Console (não pode ser certificado) POLÍTICA SOBRE SAÚDE E MEDICAMENTOS
Produção Não certificado, não registrado POLÍTICA SOBRE SAÚDE E MEDICAMENTOS
Produção Não certificado, registrado no Developer Console
Produção Certificado na DCL de CSA, não registrado POLÍTICA SOBRE SAÚDE E MEDICAMENTOS
Produção Tem a certificação DCL CSA e está registrada no Developer Console

ID do produto

As informações sobre o dispositivo são lidas usando os clusters do Matter Descriptor, em vez do ID do produto. Você pode atribuir qualquer ID do produto durante o desenvolvimento, de acordo com o esquema de numeração da sua empresa, desde que ele corresponda ao ID do produto da integração do Matter, se especificado.

Recursos não compatíveis

Alguns clusters Matter ainda não estão expostos aos usuários, embora possam ser usados pelo sistema. Na maioria dos casos, isso significa que os atributos expostos por esses clusters não ficarão visíveis para os usuários finais:

Tabela: Matter clusters não expostos a usuários no ecossistema do Google Home
Tipo de cluster Clusters
Core
  • Vinculação
  • Rótulo
  • Rótulo fixo
  • Rótulo do usuário
  • Ações
  • Chave do grupo
  • Configuração de localização
  • Localização do formato da hora
  • Localização de unidades
  • Configuração da fonte de energia
  • Fonte de energia
  • Clusters de diagnósticos (registros de diagnóstico, diagnósticos gerais, diagnósticos de software, diagnósticos de rede Thread, diagnósticos de rede Wi-Fi, diagnósticos de rede Ethernet)
  • Sincronização de tempo
  • Seleção de modo
Aplicativo
  • Os grupos e as cenas não são diretamente compatíveis. Uma funcionalidade equivalente está disponível nas Rotinas.
  • Todos os clusters de mídia. Uma funcionalidade equivalente está disponível via Google Cast .