Rozwiązywanie problemów ze standardem Matter

Budynek

Sprawdź, czy telefon jest zgodny

Wszystkie urządzenia z Android O (8.1, poziom interfejsu API 27) i nowsze są zgodne z zasadą Matter. Wykonaj te czynności, aby sprawdzić, czy 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 USB debugowanie, na telefonie Android.

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

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

  1. Skonfiguruj Android Debug Bridge.
  2. Użyj kabla USB, aby połączyć telefon Android z urządzeniem komputera.
  3. Uruchom to polecenie w terminalu, aby sprawdzić, czy niezbędne Zainstalowane 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 poniższych, oznacza to, że Zainstalowane moduły (Matter): 
    com.google.android.gms.home [v222110900]
    Pamiętaj, że powyższy numer wersji może być inny niż numer Twojego urządzenia.
  4. Uruchom to polecenie w terminalu, aby sprawdzić, czy niezbędne Zainstalowane 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 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. Masz nieaktualną wersję języka Android. Sprawdź, czy Android O (8.1) lub więcej.
  2. Moduły Matter nie zostały jeszcze pobrane. Czekaj co najmniej 24 godziny na ich pobranie. Upewnij się, że urządzenie jest włączone i w tym czasie ładowania, dzięki czemu pobieranie nie będzie opóźnione. Jeśli nie masz jeszcze otrzymano moduły w ciągu 24 godzin, możesz spróbować przywrócić dane fabryczne aby wymusić pobranie modułów.

Logi urządzenia centrali Fuchsia

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

  1. Wyślij e-maila z numerem seryjnym i modelem swoich urządzeń na konto Technical Account Manager (TAM) Google. Są zapisane małymi literami pod urządzeniem.
  2. Gdy ta funkcja zostanie dodana do listy dozwolonych, musisz ją włączyć, wykonując te czynności:
    • Z 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. Kliknij „Wersja Fussia”. 7 razy. Spowoduje to włączenie opcji programisty
      5. Wróć do menu najwyższego poziomu
      6. Kliknij „Opcje programisty”.
      7. Kliknij „Logowanie partnera”.
    • Funkcja zostanie włączona na 24 godziny. Następnie ponownie włącz funkcję rejestrowania 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. Znajdź adres IP urządzenia: na urządzeniu Nest Hub (2nd gen) kliknij Informacje o urządzeniu > Informacje techniczne > Adres IP
    • Źródło: Google Home app (GHA) na telefonie:
      1. Kliknij urządzenie, aby otworzyć stronę z informacjami o nim.
      2. Kliknij ikonę Ustawienia . by otworzyć stronę ustawień
      3. Znaleźć adres IP urządzenia: kliknij Urządzenie. informacje > 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.
    • 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 pozostawać otwarte tylko przez minutę, ale dane pobrane z bufora mają zwykle 20–30 minut przeszłych zdarzeń.
      • W idealnej sytuacji dzienniki są wyodrębniane natychmiast po wykonaniu procedury testowej, aby mieć pewność, że bufor zawiera treści związane z testem (podobnie jak w przypadku raportów o błędach Androida).

Wyłącz pomijanie logów Androida

  • Prywatność i bezpieczeństwo zabezpieczeń, ta funkcja powinna być używana tylko do testów technicznych.
  • Nie używaj tej opcji w przypadku urządzeń produkcyjnych ani użytkowników.
  • Kroki:
    1. Wyślij konta Google użytkowników, dla których nie zostaną usunięte dzienniki, do usługi Google TAM.
    2. Po potwierdzeniu dodania konta do listy dozwolonych zrestartuj telefon.

Weryfikacja VID/PID urządzenia

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

Rozwiązywanie problemów ze snifferem Bluetooth

Wartość VID/PID, którą sygnalizuje urządzenie, powinna być zgodna z wartością VID/PID wprowadzone do projektu Google Home Developer Console.

  • Identyfikatory VID 0xFFF1 – 0xFFF4 są zarezerwowane do testowania. Mogą być wykorzystywane do tych celów: testów podstawowych i kontrolnych, ale nie można ich używać następujące etapy rozwoju:

