Uzak Sanal Cihaz

Konu Cihaz SDK'sı

Matter sanal cihaz, geliştirme ve test için yararlıdır Matter çözümleridir ve Google Home app (GHA) ve GHA ve Google Assistant, aynı fiziksel Matter gibi cihazlar.

Uygulama geliştiriciler ve sanal bir sanal makineyi test etmesi ya da Matter cihaz var ancak kendi cihazlarını oluşturmak için gerekli kaynaklara sahip değiller fiziksel veya sanal Matter cihaz, Google Matter Virtual Device (MVD) sunuyor. MVD bir simüle eden basit bağımsız Linux veya macOS masaüstü aracı Sanal Matter cihaz türlerini belirtir ve size kontrol etmek ve görüntülemek için kullanıcı arayüzünde Matter cihaz.

Fiziksel Matter cihazın aksine, MVD Bluetooth® Düşük Enerji (BDE) veya Thread® bir Matter kumaşını birleştirmek için gereklidir. Bunun yerine, ilk çalıştırma için ana Linux veya macOS makinesinin mevcut kablosuz ağ bağlantısını kullanır.

Diğer araçlara kıyasla

MVD, sanal bir cihazı kontrol etmek için kullanıcı arayüzüyle birleştiren bağımsız bir çözüm olması bakımından Virtual Device Controller (VDC)'den farklıdır. Buna karşılık VDC, olan ayrı bir sanal Matter cihazını kontrol edebilir (örneğin, Matter Virtual Device Development Environment (MVD-DE) içinde oluşturuyoruz.

Daha önce MVD-DE codelab'i ile çalışmış olabilirsiniz. Burada codelab'i kullanarak tek bir tür sanal cihaz, yani akıllı ampul geliştiriyorsunuz. İçinde Buna karşın MVD, birkaç farklı önceden oluşturulmuş öğe içerir. sanal cihazları çalıştırıp kontrol etmek için entegre bir kullanıcı arayüzü içerir.

Desteklenen cihazlar

MVD, şu Matter ayarlarını destekler: cihaz türleri:

MVD'yi yükle

MVD, Debian çalıştıran 64 bit x86 işlemci makinelerinde çalışır (11 veya üzeri), Ubuntu (20.04 veya sonraki bir sürüm) ya da macOS.

Linux

MVD Debian (.deb) paketini indirin

Zırhlı ASCII imza (.asc) dosyasını indirin

Ardından MVD eklentisini yüklemek için dpkg komutunu çalıştırın. Debian (.deb) paketi:

sudo dpkg -i mvd_1.4.0_amd64.deb

macOS

MVD (macOS x86) dmg dosyasını indirin

MVD (ARM64 M1) dmg dosyasını indirme

Ardından yüklemeyi açmak için dmg dosyasını çift tıklayın penceresini kapatın.

Yüklemeyi tamamlamak için mvd simgesini seçip Applications klasörü:

Bağlantı noktası kullanımını kontrol etme

MVD içindeki denetleyici modülü, RPC işlemini gerçekleştirmek için TCP bağlantı noktası 33000'i kullanır sanal cihaza çağrı gönderir. Bu bağlantı noktası halihazırda başka bir bağlantı noktası tarafından kullanılıyorsa işlemi gerçekleştirdiyseniz boş bıraktığınızdan emin olun.

Herhangi bir işlemin 33000 bağlantı noktasını kullanıp kullanmadığını öğrenmek için:

sudo fuser -v 33000/tcp

lsof -i:33000

TCP bağlantı noktası 33000'i kullanarak tüm işlemleri tek bir komutla sonlandırabilirsiniz:

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

MVD'yi çalıştırma

mvd

cd /Applications
open mvd.app

Cihazınızı yapılandırma

Ana ekran, başlatıldıktan sonra görünür ve sanal bir cihaz yapılandırmanıza olanak tanır:

• Cihaz Türü: Cihaz türünü seçin (örneğin, Işık, Anahtar, Sensör vb.) kullanın.
• Cihaz Adı: Cihaza kullanıcı dostu bir ad verin.
• Ayırıcı: Birden fazla ifadeyi ayırt etmek için kullanılan 12 bitlik bir sayı cihaz reklamları için geçerlidir. (Varsayılan: 3840).
• Matter Bağlantı Noktası: Matter için bir bağlantı noktası devreye alma sürecini IP ağları. Matter varsayılan olarak 5540 numaralı TCP/UDP bağlantı noktasını kullanır, ancak sanal cihazı farklı bir kullanmadığı sürece bağlantı noktasını kullanabilirsiniz.
• Tedarikçi firma kimliği: Yalnızca test tedarikçi firması kimliği 0xFFF1 desteklenir.
• Ürün kimliği: Yalnızca 0x8000 - 0x801F arasındaki ürün kimliklerini test edin desteklenir.

Güvenlik duvarınızı yapılandırma

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

Cihazınızı çalıştırma

Cihaz yapılandırıldıktan sonra Cihaz oluştur'u tıklayın. Cihaz şu durumda: Denetleyici ekranı görüntülenir. Kullandığınız cihazın türüne bağlı olarak aşağıdaki denetimlerden birini veya daha fazlasını görebilirsiniz:

• Açık/Kapalı: Çoğu cihazda kullanılabilir.
• Seviye: Örneğin, bir ışıkta parlaklığı ayarlamak için seviye kaydırma çubuğu bulunabilir.
• Renk: Örneğin, bir renk ışığında bu kontrol kullanılabilir.
• Doluluk: Doluluk Sensörü, sıcaklığı simüle etmek için bu kontrolü sunar. işsiz veya boş durumunda olabilir.

