Pemecahan Masalah Matter

Gedung

Verifikasi apakah 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:

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

Memverifikasi modul Matter Layanan Google Play (GPS) Anda

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

  1. Siapkan Android Debug Bridge.
  2. Gunakan kabel USB untuk menghubungkan ponsel Android ke komputer.
  3. 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 melihat output yang mirip dengan yang di bawah ini, berarti Anda telah menginstal modul Matter: 
    com.google.android.gms.home [v222110900]
    Perhatikan bahwa nomor versi di atas mungkin berbeda dengan perangkat Anda.
  4. 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 contoh berikut, berarti Anda telah menginstal modul Thread: 
    com.google.android.gms.threadnetwork [v222106301]
    Perhatikan bahwa nomor versi di perangkat Anda mungkin berbeda.

Jika modul tidak tercantum, berarti:

  1. Anda memiliki versi Android yang sudah tidak berlaku. Pastikan Android O (8.1) atau yang lebih tinggi.
  2. Modul Matter belum didownload. Tunggu minimal 24 jam agar file didownload. Pastikan perangkat dinyalakan dan mengisi daya selama waktu ini, agar download tidak tertunda. Jika belum menerima modul dalam waktu 24 jam, Anda dapat mencoba mereset perangkat ke setelan pabrik untuk memaksa modul didownload.

Log perangkat hub Fuchsia

Untuk mengaktifkan hub pengambilan log lokal:

  1. Kirim email yang berisi Nomor Seri dan Model perangkat Anda ke Google Technical Account Manager (TAM). File tersebut dapat ditemukan dalam huruf kecil di bawah perangkat.
  2. Setelah diizinkan, Anda harus mengaktifkan fitur ini dengan mengikuti langkah-langkah berikut:
    • Dari hub:
      1. Geserkan jari pada layar dari atas ke bawah
      2. Ketuk ikon Setelan
      3. Menemukan Versi Fuchsia: Di Google Nest Hub (2nd gen), buka Device information > Technical information > Fuchsia Version
      4. Ketuk "Fuchsia Version" 7 kali. Ini akan mengaktifkan opsi developer
      5. Kembali ke menu tingkat atas
      6. Ketuk "Opsi developer"
      7. Ketuk "Pencatatan Log Partner"
    • Fitur ini akan diaktifkan selama 24 jam. Setelah itu, aktifkan kembali fitur logging dari langkah 5 dan seterusnya.
  3. Dapatkan alamat IP hub Anda:
    • Dari hub, jika memiliki layar:
      1. Geserkan jari pada layar dari atas ke bawah
      2. Ketuk ikon Setelan
      3. Menemukan alamat IP perangkat: Di Nest Hub (2nd gen), buka Informasi perangkat > Informasi teknis > Alamat IP
    • Dari Google Home app (GHA) di ponsel Anda:
      1. Ketuk perangkat untuk memunculkan halaman detail perangkat
      2. Ketuk ikon Setelan untuk memunculkan halaman setelan
      3. Temukan alamat IP perangkat: buka Informasi perangkat > Informasi teknis > Alamat IP
  4. Untuk mengambil log dari hub, Anda akan membuat permintaan HTTP GET ke hub dari komputer di jaringan Wi-Fi yang sama.
    • Perhatikan port dan jalur endpoint: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • Koneksi hanya dapat dibiarkan terbuka selama satu menit, tetapi data yang diambil dari buffer biasanya memiliki 20-30 menit peristiwa terdahulu.
      • Idealnya, log diekstrak menggunakan metode ini segera setelah menyelesaikan prosedur pengujian untuk memastikan buffer berisi konten yang relevan dengan pengujian (serupa dengan laporan bug Android).

Menonaktifkan penyamaran Log Android

  • Untuk privasi & keamanan, fitur ini hanya boleh digunakan untuk tujuan pengujian engineering.
  • Jangan gunakan opsi ini dengan pengguna atau perangkat produksi.
  • Langkah-langkah:
    1. Kirim Akun Google pengguna yang tidak akan tersunting log ke Google TAM Anda.
    2. Setelah mengonfirmasi bahwa akun Anda ditambahkan ke daftar yang diizinkan, mulai ulang ponsel.

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 beaconing perangkat Anda harus cocok dengan VID/PID yang dimasukkan ke project Google Home Developer Console Anda.

  • VID 0xFFF1 — 0xFFF4 dicadangkan untuk pengujian. Class ini dapat digunakan untuk pengujian komisi dan kontrol 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 ini, Anda akan melihat VID/PID tercantum sebagai 5A23FFFE, mulai dari byte keempat kolom Service Data. Nilai ini menunjukkan VID 5A23 dan PID FFFE — keduanya dalam format endian kecil.

Aplikasi BLE menampilkan nilai dalam endian kecil, tetapi nilai VID/PID yang Anda masukkan ke dalam project Developer Console berada di endian besar.

Pastikan nilai dan format yang tepat telah dimasukkan ke dalam project Konsol Action Anda berdasarkan apa yang ditampilkan sniffer Bluetooth.

Untuk nilai dalam screenshot contoh, VID dan PID di Developer Console berturut-turut adalah 235A dan FEFF.

Memverifikasi bahwa perangkat Anda dibuat menggunakan cabang Matter SDK yang kompatibel

Hub Matter Google kompatibel dengan Matter 1.0 dan telah diuji dengan build yang menggunakan commit dari cabang v1.0-branch yang stabil. Lihat Catatan rilis publik untuk mengetahui commit tertentu yang direkomendasikan untuk digunakan dengan 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 mengetahui informasi selengkapnya, lihat Membuat sertifikat pengujian perangkat Matter.

Verifikasi Hub yang kompatibel dengan Matter

Hub Matter Anda harus berupa salah satu hub yang didukung oleh Google. SDK tersebut juga harus berada 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 Matter Wi-Fi dan Ethernet, kecuali jika Anda memiliki router pembatas lain di jaringan Anda untuk mengaktifkan konektivitas Thread.

Versi 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 Matter untuk mengetahui informasi selengkapnya.

Commissioning 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 pilihan yang tersimpan di ponsel Android untuk penyiapan bersih melalui Setelan > Aplikasi > Aplikasi Aplikasi' > Layanan Google Play > Penyimpanan & cache > Kelola ruang > HAPUS SEMUA DATA.

Pengujian

Perangkat yang ditugaskan tidak muncul di Test Suite

Jika Anda telah menyambungkan perangkat dengan ID Vendor (VID) dan ID Produk (PID) pengujian, tetapi perangkat tersebut 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 Anda uji lagi.

Untuk memvalidasi bahwa Anda telah menyambungkan 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 informasi selengkapnya.

Jika masih ada yang salah

Jika setelah mengikuti semua langkah pemecahan masalah di sini, masalah Anda masih belum terselesaikan, tidak masalah.

Dalam langkah-langkah pemecahan masalah, Anda telah mengumpulkan data penting tentang perangkat, project konsol, dan lingkungan. Setelah memiliki data tersebut, lihat halaman Dukungan, untuk mengetahui cara terbaik menyampaikan masalah Anda kepada komunitas dan tim dukungan Google Home.