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üm 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

Android Debug Bridge (adb), sorun giderme işleminden önce kurulmalı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ı etkinleştirin.

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

Google Play services Matter modüllerinizin olup olmadığını 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 bir 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ürseniz Matter modülleri yüklü demektir: 
    com.google.android.gms.home [v222110900]
     Yukarıdaki sürüm numarasının cihazınızdan farklı olabileceğini unutmayın.
  4. Gerekli modüllerin yüklü olduğunu doğrulamak için bir 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 örnektekine benzer bir çıkış görüyorsanız Thread modülleri yüklü demektir: 
    com.google.android.gms.threadnetwork [v222106301]
     Cihazınızdaki sürüm numarasının farklı olabileceğini unutmayın.

Modüller listelenmiyorsa aşağıdakilerden biri geçerlidir:

  1. Android sürümünüz eski. Android O (8.1) veya sonraki bir sürümün yüklü olduğundan emin olun.
  2. Matter modülleri henüz indirilmedi. İndirme işleminin tamamlanması için en az 24 saat bekleyin. İndirme işleminin gecikmemesi için cihazınızın açık ve şarjlı olduğundan emin olun. Modülleri 24 saat içinde almazsanız modülleri indirmeye zorlamak için cihazı fabrika ayarlarına sıfırlamayı deneyebilirsiniz.

Fuchsia hub cihaz günlükleri

Yerel günlüklerin alınması için bir merkez etkinleştirmek üzere:

  1. Cihazlarınızın seri numarasını ve modelini içeren bir e-posta gönderin.Technical Account Manager (TAM) Bu bilgiler, cihazın altında küçük harflerle belirtilir.
  2. İzin verilenler listesine eklendikten sonra aşağıdaki adımları uygulayarak özelliği etkinleştirmeniz gerekir:
    • Merkezin üzerinden:
      1. Ekranın üst kısmından aşağı doğru kaydırın
      2. Ayarlar simgesine dokunun.
      3. Fuchsia sürümünü bulma: Google Nest Hub (2nd gen) cihazında Cihaz bilgileri > Teknik bilgiler > Fuchsia sürümü'ne gidin.
      4. "Fuchsia Sürümü"ne 7 kez dokunun. Bu işlem, geliştirici seçeneklerini etkinleştirir.
      5. Üst düzey menüye dön
      6. "Geliştirici seçenekleri"ne dokunun.
      7. "İş Ortağı Günlüğü"ne dokunun.
    • Bu özellik 24 saat boyunca etkinleştirilir. Ardından, 5. adımdan itibaren günlük kaydı özelliğini yeniden etkinleştirin.
  3. Merkezinizin IP adresini alın:
    • Ekranı varsa hub'dan:
      1. Ekranın üst kısmından aşağı doğru kaydırın
      2. Ayarlar simgesine dokunun.
      3. Cihazın IP adresini bulma: Nest Hub (2nd gen) cihazında Cihaz bilgileri > Teknik bilgiler > IP Adresi'ne gidin.
    • Telefonunuzdaki Google Home app (GHA)'ten:
      1. Cihaz ayrıntıları sayfasını açmak için cihaza dokunun.
      2. Ayarlar sayfasını açmak için Ayarlar simgesine dokunun
      3. Cihazın IP adresini bulun: Cihaz bilgileri > Teknik bilgiler > IP adresi'ne gidin.
  4. Merkezin günlüklerini almak için aynı kablosuz ağdaki bir bilgisayardan merkeze GET HTTP isteği gönderirsiniz.
    • Uç noktanın bağlantı noktasını ve yolunu not edin: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • Bağlantı yalnızca bir dakika açık tutulabilir ancak arabellekten alınan veriler genellikle 20-30 dakika önceki etkinlikleri içerir.
      • İdeal olarak, arabelleğin testle alakalı içerik içerdiğinden emin olmak için günlükler, bir test prosedürü tamamlandıktan hemen sonra bu yöntem kullanılarak ayıklanır (Android hata raporlarına benzer).

