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 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 uma plataforma compatível com Matter no ecossistema do Google Home.
Exonerações de responsabilidade
Em relação aos procedimentos descritos na documentação Matter, esteja ciente do seguinte:
- Recomendamos que a conta usada para desenvolvimento tenha apenas um hub ativado para Matter conectado para testes. Vários hubs ativados para Matter conectados ao mesmo tempo ou à mesma estrutura durante o teste podem resultar em comportamento imprevisível.
- Todos os procedimentos pressupõem o uso de uma máquina Linux executando o Ubuntu 20.04 para criar e atualizar amostras de Matter, que foram testadas pelo Google. Embora os computadores macOS sejam compatíveis, recomendamos o uso do Linux. Instruções específicas do Mac são chamadas nos procedimentos conforme necessário.
Como criar
Para criar um dispositivo compatível com Matter que se integre ao ecossistema do 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 nossos codelabs. Recomendamos fazer pelo menos um destes codelabs:
Depois disso, consulte nossa lista de dispositivos compatíveis para garantir que o que você planeja integrar seja compatível com o ecossistema do Google Home. Em seguida, leia a Lista de verificação para desenvolvedores e entenda 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 um roteador de borda Thread de uso geral para dispositivos com Thread ativado.
- 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, a GHA e smart displays.
- Matter dispositivo compatível
- Um dispositivo ou uma placa de desenvolvimento que foi atualizado com um build ou app de exemplo compatível com Matter.
- Dispositivo móvel
- O smartphone de teste usado para ajudar no pareamento. No momento, o tipo é um smartphone Android.
Pré-requisitos
Para integrar totalmente um dispositivo compatível com Matter ao ecossistema Google Home, um desenvolvedor precisa ter:
- Um hub do Google com suporte ao Thread para servir como um roteador de borda para dispositivos habilitados para Thread e como um caminho de fulfillment local para rotear intents de casa inteligente.
- Um dispositivo móvel (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
- 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.
- Um dispositivo com o Matter ativado. Ele precisa ser um dos
tipos de dispositivo Matter com suporte no
ecossistema Google Home e pode ser:
- Seu próprio produto com firmware compatível com Matter.
- Um dos seguintes dispositivos Matter para usar na verificação de ponta a ponta:
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 | Kit de desenvolvimento IOTZTB-DK006 | ||
Realtek | Ameba série D | ||
Silicon Labs | Kit de desenvolvimento EFR32MG24 | ||
Kit para iniciantes EFR32MG Zigbee e Thread | |||
Telink | TLSR9518 | ||
Instrumentos texas | Kit de desenvolvimento do LaunchPad CC2652R7 (link em inglês) |
ID do fornecedor
Por padrão, é possível usar um dos VIDs alocados pelo CSA para fins de
testes. 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 iniciada, é necessário primeiro verificá-la pelo Google para garantir que ele tenha sido emitido pelo CSA.
Esse VID precisa ser implementado no firmware do dispositivo.
Um dispositivo Matter só pode ser pareado no ecossistema 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.
- Seu VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google vai validar se você é o proprietário desse VID antes que você possa 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, é 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 comissiona o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários de testes de campo.
- Os usuários de consumidor só poderão usar seu produto depois que ele for certificado pela Alliance.
Que tipos de usuários podem comissionar o dispositivo no 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 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 no DCL Alliance. A integração não existe no Developer Console | ||
Produção | Certificado no DCL Alliance e existe 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 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 são visíveis para os usuários finais:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Consulte Chaves de ativação/desativação para saber como isso afeta os interruptores de luz.