Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdzanie, czy telefon jest zgodny

Wszystkie urządzenia z Androidem Android O (8.1, interfejs API na poziomie 27) i nowszym są zgodne z Matter. Aby sprawdzić, czy telefon ma niezbędne moduły, wykonaj te czynności.

Konfigurowanie narzędzia 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.

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

Aby sprawdzić, czy masz moduły Google Play services Matter, wykonaj te czynności:

  1. Skonfiguruj Android Debug Bridge.
  2. Podłącz telefon Android do komputera za pomocą kabla USB.
  3. Uruchom to polecenie w terminalu, 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 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 to polecenie w terminalu, 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, 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 być inny.

Jeśli moduły nie są widoczne na liście, oznacza to, że:

  1. Masz nieaktualną wersję aplikacji Android. Upewnij się, że jest to wersja Android O (8.1) lub nowsza.
  2. Moduły Matter nie zostały jeszcze pobrane. Odczekaj co najmniej 24 godziny, aż zostaną pobrane. Upewnij się, że urządzenie jest włączone i ładuje się, aby nie opóźniać pobierania. Jeśli nie otrzymasz modułów w ciągu 24 godzin, możesz spróbować przywrócić dane fabryczne na urządzeniu, aby wymusić ich pobranie.

Sprawdzanie identyfikatora VID/PID urządzenia

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

Rozwiązywanie problemów z analizatorem Bluetooth

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

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

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

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

Aplikacja BLE wyświetla wartości w formacie little endian,ale wartości VID/PID wprowadzane w projekcie 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 danych z analizatora Bluetooth.

W przypadku wartości na przykładowym zrzucie ekranu identyfikatory VID i PID w Developer Console będą wynosić odpowiednio 235A i FEFF.

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

Huba Google Matter są zgodne z Matter 1.0 i zostały przetestowane z kompilacjami, które używały zatwierdzeń ze stabilnej gałęzi v1.0-branch. Sprawdź w informacjach o wersji publicznej, które zatwierdzenia są zalecane w przypadku każdej nowej wersji centrum.

Paruję

Weryfikowanie danych logowania na urządzeniu

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

  • Deklaracja certyfikatu (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.

Weryfikowanie koncentratora zgodnego ze standardem Matter

Koncentrator Matter musi być jednym z koncentratorów obsługiwanych przez Google. Musi też mieć kompilację zgodną ze standardem Matter.

Niektóre centra są też Thread Border Router (TBR), dzięki czemu umożliwiają tworzenie i testowanie urządzeń Thread. Inne centra obsługują tylko urządzenia Wi-Fi i Ethernet Matter, chyba że masz w sieci inne urządzenie border router, które umożliwia łączność Thread.

Kompilację huba możesz sprawdzić, przesuwając palcem w dół od górnej krawędzi > Koło konfiguracji > Informacje o urządzeniu > Informacje techniczne > Wersja oprogramowania Chromecasta.

Uruchomienie nie powiodło się i wyświetlił się komunikat o błędzie „Nie udało się skontaktować z Google”

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

Uruchomienie nie powiodło się i wyświetlił się komunikat o błędzie „Nie udało się znaleźć urządzenia”

Jeśli podczas dodawania urządzenia Thread nadal pojawia się komunikat o błędzie „Nie można połączyć się z urządzeniem” i wyczerpały się wszystkie dostępne opcje debugowania, możesz wyczyścić zapisane preferowane dane logowania Thread na telefonie z Androidem, aby przeprowadzić czystą konfigurację. Aby to zrobić, kliknij Ustawienia > Aplikacje > Wszystkie 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 zestawie testów

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

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

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

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

Jeśli problemy nie ustąpią

Jeśli po wykonaniu wszystkich opisanych tu czynności rozwiązywania problemów problem nadal nie został rozwiązany, nie martw się.

W ramach rozwiązywania problemów udało Ci się zebrać ważne dane o urządzeniu, projekcie konsoli i środowisku. Gdy będziesz mieć te dane, sprawdź na stronie pomocy, jak najlepiej opisać swój problem społeczności i zespołowi pomocy Google Home.