Mulai menggunakan Matter

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Rilis Pratinjau Developer

Program Developer Home Google memungkinkan produsen perangkat untuk menghubungkan perangkat smart home mereka dengan ekosistem Google Home. Kami memperluas jalur fulfillment lokal Smart Home Actions dengan kemampuan untuk menambahkan perangkat berkemampuan Matter untuk penyiapan menggunakan Google Home app (GHA) di Android 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

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

  • Akun yang digunakan untuk pengembangan hanya boleh memiliki satu Hub yang mendukung Matter yang terhubung untuk pengujian. Beberapa hub dengan Matter aktif yang terhubung pada waktu yang sama atau terhubung ke struktur yang sama selama pengujian dapat menyebabkan 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, Linux direkomendasikan. Petunjuk khusus Mac disebutkan dalam prosedur sesuai kebutuhan.
  • Hanya GHA versi Android yang didukung.

Definisi

Istilah berikut digunakan di seluruh dokumentasi ini:

Router pembatas
Hub yang menerapkan Border Router Thread tujuan umum untuk perangkat yang mengaktifkan 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 mengaktifkan Matter
Perangkat atau board pengembangan yang telah di-flash dengan build atau aplikasi contoh yang mengaktifkan 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 berkemampuan Matter dengan ekosistem Google Home, developer harus memiliki:

  1. Hub Google dengan dukungan Thread yang berfungsi sebagai Router Batas untuk perangkat yang mengaktifkan Thread dan sebagai jalur fulfillment lokal untuk mengarahkan intent Smart Home.
  2. Perangkat seluler (ponsel pengujian) yang memenuhi persyaratan minimum:
    • Android O (8.1, API level 27) atau yang lebih baru (dukungan iOS akan ditambahkan nanti)
    • Kemampuan BLE
  3. ID Vendor (VID) dan ID Produk (PID) untuk perangkat yang mengaktifkan Matter.
  4. Perangkat yang mengaktifkan Matter. Perangkat ini harus berupa salah satu jenis perangkat Matter yang saat ini didukung dalam ekosistem Google Home, dan dapat berupa:
    • Produk Anda sendiri dengan firmware yang diaktifkan Matter.
    • Board pengembangan platform vendor yang didukung yang dapat berfungsi sebagai perangkat dengan Matter yang aktif untuk verifikasi menyeluruh. Platform berikut ini didukung:
Tabel: Matter contoh dari vendor silicon
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 EFR32MG Zigbee dan Thread Starter Kit Mulai Cepat
Kit Developer EFR32MG24 Mulai Cepat
Tautan TLSR9518 Mulai Cepat

ID Vendor

Secara default, Anda dapat menggunakan salah satu VID yang dialokasikan oleh CSA untuk tujuan pengujian. Pilih salah satu 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 sertifikat tersebut telah diberikan kepada Anda oleh CSA.

VID ini harus diterapkan di firmware perangkat Anda.

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

  • VID pengujian tidak dapat digunakan di perangkat konsumen.
  • Agar perangkat produksi (konsumen) dapat dipasangkan, perangkat tersebut harus disertifikasi di DCL CSA.
  • Untuk tujuan pengembangan dan uji coba lapangan, perangkat harus terdaftar di Google Home Developer Console.
Tabel: Skenario penyambungan ID vendor (VID) dan jenis perangkat
Apa jenis pengguna yang dapat memesan perangkat ke ekosistem Google Home?
Jenis VID Status pendaftaran dan sertifikasi VID Produksi
(Pengguna konsumen)
Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Tes Tidak terdaftar (tidak dapat disertifikasi) T/A T/A
Tes Terdaftar di Developer Console (tidak dapat disertifikasi) T/A
Produksi Tidak tersertifikasi, tidak terdaftar T/A
Produksi Tidak tersertifikasi, terdaftar di Developer Console
Produksi Bersertifikat di DCL CSA, tidak terdaftar T/A
Produksi Mendapatkan sertifikasi di DCL CSA dan terdaftar di Developer Console

ID Produk

Informasi tentang perangkat dibaca menggunakan cluster Matter Descriptor, bukan ID Produk. Anda dapat menetapkan ID Produk apa pun selama pengembangan, sesuai dengan skema penomoran perusahaan Anda—selama cocok dengan ID Produk integrasi Matter Anda, jika ditentukan.

Fitur yang tidak didukung

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

Tabel: Matter cluster yang tidak ditampilkan kepada pengguna di ekosistem Google Home
Jenis Cluster Cluster
Core
  • Binding
  • 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
  • Pilihan 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.