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 guna mengontrol dan menampilkan status perangkat Matter virtual Anda. Aplikasi memberikan representasi visual dari 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 (tombol 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
Cahaya yang Dapat Diredupkan Aktif/Nonaktif
Kontrol Level
Terang
Cahaya Warna Diperluas Aktif/Nonaktif
Kontrol Level
Kontrol Warna
Terang
Sensor Aliran Pengukuran Aliran Sensor
Sensor Kelembapan Pengukuran Kelembapan Relatif Sensor
Sensor Penerangan Pengukuran Pencahayaan Sensor
Sensor Kehadiran Deteksi Jumlah Tamu Sensor
Lampu Aktif/Nonaktif Aktif/Nonaktif Terang
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.

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 yang diikuti dengan pesan yang menegaskan bahwa konfigurasi penampung Anda sudah benar, dan terakhir, 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 --ddiikuti dengan port serial perangkat:

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

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

Setelah VDC dapat terhubung ke perangkat, perangkat akan menampilkan layar yang menunjukkan 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 image perangkat untuk menampilkan kode QR untuk perangkat ini:

Pengontrol Perangkat Virtual menampilkan Kode QR perangkat

Anda dapat menggunakan kode QR ini untuk memesan perangkat.

Menghentikan 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 Anda tentang cara kami dapat meningkatkan pengalaman Anda dengan MVD-DE, lengkapi Formulir Masukan kami.

Kirim masukan Anda kepada kami