Testowanie integracji standardu Matter

Google Home Developer Console zawiera stronę testową, na której możesz konfigurować i uruchamiać testy na urządzeniu Matter za pomocą Google Home Test Suite. Test Suite to osobna aplikacja wbudowana w Developer Console, która obsługuje wszystkie testy integracji.

Urządzenia przypisane do identyfikatora dostawcy i identyfikatora produktu integracji muszą zostać zlecone i dostępne w aplikacji Google Home app (GHA) na koncie używanym z Developer Console. Zobacz Parowanie sprawy , by dowiedzieć się więcej.

Test Suite może być uruchamiana na zestawie urządzeń należących do określonej konfiguracji projektu Matter. To bardzo ważne jest uruchomienie Test Suite w integracji do sprawdzić, czy wszystko działa prawidłowo.

Na stronie Test zobaczysz integracje (Matter), które są ukończone i gotowe do testowania są wymienione w sekcji Gotowy do testowania.

Matter przetestowanych integracji jest wymienionych w sekcji Przetestowane.

Typy planów testów

Istnieją 2 rodzaje planów testów:

  • Plany testów deweloperskich służą do testowania urządzeń za pomocą Matter Można je edytować, ale nie można ich przesłać aby uzyskać certyfikat Matter.

  • Plany testów certyfikacyjnych są przeznaczone specjalnie do: Matter i nie można ich edytować. Wybranie tej opcji spowoduje utworzenie nowej wersji karty Integracja z Matter.

Wersje integracji

Gdy tworzysz plan testowy na potrzeby certyfikacji, tworzona jest nowa wersja integracji. Ten numer wersja jest wymieniona na wszystkich listach integracji w systemie Developer Console od karty Test.

Nowe wersje nigdy nie są tworzone na podstawie innych wersji numerowanych. Na przykład parametr Pierwszy plan testowania, jaki utworzysz dla integracji, spowoduje utworzenie wersji v.1 dla tej integracji. i integrację społeczną. Utworzenie innego planu testowania spowoduje utworzenie wersji v.2. ale ta wersja nie będzie oparta na v.1. Ta wersja opiera się na instancji integracji bez wersji, tak jak miało to miejsce w przypadku wersji 1.

Wersja Nie dotyczy integracji odpowiada instancji bez wersji i można nią zarządzać na karcie Programowanie.

Inaczej mówiąc, w aplikacji Matter > Przetestuj w Developer Console:

  • Jeśli klikniesz Testuj dla wersji Nie dotyczy integracji, nowa wersja zostanie Utworzono. Numer wersji będzie o jeden wyższy niż wszystkie istniejące numerowane wersji.
    • Jeśli nie ma żadnych wersji numerowanych, tworzona jest wersja v.1.
    • Jeśli istnieje wersja v.1, zostanie utworzona wersja v.2. Jeśli wersja v.2 już istnieje, tworzona jest wersja v.3 itd.
  • Jeśli klikniesz Testuj w przypadku wersji z numerem (np. v.1), nowa wersja nie zostanie utworzona. Zamiast tego wersja v.1 jest został przetestowany ponownie.

Więcej informacji znajdziesz w sekcji Integracja obsługi wersji.

Tworzenie planu testów

Wersje integracji to migawka integracji bez wersji. Oznacza to, że że podczas tworzenia planu testów certyfikacyjnych oraz integracji wersji, wszystkie metadane związane z tą integracją muszą być informacjami których chcesz użyć podczas uruchomionej integracji.

Zanim utworzysz plan testów pod kątem certyfikacji, wykonaj :

  1. Utworzono profil firmy.
  2. Wpisano produkcyjny identyfikator dostawcy (VID) integracji.
  3. Konfiguracja konfiguracji i budowania marki

Jeśli nie wykonano wszystkich tych czynności, wersja utworzona do testowania certyfikacyjnego nie może mieć certyfikatu. Masz aby utworzyć nową wersję, co oznacza powtórzenie testów, testów funkcjonalnych i certyfikacji kroków.

