Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdzanie, czy telefon jest zgodny

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

Konfigurowanie Android Debug Bridge

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

  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. Aby sprawdzić, czy zainstalowane są niezbędne moduły Matter, uruchom to polecenie w terminalu: 
      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]
    Uwaga: numer wersji powyżej może być inny niż na Twoim urządzeniu.
  4. Aby sprawdzić, czy zainstalowane są niezbędne moduły Thread, uruchom to polecenie w terminalu: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Jeśli widzisz dane wyjściowe podobne do tych w przykładzie poniżej, masz zainstalowane moduły Thread: 
    com.google.android.gms.threadnetwork [v222106301]
    Uwaga: numer wersji na 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 Android O (8.1) lub nowsza wersja.
  2. Moduł Matter nie został jeszcze pobrany. Poczekaj co najmniej 24 godziny na pobranie. Pamiętaj, aby w tym czasie urządzenie było włączone i ładowane, aby pobieranie nie było opóźnione. Jeśli nie otrzymasz modułów w ciągu 24 godzin, możesz spróbować przywrócić dane fabryczne urządzenia, aby wymusić pobranie modułów.

Weryfikowanie VID/PID urządzenia

Jeśli chcesz zacząć tworzyć integrację z Google, musisz utworzyć projekt i integrację w konsoli Google Home.

Rozwiązywanie problemów z Bluetooth Sniffer

Wartość VID/PID, którą beaconuje urządzenie, powinna być zgodna z wartością VID/PID podana w projekcie Google Home Developer Console.

  • VIDs 0xFFF1 – 0xFFF4 są zarezerwowane do testowania. Mogą one służyć do podstawowych testów uruchomienia i kontroli, ale nie można ich używać w tych fazach rozwoju:

Za pomocą aplikacji do obsługi Bluetooth, takiej jak nRF Connect for Mobile, możesz sprawdzić VID/PID urządzenia emitującego sygnały beacon w polu Dane usługi.

Na tym zrzucie ekranu z wersji Android nRF Connect widać, że VID/PID jest wymieniony jako 5A23FFFE, zaczynając od czwartego bajtu pola Service Data. Wskazuje to VID 5A23 i PID FFFE – oba w formacie little-endian.

Aplikacja BLE wyświetla wartości w systemie little-endian, ale wartości VID/PID, które wpisujesz w projekcie Developer Console, są w systemie big-endian.

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

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

Sprawdź, czy urządzenie zostało skompilowane za pomocą zgodnego gałązki pakietu SDK Matter

Huby Google Matter są zgodne z Matter 1.0 i zostały przetestowane z kompilacją, która używała zatwierdzeń z stabilnej gałęzi v1.0-branch. Szczegółowe informacje o poszczególnych zatwierdzeniach zalecanych do użycia w przypadku każdej nowej wersji huba znajdziesz w notatkach do wersji publicznej.

Paruję

Weryfikowanie danych logowania urządzenia

Jeśli używasz własnego identyfikatora VID przypisanego przez Alliance, sprawdź, czy masz prawidłowe dane logowania na urządzeniu:

  • Deklaracja certyfikacyjna (CD).
  • certyfikat uwierzytelniający urządzenie (DAC) i jego łańcuch certyfikatów.

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

Sprawdzanie koncentratora zgodnego z Matter

Twój hub Matter musi być jednym z hubów obsługiwanych przez Google. Musi też być zgodna z wersją Matter.

Niektóre koncentratory są też routerami brzegowymi Thread, dzięki czemu można tworzyć i testować urządzenia Thread. Inne koncentratory obsługują tylko urządzenia z Wi-Fi i Ethernetem Matter, chyba że masz w swojej sieci inny router graniczny, który umożliwia połączenie z siecią Thread.

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

Wdrożenie nie udaje się z powodu komunikatu o błędzie „Nie udało się połączyć z Google”.

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

Wdrożenie nie udaje się z powodu komunikatu o błędzie „Nie można połączyć się z urządzeniem”.

Jeśli podczas uruchamiania urządzenia Thread ciągle pojawia się komunikat o błędzie „Nie można połączyć się z urządzeniem” i nie udało Ci się rozwiązać problemu za pomocą wszystkich dostępnych opcji debugowania, możesz wyczyścić z telefonu z Androidem przechowywane preferowane dane logowania Thread, aby ustawić urządzenie od nowa. Aby to zrobić, kliknij Ustawienia > Aplikacje > Aplikacje Google > Usługi Google Play > Pamięć i pamięć podręczna > Zarządzaj miejscem > WYCZYŚĆ WSZYSTKIE DANE.

Testowanie

Zarejestrowane urządzenie nie wyświetla się w pakiecie testów

Jeśli sparujesz urządzenie z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawi się ono, gdy spróbujesz przetestować urządzenie za pomocą Testowej suity w Developer Console, jest to prawdopodobnie spowodowane użyciem tej samej testowej kombinacji identyfikatorów VID i PID w różnych integracjach.

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

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

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

Jeśli coś pójdzie nie tak

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

Podczas wykonywania czynności rozwiązywania problemów zebrałeś/zebrałaś ważne dane o urządzeniu, projekcie w Konsoli i środowisku. Gdy już je będziesz mieć, zajrzyj na stronę pomocy, aby dowiedzieć się, jak najlepiej przekazać informacje o problemie społeczności i zespołowi pomocy Google Home.