Korzystając z aplikacji konstrukcyjnych Bluetooth, takich jak nRF Connect for Mobile, identyfikator VID/PID urządzenia beacon znajdziesz w polu Dane usługi.

Na tym zrzucie ekranu z wersji nRF Connect w wersji Android zobaczysz, że identyfikator VID/PID jest oznaczony jako 5A23FFFE, począwszy od czwartego bajtu w polu Service Data (Dane usługi). Oznacza to identyfikator VID o wartości 5A23 oraz identyfikator PID o wartości FFFE – w formacie małego końca.

Aplikacja BLE wyświetla wartości w wyrazie little endian,ale wartości VID/PID w projekcie Developer Console używa się języka big end.

sprawdzić, czy w działaniach zostały wprowadzone prawidłowe wartości i format; Projekt konsoli na podstawie tego, co pokazuje sniffer Bluetooth.

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

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

Centra Google Matter są zgodne z Matter 1.0 i zostały przetestowane z użyciem kompilacji zatwierdzenia z gałęzi stabilnej v1.0-branch. Sprawdź wersję publiczną uwagi dotyczące konkretnych zatwierdzeń rekomendowanych do użycia w każdej nowej wersji centralnej.

Paruję

Zweryfikuj dane logowania do urządzenia

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

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

Więcej informacji znajdziesz w artykule Tworzenie testu urządzenia Matter .

Zweryfikuj centrum zgodne ze standardem Matter

Centrum Matter musi być jednym z hubów obsługiwanych przez Google. Musi być również na kompilację zgodną ze standardem Matter.

Niektóre centra są też routerami Border Router i w ten sposób pozwalają tworzyć i testować urządzenia Thread. Inne centra obsługuje tylko urządzenia z siecią Wi-Fi i Ethernet Matter, chyba że Aby umożliwić połączenia Thread, musisz mieć w sieci inny router brzegowy.

Konfigurację centrali możesz sprawdzić w ten sposób: przesuń palcem od górnej krawędzi w dół > Koło konfiguracji > Informacje z urządzenia > Informacje techniczne > Wersja oprogramowania Chromecasta

Przekazywanie dalej kończy się niepowodzeniem i wyświetlany jest komunikat „Nie udało się skontaktować z Google”. komunikat o błędzie

Sprawdź, czy została utworzona integracja z prawidłową kombinacją identyfikatora VID i identyfikatora PID w Developer Console. Zobacz Tworzenie sprawy , aby dowiedzieć się więcej.

Przekazywanie dalej się kończy z komunikatem „Nie można połączyć się z urządzeniem” komunikat o błędzie

Jeśli nadal pojawia się komunikat „Nie można połączyć się z urządzeniem” jest komunikat o błędzie przy uruchamianiu Thread urządzenie i wyczerpano wszystkie dostępne opcje debugowania możesz wyczyścić zapisane preferowane ustawienia Thread dane logowania na telefon z Androidem w celu uzyskania czystej konfiguracji. Aby to zrobić, wybierz kolejno Ustawienia > Aplikacje > Aplikacje > Usługi Google Play > Przechowywanie pamięć podręczna > Zarządzaj pokojem > WYCZYŚĆ WSZYSTKIE DANE.

Testowanie

Urządzenie objęte zleceniem nie pojawia się w Pakietie testów

Jeśli urządzenie zostało sparowane z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się przy próbie testowania urządzenia za pomocą Analytics 360 w regionie Developer Console. Prawdopodobna przyczyna: za pomocą tego samego testowego identyfikatora VID i PID w wielu integracjach.

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

Aby upewnić się, że urządzenie jest sparowane, możesz ustawić oznaczenie producenta Informacje o modelu (liczba wartości: CHIP_DEVICE_CONFIG_DEVICE_*), które urządzenie może unikalne wartości w oprogramowaniu testowym.

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

Jeśli coś nadal pójdzie nie tak

Jeśli po wykonaniu wszystkich opisanych tu czynności problem nadal występuje problem rozwiązany, nie ma problemu!

Podczas rozwiązywania problemów udało Ci się zebrać ważne dane o urządzeniu, projekt konsoli i środowisko. Mając te dane pod ręką, sprawdź stronie pomocy, aby dowiedzieć się, jak najlepiej skontaktować się z i z zespołem pomocy Google Home.