Iniziare a utilizzare Matter

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

  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 Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the Google Nest Hub (2nd gen) .

Questa documentazione descrive come iniziare a creare e integrare una piattaforma supportata da Matter nell'ecosistema 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 Matter abilitato per i test. Più hub abilitati Matter collegati contemporaneamente o collegati alla stessa struttura durante i test potrebbero causare comportamenti imprevedibili.
  • Tutte le procedure presuppongono l'utilizzo di una macchina Linux che esegue Ubuntu 20.04 per la creazione e il lampeggiamento di esempi 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 Android GHA.

Definizioni

In questa documentazione vengono utilizzati i seguenti termini:

Router di confine
Un hub che implementa un uso generico Thread Border Router for Thread-enabled devices.
Hub
Un file supportato Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
Dispositivo abilitato per Matter
Un dispositivo o una scheda di sviluppo lampeggiati con un'app di esempio o una build abilitata per Matter.
Dispositivo mobile
Il telefono di prova utilizzato per facilitare l'accoppiamento. Al momento, questa è una Android phone.

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 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.
  2. 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
  3. Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
  4. Un dispositivo abilitato per 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:
Tabella: Matter esempi da fornitori di silicon
Fornitore Piattaforma Guide Assistenza Thread
Laboratorio bouffalo BL602 Guida rapida
BL702 Guida rapida
Espressif ESP32 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 associato solo nell'ecosistema Google Home in determinati 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 .
Tabella: scenari di accoppiamento di ID fornitore (VID) e tipo di dispositivo
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/A N/A
Test Inserzionista registrato in Developer Console (non certificato) N/A
Produzione Non certificato, non registrato N/A
Produzione Non certificato, registrato in Developer Console
Produzione Certificato in CSA DCL, non registrato N/A
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 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 saranno visibili agli utenti finali:

Tabella: Matter cluster non esposti agli utenti nell'ecosistema Google Home
Tipo di cluster Cluster
Core
  • Associazione
  • Etichetta
  • Etichetta fissa
  • Etichetta utente
  • Azioni
  • Chiave di gruppo
  • Configurazione localizzazione
  • Localizzazione del formato temporale
  • Localizzazione di 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. La funzionalità equivalente è disponibile tramite Google Cast .