Matter Sanal Cihazı

Matter sanal cihazları, Matter çözümlerini geliştirme ve test etme konusunda faydalıdır. Bu cihazlar, tıpkı fiziksel Matter cihazları gibi Google Home app (GHA) kullanılarak devreye alınabilir ve GHA ile Google Assistant kullanılarak kontrol edilebilir.

Google, sanal bir cihazı test etmesi veya emüle etmesi gereken ancak kendi fiziksel ya da sanal Matter cihazını oluşturmak için yeterli kaynağı olmayan uygulama geliştiriciler ve diğer kullanıcılar için Matter Virtual Device (MVD) hizmetini sunar.Matter MVD, farklı türde sanal Matter cihazları 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, hafif ve bağımsız bir Linux veya macOS masaüstü aracıdır.

Fiziksel bir Matter cihazın aksine MVD, Matter yapısına katılmak için Bluetooth® Düşük Enerji (BLE) veya Thread®'i kullanmaz. Bunun yerine, devreye alma için ana makine 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ıyla Virtual Device Controller (VDC)'dan farklıdır. Buna karşılık VDC, ayrı bir sanal Matter cihazını kontrol etmek için kullanılır.

MVD, önceden oluşturulmuş birkaç farklı sanal cihaz içerir ve bunları çalıştırıp 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 üzeri), Ubuntu (20.04 Noble Numbat veya üzeri) ya da macOS çalıştıran 64 bit x86 işlemci makinelerinde çalışır.

Linux

MVD Debian (.deb) paketini indirme

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

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ı indirme

MVD (ARM64 M1) dmg dosyasını indirme

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'i kullanır. Bu bağlantı noktası bilgisayarınızdaki başka bir işlem tarafından kullanılıyorsa bağlantı noktasını boşalttığınızdan emin olun.

33000 numaralı bağlantı noktasını kullanan bir işlem olup olmadığı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

Başlatıldığında ana ekran görünür ve sanal bir cihaz yapılandırmanıza olanak tanır:

• Cihaz Türü: Cihaz türünü seçin (ör. Işık, Anahtar, Sensör vb.).
• Cihaz Adı: Cihaza kullanıcı dostu bir ad verin.
• Ayırt edici: Birden fazla devreye alınabilir cihaz reklamını ayırt etmek için kullanılan 12 bitlik bir sayı. (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 TCP/UDP bağlantı noktası 5540'ı kullanır ancak sanal cihazı, başka bir hizmet tarafından kullanılmadığı sürece farklı bir bağlantı noktası kullanacak şekilde yapılandırabilirsiniz.
• Tedarikçi kimliği: Yalnızca test tedarikçi 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 Create device'ı (Cihaz oluştur) tıklayın. Cihaz oluşturulduğunda Kumanda ekranı görünür. Seçtiğiniz cihaz türüne bağlı olarak aşağıdaki kontrollerden birini veya daha fazlasını görebilirsiniz:

• Açma/Kapatma: Cihazların çoğunda ortaktır.
• Seviye: Örneğin, bir ışığın parlaklığını ayarlamak için seviye kaydırma çubuğu olabilir.
• Renk: Örneğin, renkli bir ışıkta bu kontrol bulunabilir.
• Varlık: Varlık sensörü, dolu veya boş durumunu simüle etmek için bu kontrolü sunar.

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

• QRCode: Devreye alma 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 bir süreliğine kesilir.
• Sıfırla: Mevcut cihazı fabrika ayarlarına sıfırlar ve devreye alma, mevcut kontrollerin durumu vb. dahil tüm durumları temizler.
• Delete (Sil): Cihazı siler ve Create device (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 içindeki standart özelliklerin ötesinde ek işlevler sağlar. MS özelliğine sahip bir cihazı test etmek için MVD, Özel Kümeler adlı bölümdeki özelliklerle etkileşim kurmanıza olanak tanır (yukarıdaki resme bakın).

Cihazınızı devreye alma

Cihaz, oluşturulduğu anda devreye alınabilir.

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

• Google Home Developer Console içinde bir projeniz olmalıdır. Bu proje, sanal cihazınızı ayarlarken kullandığınız VID/PID kombinasyonuna sahip bir Matter entegrasyonu 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 sonraki sürümlerin yüklü olduğu ve GHA uygulamasının bulunduğ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 devreye almak için QRCode'nu tıklayarak cihazın QR kodunu görüntüleyin, ardından Matter cihazı eşleme bölümündeki talimatları uygulayın. Bu bölümde, GHA kullanarak Matter cihazın ilk katılımının nasıl yapılacağı açıklanmaktadır. Cihazı Google Home Sample App for Matter kullanarak da devreye alabilirsiniz.

MatterDevreye alma işleminin nasıl çalıştığını öğrenmek için Mattertemel bilgiler sayfamıza göz atın.

Cihazı kontrol etme

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

• Sanal cihazdaki durum değişikliklerini izlerken cihazı GHA veya Assistant üzerinden kontrol etme ya da
• Sanal cihazdaki durum değişikliklerini izlerken Sample App for Matter kullanarak cihazı kontrol edin veya
• MVD veya Assistant'deki durum değişikliklerini izlerken cihaz durumunu GHA üzerinden kontrol edin.

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ülatörü kullanmanızı öneririz.

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

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ı: Mevcut cihaz ayrıştırıcısı.
• Satıcı kimliği: Mevcut cihaz satıcı kimliği.
• Ürün kimliği: Mevcut cihaz ürün kimliği.
• RPC Port (RPC Bağlantı Noktası): Cihazın denetleyicilerle (GUI) iletişim kurduğu RPC bağlantı noktası.
• Matter Bağlantı Noktası: Mevcut cihazın IP ağı üzerinden iletişim kurmak için kullandığı bağlantı noktası.
• Şifre Kodu: Cihazı ağ üzerinden devreye almak için kullanılan PIN.
• Configuration Folder (Yapılandırma Klasörü): Sanal cihazın yapılandırmayı depoladığı klasör.
• Komisyon Bilgileri: Cihazın katıldığı yapıyı ve cihazın yapıdaki 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 imha etmek için Sil'i tıklayın.

Uygulamayı sonlandırma

Kontrol penceresi kapatıldığında cihaz imha edilir ve MVD uygulaması sonlandırılır. Uygulamayı terminalden başlattıysanız terminale Ctrl-C yazarak da uygulamayı sonlandırabilirsiniz.

Yardım alın

MVD ile ilgili yardım almak, hata bildirmek veya yeni bir özellik isteğinde bulunmak için Google destek ekibindeki 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 hata bulduğunuzu düşünüyorsanız pencerenin sağ üst köşesindeki Sorun sms_failed düğmesini tıklayarak hata bildiriminde bulunabilirsiniz.

Geri bildirim gönder

MVD ile ilgili beğendiğiniz özellikler veya araçla ilgili deneyiminizi nasıl iyileştirebileceğimiz hakkındaki 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 açabilirsiniz.

Geri bildiriminizi gönderin

MVD kullanırken alt kısımda açılan anket aracılığıyla da geri bildirim gönderebilirsiniz.