Menguji integrasi Matter

Google Home Developer Console menyediakan halaman Test tempat Anda dapat mengonfigurasi dan menjalankan pengujian terhadap Matter integrasi menggunakan Google Home Test Suite. Test Suite adalah aplikasi terpisah yang terintegrasi ke dalam Developer Console yang menangani semua pengujian integrasi.

Perangkat untuk ID Vendor dan ID Produk integrasi harus diaktifkan dan tersedia di Google Home app (GHA) untuk akun yang digunakan dengan Developer Console agar dapat diuji. Lihat Memasangkan perangkat Matter device untuk mengetahui informasi selengkapnya.

Test Suite dapat dijalankan pada serangkaian perangkat yang termasuk dalam konfigurasi project Matter tertentu. Sangat penting untuk menjalankan Test Suite pada integrasi Anda guna memastikan semuanya berfungsi dengan benar.

Di halaman Test, integrasi Matter yang selesai dan siap diuji tercantum di bagian Ready to test.

Integrasi Matter yang telah diuji tercantum di bagian Tested.

Jenis paket pengujian

Jenis paket pengujian berikut tersedia:

• Paket pengujianDevelopment digunakan untuk menguji perangkat pengontrol menggunakanMatter. Paket ini dapat diedit, tetapi tidak dapat dikirimkan untuk Matter sertifikasi.

• Paket pengujian Certification khusus untuk Matter sertifikasi, dan tidak dapat diedit. Memilih opsi ini akan membuat versi baru integrasi MatterAnda.

• Paket pengujianCSA Interop memungkinkan Anda melewati tahap pengujian dan menggunakan hasil Connectivity Standards Alliance (Alliance) Interop Test Lab. Opsi pengujian ini tersedia untuk semua jenis perangkat yang didukung.

Gunakan Test Suite di Developer Console untuk mengirimkan hasil pengujian untuk sertifikasi. Jika Anda ingin menjalankan Test Suite untuk tujuan pengujian selama pengembangan, lihat halaman Google Home Test Suite untuk versi mandiri.

Versi integrasi

Saat Anda membuat paket pengujian untuk sertifikasi, versi baru integrasi akan dibuat. Versi bernomor ini tercantum di semua daftar integrasi di Developer Console mulai dari tab Test dan seterusnya.

Versi baru tidak pernah dibuat dari versi bernomor lainnya. Misalnya, paket pengujian pertama yang Anda buat untuk integrasi akan membuat versi v.1 untuk integrasi tersebut. Membuat paket pengujian lain akan membuat versi v.2 untuk integrasi tersebut, tetapi versi ini tidak akan didasarkan pada v.1. Sebagai gantinya, versi ini didasarkan pada instance integrasi yang tidak memiliki versi, sama seperti v.1.

Versi N/A integrasi mewakili instance integrasi yang tidak memiliki versi, yang dikelola di tab Develop.

Dengan kata lain, di Matter > Test di Developer Console:

• Jika Anda mengklik Test untuk integrasi versi N/A, versi baru akan dibuat. Nomor versi akan satu lebih tinggi dari versi bernomor yang ada.
  • Jika tidak ada versi bernomor, versi v.1 akan dibuat.
  • Jika versi v.1 ada, versi v.2 akan dibuat. Jika versi v.2 ada, versi v.3 akan dibuat, dan seterusnya.
• Jika Anda mengklik Test untuk integrasi versi bernomor (misalnya, v.1), versi baru tidak akan dibuat. Sebagai gantinya, versi v.1 akan diuji lagi.

Untuk mengetahui informasi selengkapnya, lihat Pembuatan versi integrasi.

Membuat paket pengujian

Versi integrasi adalah snapshot integrasi yang tidak memiliki versi. Artinya, saat Anda membuat paket pengujian untuk sertifikasi, dan dengan demikian versi integrasi, semua metadata yang terkait dengan integrasi tersebut harus berupa informasi yang ingin Anda gunakan untuk integrasi yang diluncurkan.

Sebelum membuat paket pengujian untuk sertifikasi, pastikan Anda telah melakukan hal berikut:

1. Membuat profil perusahaan.
2. Memasukkan ID Vendor (VID) produksi untuk integrasi.
3. Mengonfigurasi penyiapan dan branding.

Jika Anda belum menyelesaikan semua hal ini untuk integrasi, versi integrasi yang dibuat untuk pengujian sertifikasi tidak dapat disertifikasi. Anda harus membuat versi baru, yang berarti mengulang langkah Pengujian, Uji Lapangan, dan Sertifikasi.

Anda juga harus membuat versi baru dan memulai dari awal jika ingin memperbarui branding sebelum versi integrasi disertifikasi.

Untuk membuat paket pengujian:

Buka Konsol Developer

1. Dari daftar project, klik Open di samping project yang ingin Anda gunakan.

2. Di menu navigasi di sisi kiri halaman, buka Matter > Test.

3. Klik Test untuk integrasi versi N/A yang ingin Anda uji. Tindakan ini akan membuat versi integrasi baru.

4. Pilih jenis pengujian, lalu klik Test.

   • Pilih Certification test jika Anda bersiap untuk sertifikasi di ekosistem Google.
   • Development test tidak dapat digunakan untuk sertifikasi.
   • Pilih CSA Interop test untuk menggunakan hasil Alliance Interop Test Lab guna melewati tahap Pengujian dan Uji Lapangan dalam alur integrasi Matter.

