Iniziare a utilizzare Matter

Il programma Google Home Developer consente ai produttori di dispositivi di connettersi i propri dispositivi per la smart home con l'ecosistema Google Home. Stiamo espandendo la Percorso di distribuzione locale relativo alle azioni per la smart home con la possibilità di aggiungere Dispositivi abilitati per Matter per la configurazione tramite Google Home app (GHA) e controllarli con Google Assistant, GHA o smart display come Google Nest Hub (2nd gen).

Questa documentazione descrive come iniziare a creare e integrare un piattaforma supportata da Matter nell'ecosistema Google Home.

Disclaimer

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

  • Consigliamo che l'account utilizzato per lo sviluppo abbia un solo account Hub abilitato per Matter connesso per i test. Più di uno Hub abilitati per Matter collegati alla alla stessa ora o connessi alla stessa struttura durante i test potrebbero comportamenti imprevedibili.
  • Tutte le procedure presuppongono l’uso di un sistema Linux che esegue Ubuntu 20.04 per creare e lampeggiare Matter esempi, che sono stati testato da Google. Sebbene siano supportati i computer macOS, è consigliato Linux. Specifici per Mac le istruzioni all'interno delle procedure, se necessario.

Come creare

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

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

Dopodiché, controlla il nostro elenco di dispositivi supportati per assicurarti di l'integrazione è supportata nell'ecosistema Google Home. Dopodiché leggi l'elenco di controllo per gli sviluppatori per comprendere l'intero il flusso di sviluppo dalla creazione al lancio del progetto.

Dispositivi supportati Elenco di controllo per gli sviluppatori

Definizioni

Nella documentazione vengono utilizzati i seguenti termini:

Router di confine
Un hub che implementa un confine Thread generico Router per dispositivi abilitati per Thread.
Hub
Un dispositivo Google Nest supportato, ad esempio Google Nest Hub (2nd gen). È necessario un hub per controllare i dispositivi abilitati per Matter tramite ad altre sezioni come Assistant, GHA e smart display.
Matter dispositivo abilitato
Un dispositivo o una scheda di sviluppo su cui è stato eseguito il flashing di una App di esempio o build abilitata per Matter.
Dispositivo mobile
Lo smartphone di prova utilizzato per facilitare l'accoppiamento. Attualmente si tratta di un Android smartphone.

Prerequisiti

Estensioni IDE consigliate per Matter di sviluppo

Per integrare completamente un dispositivo abilitato per Matter con nell'ecosistema Google Home, uno sviluppatore deve avere:

  1. Un hub Google con supporto di Thread fungere sia da router di confine per i dispositivi compatibili con Thread sia come router locale percorso di distribuzione per il routing degli intent della smart home.
  2. Un dispositivo mobile (smartphone di prova) che soddisfa 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 compatibile con Matter. Questo dispositivo deve essere uno di i Matter tipi di dispositivi supportati in dell'ecosistema Google Home e potrebbe essere:
    • Il tuo prodotto con firmware abilitato per Matter.
    • Uno dei seguenti Matter dispositivi da utilizzare per verifica end-to-end:
Tabella: Matter esempi di fornitori di silicio
Fornitore Piattaforma Assistenza Thread Guida
Laboratorio Bouffalo BL602
BL702
Espressif ESP32 Test per OTA
Nordic Semiconductor nRF52840 DK Test per OTA
NXP Sviluppo IOTZTB-DK006 kit
Realtek Serie Ameba D
Lab Silicon Kit di sviluppo EFR32MG24
EFR32MG Zigbee e Thread Kit di base
Telink TLSR9518
Texas Instruments Sviluppo del LaunchPad di CC2652R7 kit

ID fornitore

Per impostazione predefinita, puoi utilizzare uno dei VID assegnati dall'CSA per i test scopi. Seleziona una delle seguenti opzioni: 0xFFF1, 0xFFF2, 0xFFF3 e 0xFFF4.

Per utilizzare un VID di produzione in modo che l'integrazione possa essere certificata e lanciata, devi prima farne verificare da Google per garantire che ti sia stato rilasciato dall'agenzia associata alla ricerca.

Questo VID deve essere implementato nel firmware del tuo dispositivo.

È possibile accoppiare un dispositivo Matter soltanto in Google Home in determinati scenari di ID fornitore e tipo di dispositivo.

  • Un VID di prova non può essere utilizzato in un dispositivo consumer.
  • Il tuo VID di produzione deve essere emesso dal Connectivity Standards Alliance (Alliance). Google provvederà confermare di essere il proprietario del VID prima di poterlo utilizzare in Google Home Developer Console. Dopodiché potrai creare per questo VID.
  • Ai fini dello sviluppo e delle sperimentazioni sul campo, un progetto e l'integrazione la combinazione di VID e PID corrispondente deve essere creata in Developer Console. L'utente che mette in servizio il dispositivo deve essere un membro del progetto o essere incluso nell'elenco degli utenti che usufruiscono di prove sul campo.
  • Gli utenti consumer possono utilizzare il tuo prodotto solo dopo che è stato certificato dal Alliance.
Tabella: ID fornitore (VID) e tipo di dispositivo scenari di accoppiamento
Quali tipi di utenti possono commissionare nell'ecosistema Google Home?
Tipo di VID Stato della certificazione VID e dell'integrazione della console Produzione
(utenti consumer)
Sviluppo
(sviluppatori, utenti di prove sul campo)
Test Nessuna integrazione in Developer Console (impossibile essere certificato)
Test L'integrazione esiste in Developer Console (non può essere certificato)
Produzione Non certificato. L'integrazione non esiste in Developer Console.
Produzione Non certificata, l'integrazione esiste in Developer Console
Produzione Certificato nel DCL di Alliance, l'integrazione non esistono in Developer Console
Produzione Certificato nel DCL di Alliance e integrazione esistente nel Developer Console

ID prodotto

Le informazioni sul dispositivo vengono lette dal Matter Cluster di informazioni di base. L'ID prodotto codificato nel tuo il 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 possono essere utilizzati dal sistema. Nella maggior parte dei casi, ciò significa che gli attributi esposti attraverso 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 Vedi Interruttori per la luce on/off sull'impatto degli interruttori della luce on/off.