Lingkungan Pengembangan Perangkat Virtual Matter

SDK Perangkat

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 visualisasi representasi perangkat virtual Anda, serta kontrol untuk Matter cluster yang didukung oleh perangkat.

Aplikasi menggunakan klien RPC untuk berkomunikasi dengan server RPC perangkat virtual, mengirimkan permintaan yang mencerminkan tindakan Anda (mengalihkan daya, redupkan, cerahkan) dan melakukan polling sekali setiap detik untuk mengambil status.

Perangkat yang didukung

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

Matter Jenis Perangkat Cluster Aplikasi Jenis Ekosistem Rumah
Sensor Kontak Status Boolean Sensor
Lampu yang Dapat Diredupkan Kontrol Level Aktif/Nonaktif
Ringan
Warna Terang yang Diperpanjang Aktif/Nonaktif
Kontrol Level
Kontrol Warna
Ringan
Sensor Aliran Pengukuran Aliran Sensor
Sensor Kelembapan Pengukuran Kelembapan Relatif Sensor
Sensor Penerangan Pengukuran Pencahayaan Sensor
Sensor Kehadiran Deteksi Kehadiran Sensor
Lampu Nyala/Nonaktif Aktif/Nonaktif Ringan
Stopkontak Aktif/Nonaktif
Kontrol Level
Outlet
Sensor Tekanan Pengukuran Tekanan Sensor
Speaker Aktif/Nonaktif
Kontrol Level
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 container, Anda akan melihat beberapa output diagnostik diikuti pesan yang menegaskan bahwa konfigurasi penampung Anda sudah benar, dan terakhir, prompt container shell:

    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, memulai VDC, dengan meneruskan argumen --s dan IP port yang digunakan oleh perangkat:

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

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

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

Jika Anda memulai VDC tanpa memberikan argumen apa pun, tindakan ini akan akan menetapkan opsi soket jaringan menggunakan {i>localhost port 33000<i}.

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

Antarmuka pengguna grafis Perangkat Virtual

Tampilkan kode QR perangkat

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

Pengontrol Perangkat Virtual menampilkan Kode QR perangkat

Anda dapat menggunakan kode QR ini untuk mengaktifkan perangkat.

Hentikan 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 agar kami dapat meningkatkan pengalaman terkait MVD-DE, lengkapi Formulir Masukan kami.

Kirimkan masukan Anda kepada kami