Il programma Google Home Developer consente ai produttori di dispositivi di connettersi i propri dispositivi per la smart home con l'ecosistema Google Home. Stiamo ampliando il percorso di evasione locale di Smart Home Actions con la possibilità di aggiungere dispositivi compatibili con Matter per la configurazione utilizzando Google Home app (GHA) e controllarli utilizzando Google Assistant, GHA o smart display come Google Nest Hub (2nd gen).
Questa documentazione descrive come iniziare a creare e integrare una piattaforma supportata da Matter nell'ecosistema Google Home.
Disclaimer
In merito alle procedure descritte nella Matter documentazione, tieni presente quanto segue:
- Consigliamo che l'account utilizzato per lo sviluppo abbia un solo account Hub abilitato per Matter connesso per i test. Più hub abilitati per Matter connessi contemporaneamente o connessi alla stessa struttura durante i test potrebbero comportare un comportamento imprevedibile.
- Tutte le procedure presuppongono l’uso di un sistema Linux che esegue Ubuntu 20.04 per creare e lampeggiare Matter esempi, che sono stati testato da Google. Sebbene siano supportati i computer macOS, è consigliato Linux. Specifici per Mac le istruzioni all'interno delle procedure, se necessario.
Come creare
Per creare un dispositivo compatibile con Matter che si integri con l'ecosistema Google Home, dovrai utilizzare una scheda di sviluppo compatibile con Matter e l'SDK Matter.
Il modo più semplice per iniziare è consultare i nostri codelab. Me ti consigliamo di eseguire almeno uno dei seguenti codelab:
Dopodiché, controlla il nostro elenco di dispositivi supportati per assicurarti che ciò che prevedi di integrare sia supportato nell'ecosistema di Google Home. Dopodiché leggi l'elenco di controllo per gli sviluppatori per comprendere l'intero il flusso di sviluppo dalla creazione al lancio del progetto.
Dispositivi supportati Elenco di controllo per gli sviluppatori
Definizioni
Nella presente documentazione vengono utilizzati i seguenti termini:
- Router di confine
- Un hub che implementa un confine Thread generico Router per dispositivi abilitati per Thread.
- Hub
- Un dispositivo Google Nest supportato, ad esempio Google Nest Hub (2nd gen). È necessario un hub per controllare i dispositivi compatibili con Matter tramite altre piattaforme come Assistant, GHA e i display smart.
- Dispositivo compatibile con Matter
- Un dispositivo o una scheda di sviluppo su cui è stato eseguito il flashing di una build o di un'app di esempio abilitata per Matter.
- Dispositivo mobile
- Lo smartphone di prova utilizzato per facilitare l'accoppiamento. Al momento si tratta di un telefono Android.
Prerequisiti
Per integrare completamente un dispositivo compatibile con Matter con l'ecosistema Google Home, uno sviluppatore deve disporre di:
- Un hub Google con supporto di Thread fungere sia da router di confine per i dispositivi compatibili con Thread sia come router locale percorso di distribuzione per il routing degli intent della smart home.
- Un dispositivo mobile (smartphone di prova) che soddisfa i requisiti minimi:
- Android O (8.1, livello API 27 o versioni successive)
- iOS (v16.5 o successive)
- Compatibilità BLE
- Un ID fornitore (VID) e un ID prodotto (PID) per il Dispositivo abilitato per Matter.
- Un dispositivo compatibile con Matter. Questo dispositivo deve essere uno di
i Matter tipi di dispositivi supportati in
dell'ecosistema Google Home e potrebbe essere:
- Il tuo prodotto con firmware abilitato per Matter.
- Uno dei seguenti Matter dispositivi da utilizzare per verifica end-to-end:
Fornitore | Piattaforma | Assistenza Thread | Guida |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | Test OTA | |
Nordic Semiconductor | nRF52840 DK | Test per OTA | |
NXP | Kit di sviluppo IOTZTB-DK006 | ||
Realtek | Ameba D Series | ||
Lab Silicon | Kit di sviluppo EFR32MG24 | ||
EFR32MG Zigbee e Thread Starter Kit | |||
Telink | TLSR9518 | ||
Texas Instruments | Kit di sviluppo LaunchPad CC2652R7 |
ID fornitore
Per impostazione predefinita, puoi utilizzare uno dei VID allocati dal CSA a scopo di test. Seleziona una delle seguenti opzioni:
0xFFF1
, 0xFFF2
, 0xFFF3
e 0xFFF4
.
Per utilizzare un VID di produzione in modo che l'integrazione possa essere certificata e lanciata, devi prima farla verificare da Google per assicurarti che ti sia stata rilasciata dal CSA.
Questo VID deve essere implementato nel firmware del dispositivo.
È possibile accoppiare un dispositivo Matter soltanto in Google Home in determinati scenari di ID fornitore e tipo di dispositivo.
- Un VID di test non può essere utilizzato in un dispositivo consumer.
- Il VID di produzione deve essere emesso da Connectivity Standards Alliance (Alliance). Google provvederà confermare di essere il proprietario del VID prima di poterlo utilizzare in Google Home Developer Console. Dopodiché potrai creare per questo VID.
- Ai fini dello sviluppo e delle sperimentazioni sul campo, un progetto e l'integrazione la combinazione di VID e PID corrispondente deve essere creata in Developer Console. L'utente che esegue la messa in servizio del dispositivo deve essere un membro del progetto o essere incluso nell'elenco degli utenti della prova sul campo.
- Gli utenti consumatori possono utilizzare il tuo prodotto solo dopo che è stato certificato da Alliance.
Quali tipi di utenti possono commissionare il dispositivo nell'ecosistema Google Home? | |||
---|---|---|---|
Tipo di VID | Stato della certificazione VID e dell'integrazione della console | Produzione
(utenti consumer) |
Sviluppo
(sviluppatori, utenti del programma di prova sul campo) |
Test | Nessuna integrazione in Developer Console (impossibile essere certificato) | ||
Test | L'integrazione esiste in Developer Console (non può essere certificato) | ||
Produzione | Non certificato. L'integrazione non esiste in Developer Console. | ||
Produzione | Non certificata, l'integrazione esiste in Developer Console | ||
Produzione | Certificato nel DCL di Alliance, l'integrazione non esistono in Developer Console | ||
Produzione | Certificato nel DCL di Alliance e integrazione esistente nel Developer Console |
ID prodotto
Le informazioni sul dispositivo vengono lette dal Matter Cluster di informazioni di base. L'ID prodotto codificato nel firmware del dispositivo deve corrispondere all'ID prodotto dell'integrazione Matter nella Console per gli sviluppatori.
Funzionalità non supportate
Alcuni cluster Matter non sono ancora esposti agli utenti, anche se possono essere utilizzati dal sistema. Nella maggior parte dei casi, ciò significa che gli attributi esposti tramite questi cluster non sono visibili agli utenti finali:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Vedi Interruttori per la luce on/off sull'impatto degli interruttori della luce on/off.