In der Google Home Developer Console gibt es die Seite Testen , auf der du Tests für deine Matter Integration mit der Google Home Test Suite konfigurieren und ausführen kannst. Die Test Suite ist eine separate Anwendung, die in die Developer Console integriert ist und alle Integrationstests durchführt.
Geräte für die Anbieter-ID und Produkt-ID der Integration müssen in Betrieb genommen und in Google Home app (GHA) für das Konto verfügbar sein, das mit der Developer Console verwendet wird, damit sie getestet werden können. Weitere Informationen findest du unter Matter-Gerät koppeln.
Die Test Suite kann auf einer Reihe von Geräten ausgeführt werden, die zu einer bestimmten Matter Projektkonfiguration gehören. Es ist sehr wichtig, die Test Suite für deine Integration(en) auszuführen, um sicherzustellen, dass alles ordnungsgemäß funktioniert.
Auf der Seite Testen werden unter Bereit zum Testen die Matter Integrationen aufgeführt, die fertig sind und getestet werden können.
Matter Integrationen, die getestet wurden, werden in dem Abschnitt Getestet aufgeführt.
Testplantypen
Folgende Testplantypen sind verfügbar:
Entwicklungstestpläne werden verwendet, um die Steuerung von Geräten mit Matter zu testen. Sie können bearbeitet, aber nicht zur Matter Zertifizierung eingereicht werden.
Zertifizierungstestpläne sind speziell für die Matter Zertifizierung vorgesehen und können nicht bearbeitet werden. Wenn du diese Option auswählst, wird eine neue Version deiner Matter Integration erstellt.
Mit CSA Interop-Testplänen kannst du die Testphase überspringen und die Ergebnisse des Connectivity Standards Alliance (Alliance) Interop Test Lab verwenden. Diese Testoption ist für alle unterstützten Gerätetypen verfügbar.
Verwende die Test Suite in der Developer Console, um Testergebnisse zur Zertifizierung einzureichen. Wenn du die Test Suite zu Testzwecken während der Entwicklung ausführen möchtest, findest du auf der Google Home Test Suite Seite die eigenständige Version.
Integrationsversionen
Wenn du einen Testplan erstellst für die Zertifizierung, wird eine neue Version der Integration erstellt. Diese nummerierte Version wird in allen Integrationslisten in der Developer Console ab dem Tab „Testen“ aufgeführt.
Neue Versionen werden nie aus anderen nummerierten Versionen erstellt. Wenn du beispielsweise den ersten Testplan für eine Integration erstellst, wird die Version v.1 für diese Integration erstellt. Wenn du einen weiteren Testplan erstellst, wird die Version v.2 für diese Integration erstellt. Diese Version basiert jedoch nicht auf v.1. Stattdessen basiert diese Version auf der Version der Integration ohne Versionsnummer, genau wie v.1.
Die Version N/A einer Integration stellt die Version der Integration ohne Versionsnummer dar, die auf dem Tab Entwickeln verwaltet wird.
Anders ausgedrückt: In der Developer Console unter Matter > Test:
- Wenn du für die Version N/A der Integration auf Testen klickst, wird eine neue Version erstellt. Die Versionsnummer ist um eins höher als bei allen vorhandenen nummerierten Versionen.
- Wenn keine nummerierten Versionen vorhanden sind, wird die Version v.1 erstellt.
- Wenn die Version v.1 vorhanden ist, wird die Version v.2 erstellt. Wenn die Version v.2 vorhanden ist, wird die Version v.3 erstellt usw.
- Wenn du für eine nummerierte Version der Integration (z. B. v.1) auf Testen klickst, wird keine neue Version erstellt. Stattdessen wird die Version v.1 noch einmal getestet.
Weitere Informationen findest du unter Integration versionsverwaltung.
Testplan erstellen
Integrationsversionen sind ein Snapshot einer Integration ohne Versionsnummer. Wenn du also einen Testplan für die Zertifizierung und damit eine Integrationsversion erstellst, müssen alle Metadaten im Zusammenhang mit dieser Integration die Informationen sein, die du für die gestartete Integration verwenden möchtest.
Bevor du einen Testplan für die Zertifizierung erstellst, musst du Folgendes tun:
- Ein Unternehmensprofil erstellen.
- Die Produktionsanbieter-ID (VID) für die Integration eingeben.
- Einrichtung und Branding konfigurieren.
Wenn du diese Schritte für deine Integration nicht ausgeführt hast, kann eine für Zertifizierungstests erstellte Integrationsversion nicht zertifiziert werden. Du musst eine neue Version erstellen und die Schritte „Testen“, „Field Trial“ und „Zertifizieren“ noch einmal ausführen.
Du musst auch eine neue Version erstellen und von vorn beginnen, wenn du dein Branding aktualisieren möchtest, bevor eine Integrationsversion zertifiziert wird.
So erstellst du einen Testplan:
Klicke in der Liste der Projekte neben dem Projekt, mit dem du arbeiten möchtest, auf Öffnen.
Gehe im Navigationsmenü auf der linken Seite der Seite zu Matter > Testen.
Klicke für die Version N/A der Integration, die du testen möchtest, auf Testen. Dadurch wird eine neue Integrationsversion erstellt.
Wähle einen Testtyp aus und klicke auf Testen.
- Wähle Zertifizierungstest aus, wenn du dich auf die Zertifizierung im Google-Ökosystem vorbereitest.
- Ein Entwicklungstest kann nicht für die Zertifizierung verwendet werden.
- Wähle CSA Interop-Test aus, um die Ergebnisse des Alliance Interop Test Lab zu verwenden und die Phasen „Testen“ und „Field Trial“ im Matter-Integrationsablauf zu überspringen.
Gib auf dem Bildschirm Test konfigurieren einen Namen für deinen Test ein und klicke auf Gerät automatisch koppeln, um ein Gerät zum Koppeln auszuwählen.
Für ein Android-Gerät:
- Achte darauf, dass du GHA auf deinem Smartphone installiert hast.
- Verbinde dein Smartphone über ein USB-Kabel mit dem Hostcomputer.
- Du musst
das USB-Debugging auf deinem Gerät aktivieren
Die
APKcom.chip.interop.moblysnippetwird automatisch heruntergeladen und installiert. - Sobald dein Smartphone verbunden ist, gib den Kopplungscode und den Gerätenamen ein, um dein Gerät automatisch zu koppeln.
Für ein iOS-Gerät:
- Du musst dein Gerät manuell koppeln. Eine Anleitung zum manuellen Koppeln findest du im Abschnitt Google Home App.
- Wenn du ein vorhandenes Gerät hast, wirst du möglicherweise aufgefordert, die Kopplung des Geräts aufzuheben und es noch einmal zu koppeln oder ein neues Gerät zu koppeln.
Klicke auf die Schaltfläche Weiter: Testplan.
Wähle auf der Seite Testplan erstellen im Abschnitt Test-Suites die Test-Suites aus, die du ausführen möchtest.
Wenn du die Test Suite beenden möchtest, klicke auf
Zurück zum Developer
Center.
Testplan ausführen
Klicke in der Test Suite auf der Seite Testplan erstellen auf Testen. Die Seite Testumgebung wird mit dem Status und den Logs aller Tests angezeigt.
Deine Testergebnisse werden angezeigt, sobald die Tests abgeschlossen sind. Der Status der einzelnen Test-Suite-Ausführungen wird daneben angezeigt (Bestanden, Nicht bestanden).
Im Bereich Logs wird der Status der einzelnen Testausführungen angezeigt.
Wenn du einen Testplan auf der Seite Testumgebung noch einmal testen möchtest, klicke oben
nach Abschluss der Testausführung auf
Test wiederholen.
Nach Abschluss:
- Klicke auf Fertig , um zur Seite Testverlauf zu wechseln, oder
- klicke auf Einreichen , um die Testergebnisse zur Zertifizierung einzureichen.
Testergebnisse ansehen und interpretieren
Auf der Seite Testverlauf in der Test Suite kannst du dir frühere Testergebnisse für einen Entwicklungsplan oder einen nicht eingereichten Zertifizierungs- testplan ansehen. Klicke dazu im Abschnitt Testpläne für den gewünschten Testplan auf Test wiederholen. Du wirst zur Seite Testumgebung weitergeleitet, auf der die Ergebnisse dieses Tests angezeigt werden.
Klicke für einen eingereichten Zertifizierungsplan im Abschnitt Zur Zertifizierung gespeichert auf Ergebnisse, um den Bericht mit den Testergebnissen aufzurufen.
Testergebnisse können auch für eine Integrationsversion auf dem Testen Tab in der Developer Consoleaufgerufen werden. Klicke für den Testverlauf einer beliebigen Integrationsversion auf dieser Seite auf Ansehen , um zur Seite Testverlauf in der Test Suite zu gelangen.
Console-Status
In der Testphase werden die folgenden Console-Status angezeigt:
| Abschnitt | Status | Beschreibung | Anforderung | Vorgehensweise |
|---|---|---|---|---|
| Bereit zum Testen | Bereit | Diese Version von integration ist bereit zum Testen. | – | Teste diese Version von integration. |
| Getestet | Bereit | Diese Version von integration wurde getestet und kann für Field Trial oder die Zertifizierung eingereicht werden. |
Die Version wurde getestet und gespeichert. Alle nicht bestandenen Testläufe enthalten Begründungen zur Überprüfung durch Google. |
Teste bei Bedarf noch einmal. |
Erneut prüfen
Zertifizierung
Wenn du den Test für die Zertifizierung wiederholen musst, musst du dein Gerät koppeln, nachdem du den Test neu gestartet hast.
Entwicklung
Wenn du den Test für die Entwicklung wiederholen musst, kannst du das vorhandene Gerät verwenden, ohne es noch einmal zu koppeln.
Fehlerbehebung
In Betrieb genommenes Gerät wird in der Test Suite nicht angezeigt
Wenn du ein Gerät mit einer Testanbieter-ID (VID) und Produkt-ID (PID) gekoppelt hast, aber es nicht angezeigt wird, wenn du versuchst, das Gerät mit der Test Suite in Developer Console zu testen, liegt das wahrscheinlich daran, dass du dieselbe Kombination aus Test-VID und ‑PID für mehrere Integrationen verwendest.
Entferne zur Fehlerbehebung alle Testgeräte aus Developer Console und kopple das Gerät, das du testen möchtest, noch einmal.
Um zu prüfen, ob du das richtige Gerät gekoppelt hast, kannst du die Informationen zu Hersteller und Modell (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in deiner Testfirmware auf eindeutige Werte festlegen.
Weitere Informationen findest du unter Geräteinformationen für weitere Informationen.
VID/PID deines Geräts überprüfen
Wenn du mit der Entwicklung deiner Integration mit Google beginnen möchtest, musst du ein Projekt und eine Integration in der Google Home Console erstellen.
Der VID/PID-Wert, den dein Gerät sendet, muss mit der VID/PID übereinstimmen, die in deinem Developer Console Projekt eingegeben wurde.
- Die VIDs
0xFFF1bis0xFFF4sind für Tests reserviert. Sie können für grundlegende Inbetriebnahme- und Steuerungstests verwendet werden, aber nicht in den folgenden Phasen der Entwicklung:
Mit einer Bluetooth-Engineering-App wie nRF Connect for Mobile, kannst du die VID/PID des sendenden Geräts im Feld Service Data sehen.
In diesem Screenshot aus der Android Version von nRF Connect, sehen Sie, dass die VID/PID ab dem vierten Byte des Felds Service Data als 5A23FFFE aufgeführt ist. Das bedeutet eine VID von 5A23 und eine PID von FFFE – beide im Little-Endian-Format.
In der BLE-App werden die Werte im Little-Endian-Format angezeigt. Die VID/PID-Werte, die du in dein Developer Console Projekt eingibst, sind jedoch im Big-Endian-Format.
Prüfe anhand der Informationen des Bluetooth-Sniffers, ob die richtigen Werte und das richtige Format in dein Actions Console-Projekt eingegeben wurden.
Für die Werte im Beispiel-Screenshot wären die VID und PID in der
Developer Console 235A bzw. FEFF.