Primeiros passos com o Matter

  Versão da Visualização do desenvolvedor  

O programa para desenvolvedores do Google Home permite que os fabricantes conectem 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 controlá-los usando Google Assistant, GHA ou smart displays como 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 Visualização do desenvolvedor de Matter, esteja ciente do seguinte:

• A conta usada para desenvolvimento só pode ter um hub ativado para Matter conectado para teste. Vários hubs ativados para Matter conectados ao mesmo tempo ou conectados à mesma estrutura durante os testes podem resultar em comportamentos imprevisíveis.
• 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 GHA do Android é compatível.

Definições

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

Roteador de borda

Um hub que implementa um roteador de borda Thread de uso geral para dispositivos com Thread.

Hub

Um dispositivo Google Nest compatível, como o Google Nest Hub (2nd gen) Um hub é necessário para controlar dispositivos com Matter em outras superfícies, como Assistant, GHA e smart displays.

Dispositivo com Matter ativado

Um dispositivo ou placa de desenvolvimento que foi atualizada com um app de build ou amostra ativado para Matter.

Dispositivo móvel

O smartphone de teste usado para ajudar no pareamento. No momento, este é um smartphone Android.

Pré-requisitos

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

1. Um hub do Google compatível com Thread para servir como um roteador de borda para dispositivos compatíveis com Thread 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 (compatibilidade com iOS a ser adicionada mais tarde)
   • 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 ativado para Matter.
4. Um dispositivo com Matter ativado. Esse dispositivo precisa ser um dos tipos de dispositivo Matter compatíveis com o ecossistema do Google Home e pode ser:
   • Seu próprio produto com firmware ativado para Matter.
   • Uma placa de desenvolvimento de uma plataforma de fornecedor compatível que pode servir como um dispositivo ativado para Matter para verificação completa. As seguintes plataformas são compatíveis:

Tabela: Matter exemplos de fornecedores de silício

Fornecedor	Plataforma	Guias	Suporte do Thread
Laboratório Bouffalo	BL602	Início rápido
	BL702	Início rápido
Espressif	ESP32 (em inglês)	Início rápido Teste OTA
Semicondutor nórdico	nRF52840 DK	Início rápido Teste OTA
PP	Kit de desenvolvimento IOTZTB-DK006	Início rápido
Realtek	Série Ameba D	Início rápido
Silicon Labs	Kit de desenvolvimento EFR32MG24	Início rápido
	Kit de primeiros passos para Zigbee e Thread EFR32MG	Início rápido
Telink	TLSR 9518 (link em inglês)	Início rápido
Instrumentos texas	Kit de desenvolvimento do LaunchPad CC2652R7 (link em inglês)	Início rápido

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 possa ser certificada e lançada, você precisa primeiro verificá-lo pelo Google para garantir que ele foi emitido para você pelo CSA.

Esse VID deve ser implementado no firmware do dispositivo.

Um dispositivo Matter só pode ser pareado no ecossistema do Google Home em determinados cenários de 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 CSA. O Google validará se você é o proprietário desse VID antes de usá-lo no Google Home Developer Console. Quando isso acontecer, você poderá criar integrações para esse VID.
• Para fins de desenvolvimento e teste em campo, é necessário criar no Developer Console um projeto e uma integração com a combinação correspondente de VID e PID. O usuário que comissionou o dispositivo precisa ser membro do projeto ou ser incluído na lista de usuários do teste de campo.
• Os usuários do consumidor só poderão usar seu produto depois que ele for certificado pela CSA.

Tabela: cenários de pareamento do ID do fornecedor (VID, na sigla em inglês) e tipo de dispositivo

		Quais 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 consumidores)	Desenvolvimento (Desenvolvedores, usuários de teste em campo)
Testar	Sem integração no Developer Console (não é possível fazer a certificação)
Testar	A integração existe no Developer Console (não pode ser certificado)
Produção	Não certificado, a integração não existe na Developer Console
Produção	Sem certificação, a integração existe no Developer Console
Produção	Com certificação da DCL da CSA, a integração não existe na Developer Console
Produção	Certificado na DCL de CSA e integração no Developer Console

ID do produto

As informações sobre o dispositivo são lidas no cluster de informações básicas Matter. O ID do produto codificado no firmware do dispositivo precisa corresponder ao ID da integração Matter no Developer 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 meio desses clusters não estarã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 1 Rótulo Marcador fixo Rótulo do usuário Ações Chave de grupo Configuração de localização Localização de formato de hora Localização de unidades Configuração da fonte de energia Fonte de alimentação 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	Os grupos e as cenas não são diretamente compatíveis. A funcionalidade equivalente está disponível em Rotinas. Todos os clusters de mídia. A funcionalidade equivalente está disponível via Google Cast.

1 Consulte Ativar/desativar interruptores de luz para saber como isso afeta os interruptores.