Iniziare a utilizzare Matter

Il programma Home Developer di Google consente ai produttori di dispositivi di connettere i propri smart device per la casa all'ecosistema Google Home. Stiamo espandendo il percorso di fulfillment locale delle azioni per la smart home con la possibilità di aggiungere dispositivi compatibili con Matter-enabled per la configurazione utilizzando l'app Google Home app (GHA) e di controllarli utilizzando l'Assistente Google Assistant, GHA, o smart display come il 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 Matter documentazione, tieni presente quanto segue:

• Ti consigliamo di utilizzare un account per lo sviluppo a cui sia collegato un solo Matter-enabled hub compatibile con Matter per i test. Se durante i test sono collegati più hub compatibili con Matter-contemporaneamente o alla stessa struttura, il comportamento potrebbe essere imprevedibile.
• Tutte le procedure presuppongono l'utilizzo di una macchina Linux con Ubuntu 20.04 per la creazione e il flashing degli esempi Matter che sono stati testati da Google. Sebbene le macchine macOS siano supportate, è consigliabile utilizzare Linux. Le istruzioni specifiche per Mac vengono indicate nelle procedure, se necessario.

Come creare

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'Matter SDK.

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

Dopodiché, consulta il nostro elenco di dispositivi supportati per assicurarti che ciò che intendi integrare sia supportato nell'ecosistema Google Home. Poi, leggi 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

I seguenti termini vengono utilizzati in questa documentazione:

Router di confine

Un hub che implementa un router di confine Threadper uso generico 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, GHAe gli smart display.

Dispositivo compatibile con Matter

Un dispositivo o una scheda di sviluppo su cui è stata eseguita l'installazione di una build o di un'app di esempio compatibile con Matter Matter.

Dispositivo mobile

Lo smartphone di test utilizzato per facilitare l'accoppiamento. Al momento questo è un Android telefono.

Prerequisiti

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

1. Un hub Google con supporto Thread che funga sia da router di confine per i dispositivi compatibili con Thread sia da percorso di fulfillment locale per il routing degli intent per la 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 (versione 16.5 o versioni successive)
   • Funzionalità BLE
3. Un ID fornitore (VID) e un ID prodotto (PID) per il Matter-enabled device.
4. Un dispositivo compatibile con Matter. Questo dispositivo deve essere uno dei tipi di dispositivi Mattersupportati nell' ecosistema Google Home e potrebbe essere:
   • Il tuo prodotto con firmware compatibile con Matter.
   • Uno dei seguenti dispositivi Matter da utilizzare per la verifica end-to-end:

Tabella: Matter esempi di Matter di fornitori di silicio

Fornitore	Piattaforma	Thread Supporto	Guida
Bouffalo Lab	BL602
	BL702
Espressif	ESP32		Test OTA
Nordic Semiconductor	nRF52840 DK		Test OTA
NXP	Kit di sviluppo IOTZTB-DK006 kit
Realtek	Serie Ameba D
Silicon Labs	Kit di sviluppo EFR32MG24
	Kit di baseEFR32MG Zigbee e Thread
Telink	TLSR9528		Guida per gli sviluppatori di Matter di Telink
Texas Instruments	Kit di sviluppo CC2652R7 LaunchPad

ID fornitore

Per impostazione predefinita, puoi utilizzare uno dei VID allocati dall'Alliance per i test. Seleziona uno dei seguenti: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Per utilizzare un VID di produzione in modo che l'integrazione possa essere certificata e lanciata, devi prima farlo verificare da Google per assicurarti che sia stato emesso dall'Alliance.

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.

• Non è possibile utilizzare un VID di test in un dispositivo consumer.
• Il VID di produzione deve essere emesso dalla Connectivity Standards Alliance (Alliance). Google verificherà che tu sia il proprietario del VID prima che tu possa utilizzarlo in Google Home Developer Console. Una volta fatto, 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 nella Developer Console. L'utente che esegue la messa in servizio del dispositivo deve essere un membro del progetto o essere incluso nell'elenco degli utenti Field Trial.
• Gli utenti consumer possono utilizzare il tuo prodotto solo dopo che è stato certificato dal Alliance.

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

• Modificare l'integrazione utilizzando il VID o il PID con un VID o PID diverso.
• Eliminare l'integrazione utilizzando il VID o il PID.

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

		Quali tipi di utenti possono eseguire la messa in servizio del dispositivo nell'ecosistema Google Home?
Tipo di VID	Stato di certificazione VID e integrazione della console	Produzione (utenti consumer)	Sviluppo (sviluppatori, Field Trial utenti)
Test	Nessuna integrazione nella Developer Console (non può essere certificata)
Test	L'integrazione esiste nella Developer Console (non può essere certificata)
Produzione	Non certificata, l'integrazione non esiste nella Developer Console
Produzione	Non certificata, l'integrazione esiste nella Developer Console
Produzione	Certificata in Alliance DCL, l'integrazione non esiste nella Developer Console
Produzione	Certificata in the Alliance DCL e l'integrazione exists in the 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'Matter integrazione nella Developer Console.

Funzionalità non supportate

Alcuni Matter cluster 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:

¹ Per informazioni su come influisce sugli interruttori della luce On/Off, consulta Interruttori della luce On/Off.