Iniziare a utilizzare Matter

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Il programma per sviluppatori di Google Home consente ai produttori di dispositivi di connettere i propri dispositivi per la smart home all'ecosistema Google Home. Stiamo ampliando il percorso di evasione locale di Smart Home Actions con la possibilità di aggiungere dispositivi compatibili con Matter per la configurazione utilizzando Google Home app (GHA) e 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 daMatter nell'ecosistema Google Home.

Disclaimer

In merito alle procedure descritte nella Matter documentazione, tieni presente quanto segue:

• Consigliamo di collegare un solo hub abilitato per Matter per i test all'account utilizzato per lo sviluppo. Più hub abilitati per Matter connessi contemporaneamente o connessi alla stessa struttura durante i test potrebbero comportare un comportamento imprevedibile.
• Tutte le procedure presuppongono l'utilizzo di una macchina Linux con Ubuntu 20.04 per compilare e eseguire il flashing dei sample Matter, che sono stati testati da Google. Sebbene le macchine macOS siano supportate, è consigliato Linux. Le istruzioni specifiche per Mac vengono indicate nelle procedure, se necessario.

Come eseguire la compilazione

Per creare un dispositivo compatibile con Matter che si integri con l'ecosistema Google Home, dovrai utilizzare una scheda di sviluppo compatibile con Matter e l'SDK Matter.

Il modo più semplice per iniziare è consultare i nostri codelab. Ti consigliamo di svolgere almeno uno dei seguenti codelab:

Dopodiché, controlla il nostro elenco di dispositivi supportati per assicurarti che ciò che prevedi di integrare sia supportato nell'ecosistema Google Home. Poi, consulta 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 presente documentazione vengono utilizzati i seguenti termini:

Router di confine

Un hub che implementa un router di confine Thread per uso generale per i dispositivi compatibili con 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 gli smart display.

Dispositivo compatibile con Matter

Un dispositivo o una scheda di sviluppo su cui è stato eseguito il flashing di una build o di un'app di esempio abilitata per Matter.

Dispositivo mobile

Lo smartphone di prova utilizzato per l'accoppiamento. Al momento si tratta di un telefono Android.

Prerequisiti

Per integrare completamente un dispositivo compatibile con Matter nell'ecosistema Google Home, uno sviluppatore deve disporre di:

1. Un hub Google con supporto Thread da utilizzare sia come router di confine per i dispositivi compatibili con Thread sia come percorso di completamento locale per il routing degli intent della smart home.
2. Un dispositivo mobile (smartphone di test) che soddisfi i requisiti minimi:
   • Android O (8.1, livello API 27 o versioni successive)
   • iOS (v16.5 o versioni successive)
   • Compatibilità BLE
3. Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo compatibile con Matter.
4. Un dispositivo compatibile con Matter. Questo dispositivo deve 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 dispositivi Matter da utilizzare per la verifica end-to-end:

Tabella: Matter esempi di fornitori di silicio

Fornitore	Piattaforma	Assistenza Thread	Guida
Bouffalo Lab	BL602
	BL702
Espressif	ESP32		Test OTA
Nordic Semiconductor	nRF52840 DK		Test OTA
NXP	Kit per sviluppatori IOTZTB-DK006
Realtek	Ameba D Series
Silicon Labs	Kit di sviluppo EFR32MG24
	EFR32MG Zigbee e Thread Starter Kit
Telink	TLSR9518
Texas Instruments	Kit di sviluppo LaunchPad CC2652R7

ID fornitore

Per impostazione predefinita, puoi utilizzare uno dei VID allocati dal 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 farla verificare da Google per assicurarti che ti sia stata rilasciata dal 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 verificherà che tu detenga la proprietà del VID prima che tu possa utilizzarlo in Google Home Developer Console. A questo punto, potrai creare integrazioni per il VID.
• Per scopi di sviluppo e Field Trial, è necessario creare un progetto e un'integrazione con la combinazione VID e PID corrispondente in Developer Console. L'utente che esegue la messa in servizio del dispositivo deve essere un membro del progetto o essere incluso nell'elenco di utenti Field Trial.
• Gli utenti consumatori possono utilizzare il tuo prodotto solo dopo che è stato certificato da Alliance.

VID e PID possono essere utilizzati una sola volta per un'integrazione. Se vuoi utilizzare lo stesso VID o PID nell'integrazione, devi:

• Modifica l'integrazione utilizzando il VID o il PID di un altro VID o PID.
• Elimina l'integrazione utilizzando il VID o il PID.

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

		Quali tipi di utenti possono commissionare il dispositivo nell'ecosistema Google Home?
Tipo di VID	Stato della certificazione VID e dell'integrazione della console	Produzione (Utenti privati)	Sviluppo (sviluppatori, utenti Field Trial)
Test	Nessuna integrazione in Developer Console (non può essere certificata)
Test	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 nel DCL Alliance, l'integrazione non esiste nel Developer Console
Produzione	Con certificazione DCL Alliance e l'integrazione è presente nel Developer Console

ID prodotto

Le informazioni sul dispositivo vengono lette dal Matter cluster di informazioni di base. L'ID prodotto codificato nel firmware del 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, anche se possono essere utilizzati dal sistema. Nella maggior parte dei casi, ciò significa che gli attributi esposti tramite questi cluster non sono visibili agli utenti finali:

¹ Consulta la sezione Interruttori di illuminazione On/Off per informazioni su come questo cambiamento influisce su questi dispositivi.