Il programma Google Home Developer consente ai produttori di dispositivi di connettere i propri dispositivi per la smart home all'ecosistema Google Home. Stiamo ampliando il percorso di evasione degli ordini locale Azioni 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 l'account utilizzato per lo sviluppo abbia un solo hub abilitato per Matter collegato per i test. Più hub abilitati per Matter connessi contemporaneamente o alla stessa struttura durante i test potrebbero comportare comportamenti imprevedibili.
- Tutte le procedure presuppongono l'utilizzo di una macchina Linux che esegue Ubuntu 20.04 per la creazione e il flashing di esempi Matter, testati da Google. Anche se i computer macOS sono supportati, è consigliabile utilizzare Linux. Le istruzioni specifiche per Mac vengono richiamate all'interno delle procedure, a seconda delle esigenze.
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'SDKMatter.
Il modo più semplice per iniziare è seguire i nostri codelab. Ti consigliamo di eseguire almeno uno dei seguenti codelab:
Dopodiché, consulta il nostro elenco dei dispositivi supportati per assicurarti che quelli che prevedi di integrare siano supportati nell'ecosistema Google Home. Dopodiché leggi l'elenco di controllo per sviluppatori per comprendere l'intero flusso di sviluppo dalla creazione al lancio del progetto.
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 con funzionalità Matter
- Un dispositivo o una scheda di sviluppo su cui è stato eseguito il flashing di una build o un'app di esempio abilitata per Matter.
- Dispositivo mobile
- Lo smartphone di prova utilizzato per l'accoppiamento del dispositivo. 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 Thread che funge sia da router di confine per i dispositivi compatibili con Thread, sia da percorso di fulfillment locale per il routing degli intent della smart home.
- Un dispositivo mobile (telefono 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 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 OTA | |
Semiconduttore nordico | nRF52840 DK | Test OTA | |
NXP | Kit di sviluppo IOTZTB-DK006 | ||
Realtek | Serie Ameba D | ||
Silicon Labs | Kit di sviluppo EFR32MG24 | ||
Starter Kit Zigbee e Thread EFR32MG | |||
Telink | TLSR9518 | ||
Texas Instruments | Kit di sviluppo CC2652R7 LaunchPad |
ID fornitore
Per impostazione predefinita, puoi utilizzare uno dei VID assegnati da CSA a scopo di test. Seleziona una delle seguenti opzioni:
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Per utilizzare un VID di produzione in modo che l'integrazione possa essere certificata e lanciata, devi prima averla verificata da Google per assicurarti che sia stata inviata da 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.
- 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 convaliderà che sei il proprietario del VID prima che tu possa utilizzarlo nel Google Home Developer Console. A quel punto, potrai creare 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 della prova sul campo.
- I consumatori possono utilizzare il tuo prodotto solo se è stato certificato dal 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 di Field Trial) |
Testa | Nessuna integrazione in Developer Console (non può essere certificata) | ||
Testa | L'integrazione esiste 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 nella DCL Alliance; l'integrazione non esiste in Developer Console | ||
Produzione | Certificato nel DCL Alliance ed esiste un'integrazione 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 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 tramite questi cluster non sono visibili agli utenti finali:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Consulta la sezione Interruttori della luce On/Off per scoprire come questo influisce sugli interruttori della luce On/Off.