W Google Home Developer Console dostępna jest strona Test, na której możesz skonfigurować i przeprowadzić testy integracji Matter za pomocą Google Home Test Suite. Test Suite to oddzielna aplikacja wbudowana w Developer Console, która obsługuje wszystkie testy integracji.
Aby można było przetestować urządzenia z identyfikatorem dostawcy i identyfikatorem produktu integracji, muszą one zostać uruchomione i być dostępne w aplikacji Google Home app (GHA) na koncie używanym z Developer Console. Więcej informacji znajdziesz w artykule Parowanie urządzenia Matter.
Test Suite można uruchomić na zbiorze urządzeń, które należą do określonej konfiguracji projektu Matter. Bardzo ważne jest, aby uruchomić Test Suite w integracjach, aby upewnić się, że wszystko działa prawidłowo.
Na stronie Test integracje Matter, które są ukończone i gotowe do testowania, są wymienione w sekcji Gotowe do testowania.
Integracje Matter, które zostały przetestowane, są wymienione w sekcji Przetestowane.
Rodzaje planów testów
Dostępne są te typy planów testów:
Programistyczne plany testów służą do testowania sterowania urządzeniami za pomocą Matter. Można je edytować, ale nie można ich przesłać do certyfikacji Matter.
Plany testów certyfikacji są przeznaczone specjalnie do certyfikacji Matter i nie można ich edytować. Wybranie tej opcji spowoduje utworzenie nowej wersji integracji Matter.
Plany testów CSA Interop umożliwiają pominięcie etapu testowania i wykorzystanie wyników z laboratorium testowego Connectivity Standards Alliance (Alliance) Interop. Ta opcja testowa jest dostępna dla wszystkich obsługiwanych typów urządzeń i jest jedyną opcją, która pozwala uzyskać certyfikat Aliro w przypadku zamków do drzwi zgodnych z Aliro.
Użyj Test Suite w Developer Console, aby przesłać wyniki testów do certyfikacji. Jeśli chcesz uruchomić Test Suite w celach testowych podczas tworzenia aplikacji, wejdź na stronę Zestawu testów Google Home, aby pobrać wersję samodzielną.
Wersje integracji
Gdy utworzysz plan testów na potrzeby certyfikacji, zostanie utworzona nowa wersja integracji. Ta wersja z numerem jest widoczna na wszystkich listach integracji w Developer Console, począwszy od karty Test.
Nowe wersje nigdy nie są tworzone z innych wersji numerowanych. Na przykład pierwszy plan testowy utworzony dla integracji spowoduje utworzenie wersji v.1 tej integracji. Utworzenie kolejnego planu testów spowoduje utworzenie wersji v.2 tej integracji, ale ta wersja nie będzie oparta na wersji v.1. Zamiast tego ta wersja jest oparta na instancji integracji bez wersji, tak samo jak v.1.
Wersja nie dotyczy integracji reprezentuje instancję integracji bez wersji, która jest zarządzana na karcie Develop (Programowanie).
Innymi słowy, na stronie Matter > Test w Developer Console:
- Jeśli klikniesz Testuj w przypadku wersji integracji nie dotyczy, zostanie utworzona nowa wersja. Numer wersji będzie o 1 wyższy niż numer ostatniej wersji.
- Jeśli nie ma wersji numerowanych, zostanie utworzona wersja v.1.
- Jeśli wersja v.1 istnieje, zostanie utworzona wersja v.2. Jeśli istnieje wersja v.2, zostanie utworzona wersja v.3 itd.
- Jeśli klikniesz Testuj w przypadku numerowanej wersji integracji (np. v.1), nowa wersja nie zostanie utworzona. Zamiast tego ponownie testowana jest wersja v.1.
Więcej informacji znajdziesz w artykule na temat obsługi wersji integracji.
Tworzenie planu testów
Wersje integracji to migawka integracji bez wersji. Oznacza to, że gdy tworzysz plan testów na potrzeby certyfikacji, a tym samym wersję integracji, wszystkie metadane związane z tą integracją muszą być informacjami, których chcesz używać w uruchomionej integracji.
Zanim utworzysz plan testów na potrzeby certyfikacji, wykonaj te czynności:
- utworzyć profil firmy,
- wpisać identyfikator dostawcy (VID) dla integracji;
- Skonfigurowane ustawienia i branding.
Jeśli nie wykonasz wszystkich tych czynności w przypadku swojej integracji, wersja integracji utworzona na potrzeby testów certyfikacyjnych nie będzie mogła zostać certyfikowana. Musisz utworzyć nową wersję, co oznacza, że musisz powtórzyć kroki testowania, testu terenowego i certyfikacji.
Jeśli chcesz zaktualizować elementy marki, zanim wersja integracji zostanie certyfikowana, musisz utworzyć nową wersję i zacząć od początku.
Aby utworzyć plan testów:
Na liście projektów kliknij Otwórz obok projektu, nad którym chcesz pracować.
W menu nawigacyjnym po lewej stronie kliknij Matter > Test.
Kliknij Test w przypadku wersji nie dotyczy integracji, którą chcesz przetestować. To działanie tworzy nową wersję integracji.
Wybierz typ testu i kliknij Test.
- Jeśli przygotowujesz się do certyfikacji w ekosystemie Google, wybierz Test certyfikacyjny.
- Testu programistycznego nie można użyć do certyfikacji.
Wybierz Test zgodności CSA, aby użyć wyników z laboratorium testów zgodności Alliance i pominąć etapy testów i testów terenowych w procesie integracji Matter. Po wybraniu opcji Test interoperacyjności CSA przypisz nazwę śledzenia do profilu konfiguracji, zmapuj identyfikator produktu (PID) urządzenia i kliknij Prześlij, aby przejść bezpośrednio do Certyfikacji.
W przypadku zamków do drzwi zgodnych z Aliro musisz wybrać test zgodności CSA, aby uzyskać certyfikat Aliro. Jeśli wybierzesz inną opcję testu, musisz utworzyć nową wersję integracji i przesłać ją ponownie.
Jeśli wybierzesz Test certyfikacyjny lub Test programistyczny, na ekranie Skonfiguruj test podaj nazwę testu i kliknij Automatycznie sparuj urządzenie, aby wybrać urządzenie do sparowania.
Na urządzeniu z Androidem:
- Upewnij się, że na telefonie jest zainstalowana aplikacja GHA.
- Podłącz telefon do komputera hosta za pomocą kabla USB.
- Musisz włączyć debugowanie USB na urządzeniu.
APKcom.chip.interop.moblysnippetzostanie automatycznie pobrany i zainstalowany. - Po połączeniu telefonu wpisz kod parowania i nazwę urządzenia, aby automatycznie sparować urządzenie.
Na urządzeniu z iOS:
- Musisz ręcznie sparować urządzenie. Instrukcje ręcznego parowania znajdziesz w sekcji Aplikacja Google Home.
- Jeśli masz już urządzenie, może pojawić się prośba o jego rozparowanie i ponowne sparowanie lub sparowanie nowego urządzenia.
Kliknij przycisk Dalej: plan testów.
Na stronie Utwórz plan testów w sekcji Zestawy testów wybierz zestawy testów, które chcesz uruchomić.
Jeśli chcesz wyjść z Test Suite, kliknij Wróć do Centrum dla deweloperów.
Uruchamianie planu testów
W Test Suite na stronie Utwórz plan testów kliknij Uruchom test. Pojawi się strona Środowisko testowe ze stanem i logami wszystkich testów.
Wyniki testów pojawią się po ich zakończeniu. Obok każdego zestawu testów wyświetla się stan jego wykonania (Ukończono, Niepowodzenie).
Panel Logi pokazuje stan każdego wykonania testu.
Aby ponownie sprawdzić plan testów na stronie Środowisko testowe, po zakończeniu wykonywania testu kliknij u góry Sprawdź ponownie.
Po zakończeniu:
- Kliknij Gotowe, aby przejść na stronę Historia testów, lub
- Kliknij Prześlij, aby przesłać wyniki testu do certyfikacji.
Wyświetlanie i interpretowanie wyników testu
Na stronie Historia testów w Test Suite możesz wyświetlić wyniki poprzednich testów planu rozwoju lub nieprzesłanego planu testów certyfikacyjnych, klikając Sprawdź ponownie obok planu testów w sekcji Plany testów. Przejdziesz na stronę Środowisko testowe, na której wyświetlane są wyniki testu.
W przypadku przesłanego planu certyfikacji kliknij Wyniki w sekcji Zapisane do certyfikacji, aby wyświetlić raport z wynikami testu.
Wyniki testów wersji integracji można też wyświetlić na karcie Test w Developer Console. Kliknij Wyświetl obok opcji Historia testów dowolnej wersji integracji wymienionej na tej stronie, aby przejść do strony Historia testów w Test Suite.
Stany konsoli
W fazie testowania występują te stany konsoli:
| Sekcja | Stan | Opis | Wymaganie | Co dalej? |
|---|---|---|---|---|
| Gotowa do testowania | Gotowe | Ta wersja integration jest gotowa do testowania. | Nie dotyczy | Przetestuj tę wersję integration. |
| Przetestowano | Gotowe | Ta wersja integration została przetestowana i można ją przesłać do Field Trial lub certyfikacji. |
Wersja została przetestowana i zapisana. Wszystkie nieudane elementy testowania zawierają uzasadnienia, które Google może sprawdzić. |
W razie potrzeby przeprowadź test ponownie. |
Sprawdź ponownie
Certyfikat
Jeśli chcesz ponownie przeprowadzić testy certyfikacyjne, musisz sparować urządzenie po rozpoczęciu ponownego testowania.
Programowanie
Jeśli musisz przeprowadzić ponowny test na potrzeby programowania, możesz użyć dotychczasowego urządzenia bez ponownego parowania.
Rozwiązywanie problemów
Uruchomione urządzenie nie pojawia się w zestawie testów
Jeśli urządzenie zostało sparowane z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się, gdy próbujesz przetestować je za pomocą zestawu testów w Developer Console, prawdopodobnie jest to spowodowane użyciem tej samej kombinacji testowego identyfikatora VID i PID w wielu integracjach.
Aby rozwiązać problem, usuń wszystkie urządzenia testowe z aplikacji Developer Console i ponownie sparuj urządzenie, które chcesz przetestować.
Aby sprawdzić, czy sparowano właściwe urządzenie, możesz ustawić informacje o producencie i modelu (wartości CHIP_DEVICE_CONFIG_DEVICE_*) urządzenia na unikalne wartości w testowym oprogramowaniu układowym.
Więcej informacji znajdziesz w sekcji Informacje o urządzeniu.
Sprawdzanie identyfikatora VID/PID urządzenia
Jeśli chcesz zacząć tworzyć integrację z Google, musisz utworzyć projekt i integrację w Google Home Console.
Wartość VID/PID, którą urządzenie wysyła w sygnałach, powinna być zgodna z wartością VID/PID podaną w projekcie Developer Console.
- Identyfikatory dostawcy od
0xFFF1do0xFFF4są zarezerwowane do testowania. Można ich używać do podstawowych testów uruchamiania i sterowania, ale nie można ich używać podczas tych faz rozwoju:
Za pomocą aplikacji inżynieryjnej Bluetooth, takiej jak nRF Connect for Mobile, możesz zobaczyć identyfikator VID/PID urządzenia wysyłającego sygnał w polu Dane usługi.
Na tym zrzucie ekranu z aplikacji nRF Connect w wersji Android widać, że identyfikator VID/PID jest podany jako 5A23FFFE, zaczynając od czwartego bajtu pola Dane usługi. Oznacza to, że identyfikator VID to 5A23, a identyfikator PID to FFFE – oba w formacie little endian.
Aplikacja BLE wyświetla wartości w formacie little endian,ale wartości VID/PID wprowadzane w projekcie Developer Console są w formacie big endian.
Sprawdź, czy w projekcie w konsoli Actions zostały wpisane prawidłowe wartości i format na podstawie danych z analizatora Bluetooth.
W przypadku wartości na przykładowym zrzucie ekranu identyfikatory VID i PID w Developer Console będą wynosić odpowiednio 235A i FEFF.