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.

Halaman ini diterjemahkan oleh Cloud Translation API.

Switch to English

Pemecahan Masalah Matter

Membuat

Memastikan ponsel Anda kompatibel

Semua perangkat Android O (8.1, API level 27) dan yang lebih baru kompatibel dengan Matter. Ikuti langkah-langkah di bawah ini untuk memeriksa apakah ponsel Anda memiliki modul yang diperlukan.

Menyiapkan Android Debug Bridge

Android Debug Bridge (adb) harus disiapkan sebelum pemecahan masalah. Untuk menyiapkannya:

Instal "adb" di komputer.
Aktifkan Opsi Developer dan Proses Debug USB di ponsel Android Anda.

Memverifikasi modul Matter Layanan Google Play (GPS)

Untuk memeriksa apakah Anda memiliki modul Google Play services Matter, lakukan hal berikut:

Menyiapkan Android Debug Bridge.
Gunakan kabel USB untuk menghubungkan ponsel Android ke komputer Anda.
Jalankan perintah ini di terminal untuk memverifikasi bahwa modul Matter yang diperlukan telah diinstal:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
  
```
Jika Anda melihat output yang mirip dengan di bawah, berarti Anda telah menginstal modul Matter:
```
com.google.android.gms.home [v222110900]
```
Perhatikan bahwa nomor versi di atas mungkin berbeda dari perangkat Anda.
Jalankan perintah ini di terminal untuk memverifikasi bahwa modul Thread yang diperlukan telah diinstal:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
  
```
Jika Anda melihat output yang mirip dengan di bawah, berarti Anda telah menginstal modul Thread:
```
com.google.android.gms.threadnetwork [v222106301]
```
Perhatikan bahwa nomor versi di atas mungkin berbeda dari perangkat Anda.

Jika modul tidak tercantum, berarti:

Anda memiliki versi Android yang sudah tidak berlaku. Pastikan formatnya adalah Android O (8.1) atau yang lebih tinggi.
Modul Matter belum didownload. Tunggu setidaknya 24 jam untuk mendownload. Pastikan perangkat Anda menyala dan mengisi daya selama waktu tersebut, sehingga download tidak tertunda. Jika Anda belum menerima modul dalam waktu 24 jam, Anda dapat mencoba reset ke setelan pabrik pada perangkat untuk memaksa modul mendownload.

Verifikasi VID/PID perangkat Anda

Jika ingin mulai mengembangkan integrasi dengan Google, Anda harus membuat project dan integrasi di Konsol Google Home.

Memecahkan Masalah Sniffer Bluetooth

Nilai VID/PID perangkat beaconing Anda harus cocok dengan VID/PID yang dimasukkan ke project Google Home Developer Console Anda.

VID 0xFFF1 — 0xFFF4 dicadangkan untuk pengujian. Ini dapat digunakan untuk pengujian dasar dan pengujian dasar, tetapi tidak dapat digunakan selama fase pengembangan berikut:

Dengan menggunakan aplikasi engineering Bluetooth seperti nRF Connect for Mobile, Anda dapat melihat VID/PID perangkat beaconing di kolom Service Data.

Dalam screenshot dari nRF Connect versi Android, Anda akan melihat VID/PID tercantum sebagai 5A23FFFE mulai dari byte keempat dari kolom Service Data. Hal ini menunjukkan VID 5A23 dan PID FFFE — keduanya dalam sedikit format endian.

Aplikasi BLE menampilkan nilai dalam sedikit endian, tetapi nilai VID/PID yang Anda masukkan ke dalam project Developer Console Anda dalam big endian.

Validasi bahwa nilai dan format yang tepat telah dimasukkan ke project Konsol Action berdasarkan sniffer Bluetooth yang ditampilkan.

Untuk nilai dalam screenshot contoh, VID dan PID di Developer Console masing-masing akan menjadi 235A dan FEFF.

