O programa para desenvolvedores do Google Home permite que os fabricantes conectem os dispositivos de casa inteligente ao ecossistema Google Home. Estamos expandindo o caminho de fulfillment local das Ações de casa inteligente, com a possibilidade de adicionar dispositivos com Matter para configuração usando 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 com suporte a Matter no ecossistema do Google Home.
Exonerações de Responsabilidade
Em relação aos procedimentos descritos na documentação do Matter, esteja ciente do seguinte:
- Recomendamos que a conta usada para desenvolvimento tenha apenas um único hub ativado para Matter conectado para testes. Vários hubs ativados para Matter conectados ao mesmo tempo ou conectados à mesma estrutura durante o teste podem resultar em um 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, é recomendável usar o Linux. As instruções específicas do Mac são chamadas nos procedimentos conforme necessário.
Como criar
Para criar um dispositivo compatível com Matter e 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 que você realize pelo menos um destes codelabs:
Depois disso, verifique nossa lista de dispositivos compatíveis para garantir que o que você planeja integrar é 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 nesta 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 com Matter em outras plataformas, como Assistant, GHA e smart displays.
- Dispositivo compatível com Matter
- 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, 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 compatível com Thread para servir como um roteador de borda para dispositivos com Thread e como um caminho de fulfillment local para rotear intents de 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)
- 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 suporte ao Matter. Ele precisa ser um dos
Matter tipos de dispositivo com suporte atualmente no
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 | BL602 (link em inglês) | Início rápido | |
| BL702 (link em inglês) | Início rápido | ||
| Espressif | ESP32 | Início rápido
Teste OTA |
|
| Semicondutores nórdicos | nRF52840 DK (link em inglês) | Início rápido
Teste OTA |
|
| NXP | Kit de desenvolvimento IOTZTB-DK006 | Início rápido | |
| Realtek | Ameba D Series | Início rápido | |
| Laboratórios de silicone | EFR32MG24 Dev Kit (em inglês) | Início rápido | |
| Kit básico de Zigbee e Thread EFR32MG | Início rápido | ||
| Telink | TLSR9518 (em inglês) | Início rápido | |
| Instrumentos texano | Kit de desenvolvimento do LaunchPad CC2652R7 | Início rápido |
ID do fornecedor
Por padrão, você pode usar um dos VIDs alocados pelo CSA para
fins de teste. Selecione uma das seguintes opções:
0xFFF1, 0xFFF2, 0xFFF3 ou 0xFFF4.
Para usar um VID de produção para que sua integração possa ser certificada e lançada, primeiro você precisa verificá-lo pelo Google para garantir que ele foi 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.
- Não é possível usar um VID de teste em um dispositivo de consumidor.
- O VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google validará que você é o proprietário desse VID antes de usá-lo no Google Home Developer Console. Quando isso acontecer, será possível criar integrações para esse VID.
- Para fins de desenvolvimento e teste de campo, é necessário criar um projeto e uma integração com a combinação de VID e PID correspondente no Developer Console. O usuário que comissionou o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários de testes de campo.
- Os usuários pessoais só poderão usar seu produto depois que ele for certificado pelo Alliance.
| Que tipos de usuários podem comissionar o dispositivo para o 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 testes em campo) |
| Teste | Nenhuma integração no Developer Console (não pode ser certificado) | ||
| 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, há integração no Developer Console | ||
| Produção | Certificada na DCL Alliance, a integração não existe no Developer Console | ||
| Produção | Tem certificação nos termos do DCL Alliance, e há integração no Developer Console | ||
ID do produto
As informações sobre o dispositivo são lidas do cluster de informações básicas do 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 ficarão visíveis para os usuários finais:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
1 Consulte Interruptores de luz para ligar/desligar para saber como isso afeta os interruptores de luz de ativação/desativação.