Release di anteprima per sviluppatori
Il programma per sviluppatori di Google Home consente ai produttori di connettere i propri dispositivi per la smart home con l'ecosistema Google Home. Stiamo espandendo il percorso di evasione degli ordini locale per le smart home con la possibilità di aggiungere dispositivi abilitati per Matter per la configurazione utilizzando Google Home app (GHA) e controllarli utilizzando Google Assistant, smart display o GHA come Google Nest Hub (2nd gen).
Questa documentazione descrive come iniziare a creare e integrare una piattaforma supportata da Matter nell'ecosistema di Google Home.
Limitazioni di responsabilità
In merito alle procedure descritte in questa Anteprima per gli sviluppatori di Matter, tieni presente quanto segue:
- L'account utilizzato per lo sviluppo deve avere un solo hub abilitato per Matter collegato per il test. Più hub abilitati per Matter connessi contemporaneamente o collegati alla stessa struttura durante i test potrebbero causare comportamenti imprevedibili.
- Tutte le procedure presuppongono l'uso di una macchina Linux che esegue Ubuntu 20.04 per la creazione e il flashing di esempi Matter, che sono stati testati da Google. Anche se le macchine MacOS sono supportate, è consigliato Linux. Le istruzioni specifiche per Mac vengono richiamate nelle procedure secondo necessità.
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, ad esempio il dispositivo Google Nest Hub (2nd gen). È necessario un hub per controllare i dispositivi abilitati per Matter attraverso altre piattaforme come Assistant, GHA e smart display.
- Dispositivo abilitato per Matter
- Un dispositivo o una scheda di sviluppo che è stata visualizzata automaticamente con un'app di esempio o build abilitata per Matter.
- Dispositivo mobile
- Il telefono di prova utilizzato per facilitare l'accoppiamento. Al momento questo è 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 per Thread che funga sia da router di confine per i dispositivi abilitati per Thread sia come percorso di evasione locale per il routing degli intent della smart home.
- Un dispositivo mobile (telefono di prova) che soddisfa i requisiti minimi:
- Android O (8.1, livello API 27 o versioni successive)
- iOS (16.5 o versioni successive)
- Funzionalità BLE
- Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
- Un dispositivo con Matter abilitato. Questo dispositivo deve essere uno dei
Mattertipi di dispositivo attualmente supportati nell'ecosistema
Google Home e può essere:
- Il tuo prodotto con il firmware abilitato per Matter.
- Una scheda di sviluppo di una piattaforma di fornitori 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 |
---|---|---|---|
Bouffalo | BL602 | Guida rapida | |
BL702 | Guida rapida | ||
Espressif | ESP32 | Guida rapida
Test OTA |
|
Semiconduttore nordico | NRF52840 DK | Guida rapida
Test OTA |
|
RPD | Kit di sviluppo IOTZTB-DK006 | Guida rapida | |
Realtek | Serie Ameba D | Guida rapida | |
Silicon Labs | Kit di sviluppo EFR32MG24 | Guida rapida | |
Kit iniziale ZAFbee e Thread EFR32MG | Guida rapida | ||
Telink | TLSR9518 | Guida rapida | |
Strumenti texani | 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
, 0xFFF4
.
Per utilizzare un VID produzione in modo che la tua integrazione possa essere certificata e lanciata, devi prima che Google lo verifichi per assicurarti che ti sia stata rilasciata dalla CSA.
Questo VID deve essere implementato nel firmware del dispositivo.
Un dispositivo Matter può essere accoppiato solo nell'ecosistema Google Home in alcuni scenari di 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 dalla CSA. Google convaliderà la tua proprietà del VID prima che tu possa utilizzarlo in Google Home Developer Console. In seguito, potrai creare integrazioni per il VID in questione.
- A scopo di sviluppo e prova sul campo, è necessario creare in Developer Console un progetto e l'integrazione con la combinazione di VID e PID corrispondenti. L'utente che mette in servizio il dispositivo deve essere un membro del progetto o essere incluso nell'elenco degli utenti della prova sul campo.
- Gli utenti consumer possono utilizzare il tuo prodotto solo dopo essere stato certificato dalla CSA.
Quali tipi di utenti possono far usare il dispositivo all'ecosistema Google Home? | |||
---|---|---|---|
Tipo VID | Certificazione VID e stato di integrazione della console | Produzione
(utenti consumer) |
Sviluppo
(sviluppatori, utenti che usano la prova sul campo) |
Test | Nessuna integrazione in Developer Console (non può essere certificata) | ||
Test | L'integrazione esiste nella Developer Console (non può essere certificata) | ||
Produzione | Non certificata, l'integrazione non esiste in Developer Console | ||
Produzione | Non certificato, l'integrazione è presente in Developer Console | ||
Produzione | Certificato nel DCL CSA, l'integrazione non esiste in Developer Console | ||
Produzione | Certificato nel DCL CSA e l'integrazione esiste in Developer Console |
ID prodotto
Le informazioni sul dispositivo vengono lette dal cluster di informazioni di base Matter. L'ID prodotto codificato nel firmware del tuo 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, ma potrebbero essere utilizzati dal sistema. Nella maggior parte dei casi, ciò significa che gli attributi esposti tramite questi cluster non saranno visibili agli utenti finali:
Tipo di cluster | Cluster |
---|---|
Core |
|
Applicazione |
|
1 Per informazioni sull'impatto dei sensori di accensione/spegnimento, consulta la sezione Interruttori luce di accensione/spegnimento.