Noções básicas sobre o Matter

O programa para desenvolvedores do Google Home permite que fabricantes de dispositivos se conectem os dispositivos de casa inteligente com o ecossistema Google Home. Estamos expandindo a Caminho de fulfillment local de ações de casa inteligente com a possibilidade de adicionar Dispositivos com Matter para configuração usando o Google Home app (GHA) e controlá-los 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 um Plataforma com suporte a Matter no ecossistema do Google Home.

Exonerações de responsabilidade

Com relação aos procedimentos descritos no Matter documentação, esteja ciente do seguinte:

  • Recomendamos que a conta usada para desenvolvimento tenha apenas um Hub ativado para Matter conectado para teste. Vários status Hubs ativados para Matter conectados no ao mesmo tempo ou conectados à mesma estrutura durante os testes podem resultar em comportamento imprevisível.
  • Todos os procedimentos pressupõem o uso de uma máquina Linux executando Ubuntu 20.04 para criando e atualizando exemplos de Matter, que foram testado pelo Google. Embora os computadores macOS sejam compatíveis, recomendamos o uso do Linux. Específico para Mac e as instruções são mencionadas nos procedimentos conforme necessário.

Como criar

Para criar um dispositivo compatível com Matter que se integre à ecossistema do Google Home, você vai trabalhar com uma placa de desenvolvimento compatível com Matter e a Matter SDK.

A maneira mais fácil de começar é com nossos codelabs. Qa recomendamos que você faça pelo menos um destes codelabs:

Depois disso, consulte nossa lista de dispositivos compatíveis para garantir que que planeja integrar é compatível com o ecossistema do Google Home. Em seguida, leia a Lista de verificação para desenvolvedores 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 em toda esta documentação:

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

Pré-requisitos

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

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

  1. Um hub do Google com suporte para Thread para servir como roteador de borda para dispositivos habilitados para Thread e como caminho de fulfillment para rotear intents de 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)
    • iOS (v16.5 ou mais recente)
    • Recurso BLE
  3. Um ID do fornecedor (VID) e um ID do produto (PID) para o dispositivo com Matter.
  4. Um dispositivo com o Matter ativado. Este dispositivo deve ser um dos os Matter tipos de dispositivos suportados na ecossistema do Google Home, e pode ser:
    • Seu próprio produto com firmware compatível com Matter.
    • Um dos seguintes dispositivos Matter para usar para verificação de ponta a ponta:
Tabela: Matter exemplos de fornecedores de componentes eletrônicos
Fornecedor Plataforma Suporte do Thread Guia
Bouffalo Lab BL602
BL702
Espressif ESP32 Testes OTA
Semicondutores nórdicos nRF52840 DK (link em inglês) Testes OTA
NXP Desenvolvimento IOTZTB-DK006 kit
Realtek Ameba série D
Silicon Labs Kit de desenvolvimento EFR32MG24
EFR32MG Zigbee e Thread Kit para iniciantes
Telink TLSR9518
Instrumentos texas Desenvolvimento do LaunchPad CC2652R7 kit

ID do fornecedor

Por padrão, você pode usar um dos VIDs alocados pelo CSA para testes propósitos. Selecione uma destas opções: 0xFFF1, 0xFFF2, 0xFFF3 e 0xFFF4.

Para usar um VID de produção para que sua integração seja certificada e iniciada, primeiro você precisa ele deve ser verificado pelo Google para garantir que foi emitido pelo CSA.

Esse VID precisa ser implementado no firmware do dispositivo.

Um dispositivo Matter só pode ser pareado com o Google Home ecossistema 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.
  • Seu VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google vai confirmar que você é o proprietário desse VID antes de poder usá-lo no Google Home Developer Console. Depois que isso acontecer, você poderá criar integrações para esse VID.
  • Para fins de desenvolvimento e teste de campo, um projeto e integração com o a combinação de VID e PID correspondente precisa ser criada no Developer Console. O comissionamento do usuário o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários de teste de campo.
  • Os usuários de consumidor só poderão usar seu produto depois que ele for certificado pela Alliance:
Tabela: ID do fornecedor (VID) e tipo de dispositivo de pareamento
Que tipos de usuários podem encomendar para o ecossistema do Google Home?
Tipo de VID Certificação VID e status da integração do console Produção
(Usuários consumidores)
Desenvolvimento
(desenvolvedores, usuários de testes de campo)
Teste Nenhuma integração no Developer Console (não pode ser certificada)
Teste A integração existe no Developer Console (não pode ser com certificação)
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 no DCL Alliance, a integração não existem no seguinte local: Developer Console
Produção Certificado no DCL do Alliance e que existe integração em Developer Console

ID do produto

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

Recursos não compatíveis

No entanto, alguns clusters Matter ainda não foram expostos aos usuários. elas podem ser usadas pelo sistema. Na maioria dos casos, isso significa que os atributos expostas 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 ativação/desativação. de como isso afeta os interruptores de luz.