O programa Home Developer do Google permite que fabricantes de dispositivos conectem seus 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 compatíveis com o Matter-enabled para configuração usando o Google Home app (GHA) e controlá-los usando o 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 a Matter- no ecossistema do Google Home.
Exonerações de responsabilidade
Em relação aos procedimentos descritos na Matter documentação, esteja ciente do seguinte:
- Recomendamos que a conta usada para desenvolvimento tenha apenas um hub compatível com o Matter-conectado para testes. Vários Matter-enabled hubs conectados ao mesmo tempo ou conectados à mesma estrutura durante o teste podem resultar em comportamento imprevisível.
- Todos os procedimentos pressupõem o uso de uma máquina Linux com o Ubuntu 20.04 para criar e instalar Matter exemplos, que foram testados pelo Google. Embora as máquinas macOS sejam compatíveis, o Linux é recomendado. As instruções específicas para Mac são chamadas nos procedimentos conforme necessário.
Como criar
Para criar um dispositivo compatível com Matter que se integra ao ecossistema do Google Home, você vai trabalhar com uma placa de desenvolvimento compatível com Matter e o Matter SDK.
A maneira mais fácil de começar é acessar nossos codelabs. Recomendamos fazer pelo menos um dos seguintes codelabs:
Depois disso, 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 do desenvolvedor para entender todo o fluxo de desenvolvimento, desde a criação do projeto até o lançamento.
Dispositivos compatíveis Lista de verificação do desenvolvedor
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 compatível, como o Google Nest Hub (2nd gen). Um hub é necessário para controlar dispositivos compatíveis com o Matter em outras plataformas, como o Assistant, o GHA, e smart displays.
- Dispositivo compatível com Matter
- Um dispositivo ou placa de desenvolvimento que foi instalado com um Matter-enabled build ou app de exemplo.
- Dispositivo móvel
- O smartphone de teste usado para ajudar no pareamento. No momento, é um Android telefone.
Pré-requisitos
Para integrar totalmente um dispositivo compatível com o 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 compatíveis 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, nível 27 da API ou mais recente)
- iOS (v16.5 ou mais recente)
- Capacidade BLE
- Um ID do fornecedor (VID) e um ID do produto (PID) para o dispositivo compatível com o Matter.
- Um dispositivo compatível com o Matter. Esse dispositivo precisa ser um dos
tipos de dispositivo Mattercom 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 | Thread Suporte | Guia |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Teste OTA | |
| Nordic Semiconductor | nRF52840 DK | Teste OTA | |
| NXP | Kit de desenvolvimento IOTZTB-DK006 | ||
| Realtek | Série Ameba D | ||
| Silicon Labs | Kit de desenvolvimento EFR32MG24 | ||
| Kit inicialEFR32MG Zigbee e Thread | |||
| Telink | TLSR9528 | Guia do desenvolvedor do Matter da Telink | |
| Texas Instruments | Kit de desenvolvimento CC2652R7 LaunchPad |
ID do fornecedor
Por padrão, você pode usar um dos VIDs alocados pela Alliance para
fins de teste. Selecione um dos seguintes:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Para usar um VID de produção para que sua integração possa ser certificada e lançada, primeiro é necessário que ele seja verificado pelo Google para garantir que foi emitido para você pela Alliance.
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.
- Seu VID de produção precisa ser emitido pela 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, você poderá criar integrações para esse VID.
- Para fins de desenvolvimento e Field Trial, um projeto e 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 Field Trial usuários.
- Os usuários 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 sua integração, será necessário:
- Editar a integração usando o VID ou PID para um VID ou PID diferente.
- Excluir a integração usando o VID ou PID.
| Quais tipos de usuários podem comissionar o dispositivo no ecossistema do Google Home? | |||
|---|---|---|---|
| Tipo de VID | Certificação de VID e status de integração do console | Produção
(Usuários de serviços sem custo financeiro) |
Desenvolvimento
(Desenvolvedores, Field Trial usuários) |
| 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, a integração existe no Developer Console | ||
| Produção | Certificado no Alliance DCL, a integração não existe no Developer Console | ||
| Produção | Certificado no Alliance DCL e a integração existe na Developer Console | ||
ID do produto
As informações sobre o dispositivo são lidas no Matter cluster de informações básicas. O ID do produto codificado no firmware do dispositivo precisa corresponder ao ID do produto da Matter integração no Developer 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 ficam visíveis para os usuários finais:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Consulte Interruptores de luz liga/desliga para saber como isso afeta os interruptores de luz liga/desliga.