Uzak Sanal Cihaz

Madde ; Ana Sayfa API'leri

Matter sanal cihazlar, Matter çözümlerini geliştirip test etmek için kullanışlıdır. Google Home app (GHA) kullanılarak devreye alınabilir ve fiziksel Matter cihazlar gibi GHA ve Google Assistant kullanılarak kontrol edilebilir.

Uygulama geliştiriciler ve sanal bir cihazı test etmesi ya da emüle etmesi gereken ancak kendi Matter cihazını oluşturmak için kaynakları olmayan diğer kullanıcılar için Google, Matter Virtual Device (MVD)'ı sunar.Matter MVD, farklı sanal Matter cihaz türlerini simüle eden ve sanal Matter cihazın durumlarını kontrol edip görüntülemek için grafik kullanıcı arayüzü sağlayan, bağımsız ve hafif bir Linux veya macOS masaüstü aracıdır.

Fiziksel bir Matter aygıtının aksine, MVD bir Matter yapısına katılmak için Bluetooth® Low Energy (BLE) veya Thread®'e güvenmez. Bunun yerine, devreye alma için ana Linux veya macOS makinesinin mevcut Wi-Fi ağ bağlantısını kullanır.

Diğer araçlarla karşılaştırma

MVD, Virtual Device Controller (VDC)'den farklı olarak, sanal cihazı kontrol etmek için kullanıcı arayüzüyle birleştiren bağımsız bir çözümdür. Buna karşılık, VDC ayrı bir sanal Matter cihazı kontrol etmek için kullanılır.

MVD, çeşitli önceden oluşturulmuş sanal cihazlar içerir ve bunları çalıştırmak ve kontrol etmek için entegre bir kullanıcı arayüzü sunar.

Desteklenen cihazlar

MVD, aşağıdaki Matter cihaz türlerini destekler:

MVD'yi yükleme

MVD, Debian (13 Trixie veya üstü), Ubuntu (20.04 Noble Numbat veya üstü) ya da macOS çalıştıran 64 bit x86 işlemcili makinelerde çalışır.

Linux

MVD Debian (.deb) paketini indirin

Armored-ASCII imzası (.asc) dosyasını indirin

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

sudo dpkg -i mvd_1.7.0_amd64.deb

macOS

MVD (macOS x86) dmg dosyasını indirin

MVD (ARM64 M1) dmg dosyasını indirin

Daha sonra dmg dosyasına çift tıklayarak kurulum penceresini açın.

Kurulumu tamamlamak için mvd simgesini seçip Applications klasörüne sürükleyin:

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

MVD içindeki denetleyici modülü, sanal cihaza RPC çağrıları yapmak için 33000 numaralı TCP bağlantı noktasını kullanır. Bu nedenle, bu bağlantı noktası bilgisayarınızda başka bir işlem tarafından zaten kullanılıyorsa bağlantı noktasını boşaltın.

Herhangi bir işlemin 33000 portunu kullanıp kullanmadığını görmek için:

sudo fuser -v 33000/tcp

lsof -i:33000

TCP bağlantı noktası 33000'i kullanan 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

Uygulama başlatıldığında ana ekran görünür ve sanal 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.).
• Cihaz Adı: Cihaza kullanıcı dostu bir ad verin.
• Ayırt edici: Birden fazla komisyonlu cihaz reklamı arasında ayrım yapmak için kullanılan 12 bitlik bir sayıdır. (Varsayılan: 3840).
• Matter Bağlantı noktası: Matter IP ağları üzerinden devreye alma ve iletişim için kullanılan bir bağlantı noktası. Matter, varsayılan olarak 5540 numaralı TCP/UDP bağlantı noktasını kullanır ancak başka bir hizmet tarafından kullanılmadığı sürece sanal cihazı farklı bir bağlantı noktası kullanacak şekilde yapılandırabilirsiniz.
• Satıcı kimliği: Yalnızca test satıcı kimliği 0xFFF1 desteklenir.
• Ürün kimliği: Yalnızca 0x8000 ile 0x801F arasındaki test ürün kimlikleri 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 oluşturulduğunda Denetleyici ekranı görüntülenir. Seçtiğiniz aygıt türüne bağlı olarak aşağıdaki denetimlerden birini veya birkaçını görebilirsiniz:

• Açık/Kapalı: Çoğu cihazda bulunur.
• Düzey: Örneğin, bir ışığın parlaklığı ayarlamak için düzey kaydırma çubuğu olabilir.
• Renk: Örneğin, bir renkli ışık bu kontrole sahip olabilir.
• Doluluk: Doluluk Sensörü, dolu veya boş durumunu simüle etmek için bu kontrolü sunar.

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

