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 narzędzia Android Debug Bridge

Przed rozpoczęciem rozwiązywania problemów skonfiguruj 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 niezbędne moduły Matter są zainstalowane, uruchom w terminalu to polecenie:
      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]
    Należy pamiętać, że numer wersji może być inny niż na Twoim urządzeniu.
  4. Uruchom to polecenie w terminalu, aby sprawdzić, czy są zainstalowane 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 przedstawionych w przykładzie poniżej, oznacza to, że masz zainstalowane moduły Thread: 
    com.google.android.gms.threadnetwork [v222106301]
    Pamiętaj, że 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. Sprawdź, czy jest to AndroidO (8.1) lub większy.
  2. Moduł Matter nie został jeszcze pobrany. Poczekaj co najmniej 24 godziny na pobranie. Upewnij się, że urządzenie jest w tym czasie włączone i ładowane, aby uniknąć opóźnień. 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 swoich urządzeń na konto Technical Account Manager (TAM) Google. Znajdziesz je w małej czcionce pod urządzeniem.
  2. Gdy ta funkcja zostanie dodana do listy dozwolonych, musisz ją włączyć, 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 Fussia”. Włącza to opcje programisty.
      5. Powrót do menu najwyższego poziomu
      6. Kliknij „Opcje programisty”.
      7. Kliknij „Partner Logging” (Rejestrowanie partnera).
    • Funkcja zostanie włączona na 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) kliknij 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ć logi z centrum, wyślij do centrum żądania HTTP GET 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 mają zwykle 20–30 minut przeszłych 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 prywatność i bezpieczeństwo tej funkcji należy używać tylko do testów technicznych.
  • 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 języku little endian,ale wartości VID/PID wpisane w projekcie Developer Console są w języku big end.

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 z Matter pakietu SDK

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. W informacjach o wersji publicznej znajdziesz informacje o konkretnych zatwierdzeniach zalecanych do użycia z każdą nową wersją centrum.

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 certyfikacji (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.

Zweryfikuj centrum zgodne ze standardem Matter

Twoje centrum Matter musi być jednym z hubów obsługiwanych przez Google. Musi też być kompilacją zgodną ze standardem 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 łączność 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.

Przekazywanie dalej się kończy i pojawia się komunikat o błędzie „Nie udało się skontaktować 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ć, 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 urządzenie zostało sparowane z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się on podczas testowania urządzenia za pomocą pakietu do testów w Developer Console, prawdopodobnie jest to spowodowane używaniem tego samego testowego identyfikatora VID i PID w kilku 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 opisanych tu czynności problem nie ustąpił, nie ma sprawy.

Podczas wykonywania czynności rozwiązywania problemów zebrałeś/zebrałaś ważne dane o urządzeniu, projekcie w Konsoli i środowisku. Mając te dane, zajrzyj na stronę Pomoc, aby dowiedzieć się, jak najlepiej przedstawić swój problem społeczności i zespołowi pomocy Google Home.