Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdzanie zgodności telefonu

Wszystkie urządzenia Android O (8.1, poziom interfejsu API 27) i nowsze są zgodne z Matter. Wykonaj opisane poniż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 należy skonfigurować Android Debug Bridge (adb). Aby to zrobić:

  1. Zainstaluj „adb” na komputerze.
  2. Na telefonie Android włącz Opcje programisty i Debugowanie USB.

Zweryfikuj moduły Usług Google Play (GPS) Matter

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 kablem USB.
  3. Uruchom to polecenie w terminalu, aby sprawdzić, czy są zainstalowane 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, oznacza to, że masz zainstalowane moduły Matter: 
    com.google.android.gms.home [v222110900]
    Pamiętaj, że powyższy 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 widzisz dane wyjściowe podobne do tych 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 Twoim urządzeniu może być inny.

Jeśli modułów nie ma na liście, oznacza to, że:

  1. Masz nieaktualną wersję usługi Android. Sprawdź, czy wartość ma wartość Android O (8.1) lub wyższą.
  2. Moduły Matter nie zostały jeszcze pobrane. Poczekaj co najmniej 24 godziny na ich pobranie. Zadbaj o to, aby w tym czasie urządzenie było włączone i ładowane, by uniknąć opóźnienia pobierania. Jeśli nie otrzymasz modułów w ciągu 24 godzin, możesz spróbować przywrócić dane fabryczne urządzenia, aby wymusić ich pobranie.

Dzienniki urządzenia centralnego Fuchsia

Aby włączyć centrum pobierania logów lokalnych:

  1. Wyślij e-maila z numerem seryjnym i modelem swoich urządzeń na urządzenie Technical Account Manager (TAM) Google. Można je znaleźć małymi literami pod urządzeniem.
  2. Gdy znajdziesz się na liście dozwolonych, musisz ją włączyć, wykonując te czynności:
    • W centrum:
      1. Przesuń palcem z góry ekranu w dół
      2. Kliknij ikonę Ustawienia .
      3. Znajdź wersję Fuchsia na urządzeniu Google Nest Hub (2nd gen) otwórz Informacje o urządzeniu > Informacje techniczne > Wersja Fuchsia.
      4. 7 razy kliknij „Wersja Fuchsia”. Spowoduje to włączenie opcji programisty
      5. Wróć do menu najwyższego poziomu
      6. Kliknij „Opcje programisty”.
      7. Kliknij „Partner Logging”.
    • Funkcja będzie włączona przez 24 godziny. Następnie włącz tę funkcję ponownie od kroku 5.
  3. Uzyskaj adres IP swojego centrum:
    • W centrum, jeśli ma ekran:
      1. Przesuń palcem z góry ekranu w dół
      2. Kliknij ikonę Ustawienia .
      3. Znajdowanie adresu IP urządzenia: na urządzeniu Nest Hub (2nd gen) otwórz Informacje o urządzeniu > Informacje techniczne > Adres IP
    • W aplikacji Google Home app (GHA) na telefonie:
      1. Kliknij urządzenie, aby otworzyć stronę szczegółów urządzenia.
      2. Kliknij ikonę Ustawienia , aby otworzyć stronę ustawień.
      3. Znajdowanie adresu IP urządzenia: otwórz Informacje o urządzeniu > Informacje techniczne > Adres IP.
  4. Aby pobrać dzienniki z centrum, musisz wysłać do centrum żądanie GET z komputera w tej samej sieci Wi-Fi.
    • Zapisz 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 1 minutę, ale dane pobrane z bufora zawierają zwykle od 20 do 30 minut przeszłych zdarzeń.
      • W miarę możliwości dzienniki są pobierane za pomocą tej metody tuż po zakończeniu procedury testowej, aby się upewnić, że bufor zawiera treści istotne dla testu (podobnie jak w przypadku raportów o błędach w Androidzie).

Wyłącz pomijanie logów Androida

  • Ze względu na ochronę prywatności i bezpieczeństwo danych ta funkcja powinna być używana tylko do testów technicznych.
  • Nie używaj tej opcji w przypadku urządzeń produkcyjnych i użytkowników.
  • Kroki:
    1. Wyślij konta Google użytkowników, których dzienniki nie zostały usunięte, do Google TAM.
    2. Gdy potwierdzisz, że Twoje konto zostało dodane do listy dozwolonych, uruchom ponownie telefon.

Sprawdzanie identyfikatora 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 ze Snifferem Bluetooth