5. Di layar Configure your test , berikan nama untuk pengujian Anda, lalu klik Automatically pair device untuk memilih perangkat yang akan dipasangkan.

   

   

   • Untuk perangkat Android:

     1. Pastikan Anda telah menginstal GHA ke ponsel.
     2. Hubungkan ponsel Anda dengan kabel USB ke mesin host.
     3. Anda harus Mengaktifkan proses debug USB di perangkat Anda The APK com.chip.interop.moblysnippet akan otomatis didownload dan diinstal.
     4. Setelah ponsel Anda terhubung, masukkan Pairing code dan Device name untuk memasangkan perangkat Anda secara otomatis.

   • Untuk perangkat iOS:

     1. Anda harus memasangkan perangkat secara manual. Lihat bagian Aplikasi Google Home untuk mengetahui petunjuk tentang cara memasangkan secara manual.
     2. Jika Anda memiliki perangkat yang ada, Anda mungkin akan diminta untuk melepaskan perangkat dan memasangkannya lagi atau memasangkan perangkat baru.

6. Klik tombol Next: Test plan.

7. Di halaman Create a test plan, di bagian Test suites, pilih test suite yang ingin Anda jalankan.

Jika Anda ingin keluar dari Test Suite, klik exit_to_app Kembali ke Developer Center.

Menjalankan paket pengujian

Di Test Suite, dari halaman Create a test plan, klik Run Test. Halaman Test environment akan muncul, dengan status dan log semua pengujian.

Hasil pengujian akan muncul setelah pengujian selesai. Status setiap eksekusi test suite akan muncul di sampingnya (Passed, Failed).

Panel Logs menampilkan status setiap eksekusi pengujian.

Untuk menguji ulang paket pengujian dari halaman Test environment, klik play_circle_filled Retest di bagian atas setelah eksekusi pengujian selesai.

Setelah selesai:

• Klik Done untuk membuka halaman Test history, atau
• Klik Submit untuk mengirimkan hasil pengujian untuk sertifikasi.

Melihat dan menafsirkan hasil pengujian

Di halaman Test history di Test Suite, Anda dapat melihat hasil pengujian sebelumnya untuk paket pengembangan atau sertifikasi yang belum dikirimkan dengan mengklik Retest untuk paket pengujian yang diinginkan di bagian Test plans. Tindakan ini akan membawa Anda ke halaman Test Environment yang menampilkan hasil pengujian tersebut.

Untuk paket sertifikasi yang dikirimkan, klik Results di bagian Saved for certification untuk melihat laporan hasil pengujian.

Hasil pengujian juga dapat diakses untuk versi integrasi dari tab Test di Developer Console. Klik View untuk Test history dari versi integrasi mana pun yang tercantum di halaman tersebut untuk membuka halaman Test history di Test Suite.

Status konsol

Status Konsol berikut ditemui dalam fase Pengujian:

Section	Status	Deskripsi	Persyaratan	Langkah selanjutnya
Siap diuji	Siap	Versi ini siap diuji. integration	T/A	Uji versi ini integration.
Diuji	Siap	Versi ini telah diuji dan dapat dikirimkan untuk Field Trial atau sertifikasi. integration	Versi telah diuji dan disimpan. Semua kasus pengujian yang gagal menyertakan justifikasi untuk ditinjau oleh Google.	Uji ulang, jika diinginkan.

Tes ulang

Sertifikasi

Jika Anda perlu menguji ulang untuk sertifikasi, Anda harus memasangkan perangkat setelah mulai menguji ulang.

Pengembangan

Jika Anda perlu menguji ulang untuk pengembangan, Anda dapat menggunakan perangkat yang ada tanpa memasangkan lagi.

Pemecahan masalah

Perangkat yang diaktifkan tidak muncul di Test Suite

Jika Anda telah memasangkan 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, kemungkinan hal ini disebabkan oleh penggunaan kombinasi VID dan PID pengujian yang sama di beberapa integrasi.

Untuk memecahkan masalah, hapus semua perangkat pengujian dari Developer Console dan pasangkan perangkat yang ingin Anda uji lagi.

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

Lihat Informasi perangkat untuk mengetahui informasi selengkapnya.

Memverifikasi VID/PID perangkat Anda

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

Nilai VID/PID yang di-beacon oleh perangkat Anda harus cocok dengan VID/PID yang dimasukkan ke dalam project Developer Console Anda.

• VID 0xFFF1 — 0xFFF4 dicadangkan untuk pengujian. VID ini dapat digunakan untuk pengujian pengaktifan dan kontrol dasar, tetapi tidak dapat digunakan selama fase pengembangan berikut:
  • Pengujian
  • Uji Lapangan
  • OTA

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

Dalam screenshot ini dari versi Android nRF Connect, Anda akan melihat VID/PID tercantum sebagai 5A23FFFE yang dimulai dari 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 Anda dalam big endian.

Validasi bahwa nilai dan format yang tepat telah dimasukkan ke dalam project Konsol Tindakan Anda berdasarkan apa yang ditampilkan oleh Bluetooth sniffer.

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