Program Developer Rumah Google memungkinkan produsen perangkat menghubungkan perangkat smart home mereka dengan ekosistem Google Home. Kami memperluas jalur fulfillment lokal Smart Home Actions dengan kemampuan untuk menambahkan perangkat yang kompatibel dengan 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 memulai pembuatan dan integrasi platform yang didukung Matter di ekosistem Google Home.
Pernyataan penyangkalan
Terkait prosedur yang dijelaskan dalam dokumentasi Matter, perhatikan hal berikut:
- Sebaiknya akun yang digunakan untuk pengembangan hanya memiliki satu hub yang mengaktifkan Matter yang terhubung untuk pengujian. Beberapa hub yang kompatibel dengan Matter yang terhubung secara bersamaan 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 akan disebutkan dalam prosedur sesuai kebutuhan.
Cara mem-build
Untuk mem-build perangkat yang kompatibel dengan Matter yang terintegrasi dengan ekosistem Google Home, Anda akan menggunakan board pengembangan yang kompatibel dengan Matter dan Matter SDK.
Cara termudah untuk memulai adalah dengan membaca codelab kami. Sebaiknya lakukan minimal salah satu codelab berikut:
Setelah itu, periksa daftar perangkat yang didukung untuk memastikan bahwa perangkat yang ingin Anda integrasikan didukung di ekosistem Google Home. Kemudian, baca Checklist Developer untuk memahami seluruh alur pengembangan dari pembuatan project hingga peluncuran.
Perangkat yang Didukung Checklist Developer
Definisi
Istilah berikut digunakan di seluruh dokumentasi ini:
- Router pembatas
- Hub yang mengimplementasikan Router Pembatas Thread tujuan umum untuk perangkat yang kompatibel dengan Thread.
- Penghubung
- Perangkat Google Nest yang didukung, seperti Google Nest Hub (2nd gen). Hub diperlukan untuk mengontrol perangkat yang kompatibel dengan Matter melalui platform lain seperti Assistant, GHA, dan layar smart.
- Perangkat yang kompatibel dengan Matter
- Perangkat atau board pengembangan yang telah di-flash dengan build atau aplikasi contoh yang mengaktifkan Matter.
- Perangkat seluler
- Ponsel pengujian yang digunakan untuk membantu penyambungan. Saat ini ini adalah ponsel Android.
Prasyarat
Untuk mengintegrasikan perangkat yang kompatibel dengan Matter sepenuhnya dengan ekosistem Google Home, developer harus memiliki:
- 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.
- 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
- ID Vendor (VID) dan ID Produk (PID) untuk perangkat yang kompatibel dengan Matter.
- Perangkat yang kompatibel dengan Matter. Perangkat ini harus merupakan salah satu
jenis perangkat Matter yang didukung di
ekosistem Google Home, dan dapat berupa:
- Produk Anda sendiri dengan firmware yang mengaktifkan Matter.
- Salah satu perangkat Matter berikut yang akan digunakan untuk verifikasi menyeluruh:
Vendor | Platform | Dukungan Thread | Panduan |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | Pengujian OTA | |
Nordic Semiconductor | nRF52840 DK | Pengujian OTA | |
NXP | Kit pengembangan IOTZTB-DK006 | ||
Realtek | Ameba Seri D | ||
Silicon Labs | Kit Pengembangan EFR32MG24 | ||
EFR32MG Zigbee dan Thread Starter Kit | |||
Telink | TLSR9518 | ||
Texas Instruments | Kit pengembangan LaunchPad CC2652R7 |
ID Vendor
Secara default, Anda dapat menggunakan salah satu VID yang dialokasikan oleh CSA untuk tujuan
pengujian. Pilih salah satu dari berikut:
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Untuk menggunakan VID Produksi agar integrasi Anda dapat disertifikasi dan diluncurkan, Anda harus memverifikasinya terlebih dahulu oleh Google untuk memastikan bahwa VID tersebut telah dikeluarkan kepada Anda oleh CSA.
VID ini harus diterapkan di firmware perangkat Anda.
Perangkat Matter hanya dapat disambungkan di 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 mengaktifkan perangkat harus menjadi anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
- Pengguna konsumen hanya dapat menggunakan produk Anda setelah disertifikasi oleh Alliance.
VID dan PID hanya dapat digunakan satu kali untuk satu integrasi. Jika ingin menggunakan VID atau PID yang sama dalam integrasi, Anda harus:
- Edit integrasi yang menggunakan VID atau PID ke VID atau PID yang berbeda.
- Hapus integrasi menggunakan VID atau PID.
Jenis pengguna mana yang dapat mengaktifkan perangkat ke dalam ekosistem Google Home? | |||
---|---|---|---|
Jenis VID | Status integrasi konsol dan sertifikasi VID | 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 dapat disertifikasi) | ||
Produksi | Tidak disertifikasi, integrasi tidak ada di Developer Console | ||
Produksi | Tidak disertifikasi, integrasi ada di Developer Console | ||
Produksi | Disertifikasi di DCL Alliance, integrasi tidak ada di Developer Console | ||
Produksi | Memiliki sertifikasi di DCL Alliance dan integrasi ada di Developer Console |
ID Produk
Informasi tentang perangkat dibaca dari Matter Basic Information Cluster. ID Produk yang dienkode dalam firmware perangkat Anda harus cocok dengan ID Produk integrasi Matter di Konsol Play.
Fitur yang tidak didukung
Beberapa cluster Matter belum ditampilkan kepada pengguna, meskipun cluster tersebut dapat digunakan oleh sistem. Pada umumnya, hal ini berarti atribut yang ditampilkan melalui cluster ini tidak terlihat oleh pengguna akhir:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ Lihat Tombol Lampu Aktif/Nonaktif untuk mengetahui pengaruhnya terhadap Tombol Lampu Aktif/Nonaktif.