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üllere sahip 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) kurulmalıdır. Hangout planlamak için:

  1. Bilgisayarınıza "adb"yi 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ü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 Matter modüllerinin yüklü olduğunu doğrulamak için şu 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 yüklü olan Matter modülleri vardır: 
    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 şu 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 örneğe benzer bir çıkış görürseniz 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 listelenmemişse, bu aşağıdakilerden biri demektir:

  1. Eski bir Android sürümünüz var. Android O (8.1) veya sonraki bir sürümde olduğundan emin olun.
  2. Matter modül henüz indirilmedi. İndirme işlemi için en az 24 saat bekleyin. Bu sırada cihazınızın açık olduğundan ve şarj edildiğinden emin olun. Böylece indirme işlemi gecikmez. Modülleri 24 saat içinde almazsanız modüllerin indirilmesini sağlamak için cihazı fabrika verilerine sıfırlamayı deneyebilirsiniz.

Fuchsia hub cihaz günlükleri

Yerel günlükleri almak üzere bir merkez etkinleştirmek için:

  1. Google Technical Account Manager (TAM) cihazınıza cihazlarınızın seri numarasını ve modelini içeren bir e-posta gönderin. Bu bilgiler cihazın altında küçük harflerle bulunur.
  2. İzin verilenler listesine eklendikten sonra aşağıdaki adımları uygulayarak bu özelliği 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ında Cihaz bilgileri > Teknik bilgiler > Fuchsia Sürümü'ne gidin.
      4. "Fuşya Sürümü"ne 7 kez dokunun. Bu, geliştirici seçeneklerini etkinleştirecek
      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. Ardından, 5. adımdan itibaren günlük kaydı özelliğini yeniden etkinleştirin.
  3. Merkezinizin IP adresini alın:
    • Merkezinden, 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) cihazında Cihaz bilgileri > Teknik bilgiler > IP adresi'ne gidin.
    • Telefonunuzdaki Google Home app (GHA) hesabı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 merkeze bir 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 arabelleğe alınan verilerde genellikle 20-30 dakikalık geçmiş etkinlikler bulunur.
      • İdeal olarak günlükler, tamponun testle ilgili içerik barındırdığından emin olmak için (Android hata raporlarına benzer) bir test prosedürü tamamlandıktan hemen sonra bu yöntem kullanılarak alınır.

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

  • Gizlilik ve güvenlik açısından bu özellik yalnızca mühendislik testi amacıyla kullanılmalıdır.
  • Bu seçeneği üretim cihazları veya kullanıcılarla kullanmayın.
  • Adımlar:
    1. Çıkartılmamış günlüklerine 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 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 sorunlarını 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 video kimlikleri test için ayrılmıştır. Temel devreye alma 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'nin Hizmet Verileri alanının dördüncü baytından başlayarak 5A23FFFE olarak listelendiğini görürsünüz. Bu, her ikisi de küçük endian biçiminde, 5A23 VID'si ve FFFE PID'si olduğunu gösterir.

BDE uygulaması,değerleri küçük endian içinde gösterir ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endian'dadır.

Bluetooth algılayıcının gösterdiklerine 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 derlendiğini doğrulayın

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

Eşleniyor

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

Alliance tarafından atanan kendi 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ğrulayın

Matter merkeziniz Google tarafından desteklenen merkezlerden biri olmalıdır. Aynı zamanda Matter ile uyumlu bir yapıda olmalıdır.

Bazı merkezler aynı zamanda İş Parçacığı Sınırı Yönlendiricileridir ve bu sayede Thread cihazları geliştirip test edebilirsiniz. Ağınızda Thread bağlantısını etkinleştirecek başka bir sınır yönlendirici yoksa diğer merkezler yalnızca kablosuz ve Ethernet Matter cihazlarını destekler.

Hub yapınız, Parmağınızı üst kenardan aşağı doğru kaydırarak > Yapılandırma Tekerleği > Cihaz Bilgileri > Teknik bilgiler > Chromecast donanım yazılımı sürümü kullanılarak doğrulanabilir.

Devreye alma, "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, "Cihaza ulaşılamıyor" hata mesajını vererek başarısız oluyor

Bir Thread cihazı devreye alırken "Cihaza erişilemiyor" hata mesajı almaya devam ediyorsanız ve mevcut tüm hata ayıklama seçeneklerini kullandıysanız ve temiz bir kurulum için Android telefonunuzda 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'ye giderek temizleyebilirsiniz.

Test

Devreye alınan 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 içinde cihazı Test Paketi ile test etmeye çalıştığınızda bu cihaz görünmüyorsa bunun nedeni büyük olasılıkla birden fazla entegrasyonda aynı test VID'si ve PID kombinasyonunun kullanılmasıdır.

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

Doğru cihazı eşleştirdiğinizi doğrulamak için cihazın Üretici ve Model bilgilerini (CHIP_DEVICE_CONFIG_DEVICE_* değer) 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ı 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 verileri elde ettikten sonra sorununuzu topluluk ve Google Home destek ekibiyle en iyi şekilde nasıl paylaşabileceğinizi öğrenmek için Destek sayfasına göz atın.