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 zrobić:

  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 starszej wersji Android. Upewnij się, że jest to Android O (8.1) lub nowsza wersja.
  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ć urządzenie do ustawień fabrycznych, 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.

  • VIDs 0xFFF1 — 0xFFF4 są zarezerwowane do testowania. Można ich używać do podstawowych testów uruchamiania i sterowania, ale nie można ich stosować w trakcie tych etapów rozwoju:

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

Na tym zrzucie ekranu z wersji Android aplikacji nRF Connect widać, że identyfikator VID/PID jest wymieniony 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 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 wersją Matter 1.0 i zostały przetestowane z kompilacjami, które wykorzystywały commity ze stabilnej gałęzi v1.0-branch. W informacjach o wersji publicznej znajdziesz konkretne commity zalecane do użycia z każdą nową wersją huba.

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

Twój hub Matter musi być jednym z hubów obsługiwanych przez Google. Musi też być na kompilacji zgodnej 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”

Sprawdź, czy integracja została utworzona z prawidłową kombinacją identyfikatorów VID/PID w Developer Console. 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życiem 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.