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. Tujuan Test Suite adalah aplikasi terpisah yang dibangun dalam Developer Console yang menangani semua pengujian integrasi.

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

Test Suite dapat dijalankan pada kumpulan perangkat yang dimiliki konfigurasi project Matter tertentu. Sangatlah penting untuk menjalankan Test Suite pada integrasi Anda untuk memastikan semuanya berfungsi dengan benar.

Di halaman Test, Matter integrasi yang selesai dan siap diuji tercantum dalam Siap diuji.

Matter integrasi yang telah diuji tercantum di bagian Diuji.

Jenis rencana pengujian

Ada dua jenis rencana pengujian:

  • Rencana pengujian pengembangan digunakan untuk menguji perangkat pengontrol dengan Matter. Laporan dapat diedit, tetapi tidak dapat dikirim untuk sertifikasi Matter.

  • Rencana pengujian sertifikasi ditujukan khusus untuk Matter, dan tidak dapat diedit. Memilih opsi ini akan membuat versi baru dari Integrasi Matter.

Versi integrasi

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

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

Versi T/A dari suatu integrasi mewakili instance tanpa versi dari integrasi, yang dikelola di tab Develop.

Dengan kata lain, pada Matter > Uji di Developer Console:

  • Jika Anda mengklik Uji untuk versi T/A integrasi, versi baru akan dibuat. Nomor versi akan lebih tinggi satu 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 dibuat, dan seterusnya.
  • Jika Anda mengklik Test untuk versi integrasi bernomor (untuk misalnya, v.1), versi baru tidak akan dibuat. Sebaliknya, versi v.1 adalah diuji lagi.

Untuk mengetahui informasi selengkapnya, lihat Pembuatan versi integrasi.

Membuat rencana pengujian

Versi integrasi adalah ringkasan dari integrasi tanpa versi. Artinya ketika Anda membuat rencana pengujian untuk sertifikasi, dan dengan demikian semua metadata yang terkait dengan integrasi tersebut harus berupa informasi yang ingin digunakan untuk integrasi yang diluncurkan.

Sebelum membuat rencana pengujian untuk sertifikasi, pastikan Anda telah melakukan berikut ini:

  1. Membuat profil perusahaan.
  2. Memasukkan ID Vendor produksi (VID) untuk integrasi.
  3. Penyiapan dan branding yang dikonfigurasi.

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

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

Untuk membuat rencana pengujian:

Buka Konsol Play

  1. Dari daftar project, klik Buka di samping project yang ingin Anda kerjakan.

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

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

  4. Pilih jenis pengujian Uji pengembangan atau Uji sertifikasi. Membuat rencana pengujian baru

    • Pilih Ujian sertifikasi jika Anda sedang mempersiapkan diri untuk mengikuti sertifikasi ekosistem Google.
    • Pengujian pengembangan tidak dapat digunakan untuk sertifikasi.
  5. Klik Uji. Jika Anda mendapatkan layar kesalahan Tidak ditemukan, berarti perangkat untuk integrasi ini belum ditugaskan ke dalam ekosistem. Lihat Memecahkan masalah penyambungan untuk informasi selengkapnya.

  6. Di layar Configure your testing, berikan nama untuk pengujian Anda dan pilih perangkat yang ingin Anda uji dari daftar perangkat.

  7. Klik tombol Next: Test plan.

  8. Di halaman Create a test plan, di bagian Test suites, pilih suite pengujian yang ingin dijalankan.

Membuat rencana pengujian

Jika Anda ingin keluar dari Test Suite, klik Kembali ke Pengembang Google Workspace.

Menjalankan rencana pengujian

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

Hasil pengujian Anda akan muncul setelah pengujian selesai. Status setiap rangkaian pengujian eksekusi akan muncul di sebelahnya (Lulus, Gagal).

Panel Logs menampilkan status setiap eksekusi uji.

Hasil tes

Untuk menguji ulang rencana pengujian dari halaman Lingkungan pengujian, klik Tes ulang di bagian atas setelah eksekusi uji selesai.

Setelah selesai:

Melihat dan menafsirkan hasil pengujian Anda

Di halaman Histori pengujian pada Test Suite, Anda dapat melihat hasil pengujian sebelumnya untuk rencana pengembangan atau sertifikasi yang belum dikirimkan rencana pengujian dengan mengklik Uji ulang untuk rencana pengujian yang diinginkan di Rencana pengujian bagian. Tindakan ini akan mengarahkan Anda ke halaman Lingkungan Pengujian yang menampilkan hasil pengujian tersebut.

Histori pengujian

Untuk rencana sertifikasi yang dikirimkan, klik Hasil di bagian Disimpan untuk sertifikasi untuk melihat laporan hasil pengujian.

Hasil pengujian juga dapat diakses untuk versi integrasi dari tab Pengujian tab di Developer Console. Klik Lihat untuk Histori pengujian versi integrasi yang tercantum di halaman tersebut akan diarahkan ke Histori pengujian di Test Suite.

Status konsol

Status Konsol berikut ditemukan dalam fase Pengujian:

Section Status Deskripsi Persyaratan Apa langkah selanjutnya
Siap diuji Siap Versi integration ini siap diuji. T/A Uji versi integrationini.
Telah diuji Siap Versi integration ini telah diuji dan dapat dikirimkan untuk Uji Coba Lapangan atau sertifikasi.

Versi telah diuji dan disimpan.

Semua kasus pengujian yang gagal menyertakan justifikasi untuk ditinjau oleh Google.

Uji ulang, jika diinginkan.

Pemecahan masalah

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 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 mengetahui informasi selengkapnya tidak akurat atau tidak sesuai.

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 Developer Console Anda.

  • VID 0xFFF10xFFF4 dicadangkan untuk pengujian. Alat ini dapat digunakan untuk pengujian kontrol dan komisioning 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 beacon di kolom Service Data.

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.

Validasi bahwa nilai dan format yang tepat telah dimasukkan ke dalam project Actions Console Anda 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.