Menguji integrasi Matter

Google Home Developer Console menyediakan halaman Test tempat Anda dapat mengonfigurasi dan menjalankan pengujian terhadap integrasi Matter menggunakan Google Home Test Suite. Test Suite adalah aplikasi terpisah yang di-build pada Developer Console yang menangani semua pengujian integrasi.

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

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

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

Integrasi Matter yang telah diuji dicantumkan di bagian Diuji.

Jenis rencana pengujian

Ada dua jenis rencana pengujian:

  • Rencana pengujian pengembangan digunakan untuk menguji pengontrolan perangkat menggunakan Matter. File tersebut dapat diedit, tetapi tidak dapat dikirim untuk sertifikasi Matter.

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

Versi integrasi

Saat Anda membuat rencana pengujian untuk sertifikasi, versi baru integrasi akan dibuat. Versi bernomor ini tercantum dalam semua daftar integrasi di Developer Console mulai dari tab Pengujian 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. Membuat rencana pengujian lain akan membuat versi v.2 untuk integrasi tersebut, 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 integrasi mewakili instance integrasi tanpa versi, yang dikelola di tab Develop.

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

  • Jika Anda mengklik Test untuk versi T/A integrasi, versi baru akan dibuat. Nomor versi akan 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 versi integrasi bernomor (misalnya, v.1), versi baru tidak akan dibuat. Sebagai gantinya, versi v.1 akan diuji lagi.

Untuk informasi selengkapnya, lihat Pembuatan versi integrasi.

Membuat rencana pengujian

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

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

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

Jika Anda belum menyelesaikan semua langkah tersebut untuk integrasi, versi integrasi yang dibuat untuk pengujian sertifikasi tidak dapat disertifikasi. Anda harus membuat versi baru, yang berarti mengulangi langkah-langkah Uji, Uji Coba Lapangan, dan Sertifikasi.

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

Untuk membuat rencana pengujian:

Buka Developer Console

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

  2. Pada menu navigasi di sisi kiri halaman, buka Matter > Pengujian.

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

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

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

  6. Pada layar Configure your test, berikan nama untuk pengujian dan pilih perangkat yang ingin diuji dari daftar perangkat.

  7. Klik tombol Berikutnya: Rencana pengujian.

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

Membuat rencana pengujian

Jika Anda ingin keluar dari Test Suite, klik Return to Developer Center.

Menjalankan rencana 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 Anda akan muncul setelah pengujian selesai. Status setiap eksekusi rangkaian pengujian muncul di sebelahnya (Lulus, Gagal).

Panel Logs menampilkan status setiap eksekusi uji.

Hasil tes

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

Setelah selesai:

Melihat dan menafsirkan hasil pengujian

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

Histori pengujian

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

Hasil pengujian juga dapat diakses untuk versi integrasi dari tab Test di Developer Console. Klik View untuk Test history versi integrasi apa pun yang tercantum di halaman tersebut agar diarahkan ke halaman Test history 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 uji 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 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 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.

Memverifikasi VID/PID perangkat

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

Memecahkan Masalah Bluetooth Sniffer

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

  • VID 0xFFF10xFFF4 disediakan untuk pengujian. Library ini dapat digunakan untuk pengujian uji coba 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, Anda akan melihat VID/PID dicantumkan sebagai 5A23FFFE mulai byte keempat kolom Service Data. Hal ini menunjukkan VID 5A23 dan PID FFFE — keduanya dalam format endian kecil.

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

Pastikan nilai dan format yang benar telah dimasukkan ke dalam project Konsol Actions berdasarkan apa yang ditampilkan sniffer Bluetooth.

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