Mulai menggunakan Matter

Program Developer Home dari Google memungkinkan produsen perangkat untuk perangkat smart home mereka dengan ekosistem Google Home. Kami memperluas Jalur fulfillment lokal Smart Home Actions dengan kemampuan untuk menambahkan perangkat yang mendukung Matter untuk penyiapan menggunakan Google Home app (GHA) dan kontrol menggunakan Google Assistant, GHA, atau layar smart seperti Google Nest Hub (2nd gen).

Dokumentasi ini menjelaskan cara memulai pembuatan dan integrasi platform yang didukung Matter di ekosistem Google Home.

Pernyataan penyangkalan

Mengenai prosedur yang dijelaskan dalam Matter dokumentasi, perhatikan hal-hal berikut:

  • Sebaiknya akun yang digunakan untuk pengembangan hanya memiliki satu Hub yang mengaktifkan Matter terhubung untuk pengujian. Beberapa hub berkemampuan Matter yang terhubung di waktu yang sama atau terhubung ke struktur yang sama selama pengujian dapat mengakibatkan perilaku yang tidak dapat diprediksi.
  • Semua prosedur mengasumsikan penggunaan komputer Linux yang menjalankan Ubuntu 20.04 untuk mem-build dan mem-flash sampel Matter, yang telah diuji oleh Google. Meskipun mesin macOS didukung, sebaiknya gunakan Linux. Khusus Mac instruksi disebutkan dalam prosedur sesuai kebutuhan.

Cara membangun

Untuk membuat perangkat berkemampuan Matter yang terintegrasi dengan ekosistem Google Home, Anda akan bekerja dengan board pengembangan yang kompatibel dengan Matter dan Matter SDK.

Cara termudah untuk memulai adalah dengan mempelajari codelab kami. Rab sebaiknya lakukan setidaknya salah satu codelab berikut:

Setelah itu, periksa daftar perangkat yang didukung untuk memastikan bahwa yang Anda integrasi Anda didukung dalam ekosistem Google Home. Lalu baca Checklist Developer untuk memahami seluruh bagian alur pengembangan dari pembuatan proyek hingga peluncuran.

Perangkat yang Didukung Checklist Developer

Definisi

Istilah berikut digunakan di seluruh dokumentasi ini:

Router pembatas
Hub yang mengimplementasikan Batas Thread tujuan umum Router untuk perangkat yang mendukung Thread.
Penghubung
Perangkat Google Nest yang didukung, seperti Google Nest Hub (2nd gen). Hub diperlukan untuk mengontrol perangkat yang mendukung Matter melalui platform lain seperti Assistant, GHA, dan layar smart.
Perangkat yang mendukung Matter
Perangkat atau board pengembangan yang telah di-flash dengan Build atau aplikasi contoh yang mendukung Matter.
Perangkat seluler
Ponsel pengujian yang digunakan untuk membantu penyambungan. Saat ini, Ponsel Android.

Prasyarat

Ekstensi IDE yang direkomendasikan untuk Matter pengembangan

Untuk mengintegrasikan sepenuhnya perangkat yang mendukung Matter dengan ekosistem Google Home, developer harus memiliki:

  1. Hub Google dengan dukungan Thread berfungsi sebagai {i>Router<i} Perbatasan untuk perangkat yang mendukung Thread dan sebagai untuk merutekan intent Smart Home.
  2. Perangkat seluler (ponsel uji coba) yang memenuhi persyaratan minimum:
    • Android O (8.1, API level 27 atau yang lebih baru)
    • iOS (v16.5 atau yang lebih baru)
    • Kemampuan BLE
  3. ID Vendor (VID) dan ID Produk (PID) untuk perangkat yang mendukung Matter.
  4. Perangkat yang mendukung Matter. Perangkat ini harus merupakan salah satu Matter jenis perangkat yang didukung dalam ekosistem Google Home, dan dapat berupa:
    • Produk Anda sendiri dengan firmware yang mendukung Matter.
    • Salah satu dari Matter perangkat berikut yang akan digunakan untuk verifikasi {i>end-to-end<i}:
Tabel: Matter contoh dari vendor silicon
Vendor Platform Dukungan Thread Panduan
Lab Bouffalo BL602
BL702
Espressif ESP32 Pengujian OTA
Semikonduktor Nordik nRF52840 DK Pengujian OTA
NXP Pengembangan IOTZTB-DK006 perangkat
Realtek Seri Ameba D
Lab Silicon Kit Developer EFR32MG24
EFR32MG Zigbee dan Thread Kit Pemula
Telink TLSR9518
Alat Musik Texas Pengembangan LaunchPad CC2652R7 perangkat

ID Vendor

Secara default, Anda dapat menggunakan salah satu VID yang dialokasikan oleh CSA untuk pengujian tujuan. Pilih salah satu opsi berikut: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Untuk menggunakan VID Produksi agar integrasi dapat disertifikasi dan diluncurkan, Anda harus terlebih dahulu meminta Google melakukan verifikasi untuk memastikan bahwa kode tersebut telah dikeluarkan oleh CSA kepada Anda.

VID ini harus diterapkan di firmware perangkat Anda.

Perangkat Matter hanya bisa disambungkan di Google Home ekosistem dalam skenario ID Vendor dan jenis perangkat tertentu.

  • VID pengujian tidak dapat digunakan di perangkat konsumen.
  • VID produksi Anda harus diterbitkan oleh Connectivity Standards Alliance (Alliance). Google akan memvalidasi bahwa Anda adalah pemilik VID tersebut sebelum dapat menggunakannya di Google Home Developer Console. Setelah itu terjadi, Anda akan dapat membuat integrasi untuk VID tersebut.
  • Untuk tujuan pengembangan dan uji coba lapangan, sebuah proyek dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. commissioning pengguna perangkat harus menjadi anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah disertifikasi oleh Alliance.
Tabel: ID Vendor (VID) dan jenis perangkat skenario penyambungan
Jenis pengguna mana yang dapat melakukan komisi perangkat Anda ke ekosistem Google Home?
Jenis VID Sertifikasi VID dan status integrasi konsol Produksi
(Pengguna konsumen)		 Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Tes Tidak ada integrasi di Developer Console (tidak dapat disertifikasi)
Tes Integrasi ada di Developer Console (tidak boleh tersertifikasi)
Produksi Tidak tersertifikasi, integrasi tidak ada di Developer Console
Produksi Tidak tersertifikasi, integrasi ada di Developer Console
Produksi Tersertifikasi dalam DCL Alliance, integrasi tidak ada dalam Developer Console
Produksi Tersertifikasi dalam DCL Alliance dan tersedia integrasi dalam Developer Console

ID Produk

Informasi tentang perangkat dibaca dari Matter Cluster Informasi Dasar. ID Produk yang dienkode di kolom firmware perangkat harus cocok dengan ID Produk integrasi Matter di Konsol Play.

Fitur yang tidak didukung

Beberapa cluster Matter belum diekspos ke pengguna mereka dapat digunakan oleh sistem. Dalam kebanyakan kasus, ini berarti bahwa atribut terekspos melalui cluster ini tidak terlihat oleh pengguna akhir:

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 Lihat Sakelar Lampu Aktif/Nonaktif untuk mengetahui dampaknya terhadap Sakelar Lampu Aktif/Nonaktif.

Berikutnya
Checklist developer