O programa para desenvolvedores do Google Home permite que fabricantes de dispositivos se conectem os dispositivos de casa inteligente com o ecossistema Google Home. Estamos expandindo a Caminho de fulfillment local de ações de casa inteligente com a possibilidade 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 um Plataforma com suporte a Matter no ecossistema do Google Home.
Exonerações de responsabilidade
Com relação aos procedimentos descritos no Matter documentação, esteja ciente do seguinte:
- Recomendamos que a conta usada para desenvolvimento tenha apenas um Hub ativado para Matter conectado para teste. Vários status Hubs ativados para Matter conectados no ao mesmo tempo ou conectados à mesma estrutura durante os testes podem resultar em comportamento imprevisível.
- Todos os procedimentos pressupõem o uso de uma máquina Linux executando Ubuntu 20.04 para criando e atualizando exemplos de Matter, que foram testado pelo Google. Embora os computadores macOS sejam compatíveis, recomendamos o uso do Linux. Específico para Mac e as instruções são mencionadas nos procedimentos conforme necessário.
Como criar
Para criar um dispositivo compatível com Matter que se integre à ecossistema do Google Home, você vai trabalhar com uma placa de desenvolvimento compatível com Matter e a Matter SDK.
A maneira mais fácil de começar é com nossos codelabs. Qa recomendamos que você faça pelo menos um destes codelabs:
Depois disso, consulte nossa lista de dispositivos compatíveis para garantir que que planeja integrar é 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 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 uma borda Thread de uso geral Roteador para dispositivos com Thread ativado.
- Hub
- Um dispositivo Google Nest compatível, como o Google Nest Hub (2nd gen) É necessário ter um hub para controlar os dispositivos com Matter ativado outras plataformas, como Assistant, a GHA e smart displays.
- Matter dispositivo compatível
- Um dispositivo ou placa de desenvolvimento que foi atualizado com um App de exemplo ou build com Matter ativado.
- Dispositivo móvel
- O smartphone de teste usado para ajudar no pareamento. Atualmente, esta é uma Android.
Pré-requisitos
Para integrar totalmente um dispositivo compatível com Matter com o no ecossistema do Google Home, um desenvolvedor precisa ter:
- Um hub do Google com suporte para Thread para servir como roteador de borda para dispositivos habilitados para Thread e como caminho de fulfillment para rotear intents de casa inteligente.
- Um dispositivo móvel (telefone 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) e um ID do produto (PID) para o dispositivo com Matter.
- Um dispositivo com o Matter ativado. Este dispositivo deve ser um dos
os Matter tipos de dispositivos suportados na
ecossistema do Google Home, e pode ser:
- Seu próprio produto com firmware compatível com Matter.
- Um dos seguintes dispositivos Matter para usar para 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 | Desenvolvimento IOTZTB-DK006 kit | ||
| Realtek | Ameba série D | ||
| Silicon Labs | Kit de desenvolvimento EFR32MG24 | ||
| EFR32MG Zigbee e Thread Kit para iniciantes | |||
| Telink | TLSR9518 | ||
| Instrumentos texas | Desenvolvimento do LaunchPad CC2652R7 kit |
ID do fornecedor
Por padrão, você pode usar um dos VIDs alocados pelo CSA para testes
propósitos. Selecione uma destas opções:
0xFFF1, 0xFFF2, 0xFFF3 e 0xFFF4.
Para usar um VID de produção para que sua integração seja certificada e iniciada, primeiro você precisa ele deve ser verificado pelo Google para garantir que foi emitido pelo CSA.
Esse VID precisa ser implementado no firmware do dispositivo.
Um dispositivo Matter só pode ser pareado com o Google Home ecossistema 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 confirmar que você é o proprietário desse VID antes de poder 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, um projeto e integração com o a combinação de VID e PID correspondente precisa ser criada no Developer Console. O comissionamento do usuário o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários de teste 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 encomendar para o 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 com certificação) | ||
| 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 existem no seguinte local: Developer Console | ||
| Produção | Certificado no DCL do Alliance e que existe integração em Developer Console | ||
ID do produto
As informações sobre o dispositivo são lidas Cluster de informações básicas do Matter. O ID do produto codificado no O firmware do dispositivo precisa corresponder ao ID do produto da integração com o Matter no Play Console.
Recursos não compatíveis
No entanto, alguns clusters Matter ainda não foram expostos aos usuários. elas podem ser usadas pelo sistema. Na maioria dos casos, isso significa que os atributos expostas por esses clusters não ficam visíveis para os usuários finais:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
1 Consulte Interruptores de ativação/desativação. de como isso afeta os interruptores de luz.