Lingkungan Pengembangan Perangkat Virtual Matter

SDK Perangkat

Matter Virtual Device Development Environment (MVD-DE) adalah container Docker tempat Anda dapat membuat Matter Virtual Device (MVD) dan menggunakan aplikasi desktop Virtual Device Controller (VDC) untuk menyediakan antarmuka pengguna grafis (GUI) guna mengontrol serta 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, mengirimkan permintaan yang mencerminkan tindakan Anda (mengalihkan daya, redupkan, cerahkan) dan 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 Aktif/Nonaktif
Kontrol Level
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
Pembicara Aktif/Nonaktif
Kontrol Level
Speaker
Ganti 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.

Jalankan 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 menegaskan bahwa konfigurasi penampung Anda sudah benar, dan akhirnya, perintah shell container:

    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 seri perangkat:

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

Jika Anda memulai VDC tanpa memberikan argumen, opsi ini akan ditetapkan secara default ke opsi soket jaringan menggunakan port localhost 33000.

Setelah dapat terhubung ke perangkat, 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 bagian dari alur commissioning perangkat. 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 melakukan commissioning pada perangkat Anda.

Hentikan Lingkungan Pengembangan Perangkat Virtual Matter

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

Masukan

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

Kirim masukan Anda kepada kami