Il programma per sviluppatori per Google Home consente ai produttori di connettere i loro dispositivi per la smart home all'ecosistema Google Home. Stiamo ampliando il percorso di distribuzione locale relativo alle azioni per la smart home con la possibilità di aggiungere dispositivi abilitati per Matter per la configurazione tramite Google Home app (GHA) e controllarli tramite Google Assistant, GHA o smart display comeGoogle 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:
- Consigliamo che l'account utilizzato per lo sviluppo abbia un solo hub abilitato per Matter connesso per i test. Più hub abilitati per Matter collegati contemporaneamente o connessi alla stessa struttura durante i test potrebbero causare comportamenti imprevedibili.
- Tutte le procedure presuppongono l'utilizzo di un computer Linux che esegue Ubuntu 20.04 per la creazione e il flashing di esempi di Matter, che sono stati testati da Google. Sebbene siano supportati i computer macOS, è consigliato Linux. Le istruzioni specifiche per Mac vengono citate nelle procedure, se necessario.
Come creare
Per creare un dispositivo compatibile con Matter che si integri con l'ecosistema Google Home, lavorerai con una scheda di sviluppo compatibile con Matter e con l'Matter SDK.
Il modo più semplice per iniziare è seguire i nostri codelab. Ti consigliamo di eseguire almeno uno dei seguenti codelab:
Dopodiché, consulta il nostro elenco di dispositivi supportati per assicurarti che quelli che prevedi di integrare siano supportati nell'ecosistema Google Home. Poi leggi 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 gli sviluppatori
Definizioni
Nella 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, ad esempio Google Nest Hub (2nd gen). È necessario un hub per controllare i dispositivi compatibili con Matter tramite altre piattaforme come Assistant, GHA e smart display.
- Matter dispositivo abilitato
- Un dispositivo o una scheda di sviluppo su cui è stato eseguito il flashing di un'app di esempio o build abilitata per Matter.
- Dispositivo mobile
- Lo smartphone di prova utilizzato per facilitare l'accoppiamento. Al momento, questo è un telefono Android.
Prerequisiti
Per integrare completamente un dispositivo compatibile con Matter con l'ecosistema Google Home, uno sviluppatore deve avere:
- Un hub Google con supporto di Thread da fungere sia da router di confine per i dispositivi abilitati per Thread sia da percorso di distribuzione locale per il routing degli intent per la smart home.
- Un dispositivo mobile (smartphone di prova) che soddisfi i requisiti minimi:
- Android O (8.1, livello API 27 o versioni successive)
- iOS (v16.5 o successive)
- Funzionalità BLE
- Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
- Un dispositivo compatibile con 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.
- Uno dei seguenti Matter dispositivi da utilizzare per la verifica end-to-end:
Fornitore | Piattaforma | Assistenza Thread | Guida |
---|---|---|---|
Laboratorio Bouffalo | BL602 | ||
BL702 | |||
Espressif | ESP32 | Test per OTA | |
Nordic Semiconductor | nRF52840 DK | Test per OTA | |
NXP | Kit di sviluppo IOTZTB-DK006 | ||
Realtek | Serie Ameba D | ||
Lab Silicon | Kit di sviluppo EFR32MG24 | ||
Starter kit EFR32MG Zigbee e Thread | |||
Telink | TLSR9518 | ||
Texas Instruments | Kit di sviluppo CC2652R7 LaunchPad |
ID fornitore
Per impostazione predefinita, puoi utilizzare uno dei VID assegnati dall'CSA a scopo di test. Seleziona una delle seguenti opzioni:
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Per utilizzare un VID di produzione in modo che la tua integrazione possa essere certificata e lanciata, devi prima verificarla da Google per assicurarti che ti sia stata rilasciata dall'CSA.
Questo VID deve essere implementato nel firmware del tuo dispositivo.
Un dispositivo Matter può essere accoppiato nell'ecosistema Google Home solo in determinati scenari con ID fornitore e tipo di dispositivo.
- Un VID di test non può essere utilizzato in un dispositivo consumer.
- Il tuo VID di produzione deve essere emesso dal Connectivity Standards Alliance (Alliance). Google convaliderà che sei il proprietario del VID prima che tu possa utilizzarlo in Google Home Developer Console. Dopodiché potrai creare integrazioni per quel VID.
- Ai fini dello sviluppo e delle prove 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 membro del progetto o essere incluso nell'elenco degli utenti delle prove sul campo.
- Gli utenti consumer possono utilizzare il tuo prodotto solo dopo che è stato certificato dall'Alliance.
Quali tipi di utenti possono mettere in servizio il dispositivo nell'ecosistema di Google Home? | |||
---|---|---|---|
Tipo di VID | Stato della certificazione VID e dell'integrazione della console | Produzione
(utenti consumer) |
Sviluppo
(sviluppatori, utenti di prove sul campo) |
Test | Nessuna integrazione in Developer Console (impossibile essere certificato) | ||
Test | Integrazione in Developer Console (non può essere certificata) | ||
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 esiste nel Developer Console | ||
Produzione | Certificato nel DCL di Alliance e integrazione esistente in Developer Console |
ID prodotto
Le informazioni sul dispositivo vengono lette dal cluster delle informazioni di base Matter. L'ID prodotto codificato nel firmware del tuo dispositivo deve corrispondere all'ID prodotto dell'integrazione 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 sezione Interruttori della luce on/off per avere un'idea dell'impatto sugli interruttori della luce.