Konu Sorunlarını Giderme

Köprü

Telefonunuzun uyumlu olduğunu doğrulayın

Tüm Android O (8.1, API düzeyi 27) ve sonraki 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" yükleyin.
  2. Android telefonunuzda Geliştirici Seçenekleri ve USB Hata Ayıklaması'nı açın.

Google Play Hizmetleri (GPS) Matter modüllerinizi doğrulayın

Google Play services Matter modülüne 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 Matter modüllerinin yüklü olduğunu doğrulamak için bu komutu bir terminalde çalıştırın: 
      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 Thread modüllerinin yüklü olduğunu doğrulamak için bu komutu bir terminalde çalıştırın: 
      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ürseniz 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 listelenmemişse:

  1. Eski bir Android sürümünüz var. Android O (8.1) veya üzeri bir değer olduğundan emin olun.
  2. Matter modül henüz indirilmedi. İndirmeleri için en az 24 saat bekleyin. İndirme işleminin gecikmemesi için bu süre zarfında cihazınızın açık olduğundan ve şarj olduğundan emin olun. Modülleri 24 saat içinde almazsanız modülleri indirmeye zorlamak için cihazı fabrika verilerine sıfırlamayı deneyebilirsiniz.

Fuchsia hub cihaz günlükleri

Bir merkezi yerel günlük almak üzere etkinleştirmek için:

  1. Google Technical Account Manager (TAM) cihazınıza cihazlarınızın seri numarası ve modelini içeren bir e-posta gönderin. Bu numaraları cihazın altında küçük harflerle bulabilirsiniz.
  2. İzin verilenler listesine eklendikten sonra bu özelliği aşağıdaki adımları uygulayarak etkinleştirmeniz gerekir:
    • Merkezden:
      1. Ekranın üstünden aşağı doğru kaydırın.
      2. Ayarlar simgesine dokunun
      3. Fuchsia sürümünü bulun: Google Nest Hub (2nd gen) cihazınızda Cihaz bilgileri > Teknik bilgiler > Fuchsia Sürümü bölümüne gidin
      4. "Fuşya Sürümü"ne 7 kez dokunun. Bu, geliştirici seçeneklerini etkinleştirir
      5. Üst düzey menüye dön
      6. "Geliştirici seçenekleri"ne dokunun
      7. "Partner Logging"e (İş Ortağı Günlük Kaydı) dokunun.
    • Bu özellik 24 saat boyunca etkin olacaktır. Bunun ardından, 5. adımdan itibaren günlük kaydı özelliğini yeniden etkinleştirin.
  3. Hub'ınızın IP adresini alın:
    • Hub'da bir ekran varsa:
      1. Ekranın üstünden aşağı doğru kaydırın.
      2. Ayarlar simgesine dokunun
      3. Cihazın IP adresini bulun: Nest Hub (2nd gen) için Cihaz bilgileri > Teknik bilgiler > IP Adresi bölümüne gidin.
    • Telefonunuzdaki Google Home app (GHA) uygulamasından:
      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. Günlükleri merkezden almak için, aynı kablosuz ağdaki bir bilgisayardan hub'a GET HTTP isteğinde bulunursunuz.
    • 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 boyunca açık tutulabilir ancak arabellekten alınan veriler genellikle 20-30 dakikalık geçmiş etkinliklere sahiptir.
      • İdeal olarak, arabelleğin testle ilgili içerik barındırdığından (Android hata raporlarına benzer) emin olmak için, bir test prosedürü tamamlandıktan hemen sonra günlükler bu yöntem kullanılarak ayıklanır.

Android Günlüklerinin çıkartılmasını devre dışı bırak

  • Gizlilik ve güvenlik nedeniyle bu özellik yalnızca mühendislik testleri amacıyla kullanılmalıdır.
  • Bu seçeneği üretim cihazları veya kullanıcılarıyla kullanmayın.
  • Adımlar:
    1. Çıkartılmamış günlüklere sahip olacak kullanıcıların Google Hesaplarını, Google TAM cihazınıza gönderin.
    2. Hesabınızın izin verilenler listesine eklendiğini doğruladıktan sonra telefonunuzu yeniden başlatın.

Cihazınızın VID/PID'sini 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 ile İlgili Sorun Giderme

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

  • 0xFFF1 — 0xFFF4 VID'leri test amaçlıdı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ını kullanarak işaretleme 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, Service Data alanının dördüncü baytından başlayarak VID/PID'nin 5A23FFFE olarak listelendiğini göreceksiniz. Bu, 5A23 VID'sini ve FFFE PID'yi gösterir. Her ikisi de küçük endian biçiminde olur.

BLE uygulaması,değerleri küçük endian cinsinden görüntüler ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endian değerindedir.

Bluetooth yoklayıcının gösterdiği bilgilere 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ğrulayın.

Google Matter hub'ları Matter 1.0 ile uyumludur ve v1.0-branch kararlı dalından taahhütleri kullanan derlemelerle test edilmiştir. Her yeni hub sürümünde kullanılması önerilen belirli kaydetmeler için Herkese açık sürüm notlarını kontrol edin.

Eşleniyor

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

Alliance atanmış VID'inizi 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 Konu cihaz test sertifikaları oluşturma bölümüne bakın.

Matter uyumlu Hub'ınızı doğrulayın

Matter merkeziniz, Google tarafından desteklenen merkezlerden biri olmalıdır. Ayrıca öğe, Matter ile uyumlu bir derleme üzerinde de olmalıdır.

Bazı hub'lar aynı zamanda Thread Kenarlığı Yönlendiricilerdir ve dolayısıyla Thread cihazları geliştirip test etmenize olanak tanır. Diğer merkezler, ağınızda Thread bağlantısını etkinleştirmek için başka bir sınır yönlendiriciniz olmadığı sürece yalnızca kablosuz ağ ve Ethernet Matter cihazlarını destekler.

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

Devreye alma işlemi, "Google ile iletişim kurulamadı" hata mesajıyla başarısız oluyor

Developer Console içinde doğru VID/PID kombinasyonuyla entegrasyon oluşturduğunuzdan emin olun. Daha fazla bilgi için Konu entegrasyonu oluşturma bölümüne bakın.

Devreye alma işlemi, "Cihaza erişilemiyor" hata mesajıyla başarısız oluyor

Bir Thread cihazı devreye sokarken sürekli "Cihaza ulaşılamıyor" hata mesajı almaya devam ederseniz ve mevcut tüm hata ayıklama seçeneklerini kullandıysanız Ayarlar > Uygulamalar > Uygulama Uygulamaları > Google Play Hizmetleri > Depolama ve önbellek > Alanı yönet > TÜM VERİLERİ TEMİZLE'ye giderek temiz bir kurulum için Android telefonunuzda depolanan Thread kimlik bilgilerini temizlemek isteyebilirsiniz.

Test

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

Bir cihazı test Tedarikçi Kimliği (VID) ve Ürün Kimliği (PID) ile eşlediyseniz ancak Developer Console ürününde cihazı Test Paketi ile test etmeye çalıştığınızda bu hata görünmüyorsa muhtemelen birden çok entegrasyonda aynı test VID ve PID birleşiminin kullanılmasından kaynaklanmaktadır.

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

Doğru cihazı eşlediğinizi onaylamak 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 sorun değil.

Sorun giderme adımlarında cihazınız, konsol projeniz ve ortamınızla ilgili önemli verileri topladınız. Bu veriler elinizdeyken, sorununuzu topluluk ve Google Home destek ekibiyle en iyi şekilde nasıl paylaşacağınızı öğrenmek için Destek sayfasına göz atın.