Matter entegrasyonunu test etme

Google Home Developer Console, Google Home Test Suite kullanarak Matter entegrasyonunuza göre testleri yapılandırıp çalıştırabileceğiniz bir Test sayfası sağlar. Test Suite, tüm entegrasyon testlerini gerçekleştiren ve Developer Console üzerinde yerleşik olarak bulunan ayrı bir uygulamadır.

Entegrasyonun Tedarikçi Kimliği ve Ürün Kimliğine yönelik cihazların test edilebilmesi için Developer Console ile kullanılan hesap için Google Home app (GHA) içinde devreye alınmış ve hazır olması gerekir. Daha fazla bilgi için Matter cihazı eşleme konusuna bakın.

Test Suite, belirli bir Matter proje yapılandırmasına ait cihaz grubunda çalıştırılabilir. Her şeyin düzgün çalıştığından emin olmak için entegrasyonlarınızda Test Suite kullanmanız çok önemlidir.

Test sayfasında, tamamlanmış ve test edilmeye hazır Matter entegrasyonları Teste hazır bölümünde listelenir.

Test edilen Matter entegrasyon Test edilen bölümünde listelenir.

Test planı türü

İki tür test planı vardır:

  • Geliştirme test planları, Matter kullanarak cihazların kontrolünü test etmek için kullanılır. Düzenlenebilir ancak Matter sertifikası için gönderilemez.

  • Sertifika test planları özellikle Matter sertifikasyonu içindir ve düzenlenemez. Bu seçeneği belirlediğinizde Matter entegrasyonunuzun yeni bir sürümü oluşturulur.

Entegrasyon sürümleri

Sertifika için bir test planı oluşturduğunuzda entegrasyonun yeni bir sürümü oluşturulur. Bu numaralı sürüm, Test sekmesinden itibaren Developer Console içindeki tüm entegrasyon listelerinde listelenir.

Yeni sürümler asla diğer numaralı sürümlerden oluşturulmaz. Örneğin, bir entegrasyon için oluşturduğunuz ilk test planı, söz konusu entegrasyon için v.1 sürümünü oluşturur. Başka bir test planı oluşturduğunuzda söz konusu entegrasyon için v.2 sürümü oluşturulur ancak bu sürüm, v.1 sürümünü temel almaz. Bunun yerine bu sürüm, v.1'de olduğu gibi entegrasyonun eski sürüme geçirilmemiş örneğini temel alır.

Bir entegrasyonun yok sürümü, Geliştirme sekmesinde yönetilen entegrasyonun eski sürüme geçirilmemiş örneğini temsil eder.

Başka bir deyişle, Developer Console içindeki Matter > Test'te:

  • Entegrasyonun Yok sürümü için Test et'i tıklarsanız yeni bir sürüm oluşturulur. Sürüm numarası, numaralandırılmış mevcut sürümlerden bir yüksek olacaktır.
    • Numaralı sürüm yoksa v.1 sürümü oluşturulur.
    • v.1 sürümü varsa v.2 sürümü oluşturulur. v.2 sürümü varsa v.3 sürümü oluşturulur ve bu şekilde devam eder.
  • Entegrasyonun numaralı bir sürümü için (örneğin, v.1) Test et'i tıklarsanız yeni sürüm oluşturulmaz. Bunun yerine, v.1 sürümü tekrar test edilir.

Daha fazla bilgi için Entegrasyon sürümü oluşturma bölümüne bakın.

Test planı oluşturma

Entegrasyon sürümleri, sürümü dönüştürülmemiş bir entegrasyonun anlık görüntüsüdür. Diğer bir deyişle, sertifikasyon için bir test planı ve dolayısıyla bir entegrasyon sürümü oluşturduğunuzda, bu entegrasyonla ilgili tüm meta verilerin, başlatılan entegrasyon için kullanmak istediğiniz bilgiler olması gerekir.

Sertifikasyon için bir test planı oluşturmadan önce aşağıdakileri yaptığınızdan emin olun:

  1. Bir şirket profili oluşturduysanız.
  2. Entegrasyon için üretim tedarikçi firması kimliğini (VID) girin.
  3. Kurulum ve markalama yapılandırıldı.

Entegrasyonunuz için bunların hepsini tamamlamadıysanız sertifika testi için oluşturulan bir entegrasyon sürümü onaylanamaz. Yeni bir sürüm oluşturmanız, yani Test, Saha Denemesi ve Sertifikalandırma adımlarını yeniden uygulamanız gerekir.

Ayrıca, bir entegrasyon sürümü onaylanmadan önce marka öğelerinizi güncellemek istiyorsanız yeni bir sürüm oluşturmanız ve baştan başlamanız gerekir.

Test planı oluşturmak için:

Developer Console'a git

  1. Proje listesinden, çalışmak istediğiniz projenin yanındaki 'ı tıklayın.

  2. Sayfanın sol tarafındaki gezinme menüsünde Matter > Test et'e gidin.

  3. Test etmek istediğiniz entegrasyonun Yok sürümü için Test et'i tıklayın. Bu işlem yeni bir entegrasyon sürümü oluşturur.

  4. Test türü olarak Geliştirme testi veya Sertifika testi'ni seçin. Yeni bir test planı oluşturma

    • Google ekosisteminde sertifika almaya hazırlanıyorsanız Sertifika testi'ni seçin.
    • Geliştirme testi, sertifikasyon için kullanılamaz.
  5. Test et'i tıklayın. Cihaz bulunamadı hata ekranını görürseniz bu entegrasyon için bir cihaz henüz ekosisteme dahil edilmemiş demektir. Daha fazla bilgi için Eşleme sorunlarını giderme bölümüne bakın.

  6. Testinizi yapılandırın ekranında testiniz için bir ad girin ve cihaz listesinden test etmek istediğiniz cihazları seçin.

  7. Sonraki: Test planı düğmesini tıklayın.

  8. Test planı oluşturun sayfasındaki Test paketleri bölümünde, çalıştırmak istediğiniz test paketlerini seçin.