Catatan: VID 235A tidak boleh lagi digunakan dalam project Anda dan digunakan di sini sebagai ilustrasi. Pastikan Anda menggunakan VID sesuai dengan Spesifikasi Matter, atau salah satu VID pengujian seperti yang disebutkan di halaman Membuat integrasi Matter.

Verifikasi bahwa perangkat Anda dibuat menggunakan cabang Matter SDK yang kompatibel

Hub Matter Google saat ini kompatibel dengan Matter 1.0 dan telah diuji dengan build yang menggunakan commit dari cabang stabil v1.0-branch. Periksa Catatan rilis publik untuk mengetahui commit tertentu yang direkomendasikan untuk digunakan pada setiap rilis hub baru.

Penyambungan

Memverifikasi kredensial untuk perangkat Anda

Saat menggunakan VID yang ditetapkan Alliance sendiri, pastikan Anda memiliki kredensial yang benar di perangkat:

Pernyataan Sertifikasi (CD).
Sertifikat Pengesahan Perangkat (DAC) dan rantai sertifikatnya.

Untuk informasi selengkapnya, lihat Membuat sertifikat pengujian perangkat Matter.

Memverifikasi Hub yang kompatibel dengan Matter

Hub Matter Anda harus merupakan salah satu hub yang didukung oleh Google. Versi ini juga harus ada di build yang kompatibel dengan Matter.

Beberapa hub juga merupakan Router Pembatas Thread sehingga memungkinkan Anda mengembangkan dan menguji perangkat Thread. Hub lain hanya mendukung perangkat Wi-Fi dan Ethernet Matter, kecuali jika Anda memiliki router pembatas lain di jaringan Anda untuk mengaktifkan konektivitas Thread.

Build hub Anda dapat diverifikasi dengan: Geser jari ke bawah dari tepi atas > Roda Konfigurasi > Informasi Perangkat > Informasi teknis > Versi firmware Chromecast

Komisi gagal dengan pesan error "Tidak dapat menghubungi Google"

Pastikan Anda telah membuat integrasi dengan kombinasi VID/PID yang benar di Developer Console. Lihat Membuat integrasi Masalah untuk informasi selengkapnya.

Komisi gagal dengan pesan error "Tidak dapat menjangkau perangkat"

Jika Anda terus mendapatkan pesan error "Tidak dapat menjangkau perangkat" saat memesan perangkat Thread, dan telah menghabiskan semua opsi debug yang tersedia, sebaiknya hapus kredensial Thread yang disimpan di ponsel Android untuk penyiapan yang bersih melalui Setelan > Aplikasi > Aplikasi Aplikasi > Layanan Google Play > Penyimpanan & cache > Kelola ruang > HAPUS SEMUA DATA.

Pengujian

Perangkat yang dipesan tidak muncul di Test Suite

Jika Anda telah menyambungkan perangkat dengan ID Vendor pengujian (VID) dan ID Produk (PID), tetapi perangkat tidak muncul saat Anda mencoba menguji perangkat dengan Test Suite di Developer Console, hal ini kemungkinan disebabkan oleh penggunaan kombo VID dan PID pengujian yang sama di beberapa integrasi.

Untuk memecahkan masalah, hapus semua perangkat pengujian dari Developer Console dan sambungkan perangkat yang ingin diuji lagi.

Untuk memvalidasi bahwa Anda telah menyambungkan perangkat yang benar, Anda dapat menetapkan informasi Produsen dan Model (nilai CHIP_DEVICE_CONFIG_DEVICE_*) untuk perangkat ke nilai unik dalam firmware pengujian.

Lihat Informasi perangkat untuk mengetahui informasi selengkapnya.

Jika masih terjadi masalah

Jika setelah mengikuti semua langkah pemecahan masalah di sini, masalah Anda masih belum teratasi. Tidak masalah.

Di langkah pemecahan masalah, Anda telah mengumpulkan data penting tentang perangkat, project konsol, dan lingkungan. Dengan data tersebut, periksa halaman Dukungan, untuk mengetahui cara terbaik menyampaikan masalah Anda kepada komunitas dan tim dukungan Google Home.