Perhatian! Program Pratinjau Developer yang baru akan segera diluncurkan. Daftar di sini dan jadilah salah satu developer pertama yang mencoba alat baru serta berikan masukan.

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

Aplikasi ini menggunakan klien RPC untuk berkomunikasi dengan server RPC perangkat virtual, mengirim permintaan yang mencerminkan tindakan Anda (beralih 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
Cahaya yang Dapat Diredupkan Kontrol Level Aktif/Nonaktif
Terang
Cahaya Warna Diperpanjang Aktif/Nonaktif
Kontrol Level
Kontrol Warna
Terang
Sensor Aliran Pengukuran Alur Sensor
Sensor Kelembapan Pengukuran Kelembapan Relatif Sensor
Sensor Iluminasi Pengukuran Iluminasi Sensor
Sensor Jumlah Tamu Deteksi Kehadiran Sensor
Lampu Nyala/Mati Aktif/Nonaktif Terang
Stopkontak Kontrol Level Aktif/Nonaktif
Stopkontak
Sensor Tekanan Pengukuran Tekanan Sensor
Speaker Kontrol Level Aktif/Nonaktif
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 yang tersedia di Docker Hub. Untuk menginstalnya, jalankan:

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

Operasi ini mungkin memerlukan waktu beberapa menit hingga selesai.

Menjalankan Lingkungan Virtual Device Development 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 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 --d diikuti dengan port serial perangkat:

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

Jika Anda memulai VDC tanpa memberikan argumen, setelan defaultnya akan menjadi default menggunakan port localhost 33000.

Setelah VDC dapat terhubung ke perangkat, layar akan 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 komisi perangkat Anda. Klik ikon kode QR di samping gambar perangkat untuk menampilkan kode QR perangkat ini:

Pengontrol Perangkat Virtual yang menampilkan Kode QR perangkat

Anda dapat menggunakan kode QR ini untuk membuat perangkat Anda.

Menghentikan Lingkungan Matter Virtual Device Development

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

Masukan

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

Kirimkan masukan Anda