Android günlüklerinin azaltılmasını devre dışı bırakma

  • Gizlilik ve güvenlik nedeniyle bu özellik yalnızca mühendislik testleri için kullanılmalıdır.
  • Bu seçeneği üretim cihazları veya kullanıcılarıyla kullanmayın.
  • Adımlar:
    1. Günlüklerinin sansürsüz olarak gösterileceği kullanıcıların Google Hesaplarını Google TAM hesabınıza gönderin.
    2. Hesabınızın izin verilenler listesine eklendiğini onayladıktan sonra telefonunuzu yeniden başlatın.

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 aşağıdaki geliştirme aşamalarında kullanılamazlar:

nRF Connect for Mobile gibi bir Bluetooth mühendislik uygulaması kullanarak Hizmet Verileri alanında işaretçi cihazın VID/PID'sini 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 itibaren 5A23FFFE olarak listelendiğini görebilirsiniz. Bu, 5A23 VID'sini ve FFFE PID'sini gösterir. Her ikisi de little endian biçimindedir.

BLE uygulaması değerleri küçük endian olarak gösterir ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endian olarak gösterilir.

Bluetooth sniffer'ın gösterdiğine göre Actions Console projenize doğru değerlerin ve biçimin girildiğini doğrulayın.

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

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

Google Matter hub'ları Matter 1.0 ile uyumludur ve v1.0-branch kararlı dalındaki taahhütleri kullanan derlemelerle test edilmiştir. Her yeni merkez sürümüyle birlikte kullanılması önerilen belirli taahhütler 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 atanan VID'nizi kullandığınızda cihazınızda doğru kimlik bilgilerine sahip olduğunuzdan emin olun:

  • Sertifika Beyannamesi (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 merkeziniz, Google tarafından desteklenen merkezlerden biri olmalıdır. Ayrıca, Matter ile uyumlu bir derleme üzerinde olmalıdır.

Bazı hub'lar aynı zamanda Thread Sınır Yönlendiricisi olduğundan Thread cihazları geliştirip test etmenize olanak tanır. Ağınızda Thread bağlantısını etkinleştirecek başka bir sınır yönlendiriciniz yoksa diğer merkezler yalnızca kablosuz ve Ethernet Matter cihazlarını destekler.

Hub'ınızın derlemesini şu şekilde doğrulayabilirsiniz: Parmağınızı üst kenardan aşağı kaydırın > Yapılandırıcı tekerlek > Cihaz bilgileri > Teknik bilgiler > Chromecast donanım yazılımı sürümü

"Google ile iletişim kurulamadı" hata mesajıyla birlikte devreye alma işlemi 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.

"Cihazla bağlantı kurulamıyor" hata mesajıyla birlikte devreye alma işlemi başarısız oluyor

Bir Thread cihazı devreye alırken "Cihaza ulaşılamıyor" hata mesajı almaya devam ediyorsanız ve mevcut tüm hata ayıklama seçeneklerini denediyseniz temiz bir kurulum için Android telefonunuzdaki depolanan tercih edilen Thread kimlik bilgilerini Ayarlar > Uygulamalar > Uygulama Uygulamaları > Google Play Hizmetleri > Depolama alanı ve önbellek > Alanı yönet > TÜM VERİLERİ TEMİZLE'yi seçerek temizleyebilirsiniz.

Test

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

Bir cihazı test amaçlı bir tedarikçi kimliği (VID) ve ürün kimliği (PID) ile eşlediniz ancak Developer Console'de cihazı Test Paketi ile test etmeye çalıştığınızda cihaz görünmüyorsa bunun nedeni muhtemelen birden fazla entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.

Sorun gidermek için tüm test cihazlarını Developer Console'ten kaldırın ve tekrar test etmek istediğiniz cihazı 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 yaşamaya devam ederseniz

Buradaki tüm sorun giderme adımlarını uyguladıktan sonra sorununuz çözülmediyse endişelenmeyin.

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