Unter Google Home Developer Console wird die Seite Test angezeigt, auf der Sie mit Google Home Test Suite Tests für die Matter-Integration konfigurieren und ausführen können. Test Suite ist eine separate Anwendung, die in Developer Console integriert ist und alle Integrationstests ausführt.
Geräte, für die die Anbieter-ID und die Produkt-ID der Integration verwendet werden, müssen für das Konto, das mit Developer Console verwendet wird, in Google Home app (GHA) in Betrieb genommen und verfügbar sein, damit sie getestet werden können. Weitere Informationen findest du unter Matter-Geräte koppeln.
Das Test Suite kann auf einer Reihe von Geräten ausgeführt werden, die zu einer bestimmten Matter-Projektkonfiguration gehören. Es ist sehr wichtig, Test Suite auf Ihren Integrationen(en) auszuführen, damit alles ordnungsgemäß funktioniert.
Auf der Seite Test werden Matter Integrationen, die abgeschlossen und zum Testen bereit sind, unter Bereit zum Testen aufgeführt.
Getestete Matter-Integrationen werden im Abschnitt Getestete aufgeführt.
Art der Testpläne
Es gibt zwei Arten von Testplänen:
Entwicklungstestpläne werden verwendet, um steuernde Geräte mit Matter zu testen. Sie können bearbeitet, aber nicht zur Matter-Zertifizierung eingereicht werden.
Zertifizierungstestpläne gelten speziell für Matter-Zertifizierungen und können nicht bearbeitet werden. Wenn Sie diese Option auswählen, wird eine neue Version Ihrer Matter-Integration erstellt.
Integrationsversionen
Wenn du einen Testplan für die Zertifizierung erstellst, wird eine neue Version der Integration erstellt. Diese nummerierte Version ist ab dem Tab „Test“ in allen Integrationslisten in Developer Console aufgeführt.
Neue Versionen werden nie aus anderen nummerierten Versionen erstellt. Beispielsweise wird im ersten Testplan, den du für eine Integration erstellst, Version v.1 für diese Integration erstellt. Wenn Sie einen weiteren Testplan erstellen, wird für diese Integration Version v.2 erstellt. Diese Version basiert jedoch nicht auf v.1. Stattdessen basiert diese Version auf der nicht versionierten Instanz der Integration, genau wie v.1.
Die Version – einer Integration stellt die nicht versionierte Instanz der Integration dar, die auf dem Tab Entwickeln verwaltet wird.
Mit anderen Worten, unter Matter > Test in Developer Console:
- Wenn Sie auf Test für Version – der Integration klicken, wird eine neue Version erstellt. Die Versionsnummer ist um 1 höher als die aller vorhandenen nummerierten Versionen.
- Wenn keine nummerierten Versionen vorhanden sind, wird Version v.1 erstellt.
- Wenn Version v.1 vorhanden ist, wird Version v.2 erstellt. Wenn Version v.2 vorhanden ist, wird Version v.3 erstellt usw.
- Wenn Sie für eine nummerierte Version der Integration (z. B. v.1) auf Test klicken, wird keine neue Version erstellt. Stattdessen wird Version v.1 noch einmal getestet.
Weitere Informationen finden Sie unter Integrationsversionsverwaltung.
Testplan erstellen
Integrationsversionen sind Momentaufnahmen einer nicht versionierten Integration. 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 wurde erstellt.
- Eingabe der Produktionsanbieter-ID (VID) für die Integration.
- Konfigurierte Einrichtung und Branding:
Wenn du nicht alle diese Schritte für deine Integration abgeschlossen hast, kann eine für den Zertifizierungstest erstellte Integrationsversion nicht zertifiziert werden. Du musst eine neue Version erstellen, was bedeutet, dass du die Schritte Test, Field Trial und Zertifizierung wiederholen musst.
Außerdem musst du eine neue Version erstellen und neu beginnen, wenn du dein Branding aktualisieren möchtest, bevor eine Integrationsversion zertifiziert wird.
So erstellen Sie einen Testplan:
Klicken Sie in der Projektliste neben dem Projekt, mit dem Sie arbeiten möchten, auf Öffnen.
Wählen Sie im Navigationsmenü auf der linken Seite Matter > Test aus.
Klicke auf Testen, um die Version – der Integration zu sehen, die du testen möchtest. Durch diese Aktion wird eine neue Integrationsversion erstellt.
Wählen Sie den Testtyp Entwicklungstest oder Zertifizierungstest aus.
- Wählen Sie Zertifizierungstest aus, wenn Sie sich auf die Zertifizierung in der Google-Umgebung vorbereiten.
- Ein Entwicklungstest kann nicht für die Zertifizierung verwendet werden.
Klicken Sie auf Testen. Wenn der Fehler Kein Gerät gefunden angezeigt wird, wurde noch kein Gerät für diese Integration für die Umgebung in Betrieb genommen. Weitere Informationen finden Sie unter Fehlerbehebung beim Koppeln.
Geben Sie auf dem Bildschirm Test konfigurieren einen Namen für den Test ein und wählen Sie in der Liste der Geräte die zu testenden Geräte aus.
Klicken Sie auf die Schaltfläche Weiter: Plan testen.
Wählen Sie auf der Seite Testplan erstellen im Abschnitt Testsuites die Testsuiten aus, die Sie ausführen möchten.
Wenn Sie Test Suite nicht mehr nutzen möchten, klicken Sie auf Zurück zum Developer Center.
Testplan ausführen
Klicken Sie in der Test Suite auf der Seite Testplan erstellen auf Test ausführen. Die Seite Testumgebung wird mit dem Status und den Logs aller Tests angezeigt.
Die Testergebnisse werden nach Abschluss der Tests angezeigt. Daneben wird der Status jeder Testsuite-Ausführung angezeigt ("Bestanden", "Fehlgeschlagen").
Im Bereich Logs wird der Status jeder einzelnen Testausführung angezeigt.
Wenn Sie einen Testplan auf der Seite Testumgebung noch einmal testen möchten, klicken Sie nach Abschluss der Testausführung oben auf Erneut testen.
Nach Abschluss:
- Klicken Sie auf Fertig, um die Seite Testverlauf aufzurufen, oder
- Klicken Sie auf Senden, um die Testergebnisse zur Zertifizierung einzureichen.
Testergebnisse ansehen und interpretieren
Auf der Seite Testverlauf im Test Suite können Sie frühere Testergebnisse für einen Entwicklungsplan oder einen nicht eingereichten Zertifizierungstestplan aufrufen. Klicken Sie dazu für den gewünschten Testplan im Abschnitt Testpläne auf Erneut prüfen. Dadurch gelangen Sie zur Seite Test Environment (Testumgebung), auf der die Ergebnisse dieses Tests angezeigt werden.
Klicken Sie für einen eingereichten Zertifizierungsplan im Abschnitt Für die Zertifizierung gespeichert auf Ergebnisse, um den Bericht zu den Testergebnissen aufzurufen.
Testergebnisse für eine Integrationsversion können auch über den Tab Test im Developer Console aufgerufen werden. Klicken Sie auf Anzeigen, um den Testverlauf einer beliebigen Integrationsversion auf dieser Seite aufzurufen und zur Seite Testverlauf in Test Suite zu gelangen.
Status der Konsole
In der Testphase können die folgenden Konsolenstatus auftreten:
| Abschnitt | Status | Beschreibung | Anforderung | Der nächste Schritt |
|---|---|---|---|---|
| Zum Testen bereit | Bereit | Diese Version von integration kann getestet werden. | – | Teste diese Version von integration. |
| Getestet | Bereit | Diese Version von integration wurde getestet und kann zum Field Trial oder zur Zertifizierung eingereicht werden. |
Die Version wurde getestet und gespeichert. Alle fehlgeschlagenen Testläufe enthalten eine Begründung, die Google prüfen kann. |
Führen Sie den Test gegebenenfalls noch einmal durch. |
Fehlerbehebung
In Betrieb genommenes Gerät wird nicht in der Test-Suite angezeigt
Wenn du ein Gerät mit einer Testanbieter-ID (VID) und einer Produkt-ID (PID) gekoppelt hast, diese aber nicht erscheint, wenn du versuchst, das Gerät mit der Test-Suite in Developer Console zu testen, wird dies wahrscheinlich durch die Verwendung derselben Kombination aus Test-VID und PID für mehrere Integrationen verursacht.
Entfernen Sie zur Fehlerbehebung alle Testgeräte aus Developer Console und koppeln Sie das Gerät, das Sie noch einmal testen möchten.
Du kannst prüfen, ob du das richtige Pairing gekoppelt hast, indem du die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in deiner Testfirmware auf eindeutige Werte setzt.
Weitere Informationen finden Sie unter Geräteinformationen.
Bestätige die VID/PID deines Geräts
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 für das Beaconing deines Geräts muss mit der VID/PID übereinstimmen, die du in dein Developer Console-Projekt eingegeben hast.
- VIDs
0xFFF1bis0xFFF4sind für Tests reserviert. Sie können für grundlegende Inbetriebnahme- und Kontrolltests verwendet werden, aber nicht in den folgenden Entwicklungsphasen:
Wenn Sie eine technische Bluetooth-App wie nRF Connect for Mobile verwenden, können Sie die VID/PID des Beaconing-Geräts im Feld Dienstdaten sehen.
In diesem Screenshot aus der Android-Version von nRF Connect ist die VID/PID als 5A23FFFE beginnend beim vierten Byte des Felds Dienstdaten aufgeführt. Dies weist auf die VID 5A23 und die PID FFFE hin – beide im Little-Endian-Format.
Die BLE-Anwendung zeigt die Werte in Little-Endian an, aber die VID/PID-Werte, die Sie in Ihr Developer Console-Projekt eingeben, sind in Big-Endian.
Prüfen Sie, ob die richtigen Werte und das richtige Format in Ihr Actions Console-Projekt eingegeben wurden, je nachdem, was der Bluetooth-Sniffer anzeigt.
Für die Werte im Beispielscreenshot wären die VID und die PID im Developer Console 235A bzw. FEFF.