Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdź, 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 Google Play Services (GPS) Matter

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. Upewnij się, że urządzenie jest włączone i ładuje się, aby nie opóźnić pobierania. Jeśli w ciągu 24 godzin nie otrzymasz modułów, możesz spróbować przywrócić dane fabryczne urządzenia, aby wymusić pobranie modułów.

Dzienniki urządzenia Fuchsia

Aby włączyć hub do pobierania logów lokalnych:

  1. Wyślij e-maila z numerem seryjnym i modelem urządzenia do Technical Account Manager (TAM) Google. Znajdziesz je w małej czcionce pod urządzeniem.
  2. Gdy Twoje konto znajdzie się na liście dozwolonych, musisz włączyć tę funkcję, wykonując te czynności:
    • Na panelu:
      1. Przesuń palcem z góry ekranu w dół
      2. Kliknij ikonę ustawień .
      3. Znajdź wersję Fuchsia: na urządzeniu Google Nest Hub (2nd gen) otwórz Informacje o urządzeniu > Informacje techniczne > Wersja Fuchsia.
      4. Kliknij 7 razy „Wersja Fuchsia”. Włącza to opcje programisty.
      5. Powrót do menu najwyższego poziomu
      6. Kliknij „Opcje programisty”.
      7. Kliknij „Partner Logging” (Rejestrowanie partnera).
    • Ta funkcja będzie włączona przez 24 godziny. Następnie od kroku 5 ponownie włącz funkcję rejestrowania.
  3. Uzyskaj adres IP koncentratora:
    • Na ekranie koncentratora (jeśli jest on wyposażony w ekran):
      1. Przesuń palcem z góry ekranu w dół
      2. Kliknij ikonę ustawień .
      3. Znajdź adres IP urządzenia: na urządzeniu Nest Hub (2nd gen) otwórz Informacje o urządzeniu > Informacje techniczne > Adres IP.
    • Na telefonie w aplikacji Google Home app (GHA):
      1. Kliknij urządzenie, aby otworzyć stronę z informacjami o nim.
      2. Kliknij ikonę Ustawienia , aby otworzyć stronę ustawień.
      3. Znajdź adres IP urządzenia: Informacje o urządzeniu > Informacje techniczne > Adres IP.
  4. Aby pobrać dzienniki z huba, wyślij żądanie HTTP GET do huba z komputera w tej samej sieci Wi-Fi.
    • Zanotuj port i ścieżkę punktu końcowego: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • Połączenie może być otwarte tylko przez minutę, ale dane pobrane z bufora zwykle obejmują 20–30 minut wcześniejszych zdarzeń.
      • Najlepiej jest wyodrębnić dzienniki za pomocą tej metody bezpośrednio po zakończeniu procedury testowej, aby mieć pewność, że bufor zawiera treści istotne dla testu (podobnie jak raporty o błędach Androida).

Wyłączanie pomijania logów Androida

  • Ze względu na ochronę prywatności i bezpieczeństwo należy używać tej funkcji tylko do celów testowania technicznego.
  • Nie używaj tej opcji w przypadku urządzeń czy użytkowników w wersji produkcyjnej.
  • Kroki:
    1. Prześlij do swojego konta Google TAM konta Google użytkowników, którzy mają nieocenzurowane dzienniki.
    2. Po potwierdzeniu, że Twoje konto zostało dodane do listy dozwolonych, uruchom ponownie telefon.

Weryfikacja VID/PID urządzenia

Jeśli chcesz rozpocząć tworzenie integracji 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 wpisaną w projekcie Google Home Developer Console.

  • Identyfikatory VID 0xFFF1 – 0xFFF4 są zarezerwowane do testowania. Można ich używać do podstawowych testów wdrożenia 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. To oznacza, że VID to 5A23, a PID to 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 na urządzeniu możesz sprawdzić, wykonując te czynności: przesuń palcem w dół od górnej krawędzi > koło konfiguracji > informacje o urządzeniu > informacje techniczne > wersja oprogramowania Chromecasta.

Wdrożenie nie udaje się z powodu komunikatu o błędzie „Nie udało się nawiązać połączenia 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 przeprowadzić czystą konfigurację. Aby to zrobić, otwórz 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 przypadku wielu integracji.

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.