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 zostać zarejestrowane i być 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 upewnić się, że wszystko działa prawidłowo.
Na stronie Test w sekcji Gotowe do testowania znajdziesz listę Matter integracji, które są gotowe i przetestowane.
Integracje Matter, które zostały przetestowane, są wymienione w sekcji Przetestowano.
Rodzaje planów testów
Dostępne są te rodzaje planów testów:
Plany testów programistycznych 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 certyfikacyjnych 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 pozwalają pominąć etap testowania i użyć wyników testów interoperacyjności Connectivity Standards Alliance (Alliance). Ta opcja testowania jest dostępna w przypadku wszystkich obsługiwanych typów urządzeń i jest jedyną prawidłową opcją uzyskania certyfikatu Aliro w przypadku zamków do drzwi zgodnych z Aliro.
Aby przesłać wyniki testów do certyfikacji, użyj Test Suite w Developer Console do Jeśli chcesz uruchomić Test Suite na potrzeby testowania podczas programowania, zapoznaj się ze stroną Google Home Test Suite, na której znajdziesz wersję samodzielną.
Wersje integracji
Gdy tworzysz plan testów na potrzeby certyfikacji, tworzona jest nowa wersja integracji. Ta numerowana wersja jest widoczna na wszystkich listach integracji w Developer Console na karcie Test.
Nowe wersje nigdy nie są tworzone na podstawie innych numerowanych wersji. Na przykład pierwszy plan testów utworzony na potrzeby 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 numerem instancji integracji, tak jak v.1.
Wersja integracji Nie dotyczy reprezentuje nieoznaczoną numerem 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 Nie dotyczy integracji, zostanie utworzona nowa wersja. Numer wersji będzie o 1 większy niż w przypadku wszystkich istniejących wersji numerowanych.
- Jeśli nie ma wersji numerowanych, 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 nieoznaczonej numerem integracji. 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żyć w uruchomionej integracji.
Zanim utworzysz plan testów na potrzeby certyfikacji, upewnij się, że masz:
- Utworzony profil firmy.
- Wpisany identyfikator dostawcy (VID) integracji.
- Skonfigurowane ustawienia i branding.
Jeśli nie wykonasz wszystkich tych czynności w przypadku integracji, wersja integracji utworzona na potrzeby testów certyfikacyjnych nie będzie mogła zostać certyfikowana. Będziesz musiał utworzyć nową wersję, co oznacza, że musisz ponownie wykonać kroki Test, Test funkcjonalny i Certyfikacja.
Musisz też utworzyć nową wersję i zacząć od nowa, jeśli chcesz zaktualizować branding przed certyfikacją wersji integracji.
Aby utworzyć plan testów:
Otwórz Konsolę dla programistów.
Na liście projektów kliknij Otwórz obok projektu, nad którym chcesz pracować.
W menu nawigacyjnym po lewej stronie otwórz Matter > Test.
Kliknij Test w przypadku wersji Nie dotyczy integracji, 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 programistycznego nie można użyć do certyfikacji.
Aby pominąć etapy testowania i testów funkcjonalnych w przepływie integracji Matter, wybierz Test interoperacyjności CSA i użyj wyników testów interoperacyjności Alliance Alliance. Po wybraniu opcji Test interoperacyjności CSA przypisz nazwę śledzenia do profilu konfiguracji , przypisz identyfikator produktu urządzenia (PID) i kliknij Prześlij, aby przejść bezpośrednio do certyfikacji.
Aby uzyskać certyfikat Aliro w przypadku zamków do drzwi zgodnych z Aliro, musisz wybrać Test interoperacyjności CSA. Jeśli wybierzesz inną opcję testowania, 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.
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 dla programistów.
Uruchamianie planu testów
W Test Suite na stronie Utwórz plan testów kliknij Uruchom test. Otworzy 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ę jego stan (Zakończono, Niepowodzenie).
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 programistycznego lub nieprzesłanego planu testów certyfikacyjnych . W tym celu w sekcji Plany testów kliknij Sprawdź ponownie. 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 Zapisano 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 się spotkać z tymi stanami 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 sprawdź ponownie. |
Sprawdź ponownie
Certyfikat
Jeśli musisz ponownie przetestować urządzenie na potrzeby certyfikacji, po rozpoczęciu ponownego testowania musisz je sparować.
Programowanie
Jeśli musisz ponownie przetestować urządzenie na potrzeby programowania, możesz użyć istniejącego urządzenia bez ponownego parowania.
Rozwiązywanie problemów
Zarejestrowane urządzenie nie pojawia się w zestawie testów
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ą zestawu testów w Developer Console, prawdopodobnie jest to spowodowane użyciem tej samej kombinacji testowego identyfikatora VID i PID w przypadku kilku integracji.
Aby rozwiązać problemy, usuń wszystkie urządzenia testowe z Developer Console i ponownie sparuj urządzenie, które chcesz przetestować.
Aby sprawdzić, czy urządzenie zostało prawidłowo sparowane, możesz ustawić informacje o producencie i modelu (CHIP_DEVICE_CONFIG_DEVICE_*) na unikalne wartości w oprogramowaniu układowym testu.
Więcej informacji znajdziesz w sekcji Informacje o urządzeniu.
Sprawdź identyfikator VID/PID urządzenia
Jeśli chcesz rozpocząć programowanie integracji z Google, musisz utworzyć projekt i integrację w Konsoli Google Home.
Wartość VID/PID, którą urządzenie wysyła, powinna być zgodna z wartością VID/PID wpisaną w projekcie 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żynierskiej 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 Android nRF Connect,
widać, że identyfikator VID/PID jest wymieniony jako 5A23FFFE począwszy od czwartego bajtu
pola Dane usługi. Oznacza to identyfikator VID 5A23 i identyfikator PID 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 Konsoli Actions zostały wpisane 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 235A i FEFF, odpowiednio.