Google Home Developer Console zawiera stronę Test, na której możesz skonfigurować i przeprowadzić testy Matter integracji za pomocą Google Home Test Suite. Test Suite to osobna aplikacja wbudowana w Developer Console, która obsługuje wszystkie testy integracji.
Aby można było przetestować urządzenia, muszą one być zarejestrowane i dostępne w Google Home app (GHA) na koncie używanym w Developer Console. Dotyczy to urządzeń z identyfikatorem dostawcy i identyfikatorem produktu integracji. Więcej informacji znajdziesz w artykule Parowanie urządzenia Matter .
Test Suite można uruchomić na zestawie urządzeń należących do określonej konfiguracji projektu Matter. Bardzo ważne jest, aby uruchomić Test Suite w integracji, aby mieć pewność, że wszystko działa prawidłowo.
Na stronie Test integracje Matter które są 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 rodzaje planów testów:
Plany testówprogramowania służą do testowania sterowania urządzeniami za pomocą Matter. Można je edytować, ale nie można ich przesłać do Matter certyfikacji.
Plany testów certyfikacji są przeznaczone specjalnie do Matter certyfikacji 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 użycie wyników testów interoperacyjności Connectivity Standards Alliance (Alliance) Laboratorium. Ta opcja testowania jest dostępna w przypadku wszystkich obsługiwanych typów urządzeń.
Aby przesłać wyniki testów do certyfikacji, użyj Test Suite w Developer Console do. Jeśli chcesz uruchomić Test Suite do celów testowych podczas programowania, zapoznaj się ze stroną Google Home Test Suite, na której znajdziesz informacje o wersji samodzielnej.
Wersje integracji
Gdy tworzysz plan testów do certyfikacji, tworzona jest nowa wersja integracji. Ta numerowana wersja jest widoczna na wszystkich listach integracji w Developer Console od karty Test.
Nowe wersje nigdy nie są tworzone na podstawie innych numerowanych wersji. Na przykład pierwszy plan testów 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 v.1. Zamiast tego ta wersja jest oparta na nieoznaczonej wersją instancji integracji, tak jak v.1.
Wersja integracji Nie dotyczy reprezentuje nieoznaczoną wersją instancję integracji, którą można zarządzać na karcie Programowanie.
Innymi słowy, w Developer Console w sekcji Matter > Test:
- Jeśli klikniesz Test w przypadku wersji integracji Nie dotyczy, zostanie utworzona nowa wersja. Numer wersji będzie o 1 większy niż w przypadku wszystkich istniejących numerowanych wersji.
- Jeśli nie ma numerowanych wersji, zostanie utworzona wersja v.1.
- Jeśli istnieje wersja v.1, zostanie utworzona wersja v.2. Jeśli istnieje wersja v.2, zostanie utworzona wersja v.3 itd.
- Jeśli klikniesz Test w przypadku numerowanej wersji integracji (np. v.1), nie zostanie utworzona nowa wersja. Zamiast tego wersja v.1 zostanie ponownie przetestowana.
Więcej informacji znajdziesz w artykule Wersjonowanie integracji.
Tworzenie planu testów
Wersje integracji to migawka integracji bez wersji. Oznacza to, że gdy tworzysz plan testów do certyfikacji, a tym samym wersję integracji, wszystkie metadane związane z tą integracją muszą być informacjami, których chcesz użyć w uruchomionej integracji.
Zanim utworzysz plan testów do certyfikacji, wykonaj te czynności:
- Utworzono profil firmy.
- Wpisz produkcyjny identyfikator dostawcy (VID) integracji.
- Skonfiguruj ustawienia i branding.
Jeśli nie wykonasz wszystkich tych czynności w przypadku integracji, wersja integracji utworzona na potrzeby testów certyfikacyjnych nie może zostać certyfikowana. Będziesz musiał utworzyć nową wersję, co oznacza, że musisz ponowić kroki Test, Testy w terenie i Certyfikacja.
Będziesz też musiał utworzyć nową wersję i zacząć od nowa, jeśli chcesz zaktualizować branding przed certyfikacją wersji integracji.
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 wybierz Matter > Test.
Kliknij Test w przypadku wersji integracji Nie dotyczy, którą chcesz przetestować. Ta czynność spowoduje utworzenie nowej wersji integracji.
Wybierz typ testu i kliknij Test.
- Jeśli przygotowujesz się do certyfikacji w ekosystemie Google, wybierz Test certyfikacyjny.
- Testu programowania nie można użyć do certyfikacji.
- Aby pominąć etapy testowania i testów w terenie w przepływie integracji Matter, użyj wyników testów interoperacyjności Alliance.Alliance
Na ekranie Skonfiguruj test podaj nazwę testu i kliknij Automatycznie sparuj urządzenie, aby wybrać urządzenie do sparowania.
W przypadku urządzenia z Androidem:
- Upewnij się, że masz zainstalowaną aplikację GHA na telefonie.
- Połącz telefon z komputerem hosta za pomocą kabla USB.
- Musisz
włączyć debugowanie USB na urządzeniu
Plik
APKcom.chip.interop.moblysnippetzostanie automatycznie pobrany i zainstalowany. - Gdy telefon jest połączony, wpisz kod parowania i nazwę urządzenia , aby automatycznie sparować urządzenie.
W przypadku urządzenia z iOS:
- Musisz ręcznie sparować urządzenie. Instrukcje dotyczące ręcznego parowania znajdziesz w sekcji Aplikacja Google Home.
- Jeśli masz już urządzenie, może pojawić się prośba o rozparowanie urządzenia 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 zamknąć Test Suite, kliknij
Wróć do Centrum
deweloperów.
Uruchamianie planu testów
W Test Suite na stronie Utwórz plan testów kliknij Uruchom test. Wyświetli się strona Środowisko testowe ze stanem i logami wszystkich testów.
Wyniki testów pojawią się po zakończeniu testów. Obok każdego zestawu testów wyświetla się jego stan (Zaliczone, Nieudane).
W panelu Logi widać stan wykonania każdego testu.
Aby ponownie przetestować plan testów na stronie Środowisko testowe, po zakończeniu wykonania testu kliknij u góry
Sprawdź ponownie.
Po zakończeniu:
- kliknij Gotowe , aby przejść do strony Historia testów , lub
- kliknij Prześlij , aby przesłać wyniki testów do certyfikacji.
Wyświetlanie i interpretowanie wyników testów
Na stronie Historia testów w Test Suite możesz wyświetlić poprzednie wyniki testów planu programowania lub nieprzesłanego planu testów certyfikacyjnych W tym celu w sekcji Plany testów kliknij Sprawdź ponownie w przypadku wybranego planu testów. Spowoduje to przejście do strony Środowisko testowe , na której wyświetlają się wyniki tego testu.
W przypadku przesłanego planu certyfikacji kliknij Wyniki w sekcji Zapisane do certyfikacji, aby wyświetlić raport z wynikami testów.
Wyniki testów można też wyświetlić w przypadku wersji integracji na karcie Test w Developer Console. Kliknij Wyświetl w przypadku historii testów dowolnej wersji integracji wymienionej na tej stronie, aby przejść do strony Historia testów w Test Suite.
Stany konsoli
W fazie testowania można spotkać 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. |
| Przetestowane urządzenia | 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 przypadki testowe zawierają uzasadnienia, które Google może sprawdzić. |
W razie potrzeby sprawdź ponownie. |
Sprawdź ponownie
Certyfikat
Jeśli musisz ponownie przetestować urządzenie do celów certyfikacji, po rozpoczęciu ponownego testowania musisz je sparować.
Programowanie
Jeśli musisz ponownie przetestować urządzenie do celów programowania, możesz użyć istniejącego urządzenia bez ponownego parowania.
Rozwiązywanie problemów
Zarejestrowane urządzenie nie pojawia się w Test Suite
Jeśli sparujesz urządzenie z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się ono, gdy próbujesz przetestować urządzenie za pomocą Test Suite w Developer Console, prawdopodobnie jest to spowodowane użyciem tej samej kombinacji testowego identyfikatora VID i PID w przypadku wielu integracji.
Aby rozwiązać ten problem, usuń wszystkie urządzenia testowe z Developer Console i ponownie sparuj urządzenie, które chcesz przetestować.
Aby sprawdzić, czy sparowano prawidłowe urządzenie, możesz ustawić informacje o producencie i modelu (wartości CHIP_DEVICE_CONFIG_DEVICE_*) na unikalne wartości w oprogramowaniu testowym.
Więcej informacji znajdziesz w artykule Informacje o urządzeniu.
Sprawdzanie identyfikatora VID/PID urządzenia
Jeśli chcesz rozpocząć programowanie integracji z Google, musisz utworzyć projekt i integrację w Google Home Console.
Wartość VID/PID, którą urządzenie wysyła, powinna być zgodna z wartością VID/PID wpisaną w projekt Developer Console.
- Identyfikatory VID
0xFFF1–0xFFF4są zarezerwowane do testowania. Można ich używać do podstawowych testów rejestracji i sterowania, ale nie można ich używać w tych fazach programowania:
Za pomocą aplikacji inżynieryjnej Bluetooth, takiej jak nRF Connect for Mobile, możesz sprawdzić identyfikator VID/PID urządzenia wysyłającego sygnał w polu Dane usługi.
Na tym zrzucie ekranu z wersji nRF Connect Android widać, że identyfikator VID/PID jest wymieniony jako 5A23FFFE 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 wpisywane w projekcie Developer Console są w formacie big endian.
Sprawdź, czy w projekcie Actions Console wpisano prawidłowe wartości i format na podstawie tego, co pokazuje sniffer Bluetooth.
W przypadku wartości na przykładowym zrzucie ekranu identyfikator VID i PID w
Developer Console to odpowiednio 235A i FEFF.