Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdzanie, czy telefon jest zgodny

Wszystkie Android O (8.1, poziom interfejsu API 27) i nowsze urządzenia są zgodne z Matter. Aby sprawdzić, czy Twój telefon ma niezbędne moduły, wykonaj te czynności.

Konfigurowanie Android Debug Bridge

Przed rozpoczęciem rozwiązywania problemów należy skonfigurować Android Debug Bridge (adb). Aby go skonfigurować:

  1. Zainstaluj "adb" na komputerze.
  2. Włącz na telefonie Android Opcje programisty i Debugowanie.

Sprawdzanie modułów Matter w Usługach Google Play

Aby sprawdzić, czy masz moduły Google Play services Matter:

  1. Skonfiguruj Android Debug Bridge.
  2. Podłącz telefon Android do komputera za pomocą kabla USB.
  3. Uruchom w terminalu to polecenie, aby sprawdzić, czy zainstalowane są niezbędne Matter moduły: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    Jeśli zobaczysz dane wyjściowe podobne do tych poniżej, oznacza to, że masz zainstalowane moduły Matter: 
    com.google.android.gms.home [v222110900]
     Pamiętaj, że numer wersji powyżej może się różnić od numeru wersji na Twoim urządzeniu.
  4. Uruchom w terminalu to polecenie, aby sprawdzić, czy zainstalowane są niezbędne Thread moduły: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Jeśli zobaczysz dane wyjściowe podobne do tych w poniższym przykładzie, oznacza to, że masz zainstalowane moduły Thread: 
    com.google.android.gms.threadnetwork [v222106301]
     Pamiętaj, że numer wersji na Twoim urządzeniu może się różnić.

Jeśli moduły nie są wymienione, oznacza to, że:

  1. Masz nieaktualną wersję Android. Upewnij się, że jest to Android O (8.1) lub nowszy.
  2. Moduły Matter nie zostały jeszcze pobrane. Poczekaj co najmniej 24 godziny, aż się pobiorą. W tym czasie urządzenie musi być włączone i ładować się, aby pobieranie nie zostało opóźnione. Jeśli moduły nie zostaną pobrane w ciągu 24 godzin, możesz przywrócić dane fabryczne urządzenia, aby wymusić pobranie modułów.

Sprawdzanie identyfikatora dostawcy i identyfikatora produktu urządzenia

Jeśli chcesz rozpocząć tworzenie integracji z Google, musisz utworzyć projekt i integrację w Konsoli Google Home.

Rozwiązywanie problemów z Bluetooth Sniffer

Wartość identyfikatora dostawcy i identyfikatora produktu, którą urządzenie wysyła w sygnale, powinna być zgodna z wartością identyfikatora dostawcy i identyfikatora produktu wpisaną w projekcie Google Home Developer Console.

  • Identyfikatory dostawcy 0xFFF1–0xFFF4 są zarezerwowane do testowania. Można ich używać do podstawowych testów uruchamiania i sterowania, ale nie można ich używać w tych fazach programowania:

Za pomocą aplikacji inżynieryjnej Bluetooth, takiej jak nRF Connect for Mobile, możesz sprawdzić identyfikator dostawcy i identyfikator produktu urządzenia wysyłającego sygnał w polu Dane usługi.

Na tym zrzucie ekranu z wersji nRF Connect Android widać, że identyfikator dostawcy i identyfikator produktu są wymienione jako 5A23FFFE począwszy od czwartego bajtu pola Dane usługi. Oznacza to identyfikator dostawcy 5A23 i identyfikator produktu FFFE – oba w formacie little endian.

Aplikacja BLE wyświetla wartości w formacie little endian, ale wartości identyfikatora dostawcy i identyfikatora produktu które wpisujesz w projekcie w Developer Console są w formacie big endian.

Sprawdź, czy w projekcie w Konsoli Actions zostały wpisane prawidłowe wartości i format na podstawie tego, co pokazuje sniffer Bluetooth.

W przypadku wartości na przykładowym zrzucie ekranu identyfikator dostawcy i identyfikator produktu w Developer Console będą odpowiednio 235A i FEFF.

