O programa de desenvolvedores do Google Home permite que os fabricantes de dispositivos conectem os dispositivos de casa inteligente ao ecossistema do Google Home. Estamos expandindo o caminho de fulfillment local de Ações da casa inteligente com a capacidade de adicionar dispositivos compatíveis com Matter para configuração usando o Google Home app (GHA) e controlá-los usando Google Assistant, GHA ou telas inteligentes, como a Google Nest Hub (2nd gen).
Esta documentação descreve como começar a criar e integrar uma plataforma com suporte a Matter no ecossistema do Google Home.
Exonerações de responsabilidade
Com relação aos procedimentos descritos na documentação do Matter, considere o seguinte:
- Recomendamos que a conta usada para desenvolvimento tenha apenas um hub ativado para Matter conectado para testes. Vários hubs com Matter conectados ao mesmo tempo ou conectados à mesma estrutura durante o teste podem resultar em comportamento imprevisível.
- Todos os procedimentos assumem o uso de uma máquina Linux com o Ubuntu 20.04 para criar e atualizar amostras Matter, que foram testadas pelo Google. Embora as máquinas macOS sejam compatíveis, o Linux é recomendado. As instruções específicas para Mac são mencionadas nos procedimentos conforme necessário.
Como criar
Para criar um dispositivo compatível com Matter que se integre ao ecossistema Google Home, você vai trabalhar com uma placa de desenvolvimento compatível com Matter e o SDK Matter.
A maneira mais fácil de começar é consultando nossos codelabs. Recomendamos realizar pelo menos um dos seguintes codelabs:
Depois, confira 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 para entender todo o fluxo de desenvolvimento, da criação do projeto ao 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). Um hub é necessário para controlar dispositivos compatíveis com Matter em outras plataformas, como Assistant, GHA e smart displays.
- Dispositivo com Matter
- Um dispositivo ou placa de desenvolvimento que foi atualizado com um build ou app de exemplo ativado por Matter.
- Dispositivo móvel
- O smartphone de teste usado para ajudar no pareamento. No momento, este é um telefone Android.
Pré-requisitos
Para integrar totalmente um dispositivo compatível com Matter ao ecossistema do Google Home, o desenvolvedor precisa ter:
- Um hub do Google com suporte ao Thread para servir como um roteador de borda para dispositivos com suporte ao Thread e como um caminho de fulfillment local para rotear intents da casa inteligente.
- Um dispositivo móvel (smartphone de teste) que atenda aos requisitos mínimos:
- Android O (8.1, nível 27 da API ou mais recente)
- iOS (v16.5 ou mais recente)
- Recurso BLE
- Um ID do fornecedor (VID) e um ID do produto (PID) para o dispositivo Matter.
- Um dispositivo com Matter. Esse dispositivo precisa ser um dos
tipos de dispositivo Matter com suporte no
ecossistema do 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 | Teste OTA | |
| Nordic Semiconductor | nRF52840 DK | Teste OTA | |
| NXP | Kit de desenvolvimento IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | Kit de desenvolvimento EFR32MG24 | ||
| Kit de iniciantes EFR32MG Zigbee e Thread | |||
| Telink | TLSR9518 | ||
| Texas Instruments | Kit de desenvolvimento 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 e certificar e lançar sua integração, primeiro ele precisa ser verificado pelo Google para garantir que foi emitido para você pelo CSA.
Esse VID precisa 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.
- Um VID de teste não pode ser usado em um dispositivo do consumidor.
- O VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google vai validar se você é o proprietário desse VID antes de poder usá-lo no Google Home Developer Console. Depois disso, será possível criar integrações para esse VID.
- Para fins de desenvolvimento e Field Trial, um projeto e uma integração com a combinação de VID e PID correspondente precisam ser criados no Developer Console. O usuário que comissiona o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários Field Trial.
- Os usuários consumidores só podem usar seu produto depois que ele for certificado pelo Alliance.
O VID e o PID só podem ser usados uma vez para uma integração. Se você quiser usar o mesmo VID ou PID na integração, faça o seguinte:
- Edite a integração usando o VID ou PID para um VID ou PID diferente.
- Exclua a integração usando o VID ou o PID.
| Quais tipos de usuários podem comissionar o dispositivo no ecossistema do Google Home? | |||
|---|---|---|---|
| Tipo de VID | Certificação de VID e status da integração do console | Produção
(Usuários consumidores) |
Desenvolvimento
(desenvolvedores, usuários Field Trial) |
| 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 certificada, a integração não existe no Developer Console | ||
| Produção | Não certificada, 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 a integração existe no Developer Console | ||
ID do produto
As informações sobre o dispositivo são lidas no Matter Basic Information Cluster. O ID do produto codificado no firmware do dispositivo precisa corresponder ao ID do produto da integração Matter no Google Play Console.
Recursos não suportados
Alguns clusters Matter ainda não são expostos aos usuários, mas podem 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 |
|
¹ Consulte Interruptores de luz ativados/desativados para saber como isso afeta os interruptores de luz ativados/desativados.