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 do Google Home Developer, os fabricantes de dispositivos podem conectar os dispositivos de casa inteligente ao ecossistema do Google Home. Estamos expandindo o caminho de fulfillment local das Ações de casa inteligente com a capacidade de adicionar dispositivos compatíveis com Matter para configuração usando o Google Home app (GHA) no Android e os controlar usando Google Assistant, GHA ou smart displays como o Google Nest Hub (2nd gen).

Esta documentação descreve como começar a criar e integrar uma plataforma compatível com Matter no ecossistema do Google Home.

Exonerações de Responsabilidade

Sobre os procedimentos descritos nesta Visualização do desenvolvedor de Matter, esteja ciente do seguinte:

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

Definições

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

  • hub: um dispositivo Google Nest compatível, como o Google Nest Hub (2nd gen). Um hub é necessário para controlar dispositivos habilitados para Matter por meio do GHA.

  • Roteador de borda: um Google Hub que implementa um roteador de borda de uso geral para dispositivos compatíveis com Thread.

  • Dispositivo com Matter: um dispositivo ou uma placa de desenvolvimento que foram atualizados com um app de exemplo ou build ativado para Matter.

  • dispositivo móvel: o smartphone de teste usado para ajudar com o pareamento. No momento, este é um smartphone Android.

Pré-requisitos

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

  1. Um Nest Hub (2nd gen) para servir como um roteador de borda para dispositivos habilitados para linha de execução e como um caminho de fulfillment local para rotear intents da casa inteligente.
  2. Um dispositivo móvel (telefone de teste) que atenda aos requisitos mínimos:
    • Android O (8.1, API de nível 27) ou mais recente (compatibilidade com iOS a ser adicionada mais tarde)
    • Recurso BLE
  3. Um ID do fornecedor (VID) e um ID do produto (PID) do dispositivo compatível com Matter.
  4. Um dispositivo compatível com Matter Esse dispositivo precisa ser um dos tipos de dispositivo Matter aceitos no ecossistema do Google Home e pode ser:
    • Seu produto com firmware ativado para Matter.
    • Uma placa de desenvolvimento de uma plataforma de fornecedores compatíveis que pode servir como um dispositivo com tecnologia 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 (link em japonês) Início rápido
Espressif ESP32 Início rápido
Semicondutor nórdico nRF52840 DK Início rápido
PP Kit de desenvolvimento IOTZTB-DK006 Início rápido
Realtek Série Ameba D Início rápido
Laboratórios de silício Kit básico de zigbee e linha de execução EFR32MG Início rápido

ID do fornecedor

Use seu ID de fornecedor (VID) de acordo com a especificação do CSA Matter. Se você não tiver um VID atribuído a você, use um dos VIDs alocados pelo CSA para fins de teste: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Esse VID deve ser implementado no firmware do dispositivo.

ID do produto

As informações sobre o dispositivo são lidas usando os clusters do descritor do caso, em vez do ID do produto. É possível atribuir qualquer ID de produto durante o desenvolvimento, de acordo com o esquema de numeração da empresa, desde que ele corresponda ao ID do produto da integração do Matter, se especificado.

Recursos não compatíveis

Alguns recursos da especificação Matter não são totalmente compatíveis com o ecossistema do Google Home:

  • Sem suporte para atualização OTA de firmware.

Além disso, vários outros clusters Matter ainda não foram 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 aos usuários no ecossistema do Google Home
Tipo de cluster Clusters
Core
  • Vinculação
  • Rótulo
  • Marcador fixo
  • Rótulo do usuário
  • Ações
  • Chave do grupo
  • Configuração de localização
  • Localização de formato de tempo
  • Localização de unidade
  • Configuração da fonte de energia
  • Fonte de energia
  • Clusters de diagnóstico (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
  • Grupos e cenas não são diretamente compatíveis. A funcionalidade equivalente está disponível nas Rotinas.
  • Todos os clusters de mídia. A funcionalidade equivalente está disponível via Google Cast.