Pemecahan Masalah Matter

Gedung

Verifikasi bahwa ponsel Anda kompatibel

Semua perangkat Android O (8.1, API level 27) dan yang lebih baru kompatibel dengan Matter. Ikuti langkah-langkah di bawah 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" pada komputer.
  2. Mengaktifkan Opsi Developer dan USB Proses debug di ponsel Android Anda.

Memverifikasi modul Matter Layanan Google Play (GPS) Anda

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

  1. Menyiapkan Android Debug Bridge.
  2. Gunakan kabel USB untuk menghubungkan ponsel Android ke komputer Anda
  3. Jalankan perintah ini di terminal untuk memverifikasi bahwa ID Matter modul 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 ini, Anda memiliki Matter modul diinstal: 
    com.google.android.gms.home [v222110900]
    Perhatikan bahwa nomor versi di atas mungkin berbeda dari perangkat Anda.
  4. Jalankan perintah ini di terminal untuk memverifikasi bahwa ID Thread modul 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 dalam contoh berikut, Anda memiliki Thread modul diinstal: 
    com.google.android.gms.threadnetwork [v222106301]
    Perlu diperhatikan bahwa nomor versi di perangkat Anda mungkin berbeda.

Jika modul tidak tercantum, artinya:

  1. Anda memiliki versi Android yang sudah tidak berlaku. Pastikan untuk Android O (8.1) atau yang lebih tinggi.
  2. Modul Matter belum didownload. Tunggu setidaknya 24 jam untuk diunduh. Pastikan perangkat dinyalakan dan mengisi daya selama waktu ini, agar download tidak tertunda. Jika Anda belum menerima modul dalam waktu 24 jam, Anda dapat mencoba {i>factory reset<i} perangkat untuk memaksa modul mengunduh.

Log perangkat hub Fuchsia

Guna mengaktifkan hub untuk pengambilan log lokal:

  1. Kirim email dengan Nomor Seri dan Model perangkat Anda ke Google Technical Account Manager (TAM). Tombol 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. Temukan Versi Fuchsia: Di Google Nest Hub (2nd gen), buka Informasi perangkat > Informasi teknis > Versi Fuchsia
      4. Ketuk "Versi Fuchsia" 7 kali. Tindakan ini akan mengaktifkan opsi developer,
      5. Kembali ke menu tingkat teratas
      6. Ketuk "Opsi developer"
      7. Ketuk "Partner Logging"
    • Fitur tersebut 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 menampilkan halaman detail perangkat
      2. Ketuk ikon Setelan untuk memunculkan halaman pengaturan
      3. Temukan alamat IP perangkat: buka Perangkat informasi > Informasi teknis > Alamat IP
  4. Untuk mengambil log dari hub, Anda perlu 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 dapat tetap terbuka selama satu menit, tetapi data yang diambil dari buffer biasanya memiliki 20-30 menit peristiwa terakhir.
      • Idealnya, log diekstrak menggunakan metode ini segera setelah menyelesaikan prosedur pengujian untuk memastikan buffer berisi konten yang relevan dengan pengujian (mirip dengan laporan bug Android).

Nonaktifkan penyamaran Log Android

  • Untuk privasi & keamanan, fitur ini sebaiknya hanya digunakan untuk tujuan pengujian teknis.
  • Jangan gunakan opsi ini dengan pengguna atau perangkat produksi.
  • Langkah:
    1. Kirim Akun Google pengguna yang memiliki log yang tidak tersunting 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 Bluetooth Sniffer

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

  • VID 0xFFF1 — 0xFFF4 dicadangkan untuk pengujian. Mereka dapat digunakan untuk uji commissioning dan kontrol dasar, tetapi tidak dapat digunakan fase pengembangan berikut:

Menggunakan aplikasi rekayasa Bluetooth seperti nRF Connect for Mobile, Anda dapat melihat VID/PID perangkat beaconing di kolom Data Layanan.

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

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

Pastikan nilai dan format yang tepat telah dimasukkan ke Action Anda Project konsol berdasarkan apa yang ditampilkan oleh sniffer Bluetooth.

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

Memastikan 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 stabil v1.0-branch. Periksa Rilis publik catatan untuk commit tertentu yang direkomendasikan untuk digunakan dengan setiap rilis hub baru.

Menyambungkan

Verifikasi kredensial untuk perangkat Anda

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

  • Pernyataan Sertifikasi (CD).
  • Device Attestation Certificate (DAC) dan rantai sertifikatnya.

Untuk mengetahui informasi selengkapnya, lihat Membuat pengujian perangkat Matter sertifikat.

Memverifikasi Hub yang kompatibel dengan Matter

Hub Matter Anda harus merupakan salah satu hub yang didukung oleh Google. Iklan juga harus berada di build kompatibel dengan Matter.

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

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

Commissioning gagal dengan pesan "Tidak dapat menghubungi Google" pesan error

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

Commissioning gagal dengan pesan "Tidak dapat menjangkau perangkat" pesan error

Jika Anda terus mendapatkan pesan "Tidak dapat menjangkau perangkat" saat melakukan commissioning sebuah Thread perangkat, dan telah menghabiskan semua debug yang tersedia Anda dapat menghapus Thread pilihan yang disimpan kredensial aplikasi di ponsel Android untuk penyiapan yang mudah melalui Setelan > Aplikasi > Aplikasi Aplikasi &gt; 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 keterangan tidak muncul saat Anda mencoba menguji perangkat dengan Suite di Developer Console, hal ini mungkin disebabkan oleh menggunakan 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 memasangkan produk yang benar, Anda dapat menyetel Produsen dan Informasi model (nilai CHIP_DEVICE_CONFIG_DEVICE_*) untuk perangkat nilai unik dalam firmware pengujian Anda.

Lihat Informasi perangkat untuk mengetahui informasi selengkapnya tidak akurat atau tidak sesuai.

Jika masih terjadi kesalahan

Jika setelah mengikuti semua langkah pemecahan masalah di sini masalah Anda masih belum diselesaikan, tidak masalah!

Dalam langkah-langkah pemecahan masalah telah mengumpulkan data penting tentang perangkat Anda, project konsol, dan lingkungannya. Setelah memiliki data tersebut, periksa Halaman Dukungan, untuk mengetahui cara terbaik berbagi masalah Anda dengan komunitas dan tim dukungan Google Home.