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

Program Developer Google Home memungkinkan produsen perangkat 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 dalam ekosistem Google Home.

Pernyataan Penyangkalan

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

  • Sebaiknya akun yang digunakan untuk pengembangan hanya memiliki satu hub yang mendukung Matter yang terhubung untuk pengujian. Beberapa hub berkemampuan Matter yang terhubung pada waktu yang sama 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 melakukan flash sampel Matter, yang telah diuji oleh Google. Meskipun komputer MacOS didukung, Linux direkomendasikan. Instruksi khusus Mac disebutkan dalam prosedur yang diperlukan.

Cara mem-build

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

Cara termudah untuk memulai adalah dengan membuka codelab kami. Sebaiknya lakukan setidaknya salah satu codelab berikut:

Setelah itu, periksa daftar perangkat yang didukung untuk memastikan bahwa hal yang akan Anda integrasikan didukung di ekosistem Google Home. Kemudian, baca Checklist Developer untuk memahami seluruh alur pengembangan mulai dari pembuatan project hingga peluncuran.

Perangkat yang Didukung Checklist Developer

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 berkemampuan Matter
Board perangkat atau pengembangan yang telah di-flash dengan build atau aplikasi contoh berkemampuan Matter.
Perangkat seluler
Ponsel uji coba yang digunakan untuk membantu penyambungan. Saat ini, ini adalah ponsel Android.

Prasyarat

Ekstensi IDE yang direkomendasikan untuk pengembangan Matter

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

  1. Hub Google dengan dukungan Thread untuk berfungsi sebagai Router Pembatas untuk perangkat yang mendukung Thread dan sebagai jalur fulfillment lokal 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 dari jenis perangkat Matter yang saat ini didukung di ekosistem Google Home, dan dapat berupa:
    • Produk Anda sendiri dengan firmware berkemampuan Matter.
    • Papan pengembangan platform vendor yang didukung yang dapat berfungsi sebagai perangkat berkemampuan Matter untuk verifikasi end-to-end. Platform berikut didukung:
Tabel: Matter contoh dari vendor silicon
Vendor Platform Panduan Dukungan Thread
Lab Bouffalo BL602 Mulai Cepat
BL702 Mulai Cepat
Espressif ESP32 Mulai Cepat
Pengujian OTA
Semikonduktor Nordik nRF52840 DK Mulai Cepat
Pengujian OTA
NXP Kit pengembangan IOTZTB-DK006 Mulai Cepat
Realtek Seri Ameba D Mulai Cepat
Lab Silicon Dev Kit EFR32MG24 Mulai Cepat
Starter Kit Zigbee dan Thread EFR32MG Mulai Cepat
Telink TLSR9518 Mulai Cepat
Musik 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 memverifikasi terlebih dahulu oleh Google untuk memastikan bahwa integrasi tersebut telah diterbitkan kepada Anda oleh CSA.

VID ini harus diimplementasikan di firmware perangkat Anda.

Perangkat Matter hanya dapat disambungkan dalam ekosistem Google Home 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 Anda dapat menggunakannya di Google Home Developer Console. Setelah itu, Anda dapat membuat integrasi untuk VID tersebut.
  • Untuk tujuan pengembangan dan uji coba lapangan, project dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. Pengguna yang memesan perangkat harus menjadi anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah produk tersebut disertifikasi oleh Alliance.
Tabel: Skenario penyambungan ID Vendor (VID) dan jenis perangkat
Jenis pengguna manakah yang dapat melakukan commissioning perangkat ke dalam ekosistem Google Home?
Jenis VID Status integrasi konsol dan sertifikasi VID Produksi
(Pengguna konsumen)		 Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Pengujian Tidak ada integrasi dalam 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 Disertifikasi dalam DCL Alliance, integrasi tidak ada di Developer Console
Produksi Disertifikasi dalam DCL Alliance dan integrasi ada di Developer Console

ID Produk

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

Fitur yang tidak didukung

Beberapa cluster Matter belum diekspos ke pengguna, meskipun cluster tersebut mungkin digunakan oleh sistem. Dalam sebagian besar kasus, ini berarti atribut yang ditampilkan melalui cluster ini tidak akan 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 Tombol Lampu Aktif/Nonaktif untuk mengetahui pengaruhnya terhadap Sakelar Lampu Aktif/Nonaktif.

Berikutnya
Checklist developer