Mulai menggunakan Matter

Program Developer Home Google memungkinkan produsen perangkat menghubungkan perangkat smart home mereka dengan ekosistem Google Home. Kami memperluas jalur pemenuhan lokal Tindakan Smart Home 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 mulai membangun dan mengintegrasikan platform yang didukung Matter di ekosistem Google Home.

Pernyataan penyangkalan

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

  • Sebaiknya akun yang digunakan untuk pengembangan hanya memiliki satu hub yang kompatibel dengan 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 membangun dan mem-flash sampel Matter, yang telah diuji oleh Google. Meskipun perangkat macOS didukung, sebaiknya gunakan Linux. Petunjuk khusus Mac akan dipanggil dalam prosedur sesuai kebutuhan.

Cara membuat

Untuk membuat perangkat yang kompatibel dengan Matter yang terintegrasi dengan ekosistem Google Home, Anda akan menggunakan papan pengembangan yang kompatibel dengan Matter dan Matter SDK.

Cara termudah untuk memulai adalah dengan mempelajari codelab kami. Sebaiknya selesaikan minimal 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 Daftar Periksa Developer untuk memahami seluruh alur pengembangan dari pembuatan project hingga peluncuran.

Perangkat yang Didukung Daftar Periksa 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 papan 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 ini adalah ponsel Android.

Prasyarat

Ekstensi IDE yang direkomendasikan untuk pengembangan Matter

Untuk mengintegrasikan perangkat yang kompatibel dengan Matter secara penuh dengan ekosistem Google Home, developer harus memiliki:

  1. Hub Google dengan dukungan Thread untuk berfungsi sebagai Router Pembatas bagi perangkat yang mendukung Thread dan sebagai jalur fulfillment lokal untuk mengarahkan intent Smart Home.
  2. Perangkat seluler (ponsel pengujian) yang memenuhi persyaratan minimum:
    • Android O (8.1, level API 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 kompatibel dengan Matter.
  4. Perangkat yang kompatibel dengan Matter. Perangkat ini harus menjadi salah satu jenis perangkat Matter yang didukung diekosistem Google Home, dan dapat berupa:
    • Produk Anda sendiri dengan firmware yang mendukung Matter.
    • Salah satu perangkat Matter berikut untuk digunakan dalam verifikasi end-to-end:
Tabel: Matter contoh dari vendor semikonduktor
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 Seri Ameba D
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee and Thread Starter Kit
Telink TLSR9518
Texas Instruments Kit pengembangan CC2652R7 LaunchPad

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 memverifikasinya terlebih dahulu oleh Google untuk memastikan bahwa VID 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 skenario ID Vendor dan jenis perangkat tertentu.

  • VID pengujian tidak dapat digunakan di perangkat konsumen.
  • VID produksi Anda harus dikeluarkan 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 Field Trial, project dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. Pengguna yang melakukan aktivasi perangkat harus menjadi anggota project atau disertakan dalam daftar pengguna Field Trial.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah produk tersebut disertifikasi oleh Alliance.

VID dan PID hanya dapat digunakan satu kali untuk satu integrasi. Jika Anda ingin menggunakan VID atau PID yang sama dalam integrasi, Anda harus:

  • Edit integrasi menggunakan VID atau PID ke VID atau PID yang berbeda.
  • Hapus integrasi menggunakan VID atau PID.
Tabel: ID Vendor (VID) dan jenis perangkat skenario penyambungan
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 Field Trial)
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 di firmware perangkat Anda harus cocok dengan ID Produk integrasi Matter di Konsol Developer.

Fitur yang tidak didukung

Beberapa cluster Matter belum diekspos kepada pengguna, meskipun cluster tersebut dapat digunakan oleh sistem. Dalam sebagian besar kasus, hal ini berarti atribut yang diekspos 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.

¹ Lihat Sakelar Lampu On/Off untuk mengetahui pengaruhnya terhadap Sakelar Lampu On/Off.

Berikutnya
Checklist developer