Perhatian! Program Pratinjau Developer yang baru akan segera diluncurkan. Daftar di sini dan jadilah salah satu developer pertama yang mencoba alat baru serta berikan masukan.

Mulai menggunakan Matter

  Rilis Pratinjau Developer  

Program Developer Rumah Google memungkinkan produsen perangkat untuk menghubungkan perangkat smart home mereka dengan ekosistem Google Home. Kami memperluas jalur fulfillment lokal Action Smart Home dengan kemampuan untuk menambahkan perangkat berkemampuan Matter untuk penyiapan menggunakan Google Home app (GHA) dan mengontrolnya menggunakan Google Assistant, GHA, atau layar smart seperti Google Nest Hub (2nd gen).

Dokumentasi ini menjelaskan cara mulai membuat dan mengintegrasikan platform yang didukung Matter di ekosistem Google Home.

Pernyataan penyangkalan

Terkait prosedur yang dijelaskan dalam Pratinjau Developer Matter ini, perhatikan hal-hal berikut:

  • Akun yang digunakan untuk pengembangan hanya boleh memiliki satu hub dengan dukungan Matter yang terhubung untuk pengujian. Beberapa hub yang mendukung Matter yang terhubung secara bersamaan atau terhubung ke struktur yang sama selama pengujian dapat menghasilkan perilaku yang tidak dapat diprediksi.
  • Semua prosedur mengasumsikan penggunaan mesin 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. Petunjuk khusus Mac dipanggil dalam prosedur sesuai kebutuhan.

Definisi

Istilah berikut digunakan di seluruh dokumentasi ini:

Router pembatas
Hub yang mengimplementasikan Border Router Thread tujuan umum untuk perangkat berkemampuan 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 aplikasi build atau contoh yang mendukung Matter.
Perangkat seluler
Ponsel uji yang digunakan untuk membantu penyambungan. Saat ini, ponsel ini adalah ponsel Android.

Prasyarat

Ekstensi IDE yang direkomendasikan untuk pengembangan Matter

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

  1. Hub Google dengan dukungan Thread yang berfungsi sebagai Router Pembatas untuk perangkat yang mengaktifkan Thread dan sebagai jalur fulfillment lokal untuk merutekan intent Smart Home.
  2. Perangkat seluler (ponsel pengujian) 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 jenis perangkat Matter yang saat ini didukung dalam ekosistem Google Home, dan dapat berupa:
    • Produk Anda sendiri dengan firmware yang diaktifkan oleh Matter.
    • Board pengembangan platform vendor yang didukung yang dapat berfungsi sebagai perangkat berkemampuan Matter untuk verifikasi menyeluruh. Platform berikut didukung:
Tabel: Matter contoh dari vendor silikon
Vendor Platform Panduan Dukungan Thread
Lab Bouffalo BL602 Mulai Cepat
BL702 Mulai Cepat
Spanyol ESP32 Mulai Cepat
Pengujian OTA
Semikonduktor Nordik DRF52840 Mulai Cepat
Pengujian OTA
CameraX Kit pengembangan IOTZTB-DK006 Mulai Cepat
Realtek Seri Ameba D Mulai Cepat
Lab Silikon Kit Developer EFR32MG24 Mulai Cepat
EFR32MG Zigbee dan Thread Starter Kit Mulai Cepat
Penautan TLSR9518 Mulai Cepat
Instrumen Texas Kit pengembangan LaunchPad CC2652R7 Mulai Cepat

ID Vendor

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

Untuk menggunakan VID Produksi agar integrasi Anda dapat disertifikasi dan diluncurkan, Anda harus terlebih dahulu memverifikasinya oleh Google untuk memastikan bahwa konten tersebut telah dikeluarkan untuk Anda oleh CSA.

VID ini harus diterapkan di firmware perangkat Anda.

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

  • VID pengujian tidak dapat digunakan di perangkat konsumen.
  • VID produksi Anda harus dikeluarkan oleh CSA. Google akan memvalidasi bahwa Anda adalah pemilik VID tersebut sebelum Anda dapat menggunakannya di Google Home Developer Console. Setelah itu, Anda dapat membuat integrasi untuk VID tersebut.
  • Untuk tujuan pengembangan dan uji coba kolom, project dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. Pengguna yang meminta perangkat harus merupakan anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah mendapatkan sertifikasi dari CSA.
Tabel: ID vendor (VID) dan skenario penyambungan jenis perangkat
Jenis pengguna mana yang dapat menetapkan perangkat ke ekosistem Google Home?
Jenis VID Sertifikasi VID dan status integrasi konsol Produksi
(Pengguna konsumen)
Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Pengujian Tidak ada integrasi di Developer Console (tidak dapat disertifikasi)
Pengujian Integrasi ada di Developer Console (tidak dapat disertifikasi)
Produksi Tidak tersertifikasi, integrasi tidak ada di Developer Console
Produksi Tidak tersertifikasi, integrasi ada di Developer Console
Produksi Bersertifikat di DCL CSA, integrasi tidak ada di Developer Console
Produksi Bersertifikat di DCL CSA dan integrasi ada di Developer Console

ID Produk

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

Fitur yang tidak didukung

Beberapa cluster Matter belum ditampilkan kepada pengguna, meskipun cluster tersebut dapat digunakan oleh sistem. Dalam kebanyakan kasus, ini berarti bahwa atribut yang terekspos melalui cluster ini tidak akan terlihat oleh pengguna akhir:

Tabel: Matter cluster yang tidak diekspos kepada pengguna di ekosistem Google Home
Jenis Cluster Cluster
Core
  • Binding 1
  • Label
  • Label Tetap
  • Label Pengguna
  • Tindakan
  • Kunci Grup
  • Konfigurasi Pelokalan
  • Pelokalan Format Waktu
  • Pelokalan Unit
  • Konfigurasi Sumber Listrik
  • Sumber Listrik
  • Cluster diagnostik (Log Diagnostik, Diagnostik Umum, Diagnostik Software, Diagnostik Jaringan Thread, Diagnostik Jaringan Wi-Fi, Diagnostik Jaringan Ethernet)
  • Sinkronisasi Waktu
  • Pilih Mode
Application
  • Grup dan Adegan tidak didukung secara langsung. Fungsi yang setara tersedia melalui Rutinitas.
  • Semua cluster Media. Fungsi yang setara tersedia melalui Google Cast.

1 Lihat Sakelar Lampu Aktif/Nonaktif untuk mengetahui pengaruhnya terhadap Sakelar Lampu Aktif/Nonaktif.