• QRCode: Kullanıma alma için kullanılan QR kodunu gösterir.
• Yeniden başlatma: Sanal cihazı yeniden başlatır. Cihazın ağ bağlantısı kısa süreliğine kesilir.
• Sıfırla: Mevcut cihazı fabrika ayarlarına sıfırlar ve devreye alma, mevcut kontroller durumu gibi tüm durumları temizler.
• Sil: Cihazı yok eder ve Cihaz oluştur ekranına döner.

Üreticiye özgü özellikler

Üreticiye özel (MS) özellikler Android için Home API'leri tarafından desteklenir ve Matter'deki standart özelliklerin ötesinde ek işlevler sağlar. Bir cihazı MS özelliğine sahip olarak test etmek için MVD, Özel Kümeler adlı bölümdeki özelliklerle etkileşim kurmanızı sağlar (yukarıdaki resme bakın).

Cihazınızı devreye alın

Cihaz, oluşturulur oluşturulmaz komisyon kazanmaya uygundur.

Cihazın devreye alınması için birkaç ön koşul vardır:

• Google Home Developer Console'da bir projeniz olmalıdır. Bu proje, sanal cihazınızı kurarken kullandığınız VID/PID kombinasyonuyla aynı olan bir Matter entegrasyonunu içermelidir. Ayrıntılar için proje oluşturma kılavuzuna bakın.

• Matter'ı destekleyen bir Google Nest Hub'ınız olmalıdır.

• Android 8.1 veya üzeri işletim sistemine sahip ve GHA yüklü bir Android telefonunuz olmalıdır.

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

• Ana makinenin Wi-Fi ağına bağlı olması gerekir.

Cihazı GHA kullanarak devreye almak için cihazın QR kodunu görüntülemek üzere QRCode'a tıklayın, ardından GHA kullanarak bir Matter cihazının nasıl devreye alınacağını açıklayan Bir Matter cihazını eşleştirme bölümündeki talimatları izleyin. Cihazı Google Home Sample App for Matter kullanarak da devreye alabilirsiniz.

Matter Devreye Alma işleminin nasıl çalıştığını öğrenmek için Matter Giriş Kılavuzumuzu inceleyin.

Cihazı kontrol edin

Sanal bir cihazı devreye aldıktan sonra, cihazı Google Home Uygulamasını veya Google Asistan'ı sesli olarak kullanarak kontrol edebilirsiniz. Aşağıdaki yöntemlerden birini uygulayabilirsiniz:

• Sanal cihazdaki durum değişikliklerini izlerken cihazı GHA veya Assistant üzerinden kontrol edin veya
• Sanal cihazdaki durum değişikliklerini izlerken cihazı Sample App for Matter kullanarak kontrol edin veya
• GHA veya Assistant içindeki durum değişikliklerini izlerken cihaz durumunu MVD üzerinden kontrol edin.

Cihazla test edin

Assistant ile test etmek için VS Code için Google Home Eklentisi veya Android Studio için Google Home Eklentisi gibi bir ifade simülatörü kullanmanızı öneririz.

Cihaz ayrıntılarını görüntüle

Cihaz ayrıntıları ekranı ayrıntılı cihaz bilgilerini gösterir:

• Ad: Cihaza verilen kullanıcı dostu ad.
• Cihaz Türü: Seçilen cihaz türü.
• Ayırıcı: Geçerli cihaz ayırıcısı.
• Satıcı kimliği: Mevcut cihaz satıcı 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 IP ağı üzerinden iletişim kurmak için kullandığı bağlantı noktası.
• Geçiş Kodu: Cihazı ağ üzerinden devreye almak için kullanılan PIN.
• Yapılandırma Klasörü: Sanal cihazın yapılandırmayı depoladığı klasör.
• Komisyon bilgileri: Cihazın katıldığı kumaşları ve kumaşta cihazın düğüm kimliğini gösterir.

Cihaz günlüklerini görüntüleme

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

Cihazı durdurma

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

Uygulamayı sonlandırma

Kontrol penceresinin kapatılması cihazı bozar ve MVD uygulamasını sonlandırır. Terminalden başlattıysanız terminale Ctrl-C yazarak da uygulamayı sonlandırabilirsiniz.

Yardım alın

MVD ile ilgili yardım almak, bir hatayı bildirmek veya yeni bir özellik istemek için Google destek ekibindeki ilgili kişinizle 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 pencerenin sağ üst köşesindeki Sorun sms_failed düğmesini tıklayarak hata bildirebilirsiniz.

Geri bildirim gönder

MVD ile ilgili beğendiğiniz noktalar veya araçla ilgili deneyiminizi nasıl iyileştirebileceğimiz konusundaki düşüncelerinizi göndermek için geri bildirim formumuzu 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 bize gönderin

MVD kullanırken alt kısımda açılan anketle de geri bildirim sağlayabilirsiniz.