Sprawdzanie, czy urządzenie zostało utworzone przy użyciu zgodnej gałęzi pakietu SDK Matter

Urządzenia Google Matter są zgodne z Matter 1.0 i zostały przetestowane z kompilacjami, które używały commitów ze stabilnej gałęzi v1.0-branch. W informacjach o wersji publicznej znajdziesz konkretne commity zalecane do użycia z każdą nową wersją urządzenia.

Paruję

Sprawdzanie danych logowania urządzenia

Jeśli używasz Alliance-przypisanego identyfikatora dostawcy, upewnij się, że masz prawidłowe dane logowania na urządzeniu:

  • Deklaracja certyfikacji (CD).
  • Certyfikat atestu urządzenia (DAC) i jego łańcuch certyfikatów.

Więcej informacji znajdziesz w artykule Tworzenie certyfikatów testowych urządzeń Matter.

Sprawdzanie urządzenia zgodnego z Matter

Urządzenie Matter musi być jednym z urządzeń obsługiwanych przez Google. Musi też być kompilacją zgodną z Matter.

Niektóre urządzenia są też routerami granicznymi Thread , dzięki czemu możesz tworzyć i testować urządzenia Thread. Inne urządzenia obsługują tylko urządzenia Matter Wi-Fi i Ethernet Matter chyba że masz w sieci inny router graniczny, który umożliwia łączność Thread.

Kompilację urządzenia możesz sprawdzić, wykonując te czynności: Przesuń palcem z góry ekranu w dół > Koło konfiguracji > Informacje o urządzeniu > Informacje techniczne > Wersja oprogramowania Chromecast.

Uruchamianie nie powiodło się z powodu komunikatu o błędzie „Nie udało się skontaktować z Google”

Upewnij się, że w Konsoli dla deweloperów utworzono integrację z prawidłową kombinacją identyfikatora dostawcy i identyfikatora produktu w Developer Console. Więcej informacji znajdziesz w artykule Tworzenie integracji Matter.

Uruchamianie nie powiodło się z powodu komunikatu o błędzie „Nie można połączyć się z urządzeniem”

Jeśli podczas uruchamiania urządzenia Thread nadal pojawia się komunikat o błędzie „Nie można połączyć się z urządzeniem” i wyczerpałeś(-aś) wszystkie dostępne opcje debugowania , możesz wyczyścić zapisane preferowane dane logowaniaThread na telefonie z Androidem, aby przeprowadzić czystą konfigurację. Aby to zrobić, otwórz Ustawienia > Aplikacje > Aplikacje > Usługi Google Play > Pamięć wewnętrzna i podręczna > Zarządzaj miejscem > WYCZYŚĆ WSZYSTKIE DANE.

Testowanie

Uruchomione urządzenie nie pojawia się w pakiecie testów

Jeśli urządzenie zostało sparowane z testowym identyfikatorem dostawcy i identyfikatorem produktu, ale nie pojawia się, gdy próbujesz przetestować je za pomocą pakietu testów w Developer Console, prawdopodobnie jest to spowodowane używaniem tej samej kombinacji testowego identyfikatora dostawcy i identyfikatora produktu w wielu integracjach.

Aby rozwiązać ten problem, usuń wszystkie urządzenia testowe z Developer Console i ponownie sparuj urządzenie, które chcesz przetestować.

Aby sprawdzić, czy urządzenie zostało prawidłowo sparowane, możesz ustawić informacje o producencie i modelu (CHIP_DEVICE_CONFIG_DEVICE_*) na unikalne wartości w oprogramowaniu testowym.

Więcej informacji znajdziesz w sekcji Informacje o urządzeniu.

Jeśli nadal występują problemy

Jeśli po wykonaniu wszystkich opisanych tu czynności nadal występują problemy, nie martw się.

Podczas rozwiązywania problemów zebrano ważne dane o urządzeniu, projekcie w konsoli i środowisku. Mając te dane, sprawdź stronę pomocy, aby dowiedzieć się, jak najlepiej podzielić się problemem ze społecznością i zespołem pomocy Google Home.