Lingkungan Pengembangan Perangkat Virtual Matter

Device SDK

Matter Virtual Device Development Environment (MVD-DE) adalah penampung Docker tempat Anda dapat membuat Matter Virtual Device (MVD) dan menggunakan aplikasi desktop Virtual Device Controller (VDC) untuk menyediakan antarmuka pengguna grafis guna mengontrol dan menampilkan status perangkat Matter virtual Anda. Aplikasi ini memberikan representasi visual perangkat virtual Anda, serta kontrol untuk cluster Matter yang didukung oleh perangkat.

Aplikasi menggunakan klien RPC untuk berkomunikasi dengan server RPC perangkat virtual, mengirim permintaan yang mencerminkan tindakan Anda (mengaktifkan daya, meredupkan, mencerahkan) dan melakukan polling sekali setiap detik untuk mengambil status.

Perangkat yang didukung

Saat ini, MVD-DE mendukung jenis perangkat Matter berikut:

Matter Jenis Perangkat Cluster Aplikasi Jenis Ekosistem Rumah
Sensor Kontak Status Boolean Sensor
Lampu yang Dapat Diredupkan Kontrol Level
Aktif/Nonaktif
Ringan
Lampu Warna yang Diperluas Aktif/Nonaktif
Kontrol Level
Kontrol Warna
Ringan
Sensor Aliran Pengukuran Aliran Sensor
Sensor Kelembapan Pengukuran Kelembapan Relatif Sensor
Sensor Pencahayaan Pengukuran Pencahayaan Sensor
Sensor Kehadiran Deteksi Kehadiran Sensor
Lampu Aktif/Nonaktif Aktif/Nonaktif Ringan
Stopkontak Kontrol Level
Aktif/Nonaktif
Outlet
Sensor Tekanan Pengukuran Tekanan Sensor
Speaker Kontrol Level
Aktif/Nonaktif
Speaker
Alihkan Aktif/Nonaktif Ganti
Sensor Suhu Pengukuran Suhu Sensor

Menyiapkan Lingkungan Pengembangan Perangkat Virtual Matter

MVD-DE adalah image Docker yang telah dikonfigurasi sebelumnya dan tersedia di Docker Hub. Untuk menginstalnya, jalankan:

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

Penyelesaian operasi ini mungkin memerlukan waktu beberapa menit.

Menjalankan Lingkungan Pengembangan Perangkat Virtual Matter

  1. Mulai container Docker:

    user@host> xhost local:1000
    user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
    

    Setelah memulai penampung, Anda akan melihat beberapa output diagnostik diikuti dengan pesan yang mengonfirmasi bahwa konfigurasi penampung Anda sudah benar, dan akhirnya, perintah shell penampung:

    Environment looks good, you are ready to go!
    
  2. Buat instance sesi terminal kedua:

    user@host> docker exec -it matter-container /bin/bash
    
  3. Untuk perangkat Matter virtual, setelah perangkat berjalan, mulai VDC, dengan meneruskan argumen --s dan port IP yang digunakan oleh perangkat:

    $ electron main.js --s=localhost:33000
    

    Untuk perangkat fisik, mulai VDC, dengan meneruskan argumen --d diikuti dengan port serial perangkat:

    $ electron main.js --d=/dev/ttyUSB0
    

Jika Anda memulai VDC tanpa memberikan argumen apa pun, VDC akan menggunakan opsi soket jaringan secara default menggunakan port localhost 33000.

Setelah dapat terhubung ke perangkat Anda, VDC akan menampilkan layar yang menampilkan status perangkat Anda:

Antarmuka pengguna grafis Perangkat Virtual

Menampilkan kode QR perangkat

VDC juga dapat digunakan untuk mengambil kode QR sebagai bagian dari alur commissioning perangkat Anda. Klik ikon kode QR di samping gambar perangkat untuk menampilkan kode QR untuk perangkat ini:

Virtual Device Controller yang menampilkan Kode QR perangkat

Anda dapat menggunakan kode QR ini untuk mengaktifkan perangkat.

Menghentikan Lingkungan Pengembangan Perangkat Virtual Matter

Untuk menghentikan MVD-DE, tekan Control-Q dengan layar VDC dalam fokus, atau tekan Control-C dalam sesi terminal tempat Anda memulai aplikasi.

Masukan

Untuk mengirimkan pendapat atau masukan tentang cara kami dapat meningkatkan pengalaman Anda dengan MVD-DE, lengkapi Formulir Masukan kami.

Kirim masukan Anda kepada kami