Noções básicas sobre o Matter

O programa para desenvolvedores do Google Home permite que os fabricantes conectem 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 possibilidade de adicionar dispositivos com Matter para configuração usando Google Home app (GHA) 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 na documentação do Matter, esteja ciente do seguinte:

  • Recomendamos que a conta usada para desenvolvimento tenha 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 pressupõem o uso de uma máquina Linux que executa o Ubuntu 20.04 para criar e atualizar amostras de Matter, que foram testadas pelo Google. Embora máquinas macOS sejam compatíveis, o Linux é o recomendado. As instruções específicas do Mac são mencionadas nos procedimentos conforme necessário.

Como criar

Para criar um dispositivo compatível com Matter e que possa ser integrado ao ecossistema Google Home, você vai trabalhar com uma placa de desenvolvimento compatível com Matter e o SDK do Matter.

A maneira mais fácil de começar é com os codelabs. Recomendamos que você realize pelo menos um destes codelabs:

Depois disso, confira nossa lista de dispositivos compatíveis para garantir que o que você planeja integrar é aceito pelo ecossistema do Google Home. Em seguida, leia a Lista de verificação do desenvolvedor para entender todo o fluxo de desenvolvimento, desde a criação do projeto até o lançamento.

Dispositivos compatíveis Lista de verificação para desenvolvedores

Definições

Os seguintes termos são usados nesta documentação:

Roteador de borda
Um hub que implementa um roteador de borda Thread de uso geral para dispositivos compatíveis com Thread.
Hub
Um dispositivo Google Nest com suporte, como o Google Nest Hub (2nd gen). É necessário ter um hub para controlar dispositivos com Matter usando outras plataformas, como Assistant, GHA e smart displays.
Dispositivo compatível com Matter
Um dispositivo ou placa de desenvolvimento que foi atualizado com um build ou app de exemplo ativado para Matter.
Dispositivo móvel
O smartphone de teste usado para ajudar no pareamento. No momento, este é um smartphone Android.

Pré-requisitos

Extensões de ambiente de desenvolvimento integrado recomendadas para o desenvolvimento do Matter

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

  1. Um hub do Google compatível com Thread para servir como um roteador de borda para dispositivos com Thread ativado e como um caminho de fulfillment local para rotear intents de 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)
    • iOS (v16.5 ou mais recente)
    • Recurso BLE
  3. Um ID do fornecedor (VID, na sigla em inglês) e um ID do produto (PID, na sigla em inglês) do dispositivo ativado para Matter.
  4. Um dispositivo compatível com Matter Esse dispositivo precisa ser um dos Matter tipos de dispositivo compatíveis com o ecossistema Google Home e pode ser:
    • Seu produto com firmware compatível com Matter.
    • Um dos seguintes dispositivos Matter para usar na verificação de ponta a ponta:
Tabela: Matter exemplos de fornecedores de silício
Fornecedor Plataforma Suporte do Thread Guia
Laboratório de bouffalo BL602
BL702
Espressif ESP32 Teste OTA
Semicondutores nórdicos nRF52840 DK (link em alemão) Teste OTA
Nxp Kit de desenvolvimento IOTZTB-DK006
Realtek Ameba D Series
Laboratórios de silicone Kit de desenvolvimento EFR32MG24
Kit EFR32MG Zigbee e Thread Starter
Telink TLSR9518
Instrumentos texas Kit de desenvolvimento do LaunchPad CC2652R7

ID do fornecedor

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

Para usar um VID de produção para que sua integração seja certificada e lançada, primeiro é necessário que o Google verifique se ele foi emitido pelo CSA.

Esse VID deve ser implementado no firmware do dispositivo.

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

  • Não é possível usar um VID de teste em um dispositivo de consumidor.
  • Seu VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google validará que você é o proprietário desse VID antes de usá-lo no Google Home Developer Console. Quando isso acontecer, será possível criar integrações para o VID.
  • Para fins de desenvolvimento e teste de campo, é necessário criar no Developer Console um projeto e a integração com a combinação de VID e PID correspondente. O usuário que comissionou o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários dos testes de campo.
  • Os usuários pessoais só poderão usar seu produto depois que ele for certificado pelo Alliance.
Tabela: cenários de pareamento do ID do fornecedor (VID, na sigla em inglês) e do tipo de dispositivo
Que tipos de usuários podem comissionar o dispositivo no ecossistema do Google Home?
Tipo de VID Certificação de VID e status de integração do console Produção
(Usuários de consumo)
Desenvolvimento
(Desenvolvedores, usuários de testes de campo)
Testar Nenhuma integração no Developer Console (não pode ser certificado)
Testar A integração existe no Developer Console (não pode ser certificada)
Produção Não certificado, a integração não existe no Developer Console
Produção Não certificado, a integração existe no Developer Console
Produção Certificada pela DCL Alliance, a integração não existe no Developer Console
Produção Certificada na DCL Alliance, e a integração existe no Developer Console

ID do produto

As informações sobre o dispositivo são lidas do cluster de informações básicas Matter. O ID do produto codificado no firmware do dispositivo precisa corresponder ao ID do produto da integração Matter no Play Console.

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 ficam visíveis para os usuários finais:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

1 Consulte Interruptores de luz para ligar/desligar para saber como isso afeta os interruptores de luz de liga/desliga.