Versão da prévia para desenvolvedores
Com o programa de desenvolvedores do Google Home, os fabricantes podem conectar dispositivos de casa inteligente ao ecossistema do Google Home. Estamos expandindo o caminho local de fulfillment local de ações de casa inteligente com a possibilidade de adicionar dispositivos ativados por Matter para configuração usando Google Home app (GHA) no Android 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
Com relação aos procedimentos descritos na prévia para desenvolvedores 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 seguintes termos 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 com suporte, como Google Nest Hub (2nd gen). Um hub é necessário para controlar dispositivos compatíveis com Matter por outras plataformas, como Assistant, GHA e smart displays.
- Dispositivo com Matter
- Um dispositivo ou uma placa de desenvolvimento que foi atualizada com um app de build ou de exemplo ativado para Matter.
- Dispositivo móvel
- O smartphone de teste usado para auxiliar no pareamento. Atualmente, este é um smartphone 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 para linhas de execução que funciona como um roteador de borda para dispositivos compatíveis com linhas de execução 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, API de nível 27) ou mais recente (suporte para iOS será adicionado posteriormente)
- 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 com o Matter ativado.
- Um dispositivo compatível com Matter Esse dispositivo precisa ser um dos
tipos de dispositivos 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:
Fornecedor | Plataforma | Guias | Suporte do Thread |
---|---|---|---|
Laboratório Bouffalo | BL 602 | Guia de início rápido | |
BL 702 | Guia de início rápido | ||
Espressif | ESP32 | Início rápido
Teste OTA |
|
Semicondutor nórdico | nRF52840 DK | Início rápido
Teste OTA |
|
NXP; | Kit de desenvolvimento IOTZTB-DK006 | Guia de início rápido | |
Realtek | Série Ameba D | Guia de início rápido | |
Silicon Labs | Kit de primeiros passos Zigbee e Thread do EFR32MG | Guia de início rápido | |
Kit de desenvolvimento EFR32MG24 | Guia de início rápido | ||
Telink | TLSR 9518 | Guia de início rápido |
ID do fornecedor
Por padrão, é possível usar um dos VIDs alocados pela CSA para fins de
teste. Selecione uma destas opções:
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Se quiser usar um VID de produção para que sua integração seja certificada e lançada, primeiro ele precisa ser verificado pelo Google para garantir que tenha sido emitido pelo CSA.
Esse VID deve ser implementado no firmware do dispositivo.
Um dispositivo Matter só pode ser pareado com o 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 de consumo.
- Para que um dispositivo de produção (consumidor) seja pareado, ele precisa ser certificado na DCL de CSA.
- Para fins de desenvolvimento e teste em campo, um dispositivo precisa ser registrado no Google Home Developer Console.
Que tipos de usuários podem colocar o dispositivo no ecossistema do Google Home? | |||
---|---|---|---|
Tipo de VID | Status de registro e certificação da VID | Produção
(usuários consumidores) |
Desenvolvimento
(desenvolvedores, usuários de teste de campo) |
Teste | Não registrado (não pode ser certificado) | N/A | N/A |
Teste | Registrado no Developer Console (não pode ser certificado) | N/A | |
Produção | Não certificado, não registrado | N/A | |
Produção | Não certificado, registrado no Developer Console | ||
Produção | Certificado na DCL de CSA, não registrado | N/A | |
Produção | Tem a certificação DCL CSA e está registrada no Developer Console |
ID do produto
As informações sobre o dispositivo são lidas usando os clusters do Matter Descriptor, em vez do ID do produto. Você pode atribuir qualquer ID do produto durante o desenvolvimento, de acordo com o esquema de numeração da sua empresa, desde que ele corresponda ao ID do produto da integração do Matter, se especificado.
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 ficarão visíveis para os usuários finais:
Tipo de cluster | Clusters |
---|---|
Core |
|
Aplicativo |
|