Tüm sanal cihazlarda aşağıdaki denetimler bulunur:

• QRCode: Komisyon için kullanılan QR kodunu gösterir.
• Yeniden başlat: Sanal cihazı yeniden başlatır. Cihazın bağlantısı kesildi kaldırmanız gerekir.
• Sıfırla: Mevcut cihazı fabrika ayarlarına sıfırlar ve şunlar da dahil olmak üzere tüm durumu temizler: devreye alma, mevcut kontroller durumu vb.
• Sil: Cihazı kaldırır ve Cihaz oluştur ekranına geri döner.

Cihazınızı devreye alın

Cihaz, oluşturulur oluşturulmaz kullanıma sunulabilir.

Cihazı kullanıma sunmanın birkaç ön koşulu vardır:

• Google Home Developer Console bölgesinde bir projeniz olmalıdır. Bu proje, aynı VID/PID'ye sahip bir Matter entegrasyonu içermelidir kombinasyonuyla aynı olacaktır. Görüntüleyin proje oluşturma rehberini inceleyin.

• Şu cihazları destekleyen bir Google Nest Hub'ınızın olması gerekir: Konu

• Android 8.1 veya sonraki bir sürümü çalıştıran ve GHA yüklü olan bir Android telefonunuz olmalıdır.

• Android telefon, hub ile aynı kablosuz ağa bağlı olmalıdır.

• Ana makine kablosuz ağa bağlı olmalıdır.

GHA özelliğini kullanarak cihazı komisyon almak için QRCode'u tıklayarak cihazın QR kodunu görüntüleyin, ardından Bir Matter eşle cihaz kullanıyor. bir Matter cihazına GHA Ayrıca, Google Home Sample App for Matter.

Bkz. Matter Primer'dan Matter devreye almanın işleyiş şeklini öğrenin.

Cihazı kontrol etme

Sanal bir cihazı devreye aldıktan sonra Google Home uygulamasını veya Google Asistan'ı ses özelliği gösterilir. Aşağıdaki yöntemlerden birini uygulayabilirsiniz:

• Cihazı GHA veya Durum değişiklikleri izlenirken Assistant açık sanal cihaz veya
• Sanal cihazdaki durum değişikliklerini izlerken Sample App for Matter simgesini kullanarak cihazı kontrol edin veya
• Bu sırada cihaz durumunu MVD üzerinden kontrol edin GHA veya tablodaki durum değişikliklerini izleme Assistant.

Cihazla test etme

Assistant ile test yapmak için VS Code için Google Home Uzantısı veya Android Studio için Google Home Eklentisi gibi bir ifade simülasyon aracı kullanmanızı öneririz.

Cihaz ayrıntılarını göster

Cihaz ayrıntıları ekranında ayrıntılı cihaz bilgileri gösterilir:

• Ad: Cihaza verilen kolay ad.
• Cihaz Türü: Seçilen cihaz türü.
• Ayrıştırıcı: Geçerli cihaz ayırıcısı.
• Tedarikçi firma kimliği: Geçerli cihaz tedarikçi firma kimliği.
• Ürün kimliği: Geçerli cihaz ürün kimliği.
• RPC bağlantı noktası: Cihazın denetleyicilerle (GUI) iletişim kurduğu RPC bağlantı noktası.
• Matter Bağlantı Noktası: Geçerli cihazın iletişim kurmalarını sağlar.
• Şifre Kodu: Cihazı ağ üzerinden yaptırmak için kullanılan PIN.
• Yapılandırma Klasörü: Sanal cihazın depoladığı klasör yapılandırma.
• Komisyon Bilgileri: Cihazın katıldığı kumaşları gösterir ve cihazın düğüm kimliği.

Cihaz günlüklerini göster

MVD uygulamasını terminalden başlattıysanız günlük çıkışı görünür stdout tarihinde. Cihaz günlüklerini Cihaz günlükleri sekmesinde de görüntüleyebilirsiniz.

Cihazı durdurma

Cihazı durdurmak ve yok etmek için Sil'i tıklayın.

Uygulamayı sonlandır

Denetim penceresinin kapatılması, cihazın silinmesine neden olur ve MVD uygulaması. Terminalden başlattıysanız: terminalde Ctrl-C tuşlarına basarak da uygulamayı sonlandırın.

Yardım alın

MVD ile ilgili yardım almak, hata bildirmek veya yeni bir özellik isteğinde bulunmak için Google destek temsilcinizle iletişime geçin.

Pencerenin sağ üst köşesindeki yardım help düğmesini tıkladığınızda bu sayfaya yönlendirilirsiniz.

Hata bildir

MVD içinde bir kusur bulduğunuzu düşünüyorsanız, Sorun'u sms_failed tıklayarak hata bildiriminde bulunabilirsiniz. düğmesini tıklayın.

Geri bildirim gönder

MVD ile ilgili sevdiğiniz şeylerden ve önerilerinizden yararlanmak için daha iyi bir araç deneyimi için, Geri Bildirim Formu'nu doldurun.

Formu, pencerenin sağ üst köşesindeki geri bildirim sentiment_satisfied düğmesinden veya aşağıdaki düğmeyi tıklayarak başlatabilirsiniz.

Geri bildiriminizi gönderin