Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdź, czy telefon jest zgodny

Wszystkie urządzenia z Androidem AndroidO (8.1, poziom interfejsu API 27) i nowszym są zgodne z Matter. Aby sprawdzić, czy telefon ma wymagane 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 to skonfigurować:

  1. Zainstaluj na komputerze narzędzie „adb”.
  2. Włącz Opcje programisty i debugowanie USB na telefonie Android.

Weryfikowanie modułów Matter w Usługach Google Play (GPS)

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 moduły:Matter
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    Jeśli widzisz dane wyjściowe podobne do tych poniżej, 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 moduły:Thread
      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, masz zainstalowane moduły Thread: 
    com.google.android.gms.threadnetwork [v222106301]
     Pamiętaj, że numer wersji na Twoim urządzeniu może być inny.

Jeśli modułów nie ma na liście, oznacza to, że:

  1. używasz przestarzałej wersji Android, Upewnij się, że jest to wersja AndroidO (8.1) lub nowsza.
  2. Moduły Matter nie zostały jeszcze pobrane. Poczekaj co najmniej 24 godziny, aż się pobiorą. Upewnij się, że urządzenie jest włączone i ładowane, 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ć ich pobranie.

Sprawdzanie identyfikatora dostawcy i 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 narzędziem Bluetooth Sniffer

Wartość VID/PID, którą wysyła Twoje urządzenie, powinna być zgodna z wartością VID/PID wpisaną w Google Home Developer Console projekcie.

  • VID0xFFF1 – 0xFFF4są zarezerwowane do testowania. Można ich używać do podstawowych testów uruchamiania i sterowania, ale nie można ich używać w trakcie tych etapów rozwoju:

Za pomocą aplikacji inżynieryjnej Bluetooth, takiej jak nRF Connect for Mobile, możesz sprawdzić identyfikator VID/PID urządzenia wysyłającego sygnał w polu Service Data (Dane usługi).

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

Aplikacja BLE wyświetla wartości w formacie little endian,ale wartości VID/PID wpisywane w projekcie Developer Console są w formacie big endian.

Sprawdź, czy w projekcie konsoli Actions zostały wpisane prawidłowe wartości i formaty na podstawie danych wyświetlanych przez sniffer Bluetooth.

W przypadku wartości na przykładowym zrzucie ekranu identyfikatory VID i PID w Developer Console to odpowiednio 235A i FEFF.

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

Huby Google Matter są zgodne z Matter 1.0 i zostały przetestowane z kompilacjami, które wykorzystywały commity ze stabilnej gałęzi v1.0-branch. Konkretne commity zalecane do użycia z każdą nową wersją huba znajdziesz w informacjach o wersji publicznej.

Paruję

Weryfikowanie danych logowania na urządzeniu

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

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

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

Weryfikowanie huba zgodnego z Matter

Matter Centrala musi być jedną z centrali obsługiwanych przez Google. Musi też mieć kompilację zgodną z Matter.

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

Wersję kompilacji huba możesz sprawdzić, wykonując te czynności: przesuń palcem od górnej krawędzi ekranu w dół > ikona koła zębatego > Informacje o urządzeniu > Informacje techniczne > wersja oprogramowania Chromecasta.

Występuje błąd „Nie udało się skontaktować z Google”

Upewnij się, że w Developer Console masz utworzoną integrację z prawidłową kombinacją VID/PID. Więcej informacji znajdziesz w artykule Tworzenie integracji Matter.

Występuje błąd „Nie można nawiązać połączenia z urządzeniem”

Jeśli podczas konfigurowania urządzeniaThread 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 preferowaneThread dane logowania na telefonie z Androidem, aby przeprowadzić czystą konfigurację. Aby to zrobić, kliknij Ustawienia > Aplikacje > Aplikacje > Usługi Google Play > Pamięć i pamięć podręczna > Zarządzaj miejscem > WYCZYŚĆ WSZYSTKIE DANE.

Testowanie

Urządzenie po włączeniu nie pojawia się w pakiecie testów

Jeśli urządzenie zostało sparowane z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się podczas próby testowania urządzenia za pomocą pakietu testów w Developer Console, prawdopodobnie jest to spowodowane używaniem tej samej kombinacji testowych identyfikatorów VID i PID w wielu integracjach.

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

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

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

Jeśli nadal coś pójdzie nie tak

Jeśli po wykonaniu wszystkich tych czynności problem nadal występuje, nie martw się.

W ramach rozwiązywania problemów zebrano ważne dane o urządzeniu, projekcie 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.