Wartość identyfikatora VID/PID odbieranego przez urządzenie powinna być zgodna z wartością identyfikatora VID/PID podanego w projekcie Google Home Developer Console.

  • Identyfikatory VID 0xFFF1 – 0xFFF4 są zarezerwowane na potrzeby testowania. Można ich używać na potrzeby podstawowych testów zlecania i kontroli, ale nie można ich używać w następujących fazach programowania:

Korzystając z aplikacji inżynieryjnej Bluetooth, takiej jak nRF Connect na urządzenia mobilne, możesz sprawdzić identyfikator VID/PID urządzenia sygnalizującego po stronie usługi w polu Dane usługi.

Na tym zrzucie ekranu z wersji Android nRF Connect widać, że identyfikator VID/PID ma wartość 5A23FFFE, zaczynając od czwartego bajtu pola Service Data. Wskazuje on identyfikator VID o wartości 5A23 i identyfikator PID o wartości FFFE – oba te wartości są w małym formacie endian.

Aplikacja BLE wyświetla wartości pisane małą literą,ale wartości VID/PID wpisane w projekcie Developer Console są zapisywane w big endian.

Na podstawie tego, co pokazuje sniffer Bluetooth, sprawdź, czy w projekcie w Konsoli Actions zostały wprowadzone odpowiednie wartości i format.

W przypadku wartości na przykładowym zrzucie ekranu identyfikatory VID i PID w parametrze Developer Console wyniosą odpowiednio 235A i FEFF.

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

Huby Google Matter są zgodne z Matter 1.0 i zostały przetestowane z kompilacjami, które korzystały ze zobowiązań ze stabilnej gałęzi v1.0-branch. Zapoznaj się z informacjami o wersji publicznej, aby znaleźć konkretne zatwierdzenia zalecane do użycia z każdą nową wersją centrum.

parowanie,

Zweryfikuj dane logowania urządzenia

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

  • deklaracja certyfikacyjna (CD).
  • Certyfikat atestu urządzenia (DAC) i jego łańcuch certyfikatów.

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

Sprawdzanie centrum zgodnego ze standardem Matter

Twoje centrum Matter musi być jednym z centrów obsługiwanych przez Google. Musi też być kompilacja zgodną ze standardem Matter.

Niektóre centra to także routery Thread Border Router, dzięki którym możesz tworzyć i testować urządzenia Thread. Inne centra obsługują tylko urządzenia Matter z siecią Wi-Fi i Ethernetowe, chyba że masz w sieci inny router graniczny umożliwiający włączenie połączeń Thread.

Aby zweryfikować kompilację centrum, możesz: Przesunąć palcem w dół z górnej krawędzi > koło konfiguracji > Informacje o urządzeniu > Informacje techniczne > Wersja oprogramowania Chromecasta.

Proces uruchamiania kończy się niepowodzeniem i wyświetlany jest komunikat o błędzie „Nie można skontaktować się z Google”.

Sprawdź, czy w Developer Console została utworzona integracja z prawidłową kombinacją identyfikatora VID i PID. Więcej informacji znajdziesz w artykule na temat tworzenia integracji ze zgłoszeniem.

Przekazywanie kończy się niepowodzeniem i wyświetla się komunikat o błędzie „Nie można połączyć się z urządzeniem”

Jeśli przy uruchamianiu urządzenia Thread wciąż pojawia się komunikat o błędzie „Nie można połączyć się z urządzeniem” i wyczerpano wszystkie dostępne opcje debugowania, spróbuj wyczyścić preferowane dane logowania do Thread na telefonie z Androidem, aby wyczyścić dane, wybierając kolejno Ustawienia > Aplikacje > Aplikacje aplikacji > Usługi Google Play > Pamięć i pamięć podręczna > Zarządzaj miejscem > WYCZYŚĆ WSZYSTKIE DANE.

Testowanie

Udostępnione urządzenie nie pojawia się w pakiecie Test Suite

Jeśli urządzenie zostało sparowane z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się ono podczas próby przetestowania urządzenia za pomocą pakietu testowego w Developer Console, prawdopodobnie jest to spowodowane używaniem w wielu integracjach tego samego zestawu identyfikatorów VID i PID.

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

Aby sprawdzić, czy jest sparowany z właściwym urządzeniem, możesz ustawić w oprogramowaniu testowym informacje o producencie i modelu (wartości CHIP_DEVICE_CONFIG_DEVICE_*) urządzenia.

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

Jeśli coś nadal nie działa

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

Dzięki nim udało Ci się zebrać ważne dane o urządzeniu, projekcie w konsoli i środowisku. Mając te dane, zajrzyj na stronę pomocy, aby dowiedzieć się, jak najlepiej zgłosić problem społeczności i zespołowi pomocy Google Home.