Matter Sanal Cihazı Geliştirme Ortamı

Cihaz SDK'sı

Matter Virtual Device Development Environment (MVD-DE), Matter Virtual Device (MVD)'unuzu oluşturabileceğiniz ve sanal Matter cihazlarınızın durumlarını kontrol edip görüntülemek için grafik kullanıcı arayüzü sağlamak üzere Virtual Device Controller (VDC) masaüstü uygulamasını kullanabileceğiniz bir Docker kapsayıcısıdır. Uygulama, sanal cihazınızın görsel bir temsilinin yanı sıra cihaz tarafından desteklenen Matter kümelerinin kontrollerini sağlar.

Uygulama, sanal cihazın RPC sunucusuyla iletişim kurmak için bir RPC istemcisi kullanır. İşlemlerinizi yansıtan istekler (gücü açma/kapatma, parlaklığı azaltma/arttırma) gönderir ve durumu almak için saniyede bir kez anket yapar.

Desteklenen cihazlar

MVD-DE şu anda aşağıdaki Matter cihaz türlerini desteklemektedir:

Matter Cihaz Türü Uygulama Kümeleri Ev Ekosistemi Türü
Temas Sensörü Boole Durumu Sensor
Karartılabilir Işık Açma/kapatma
Seviye kontrolü
Hafif
Genişletilmiş Renk Işığı Açma/kapatma
Seviye Kontrolü
Renk Kontrolü
Hafif
Akış Sensörü Akış Ölçümü Sensor
Nem Sensörü Bağıl Nem Ölçümü Sensor
Aydınlık Sensörü Aydınlık Ölçümü Sensor
Doluluk Sensörü Doluluk Algılama Sensor
Açma/kapatma ışığı Açık/Kapalı Hafif
Priz Açma/kapatma
Seviye kontrolü
Outlet
Basınç Sensörü Basınç Ölçümü Sensor
Hoparlör Açma/kapatma
Seviye kontrolü
Hoparlör
Geçiş yap Açık/Kapalı Geç
Sıcaklık Sensörü Sıcaklık Ölçümü Sensor

Matter Sanal Cihaz Geliştirme Ortamı'nı kurma

MVD-DE, Docker Hub'da bulunan önceden yapılandırılmış bir Docker görüntüsüdür. Yüklemek için şu komutu çalıştırın:

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

Bu işlemin tamamlanması birkaç dakika sürebilir.

Matter Sanal Cihaz Geliştirme Ortamı'nı çalıştırma

  1. Docker kapsayıcısını başlatın:

    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
    

    Kapsülü başlattıktan sonra bazı teşhis çıktılarını, ardından kapsayıcı yapılandırmanızın doğru olduğunu onaylayan bir mesajı ve son olarak kapsayıcı kabuğu istemini görürsünüz:

    Environment looks good, you are ready to go!
    
  2. İkinci bir terminal oturumu örneği oluşturun:

    user@host> docker exec -it matter-container /bin/bash
    
  3. Sanal bir Matter cihaz için cihaz çalışırken VDC'u başlatın. VDC'a --s bağımsız değişkenini ve cihaz tarafından kullanılan IP bağlantı noktasını iletin:

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

    Fiziksel bir cihaz için VDC'ü başlatın. Önce --d bağımsız değişkenini, ardından cihaz seri bağlantı noktasını iletin:

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

VDC'ü herhangi bir bağımsız değişken sağlamadan başlatırsanız varsayılan olarak localhost 33000 bağlantı noktasını kullanan ağ soketi seçeneği kullanılır.

VDC cihazınıza bağlandıktan sonra cihazınızın durumunu gösteren bir ekran görüntüler:

Sanal cihaz grafik kullanıcı arayüzü

Cihazın QR kodunu görüntüleme

VDC, cihazınızın devreye alma akışının bir parçası olarak QR kodunu almak için de kullanılabilir. Bu cihazın QR kodunu görüntülemek için cihaz resminin yanındaki QR kodu simgesini tıklayın:

Cihazın QR kodunu gösteren sanal cihaz denetleyicisi

Cihazınızı devreye almak için bu QR kodunu kullanabilirsiniz.

Matter Sanal Cihaz Geliştirme Ortamı'nı durdurma

MVD-DE'ü durdurmak için VDC ekranı odaktayken Kontrol-Q'ya veya uygulamayı başlattığınız terminal oturumunda Kontrol-C'ye basın.

Geri bildirim

MVD-DE ile ilgili deneyiminizi nasıl iyileştirebileceğimiz hakkındaki düşüncelerinizi veya geri bildirimlerinizi göndermek için geri bildirim formumuzu doldurun.

Geri bildiriminizi gönderin