Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdź, czy Twój telefon jest kompatybilny

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

Skonfiguruj Android Debug Bridge

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

  1. Zainstaluj „adb” na komputerze.
  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, Sprawdź, czy 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.

Sprawdź VID/PID swojego 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 urządzenie, powinna być zgodna z wartością VID/PID wpisaną w projekcie Google Home Developer Console.

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

Korzystając z aplikacji inżynieryjnej Bluetooth, np. nRF Connect for Mobile, możesz zobaczyć identyfikator dostawcy i produktu urządzenia wysyłającego sygnał w polu Service Data (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 VID 5A23 i 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 wersją 1.0Matter i zostały przetestowane z kompilacjami, które wykorzystywały commity z 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.

Zweryfikuj swój hub kompatybilny z Matter

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

Możesz zweryfikować kompilację swojego huba, wykonując następujące czynności: Przesuń palcem w dół od górnej krawędzi > Koło konfiguracji > Informacje o urządzeniu > Informacje techniczne > Wersja oprogramowania układowego Chromecasta

Uruchomienie kończy się niepowodzeniem i pojawia się komunikat o błędzie „Nie można nawiązać kontaktu 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.

Nie udało się uruchomić urządzenia. Pojawia się komunikat o błędzie „Nie można nawiązać połączenia z urządzeniem”

Jeśli podczas uruchamiania urządzenia Thread ciągle pojawia się komunikat o błędzie „Nie można nawiązać połączenia z urządzeniem” i wyczerpałeś wszystkie dostępne opcje debugowania, możesz wyczyścić zapisane preferowane dane logowania Thread na telefonie z systemem Android, aby przeprowadzić czystą konfigurację, wybierając kolejno Ustawienia > Aplikacje > Aplikacje > Usługi Google Play > Pamięć masowa 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 testowego 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 prawidłowo sparowane, możesz ustawić informacje o producencie i modelu (CHIP_DEVICE_CONFIG_DEVICE_* wartości) 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 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.