Avviso. A breve saranno disponibili nuovi programmi Anteprima per sviluppatori. Richiedilo qui; potrai essere uno dei primi a provare nuovi strumenti e fornire feedback.

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

Estensioni IDE consigliate per lo sviluppo di Matter

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.