Test planı oluşturma

Test Suite uygulamasından çıkmak isterseniz Geliştirici Merkezi'ne dön'ü tıklayın.

Test planını çalıştırma

Test Suite içindeki Test planı oluşturun sayfasında Testi Çalıştır'ı tıklayın. Tüm testlerin durumu ve günlükleriyle birlikte Test ortamı sayfası görüntülenir.

Testler tamamlandıktan sonra test sonuçlarınız görünür. Her test paketi yürütme işleminin durumu yanında (Başarılı, Başarısız) gösterilir.

Günlükler bölmesi, her bir test yürütmenin durumunu gösterir.

Test sonuçları

Test ortamı sayfasında bir test planını yeniden test etmek için test yürütmesi tamamlandıktan sonra üstteki Retest'i (Yeniden test et) tıklayın.

Tamamladığınızda:

Test sonuçlarınızı görüntüleme ve yorumlama

Test Suite içindeki Test geçmişi sayfasında, Test planları bölümünde istenen test planı için Yeniden test et'i tıklayarak bir geliştirme planına veya gönderilmemiş bir sertifika test planına ilişkin önceki test sonuçlarını görüntüleyebilirsiniz. Bu işlem, sizi söz konusu testin sonuçlarını gösteren Test Ortamı sayfasına yönlendirir.

Test geçmişi

Gönderilen bir sertifika planı için test sonuçları raporunu görüntülemek üzere Sertifika için kaydedilenler bölümündeki Sonuçlar'ı tıklayın.

Entegrasyon sürümü için test sonuçlarına Developer Console içindeki Test sekmesinden de erişilebilir. Test Suite içindeki Test geçmişi sayfasına gitmek için bu sayfada listelenen herhangi bir entegrasyon sürümünün Test geçmişi için Görüntüle'yi tıklayın.

Konsol durumları

Test aşamasında aşağıdaki Konsol durumlarıyla karşılaşılır:

Section Durum Açıklama Koşul Sonraki adımlar
Test için hazır Hazır Bu integration sürümü test edilmeye hazır. Yok integrationöğesinin bu sürümünü test edin.
Test edildi Hazır Bu integration sürümü test edildi ve saha denemesi veya sertifika için gönderilebilir.

Sürüm test edildi ve kaydedildi.

Başarısız olan tüm test durumları, Google'ın incelemesi için gerekçeler içerir.

İsterseniz yeniden test edin.

Sorun giderme

Devreye alınan cihaz Test Paketi'nde görünmüyor

Bir cihazı test Tedarikçi Firma Kimliği (VID) ve Ürün Kimliği (PID) ile eşlediyseniz ancak Developer Console içinde cihazı Test Paketi ile test etmeye çalıştığınızda bu cihaz görünmezse bunun nedeni muhtemelen birden çok entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.

Sorunu gidermek için Developer Console ürünündeki tüm test cihazlarını kaldırın ve tekrar test etmek istediğiniz cihazı eşleyin.

Doğru cihazı eşleştirdiğinizden emin olmak için cihazın Üretici ve Model bilgilerini (CHIP_DEVICE_CONFIG_DEVICE_* değerleri) test donanım yazılımınızdaki benzersiz değerlere ayarlayabilirsiniz.

Daha fazla bilgi için Cihaz bilgileri bölümüne bakın.

Cihazınızın VID/PID değerini doğrulayın

Google ile entegrasyonunuzu geliştirmeye başlamak istiyorsanız Google Home Console'da bir proje ve entegrasyon oluşturmanız gerekir.

Bluetooth Sniffer sorunlarını giderme

Cihazınızın işaretlediği VID/PID değeri, Developer Console projenize girilen VID/PID ile eşleşmelidir.

  • 0xFFF1 - 0xFFF4 arasındaki VID'ler test için ayrılmıştır. Bu testler, temel kullanıma sunma ve kontrol testleri için kullanılabilir ancak aşağıdaki geliştirme aşamalarında kullanılamaz:

nRF Connect for Mobile gibi bir Bluetooth mühendislik uygulaması kullanarak Hizmet Verileri alanında işaretleme cihazının VID/PID değerini görebilirsiniz.

nRF Connect'in Android sürümündeki bu ekran görüntüsünde, VID/PID değerinin Hizmet Verileri alanının dördüncü baytından başlayarak 5A23FFFE olarak listelendiğini göreceksiniz. Bu, her ikisi de küçük endian biçiminde olan 5A23 VID ve FFFE PID değerlerini gösterir.

BDE uygulaması,değerleri küçük endian dilinde görüntüler ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endian içindedir.

Bluetooth algılayıcısının gösterdiklerine bağlı olarak Actions Console projenize doğru değerlerin ve biçimin girildiğini doğrulayın.

Örnek ekran görüntüsündeki değerler için Developer Console içindeki VID ve PID sırasıyla 235A ve FEFF olur.