Matter-Integration testen

Unter Google Home Developer Console steht die Seite Test zur Verfügung, auf der Sie mit Google Home Test Suite Tests für die Matter-Integration konfigurieren und ausführen können. Die Test Suite ist eine separate Anwendung, die in den Developer Console integriert ist und alle Integrationstests abwickelt.

Geräte für die Anbieter-ID und Produkt-ID der Integration müssen in Google Home app (GHA) für das Konto, das mit der Developer Console verwendet wird, in Betrieb genommen und verfügbar sein, damit sie getestet werden können. Weitere Informationen finden Sie unter Matter-Gerät 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, die Test Suite auf deinen Integration(en) auszuführen, um dafür zu sorgen, dass alles ordnungsgemäß funktioniert.

Auf der Seite Test werden Matter Integrationen, die abgeschlossen sind 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 die Steuerung von Geräten mit Matter zu testen. Sie können bearbeitet, aber nicht zur Zertifizierung von Matter eingereicht werden.

  • Zertifizierungs-Testpläne gelten speziell für die Matter-Zertifizierung und können nicht bearbeitet werden. Wenn Sie diese Option auswählen, wird eine neue Version der Matter-Integration erstellt.

Integrationsversionen

Wenn Sie einen Testplan für die Zertifizierung erstellen, wird eine neue Version der Integration erstellt. Diese nummerierte Version wird ab dem Tab „Test“ in allen Integrationslisten unter Developer Console aufgeführt.

Neue Versionen werden nie aus anderen nummerierten Versionen erstellt. Beispielsweise wird mit dem ersten Testplan, den Sie für eine Integration erstellen, 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 steht für die nicht versionierte Instanz der Integration, die auf dem Tab Entwickeln verwaltet wird.

Mit anderen Worten: Gehen Sie zu Matter > Test in Developer Console:

  • Wenn Sie für Version der Integration auf Testen 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 Testen klicken, wird keine neue Version erstellt. Stattdessen wird Version v.1 noch einmal getestet.

Weitere Informationen finden Sie unter Integrationsversionsverwaltung.

Testplan erstellen

Integrationsversionen sind eine Momentaufnahme 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:

  1. Ein Unternehmensprofil wurde erstellt.
  2. Sie haben die Produktionsanbieter-ID (VID) für die Integration eingegeben.
  3. Einrichtung und Branding wurden konfiguriert.

Wenn du nicht alle diese Schritte für deine Integration abgeschlossen hast, kann eine Integrationsversion, die für Zertifizierungstests erstellt wurde, nicht zertifiziert werden. Du musst eine neue Version erstellen, was bedeutet, dass du die Schritte „Test“, „Field-Trial“ und „Zertifizierung“ wiederholen musst.

Du musst außerdem eine neue Version erstellen und neu beginnen, wenn du dein Branding aktualisieren möchtest, bevor eine Integrationsversion zertifiziert wird.

So erstellen Sie einen Testplan:

Zur Developer Console

  1. Klicken Sie in der Projektliste neben dem Projekt, mit dem Sie arbeiten möchten, auf Öffnen.

  2. Klicken Sie im Navigationsmenü auf der linken Seite auf Matter > Test.

  3. Klicke auf Test, um die Version der Integration zu sehen, die du testen möchtest. Dadurch wird eine neue Integrationsversion erstellt.

  4. Wählen Sie als Testtyp Entwicklungstest oder Zertifizierungstest aus. Neuen Testplan erstellen

    • Wählen Sie Zertifizierungstest aus, wenn Sie sich auf die Zertifizierung im Google-Werbenetzwerk vorbereiten.
    • Ein Entwicklungstest kann nicht für die Zertifizierung verwendet werden.
  5. Klicken Sie auf Testen. Wenn der Fehler Kein Gerät gefunden angezeigt wird, wurde noch kein Gerät für diese Integration in das System in Betrieb genommen. Weitere Informationen finden Sie unter Fehlerbehebung beim Koppeln.

  6. Geben Sie auf dem Bildschirm Test konfigurieren einen Namen für den Test an und wählen Sie aus der Liste der Geräte, die Sie testen möchten, die Geräte aus, die Sie testen möchten.

  7. Klicken Sie auf die Schaltfläche Weiter: Testplan.

  8. Wählen Sie auf der Seite Testplan erstellen im Abschnitt Testsuiten die Testsuiten aus, die Sie ausführen möchten.

Testplan erstellen

Wenn Sie Test Suite beenden 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.

Testergebnisse

Wenn Sie einen Testplan auf der Seite Testumgebung noch einmal testen möchten, klicken Sie oben nach Abschluss der Testausführung auf Erneut testen.

Nach Abschluss:

Testergebnisse ansehen und interpretieren

Auf der Seite Testverlauf im Test Suite können Sie vorherige Testergebnisse für einen Entwicklungsplan oder einen nicht eingereichten Zertifizierungstestplan ansehen. 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.

Testverlauf

Klicken Sie für einen eingereichten Zertifizierungsplan im Abschnitt Für die Zertifizierung gespeichert auf Ergebnisse, um den Bericht mit den Testergebnissen aufzurufen.

Die Testergebnisse für eine Integrationsversion können auch über den Tab Test im Developer Console aufgerufen werden. Klicken Sie auf Ansehen, um den Testverlauf einer beliebigen Integrationsversion auf dieser Seite aufzurufen. Sie gelangen dann zur Seite Testverlauf in Test Suite.

Console-Status

Die folgenden Konsolenstatus treten in der Testphase auf:

Abschnitt Status Beschreibung Anforderung Der nächste Schritt
Zum Testen bereit Bereit Diese Version von integration kann getestet werden. Diese Version von integrationtesten.
Getestet Bereit Diese Version von integration wurde getestet und kann für das Field Trial oder die 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 gegebenenfalls den Test noch einmal durch.

Fehlerbehebung

Ein aktiviertes 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 angezeigt wird, wenn du versuchst, das Gerät mit der Testsuite in Developer Console zu testen, wird dies wahrscheinlich durch die Verwendung derselben Test-VID und PID-Kombination 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.

Um zu prüfen, ob das richtige Gerät gekoppelt ist, können Sie die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät auf eindeutige Werte in der Testfirmware festlegen.

Weitere Informationen finden Sie unter Geräteinformationen.

VID/PID deines Geräts bestätigen

Wenn du deine Integration mit Google entwickeln möchtest, musst du ein Projekt und eine Integration in der Google Home Console erstellen.

Fehlerbehebung bei Bluetooth Sniffer

Der VID/PID-Wert, den dein Gerät als Beacon verwendet, muss mit der VID/PID übereinstimmen, die du in deinem Developer Console-Projekt eingegeben hast.

  • Die VIDs 0xFFF10xFFF4 sind für Tests reserviert. Sie können für grundlegende Inbetriebnahme- und Kontrolltests verwendet werden, jedoch nicht in den folgenden Entwicklungsphasen:

Wenn Sie eine Bluetooth-Engineering-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 sehen Sie, dass die VID/PID ab dem vierten Byte des Felds Dienstdaten als 5A23FFFE aufgeführt ist. Dies gibt die VID 5A23 und die PID FFFE an – 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üfe, ob die richtigen Werte und das richtige Format in dein 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.