Il programma per sviluppatori di Google Home consente ai produttori di dispositivi di connettere i loro dispositivi per la smart home all'ecosistema Google Home. Stiamo ampliando il percorso di evasione degli ordini locale per le azioni per la smart home con la possibilità di aggiungere dispositivi abilitati per Matter per la configurazione utilizzando Google Home app (GHA) e controllarli tramite 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
Per quanto riguarda le procedure descritte nella documentazione di Matter, tieni presente quanto segue:
- Ti consigliamo di fare in modo che all'account utilizzato per lo sviluppo sia collegato un solo hub abilitato per Matter per i test. Più hub abilitati per Matter connessi contemporaneamente o alla stessa struttura durante i test potrebbero causare comportamenti imprevedibili.
- Tutte le procedure presuppongono l'uso di una macchina Linux su cui è in esecuzione Ubuntu 20.04 per la creazione e il flashing di campioni Matter, che sono stati testati da Google. Sebbene i computer macOS siano supportati, è consigliato Linux. Le istruzioni specifiche per Mac vengono richiamate nelle procedure necessarie.
Come creare
Per creare un dispositivo abilitato per Matter che si integri con l'ecosistema Google Home, devi utilizzare una scheda di sviluppo compatibile con Matter e l'SDK Matter.
Il modo più semplice per iniziare è seguire i nostri codelab. Ti consigliamo di eseguire almeno uno dei seguenti codelab:
Successivamente, consulta il nostro elenco dei dispositivi supportati per assicurarti che quelli che prevedi di integrare siano supportati nell'ecosistema Google Home. Leggi quindi l'elenco di controllo per gli sviluppatori per comprendere l'intero flusso di sviluppo dalla creazione del progetto al lancio.
Dispositivi supportati Elenco di controllo per sviluppatori
Definizioni
In questa documentazione vengono utilizzati i seguenti termini:
- Router di confine
- Un hub che implementa un router di confine Thread per uso generico per i dispositivi abilitati per Thread.
- Hub
- Un dispositivo Google Nest supportato, come Google Nest Hub (2nd gen). È necessario un hub per controllare i dispositivi abilitati per Matter tramite altre piattaforme come Assistant, GHA e smart display.
- Dispositivo abilitato per Matter
- Un dispositivo o una scheda di sviluppo su cui è stata visualizzata una build o 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 abilitato per Matter con l'ecosistema Google Home, uno sviluppatore deve avere:
- Un hub Google con supporto Thread che funge sia da router di confine per i dispositivi compatibili con Thread sia da percorso di evasione degli ordini locale per il routing degli intent della smart home.
- Un dispositivo mobile (telefono di test) che soddisfa i requisiti minimi:
- Android O (8.1, livello API 27 o versioni successive)
- iOS (v16.5 o versioni successive)
- Funzionalità BLE
- Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
- Un dispositivo abilitato per Matter. Questo dispositivo dovrebbe essere uno dei Matter tipi di dispositivi supportati nell'ecosistema Google Home e potrebbe essere:
- Il tuo prodotto con firmware abilitato per Matter.
- Una scheda di sviluppo di una piattaforma di un fornitore supportata che può fungere da dispositivo abilitato per Matter per la verifica end-to-end. Sono supportate le seguenti piattaforme:
| Fornitore | Piattaforma | Guide | Assistenza Thread |
|---|---|---|---|
| Laboratorio di Bouffalo | BL602 | Guida rapida | |
| BL702 | Guida rapida | ||
| Espressif | ESP32 | Guida rapida
Test OTA |
|
| Semiconduttore nordico | nRF52840 DK | Guida rapida
Test OTA |
|
| NXP | Kit di sviluppo IOTZTB-DK006 | Guida rapida | |
| Realtek | Ameba Serie D | Guida rapida | |
| Silicon Labs | Kit di sviluppo EFR32MG24 | Guida rapida | |
| Kit iniziale Zigbee e Thread EFR32MG | Guida rapida | ||
| Telink | TLSR9518 | Guida rapida | |
| Texas Instruments | Kit di sviluppo LaunchPad CC2652R7 | Guida rapida |
ID fornitore
Per impostazione predefinita, puoi utilizzare uno dei VID allocati dalla 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 sia stata rilasciata dall'CSA.
Questo VID deve essere implementato nel firmware del dispositivo.
Un dispositivo Matter può essere accoppiato nell'ecosistema Google Home solo in determinati scenari di ID fornitore e tipo di dispositivo.
- Non è possibile utilizzare un VID di test in un dispositivo consumer.
- Il VID di produzione deve essere emesso da Connectivity Standards Alliance (Alliance). Google convaliderà la tua proprietà del VID prima che tu possa utilizzarlo in Google Home Developer Console. Potrai quindi creare le integrazioni per il VID.
- A scopo di sviluppo e prova sul campo, è necessario creare un progetto e un'integrazione con la combinazione di VID e PID corrispondente in Developer Console. L'utente che mette in servizio il dispositivo deve essere un membro del progetto o essere incluso nell'elenco degli utenti delle prove sul campo.
- Gli utenti consumer possono utilizzare il tuo prodotto solo dopo essere stato certificato dall'Alliance.
| Quali tipi di utenti possono commissionare il dispositivo nell'ecosistema Google Home? | |||
|---|---|---|---|
| Tipo di VID | Certificazione VID e stato di integrazione della console | Produzione
(utenti consumer) |
Sviluppo
(sviluppatori, utenti delle prove sul campo) |
| Test | Nessuna integrazione in Developer Console (non può essere certificato) | ||
| Test | Integrazione esistente in Developer Console (non può essere certificata) | ||
| Produzione | Non certificato, l'integrazione non esiste in Developer Console | ||
| Produzione | Non certificato, l'integrazione esiste in Developer Console | ||
| Produzione | Certificazione certificata nel DCL Alliance, l'integrazione non esiste in Developer Console | ||
| Produzione | Con certificazione per il DCL Alliance ed integrazione esistente in Developer Console | ||
ID prodotto
Le informazioni sul dispositivo vengono lette dal cluster di informazioni di base di Matter. L'ID prodotto codificato nel firmware del tuo dispositivo deve corrispondere all'ID prodotto dell'integrazione di Matter nella Developer Console.
Funzionalità non supportate
Alcuni cluster Matter non sono ancora esposti agli utenti, anche se potrebbero essere utilizzati dal sistema. Nella maggior parte dei casi, ciò significa che gli attributi esposti attraverso questi cluster non sono visibili agli utenti finali:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
1 Consulta la pagina Interruttori della luce accesa/spenta per scoprire in che modo questo influisce sugli interruttori con luce accesa/spenta.