Uzak Sanal Cihaz

Cihaz SDK'sı

Matter sanal cihazları, Matter çözümlerini geliştirip test etmek için kullanışlıdır. Bu sanal cihazlar, Google Home app (GHA) kullanılarak kullanıma sunulabilir ve GHA ile Google Assistant kullanılarak kontrol edilebilir (fiziksel Matter cihazlarda olduğu gibi).

Uygulama geliştiriciler ve sanal bir Matter cihazını test etmesi ya da emülasyonu yapması gereken ancak kendi fiziksel veya sanal Matter cihazlarını oluşturacak kaynağa sahip olmayan diğer kullanıcılar için Google, Matter Virtual Device (MVD) hizmetini sunar. MVD, farklı tür sanal Matter cihazlarını simüle eden, sanal bir Matter cihazın durumunu kontrol etmek ve görüntülemek için grafik kullanıcı arayüzü sağlayan basit bir bağımsız Linux veya macOS masaüstü aracıdır.

MVD, fiziksel Matter cihazından farklı olarak Matter kumaşını birleştirmek için Bluetooth® Düşük Enerji (BDE) veya Thread® özelliklerini kullanmaz. Bunun yerine, komisyon işlemi için ana makine Linux veya macOS makinesinin mevcut kablosuz ağ bağlantısını kullanır.

Diğer araçlara kıyasla

MVD, Virtual Device Controller (VDC) özelliğinden farklıdır. Bu çözüm, sanal cihazı kontrol etmek için bir kullanıcı arayüzüyle birleştirir. Buna karşılık VDC, Matter Virtual Device Development Environment (MVD-DE) içinde derlediğimiz gibi ayrı bir sanal Matter cihazını kontrol etmek için kullanılır.

Daha önce MVD-DE codelab'i ile çalışmış olabilirsiniz. Bu codelab'de, tek bir tür sanal cihaz (akıllı ampul) geliştireceksiniz. Buna karşılık MVD, önceden oluşturulmuş birkaç farklı sanal cihaz ve bunları çalıştırıp kontrol etmek için entegre bir kullanıcı arayüzü içerir.

Desteklenen cihazlar

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

MVD'yi yükle

MVD; Debian (11 veya üzeri), Ubuntu (20.04 veya üzeri) veya macOS çalıştıran 64 bit x86 işlemci makinelerinde çalışır.

Linux

MVD Debian (.deb) paketini indirin

Zırhlı ASCII imza (.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.4.0_amd64.deb

macOS

MVD (macOS x86) dmg dosyasını indirin

MVD (ARM64 M1) dmg dosyasını indirin

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

Yüklemeyi 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 TCP bağlantı noktası 33000'ü kullanır. Bu nedenle, bu bağlantı noktası bilgisayarınızda başka bir işlem tarafından kullanılıyorsa cihazı boşalttığı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ır

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.).
• Cihaz Adı: Cihaza kullanıcı dostu bir ad verin.
• Ayırıcı: Birden fazla komisyonlanabilir cihaz reklamını ayırt etmek için kullanılan 12 bitlik bir sayıdır. (Varsayılan: 3840).
• Matter Bağlantı Noktası: Matter'nin devreye alınması ve IP ağları üzerinden iletişim için bir bağlantı noktası. Matter varsayılan olarak 5540 numaralı TCP/UDP bağlantı noktasını kullanır ancak başka bir hizmet kullanmadığı sürece sanal cihazı farklı bir bağlantı noktası kullanacak şekilde yapılandırabilirsiniz.
• 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 test ürün kimlikleri desteklenir.

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

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, Kumanda ekranı görünür. Seçtiğiniz cihazın türüne bağlı olarak aşağıdaki kontrollerden bir veya daha fazlasını görebilirsiniz:

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

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 ağ bağlantısı kısa süreliğine kesildi.
• Sıfırla: Mevcut cihazı fabrika ayarlarına sıfırlar ve devreye alma, mevcut kontroller durumu gibi tüm durumları temizler
• 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, sanal cihazınızı kurarken kullandığınız VID/PID kombinasyonuna sahip bir Matter entegrasyonu içermelidir. Ayrıntılar için proje oluşturma rehberine bakın.

• Matter'ı destekleyen bir Google Nest Hub'ınızın olması gerekir

• Android 8.1 veya sonraki sürümleri çalıştıran ve GHA uygulamasının yüklü olduğu 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.

Cihazı GHA kullanarak çalıştırmak için QRCode'u tıklayıp cihazın QR kodunu görüntüleyin. Ardından Matter cihazı eşleme bölümündeki talimatları uygulayın. Bu talimatlar, GHA kullanarak bir Matter cihazına ilk erişim işleminin nasıl yapılacağını açıklar. Cihazı Google Home Sample App for Matter kullanarak da yetkilendirebilirsiniz.

Devreye alma işleminin işleyiş şeklini öğrenmek için Matter Primer'ı (Matter) inceleyin.

Cihazı kontrol etme

Bir sanal cihazı yaptırdıktan sonra Google Home uygulamasını veya Google Asistan'ı sesinizle kontrol edebilirsiniz. Aşağıdaki yöntemlerden birini uygulayabilirsiniz:

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

Cihazla test etme

Assistant ile test etmek için VS Code için Google Home Extension veya Android Studio için Google Home Eklentisi gibi bir ifade simülasyonu 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ı.
• 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ı: Mevcut cihaz tarafından IP ağı üzerinden iletişim kurmak için kullanılan bağlantı noktası.
• Şifre Kodu: Cihazı ağ üzerinden yaptırmak 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ştaki cihazın düğüm kimliğini gösterir.

Cihaz günlüklerini göster

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ı durdurmak ve yok etmek için Sil'i tıklayın.

Uygulamayı sonlandır

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

Yardım alma

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 pencerenin sağ üst köşesindeki Sorun sms_failed düğmesini tıklayarak hata bildiriminde bulunabilirsiniz.

Geri bildirim gönderin

MVD ile ilgili beğendiğiniz noktalar veya bu araçla ilgili deneyiminizi nasıl iyileştirebileceğimiz hakkındaki düşüncelerinizi göndermek için Geri Bildirim Formumuzu doldurun.

Form, pencerenin sağ üst köşesindeki geri bildirim sentiment_satisfied düğmesinden veya aşağıdaki düğmeyi tıklanarak başlatılabilir.

Geri bildiriminizi gönderin