Iniziare a utilizzare Matter

Il programma Google Home Developer consente ai produttori di dispositivi di connettere i propri dispositivi per la smart home all'ecosistema Google Home. Stiamo ampliando il percorso di evasione degli ordini locale Azioni smart home con la possibilità di aggiungere dispositivi abilitati per Matter per la configurazione utilizzando Google Home app (GHA) e controllarli tramite Google Assistant, GHA o smart display come 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 documentazione di Matter, tieni presente quanto segue:

  • Ti consigliamo di fare in modo che l'account utilizzato per lo sviluppo abbia un solo hub abilitato per Matter collegato per i test. Più hub abilitati per Matter connessi contemporaneamente o alla stessa struttura durante i test potrebbero comportare comportamenti imprevedibili.
  • Tutte le procedure presuppongono l'utilizzo di una macchina Linux che esegue Ubuntu 20.04 per la creazione e il flashing di esempi Matter, testati da Google. Anche se i computer macOS sono supportati, è consigliabile utilizzare Linux. Le istruzioni specifiche per Mac vengono richiamate all'interno delle procedure, a seconda delle esigenze.

Come creare

Per creare un dispositivo abilitato per Matter che si integri con l'ecosistema Google Home, devi utilizzare una scheda di sviluppo compatibile con Matter e l'SDKMatter.

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

Dopodiché, consulta il nostro elenco dei dispositivi supportati per assicurarti che quelli che prevedi di integrare siano supportati nell'ecosistema Google Home. Dopodiché leggi l'elenco di controllo per sviluppatori per comprendere l'intero flusso di sviluppo dalla creazione al lancio del progetto.

Dispositivi supportati Elenco di controllo per sviluppatori

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, come Google Nest Hub (2nd gen). È necessario un hub per controllare i dispositivi abilitati per Matter tramite altre piattaforme come Assistant, GHA e smart display.
Dispositivo con funzionalità Matter
Un dispositivo o una scheda di sviluppo su cui è stato eseguito il flashing di una build o un'app di esempio abilitata per Matter.
Dispositivo mobile
Lo smartphone di prova utilizzato per l'accoppiamento del dispositivo. 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 Thread che funge sia da router di confine per i dispositivi compatibili con Thread, sia da percorso di fulfillment locale per il routing degli intent della smart home.
  2. Un dispositivo mobile (telefono di prova) che soddisfi i requisiti minimi:
    • Android O (8.1, livello API 27 o versioni successive)
    • iOS (v16.5 o successive)
    • Funzionalità BLE
  3. Un ID fornitore (VID) e un ID prodotto (PID) per il dispositivo abilitato per Matter.
  4. Un dispositivo con Matter. Questo dispositivo dovrebbe 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 Matter dispositivi da utilizzare per la verifica end-to-end:
Tabella: Matter esempi di fornitori di silicon
Fornitore Piattaforma Assistenza Thread Guida
Laboratorio Bouffalo BL602
BL702
Espressif ESP32 Test OTA
Semiconduttore nordico nRF52840 DK Test OTA
NXP Kit di sviluppo IOTZTB-DK006
Realtek Serie Ameba D
Silicon Labs Kit di sviluppo EFR32MG24
Starter Kit Zigbee e Thread EFR32MG
Telink TLSR9518
Texas Instruments Kit di sviluppo CC2652R7 LaunchPad

ID fornitore

Per impostazione predefinita, puoi utilizzare uno dei VID assegnati da 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 averla verificata da Google per assicurarti che sia stata inviata da 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 convaliderà che sei il proprietario del VID prima che tu possa utilizzarlo nel Google Home Developer Console. A quel punto, potrai creare integrazioni per il VID.
  • A scopo di sviluppo e prova sul campo, è necessario creare un progetto e un'integrazione con la combinazione di VID e PID corrispondente in Developer Console. 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.
  • I consumatori possono utilizzare il tuo prodotto solo se è stato certificato dal Alliance.
Tabella: scenari di accoppiamento di ID fornitore (VID) e tipo di dispositivo
Quali tipi di utenti possono commissionare il dispositivo nell'ecosistema Google Home?
Tipo di VID Certificazione VID e stato di integrazione della console Produzione
(utenti consumer)
Sviluppo
(sviluppatori, utenti di Field Trial)
Testa Nessuna integrazione in Developer Console (non può essere certificata)
Testa 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 nella DCL Alliance; l'integrazione non esiste in Developer Console
Produzione Certificato nel DCL Alliance ed esiste un'integrazione 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 dispositivo deve corrispondere all'ID prodotto dell'integrazione di Matter nella Developer Console.

Funzionalità non supportate

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

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

1 Consulta la sezione Interruttori della luce On/Off per scoprire come questo influisce sugli interruttori della luce On/Off.