Konieczne będzie również utworzenie nowej wersji i rozpoczęcie od nowa należy zaktualizować markę przed certyfikacją wersji integracji.

Aby utworzyć plan testów:

Otwórz konsolę programisty

  1. Na liście projektów kliknij Otwórz obok projektu, nad którym chcesz pracować.

  2. W menu nawigacyjnym po lewej stronie kliknij Matter > Testowanie.

  3. Kliknij Testuj obok wersji Nie dotyczy integracji, którą chcesz przetestować. Ten Działanie powoduje utworzenie nowej wersji integracji.

  4. Wybierz typ testu: Test rozwoju lub Test certyfikacji. Tworzenie nowego planu testów

    • Wybierz Test certyfikacji, jeśli przygotowujesz się do uzyskania certyfikatu w: ekosystem Google.
    • W przypadku certyfikacji nie można używać testu dla programistów.
  5. Kliknij Przetestuj. Jeśli pojawi się ekran o błędzie Nie znaleziono urządzenia, urządzenie nie przeprowadzono jeszcze tej integracji w ekosystemie. Zobacz Rozwiązywanie problemów z parowaniem .

  6. Na ekranie Skonfiguruj test podaj nazwę testu i wybierz z listy urządzenia, które chcesz przetestować.

  7. Kliknij przycisk Dalej – przetestuj plan.

  8. Na stronie Utwórz plan testów w sekcji Pakiety testowe wybierz które zestawy testów chcesz uruchomić.

Tworzenie planu testów

Jeśli chcesz wyjść z Test Suite, kliknij Powrót do programisty pomocy.

Uruchamianie planu testów

Na stronie Utwórz plan testowy w usłudze Test Suite kliknij Run test (Uruchom test). Pojawi się strona Środowisko testowe ze stanem i logami wszystkich testów.

Wyniki testów pojawią się po ich zakończeniu. Stan każdego pakietu testowego (Powodzenie, Niepowodzenie).

W panelu Logi możesz sprawdzić stan każdego wykonania testu.

Wyniki testów

Aby ponownie przetestować plan testów na stronie Środowisko testowe, kliknij Sprawdź ponownie na górze gdy test się zakończy.

Po zakończeniu:

Wyświetlanie i interpretowanie wyników testu

Na stronie Historia testów w narzędziu Test Suite możesz zobaczyć wyniki testów związanych z planem rozwoju lub nieprzesłanym certyfikacją Aby sprawdzić plan testowania, w sekcji Plany testów kliknij Testuj ponownie obok wybranego planu testów. . Wyświetli się strona Środowisko testowe, na której widać wyników tego testu.

Historia testów

W przypadku przesłanego planu certyfikacji kliknij Wyniki w sekcji Zapisane dla certyfikacji, aby wyświetlić raport z wynikami testu.

Wyniki testów wersji integracji można też wyświetlić na karcie TestDeveloper Console. Kliknij Wyświetl obok pozycji Historia testów dowolną wersję integracji wymienioną na tej stronie, aby można było przejść do Historii testów w witrynie Test Suite.

Stany konsoli

Na etapie testowania występują te stany konsoli:

Sekcja Status Opis Wymagania Co dalej?
Gotowa do testowania Gotowe Ta wersja integration jest gotowa do testowania. Nie dotyczy Przetestuj tę wersję integration
Przetestowane urządzenia Gotowe Ta wersja integration została przetestowana i może być przesłanych w ramach testów funkcjonalnych lub certyfikacji.

Wersja została przetestowana i zapisana.

Wszystkie przypadki testowe, których nie udało się przeprowadzić, zawierają uzasadnienia, które Google musi sprawdzić.

W razie potrzeby ponownie przetestuj.

Rozwiązywanie problemów

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.

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 z Bluetooth Sniffer

Wartość VID/PID, którą beaconuje urządzenie, powinna być zgodna z wartością VID/PID wpisaną w projekcie Developer Console.

  • Identyfikatory VID 0xFFF10xFFF4 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.