Iniziare a utilizzare Matter

  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:

1. 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.
2. 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
3. Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
4. 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:

Tabella: Matter esempi di fornitori di silicio

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.

Tabella: scenari di accoppiamento di ID fornitore (VID) e tipo di dispositivo

		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:

Tabella: Matter cluster non esposti agli utenti nell'ecosistema Google Home

Tipo di cluster	Cluster
Core	Associazione 1 Etichetta Etichetta fissa Etichetta utente Azioni Chiave di gruppo Configurazione della localizzazione Localizzazione del formato dell'ora Localizzazione unità Configurazione della fonte di alimentazione Fonte di alimentazione Cluster di diagnostica (Log di diagnostica, Diagnostica generale, Diagnostica software, Diagnostica di rete Thread, Diagnostica di rete Wi-Fi, Diagnostica di rete Ethernet) Sincronizzazione temporale Selezione modalità
Applicazione	I gruppi e le scene non sono supportati direttamente. La funzionalità equivalente è disponibile tramite le routine. Tutti i cluster multimediali. Sono disponibili funzionalità equivalenti tramite Google Cast.

1 Per informazioni sull'impatto dei sensori di accensione/spegnimento, consulta la sezione Interruttori luce di accensione/spegnimento.