Konu Sorunlarını Giderme

Köprü

Telefonunuzun uyumlu olup olmadığını doğrulama

Tüm Android O (8.1, API düzeyi 27) ve sonraki sürümlerin yüklü olduğu cihazlar Matter ile uyumludur. Telefonunuzda gerekli modüllerin olup olmadığını kontrol etmek için aşağıdaki adımları uygulayın.

Android Debug Bridge'i kurma

Sorun giderme işleminden önce Android Debug Bridge (adb) ayarlanmalıdır. Hangout planlamak için:

  1. Bilgisayarınıza "adb"yi yükleyin.
  2. Android telefonunuzda Geliştirici Seçenekleri ve USB Üzerinden Hata Ayıklama'yı açın.

Google Play Hizmetleri (GPS) Matter modüllerinizi doğrulama

Google Play services Matter modüllerine sahip olup olmadığınızı kontrol etmek için aşağıdakileri yapın:

  1. Android Debug Bridge'i kurun.
  2. Android telefonunuzu bilgisayarınıza bağlamak için USB kablosu kullanın.
  3. Gerekli modüllerin yüklü olduğunu doğrulamak için terminalde şu komutu çalıştırın: Matter
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
      
    
    Aşağıdakine benzer bir çıkış görüyorsanız Matter modülleri yüklüdür:
    com.google.android.gms.home [v222110900]
    Yukarıdaki sürüm numarasının cihazınızdakinden farklı olabileceğini unutmayın.
  4. Gerekli modüllerin yüklü olduğunu doğrulamak için terminalde şu komutu çalıştırın: Thread
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    Aşağıdaki örneğe benzer bir çıkış görüyorsanız Thread modülleri yüklüdür:
    com.google.android.gms.threadnetwork [v222106301]
    Cihazınızdaki sürüm numarasının farklı olabileceğini unutmayın.

Modüller listede yoksa bunun nedeni şunlardan biri olabilir:

  1. Android sürümünüz güncel değil. Cihazınızın Android O (8.1) veya daha yeni bir sürüm olduğundan emin olun.
  2. Matter modülleri henüz indirilmedi. İndirilmeleri için en az 24 saat bekleyin. İndirme işleminin gecikmemesi için bu süre boyunca cihazınızın açık ve şarjda olduğundan emin olun. Modülleri 24 saat içinde almadıysanız modüllerin indirilmesini zorunlu kılmak için cihazı fabrika verilerine sıfırlamayı deneyebilirsiniz.

Cihazınızın VID/PID'sini doğrulama

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

Bluetooth Sniffer ile ilgili sorunları giderme

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

  • VID'ler 0xFFF1 - 0xFFF4 test için ayrılmıştır. Temel devreye alma ve kontrol testleri için kullanılabilirler ancak geliştirme sürecinin aşağıdaki aşamalarında kullanılamazlar:

nRF Connect for Mobile gibi bir Bluetooth mühendislik uygulaması kullanarak işaret cihazının VID/PID'sini Service Data (Hizmet Verileri) alanında görebilirsiniz.

nRF Connect'in Android sürümüne ait bu ekran görüntüsünde, VID/PID'nin Hizmet Verileri alanının dördüncü baytından başlayarak 5A23FFFE şeklinde listelendiğini görebilirsiniz. Bu, 5A23 VID ve FFFE PID değerlerini gösterir. Her ikisi de little endian biçimindedir.

BLE uygulaması,değerleri little-endian biçiminde gösterir ancak Developer Console projenize girdiğiniz VID/PID değerleri big-endian biçimindedir.

Bluetooth sniffer'ın gösterdiği değerlere göre 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.

Cihazınızın uyumlu bir Matter SDK dalı kullanılarak oluşturulduğunu doğrulama

Google Matter hub'ları Matter 1.0 ile uyumludur ve kararlı daldaki v1.0-branch commit'leri kullanan derlemelerle test edilmiştir. Her yeni hub sürümüyle kullanılması önerilen belirli commit'ler için herkese açık sürüm notlarını inceleyin.

Eşleniyor

Cihazınızın kimlik bilgilerini doğrulama

Kendi Alliance tarafından atanmış VID'nizi kullanırken cihazda doğru kimlik bilgilerine sahip olduğunuzdan emin olun:

  • Sertifika Beyanı (CD).
  • Cihaz Onay Sertifikası (DAC) ve sertifika zinciri

Daha fazla bilgi için Matter cihaz test sertifikaları oluşturma başlıklı makaleyi inceleyin.

Matter uyumlu hub'ınızı doğrulama

Matter hub'ınız, Google tarafından desteklenen hub'lardan biri olmalıdır. Ayrıca Matter ile uyumlu bir derlemede olmalıdır.

Bazı hub'lar aynı zamanda Thread Border Router (TBR) olduğundan Thread cihazları geliştirmenize ve test etmenize olanak tanır. Diğer hub'lar yalnızca kablosuz ağ ve Ethernet Matter cihazlarını destekler. Thread bağlantısını etkinleştirmek için ağınızda başka bir border router olması gerekir.

Hub derlemeniz şu şekilde doğrulanabilir: Parmağınızı üst kenardan aşağı kaydırın > Yapılandırma Çarkı > Cihaz Bilgileri > Teknik bilgiler > Chromecast donanım yazılımı sürümü

Devreye alma işlemi "Google ile bağlantı kurulamadı" hata mesajıyla başarısız oluyor

Developer Console içinde doğru VID/PID kombinasyonuyla bir entegrasyon oluşturduğunuzdan emin olun. Daha fazla bilgi için Matter entegrasyonu oluşturma başlıklı makaleyi inceleyin.

Devreye alma işlemi "Cihaza ulaşılamıyor" hata mesajıyla başarısız oluyor

Bir Thread cihazı devreye alırken "Cihaza erişilemiyor" hata mesajını almaya devam ediyorsanız ve mevcut tüm hata ayıklama seçeneklerini denediyseniz Ayarlar > Uygulamalar > Uygulama Uygulamaları > Google Play Hizmetleri > Depolama alanı ve önbellek > Alanı yönet > TÜM VERİLERİ TEMİZLE bölümünden Android telefonunuzda depolanan tercih edilen Thread kimlik bilgilerini temizleyerek temiz bir kurulum yapabilirsiniz.

Test

Yetkilendirilen cihaz, test paketinde görünmüyor

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

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

Doğru cihazı eşlediğinizi doğrulamak 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.

Sorun devam ederse

Buradaki tüm sorun giderme adımlarını uygulamanıza rağmen sorununuz çözülmediyse endişelenmeyin.

Sorun giderme adımlarında cihazınız, konsol projeniz ve ortamınız hakkında önemli veriler topladınız. Bu verileri aldıktan sonra, sorununuzu toplulukla ve Google Home Destek Ekibi ile en iyi şekilde nasıl paylaşacağınızı öğrenmek için Destek sayfasını inceleyin.