Release dell'anteprima per gli sviluppatori
Il programma per sviluppatori Google Home consente ai produttori di connettere i propri dispositivi per la smart home all'ecosistema Google Home. Stiamo espandendo il percorso di evasione degli ordini di Smart Home Actions locale con la possibilità di aggiungere dispositivi abilitati per Matter per la configurazione con Google Home app (GHA) su Android e di 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 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 i test. Più hub abilitati per Matter collegati contemporaneamente o collegati 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 campioni Matter, che sono stati testati da Google. Sebbene le macchine MacOS siano supportate, è consigliato Linux. Le istruzioni specifiche per Mac sono indicate nelle procedure in base alle necessità.
- È supportata solo la versione di GHA per Android.
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 Google Nest Hub (2nd gen). È richiesto 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 lampeggiati con una build o un'app di esempio 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 da utilizzare sia come 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 (supporto per iOS da aggiungere in seguito)
- Funzionalità BLE
- Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
- Un dispositivo compatibile con Matter. Questo deve essere uno dei tipi di dispositivi Matter attualmente supportati nell'ecosistema Google Home e potrebbe essere:
- Il tuo prodotto con firmware abilitato per Matter.
- Una scheda di sviluppo di una piattaforma 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 bouffalo | BL602 | Guida rapida | |
| BL702 | Guida rapida | ||
| Espressif | ESP 32 | Guida rapida
Test OTA |
|
| Semiconduttore nordico | 56840 DRF | Guida rapida
Test OTA |
|
| NXP | Kit di sviluppo IOTZTB-DK006 | Guida rapida | |
| Realtek | Serie Ameba D | Guida rapida | |
| Lab Silicon | Kit iniziale EFR32MG Zigbee e Thread | Guida rapida | |
| Kit di sviluppo EFR32MG24 | Guida rapida | ||
| Telink | TLS 9518 | Guida rapida |
ID fornitore
Per impostazione predefinita, puoi utilizzare uno dei VID allocati dal CSA per scopi 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 innanzitutto aver effettuato la verifica da parte di Google per assicurarti che ti sia stata rilasciata dalla CSA.
Questo VID deve essere implementato nel firmware del tuo dispositivo.
Un dispositivo Matter può essere accoppiato nell'ecosistema Google Home solo in alcuni scenari di ID fornitore e tipo di dispositivo.
- Non è possibile utilizzare un VID di test in un dispositivo consumer.
- Per poter essere accoppiato, un dispositivo di produzione (consumatore) deve essere certificato nella DCL di CSA.
- Ai fini dello sviluppo e della prova sul campo, un dispositivo deve essere registrato nel Google Home Developer Console.
| Quali tipi di utenti possono mettere in servizio il dispositivo nell'ecosistema Google Home? | |||
|---|---|---|---|
| Tipo VID | Certificazione VID e stato di registrazione | Produzione
(utenti consumer) |
Sviluppo
(sviluppatori, utenti delle prove sul campo) |
| Test | Non registrato (non può essere certificato) | N/D | N/D |
| Test | Registrato in Developer Console (non è possibile ottenere la certificazione) | N/D | |
| Produzione | Non certificato, non registrato | N/D | |
| Produzione | Non certificato, registrato in Developer Console | ||
| Produzione | Certificato in CSA DCL, non registrato | N/D | |
| Produzione | Certificato in CSA DCL e registrato nel Developer Console | ||
ID prodotto
Le informazioni sul dispositivo vengono lette usando i cluster Matter Descriptor anziché l'ID prodotto. Puoi assegnare qualsiasi ID prodotto durante lo sviluppo, secondo lo schema di numerazione della tua azienda, purché corrisponda all'ID prodotto dell'integrazione Matter, se specificato.
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 saranno visibili agli utenti finali:
| Tipo di cluster | Cluster |
|---|---|
| Core |
|
| Applicazione |
|