Perangkat virtual Matter berguna untuk mengembangkan dan menguji solusi Matter, dan dapat ditugaskan menggunakan Google Home app (GHA), serta dikontrol menggunakan GHA dan Google Assistant, seperti perangkat Matter fisik.
Untuk developer aplikasi dan pengguna lain yang perlu menguji atau mengemulasi perangkat Matter virtual tetapi tidak memiliki resource untuk mem-build perangkat Matter fisik atau virtual mereka sendiri, Google menawarkan Matter Virtual Device (MVD). MVD adalah alat desktop Linux atau macOS mandiri ringan yang menyimulasikan berbagai jenis perangkat Matter virtual dan menyediakan antarmuka pengguna grafis untuk mengontrol dan menampilkan status perangkat Matter virtual.
Tidak seperti perangkat Matter fisik, MVD tidak bergantung pada Bluetooth® Low Energy (BLE) atau Thread® untuk menggabungkan fabric Matter. Sebagai gantinya, sistem akan menggunakan koneksi jaringan Wi-Fi yang sudah ada di komputer host Linux atau macOS untuk commissioning.
Dibandingkan dengan alat lain
MVD berbeda dengan Virtual Device Controller (VDC) karena merupakan solusi mandiri yang menggabungkan perangkat virtual dengan UI untuk mengontrolnya. Sebaliknya, VDC digunakan untuk mengontrol perangkat Matter virtual terpisah, seperti perangkat yang kita build di Matter Virtual Device Development Environment (MVD-DE).
Anda mungkin sudah pernah menggunakan codelab MVD-DE. Dalam codelab ini, Anda akan membuat satu jenis perangkat virtual, yaitu bohlam smart. Sebaliknya, MVD berisi beberapa perangkat virtual bawaan yang berbeda dan menyertakan UI terintegrasi untuk menjalankan dan mengontrolnya.
| MVD | VDC | MVD-DE (Codelab) | |
|---|---|---|---|
| Mengemulasi perangkat Matter | |||
| Mengontrol perangkat Matter yang diemulasi | |||
| Upaya pengembangan yang diperlukan | |||
| Download | kurang dari 100 MB | 9 GB | 20 GB |
Perangkat yang didukung
MVD mendukung jenis perangkat Matter berikut:
| Jenis Perangkat Matter | Cluster Aplikasi | Jenis Ekosistem Rumah |
|---|---|---|
| Pemutar Video Dasar |
0x0006 0x0506 0x0509 |
Tv |
| Warna Suhu Terang |
0x0300 0x0008 0x0006 |
Ringan |
| Sensor Kontak |
0x0045 |
Sensor |
| Lampu yang Dapat Diredupkan |
0x0008 0x0006 |
Ringan |
| Kunci Pintu |
0x0101 |
Kunci |
| Lampu Warna Tambahan |
0x0300 0x0008 0x0006 |
Ringan |
| Kipas |
0x0202 0x0006 |
Kipas |
| Sensor Aliran |
0x0404 |
Sensor |
| Tombol Generik |
0x003b |
Ganti |
| Sensor Kelembapan |
0x0405 |
Sensor |
| Sensor Pencahayaan |
0x0400 |
Sensor |
| Sensor Kehadiran |
0x0406 |
Sensor |
| Lampu Aktif/Nonaktif |
0x0008 0x0006 |
Ringan |
| Sakelar Lampu Aktif/Nonaktif |
0x0006 |
Ganti |
| Unit Plugin Aktif/Nonaktif |
0x0008 0x0006 |
Outlet |
| Sensor Tekanan |
0x0403 |
Sensor |
| Pompa |
0x0006 0x0200 0x0402 0x0403 0x0404 |
T/A |
| Penyedot Debu Robot |
0x0054 0x0055 0x0061 |
Penyedot Debu |
| AC Ruangan |
0x0006 0x0201 0x0202 |
Akun |
| Alarm Gas CO Asap |
0x005C |
Asap |
| Sensor Suhu |
0x0402 |
Sensor |
| Termostat |
0x0201 |
Termostat |
| Penutup Jendela |
0x0102 |
Trai |
Instal MVD
MVD berjalan di mesin prosesor x86 64-bit yang menjalankan Debian (11 atau yang lebih tinggi), Ubuntu (20.04 atau yang lebih baru), atau macOS.
Linux
Download paket MVD Debian (.deb)
Download file tanda tangan armored-ASCII (.asc)
Kemudian, jalankan dpkg untuk menginstal paket Debian (.deb) MVD:
sudo dpkg -i mvd_1.4.0_amd64.deb
macOS
Download file dmg MVD (macOS x86)
Download file dmg MVD (ARM64 M1)
Kemudian, klik dua kali file dmg untuk membuka jendela
penginstalan.
Untuk menyelesaikan penginstalan, pilih dan tarik ikon mvd ke
folder Applications:
Memeriksa penggunaan port
Modul pengontrol di MVD menggunakan port TCP 33000 untuk melakukan panggilan RPC ke perangkat virtual, jadi jika port ini sudah digunakan oleh proses lain di komputer Anda, pastikan untuk mengosongkannya.
Untuk melihat apakah proses menggunakan port 33000:
Linux
sudo fuser -v 33000/tcp
macOS
lsof -i:33000
Anda dapat mematikan proses apa pun menggunakan TCP port 33000 dengan satu perintah:
Linux
sudo fuser -k 33000/tcp
macOS
lsof -ti:33000 | xargs kill
Jalankan MVD
Linux
Di Linux, jalankan MVD dari folder aplikasi atau dari terminal:
mvd
macOS
Di macOS, gunakan Launchpad untuk membuka MVD atau menjalankan MVD dari terminal:
cd /Applicationsopen mvd.app
Mengonfigurasi perangkat
Layar utama akan muncul saat peluncuran, dan memungkinkan Anda mengonfigurasi perangkat virtual:
- Device Type: Pilih jenis perangkat (misalnya, Lampu, Tombol, Sensor dan sebagainya).
- Nama Perangkat: Beri perangkat nama yang mudah digunakan.
- Discriminator: Angka 12-bit yang digunakan untuk membedakan antara beberapa
iklan perangkat yang dapat ditugaskan. (Default:
3840). - Port Matter: Port untuk penugasan dan komunikasi Matter melalui jaringan IP. Matter menggunakan port TCP/UDP 5540 secara default, tetapi Anda dapat mengonfigurasi perangkat virtual untuk menggunakan port yang berbeda, selama tidak ada layanan lain yang menggunakannya.
- ID Vendor: Hanya ID vendor uji
0xFFF1yang didukung. - ID Produk: Hanya ID produk uji
0x8000hingga0x801Fyang didukung.
Konfigurasikan firewall Anda
Linux
Jika Anda memiliki firewall yang berjalan di komputer, matikan atau izinkan koneksi TCP/UDP masuk di port Matter.
Untuk melihat aturan firewall netfilter yang aktif saat ini, jalankan:
sudo iptables -L -n
Jika Anda menggunakan `ufw`, fitur ini dapat dinonaktifkan dengan:
sudo ufw disable
Dan dapat diaktifkan kembali dengan:
sudo ufw enable
macOS
Untuk mengonfigurasi atau menonaktifkan firewall di macOS:
- Buka menu Apple dan pilih System Settings.
- Klik Jaringan di daftar sidebar.
- Klik Firewall.
- Alihkan tombol untuk Firewall ke posisi Nonaktif.
Jalankan perangkat Anda
Setelah perangkat dikonfigurasi, klik Buat perangkat. Saat perangkat dibuat, layar Controller akan muncul. Bergantung pada jenis perangkat yang dipilih, Anda mungkin melihat satu atau beberapa kontrol berikut:
- Aktif/Nonaktif: Umum bagi sebagian besar perangkat.
- Level: Misalnya, lampu dapat memiliki penggeser level untuk menyesuaikan kecerahan.
- Warna: Misalnya, lampu warna dapat memiliki kontrol ini.
- Jumlah Tamu: Sensor Kehadiran menawarkan kontrol ini, untuk menyimulasikan status terisi atau tidak terisi.
Semua perangkat virtual memiliki kontrol berikut:
- QRCode: Menampilkan kode QR yang digunakan untuk commissioning.
- Reboot: Memulai ulang perangkat virtual. Perangkat terputus dari jaringan sebentar.
- Reset: Mereset perangkat saat ini ke setelan pabrik dan menghapus semua status, termasuk commissioning, status kontrol saat ini, dan sebagainya
- Delete: Memusnahkan perangkat dan kembali ke layar Create device.
Komisikan perangkat Anda
Perangkat dapat dipesan segera setelah dibuat.
Ada beberapa prasyarat untuk menugaskan perangkat:
Anda harus memiliki project di Google Home Developer Console. Project ini harus berisi integrasi Matter yang memiliki kombinasi VID/PID yang sama dengan yang digunakan untuk menyiapkan perangkat virtual Anda. Lihat panduan pembuatan project untuk mengetahui detailnya.
Anda harus memiliki Google Nest Hub yang mendukung Matter
Anda harus memiliki ponsel Android yang menjalankan Android 8.1 atau yang lebih baru, dengan GHA terinstal.
Ponsel Android harus terhubung ke jaringan Wi-Fi yang sama dengan hub.
Mesin host harus terhubung ke jaringan Wi-Fi.
Untuk menugaskan perangkat menggunakan GHA, klik QRCode untuk menampilkan kode QR perangkat, lalu ikuti petunjuk di Menyambungkan perangkat Matter yang menjelaskan cara mengaktivasi perangkat Matter menggunakan GHA. Anda juga dapat melakukan commissioning pada perangkat menggunakan Google Home Sample App for Matter.
Lihat Matter Primer kami untuk mempelajari cara kerja Komisi Matter.
Mengontrol perangkat
Setelah menugaskan perangkat virtual, Anda dapat mengontrol perangkat menggunakan Aplikasi Google Home atau Asisten Google dengan suara. Anda dapat:
- Kontrol perangkat melalui GHA atau Assistant sambil memantau perubahan status di perangkat virtual, atau
- Kontrol perangkat menggunakan Sample App for Matter sambil memantau perubahan status pada perangkat virtual,atau
- Mengontrol status perangkat melalui MVD itu sendiri sambil memantau perubahan status di GHA atau Assistant.
Menguji dengan perangkat
Untuk menguji dengan Assistant, sebaiknya gunakan simulator ucapan seperti Ekstensi Google Home untuk VS Code atau Plugin Google Home untuk Android Studio.
Lihat detail perangkat
Layar Detail perangkat menampilkan informasi perangkat mendetail:
- Nama: Nama umum yang diberikan ke perangkat.
- Device Type: Jenis perangkat yang dipilih.
- Discriminator: Diskriminator perangkat saat ini.
- ID Vendor: ID vendor perangkat saat ini.
- ID Produk: ID produk perangkat saat ini.
- Port RPC: Port RPC yang digunakan perangkat untuk berkomunikasi dengan pengontrol (GUI).
- Port Matter: Port yang digunakan oleh perangkat saat ini untuk berkomunikasi melalui jaringan IP.
- Kode Kartu: PIN yang digunakan untuk melakukan commissioning pada perangkat melalui jaringan.
- Configuration Folder: Folder tempat perangkat virtual menyimpan konfigurasi.
- Commission Information: Menunjukkan fabric yang dihubungkan perangkat dan ID node perangkat pada fabric.
Lihat log perangkat
Jika Anda meluncurkan MVD dari terminal, output log akan muncul
di stdout.
Anda juga dapat melihat log perangkat di tab Log perangkat.
Hentikan perangkat
Untuk menghentikan dan menghancurkan perangkat, klik Hapus.
Menghentikan aplikasi
Menutup jendela kontrol akan menghancurkan perangkat dan menghentikan aplikasi MVD. Jika diluncurkan dari terminal, Anda juga dapat menghentikan aplikasi dengan mengetik Ctrl-C di terminal.
Mendapatkan bantuan
Untuk mendapatkan bantuan terkait MVD, melaporkan bug, atau meminta fitur baru, hubungi kontak dukungan Google Anda.
Mengklik tombol bantuan di sudut kanan atas jendela akan membawa Anda ke halaman ini.
Laporkan bug
Jika Anda merasa telah menemukan kecacatan dalam MVD, Anda dapat melaporkan bug dengan mengklik tombol Masalah di pojok kanan atas jendela.
Kirim masukan
Untuk mengirimkan pendapat tentang hal yang Anda sukai dari MVD atau cara meningkatkan pengalaman Anda dengan alat ini, lengkapi Formulir Masukan kami.
Formulir dapat diluncurkan dari tombol masukan di sudut kanan atas jendela, atau dengan mengklik tombol di bawah ini.